oci-cli 3.65.0__py3-none-any.whl → 3.66.0__py3-none-any.whl

oci_cli/help_text_producer/data_files/text/cmdref/email/sender/remove.txt

@@ -0,0 +1,141 @@
+"remove"
+********
+
+* Description
+
+* Usage
+
+* Required Parameters
+
+* Optional Parameters
+
+* Global Parameters
+
+* Example using required parameter
+
+
+Description
+===========
+
+Remove a lock to a resource.
+
+
+Usage
+=====
+
+   oci email sender remove [OPTIONS]
+
+
+Required Parameters
+===================
+
+--sender-id [text]
+
+The unique OCID of the sender.
+
+--type [text]
+
+Lock type.
+
+Accepted values are:
+
+   DELETE, FULL
+
+
+Optional Parameters
+===================
+
+--compartment-id, -c [text]
+
+The lock compartment ID.
+
+--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]
+
+Used for optimistic concurrency control. In the update or delete call
+for a resource, set the *if-match* parameter to the value of the etag
+from a previous get, create, or update 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 resource to reach the lifecycle state
+defined by "--wait-for-state". Defaults to 1200 seconds.
+
+--wait-for-state [text]
+
+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.
+
+Accepted values are:
+
+   ACTIVE, CREATING, DELETED, DELETING, FAILED, INACTIVE, NEEDS_ATTENTION
+
+--wait-interval-seconds [integer]
+
+Check every "--wait-interval-seconds" to see whether the resource has
+reached the lifecycle 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/email/sender/create.html#cmdoption-compartment-id
+       export email_address=<substitute-value-of-email_address> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/email/sender/create.html#cmdoption-email-address
+       export type=<substitute-value-of-type> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/email/sender/remove.html#cmdoption-type
+
+       sender_id=$(oci email sender create --compartment-id $compartment_id --email-address $email_address --query data.id --raw-output)
+
+       oci email sender remove --sender-id $sender_id --type $type

oci_cli/help_text_producer/data_files/text/cmdref/email/sender/update.txt

@@ -112,6 +112,10 @@ from a previous get, create, or update response for that resource.
 The resource will be updated or deleted only if the etag you provide
 matches the resource’s current etag value.
 
+--is-lock-override [boolean]
+
+Whether to override locks (if any exist).
+
 --max-wait-seconds [integer]
 
 The maximum time to wait for the resource to reach the lifecycle state

oci_cli/help_text_producer/data_files/text/cmdref/email/sender.txt

@@ -11,6 +11,8 @@ The full information representing an approved sender.
 Available Commands
 ==================
 
+* add
+
 * change-compartment
 
 * create
@@ -21,4 +23,6 @@ Available Commands
 
 * list
 
+* remove
+
 * update

oci_cli/help_text_producer/data_files/text/cmdref/email.txt

@@ -29,6 +29,8 @@ Available Commands
 
 * domain
 
+  * add
+
   * change-compartment
 
   * create
@@ -39,10 +41,14 @@ Available Commands
 
   * list
 
+  * remove
+
   * update
 
 * email-return-path
 
+  * add
+
   * create
 
   * delete
@@ -51,10 +57,14 @@ Available Commands
 
   * list
 
+  * remove
+
   * update
 
 * sender
 
+  * add
+
   * change-compartment
 
   * create
@@ -65,6 +75,8 @@ Available Commands
 
   * list
 
+  * remove
+
   * update
 
 * suppression

oci_cli/help_text_producer/data_files/text/cmdref/fs/mount-target/create.txt

@@ -145,11 +145,18 @@ address’s fully qualified domain name (FQDN). For example, *files-1*
 in the FQDN *files-1.subnet123.vcn1.oraclevcn.com*. Must be unique
 across all VNICs in the subnet and comply with RFC 952 and RFC 1123.
 
