Merge pull request #753 from oracle/release_2024-03-05

Releasing version 3.37.12

Author: NiviPari

CHANGELOG.rst

@@ -6,6 +6,47 @@ All notable changes to this project will be documented in this file.
 
 The format is based on `Keep a Changelog <http://keepachangelog.com/>`__.
 
+3.37.12 - 2024-03-05
+--------------------
+Added
+~~~~~
+* Support for server streaming events in the Generative AI Inference Service when `inference-request-is-stream` is set to true
+
+  * ``oci generative-ai-inference generate-text-result generate-text-cohere-llm-inference-request --inference-request-is-stream``
+  * ``oci generative-ai-inference generate-text-result generate-text-llama-llm-inference-request --inference-request-is-stream``
+
+* Speech service
+
+  * Support for Whisper Models in creation of transcription job
+
+    * ``oci speech transcription-job create --model-details``
+
+  * Support for Delete Job API in transcription job
+
+    * ``oci speech transcription-job delete --transcription-job-id``
+
+* Operations Insights service
+
+  * Support for updating host-insights
+
+    * ``oci opsi host-insights update-pe-comanaged-host``
+
+  * Support to receive insights from resources in child compartments for news reports
+
+    * ``oci opsi news-reports create --are-child-compartments-included, --day-of-week``
+
+  * Support to update more parameters for news reports
+
+    * ``oci opsi news-reports update --are-child-compartments-included, --day-of-week, --description, --name``
+
+  * Support to choose the day of the week the report is received for news reports
+
+    * ``oci opsi news-reports update --are-child-compartments-included, --day-of-week, --description, --name``
+
+Changed
+~~~~~~~
+* Upgraded the cryptography version to (>=3.2.1,<43.0.0) and pyOpenSSL version to (>=17.5.0,<25.0.0)
+
 3.37.11 - 2024-02-27
 --------------------
 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.123.0
+oci==2.124.0
 packaging==20.2
 pluggy==0.13.0
 py==1.11.0

services/ai_speech/src/oci_cli_ai_service_speech/generated/aiservicespeech_cli.py

@@ -373,6 +373,70 @@ def create_transcription_job_object_list_inline_input_location(ctx, from_json, w
     cli_util.render_response(result, ctx)
 
 
+@transcription_job_group.command(name=cli_util.override('speech.delete_transcription_job.command_name', 'delete'), help=u"""Delete API cleans job, tasks and the related metadata. However the generated transcriptions in customer tenancy will not be deleted. \n[Command Reference](deleteTranscriptionJob)""")
+@cli_util.option('--transcription-job-id', required=True, help=u"""Unique Transcription Job identifier.""")
+@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.""")
+@cli_util.confirm_delete_option
+@cli_util.option('--wait-for-state', type=custom_types.CliCaseInsensitiveChoice(["ACCEPTED", "IN_PROGRESS", "SUCCEEDED", "FAILED", "CANCELING", "CANCELED"]), 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.""")
+@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 delete_transcription_job(ctx, from_json, wait_for_state, max_wait_seconds, wait_interval_seconds, transcription_job_id, if_match):
+
+    if isinstance(transcription_job_id, six.string_types) and len(transcription_job_id.strip()) == 0:
+        raise click.UsageError('Parameter --transcription-job-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'])
+    client = cli_util.build_client('ai_speech', 'ai_service_speech', ctx)
+    result = client.delete_transcription_job(
+        transcription_job_id=transcription_job_id,
+        **kwargs
+    )
+    if wait_for_state:
+
+        if hasattr(client, 'get_transcription_job') and callable(getattr(client, 'get_transcription_job')):
+            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
+
+                click.echo('Action completed. Waiting until the resource has entered state: {}'.format(wait_for_state), file=sys.stderr)
+                oci.wait_until(client, client.get_transcription_job(transcription_job_id), 'lifecycle_state', wait_for_state, succeed_on_not_found=True, **wait_period_kwargs)
+            except oci.exceptions.ServiceError as e:
+                # We make an initial service call so we can pass the result to oci.wait_until(), however if we are waiting on the
+                # outcome of a delete operation it is possible that the resource is already gone and so the initial service call
+                # will result in an exception that reflects a HTTP 404. In this case, we can exit with success (rather than raising
+                # the exception) since this would have been the behaviour in the waiter anyway (as for delete we provide the argument
+                # succeed_on_not_found=True to the waiter).
+                #
+                # Any non-404 should still result in the exception being thrown.
+                if e.status == 404:
+                    pass
+                else:
+                    raise
+            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 resource entered the specified state. Please retrieve the resource to find its current state', file=sys.stderr)
+                cli_util.render_response(result, ctx)
+                sys.exit(2)
+            except Exception:
+                click.echo('Encountered error while waiting for resource 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 resource to enter the specified state', file=sys.stderr)
+    cli_util.render_response(result, ctx)
+
+
 @transcription_job_group.command(name=cli_util.override('speech.get_transcription_job.command_name', 'get'), help=u"""Gets a Transcription Job by identifier \n[Command Reference](getTranscriptionJob)""")
 @cli_util.option('--transcription-job-id', required=True, help=u"""Unique Transcription Job identifier.""")
 @json_skeleton_utils.get_cli_json_input_option({})

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

