Releasing version 3.33.1

Co-authored-by: Hamada Ibrahim <[email protected]>
Co-authored-by: Harsh Kumar <[email protected]>
Co-authored-by: Kanvi Pasricha <[email protected]>
Co-authored-by: Alex Le <[email protected]>
Co-authored-by: Nupur Gupta <[email protected]>
Co-authored-by: Karthik Kamath <[email protected]>
Co-authored-by: Mandy Tsai <[email protected]>
Co-authored-by: Anup Singh <[email protected]>

Author: 9 people

CHANGELOG.rst

@@ -6,6 +6,45 @@ All notable changes to this project will be documented in this file.
 
 The format is based on `Keep a Changelog <http://keepachangelog.com/>`__.
 
+3.33.1 - 2023-09-12
+--------------------
+Added
+~~~~~
+* Support for --is-dedicated optional param for listCharactersSets api in the Database service
+
+  * ``oci db autonomous-database-character-sets list --is-dedicated``
+
+* Support for face detection feature in Vision Service ("featureType":"FACE_DETECTION")
+
+  * ``oci ai-vision image-job create --features``
+
+* Stack Monitoring
+
+    * New api for stack-monitoring config
+
+      * ``oci stack-monitoring config change-compartment``
+      * ``oci stack-monitoring config create``
+      * ``oci stack-monitoring config create-auto-promote-config``
+      * ``oci stack-monitoring config delete``
+      * ``oci stack-monitoring config get``
+      * ``oci stack-monitoring config update``
+      * ``oci stack-monitoring config update-auto-promote-config``
+      * ``oci stack-monitoring config list``
+
+* Support for Announcement Chaining in Announcements Service, adding two new optional parameters
+
+    * ``oci announce announcements list --chain-id --should-show-only-latest-in-chain``
+
+* Database Management Service
+
+    * Support for SQL tuning set
+
+      * ``oci database-management perfhub managed-database modify-snapshot-settings``
+
+  * Existing parameter connection-info is now an optional parameter
+
+    * ``oci database-management external-db-system-connector update-macs-connector --connection-info``
+
 3.33.0 - 2023-09-05
 --------------------
 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.112.0
+oci==2.112.1
 packaging==20.2
 pluggy==0.13.0
 py==1.11.0

services/ai_vision/src/oci_cli_ai_service_vision/generated/aiservicevision_cli.py

