Merge pull request #631 from oracle/release_2023-01-24

Releasing version 3.22.3

Author: Kanvipasricha

CHANGELOG.rst

@@ -6,6 +6,43 @@ All notable changes to this project will be documented in this file.
 
 The format is based on `Keep a Changelog <http://keepachangelog.com/>`__.
 
+3.22.3 - 2023-01-24
+--------------------
+Added
+~~~~~
+
+* Support for the Cloud Migrations service
+
+  * ``oci cloud-migrations``
+
+* Support for new optional parameter to set Custom Private IP during Private End Point provisioning in the Database service
+
+  * ``oci db autonomous-database create --private-endpoint-ip``
+  * ``oci db autonomous-database create-adb-cross-region-data-guard-details --private-endpoint-ip``
+  * ``oci db autonomous-database create-from-backup-id --private-endpoint-ip``
+  * ``oci db autonomous-database create-from-backup-timestamp --private-endpoint-ip``
+  * ``oci db autonomous-database create-from-clone --private-endpoint-ip``
+  * ``oci db autonomous-database create-refreshable-clone --private-endpoint-ip``
+  * ``oci db autonomous-database update --private-endpoint-ip``
+
+* Support for Machine Learning pipelines for the Data Science Service
+
+  * ``oci data-science pipeline``
+  * ``oci data-science pipeline-run``
+
+* Support for the language PII (Personal Identifiable Information) detection in the AI Language service
+
+  * ``oci ai language batch-detect-pii-entities``
+
+* Support for cross region replication in the File Storage service
+
+  * ``oci fs replication create``
+  * ``oci fs replication get``
+  * ``oci fs replication list``
+  * ``oci fs replication delete``
+  * ``oci fs replication change-compartment``
+  * ``oci fs file-system estimate-replication``
+  
 3.22.2 - 2023-01-17
 --------------------
 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.90.2
+oci==2.90.3
 packaging==20.2
 pluggy==0.13.0
 py==1.10.0

services/ai_language/src/oci_cli_ai_service_language/aiservicelanguage_cli_extended.py

@@ -36,6 +36,7 @@ def language_group():
 cli_util.rename_command(aiservicelanguage_cli, aiservicelanguage_cli.batch_detect_language_key_phrases_group, aiservicelanguage_cli.batch_detect_language_key_phrases, "batch-detect-key-phrases")
 cli_util.rename_command(aiservicelanguage_cli, aiservicelanguage_cli.batch_detect_language_sentiments_group, aiservicelanguage_cli.batch_detect_language_sentiments, "batch-detect-sentiments")
 cli_util.rename_command(aiservicelanguage_cli, aiservicelanguage_cli.batch_detect_language_text_classification_group, aiservicelanguage_cli.batch_detect_language_text_classification, "batch-detect-text-classification")
+cli_util.rename_command(aiservicelanguage_cli, aiservicelanguage_cli.batch_detect_language_pii_entities_group, aiservicelanguage_cli.batch_detect_language_pii_entities, "batch-detect-pii-entities")
 
 # Single Documents APIs
 cli_util.rename_command(aiservicelanguage_cli, aiservicelanguage_cli.detect_dominant_language_group, aiservicelanguage_cli.detect_dominant_language, "detect-language")
@@ -50,6 +51,7 @@ def language_group():
 aiservicelanguage_cli.ai_root_group.commands.pop(aiservicelanguage_cli.batch_detect_language_key_phrases_group.name)
 aiservicelanguage_cli.ai_root_group.commands.pop(aiservicelanguage_cli.batch_detect_language_sentiments_group.name)
 aiservicelanguage_cli.ai_root_group.commands.pop(aiservicelanguage_cli.batch_detect_language_text_classification_group.name)
+aiservicelanguage_cli.ai_root_group.commands.pop(aiservicelanguage_cli.batch_detect_language_pii_entities_group.name)
 
 # Single Documents APIs
 aiservicelanguage_cli.ai_root_group.commands.pop(aiservicelanguage_cli.detect_dominant_language_group.name)
