Releasing version 3.30.1

Releasing version 3.30.1

Author: pankajmjx

CHANGELOG.rst

@@ -6,6 +6,72 @@ All notable changes to this project will be documented in this file.
 
 The format is based on `Keep a Changelog <http://keepachangelog.com/>`__.
 
+3.30.1 - 2023-08-01
+--------------------
+Added
+~~~~~
+* Loganalytics
+
+  * Support for Log Source Validations
+
+    * ``oci log-analytics source validate-loglist-endpoint``
+    * ``oci log-analytics source validate-log-endpoint``
+    * ``oci log-analytics source validate-label-condition``
+
+  * Support for listing properties
+
+    * ``oci log-analytics property list-effective-properties``
+    * ``oci log-analytics property list-properties-metadata``
+
+  * Support for getting recalls statistics
+
+    * ``oci log-analytics storage get-recalled-data-size``
+    * ``oci log-analytics storage get-recall-count``
+    * ``oci log-analytics storage list-overlapping-recalls``
+
+  * Support for getting rules summary
+
+    * ``oci log-analytics rule get-rules-summary``
+
+  * Support for new optional parameter
+
+    * ``oci log-analytics source upsert-source --endpoints, --source-properties``
+    * ``oci log-analytics source validate-source --endpoints, --source-properties``
+    * ``oci log-analytics source validate-source-extfield-details --endpoints, --source-properties``
+    * ``oci log-analytics storage recall-archived-data --is-recall-new-data-only, --purpose``
+    * ``oci log-analytics storage estimate-recall-data-size --is-recall-new-data-only, --log-sets``
+    * ``oci log-analytics em-bridge delete --is-delete-entities``
+
+* Exadata Fleet Update Service
+
+  * Support for the Exadata Fleet Update service
+
+    * ``oci fleet-software-update``
+
+* Container Engine For Kubernetes
+
+  * Support for OKE cluster credential rotation feature
+
+    * ``oci ce cluster start-credential-rotation``
+    * ``oci ce cluster complete-credential-rotation``
+    * ``oci ce credential-rotation-status get``
+
+* Fusion Applications Environment Management
+
+  * Support for new scheduled activity response properties
+
+    * ``oci fusion-apps scheduled-activity list --scheduled-activity-association-id, --scheduled-activity-phase``
+
+* Operations Insights
+
+  * Support for OPSI news reports
+
+    * ``oci opsi news-report list``
+    * ``oci opsi news-reports change``
+    * ``oci opsi news-reports delete``
+    * ``oci opsi news-reports get``
+    * ``oci opsi news-reports update``
+
 3.30.0 - 2023-07-25
 --------------------
 Added

README.rst

@@ -26,7 +26,7 @@ Try the interactive features anytime with the ``-i`` option:
 
     oci -i
 
-.. image:: images/animation.png
+.. image:: https://github.com/oracle/oci-cli/blob/master/images/animation.png?raw=true
   :width: 1000
   :alt: Alternative text
 

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.108.0
+oci==2.109.0
 packaging==20.2
 pluggy==0.13.0
 py==1.10.0

services/container_engine/src/oci_cli_container_engine/generated/containerengine_cli.py

@@ -36,6 +36,12 @@ def cluster_group():
     pass
 
 
+@click.command(cli_util.override('ce.credential_rotation_status_group.command_name', 'credential-rotation-status'), cls=CommandGroupWithAlias, help="""Information regarding cluster's credential rotation.""")
+@cli_util.help_option_group
+def credential_rotation_status_group():
+    pass
+
+
 @click.command(cli_util.override('ce.pod_shape_group.command_name', 'pod-shape'), cls=CommandGroupWithAlias, help="""Pod shape.""")
 @cli_util.help_option_group
 def pod_shape_group():
@@ -104,6 +110,7 @@ def cluster_options_group():
 
 ce_root_group.add_command(virtual_node_pool_group)
 ce_root_group.add_command(cluster_group)
+ce_root_group.add_command(credential_rotation_status_group)
 ce_root_group.add_command(pod_shape_group)
 ce_root_group.add_command(addon_option_group)
 ce_root_group.add_command(work_request_log_entry_group)
