Releasing version 3.54.4

Releasing version 3.54.4

Author: oci-dex-release-bot

CHANGELOG.rst

@@ -6,6 +6,32 @@ All notable changes to this project will be documented in this file.
 
 The format is based on `Keep a Changelog <http://keepachangelog.com/>`__.
 
+3.54.4 - 2025-04-22
+--------------------
+Added
+~~~~~
+*  Core Services
+
+  * Support iSCSI-3 Persistant Reservation for Block Volume
+
+    * ``oci bv volume create ----is-reservations-enabled``
+    * ``oci bv volume create-volume-source-from-volume-backup-delta --is-reservations-enabled``
+    * ``oci bv volume create-volume-volume-source-from-block-volume-replica-details``
+
+* Visual Builder Service
+
+  * Support for restricting public network access to a VB service instance in Visual builder
+
+    * ``oci visual-builder vb-instance update-vb-instance-update-public-endpoint-details --network-endpoint-details-allowlisted-http-ips --network-endpoint-details-allowlisted-http-vcns``
+    * ``oci visual-builder vb-instance update-vb-instance-public-endpoint-details --network-endpoint-details-allowlisted-http-ips --network-endpoint-details-allowlisted-http-vcns``
+
+* Database service
+
+  * Support for Database Lifecycle Management Patch Management
+      
+    * ``oci dblm dblm-patch-management get-patch-management``
+    * ``oci dblm patch-databases-collection list-databases``
+
 3.54.3 - 2025-04-15
 --------------------
 Added

requirements.txt

@@ -4,7 +4,7 @@
 
 appdirs==1.4.3
 arrow>=1.0.0
-certifi==2025.1.31
+certifi>=2025.1.31
 cffi>=1.9.1
 click==8.0.4
 coverage==4.5.2
@@ -15,7 +15,7 @@ Jinja2>=3.1.5; python_version >= '3.7'
 jmespath==0.10.0
 ndg-httpsclient==0.4.2
 mock==2.0.0
-oci==2.150.1
+oci==2.150.2
 packaging==20.2
 pluggy==0.13.0
 py==1.11.0

services/container_engine/src/oci_cli_container_engine/generated/containerengine_cli.py

@@ -1188,17 +1188,20 @@ def get_addon(ctx, from_json, cluster_id, addon_name):
 
 @cluster_group.command(name=cli_util.override('ce.get_cluster.command_name', 'get'), help=u"""Get the details of a cluster. \n[Command Reference](getCluster)""")
 @cli_util.option('--cluster-id', required=True, help=u"""The OCID of the cluster.""")
+@cli_util.option('--should-include-oidc-config-file', type=click.BOOL, help=u"""Boolean value to determine if the OpenIdConnectAuth configuration file should be displayed for the provided cluster.""")
 @json_skeleton_utils.get_cli_json_input_option({})
 @cli_util.help_option
 @click.pass_context
 @json_skeleton_utils.json_skeleton_generation_handler(input_params_to_complex_types={}, output_type={'module': 'container_engine', 'class': 'Cluster'})
 @cli_util.wrap_exceptions
-def get_cluster(ctx, from_json, cluster_id):
+def get_cluster(ctx, from_json, cluster_id, should_include_oidc_config_file):
 
     if isinstance(cluster_id, six.string_types) and len(cluster_id.strip()) == 0:
         raise click.UsageError('Parameter --cluster-id cannot be whitespace or empty string')
 
     kwargs = {}