@@ -6,6 +6,7 @@
     "speech.cancel_transcription_task": "oci.ai_speech.AIServiceSpeechClient.cancel_transcription_task",
     "speech.change_transcription_job_compartment": "oci.ai_speech.AIServiceSpeechClient.change_transcription_job_compartment",
     "speech.create_transcription_job": "oci.ai_speech.AIServiceSpeechClient.create_transcription_job",
+    "speech.delete_transcription_job": "oci.ai_speech.AIServiceSpeechClient.delete_transcription_job",
     "speech.get_transcription_job": "oci.ai_speech.AIServiceSpeechClient.get_transcription_job",
     "speech.get_transcription_task": "oci.ai_speech.AIServiceSpeechClient.get_transcription_task",
     "speech.list_transcription_jobs": "oci.ai_speech.AIServiceSpeechClient.list_transcription_jobs",

services/container_instances/src/oci_cli_container_instance/generated/containerinstance_cli.py

@@ -808,10 +808,10 @@ def restart_container_instance(ctx, from_json, wait_for_state, max_wait_seconds,
     cli_util.render_response(result, ctx)
 
 
-@container_group.command(name=cli_util.override('container_instances.retrieve_logs.command_name', 'retrieve-logs'), help=u"""Retrieves recent logs from the specified container. The most recent 256 KB of logs are returned. \n[Command Reference](retrieveLogs)""")
+@container_group.command(name=cli_util.override('container_instances.retrieve_logs.command_name', 'retrieve-logs'), help=u"""Returns the most recent 256 KB of logs from the specified container. \n[Command Reference](retrieveLogs)""")
 @cli_util.option('--container-id', required=True, help=u"""The [OCID] of the container.""")
 @cli_util.option('--file', type=click.File(mode='wb'), required=True, help="The name of the file that will receive the response data, or '-' to write to STDOUT.")
-@cli_util.option('--is-previous', type=click.BOOL, help=u"""Returns the logs for the previous run of the container in a pod if the pod exists. If the container fails for some reason, this parameter is useful to determine the root cause of the failure.""")
+@cli_util.option('--is-previous', type=click.BOOL, help=u"""Returns the logs for the previous run of the container in a pod. If the container fails, this parameter can help you to determine the root cause of the failure.""")
 @json_skeleton_utils.get_cli_json_input_option({})
 @cli_util.help_option
 @click.pass_context

services/generative_ai_inference/src/oci_cli_generative_ai_inference/generative_ai_inference_cli_extended.py

@@ -20,27 +20,3 @@
 # EmbedText API: embed_text_on_demand_serving_mode, embed_text_dedicated_serving_mode
 generativeaiinference_cli.embed_text_result_group.commands.pop(generativeaiinference_cli.embed_text_on_demand_serving_mode.name)
 generativeaiinference_cli.embed_text_result_group.commands.pop(generativeaiinference_cli.embed_text_dedicated_serving_mode.name)
-
-
-@cli_util.copy_params_from_generated_command(generativeaiinference_cli.generate_text_cohere_llm_inference_request, params_to_exclude=['inference_request_is_stream'])
-@generativeaiinference_cli.generate_text_result_group.command(name='generate-text-cohere-llm-inference-request', help=generativeaiinference_cli.generate_text_cohere_llm_inference_request.help)
-@click.pass_context
-@json_skeleton_utils.json_skeleton_generation_handler(input_params_to_complex_types={'serving-mode': {'module': 'generative_ai_inference', 'class': 'ServingMode'}, 'inference-request-stop-sequences': {'module': 'generative_ai_inference', 'class': 'list[string]'}}, output_type={'module': 'generative_ai_inference', 'class': 'GenerateTextResult'})
-@cli_util.wrap_exceptions
-def generate_text_cohere_llm_inference_request_extended(ctx, **kwargs):
-
-    kwargs['inference_request_is_stream'] = False
-
-    ctx.invoke(generativeaiinference_cli.generate_text_cohere_llm_inference_request, **kwargs)
-
-
-@cli_util.copy_params_from_generated_command(generativeaiinference_cli.generate_text_llama_llm_inference_request, params_to_exclude=['inference_request_is_stream'])
-@generativeaiinference_cli.generate_text_result_group.command(name='generate-text-llama-llm-inference-request', help=generativeaiinference_cli.generate_text_llama_llm_inference_request.help)
-@click.pass_context
-@json_skeleton_utils.json_skeleton_generation_handler(input_params_to_complex_types={'serving-mode': {'module': 'generative_ai_inference', 'class': 'ServingMode'}, 'inference-request-stop': {'module': 'generative_ai_inference', 'class': 'list[string]'}}, output_type={'module': 'generative_ai_inference', 'class': 'GenerateTextResult'})
-@cli_util.wrap_exceptions
-def generate_text_llama_llm_inference_request_extended(ctx, **kwargs):
-
-    kwargs['inference_request_is_stream'] = False
-
-    ctx.invoke(generativeaiinference_cli.generate_text_llama_llm_inference_request, **kwargs)