Releasing version 3.18.0

Releasing version 3.18.0

Author: HamadaGabrIbrahim

CHANGELOG.rst

@@ -6,6 +6,65 @@ All notable changes to this project will be documented in this file.
 
 The format is based on `Keep a Changelog <http://keepachangelog.com/>`__.
 
+3.18.0 - 2022-09-27
+--------------------
+
+Added
+~~~~~~~~
+
+* Support for previous pagination in Resource Search service
+
+  * ``oci search resource structured-search --page $opc-previous-token``
+
+* Support for Elastic Compute feature as part of database service
+
+  * ``oci db exadata-infrastructure generate-recommended-vm-cluster-network --db-servers``
+  * ``oci db exadata-infrastructure update --additional-compute-count, --additional-compute-system-model``
+  * ``oci db vm-cluster-network resize --action, --exadata-infrastructure-id, --vm-cluster-network-id, --vm-networks``
+
+* Stack Monitoring service
+
+  * Support for new command
+
+    * ``oci stack-monitoring resource search-associated-resources``
+
+  * Support for new optional parameter
+
+    * ``oci stack-monitoring resource search --external-id``
+    * ``oci stack-monitoring resource create --external-id``
+    * ``oci stack-monitoring resource delete --is-delete-members``
+
+* NoSQL service
+
+  * ``oci nosql query prepare``
+
+    * Added a new optional argument ``--is-get-query-plan``
+    * Added the optional ``queryPlan`` property in the JSON response
+
+  * ``oci nosql table get``
+
+    * Added the properties ``isAsUuid`` and ``isGenerated`` to the ``Column`` JSON object that is included in the JSON response
+    * Added the ``identity`` JSON object that is included in the the JSON response
+
+  * ``oci nosql table list-table-usage``
+
+    * Added the property ``maxShardSizeUsageInPercent`` in the JSON response
+
+Changed
+~~~~~~~
+* [BREAKING]  DNS service
+
+  *  ``oci dns resolver-endpoint create --subnet-id --nsg-ids``
+
+    * Required parameter ``--subnet-id`` was added
+    * Optional paramater ``--nsg-ids`` was added
+    * Optional paramater ``--endpoint-type`` was removed
+
+
+  * ``oci dns resolver-endpoint update``
+
+    * The optional paramater ``--nsg-ids`` was added
+
 3.17.0 - 2022-09-20
 --------------------
 

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

scripts/install/README.rst

@@ -77,6 +77,6 @@ The order of precedence in which this scripts applies input parameters is as fol
 
 Checksums
 -----------
-install.sh   362a5a64fa67058464e286ec99e24e25d4540c3bb63d8ba7273ea4993a62fd53
-install.ps1   9ca1cd79b3309bdb4513a0a068228a67ac85c1438cbee6b4cb034af0f138a09b
-install.py   9b728733a2323cce3d9853fcb58339359642e2fb23a3ea3385d47ef9aa4fcfb3
+install.sh   eff201279e7198101e8cbbe4cea2ca559732f3cd502e145354d7477d2a4621ce
+install.ps1   8dba598ded1718cfa2e52ca8785ece31d0b573868eaec9ad2af535d43797a70c
+install.py   b4d5879f0294ff3344b0b2e131ad4dfd44971f70bdb6d077d6a433c2faa8eb5f

services/bds/src/oci_cli_bds/generated/bds_cli.py

