Releasing version 3.54.2

Releasing version 3.54.2

Author: oci-dex-release-bot

CHANGELOG.rst

@@ -6,6 +6,39 @@ 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.2 - 2025-04-08
+--------------------
+Added
+~~~~~
+* GoldenGate Service
+
+  * Support for new optional parameters to create and update deployment operation
+
+    * ``oci goldengate deployment create  --availability-domain, --fault-domain, --placements, --source-deployment-id``
+    * ``oci goldengate deployment update --placements``
+
+  * Support for new operations to goldengate deployment operation
+
+    * ``oci goldengate deployment add-deployment-local-peer``
+    * ``oci goldengate deployment remove-deployment-local-peer``
+    * ``oci goldengate deployment switchover-deployment-peer``
+
+  * Support for deploymentPeerSummary operation
+
+    * ``oci goldengate deployment-peer-summary list-deployment-peers``
+
+  * Support for collecting diagnostics for ZeroETL pipelines
+
+    * ``oci goldengate pipeline collect-diagnostic``
+
+* Support for new optional parameters for below command in the Key Management Service
+
+  * ``oci kms management vault create-vault-replica --replica-vault-metadata``
+
+* Support for Dry Run of Function Invocation in the Functions service
+
+  * ``oci fn function invoke  --is-dry-run``
+
 3.54.1 - 2025-04-01
 --------------------
 Added

requirements.txt

@@ -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.149.2
+oci==2.150.0
 packaging==20.2
 pluggy==0.13.0
 py==1.11.0

services/functions/src/oci_cli_functions_invoke/generated/functionsinvoke_cli.py

@@ -38,12 +38,13 @@ def function_group():
 @cli_util.option('--invoke-function-body', help=u"""The body of the function invocation. Note: The maximum size of the request is limited. This limit is currently 6MB and the endpoint will not accept requests that are bigger than this limit.""")
 @cli_util.option('--fn-intent', type=custom_types.CliCaseInsensitiveChoice(["httprequest", "cloudevent"]), help=u"""An optional intent header that indicates to the FDK the way the event should be interpreted. E.g. 'httprequest', 'cloudevent'.""")
 @cli_util.option('--fn-invoke-type', type=custom_types.CliCaseInsensitiveChoice(["detached", "sync"]), help=u"""Indicates whether Oracle Functions should execute the request and return the result ('sync') of the execution, or whether Oracle Functions should return as soon as processing has begun ('detached') and leave result handling to the function.""")
+@cli_util.option('--is-dry-run', type=click.BOOL, help=u"""Indicates that the request is a dry run, if set to \"true\". A dry run request does not execute the function.""")
 @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={})
 @cli_util.wrap_exceptions
-def invoke_function(ctx, from_json, file, function_id, invoke_function_body, fn_intent, fn_invoke_type):
+def invoke_function(ctx, from_json, file, function_id, invoke_function_body, fn_intent, fn_invoke_type, is_dry_run):
 
     if isinstance(function_id, six.string_types) and len(function_id.strip()) == 0:
         raise click.UsageError('Parameter --function-id cannot be whitespace or empty string')
