oci-cli 3.69.0__py3-none-any.whl → 3.70.0__py3-none-any.whl

oci_cli/help_text_producer/data_files/text/cmdref/distributed-database/distributed-autonomous-db-service/distributed-autonomous-database/change-distributed-autonomous-db-backup-config.txt

@@ -0,0 +1,159 @@
+"change-distributed-autonomous-db-backup-config"
+************************************************
+
+* Description
+
+* Usage
+
+* Required Parameters
+
+* Optional Parameters
+
+* Global Parameters
+
+* Example using required parameter
+
+
+Description
+===========
+
+Change the DbBackupConfig for the Globally distributed autonomous
+database.
+
+
+Usage
+=====
+
+   oci distributed-database distributed-autonomous-db-service distributed-autonomous-database change-distributed-autonomous-db-backup-config [OPTIONS]
+
+
+Required Parameters
+===================
+
+--db-backup-config [complex type]
+
+This is a complex type whose value must be valid JSON. The value can
+be provided as a string on the command line or passed in as a file
+using the file://path/to/file syntax.
+
+The "--generate-param-json-input" option can be used to generate an
+example of the JSON which must be provided. We recommend storing this
+example in a file, modifying it as needed and then passing it back in
+via the file:// syntax.
+
+--distributed-autonomous-database-id [text]
+
+Globally distributed autonomous database identifier
+
+
+Optional Parameters
+===================
+
+--from-json [text]
+
+Provide input to this command as a JSON document from a file using the
+file://path-to/file syntax.
+
+The "--generate-full-command-json-input" option can be used to
+generate a sample json file to be used with this command option. The
+key names are pre-populated and match the command option names
+(converted to camelCase format, e.g. compartment-id –> compartmentId),
+while the values of the keys need to be populated by the user before
+using the sample file as an input to this command. For any command
+option that accepts multiple values, the value of the key can be a
+JSON array.
+
+Options can still be provided on the command line. If an option exists
+in both the JSON document and the command line then the command line
+specified value will be used.
+
+For examples on usage of this option, please see our “using CLI with
+advanced JSON options” link: https://docs.cloud.oracle.com/iaas/Conte
+nt/API/SDKDocs/cliusing.htm#AdvancedJSONOptions
+
+--if-match [text]
+
+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.
+
+--max-wait-seconds [integer]
+
+The maximum time to wait for the work request to reach the state
+defined by "--wait-for-state". Defaults to 1200 seconds.
+
+--wait-for-state [text]
+
+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.
+
+Accepted values are:
+
+   ACCEPTED, CANCELED, CANCELING, FAILED, IN_PROGRESS, NEEDS_ATTENTION, SUCCEEDED, WAITING
+
+--wait-interval-seconds [integer]
+
+Check every "--wait-interval-seconds" to see whether the work request
+has reached the state defined by "--wait-for-state". Defaults to 30
+seconds.
+
+
+Global Parameters
+=================
+
+Use "oci --help" for help on global parameters.
+
+"--auth-purpose", "--auth", "--cert-bundle", "--cli-auto-prompt", "--
+cli-rc-file", "--config-file", "--connection-timeout", "--debug", "--
+defaults-file", "--endpoint", "--generate-full-command-json-input", "
+--generate-param-json-input", "--help", "--latest-version", "--max-
+retries", "--no-retry", "--opc-client-request-id", "--opc-request-id",
+"--output", "--profile", "--proxy", "--query", "--raw-output", "--
+read-timeout", "--realm-specific-endpoint", "--region", "--release-
+info", "--request-id", "--version", "-?", "-d", "-h", "-i", "-v"
+
+
+Example using required parameter
+================================
+
+Copy and paste the following example into a JSON file, replacing the
+example parameters with your own.
+
+       oci distributed-database distributed-autonomous-db-service distributed-autonomous-database create --generate-param-json-input catalog-details > catalog-details.json
+       oci distributed-database distributed-autonomous-db-service distributed-autonomous-database create --generate-param-json-input private-endpoint-ids > private-endpoint-ids.json
+       oci distributed-database distributed-autonomous-db-service distributed-autonomous-database create --generate-param-json-input shard-details > shard-details.json
+
+       oci distributed-database distributed-autonomous-db-service distributed-autonomous-database change-distributed-autonomous-db-backup-config --generate-param-json-input db-backup-config > db-backup-config.json
+
+Copy the following CLI commands into a file named example.sh. Run the
+command by typing “bash example.sh” and replacing the example
+parameters with your own.
+
+Please note this sample will only work in the POSIX-compliant bash-
+like shell. You need to set up the OCI configuration and appropriate
+security policies before trying the examples.
+
+       export character_set=<substitute-value-of-character_set> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/distributed-database/distributed-autonomous-db-service/distributed-autonomous-database/create.html#cmdoption-character-set
+       export compartment_id=<substitute-value-of-compartment_id> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/distributed-database/distributed-autonomous-db-service/distributed-autonomous-database/create.html#cmdoption-compartment-id
+       export database_version=<substitute-value-of-database_version> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/distributed-database/distributed-autonomous-db-service/distributed-autonomous-database/create.html#cmdoption-database-version
+       export db_deployment_type=<substitute-value-of-db_deployment_type> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/distributed-database/distributed-autonomous-db-service/distributed-autonomous-database/create.html#cmdoption-db-deployment-type
+       export db_workload=<substitute-value-of-db_workload> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/distributed-database/distributed-autonomous-db-service/distributed-autonomous-database/create.html#cmdoption-db-workload
+       export display_name=<substitute-value-of-display_name> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/distributed-database/distributed-autonomous-db-service/distributed-autonomous-database/create.html#cmdoption-display-name
+       export listener_port=<substitute-value-of-listener_port> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/distributed-database/distributed-autonomous-db-service/distributed-autonomous-database/create.html#cmdoption-listener-port
+       export ncharacter_set=<substitute-value-of-ncharacter_set> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/distributed-database/distributed-autonomous-db-service/distributed-autonomous-database/create.html#cmdoption-ncharacter-set
+       export ons_port_local=<substitute-value-of-ons_port_local> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/distributed-database/distributed-autonomous-db-service/distributed-autonomous-database/create.html#cmdoption-ons-port-local
+       export ons_port_remote=<substitute-value-of-ons_port_remote> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/distributed-database/distributed-autonomous-db-service/distributed-autonomous-database/create.html#cmdoption-ons-port-remote
+       export prefix=<substitute-value-of-prefix> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/distributed-database/distributed-autonomous-db-service/distributed-autonomous-database/create.html#cmdoption-prefix
+       export sharding_method=<substitute-value-of-sharding_method> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/distributed-database/distributed-autonomous-db-service/distributed-autonomous-database/create.html#cmdoption-sharding-method
+
+       distributed_autonomous_database_id=$(oci distributed-database distributed-autonomous-db-service distributed-autonomous-database create --catalog-details file://catalog-details.json --character-set $character_set --compartment-id $compartment_id --database-version $database_version --db-deployment-type $db_deployment_type --db-workload $db_workload --display-name $display_name --listener-port $listener_port --ncharacter-set $ncharacter_set --ons-port-local $ons_port_local --ons-port-remote $ons_port_remote --prefix $prefix --private-endpoint-ids file://private-endpoint-ids.json --shard-details file://shard-details.json --sharding-method $sharding_method --query data.id --raw-output)
+
+       oci distributed-database distributed-autonomous-db-service distributed-autonomous-database change-distributed-autonomous-db-backup-config --db-backup-config file://db-backup-config.json --distributed-autonomous-database-id $distributed_autonomous_database_id

oci_cli/help_text_producer/data_files/text/cmdref/distributed-database/distributed-autonomous-db-service/distributed-autonomous-database/create.txt

@@ -64,7 +64,8 @@ Accepted values are:
 
 --db-workload [text]
 
-Possible workload types.
+Possible workload types. Currently only OLTP workload type is
+supported.
 
 Accepted values are:
 
@@ -77,7 +78,9 @@ The display name of the Globally distributed autonomous database.
 --listener-port [integer]
 
 The listener port number for the Globally distributed autonomous
-database.
+database. The listener port number has to be unique for a customer
+tenancy across all distributed autonomous databases. Same port number
+should not be re-used for any other distributed autonomous database.
 
 --ncharacter-set [text]
 
@@ -85,11 +88,17 @@ The national character set for the database.
 
 --ons-port-local [integer]
 
-Ons local port number.
+Ons local port number for Globally distributed autonomous database.
+The onsPortLocal has to be unique for a customer tenancy across all
+distributed autonomous databases. Same port number should not be re-
+used for any other distributed autonomous database.
 
 --ons-port-remote [integer]
 
-Ons remote port number.
+Ons remote port number for Globally distributed autonomous database.
+The onsPortRemote has to be unique for a customer tenancy across all
+distributed autonomous databases. Same port number should not be re-
+used for any other distributed autonomous database.
 
 --prefix [text]
 
@@ -136,9 +145,22 @@ Optional Parameters
 
 --chunks [integer]
 
-The default number of unique chunks in a shardspace. The value of
-chunks must be greater than 2 times the size of the largest shardgroup
-in any shardspace.
+Number of chunks in a shardspace. The value of chunks must be greater
+than 2 times the size of the largest shardgroup in any shardspace.
+Chunks is required to be provided for distributed autonomous databases
+being created with SYSTEM shardingMethod. For USER shardingMethod,
+chunks should not be set in create payload.
+
+--db-backup-config [complex type]
+
+This is a complex type whose value must be valid JSON. The value can
+be provided as a string on the command line or passed in as a file
+using the file://path/to/file syntax.
+
+The "--generate-param-json-input" option can be used to generate an
+example of the JSON which must be provided. We recommend storing this
+example in a file, modifying it as needed and then passing it back in
+via the file:// syntax.
 
 --defined-tags [complex type]
 
@@ -191,7 +213,11 @@ nt/API/SDKDocs/cliusing.htm#AdvancedJSONOptions
 --listener-port-tls [integer]
 
 The TLS listener port number for Globally distributed autonomous
-database.
+database. The TLS listener port number has to be unique for a customer
+tenancy across all distributed autonomous databases. Same port number
+should not be re-used for any other distributed autonomous database.
+The listenerPortTls is mandatory for dedicated infrastructure based
+distributed autonomous databases.
 
 --max-wait-seconds [integer]
 
@@ -206,8 +232,11 @@ autonomous database. Currently supported values are 3, 5 and 7.
 --replication-method [text]
 
 The Replication method for Globally distributed autonomous database.
-Use RAFT for Raft replication, and DG for DataGuard. If
-replicationMethod is not provided, it defaults to DG.
+Use RAFT for Raft based replication. With RAFT replication, shards
+cannot have peers details set on them. In case shards need to have
+peers, please do not set RAFT replicationMethod. For all non RAFT
+replication cases (with or without peers), please set
+replicationMethod as DG or do not set any value for replicationMethod.
 
 Accepted values are:
 
@@ -215,8 +244,9 @@ Accepted values are:
 
 --replication-unit [integer]
 
-For RAFT replication based Globally distributed autonomous database,
-the value should be atleast twice the number of shards.
+The replication unit count for RAFT based distributed autonomous
+database. For RAFT replication based Globally distributed autonomous
+database, the value should be at least twice the number of shards.
 
 --wait-for-state [text]
 

oci_cli/help_text_producer/data_files/text/cmdref/distributed-database/distributed-autonomous-db-service/distributed-autonomous-database/rotate-distributed-autonomous-database-passwords.txt

@@ -17,8 +17,9 @@
 Description
 ===========
 
-Rotate passwords for different components of the Globally distributed
-autonomous database.
+Rotate the gsmuser and gsmcatuser passwords for shards and catalog of
+the Globally distributed autonomous database. This operation will also
+remove GdsCtlNodes if present.
 
 
 Usage

oci_cli/help_text_producer/data_files/text/cmdref/distributed-database/distributed-autonomous-db-service/distributed-autonomous-database.txt

@@ -15,6 +15,8 @@ Available Commands
 
 * change-compartment
 
+* change-distributed-autonomous-db-backup-config
+
 * configure-distributed-autonomous-database-gsms
 
 * configure-distributed-autonomous-database-sharding

oci_cli/help_text_producer/data_files/text/cmdref/distributed-database/distributed-autonomous-db-service.txt

@@ -18,6 +18,8 @@ Available Commands
 
   * change-compartment
 
+  * change-distributed-autonomous-db-backup-config
+
   * configure-distributed-autonomous-database-gsms
 
   * configure-distributed-autonomous-database-sharding

oci_cli/help_text_producer/data_files/text/cmdref/distributed-database/distributed-db-service/distributed-database/create.txt

@@ -68,7 +68,10 @@ The display name of the Globally distributed database.
 
 --listener-port [integer]
 
-The listener port number for the Globally distributed database.
+The listener port number for the Globally distributed database. The
+listener port number has to be unique for a customer tenancy across
+all distributed databases. Same port number should not be re-used for
+any other distributed database.
 
 --ncharacter-set [text]
 
@@ -76,11 +79,17 @@ The national character set for the database.
 
 --ons-port-local [integer]
 
-Ons local port number.
+The ons local port number for the Globally distributed database. The
+onsPortLocal has to be unique for a customer tenancy across all
+distributed databases. Same port number should not be re-used for any
+other distributed database.
 
 --ons-port-remote [integer]
 
-Ons remote port number.
+The ons remote port number for the Globally distributed database. The
+onsPortRemote has to be unique for a customer tenancy across all
+distributed databases. Same port number should not be re-used for any
+other distributed database.
 
 --prefix [text]
 
@@ -127,9 +136,11 @@ Optional Parameters
 
 --chunks [integer]
 
-The default number of unique chunks in a shardspace. The value of
-chunks must be greater than 2 times the size of the largest shardgroup
-in any shardspace.
+Number of chunks in a shardspace. The value of chunks must be greater
+than 2 times the size of the largest shardgroup in any shardspace.
+Chunks is required to be provided for distributed databases being
+created with SYSTEM shardingMethod. For USER shardingMethod, chunks
+should not be set in create payload.
 
 --db-backup-config [complex type]
 
@@ -196,7 +207,12 @@ The SSH public key for Global service manager instances.
 
 --listener-port-tls [integer]
 
-The TLS listener port number for Globally distributed database.
+The TLS listener port number for the Globally distributed database.
+The TLS listener port number has to be unique for a customer tenancy
+across all distributed databases. Same port number should not be re-
+used for any other distributed database. For BASE_DB and EXADB_XS
+based distributed databases, tls is not supported hence the
+listenerPortTls is not needed to be provided in create payload.
 
 --max-wait-seconds [integer]
 
@@ -211,8 +227,11 @@ database. Currently supported values are 3, 5 and 7.
 --replication-method [text]
 
 The Replication method for Globally distributed database. Use RAFT for
-Raft replication, and DG for DataGuard. If replicationMethod is not
-provided, it defaults to DG.
+Raft based replication. With RAFT replication, shards cannot have
+peers details set on them. In case shards need to have peers, please
+do not set RAFT replicationMethod. For all non RAFT replication cases
+(with or without peers), please set replicationMethod as DG or do not
+set any value for replicationMethod.
 
 Accepted values are:
 
@@ -220,8 +239,9 @@ Accepted values are:
 
 --replication-unit [integer]
 
-For RAFT replication based Globally distributed database, the value
-should be atleast twice the number of shards.
+The replication unit count for RAFT based distributed database. For
+RAFT replication based Globally distributed database, the value should
+be at least twice the number of shards.
 
 --wait-for-state [text]
 

oci_cli/help_text_producer/data_files/text/cmdref/distributed-database/distributed-db-service/distributed-database/rotate-distributed-database-passwords.txt

@@ -17,8 +17,9 @@
 Description
 ===========
 
-Rotate passwords for different components of the Globally distributed
-database.
+Rotate the gsmuser and gsmcatuser passwords for shards and catalog of
+the Globally distributed database.  This operation will also remove
+GdsCtlNodes if present.
 
 
 Usage

oci_cli/help_text_producer/data_files/text/cmdref/distributed-database.txt

@@ -20,6 +20,8 @@ Available Commands
 
     * change-compartment
 
+    * change-distributed-autonomous-db-backup-config
+
     * configure-distributed-autonomous-database-gsms
 
     * configure-distributed-autonomous-database-sharding

oci_cli/help_text_producer/data_files/text/cmdref/governance-rules-control-plane/work-request/work-request-error/{list-errors.txt → list.txt}

@@ -1,5 +1,5 @@
-"list-errors"
-*************
+"list"
+******
 
 * Description
 
@@ -24,7 +24,7 @@ given ID.
 Usage
 =====
 
-   oci governance-rules-control-plane work-request work-request-error list-errors [OPTIONS]
+   oci governance-rules-control-plane work-request work-request-error list [OPTIONS]
 
 
 Required Parameters
@@ -124,6 +124,6 @@ Please note this sample will only work in the POSIX-compliant bash-
 like shell. You need to set up the OCI configuration and appropriate
 security policies before trying the examples.
 
-       export work_request_id=<substitute-value-of-work_request_id> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/governance-rules-control-plane/work-request/work-request-error/list-errors.html#cmdoption-work-request-id
+       export work_request_id=<substitute-value-of-work_request_id> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/governance-rules-control-plane/work-request/work-request-error/list.html#cmdoption-work-request-id
 
-       oci governance-rules-control-plane work-request work-request-error list-errors --work-request-id $work_request_id
+       oci governance-rules-control-plane work-request work-request-error list --work-request-id $work_request_id

oci_cli/help_text_producer/data_files/text/cmdref/governance-rules-control-plane/work-request/work-request-error.txt

@@ -11,4 +11,4 @@ An error encountered while executing a work request.
 Available Commands
 ==================
 
-* list-errors
+* list

oci_cli/help_text_producer/data_files/text/cmdref/governance-rules-control-plane/work-request/{work-request-log/list.txt → work-request-log-entry/list-work-request-logs.txt}

@@ -1,5 +1,5 @@
-"list"
-******
+"list-work-request-logs"
+************************
 
 * Description
 
@@ -24,7 +24,7 @@ ID.
 Usage
 =====
 
-   oci governance-rules-control-plane work-request work-request-log list [OPTIONS]
+   oci governance-rules-control-plane work-request work-request-log-entry list-work-request-logs [OPTIONS]
 
 
 Required Parameters
@@ -124,6 +124,6 @@ Please note this sample will only work in the POSIX-compliant bash-
 like shell. You need to set up the OCI configuration and appropriate
 security policies before trying the examples.
 
-       export work_request_id=<substitute-value-of-work_request_id> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/governance-rules-control-plane/work-request/work-request-log/list.html#cmdoption-work-request-id
+       export work_request_id=<substitute-value-of-work_request_id> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/governance-rules-control-plane/work-request/work-request-log-entry/list-work-request-logs.html#cmdoption-work-request-id
 
-       oci governance-rules-control-plane work-request work-request-log list --work-request-id $work_request_id
+       oci governance-rules-control-plane work-request work-request-log-entry list-work-request-logs --work-request-id $work_request_id

oci_cli/help_text_producer/data_files/text/cmdref/governance-rules-control-plane/work-request.txt

@@ -21,8 +21,8 @@ Available Commands
 
 * work-request-error
 
-  * list-errors
+  * list
 
-* work-request-log
+* work-request-log-entry
 
-  * list
+  * list-work-request-logs

oci_cli/help_text_producer/data_files/text/cmdref/governance-rules-control-plane.txt

@@ -77,8 +77,8 @@ Available Commands
 
   * work-request-error
 
-    * list-errors
+    * list
 
-  * work-request-log
+  * work-request-log-entry
 
-    * list
+    * list-work-request-logs

oci_cli/help_text_producer/data_files/text/cmdref/psa/private-service-access/change-compartment.txt

@@ -0,0 +1,136 @@
+"change-compartment"
+********************
+
+* Description
+
+* Usage
+
+* Required Parameters
+
+* Optional Parameters
+
+* Global Parameters
+
+* Example using required parameter
+
+
+Description
+===========
+
+Moves a PrivateServiceAccess into a different compartment within the
+same tenancy. For information about moving resources between
+compartments, see Moving Resources to a Different Compartment.
+
+
+Usage
+=====
+
+   oci psa private-service-access change-compartment [OPTIONS]
+
+
+Required Parameters
+===================
+
+--compartment-id, -c [text]
+
+The OCID of the compartment into which the private service access
+should be moved.
+
+--private-service-access-id [text]
+
+The OCID of the PrivateServiceAccess.
+
+
+Optional Parameters
+===================
+
+--from-json [text]
+
+Provide input to this command as a JSON document from a file using the
+file://path-to/file syntax.
+
+The "--generate-full-command-json-input" option can be used to
+generate a sample json file to be used with this command option. The
+key names are pre-populated and match the command option names
+(converted to camelCase format, e.g. compartment-id –> compartmentId),
+while the values of the keys need to be populated by the user before
+using the sample file as an input to this command. For any command
+option that accepts multiple values, the value of the key can be a
+JSON array.
+
+Options can still be provided on the command line. If an option exists
+in both the JSON document and the command line then the command line
+specified value will be used.
+
+For examples on usage of this option, please see our “using CLI with
+advanced JSON options” link: https://docs.cloud.oracle.com/iaas/Conte
+nt/API/SDKDocs/cliusing.htm#AdvancedJSONOptions
+
+--if-match [text]
+
+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.
+
+--max-wait-seconds [integer]
+
+The maximum time to wait for the work request to reach the state
+defined by "--wait-for-state". Defaults to 1200 seconds.
+
+--wait-for-state [text]
+
+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.
+
+Accepted values are:
+
+   ACCEPTED, CANCELLED, CANCELLING, FAILED, IN_PROGRESS, NEEDS_ATTENTION, SUCCEEDED, WAITING
+
+--wait-interval-seconds [integer]
+
+Check every "--wait-interval-seconds" to see whether the work request
+has reached the state defined by "--wait-for-state". Defaults to 30
+seconds.
+
+
+Global Parameters
+=================
+
+Use "oci --help" for help on global parameters.
+
+"--auth-purpose", "--auth", "--cert-bundle", "--cli-auto-prompt", "--
+cli-rc-file", "--config-file", "--connection-timeout", "--debug", "--
+defaults-file", "--endpoint", "--generate-full-command-json-input", "
+--generate-param-json-input", "--help", "--latest-version", "--max-
+retries", "--no-retry", "--opc-client-request-id", "--opc-request-id",
+"--output", "--profile", "--proxy", "--query", "--raw-output", "--
+read-timeout", "--realm-specific-endpoint", "--region", "--release-
+info", "--request-id", "--version", "-?", "-d", "-h", "-i", "-v"
+
+
+Example using required parameter
+================================
+
+Copy the following CLI commands into a file named example.sh. Run the
+command by typing “bash example.sh” and replacing the example
+parameters with your own.
+
+Please note this sample will only work in the POSIX-compliant bash-
+like shell. You need to set up the OCI configuration and appropriate
+security policies before trying the examples.
+
+       export compartment_id=<substitute-value-of-compartment_id> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/psa/private-service-access/create.html#cmdoption-compartment-id
+       export service_id=<substitute-value-of-service_id> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/psa/private-service-access/create.html#cmdoption-service-id
+       export subnet_id=<substitute-value-of-subnet_id> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/psa/private-service-access/create.html#cmdoption-subnet-id
+
+       private_service_access_id=$(oci psa private-service-access create --compartment-id $compartment_id --service-id $service_id --subnet-id $subnet_id --query data.id --raw-output)
+
+       oci psa private-service-access change-compartment --compartment-id $compartment_id --private-service-access-id $private_service_access_id