@@ -332,7 +332,7 @@ def analyze_image_inline_image_details(ctx, from_json, features, image_data, com
 
 
 @document_job_group.command(name=cli_util.override('ai_vision.cancel_document_job.command_name', 'cancel'), help=u"""Cancel a document batch job. \n[Command Reference](cancelDocumentJob)""")
-@cli_util.option('--document-job-id', required=True, help=u"""Document job id.""")
+@cli_util.option('--document-job-id', required=True, help=u"""The document job ID.""")
 @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
@@ -357,7 +357,7 @@ def cancel_document_job(ctx, from_json, document_job_id, if_match):
 
 
 @image_job_group.command(name=cli_util.override('ai_vision.cancel_image_job.command_name', 'cancel'), help=u"""Cancel an image batch job. \n[Command Reference](cancelImageJob)""")
-@cli_util.option('--image-job-id', required=True, help=u"""Image job id.""")
+@cli_util.option('--image-job-id', required=True, help=u"""The image job ID.""")
 @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
@@ -1012,7 +1012,7 @@ def delete_project(ctx, from_json, wait_for_state, max_wait_seconds, wait_interv
 
 
 @document_job_group.command(name=cli_util.override('ai_vision.get_document_job.command_name', 'get'), help=u"""Get details of a document batch job. \n[Command Reference](getDocumentJob)""")
-@cli_util.option('--document-job-id', required=True, help=u"""Document job id.""")
+@cli_util.option('--document-job-id', required=True, help=u"""The document job ID.""")
 @json_skeleton_utils.get_cli_json_input_option({})
 @cli_util.help_option
 @click.pass_context
@@ -1034,7 +1034,7 @@ def get_document_job(ctx, from_json, document_job_id):
 
 
 @image_job_group.command(name=cli_util.override('ai_vision.get_image_job.command_name', 'get'), help=u"""Get details of an image batch job. \n[Command Reference](getImageJob)""")
-@cli_util.option('--image-job-id', required=True, help=u"""Image job id.""")
+@cli_util.option('--image-job-id', required=True, help=u"""The image job ID.""")
 @json_skeleton_utils.get_cli_json_input_option({})
 @cli_util.help_option
 @click.pass_context

services/announcements_service/src/oci_cli_announcement/generated/announcement_cli.py

@@ -111,14 +111,16 @@ def get_announcement_user_status(ctx, from_json, announcement_id):
 @cli_util.option('--service', help=u"""A filter to return only announcements affecting a specific service.""")
 @cli_util.option('--platform-type', type=custom_types.CliCaseInsensitiveChoice(["IAAS", "SAAS"]), help=u"""A filter to return only announcements affecting a specific platform.""")
 @cli_util.option('--exclude-announcement-types', multiple=True, help=u"""Exclude The type of announcement.""")
+@cli_util.option('--should-show-only-latest-in-chain', type=click.BOOL, help=u"""A filter to display only the latest announcement in a chain.""")
+@cli_util.option('--chain-id', help=u"""A filter to return only announcements belonging to the specified announcement chain ID.""")
 @cli_util.option('--all', 'all_pages', is_flag=True, help="""Fetches all pages of results. If you provide this option, then you cannot provide the --limit option.""")
 @cli_util.option('--page-size', type=click.INT, help="""When fetching results, the number of results to fetch per call. Only valid when used with --all or --limit, and ignored otherwise.""")
 @json_skeleton_utils.get_cli_json_input_option({'exclude-announcement-types': {'module': 'announcements_service', 'class': 'list[string]'}})
 @cli_util.help_option
 @click.pass_context
 @json_skeleton_utils.json_skeleton_generation_handler(input_params_to_complex_types={'exclude-announcement-types': {'module': 'announcements_service', 'class': 'list[string]'}}, output_type={'module': 'announcements_service', 'class': 'AnnouncementsCollection'})
 @cli_util.wrap_exceptions
-def list_announcements(ctx, from_json, all_pages, page_size, compartment_id, limit, page, announcement_type, lifecycle_state, is_banner, sort_by, sort_order, time_one_earliest_time, time_one_latest_time, environment_name, service, platform_type, exclude_announcement_types):
+def list_announcements(ctx, from_json, all_pages, page_size, compartment_id, limit, page, announcement_type, lifecycle_state, is_banner, sort_by, sort_order, time_one_earliest_time, time_one_latest_time, environment_name, service, platform_type, exclude_announcement_types, should_show_only_latest_in_chain, chain_id):
 
     if all_pages and limit:
         raise click.UsageError('If you provide the --all option you cannot provide the --limit option')
@@ -150,6 +152,10 @@ def list_announcements(ctx, from_json, all_pages, page_size, compartment_id, lim
         kwargs['platform_type'] = platform_type
     if exclude_announcement_types is not None and len(exclude_announcement_types) > 0:
         kwargs['exclude_announcement_types'] = exclude_announcement_types
+    if should_show_only_latest_in_chain is not None:
+        kwargs['should_show_only_latest_in_chain'] = should_show_only_latest_in_chain
+    if chain_id is not None:
+        kwargs['chain_id'] = chain_id
     kwargs['opc_request_id'] = cli_util.use_or_generate_request_id(ctx.obj['request_id'])
     client = cli_util.build_client('announcements_service', 'announcement', ctx)
     if all_pages:

services/announcements_service/src/oci_cli_announcement_subscription/generated/announcementsubscription_cli.py

@@ -82,8 +82,8 @@ def change_announcement_subscription_compartment(ctx, from_json, announcement_su
 @cli_util.option('--filter-groups', type=custom_types.CLI_COMPLEX_TYPE, help=u"""A list of filter groups for the announcement subscription. A filter group combines one or more filters that the Announcements service applies to announcements for matching purposes.
 
 This option is a JSON dictionary of type dict(str, FilterGroupDetails).  For documentation on FilterGroupDetails please see our API reference: https://docs.cloud.oracle.com/api/#/en/announcementsubscription/0.0.1/datatypes/FilterGroupDetails.""" + custom_types.cli_complex_type.COMPLEX_TYPE_HELP)
-@cli_util.option('--preferred-language', help=u"""(For announcement subscriptions with Oracle Fusion Applications configured as the service only) The language in which the user prefers to receive emailed announcements. Specify the preference with a value that uses the language tag format (x-obmcs-human-language). For example fr-FR.""")
-@cli_util.option('--preferred-time-zone', help=u"""The time zone that the user prefers for announcement time stamps. Specify the preference with a value that uses the IANA Time Zone Database format (x-obmcs-time-zone). For example America/Los_Angeles.""")
+@cli_util.option('--preferred-language', help=u"""(For announcement subscriptions with SaaS configured as the platform type or Oracle Fusion Applications as the service, or both, only) The language in which the user prefers to receive emailed announcements. Specify the preference with a value that uses the x-obmcs-human-language format. For example fr-FR.""")
+@cli_util.option('--preferred-time-zone', help=u"""The time zone in which the user prefers to receive announcements. Specify the preference with a value that uses the IANA Time Zone Database format (x-obmcs-time-zone). For example - America/Los_Angeles""")
 @cli_util.option('--freeform-tags', type=custom_types.CLI_COMPLEX_TYPE, help=u"""Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: `{\"bar-key\": \"value\"}`""" + custom_types.cli_complex_type.COMPLEX_TYPE_HELP)
 @cli_util.option('--defined-tags', type=custom_types.CLI_COMPLEX_TYPE, help=u"""Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: `{\"foo-namespace\": {\"bar-key\": \"value\"}}`""" + custom_types.cli_complex_type.COMPLEX_TYPE_HELP)
 @cli_util.option('--wait-for-state', type=custom_types.CliCaseInsensitiveChoice(["ACTIVE", "DELETED", "FAILED"]), 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.""")
@@ -383,8 +383,8 @@ def list_announcement_subscriptions(ctx, from_json, all_pages, page_size, compar
 @cli_util.option('--display-name', help=u"""A user-friendly name for the announcement subscription. Does not have to be unique, and it's changeable. Avoid entering confidential information.""")
 @cli_util.option('--description', help=u"""A description of the announcement subscription. Avoid entering confidential information.""")
 @cli_util.option('--ons-topic-id', help=u"""The [OCID] of the Notifications service topic that is the target for publishing announcements that match the configured announcement subscription. The caller of the operation needs the ONS_TOPIC_PUBLISH permission for the targeted Notifications service topic. For more information about Notifications permissions, see [Details for Notifications].""")
-@cli_util.option('--preferred-language', help=u"""(For announcement subscriptions with Oracle Fusion Applications configured as the service only) The language in which the user prefers to receive emailed announcements. Specify the preference with a value that uses the language tag format (x-obmcs-human-language). For example fr-FR.""")
-@cli_util.option('--preferred-time-zone', help=u"""The time zone that the user prefers for announcement time stamps. Specify the preference with a value that uses the IANA Time Zone Database format (x-obmcs-time-zone). For example America/Los_Angeles.""")
+@cli_util.option('--preferred-language', help=u"""(For announcement subscriptions with SaaS configured as the platform type or Oracle Fusion Applications as the service, or both, only) The language in which the user prefers to receive emailed announcements. Specify the preference with a value that uses the x-obmcs-human-language format. For example fr-FR.""")
+@cli_util.option('--preferred-time-zone', help=u"""The time zone in which the user prefers to receive announcements. Specify the preference with a value that uses the IANA Time Zone Database format (x-obmcs-time-zone). For example - America/Los_Angeles""")
 @cli_util.option('--freeform-tags', type=custom_types.CLI_COMPLEX_TYPE, help=u"""Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: `{\"bar-key\": \"value\"}`""" + custom_types.cli_complex_type.COMPLEX_TYPE_HELP)
 @cli_util.option('--defined-tags', type=custom_types.CLI_COMPLEX_TYPE, help=u"""Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: `{\"foo-namespace\": {\"bar-key\": \"value\"}}`""" + custom_types.cli_complex_type.COMPLEX_TYPE_HELP)
 @cli_util.option('--if-match', help=u"""The locking version, used for optimistic concurrency control.""")
@@ -471,7 +471,7 @@ def update_announcement_subscription(ctx, from_json, force, wait_for_state, max_
 This call is subject to an Announcements limit that applies to the total number of requests across all read or write operations. Announcements might throttle this call to reject an otherwise valid request when the total rate of operations exceeds 20 requests per second for a given user. The service might also throttle this call to reject an otherwise valid request when the total rate of operations exceeds 100 requests per second for a given tenancy. \n[Command Reference](updateFilterGroup)""")
 @cli_util.option('--announcement-subscription-id', required=True, help=u"""The OCID of the announcement subscription.""")
 @cli_util.option('--filter-group-name', required=True, help=u"""The name of the filter group.""")
-@cli_util.option('--filters', required=True, type=custom_types.CLI_COMPLEX_TYPE, help=u"""A list of filters against which the Announcements service will match announcements. You cannot have more than one of any given filter type within a filter group.""" + custom_types.cli_complex_type.COMPLEX_TYPE_HELP)
+@cli_util.option('--filters', required=True, type=custom_types.CLI_COMPLEX_TYPE, help=u"""A list of filters against which the Announcements service will match announcements. You cannot combine the RESOURCE_ID filter with any other type of filter within a given filter group. For filter types that support multiple values, specify the values individually.""" + custom_types.cli_complex_type.COMPLEX_TYPE_HELP)
 @cli_util.option('--if-match', help=u"""The locking version, used for optimistic concurrency control.""")
 @cli_util.option('--force', help="""Perform update without prompting for confirmation.""", is_flag=True)
 @json_skeleton_utils.get_cli_json_input_option({'filters': {'module': 'announcements_service', 'class': 'list[Filter]'}})

services/announcements_service/src/oci_cli_announcements_preferences/generated/announcementspreferences_cli.py

@@ -39,7 +39,7 @@ def announcements_preferences_group():
 @cli_util.option('--preference-type', required=True, type=custom_types.CliCaseInsensitiveChoice(["OPT_IN_TENANT_ANNOUNCEMENTS", "OPT_IN_TENANT_AND_INFORMATIONAL_ANNOUNCEMENTS", "OPT_OUT_ALL_ANNOUNCEMENTS"]), help=u"""The string representing the user's preference, whether to opt in to only required announcements, to opt in to all announcements, including informational announcements, or to opt out of all announcements.""")
 @cli_util.option('--is-unsubscribed', type=click.BOOL, help=u"""A Boolean value to indicate whether the specified compartment chooses to not to receive informational announcements by email. (Manage preferences for receiving announcements by email by specifying the `preferenceType` attribute instead.)""")
 @cli_util.option('--compartment-id', help=u"""The OCID of the compartment for which you want to manage announcement email preferences. (Specify the tenancy by providing the root compartment OCID.)""")
-@cli_util.option('--preferred-time-zone', help=u"""The time zone that the user prefers for announcement time stamps. Specify the preference with a value that uses the IANA Time Zone Database format (x-obmcs-time-zone). For example America/Los_Angeles.""")
+@cli_util.option('--preferred-time-zone', help=u"""The time zone in which the user prefers to receive announcements. Specify the preference with a value that uses the IANA Time Zone Database format (x-obmcs-time-zone). For example - America/Los_Angeles""")
 @json_skeleton_utils.get_cli_json_input_option({})
 @cli_util.help_option
 @click.pass_context
@@ -155,7 +155,7 @@ def list_announcements_preferences(ctx, from_json, all_pages, page_size, compart
 @cli_util.option('--preference-type', required=True, type=custom_types.CliCaseInsensitiveChoice(["OPT_IN_TENANT_ANNOUNCEMENTS", "OPT_IN_TENANT_AND_INFORMATIONAL_ANNOUNCEMENTS", "OPT_OUT_ALL_ANNOUNCEMENTS"]), help=u"""The string representing the user's preference, whether to opt in to only required announcements, to opt in to all announcements, including informational announcements, or to opt out of all announcements.""")
 @cli_util.option('--is-unsubscribed', type=click.BOOL, help=u"""A Boolean value to indicate whether the specified compartment chooses to not to receive informational announcements by email. (Manage preferences for receiving announcements by email by specifying the `preferenceType` attribute instead.)""")
 @cli_util.option('--compartment-id', help=u"""The OCID of the compartment for which you want to manage announcement email preferences. (Specify the tenancy by providing the root compartment OCID.)""")
-@cli_util.option('--preferred-time-zone', help=u"""The time zone that the user prefers for announcement time stamps. Specify the preference with a value that uses the IANA Time Zone Database format (x-obmcs-time-zone). For example America/Los_Angeles.""")
+@cli_util.option('--preferred-time-zone', help=u"""The time zone in which the user prefers to receive announcements. Specify the preference with a value that uses the IANA Time Zone Database format (x-obmcs-time-zone). For example - America/Los_Angeles""")
 @cli_util.option('--if-match', help=u"""The locking version, used for optimistic concurrency control.""")
 @json_skeleton_utils.get_cli_json_input_option({})
 @cli_util.help_option