@@ -1543,7 +1543,7 @@ def list_bds_api_keys(ctx, from_json, all_pages, page_size, bds_instance_id, lif
 
 @bds_instance_group.command(name=cli_util.override('bds.list_bds_instances.command_name', 'list'), help=u"""Returns a list of all Big Data Service clusters in a compartment. \n[Command Reference](listBdsInstances)""")
 @cli_util.option('--compartment-id', required=True, help=u"""The OCID of the compartment.""")
-@cli_util.option('--lifecycle-state', type=custom_types.CliCaseInsensitiveChoice(["CREATING", "ACTIVE", "UPDATING", "SUSPENDING", "SUSPENDED", "RESUMING", "DELETING", "DELETED", "FAILED"]), help=u"""The state of the cluster.""")
+@cli_util.option('--lifecycle-state', type=custom_types.CliCaseInsensitiveChoice(["CREATING", "ACTIVE", "UPDATING", "SUSPENDING", "SUSPENDED", "RESUMING", "DELETING", "DELETED", "FAILED", "INACTIVE"]), help=u"""The state of the cluster.""")
 @cli_util.option('--page', help=u"""The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call.""")
 @cli_util.option('--limit', type=click.INT, help=u"""The maximum number of items to return.""")
 @cli_util.option('--sort-by', type=custom_types.CliCaseInsensitiveChoice(["timeCreated", "displayName"]), help=u"""The field to sort by. Only one sort order may be provided. Default order for timeCreated is descending. Default order for displayName is ascending. If no value is specified timeCreated is default.""")
@@ -2197,6 +2197,124 @@ def restart_node(ctx, from_json, wait_for_state, max_wait_seconds, wait_interval
     cli_util.render_response(result, ctx)
 
 
+@bds_instance_group.command(name=cli_util.override('bds.start_bds_instance.command_name', 'start'), help=u"""Starts the BDS cluster that was stopped earlier. \n[Command Reference](startBdsInstance)""")
+@cli_util.option('--bds-instance-id', required=True, help=u"""The OCID of the cluster.""")
+@cli_util.option('--cluster-admin-password', required=True, help=u"""Base-64 encoded password for the cluster admin user.""")
+@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 to see if it 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_bds_instance(ctx, from_json, wait_for_state, max_wait_seconds, wait_interval_seconds, bds_instance_id, cluster_admin_password, if_match):
+
+    if isinstance(bds_instance_id, six.string_types) and len(bds_instance_id.strip()) == 0:
+        raise click.UsageError('Parameter --bds-instance-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['clusterAdminPassword'] = cluster_admin_password
+
+    client = cli_util.build_client('bds', 'bds', ctx)
+    result = client.start_bds_instance(
+        bds_instance_id=bds_instance_id,
+        start_bds_instance_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)
+
+
+@bds_instance_group.command(name=cli_util.override('bds.stop_bds_instance.command_name', 'stop'), help=u"""Stops the BDS cluster that can be started at later point of time. \n[Command Reference](stopBdsInstance)""")
+@cli_util.option('--bds-instance-id', required=True, help=u"""The OCID of the cluster.""")
+@cli_util.option('--cluster-admin-password', required=True, help=u"""Base-64 encoded password for the cluster admin user.""")
+@cli_util.option('--is-force-stop-jobs', type=click.BOOL, help=u"""Boolean indicating whether to force stop jobs while stopping cluster. Defaults to false.""")
+@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 to see if it 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 stop_bds_instance(ctx, from_json, wait_for_state, max_wait_seconds, wait_interval_seconds, bds_instance_id, cluster_admin_password, is_force_stop_jobs, if_match):
+
+    if isinstance(bds_instance_id, six.string_types) and len(bds_instance_id.strip()) == 0:
+        raise click.UsageError('Parameter --bds-instance-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['clusterAdminPassword'] = cluster_admin_password
+
+    if is_force_stop_jobs is not None:
+        _details['isForceStopJobs'] = is_force_stop_jobs
+
+    client = cli_util.build_client('bds', 'bds', ctx)
+    result = client.stop_bds_instance(
+        bds_instance_id=bds_instance_id,
+        stop_bds_instance_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)
+
+
 @bds_metastore_configuration_group.command(name=cli_util.override('bds.test_bds_metastore_configuration.command_name', 'test'), help=u"""Test specified metastore configuration. \n[Command Reference](testBdsMetastoreConfiguration)""")
 @cli_util.option('--bds-instance-id', required=True, help=u"""The OCID of the cluster.""")
 @cli_util.option('--metastore-config-id', required=True, help=u"""The metastore configuration ID""")

services/cloud_bridge/src/oci_cli_ocb_agent_svc/ocbagentsvc_cli_extended.py

@@ -20,11 +20,9 @@
 ocbagentsvc_cli.agent_dependency_group.add_command(ocbagentsvc_cli.list_agent_dependencies)
 cli_util.rename_command(ocbagentsvc_cli, ocbagentsvc_cli.agent_dependency_group, ocbagentsvc_cli.list_agent_dependencies, "list")
 
-cli_util.rename_command(ocbagentsvc_cli, ocbagentsvc_cli.agent_dependency_collection_group, ocbagentsvc_cli.list_agent_dependencies, "list")
-
-# oci cloud-bridge ocb-agent-svc environment-collection list-environments -> oci cloud-bridge ocb-agent-svc environment-collection list
-cli_util.rename_command(ocbagentsvc_cli, ocbagentsvc_cli.environment_collection_group, ocbagentsvc_cli.list_environments, "list")
-
-cli_util.rename_command(ocbagentsvc_cli, ocbagentsvc_cli.ocb_agent_svc_root_group, ocbagentsvc_cli.environment_collection_group, "environment")
+# oci cloud-bridge ocb-agent-svc environment-collection list-environments -> oci cloud-bridge ocb-agent-svc environment list
+ocbagentsvc_cli.ocb_agent_svc_root_group.commands.pop(ocbagentsvc_cli.environment_collection_group.name)
+ocbagentsvc_cli.environment_group.add_command(ocbagentsvc_cli.list_environments)
+cli_util.rename_command(ocbagentsvc_cli, ocbagentsvc_cli.environment_group, ocbagentsvc_cli.list_environments, "list")
 
 cli_util.rename_command(ocbagentsvc_cli, ocbagentsvc_cli.ocb_agent_svc_root_group, ocbagentsvc_cli.appliance_image_collection_group, "appliance-image")