+    if should_include_oidc_config_file is not None:
+        kwargs['should_include_oidc_config_file'] = should_include_oidc_config_file
     kwargs['opc_request_id'] = cli_util.use_or_generate_request_id(ctx.obj['request_id'])
     client = cli_util.build_client('container_engine', 'container_engine', ctx)
     result = client.get_cluster(
@@ -2092,6 +2095,136 @@ def list_workload_mappings(ctx, from_json, all_pages, page_size, cluster_id, lim
     cli_util.render_response(result, ctx)
 
 
+@cluster_group.command(name=cli_util.override('ce.reboot_cluster_node.command_name', 'reboot-cluster-node'), help=u"""perform reboot action to node in cluster \n[Command Reference](rebootClusterNode)""")
+@cli_util.option('--cluster-id', required=True, help=u"""The OCID of the cluster.""")
+@cli_util.option('--node-id', required=True, help=u"""The OCID of the compute instance.""")
+@cli_util.option('--node-eviction-settings', type=custom_types.CLI_COMPLEX_TYPE, help=u"""""" + custom_types.cli_complex_type.COMPLEX_TYPE_HELP)
+@cli_util.option('--wait-for-state', type=custom_types.CliCaseInsensitiveChoice(["ACCEPTED", "IN_PROGRESS", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED"]), multiple=True, help="""This operation asynchronously creates, modifies or deletes a resource and uses a work request to track the progress of the operation. Specify this option to perform the action and then wait until the work request reaches a certain state. Multiple states can be specified, returning on the first state. For example, --wait-for-state SUCCEEDED --wait-for-state FAILED would return on whichever lifecycle state is reached first. If timeout is reached, a return code of 2 is returned. For any other error, a return code of 1 is returned.""")
+@cli_util.option('--max-wait-seconds', type=click.INT, help="""The maximum time to wait for the work request to reach the state defined by --wait-for-state. Defaults to 1200 seconds.""")
+@cli_util.option('--wait-interval-seconds', type=click.INT, help="""Check every --wait-interval-seconds to see whether the work request has reached the state defined by --wait-for-state. Defaults to 30 seconds.""")
+@json_skeleton_utils.get_cli_json_input_option({'node-eviction-settings': {'module': 'container_engine', 'class': 'NodeEvictionSettings'}})
+@cli_util.help_option
+@click.pass_context
+@json_skeleton_utils.json_skeleton_generation_handler(input_params_to_complex_types={'node-eviction-settings': {'module': 'container_engine', 'class': 'NodeEvictionSettings'}})
+@cli_util.wrap_exceptions
+def reboot_cluster_node(ctx, from_json, wait_for_state, max_wait_seconds, wait_interval_seconds, cluster_id, node_id, node_eviction_settings):
+
+    if isinstance(cluster_id, six.string_types) and len(cluster_id.strip()) == 0:
+        raise click.UsageError('Parameter --cluster-id cannot be whitespace or empty string')
+
+    if isinstance(node_id, six.string_types) and len(node_id.strip()) == 0:
+        raise click.UsageError('Parameter --node-id cannot be whitespace or empty string')
+
+    kwargs = {}
+    kwargs['opc_request_id'] = cli_util.use_or_generate_request_id(ctx.obj['request_id'])
+
+    _details = {}
+
+    if node_eviction_settings is not None:
+        _details['nodeEvictionSettings'] = cli_util.parse_json_parameter("node_eviction_settings", node_eviction_settings)
+
+    client = cli_util.build_client('container_engine', 'container_engine', ctx)
+    result = client.reboot_cluster_node(
+        cluster_id=cluster_id,
+        node_id=node_id,
+        reboot_cluster_node_details=_details,
+        **kwargs
+    )
+    if wait_for_state:
+
+        if hasattr(client, 'get_work_request') and callable(getattr(client, 'get_work_request')):
+            try:
+                wait_period_kwargs = {}
+                if max_wait_seconds is not None:
+                    wait_period_kwargs['max_wait_seconds'] = max_wait_seconds
+                if wait_interval_seconds is not None:
+                    wait_period_kwargs['max_interval_seconds'] = wait_interval_seconds
+                if 'opc-work-request-id' not in result.headers:
+                    click.echo('Encountered error while waiting for work request to enter the specified state. Outputting last known resource state')
+                    cli_util.render_response(result, ctx)
+                    return
+
+                click.echo('Action completed. Waiting until the work request has entered state: {}'.format(wait_for_state), file=sys.stderr)
+                result = oci.wait_until(client, client.get_work_request(result.headers['opc-work-request-id']), 'status', wait_for_state, **wait_period_kwargs)
+            except oci.exceptions.MaximumWaitTimeExceeded as e:
+                # If we fail, we should show an error, but we should still provide the information to the customer
+                click.echo('Failed to wait until the work request entered the specified state. Outputting last known resource state', file=sys.stderr)
+                cli_util.render_response(result, ctx)
+                sys.exit(2)
+            except Exception:
+                click.echo('Encountered error while waiting for work request to enter the specified state. Outputting last known resource state', file=sys.stderr)
+                cli_util.render_response(result, ctx)
+                raise
+        else:
+            click.echo('Unable to wait for the work request to enter the specified state', file=sys.stderr)
+    cli_util.render_response(result, ctx)
+
+
+@cluster_group.command(name=cli_util.override('ce.replace_boot_volume_cluster_node.command_name', 'replace-boot-volume-cluster-node'), help=u"""perform cycle action to node in cluster \n[Command Reference](replaceBootVolumeClusterNode)""")
+@cli_util.option('--cluster-id', required=True, help=u"""The OCID of the cluster.""")
+@cli_util.option('--node-id', required=True, help=u"""The OCID of the compute instance.""")
+@cli_util.option('--node-eviction-settings', type=custom_types.CLI_COMPLEX_TYPE, help=u"""""" + custom_types.cli_complex_type.COMPLEX_TYPE_HELP)
+@cli_util.option('--wait-for-state', type=custom_types.CliCaseInsensitiveChoice(["ACCEPTED", "IN_PROGRESS", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED"]), multiple=True, help="""This operation asynchronously creates, modifies or deletes a resource and uses a work request to track the progress of the operation. Specify this option to perform the action and then wait until the work request reaches a certain state. Multiple states can be specified, returning on the first state. For example, --wait-for-state SUCCEEDED --wait-for-state FAILED would return on whichever lifecycle state is reached first. If timeout is reached, a return code of 2 is returned. For any other error, a return code of 1 is returned.""")
+@cli_util.option('--max-wait-seconds', type=click.INT, help="""The maximum time to wait for the work request to reach the state defined by --wait-for-state. Defaults to 1200 seconds.""")
+@cli_util.option('--wait-interval-seconds', type=click.INT, help="""Check every --wait-interval-seconds to see whether the work request has reached the state defined by --wait-for-state. Defaults to 30 seconds.""")
+@json_skeleton_utils.get_cli_json_input_option({'node-eviction-settings': {'module': 'container_engine', 'class': 'NodeEvictionSettings'}})
+@cli_util.help_option
+@click.pass_context
+@json_skeleton_utils.json_skeleton_generation_handler(input_params_to_complex_types={'node-eviction-settings': {'module': 'container_engine', 'class': 'NodeEvictionSettings'}})
+@cli_util.wrap_exceptions
+def replace_boot_volume_cluster_node(ctx, from_json, wait_for_state, max_wait_seconds, wait_interval_seconds, cluster_id, node_id, node_eviction_settings):
+
+    if isinstance(cluster_id, six.string_types) and len(cluster_id.strip()) == 0:
+        raise click.UsageError('Parameter --cluster-id cannot be whitespace or empty string')
+
+    if isinstance(node_id, six.string_types) and len(node_id.strip()) == 0:
+        raise click.UsageError('Parameter --node-id cannot be whitespace or empty string')
+
+    kwargs = {}
+    kwargs['opc_request_id'] = cli_util.use_or_generate_request_id(ctx.obj['request_id'])
+
+    _details = {}
+
+    if node_eviction_settings is not None:
+        _details['nodeEvictionSettings'] = cli_util.parse_json_parameter("node_eviction_settings", node_eviction_settings)
+
+    client = cli_util.build_client('container_engine', 'container_engine', ctx)
+    result = client.replace_boot_volume_cluster_node(
+        cluster_id=cluster_id,
+        node_id=node_id,
+        replace_boot_volume_cluster_node_details=_details,
+        **kwargs
+    )
+    if wait_for_state:
+
+        if hasattr(client, 'get_work_request') and callable(getattr(client, 'get_work_request')):
+            try:
+                wait_period_kwargs = {}
+                if max_wait_seconds is not None:
+                    wait_period_kwargs['max_wait_seconds'] = max_wait_seconds
+                if wait_interval_seconds is not None:
+                    wait_period_kwargs['max_interval_seconds'] = wait_interval_seconds
+                if 'opc-work-request-id' not in result.headers:
+                    click.echo('Encountered error while waiting for work request to enter the specified state. Outputting last known resource state')
+                    cli_util.render_response(result, ctx)
+                    return
+
+                click.echo('Action completed. Waiting until the work request has entered state: {}'.format(wait_for_state), file=sys.stderr)
+                result = oci.wait_until(client, client.get_work_request(result.headers['opc-work-request-id']), 'status', wait_for_state, **wait_period_kwargs)
+            except oci.exceptions.MaximumWaitTimeExceeded as e:
+                # If we fail, we should show an error, but we should still provide the information to the customer
+                click.echo('Failed to wait until the work request entered the specified state. Outputting last known resource state', file=sys.stderr)
+                cli_util.render_response(result, ctx)
+                sys.exit(2)
+            except Exception:
+                click.echo('Encountered error while waiting for work request to enter the specified state. Outputting last known resource state', file=sys.stderr)
+                cli_util.render_response(result, ctx)
+                raise
+        else:
+            click.echo('Unable to wait for the work request to enter the specified state', file=sys.stderr)
+    cli_util.render_response(result, ctx)
+
+
 @cluster_group.command(name=cli_util.override('ce.start_credential_rotation.command_name', 'start-credential-rotation'), help=u"""Start cluster credential rotation by adding new credentials, old credentials will still work after this operation. \n[Command Reference](startCredentialRotation)""")
 @cli_util.option('--cluster-id', required=True, help=u"""The OCID of the cluster.""")
 @cli_util.option('--auto-completion-delay-duration', required=True, help=u"""The duration in days(in ISO 8601 notation eg. P5D) after which the old credentials should be retired. Maximum delay duration is 90 days.""")

services/container_engine/tests/util/generated/command_to_api.py

@@ -39,6 +39,8 @@
     "ce.list_work_request_logs": "oci.container_engine.ContainerEngineClient.list_work_request_logs",
     "ce.list_work_requests": "oci.container_engine.ContainerEngineClient.list_work_requests",
     "ce.list_workload_mappings": "oci.container_engine.ContainerEngineClient.list_workload_mappings",
+    "ce.reboot_cluster_node": "oci.container_engine.ContainerEngineClient.reboot_cluster_node",
+    "ce.replace_boot_volume_cluster_node": "oci.container_engine.ContainerEngineClient.replace_boot_volume_cluster_node",
     "ce.start_credential_rotation": "oci.container_engine.ContainerEngineClient.start_credential_rotation",
     "ce.update_addon": "oci.container_engine.ContainerEngineClient.update_addon",
     "ce.update_cluster": "oci.container_engine.ContainerEngineClient.update_cluster",