@@ -65,6 +67,7 @@ def language_group():
 language_group.add_command(aiservicelanguage_cli.batch_detect_language_key_phrases)
 language_group.add_command(aiservicelanguage_cli.batch_detect_language_sentiments)
 language_group.add_command(aiservicelanguage_cli.batch_detect_language_text_classification)
+language_group.add_command(aiservicelanguage_cli.batch_detect_language_pii_entities)
 
 # Single Documents APIs
 aiservicelanguage_cli.ai_root_group.add_command(language_group)

services/ai_language/src/oci_cli_ai_service_language/generated/aiservicelanguage_cli.py

@@ -71,6 +71,12 @@ def detect_language_sentiments_group():
     pass
 
 
+@click.command(cli_util.override('ai.batch_detect_language_pii_entities_group.command_name', 'batch-detect-language-pii-entities'), cls=CommandGroupWithAlias, help="""""")
+@cli_util.help_option_group
+def batch_detect_language_pii_entities_group():
+    pass
+
+
 @click.command(cli_util.override('ai.batch_language_translation_group.command_name', 'batch-language-translation'), cls=CommandGroupWithAlias, help="""""")
 @cli_util.help_option_group
 def batch_language_translation_group():
@@ -139,6 +145,7 @@ def batch_detect_language_text_classification_group():
 ai_root_group.add_command(work_request_group)
 ai_root_group.add_command(evaluation_result_collection_group)
 ai_root_group.add_command(detect_language_sentiments_group)
+ai_root_group.add_command(batch_detect_language_pii_entities_group)
 ai_root_group.add_command(batch_language_translation_group)
 ai_root_group.add_command(batch_detect_language_sentiments_group)
 ai_root_group.add_command(detect_language_entities_group)
@@ -246,6 +253,41 @@ def batch_detect_language_key_phrases(ctx, from_json, documents, compartment_id)
     cli_util.render_response(result, ctx)
 
 
