Releasing version 3.38.0

Releasing version 3.38.0

Author: NiviPari

CHANGELOG.rst

@@ -6,6 +6,116 @@ All notable changes to this project will be documented in this file.
 
 The format is based on `Keep a Changelog <http://keepachangelog.com/>`__.
 
+3.38.0 - 2024-03-26
+-------------------
+Added
+~~~~~
+
+* OCI Network Load Balancer Service
+
+  * Support for symmetric hashing when creating or updating network load balancers.
+
+    * ``oci nlb network-load-balancer create --is-symmetric-hash-enabled``
+    * ``oci nlb network-load-balancer update --is-symmetric-hash-enabled``
+
+* OCI Monitoring Service
+
+  * Support for new optional parameters in the create or update alarms commands.
+
+    * ``oci monitoring alarm create --overrides --rule-name --notification-version``
+    * ``oci monitoring alarm update --overrides --rule-name --notification-version``
+
+* OCI Database Management Service
+
+  * Support for new command to retrieve fleet health metrics for MySQL HeatWave clusters.
+
+    * ``oci database-management managed-my-sql-databases heat-wave-fleet-metrics``
+
+  * Support for new optional parameter when retrieving MySQL fleet metrics.
+
+    * ``oci database-management managed-my-sql-databases my-sql-fleet-metrics --is-heat-wave-enabled``
+
+* OCI Database Service
+
+  * Support for creating and updating a refreshable clone with auto-refresh for an autonomous database.
+
+    * ``oci db autonomous-database create-refreshable-clone --auto-refresh-point-lag-in-seconds``
+    * ``oci db autonomous-database update --auto-refresh-point-lag-in-seconds``
+
+* OCI Logging Service
+
+  * Support for new logging agent-configuration commands.
+
+    * ``oci logging agent-configuration create-unified-agent-configuration-unified-agent-monitoring-configuration-details``
+    * ``oci logging agent-configuration update-unified-agent-configuration-unified-agent-monitoring-configuration-details``
+
+  * Support for new optional parameters in the following commands
+
+    * ``oci logging agent-configuration create-log-configuration --service-configuration-filter``
+    * ``oci logging agent-configuration update-log-configuration --service-configuration-filter``
+
+* OCI Devops Deployment Service
+
+  * Support for new groups of commands.
+
+    * ``oci devops code-search``
+    * ``oci devops protected-branch``
+    * ``oci devops pull-request``
+    * ``oci devops pull-request-comment``
+    * ``oci devops repository-private-access``
+
+  * Support for new commands in the ``deploy-artifact`` group.
+
+    * ``oci devops deploy-artifact create-helm-command-spec``
+    * ``oci devops deploy-artifact update-helm-command-spec``
+
+  * Support for new commands in the ``project`` group.
+
+    * ``oci devops project get-project-settings``
+    * ``oci devops project update-project-settings``
+    * ``oci devops project delete-project-settings``
+    * ``oci devops project get-notification-preference``
+    * ``oci devops project update-notification-preference``
+    * ``oci devops project list-project-analytics-authors``
+    * ``oci devops project summarize-project-analytics``
+
+  * Support for new commands in the ``repository`` group.
+
+    * ``oci devops repository create-or-update-git-branch-details``
+    * ``oci devops repository create-or-update-git-tag-details``
+    * ``oci devops repository delete-git-ref``
+    * ``oci devops repository delete-repository-settings``
+    * ``oci devops repository get-repository-settings``
+    * ``oci devops repository get-repository-notification-preference``
+    * ``oci devops repository list-fork-sync-statuses``
+    * ``oci devops repository list-pull-request-authors``
+    * ``oci devops repository list-repository-analytics-authors``
+    * ``oci devops repository list-repository-build-run-snapshots``
+    * ``oci devops repository summarize-repository-analytics``
+    * ``oci devops repository sync``
+    * ``oci devops repository update-repository-notification-preference``
+    * ``oci devops repository update-repository-settings``
+
+  * Support for new parameters in the following commands.
+
+    * ``oci devops repository create --parent-repository-id``
+    * ``oci devops repository get-commit-diff --target-repository-id``
+    * ``oci devops repository list-commit-diffs --target-repository-id``
+    * ``oci devops deploy-stage create-deploy-oke-stage --oke-environment-details``
+    * ``oci devops deploy-stage update-deploy-oke-stage --oke-environment-details``
+    * ``oci devops deploy-stage create-oke-helm-chart-stage --oke-environment-details --helm-command-artifact-ids --purpose --is-uninstall-on-stage-delete``
+    * ``oci devops deploy-stage update-oke-helm-chart-stage --oke-environment-details --helm-command-artifact-ids --purpose --is-uninstall-on-stage-delete``
+
+
+Changed
+~~~~~~~
+
+* [BREAKING] Optional parameters ``--description`` and ``--display-name`` have now been made required in the following commands in OCI Logging Service.
+
+  * ``oci logging agent-configuration create``
+  * ``oci logging agent-configuration create-log-configuration``
+
+
 3.37.14 - 2024-03-19
 --------------------
 Added