@@ -178,6 +185,57 @@ def cluster_migrate_to_native_vcn(ctx, from_json, wait_for_state, max_wait_secon
     cli_util.render_response(result, ctx)
 
 
+@cluster_group.command(name=cli_util.override('ce.complete_credential_rotation.command_name', 'complete-credential-rotation'), help=u"""Complete cluster credential rotation. Retire old credentials from kubernetes components. \n[Command Reference](completeCredentialRotation)""")
+@cli_util.option('--cluster-id', required=True, help=u"""The OCID of the cluster.""")
+@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.option('--wait-for-state', type=custom_types.CliCaseInsensitiveChoice(["ACCEPTED", "IN_PROGRESS", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED"]), multiple=True, help="""This operation asynchronously creates, modifies or deletes a resource and uses a work request to track the progress of the operation. Specify this option to perform the action and then wait until the work request reaches a certain 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 work request to reach the 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 work request has reached the 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 complete_credential_rotation(ctx, from_json, wait_for_state, max_wait_seconds, wait_interval_seconds, cluster_id, if_match):
+
+    if isinstance(cluster_id, six.string_types) and len(cluster_id.strip()) == 0:
+        raise click.UsageError('Parameter --cluster-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('container_engine', 'container_engine', ctx)
+    result = client.complete_credential_rotation(
+        cluster_id=cluster_id,
+        **kwargs
+    )
+    if wait_for_state:
+
+        if hasattr(client, 'get_work_request') and callable(getattr(client, 'get_work_request')):
+            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 work request has entered state: {}'.format(wait_for_state), file=sys.stderr)
+                result = oci.wait_until(client, client.get_work_request(result.headers['opc-work-request-id']), 'status', wait_for_state, **wait_period_kwargs)
+            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 work request entered the specified state. Outputting last known resource state', file=sys.stderr)
+                cli_util.render_response(result, ctx)
+                sys.exit(2)
+            except Exception:
+                click.echo('Encountered error while waiting for work request 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 work request to enter the specified state', file=sys.stderr)
+    cli_util.render_response(result, ctx)
+
+
 @cluster_group.command(name=cli_util.override('ce.create_cluster.command_name', 'create'), help=u"""Create a new cluster. \n[Command Reference](createCluster)""")
 @cli_util.option('--name', required=True, help=u"""The name of the cluster. Avoid entering confidential information.""")
 @cli_util.option('--compartment-id', required=True, help=u"""The OCID of the compartment in which to create the cluster.""")
@@ -1160,6 +1218,28 @@ def get_cluster_options(ctx, from_json, cluster_option_id, compartment_id):
     cli_util.render_response(result, ctx)
 
 
+@credential_rotation_status_group.command(name=cli_util.override('ce.get_credential_rotation_status.command_name', 'get'), help=u"""Get cluster credential rotation status. \n[Command Reference](getCredentialRotationStatus)""")
+@cli_util.option('--cluster-id', required=True, help=u"""The OCID of the cluster.""")
+@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={}, output_type={'module': 'container_engine', 'class': 'CredentialRotationStatus'})
+@cli_util.wrap_exceptions
+def get_credential_rotation_status(ctx, from_json, cluster_id):
+
+    if isinstance(cluster_id, six.string_types) and len(cluster_id.strip()) == 0:
+        raise click.UsageError('Parameter --cluster-id cannot be whitespace or empty string')
+
+    kwargs = {}
+    kwargs['opc_request_id'] = cli_util.use_or_generate_request_id(ctx.obj['request_id'])
+    client = cli_util.build_client('container_engine', 'container_engine', ctx)
+    result = client.get_credential_rotation_status(
+        cluster_id=cluster_id,
+        **kwargs
+    )
+    cli_util.render_response(result, ctx)
+
+
 @node_pool_group.command(name=cli_util.override('ce.get_node_pool.command_name', 'get'), help=u"""Get the details of a node pool. \n[Command Reference](getNodePool)""")
 @cli_util.option('--node-pool-id', required=True, help=u"""The OCID of the node pool.""")
 @json_skeleton_utils.get_cli_json_input_option({})
@@ -1967,6 +2047,63 @@ def list_workload_mappings(ctx, from_json, all_pages, page_size, cluster_id, lim
     cli_util.render_response(result, ctx)
 
 
+@cluster_group.command(name=cli_util.override('ce.start_credential_rotation.command_name', 'start-credential-rotation'), help=u"""Start cluster credential rotation by adding new credentials, old credentials will still work after this operation. \n[Command Reference](startCredentialRotation)""")
+@cli_util.option('--cluster-id', required=True, help=u"""The OCID of the cluster.""")
+@cli_util.option('--auto-completion-delay-duration', required=True, help=u"""The duration in days(in ISO 8601 notation eg. P5D) after which the old credentials should be retired. Maximum delay duration is 14 days.""")
+@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.option('--wait-for-state', type=custom_types.CliCaseInsensitiveChoice(["ACCEPTED", "IN_PROGRESS", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED"]), multiple=True, help="""This operation asynchronously creates, modifies or deletes a resource and uses a work request to track the progress of the operation. Specify this option to perform the action and then wait until the work request reaches a certain 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 work request to reach the 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 work request has reached the 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 start_credential_rotation(ctx, from_json, wait_for_state, max_wait_seconds, wait_interval_seconds, cluster_id, auto_completion_delay_duration, if_match):
+
+    if isinstance(cluster_id, six.string_types) and len(cluster_id.strip()) == 0:
+        raise click.UsageError('Parameter --cluster-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['autoCompletionDelayDuration'] = auto_completion_delay_duration
+
+    client = cli_util.build_client('container_engine', 'container_engine', ctx)
+    result = client.start_credential_rotation(
+        cluster_id=cluster_id,
+        start_credential_rotation_details=_details,
+        **kwargs
+    )
+    if wait_for_state:
+
+        if hasattr(client, 'get_work_request') and callable(getattr(client, 'get_work_request')):
+            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 work request has entered state: {}'.format(wait_for_state), file=sys.stderr)
+                result = oci.wait_until(client, client.get_work_request(result.headers['opc-work-request-id']), 'status', wait_for_state, **wait_period_kwargs)
+            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 work request entered the specified state. Outputting last known resource state', file=sys.stderr)
+                cli_util.render_response(result, ctx)
+                sys.exit(2)
+            except Exception:
+                click.echo('Encountered error while waiting for work request 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 work request to enter the specified state', file=sys.stderr)
+    cli_util.render_response(result, ctx)
+
+
 @cluster_group.command(name=cli_util.override('ce.update_addon.command_name', 'update-addon'), help=u"""Update addon details for a cluster. \n[Command Reference](updateAddon)""")
 @cli_util.option('--cluster-id', required=True, help=u"""The OCID of the cluster.""")
 @cli_util.option('--addon-name', required=True, help=u"""The name of the addon.""")

services/fleet_software_update/__init__.py

@@ -0,0 +1,4 @@
+# coding: utf-8
+# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220528

services/fleet_software_update/src/__init__.py

@@ -0,0 +1,4 @@
+# coding: utf-8
+# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220528

services/fleet_software_update/src/oci_cli_fleet_software_update/__init__.py

@@ -0,0 +1,4 @@
+# coding: utf-8
+# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220528