-Note: This attribute value is stored in the PrivateIp resource, not in
-the *mountTarget* resource. To update the *hostnameLabel*, use
-*GetMountTarget* to obtain the OCIDs of the mount target’s private IPs
-(*privateIpIds*). Then, you can use UpdatePrivateIp to update the
-*hostnameLabel* value.
+Note:
+
+If the IP address is IPv4, this attribute value is stored in the
+PrivateIp resource, not in the *mountTarget* resource. To update the
+*hostnameLabel*, use *GetMountTarget* to obtain the OCIDs of the mount
+target’s private IPs (*privateIpIds*). Then, you can use
+UpdatePrivateIp to update the *hostnameLabel* value.
+
+If the IP address is IPv6, it is stored in the Ipv6  resource To
+update the *hostnameLabel*, use *GetMountTarget* to obtain the OCIDs
+of the mount target’s IPv6 address (*mountTargetIpv6Ids*). Then, you
+can use UpdateIpv6 to update the *hostnameLabel* value.
 
 For more information, see DNS in Your Virtual Cloud Network.
 

oci_cli/help_text_producer/data_files/text/cmdref/generative-ai/dedicated-ai-cluster/create.txt

@@ -52,7 +52,8 @@ hardware configuration is hidden from customers.
 Allowed values are: - LARGE_COHERE - LARGE_COHERE_V2 - SMALL_COHERE -
 SMALL_COHERE_V2 - SMALL_COHERE_4 - EMBED_COHERE - LLAMA2_70 -
 LARGE_GENERIC - LARGE_COHERE_V2_2 - LARGE_GENERIC_4 - SMALL_GENERIC_V2
-- LARGE_GENERIC_2 - LARGE_COHERE_V3 - RERANK_COHERE
+- LARGE_GENERIC_2 - LARGE_COHERE_V3 - RERANK_COHERE - SMALL_GENERIC_V1
+- MEDIUM_GENERIC_V1 - LARGE_GENERIC_V1
 
 
 Optional Parameters

oci_cli/help_text_producer/data_files/text/cmdref/generative-ai/endpoint-collection/list-endpoints.txt

@@ -69,6 +69,10 @@ 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
 
+--generative-ai-private-endpoint-id [text]
+
+The OCID of the private endpoint.
+
 --id [text]
 
 The OCID of the endpoint.

oci_cli/help_text_producer/data_files/text/cmdref/generative-ai-inference/chat-result/chat-generic-chat-request.txt

@@ -300,6 +300,17 @@ Accepted values are:
 
    HIGH, LOW, MEDIUM
 