requirements.txt

@@ -14,7 +14,7 @@ Jinja2==3.0.3
 jmespath==0.10.0
 ndg-httpsclient==0.4.2
 mock==2.0.0
-oci==2.124.2
+oci==2.125.0
 packaging==20.2
 pluggy==0.13.0
 py==1.11.0

services/database/src/oci_cli_database/generated/database_cli.py

@@ -3803,6 +3803,12 @@ def create_autonomous_database_create_autonomous_database_clone_details(ctx, fro
 This cannot be used in conjunction with adminPassword.""")
 @cli_util.option('--secret-version-number', type=click.INT, help=u"""The version of the vault secret. If no version is specified, the latest version will be used.""")
 @cli_util.option('--refreshable-mode', type=custom_types.CliCaseInsensitiveChoice(["AUTOMATIC", "MANUAL"]), help=u"""The refresh mode of the clone. AUTOMATIC indicates that the clone is automatically being refreshed with data from the source Autonomous Database.""")
+@cli_util.option('--auto-refresh-frequency-in-seconds', type=click.INT, help=u"""The frequency a refreshable clone is refreshed after auto-refresh is enabled. The minimum is 1 hour. The maximum is 7 days. The date and time that auto-refresh is enabled is controlled by the `timeOfAutoRefreshStart` parameter.""")
+@cli_util.option('--auto-refresh-point-lag-in-seconds', type=click.INT, help=u"""The time, in seconds, the data of the refreshable clone lags the primary database at the point of refresh. The minimum is 0 minutes (0 mins means refresh to the latest available timestamp). The maximum is 7 days. The lag time increases after refreshing until the next data refresh happens.""")
+@cli_util.option('--time-of-auto-refresh-start', type=custom_types.CLI_DATETIME, help=u"""The the date and time that auto-refreshing will begin for an Autonomous Database refreshable clone. This value controls only the start time for the first refresh operation. Subsequent (ongoing) refresh operations have start times controlled by the value of the `autoRefreshFrequencyInSeconds` parameter.""" + custom_types.CLI_DATETIME.VALID_DATETIME_CLI_HELP_MESSAGE)
+@cli_util.option('--open-mode', type=custom_types.CliCaseInsensitiveChoice(["READ_ONLY", "READ_WRITE"]), help=u"""Indicates the Autonomous Database mode. The database can be opened in `READ_ONLY` or `READ_WRITE` mode.
+
+This cannot be updated in parallel with any of the following: cpuCoreCount, computeCount, computeModel, adminPassword, whitelistedIps, isMTLSConnectionRequired, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, or isFreeTier.""")
 @cli_util.option('--wait-for-state', type=custom_types.CliCaseInsensitiveChoice(["PROVISIONING", "AVAILABLE", "STOPPING", "STOPPED", "STARTING", "TERMINATING", "TERMINATED", "UNAVAILABLE", "RESTORE_IN_PROGRESS", "RESTORE_FAILED", "BACKUP_IN_PROGRESS", "SCALE_IN_PROGRESS", "AVAILABLE_NEEDS_ATTENTION", "UPDATING", "MAINTENANCE_IN_PROGRESS", "RESTARTING", "RECREATING", "ROLE_CHANGE_IN_PROGRESS", "UPGRADING", "INACCESSIBLE", "STANDBY"]), multiple=True, help="""This operation creates, modifies or deletes a resource that has a defined lifecycle state. Specify this option to perform the action and then wait until the resource reaches a given lifecycle 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 resource to reach the lifecycle 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 resource has reached the lifecycle state defined by --wait-for-state. Defaults to 30 seconds.""")
@@ -3811,7 +3817,7 @@ def create_autonomous_database_create_autonomous_database_clone_details(ctx, fro
 @click.pass_context
 @json_skeleton_utils.json_skeleton_generation_handler(input_params_to_complex_types={'whitelisted-ips': {'module': 'database', 'class': 'list[string]'}, 'standby-whitelisted-ips': {'module': 'database', 'class': 'list[string]'}, 'nsg-ids': {'module': 'database', 'class': 'list[string]'}, 'freeform-tags': {'module': 'database', 'class': 'dict(str, string)'}, 'defined-tags': {'module': 'database', 'class': 'dict(str, dict(str, object))'}, 'customer-contacts': {'module': 'database', 'class': 'list[CustomerContact]'}, 'resource-pool-summary': {'module': 'database', 'class': 'ResourcePoolSummary'}, 'scheduled-operations': {'module': 'database', 'class': 'list[ScheduledOperationDetails]'}, 'db-tools-details': {'module': 'database', 'class': 'list[DatabaseTool]'}}, output_type={'module': 'database', 'class': 'AutonomousDatabase'})
 @cli_util.wrap_exceptions
-def create_autonomous_database_create_refreshable_autonomous_database_clone_details(ctx, from_json, wait_for_state, max_wait_seconds, wait_interval_seconds, compartment_id, source_id, character_set, ncharacter_set, db_name, cpu_core_count, backup_retention_period_in_days, compute_model, compute_count, ocpu_count, db_workload, data_storage_size_in_tbs, data_storage_size_in_gbs, is_free_tier, kms_key_id, vault_id, admin_password, display_name, license_model, is_preview_version_with_service_terms_accepted, is_auto_scaling_enabled, is_dev_tier, is_dedicated, autonomous_container_database_id, in_memory_percentage, is_access_control_enabled, whitelisted_ips, are_primary_whitelisted_ips_used, standby_whitelisted_ips, is_data_guard_enabled, is_local_data_guard_enabled, subnet_id, nsg_ids, private_endpoint_label, freeform_tags, defined_tags, private_endpoint_ip, db_version, customer_contacts, is_mtls_connection_required, resource_pool_leader_id, resource_pool_summary, autonomous_maintenance_schedule_type, scheduled_operations, is_auto_scaling_for_storage_enabled, database_edition, db_tools_details, secret_id, secret_version_number, refreshable_mode):
+def create_autonomous_database_create_refreshable_autonomous_database_clone_details(ctx, from_json, wait_for_state, max_wait_seconds, wait_interval_seconds, compartment_id, source_id, character_set, ncharacter_set, db_name, cpu_core_count, backup_retention_period_in_days, compute_model, compute_count, ocpu_count, db_workload, data_storage_size_in_tbs, data_storage_size_in_gbs, is_free_tier, kms_key_id, vault_id, admin_password, display_name, license_model, is_preview_version_with_service_terms_accepted, is_auto_scaling_enabled, is_dev_tier, is_dedicated, autonomous_container_database_id, in_memory_percentage, is_access_control_enabled, whitelisted_ips, are_primary_whitelisted_ips_used, standby_whitelisted_ips, is_data_guard_enabled, is_local_data_guard_enabled, subnet_id, nsg_ids, private_endpoint_label, freeform_tags, defined_tags, private_endpoint_ip, db_version, customer_contacts, is_mtls_connection_required, resource_pool_leader_id, resource_pool_summary, autonomous_maintenance_schedule_type, scheduled_operations, is_auto_scaling_for_storage_enabled, database_edition, db_tools_details, secret_id, secret_version_number, refreshable_mode, auto_refresh_frequency_in_seconds, auto_refresh_point_lag_in_seconds, time_of_auto_refresh_start, open_mode):
 
     kwargs = {}
     kwargs['opc_request_id'] = cli_util.use_or_generate_request_id(ctx.obj['request_id'])
@@ -3964,6 +3970,18 @@ def create_autonomous_database_create_refreshable_autonomous_database_clone_deta
     if refreshable_mode is not None:
         _details['refreshableMode'] = refreshable_mode
 
+    if auto_refresh_frequency_in_seconds is not None:
+        _details['autoRefreshFrequencyInSeconds'] = auto_refresh_frequency_in_seconds
+
+    if auto_refresh_point_lag_in_seconds is not None:
+        _details['autoRefreshPointLagInSeconds'] = auto_refresh_point_lag_in_seconds
+
+    if time_of_auto_refresh_start is not None:
+        _details['timeOfAutoRefreshStart'] = time_of_auto_refresh_start
+
+    if open_mode is not None:
+        _details['openMode'] = open_mode
+
     _details['source'] = 'CLONE_TO_REFRESHABLE'
 
     client = cli_util.build_client('database', 'database', ctx)
@@ -21617,6 +21635,9 @@ def update_autonomous_container_database_dataguard_association(ctx, from_json, w
 This setting cannot be updated in parallel with any of the following: licenseModel, dbEdition, cpuCoreCount, computeCount, computeModel, adminPassword, whitelistedIps, isMTLSConnectionRequired, dbWorkload, dbVersion, isRefreshable, dbName, scheduledOperations, dbToolsDetails, or isFreeTier.""")
 @cli_util.option('--private-endpoint-ip', help=u"""The private endpoint Ip address for the resource.""")
 @cli_util.option('--nsg-ids', type=custom_types.CLI_COMPLEX_TYPE, help=u"""The list of [OCIDs] for the network security groups (NSGs) to which this resource belongs. Setting this to an empty list removes all resources from all NSGs. For more information about NSGs, see [Security Rules]. **NsgIds restrictions:** - A network security group (NSG) is optional for Autonomous Databases with private access. The nsgIds list can be empty.""" + custom_types.cli_complex_type.COMPLEX_TYPE_HELP)