@@ -55,6 +56,8 @@ def invoke_function(ctx, from_json, file, function_id, invoke_function_body, fn_
         kwargs['fn_intent'] = fn_intent
     if fn_invoke_type is not None:
         kwargs['fn_invoke_type'] = fn_invoke_type
+    if is_dry_run is not None:
+        kwargs['is_dry_run'] = is_dry_run
     kwargs['opc_request_id'] = cli_util.use_or_generate_request_id(ctx.obj['request_id'])
 
     # do not automatically retry operations with binary inputs

services/golden_gate/src/oci_cli_golden_gate/generated/goldengate_cli.py

@@ -653,6 +653,14 @@ def update_connection_update_oracle_nosql_connection_details_extended(ctx, **kwa
 cli_util.rename_command(goldengate_cli, goldengate_cli.deployment_backup_group, goldengate_cli.remove_deployment_backup_lock, "remove-lock")
 
 
+# oci goldengate deployment add -> oci goldengate deployment add-deployment-local-peer
+cli_util.rename_command(goldengate_cli, goldengate_cli.deployment_group, goldengate_cli.add_deployment_local_peer, "add-deployment-local-peer")
+
+
+# oci goldengate deployment remove -> oci goldengate deployment remove-deployment-local-peer
+cli_util.rename_command(goldengate_cli, goldengate_cli.deployment_group, goldengate_cli.remove_deployment_local_peer, "remove-deployment-local-peer")
+
+
 # oci goldengate connection create-connection-create-db2-connection-details -> oci goldengate connection create-db2-connection
 cli_util.rename_command(goldengate_cli, goldengate_cli.connection_group, goldengate_cli.create_connection_create_db2_connection_details, "create-db2-connection")
 
@@ -803,3 +811,7 @@ def update_connection_update_microsoft_fabric_connection_details_extended(ctx, *
         kwargs.pop('connection_endpoint')
 
     ctx.invoke(goldengate_cli.update_connection_update_microsoft_fabric_connection_details, **kwargs)
+
+
+# oci goldengate pipeline collect-pipeline-diagnostic -> oci goldengate pipeline collect-diagnostic
+cli_util.rename_command(goldengate_cli, goldengate_cli.pipeline_group, goldengate_cli.collect_pipeline_diagnostic, "collect-diagnostic")

services/golden_gate/src/oci_cli_golden_gate/golden_gate_cli_extended.py

@@ -36,9 +36,6 @@ def test_deployment_create_req_params(self):
         assert 'display-name' in result.output
         assert 'compartment-id' in result.output
         assert 'subnet-id' in result.output
-        assert 'cpu-core-count' in result.output
-        assert 'is-auto-scaling-enabled' in result.output
-        assert 'deployment-type' in result.output
 
     def test_deployment_create_req_params1(self):
         result = util.invoke_command(['goldengate', 'deployment', 'create', '--deployment-name'])

services/golden_gate/tests/unit/test_goldengate_cli_extended.py

@@ -4,6 +4,7 @@
 SDK_client_map = {
     "goldengate.add_connection_lock": "oci.golden_gate.GoldenGateClient.add_connection_lock",
     "goldengate.add_deployment_backup_lock": "oci.golden_gate.GoldenGateClient.add_deployment_backup_lock",
+    "goldengate.add_deployment_local_peer": "oci.golden_gate.GoldenGateClient.add_deployment_local_peer",
     "goldengate.add_deployment_lock": "oci.golden_gate.GoldenGateClient.add_deployment_lock",
     "goldengate.cancel_deployment_backup": "oci.golden_gate.GoldenGateClient.cancel_deployment_backup",
     "goldengate.cancel_deployment_upgrade": "oci.golden_gate.GoldenGateClient.cancel_deployment_upgrade",
@@ -14,6 +15,7 @@
     "goldengate.change_deployment_compartment": "oci.golden_gate.GoldenGateClient.change_deployment_compartment",
     "goldengate.change_pipeline_compartment": "oci.golden_gate.GoldenGateClient.change_pipeline_compartment",
     "goldengate.collect_deployment_diagnostic": "oci.golden_gate.GoldenGateClient.collect_deployment_diagnostic",
+    "goldengate.collect_pipeline_diagnostic": "oci.golden_gate.GoldenGateClient.collect_pipeline_diagnostic",
     "goldengate.copy_deployment_backup": "oci.golden_gate.GoldenGateClient.copy_deployment_backup",
     "goldengate.create_certificate": "oci.golden_gate.GoldenGateClient.create_certificate",
     "goldengate.create_connection": "oci.golden_gate.GoldenGateClient.create_connection",
@@ -48,6 +50,7 @@
     "goldengate.list_database_registrations": "oci.golden_gate.GoldenGateClient.list_database_registrations",
     "goldengate.list_deployment_backups": "oci.golden_gate.GoldenGateClient.list_deployment_backups",
     "goldengate.list_deployment_environments": "oci.golden_gate.GoldenGateClient.list_deployment_environments",
+    "goldengate.list_deployment_peers": "oci.golden_gate.GoldenGateClient.list_deployment_peers",
     "goldengate.list_deployment_types": "oci.golden_gate.GoldenGateClient.list_deployment_types",
     "goldengate.list_deployment_upgrades": "oci.golden_gate.GoldenGateClient.list_deployment_upgrades",
     "goldengate.list_deployment_versions": "oci.golden_gate.GoldenGateClient.list_deployment_versions",
@@ -68,6 +71,7 @@
     "goldengate.refresh_connection": "oci.golden_gate.GoldenGateClient.refresh_connection",
     "goldengate.remove_connection_lock": "oci.golden_gate.GoldenGateClient.remove_connection_lock",
     "goldengate.remove_deployment_backup_lock": "oci.golden_gate.GoldenGateClient.remove_deployment_backup_lock",
+    "goldengate.remove_deployment_local_peer": "oci.golden_gate.GoldenGateClient.remove_deployment_local_peer",
     "goldengate.remove_deployment_lock": "oci.golden_gate.GoldenGateClient.remove_deployment_lock",
     "goldengate.reschedule_deployment_upgrade": "oci.golden_gate.GoldenGateClient.reschedule_deployment_upgrade",
     "goldengate.restore_deployment": "oci.golden_gate.GoldenGateClient.restore_deployment",
@@ -77,6 +81,7 @@
     "goldengate.start_pipeline": "oci.golden_gate.GoldenGateClient.start_pipeline",
     "goldengate.stop_deployment": "oci.golden_gate.GoldenGateClient.stop_deployment",
     "goldengate.stop_pipeline": "oci.golden_gate.GoldenGateClient.stop_pipeline",
+    "goldengate.switchover_deployment_peer": "oci.golden_gate.GoldenGateClient.switchover_deployment_peer",
     "goldengate.test_connection_assignment": "oci.golden_gate.GoldenGateClient.test_connection_assignment",
     "goldengate.test_pipeline_connection": "oci.golden_gate.GoldenGateClient.test_pipeline_connection",
     "goldengate.update_connection": "oci.golden_gate.GoldenGateClient.update_connection",

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

@@ -396,13 +396,54 @@ def create_vault(ctx, from_json, wait_for_state, max_wait_seconds, wait_interval
 As a provisioning operation, this call is subject to a Key Management limit that applies to the total number of requests across all provisioning write operations. Key Management might throttle this call to reject an otherwise valid request when the total rate of provisioning write operations exceeds 10 requests per second for a given tenancy. \n[Command Reference](createVaultReplica)""")
 @cli_util.option('--vault-id', required=True, help=u"""The OCID of the vault.""")
 @cli_util.option('--replica-region', required=True, help=u"""The region in the realm to which the vault need to be replicated to""")
+@cli_util.option('--replica-vault-metadata', type=custom_types.CLI_COMPLEX_TYPE, help=u"""""" + custom_types.cli_complex_type.COMPLEX_TYPE_HELP)
+@cli_util.option('--if-match', help=u"""For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.""")
+@json_skeleton_utils.get_cli_json_input_option({'replica-vault-metadata': {'module': 'key_management', 'class': 'ReplicaVaultMetadata'}})
+@cli_util.help_option
+@click.pass_context
+@json_skeleton_utils.json_skeleton_generation_handler(input_params_to_complex_types={'replica-vault-metadata': {'module': 'key_management', 'class': 'ReplicaVaultMetadata'}})
+@cli_util.wrap_exceptions
+def create_vault_replica(ctx, from_json, vault_id, replica_region, replica_vault_metadata, if_match):
+
+    if isinstance(vault_id, six.string_types) and len(vault_id.strip()) == 0:
+        raise click.UsageError('Parameter --vault-id cannot be whitespace or empty string')
+
+    kwargs = {}
+    if if_match is not None:
+        kwargs['if_match'] = if_match
+    kwargs['opc_request_id'] = cli_util.use_or_generate_request_id(ctx.obj['request_id'])
+
+    _details = {}
+    _details['replicaRegion'] = replica_region
+
+    if replica_vault_metadata is not None:
+        _details['replicaVaultMetadata'] = cli_util.parse_json_parameter("replica_vault_metadata", replica_vault_metadata)
+
+    client = cli_util.build_client('key_management', 'kms_vault', ctx)
+    result = client.create_vault_replica(
+        vault_id=vault_id,
+        create_vault_replica_details=_details,
+        **kwargs
+    )
+    cli_util.render_response(result, ctx)
+
+
+@vault_group.command(name=cli_util.override('kms_vault.create_vault_replica_replica_external_vault_metadata.command_name', 'create-vault-replica-replica-external-vault-metadata'), help=u"""Creates a replica for the vault in another region in the same realm
+
+The API is a no-op if called for same region that a vault is already replicated to. 409 if called on a vault that is already replicated to a different region. Users need to delete existing replica first before calling it with a different region.
+
+As a provisioning operation, this call is subject to a Key Management limit that applies to the total number of requests across all provisioning write operations. Key Management might throttle this call to reject an otherwise valid request when the total rate of provisioning write operations exceeds 10 requests per second for a given tenancy. \n[Command Reference](createVaultReplica)""")
+@cli_util.option('--vault-id', required=True, help=u"""The OCID of the vault.""")
+@cli_util.option('--replica-region', required=True, help=u"""The region in the realm to which the vault need to be replicated to""")
+@cli_util.option('--replica-vault-metadata-private-endpoint-id', required=True, help=u"""OCID of the EKMS private endpoint in the replica region and must be in ACTIVE state""")
+@cli_util.option('--replica-vault-metadata-idcs-account-name-url', required=True, help=u"""Replica region URL of the IDCS domain""")
 @cli_util.option('--if-match', help=u"""For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.""")
 @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={})
 @cli_util.wrap_exceptions
-def create_vault_replica(ctx, from_json, vault_id, replica_region, if_match):
+def create_vault_replica_replica_external_vault_metadata(ctx, from_json, vault_id, replica_region, replica_vault_metadata_private_endpoint_id, replica_vault_metadata_idcs_account_name_url, if_match):
 
     if isinstance(vault_id, six.string_types) and len(vault_id.strip()) == 0:
         raise click.UsageError('Parameter --vault-id cannot be whitespace or empty string')
@@ -413,7 +454,12 @@ def create_vault_replica(ctx, from_json, vault_id, replica_region, if_match):
     kwargs['opc_request_id'] = cli_util.use_or_generate_request_id(ctx.obj['request_id'])
 
     _details = {}
+    _details['replicaVaultMetadata'] = {}
     _details['replicaRegion'] = replica_region
+    _details['replicaVaultMetadata']['privateEndpointId'] = replica_vault_metadata_private_endpoint_id
+    _details['replicaVaultMetadata']['idcsAccountNameUrl'] = replica_vault_metadata_idcs_account_name_url
+
+    _details['replicaVaultMetadata']['vaultType'] = 'EXTERNAL'
 
     client = cli_util.build_client('key_management', 'kms_vault', ctx)
     result = client.create_vault_replica(

services/key_management/src/oci_cli_kms_vault/generated/kmsvault_cli.py

@@ -141,3 +141,7 @@ def restore_from_file(ctx, **kwargs):
         ctx.invoke(kmsvault_cli.restore_vault_from_file, **kwargs)
     except Exception:
         click.echo("Can't open the file")
+
+
+# Remove create-vault-replica-replica-external-vault-metadata from oci kms management vault
+kmsvault_cli.vault_group.commands.pop(kmsvault_cli.create_vault_replica_replica_external_vault_metadata.name)

services/key_management/src/oci_cli_kms_vault/kms_vault_cli_extended.py

@@ -65,7 +65,7 @@ def get_connector_plugin(ctx, from_json, connector_plugin_name):
 
 
 @connector_plugin_summary_group.command(name=cli_util.override('connector_plugins.list_connector_plugins.command_name', 'list-connector-plugins'), help=u"""Lists connector plugins according to the specified filter. \n[Command Reference](listConnectorPlugins)""")
-@cli_util.option('--lifecycle-state', type=custom_types.CliCaseInsensitiveChoice(["CREATING", "UPDATING", "ACTIVE", "INACTIVE", "DELETING", "DELETED", "FAILED"]), help=u"""A filter to return only resources that match the given lifecycle state.
+@cli_util.option('--lifecycle-state', type=custom_types.CliCaseInsensitiveChoice(["CREATING", "UPDATING", "ACTIVE", "INACTIVE", "NEEDS_ATTENTION", "DELETING", "DELETED", "FAILED"]), help=u"""A filter to return only resources that match the given lifecycle state.
 
 Example: `ACTIVE`""")
 @cli_util.option('--display-name', help=u"""A filter to return only resources that match the given display name exactly.