+--chat-request-web-search-options [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.
+
 --from-json [text]
 
 Provide input to this command as a JSON document from a file using the

oci_cli/help_text_producer/data_files/text/cmdref/mysql/backup/list.txt

@@ -46,6 +46,14 @@ cannot provide the "--limit" option.
 
 Backup OCID
 
+--backup-preparation-status [text]
+
+Indicates whether the backup has been prepared successfully.
+
+Accepted values are:
+
+   NOT_PREPARED, PREPARED
+
 --creation-type [text]
 
 Backup creationType
@@ -134,6 +142,14 @@ Accepted values are:
 
    ASC, DESC
 
+--validation-status [text]
+
+Backup validation status
+
+Accepted values are:
+
+   FAILED, NEEDS_ATTENTION, NOT_VALIDATED, VALIDATED
+
 
 Global Parameters
 =================

oci_cli/help_text_producer/data_files/text/cmdref/mysql/backup/validate.txt

@@ -0,0 +1,141 @@
+"validate"
+**********
+
+* Description
+
+* Usage
+
+* Required Parameters
+
+* Optional Parameters
+
+* Global Parameters
+
+* Example using required parameter
+
+
+Description
+===========
+
+Request to validate the backup by checking the data consistency.
+
+
+Usage
+=====
+
+   oci mysql backup validate [OPTIONS]
+
+
+Required Parameters
+===================
+
+--backup-id [text]
+
+The OCID of the Backup
+
+--is-prepared-backup-required [boolean]
+
+Specifies whether the backup needs to be prepared for fast restore or
+not. Set to true to prepare the backup, set to false (default) if not
+required. Note: The prepared backup will replace the original backup
+and will not generate a new backup copy. The cost associated with the
+backup may vary, as the prepared backup will consistently be a full
+backup, it may also change the storage size of the original backup.
+
+
+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* header 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, SUCCEEDED
+
+--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/mysql/db-system/create.html#cmdoption-compartment-id
+       export shape_name=<substitute-value-of-shape_name> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/mysql/db-system/create.html#cmdoption-shape-name
+       export subnet_id=<substitute-value-of-subnet_id> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/mysql/db-system/create.html#cmdoption-subnet-id
+       export is_prepared_backup_required=<substitute-value-of-is_prepared_backup_required> # https://docs.cloud.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/mysql/backup/validate.html#cmdoption-is-prepared-backup-required
+
+       db_system_id=$(oci mysql db-system create --compartment-id $compartment_id --shape-name $shape_name --subnet-id $subnet_id --query data.id --raw-output)
+
+       backup_id=$(oci mysql backup create --db-system-id $db_system_id --query data.id --raw-output)
+
+       oci mysql backup validate --backup-id $backup_id --is-prepared-backup-required $is_prepared_backup_required

oci_cli/help_text_producer/data_files/text/cmdref/mysql/backup.txt

@@ -32,3 +32,5 @@ Available Commands
 * list
 
 * update
+
+* validate

oci_cli/help_text_producer/data_files/text/cmdref/mysql.txt

@@ -29,6 +29,8 @@ Available Commands
 
   * update
 
+  * validate
+
 * channel
 
   * create-from-mysql

oci_cli/help_text_producer/data_files/text/cmdref/organizations/{work-request-log-entry → work-request-log}/list.txt

@@ -11,6 +11,8 @@
 
 * Global Parameters
 
+* Example using required parameter
+
 
 Description
 ===========
@@ -21,7 +23,7 @@ Return a (paginated) list of logs for a given work request.
 Usage
 =====
 
-   oci organizations work-request-log-entry list [OPTIONS]
+   oci organizations work-request-log list [OPTIONS]
 
 
 Required Parameters
@@ -98,3 +100,19 @@ 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 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/organizations/work-request-log/list.html#cmdoption-work-request-id
+
+       oci organizations work-request-log list --work-request-id $work_request_id

oci_cli/help_text_producer/data_files/text/cmdref/{delegate-access-control/work-request/work-request-log-entry.txt → organizations/work-request-log.txt}

@@ -1,5 +1,5 @@
-work-request-log-entry
-**********************
+work-request-log
+****************
 
 
 Description
@@ -11,4 +11,4 @@ A log message from the execution of a work request.
 Available Commands
 ==================
 
-* list-logs
+* list

oci_cli/help_text_producer/data_files/text/cmdref/organizations.txt

@@ -143,6 +143,6 @@ Available Commands
 
   * list-errors
 
-* work-request-log-entry
+* work-request-log
 
   * list

oci_cli/help_text_producer/data_files/text/index.txt

@@ -266,7 +266,7 @@ Available Service Commands
 
 * Oracle Database Autonomous Recovery Service (recovery)
 
-* Oracle Database MultiCloud Data plane Integration (dbmulticloud)
+* Oracle Database MultiCloud Data Plane Integration (dbmulticloud)
 
 * Oracle Delegate Access Control (delegate-access-control)
 

oci_cli/service_mapping.py

@@ -240,7 +240,7 @@ service_mapping = {
     ],
     "dbmulticloud": [
         "dbmulticloud",
-        "Oracle Database MultiCloud Data plane Integration",
+        "Oracle Database MultiCloud Data Plane Integration",
         "Others"
     ],
     "dbtools": [

oci_cli/version.py

@@ -2,4 +2,4 @@
 # Copyright (c) 2016, 2021, 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.
 
-__version__ = '3.65.0'
+__version__ = '3.66.0'

{oci_cli-3.65.0.dist-info → oci_cli-3.66.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: oci-cli
-Version: 3.65.0
+Version: 3.66.0
 Summary: Oracle Cloud Infrastructure CLI
 Home-page: https://docs.cloud.oracle.com/iaas/Content/API/Concepts/cliconcepts.htm
 Author: Oracle
@@ -19,7 +19,7 @@ Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Requires-Python: >=3.6
-Requires-Dist: oci (==2.159.0)
+Requires-Dist: oci (==2.160.0)
 Requires-Dist: arrow (>=1.0.0)
 Requires-Dist: certifi (>=2025.1.31)
 Requires-Dist: click (==8.0.4)