+@cli_util.option('--auto-refresh-frequency-in-seconds', type=click.INT, help=u"""The frequency a refreshable clone is refreshed after auto-refresh is enabled. The minimum is 1 hour. The maximum is 7 days. The date and time that auto-refresh is enabled is controlled by the `timeOfAutoRefreshStart` parameter.""")
+@cli_util.option('--auto-refresh-point-lag-in-seconds', type=click.INT, help=u"""The time, in seconds, the data of the refreshable clone lags the primary database at the point of refresh. The minimum is 0 minutes (0 mins means refresh to the latest available timestamp). The maximum is 7 days. The lag time increases after refreshing until the next data refresh happens.""")
+@cli_util.option('--time-of-auto-refresh-start', type=custom_types.CLI_DATETIME, help=u"""The the date and time that auto-refreshing will begin for an Autonomous Database refreshable clone. This value controls only the start time for the first refresh operation. Subsequent (ongoing) refresh operations have start times controlled by the value of the `autoRefreshFrequencyInSeconds` parameter.""" + custom_types.CLI_DATETIME.VALID_DATETIME_CLI_HELP_MESSAGE)
 @cli_util.option('--customer-contacts', type=custom_types.CLI_COMPLEX_TYPE, help=u"""Customer Contacts. Setting this to an empty list removes all customer contacts of an Oracle
 
 This cannot be updated in parallel with any of the following: isMTLSConnectionRequired, scheduledOperations, or dbToolsDetails.
@@ -21655,7 +21676,7 @@ def update_autonomous_container_database_dataguard_association(ctx, from_json, w
 @click.pass_context
 @json_skeleton_utils.json_skeleton_generation_handler(input_params_to_complex_types={'long-term-backup-schedule': {'module': 'database', 'class': 'LongTermBackUpScheduleDetails'}, 'freeform-tags': {'module': 'database', 'class': 'dict(str, string)'}, 'defined-tags': {'module': 'database', 'class': 'dict(str, dict(str, object))'}, 'whitelisted-ips': {'module': 'database', 'class': 'list[string]'}, 'standby-whitelisted-ips': {'module': 'database', 'class': 'list[string]'}, 'nsg-ids': {'module': 'database', 'class': 'list[string]'}, 'customer-contacts': {'module': 'database', 'class': 'list[CustomerContact]'}, 'resource-pool-summary': {'module': 'database', 'class': 'ResourcePoolSummary'}, 'scheduled-operations': {'module': 'database', 'class': 'list[ScheduledOperationDetails]'}, 'db-tools-details': {'module': 'database', 'class': 'list[DatabaseTool]'}}, output_type={'module': 'database', 'class': 'AutonomousDatabase'})
 @cli_util.wrap_exceptions
-def update_autonomous_database(ctx, from_json, force, wait_for_state, max_wait_seconds, wait_interval_seconds, autonomous_database_id, backup_retention_period_in_days, compute_model, in_memory_percentage, local_adg_auto_failover_max_data_loss_limit, cpu_core_count, long_term_backup_schedule, is_dev_tier, compute_count, ocpu_count, data_storage_size_in_tbs, data_storage_size_in_gbs, display_name, is_free_tier, admin_password, db_name, freeform_tags, defined_tags, db_workload, license_model, is_access_control_enabled, whitelisted_ips, are_primary_whitelisted_ips_used, standby_whitelisted_ips, is_auto_scaling_enabled, is_refreshable_clone, refreshable_mode, is_local_data_guard_enabled, is_data_guard_enabled, peer_db_id, db_version, open_mode, permission_level, subnet_id, private_endpoint_label, private_endpoint_ip, nsg_ids, customer_contacts, is_mtls_connection_required, resource_pool_leader_id, resource_pool_summary, scheduled_operations, is_auto_scaling_for_storage_enabled, database_edition, db_tools_details, secret_id, secret_version_number, if_match):
+def update_autonomous_database(ctx, from_json, force, wait_for_state, max_wait_seconds, wait_interval_seconds, autonomous_database_id, backup_retention_period_in_days, compute_model, in_memory_percentage, local_adg_auto_failover_max_data_loss_limit, cpu_core_count, long_term_backup_schedule, is_dev_tier, compute_count, ocpu_count, data_storage_size_in_tbs, data_storage_size_in_gbs, display_name, is_free_tier, admin_password, db_name, freeform_tags, defined_tags, db_workload, license_model, is_access_control_enabled, whitelisted_ips, are_primary_whitelisted_ips_used, standby_whitelisted_ips, is_auto_scaling_enabled, is_refreshable_clone, refreshable_mode, is_local_data_guard_enabled, is_data_guard_enabled, peer_db_id, db_version, open_mode, permission_level, subnet_id, private_endpoint_label, private_endpoint_ip, nsg_ids, auto_refresh_frequency_in_seconds, auto_refresh_point_lag_in_seconds, time_of_auto_refresh_start, customer_contacts, is_mtls_connection_required, resource_pool_leader_id, resource_pool_summary, scheduled_operations, is_auto_scaling_for_storage_enabled, database_edition, db_tools_details, secret_id, secret_version_number, if_match):
 
     if isinstance(autonomous_database_id, six.string_types) and len(autonomous_database_id.strip()) == 0:
         raise click.UsageError('Parameter --autonomous-database-id cannot be whitespace or empty string')
@@ -21779,6 +21800,15 @@ def update_autonomous_database(ctx, from_json, force, wait_for_state, max_wait_s
     if nsg_ids is not None:
         _details['nsgIds'] = cli_util.parse_json_parameter("nsg_ids", nsg_ids)
 
+    if auto_refresh_frequency_in_seconds is not None:
+        _details['autoRefreshFrequencyInSeconds'] = auto_refresh_frequency_in_seconds
+
+    if auto_refresh_point_lag_in_seconds is not None:
+        _details['autoRefreshPointLagInSeconds'] = auto_refresh_point_lag_in_seconds
+
+    if time_of_auto_refresh_start is not None:
+        _details['timeOfAutoRefreshStart'] = time_of_auto_refresh_start
+
     if customer_contacts is not None:
         _details['customerContacts'] = cli_util.parse_json_parameter("customer_contacts", customer_contacts)