+@batch_detect_language_pii_entities_group.command(name=cli_util.override('ai.batch_detect_language_pii_entities.command_name', 'batch-detect-language-pii-entities'), help=u"""The API extracts pii entities in text records. For each entity, its type and confidence score (between 0 and 1) is returned.  It supports passing a batch of records.
+
+Limitations: - A batch may have up to 100 records. - A record may be up to 5000 characters long. - The total of characters to process in a request can be up to 20,000 characters. \n[Command Reference](batchDetectLanguagePiiEntities)""")
+@cli_util.option('--documents', required=True, type=custom_types.CLI_COMPLEX_TYPE, help=u"""List of documents to detect personal identification information.""" + custom_types.cli_complex_type.COMPLEX_TYPE_HELP)
+@cli_util.option('--compartment-id', help=u"""The [OCID] of the compartment that calls the API, inference will be served from pre trained model""")
+@cli_util.option('--masking', type=custom_types.CLI_COMPLEX_TYPE, help=u"""Mask recognized PII entities with different modes.
+
+This option is a JSON dictionary of type dict(str, PiiEntityMasking).  For documentation on PiiEntityMasking please see our API reference: https://docs.cloud.oracle.com/api/#/en/aiservicelanguage/20221001/datatypes/PiiEntityMasking.""" + custom_types.cli_complex_type.COMPLEX_TYPE_HELP)
+@json_skeleton_utils.get_cli_json_input_option({'documents': {'module': 'ai_language', 'class': 'list[TextDocument]'}, 'masking': {'module': 'ai_language', 'class': 'dict(str, PiiEntityMasking)'}})
+@cli_util.help_option
+@click.pass_context
+@json_skeleton_utils.json_skeleton_generation_handler(input_params_to_complex_types={'documents': {'module': 'ai_language', 'class': 'list[TextDocument]'}, 'masking': {'module': 'ai_language', 'class': 'dict(str, PiiEntityMasking)'}}, output_type={'module': 'ai_language', 'class': 'BatchDetectLanguagePiiEntitiesResult'})
+@cli_util.wrap_exceptions
+def batch_detect_language_pii_entities(ctx, from_json, documents, compartment_id, masking):
+
+    kwargs = {}
+    kwargs['opc_request_id'] = cli_util.use_or_generate_request_id(ctx.obj['request_id'])
+
+    _details = {}
+    _details['documents'] = cli_util.parse_json_parameter("documents", documents)
+
+    if compartment_id is not None:
+        _details['compartmentId'] = compartment_id
+
+    if masking is not None:
+        _details['masking'] = cli_util.parse_json_parameter("masking", masking)
+
+    client = cli_util.build_client('ai_language', 'ai_service_language', ctx)
+    result = client.batch_detect_language_pii_entities(
+        batch_detect_language_pii_entities_details=_details,
+        **kwargs
+    )
+    cli_util.render_response(result, ctx)
+
+
 @batch_detect_language_sentiments_group.command(name=cli_util.override('ai.batch_detect_language_sentiments.command_name', 'batch-detect-language-sentiments'), help=u"""The API extracts aspect-based and sentence level sentiment in text records.
 
 For aspect-based sentiment analysis, a set of aspects and their respective sentiment is returned for each record. Similarly, for sentence-level sentiment analysis, the sentiment is returned at the sentence level.
@@ -1212,9 +1254,11 @@ def delete_project(ctx, from_json, wait_for_state, max_wait_seconds, wait_interv
     cli_util.render_response(result, ctx)
 
 
-@detect_dominant_language_group.command(name=cli_util.override('ai.detect_dominant_language.command_name', 'detect-dominant-language'), help=u"""The API returns the detected language and a related confidence score (between 0 and 1).
+@detect_dominant_language_group.command(name=cli_util.override('ai.detect_dominant_language.command_name', 'detect-dominant-language'), help=u"""**Deprecated**: This API will be retired Tuesday, 10 Oct 2023 00:00:00 GMT. We recommend you replace this API with the batch API, [BatchDetectDominantLanguage].
 
-[List of supported languages.]
+The DetectDominantLanguage API returns the detected language and a related confidence score (between 0 and 1).
+
+[List of supported languages]
 
 Limitations: - A record may be up to 1000 characters long. \n[Command Reference](detectDominantLanguage)""")
 @cli_util.option('--text', required=True, help=u"""Document text for detect language.""")
@@ -1239,7 +1283,9 @@ def detect_dominant_language(ctx, from_json, text):
     cli_util.render_response(result, ctx)
 
 
-@detect_language_entities_group.command(name=cli_util.override('ai.detect_language_entities.command_name', 'detect-language-entities'), help=u"""The API extracts entities in text records. For each entity, its type and confidence score (between 0 and 1) is returned.
+@detect_language_entities_group.command(name=cli_util.override('ai.detect_language_entities.command_name', 'detect-language-entities'), help=u"""**Deprecated**: This API will be retired Tuesday, 10 Oct 2023 00:00:00 GMT. We recommend you replace this API with the batch API, [BatchDetectLanguageEntities].
+
+The DetectLanguageEntities API extracts entities in text records. For each entity, its type and confidence score (between 0 and 1) is returned.
 
 Limitations: - A text may be up to 1000 characters long. \n[Command Reference](detectLanguageEntities)""")
 @cli_util.option('--text', required=True, help=u"""Document text for detect entities.""")
@@ -1270,7 +1316,9 @@ def detect_language_entities(ctx, from_json, text, model_version, is_pii):
     cli_util.render_response(result, ctx)
 
 
-@detect_language_key_phrases_group.command(name=cli_util.override('ai.detect_language_key_phrases.command_name', 'detect-language-key-phrases'), help=u"""The API extracts key-phrases in text records. For each key-phrase, a score (between 0 and 1) is returned that highlights the importance of the key-phrase in the context of the text.
+@detect_language_key_phrases_group.command(name=cli_util.override('ai.detect_language_key_phrases.command_name', 'detect-language-key-phrases'), help=u"""**Deprecated**: This API will be retired Tuesday, 10 Oct 2023 00:00:00 GMT. We recommend you replace this API with the batch API, [BatchDetectLanguageKeyPhrases].
+
+The DetectLanguageKeyPhrases API extracts key-phrases in text records. For each key-phrase, a score (between 0 and 1) is returned that highlights the importance of the key-phrase in the context of the text.
 
 Limitations: - A record may be up to 1000 characters long. \n[Command Reference](detectLanguageKeyPhrases)""")
 @cli_util.option('--text', required=True, help=u"""Document text for detect keyPhrases.""")
@@ -1295,7 +1343,9 @@ def detect_language_key_phrases(ctx, from_json, text):
     cli_util.render_response(result, ctx)
 
 
-@detect_language_sentiments_group.command(name=cli_util.override('ai.detect_language_sentiments.command_name', 'detect-language-sentiments'), help=u"""The API extracts aspect-based in text records.
+@detect_language_sentiments_group.command(name=cli_util.override('ai.detect_language_sentiments.command_name', 'detect-language-sentiments'), help=u"""**Deprecated**: This API will be retired Tuesday, 10 Oct 2023 00:00:00 GMT. We recommend you replace this API with the batch API, [BatchDetectLanguageSentiments].
+
+The DetectLanguageSentiments API extracts aspect-based in text records.
 
 For aspect-based sentiment analysis, a set of aspects and their respective sentiment is returned.
 
@@ -1326,7 +1376,9 @@ def detect_language_sentiments(ctx, from_json, text):
     cli_util.render_response(result, ctx)
 
 
-@detect_language_text_classification_group.command(name=cli_util.override('ai.detect_language_text_classification.command_name', 'detect-language-text-classification'), help=u"""The API automatically classifies text into a set of pre-determined classes and sub-classes. A single class/subclass is returned for each record classified.
+@detect_language_text_classification_group.command(name=cli_util.override('ai.detect_language_text_classification.command_name', 'detect-language-text-classification'), help=u"""**Deprecated**: This API will be retired Tuesday, 10 Oct 2023 00:00:00 GMT. We recommend you replace this API with the batch API, [BatchDetectLanguageTextClassification].
+
+The DetectLanguageTextClassification API automatically classifies text into a set of pre-determined classes and sub-classes. A single class/subclass is returned for each record classified.
 
 Learn more about text classification [here].
 

services/autoscaling/src/oci_cli_auto_scaling/autoscaling_cli_extended.py

@@ -38,11 +38,11 @@ def create_auto_scaling_policy_extended(ctx, **kwargs):
             raise click.UsageError('If Parameter --policy-type is scheduled, then Parameter --execution-schedule must be provided')
         else:
             # Since autoscaling_cli.create_auto_scaling_policy_create_scheduled_policy_details doesn't expect the parameter policy_type
-            del(kwargs['policy_type'])
+            del (kwargs['policy_type'])
             ctx.invoke(autoscaling_cli.create_auto_scaling_policy_create_scheduled_policy_details, **kwargs)
     else:
         # Since autoscaling_cli.create_auto_scaling_policy doesn't expect the parameter execution_schedule
-        del(kwargs['execution_schedule'])
+        del (kwargs['execution_schedule'])
         ctx.invoke(autoscaling_cli.create_auto_scaling_policy, **kwargs)
 
 
@@ -58,9 +58,9 @@ def update_auto_scaling_policy_extended(ctx, **kwargs):
             raise click.UsageError('If Parameter --policy-type is scheduled, then Parameter --execution-schedule must be provided')
         else:
             # Since autoscaling_cli.update_auto_scaling_policy_update_scheduled_policy_details doesn't expect the parameter policy_type
-            del(kwargs['policy_type'])
+            del (kwargs['policy_type'])
             ctx.invoke(autoscaling_cli.update_auto_scaling_policy_update_scheduled_policy_details, **kwargs)
     else:
         # Since autoscaling_cli.update_auto_scaling_policy doesn't expect the parameter execution_schedule
-        del(kwargs['execution_schedule'])
+        del (kwargs['execution_schedule'])
         ctx.invoke(autoscaling_cli.update_auto_scaling_policy, **kwargs)