oci-cli

[BREAKING] Drop support for Python 2

Added

• Support for os object sync command that synchronizes a filesystem directory with an Object Storage bucket in the Object Storage service.

  • oci os object sync

• Support for --availability-domain option when listing VNICs attached to an instance in the Compute service

  • oci compute instance list-vnics --availability-domain

• Support for Autonomous Database Create with Early Patching via a new parameter (maintenance-schedule-type) in the Database service.

  • oci db autonomous-database create --maintenance-schedule-type

  • oci db autonomous-database create-adb-cross-region-data-guard-details --maintenance-schedule-type

  • oci db autonomous-database create-from-backup-id --maintenance-schedule-type

  • oci db autonomous-database create-from-backup-timestamp --maintenance-schedule-type

  • oci db autonomous-database create-from-clone --maintenance-schedule-type

  • oci db autonomous-database create-virtual-clone --maintenance-schedule-type

• Support for non-default config file locations for the below commands

  • oci session refresh

  • oci session export

  • oci session import

• Support for Model Catalog v2.0 features including Provenance, Metadata, Schema, Artifact introspection

  • oci data-science model

• Support for new parameter --metastore-id to specify external hive metastore for Application in the Data Flow service

  • oci data-flow application create --metastore-id

  • oci data-flow application update --metastore-id

• Support for manual copy of volume group backups across regions in the Block Storage service

  • oci bv volume-group-backup copy

• Support for MDS Backup Change Compartment in MySql service

  • oci mysql backup change-compartment

Changed

• Block volume backup copy operations now wait for their associated work requests to complete

  • oci bv boot-volume-backup copy

  • oci bv backup copy

Added

• Support for filtering by tag on capacity planning and SQL warehouse list operations in the Operations Insights service

  • Parameters defined-tag-equals, freeform-tag-equals, defined-tag-exists, freeform-tag-exists are added for some commands under oci opsi database-insights

• Support for creating cross-region autonomous data guards in the Database service

• oci db autonomous-database create-cross-region-data-guard

• oci db autonomous-database fail-over --peer-db-id

• oci db autonomous-database switchover --peer-db-id

• oci db autonomous-database update --peer-db-id

• Support for the customer contacts feature on cloud exadata infrastructure in the Database service

  • oci db cloud-exa-infra create --customer-contacts

  • oci db cloud-exa-infra update --customer-contacts

• Support for cost analysis custom tables in the Usage service

  • oci usage-api custom-table

• Support non-default config file locations for oci session validate and oci session terminate

• Support to add passphrase for session authentication (oci session authenticate)

Added

• Support for empty and dry-run options while deleting buckets in Object Storage service

  • oci os bucket delete --empty --dry-run

  • oci os bucket delete --empty

• Support for schedules and tasks in Data Integration service

  • oci data-integration schedule

  • oci data-integration task

• Database service

  • Support for getting available updates and updating histories for a VM cluster

    • oci db vm-cluster get-update --update-id <Update OCID> --vm-cluster-id <VM Cluster OCID>

    • oci db vm-cluster list-updates --vm-cluster-id <VM Cluster OCID> --update-type <GI_PATCH/GI_UPGRADE/OS_UPDATE>

    • oci db vm-cluster get-update-history --update-history-entry-id <UpdateHistory OCID> --vm-cluster-id <VM Cluster OCID>

    • oci db vm-cluster list-update-histories --vm-cluster-id <VM Cluster OCID> --update-type <GI_PATCH/GI_UPGRADE/OS_UPDATE>

  • Support for updating dataguard

    • oci db data-guard-association update

  • Support for downloading network validation report file for VM Cluster Networks

    • oci db vm-cluster-network download-validation-report --exadata-infrastructure-id, --file, --vm-cluster-network-id

Changed

• Support patch and upgrade of Grid Infrastructure (GI) and update of DomU OS software for a VM cluster

  • oci db vm-cluster update --update-id <Update OCID> --update-action <PRECHECK/ROLLING_APPLY/ROLLBACK>

Added

• Support for AI Anomaly Detection service

  • oci anomaly-detection

• Support for retrieving a DNS zone as a zone file in DNS service

  • oci dns zone get-zone-content --file

• Support for Search domain type for DHCP options to support multi-level search domain in Network Service.

  • oci network dhcp-options create --domain-name-type

  • oci network dhcp-options update --domain-name-type

• Support for searching Marketplace Listings

  • oci marketplace listing-summary search-listings

  • oci marketplace listing-summary search-listings-free-text

  • oci marketplace listing-summary search-listings-structured

Changed

• Parameter --availability-domain is now optional in create VLAN in Network service.

  • oci network vlan create--availability-domain

Added

• Support for Order Activation features in the Organizations Service

  • oci organizations order activate

  • oci organizations order get

• Support new OCE instance license type - Starter Edition in the OCE service. The new license type is: STARTER

  • oci oce oce-instance create --instance-license-type STARTER

  • oci oce oce-instance update --instance-license-type STARTER

• Expanded DRG functionality in the Networking Service

  • More than one VCN can be attached to a DRG

  • Flexible routing inside DRG enables packet flow between any two attachments

  • Routing policy to customize dynamic import/export of routes

• Operations Insights

  • Support for resource principal authorization for enterprise manager bridge resource

  • New lifecycle state "NEEDS_ATTENTION" to indicate issues with the bridge resource, and new field "objectStorageBucketStatusDetails" to provide detail

    • oci opsi host-insights list --lifecycle-state NEEDS_ATTENTION

    • oci opsi enterprise-manager-bridges list --lifecycle-state NEEDS_ATTENTION

    • oci opsi database-insights list --lifecycle-state NEEDS_ATTENTION

Changed

• Changed oci setup autocomplete to create a symlink pointing to current CLI version oci_autocomplete.sh script

Fixed

• Issue with environment based config throwing FileNotFoundError: for a non-required config

Added

• Support for passing in private key content as a environment variable. A private key file is not required if this variable is set

  • Export OCI_CLI_KEY_CONTENT with the private key content enclosed with single quotes

• Support for the DevOps service

  • oci devops

• Support for configuring network security groups for node pools in the container engine for Kubernetes service

  • oci ce node-pool create --nsg-ids

  • oci ce node-pool update --nsg-ids

• Support for optionally specifying CPU core count and data storage size when creating autonomous databases in the Database service

  • oci db autonomous-database create --data-storage-size-in-gbs

• Support for metastore and initial data asset import/export in the Data Catalog service

• oci data-catalog metastore

• oci data-catalog data-asset import

• oci data-catalog data-asset synchronous-export

• [Breaking] DISPLAYNAME removed from --sort-by option

• Support for Email Domain in the Email Delivery service

  • oci email domain change-compartment --compartment-id --email-domain-id

  • oci email domain create --compartment-id --name

  • oci email domain delete --email-domain-id

  • oci email domain get --email-domain-id

  • oci email domain list --compartment-id

  • oci email domain update --email-domain-id

• Support for Domain Key Identified Mail in the Email Delivery service

  • oci email dkim create --email-domain-id

  • oci email dkim delete --dkim-id

  • oci email dkim get --dkim-id

  • oci email dkim list --email-domain-id

  • oci email dkim update --dkim-id

• Support for new API to list work requests for Email Domain and DKIM in the Email Delivery service

  • oci email work-request get --work-request-id

  • oci email work-request list --compartment-id

  • oci email work-request-error-collection list --work-request-id

  • oci email work-request-log list --work-request-id

• Support for --domain field in the response for oci email sender in the Email Delivery service

• Support for changing the number of retries for a CLI command (--max-retries)

Added

• Users can authenticate the CLI with only environment variables, a config does not need to exist

  • The following environment variables need to be set, OCI_CLI_USER, OCI_CLI_TENANCY, OCI_CLI_FINGERPRINT, OCI_CLI_KEY_FILE, OCI_CLI_REGION

  • Optional variable for passphrase, OCI_CLI_PASSPHRASE

• Support for VMBM Pluggable Database feature as a part of the Database Service

  • oci db pluggable-database

Changed

• Support for cross-tenancy volume clone in Block Storage service

  • oci bv volume create --source-volume-id

  • oci bv boot-volume create --source-volume-id

• Changed allowed versions of cryptography package to a range from 3.2.1 to 3.4.7

• Following updates in installer scripts:

  • Use dnf, if available, to install python

  • Updated check for ubuntu/debian systems to use ID_LIKE/ID instead of NAME in /etc/os-release

Fixed

• oci setup bootstrap was causing a AttributeError: module 'oci' has no attribute 'identity'

Added

• Support for migrating an OKE cluster not integrated with your VCN to a VCN-Native cluster in Container Engine

  • oci ce cluster cluster-migrate-to-native-vcn

  • oci ce cluster cluster-migrate-to-native-vcn-status

• Support for filtering of applications based on spark version in Data Flow service

  • oci data-flow application list --spark-version

• Support for registration and management of target databases in Data Safe service.

  • oci data-safe target-database create

• Support for Elastic Storage feature for Exadata Infrastructure resources for ExaCC in Database service.

  • oci db exadata-infrastructure create --compute-count

  • oci db exadata-infrastructure update --additional-storage-count

  • oci db exadata-infrastructure add --exadata-infrastructure-id

• New parameter --parameters-config has been added to the below commands in Management Dashboard service

  • oci management-dashboard dashboard create --parameters-config

  • oci management-dashboard dashboard update

  • oci management-dashboard saved-search create

  • oci management-dashboard saved-search update

Changed

• PyYAML version requirement relaxed from PyYAML==5.4.1 to PyYAML>=5.4,<6

• Default thread count for multipart upload/download using oci os object put | get is 10.

• Multipart download is now default for oci os object get. Please use --no-multipart to disable multipart download.

• Changed multipart download chunk size to maximum instead of 1Mb

Fixed

• Parameter --compartment-id was existing twice in change compartment for rove node in Rover service

  • oci rover node change-compartment --compartment-id

• Issue with multipart download - progress bar was only showing 50% even though full file was uploaded.

Added

• Support for Java Management Service

  • oci jms

• Support to update iscsi Login State for a Volume Attachment in Compute service

  • oci compute volume-attachment update --iscsi-login-state

• Support for 'host-name' and 'is-database-instance-level-metrics' query parameters in Operations Insights service

  • oci opsi database-insights summarize-database-insight-resource-capacity-trend

  • oci opsi database-insights summarize-database-insight-resource-forecast-trend

  • oci opsi database-insights summarize-database-insight-resource-statistics

  • oci opsi database-insights summarize-database-insight-resource-usage

  • oci opsi database-insights summarize-database-insight-resource-usage-trend

  • oci opsi database-insights summarize-database-insight-resource-utilization-insight

  • oci opsi database-insights summarize-sql-insights

  • oci opsi database-insights summarize-sql-statistics

  • oci opsi database-insights summarize-sql-statistics-time-series

• Support for listing database configurations in Operations Insights service

  • oci opsi database-insights list-database-configurations

• Added support for a new type of Source called Import for use with the Export tool in Application Migration service

  • oci application-migration source create-source-import-source-details

  • oci application-migration source update-source-import-source-details

Added

• Support for configuration of autonomous database KMS keys in the Database service

  • oci db autonomous-database configure-autonomous-database-vault-key

• Support for creating database software images from an existing database home in the Database service

  • oci db database-software-image create --source-db-home-id

• Support for creating database software images with any supported RUs in the Database service

  • oci db database-software-image create --database-version [optional], --patch-set[optional]

• --is-desupported-version flag is added to take customer acknowledgment for creating database-software images with release older than N-3

• oci db database create --is-desupported-version

• oci db database create-from-backup --is-desupported-version

• oci db database create-from-database --is-desupported-version

• oci db db-home create --is-desupported-version

• Support for listing all NSGs associated with a given VLAN in the Networking service

  • oci network nsg list --compartment-id [optional]

Changed

• Services are now dynamically imported for autocomplete, speeding up completion time

Fixed

• Previous release had a bug causing some CLI commands to error with 'KeyError'. Please see github issue #415 for more details

Added

• [Breaking] For CLI installations running on Python 3.5 or lower, warning message to upgrade Python to v3.6+ and reinstall CLI before August 1st, 2021 will be seen.

  • To disable the warning message, set environment variable OCI_CLI_ALLOW_PYTHON2=True

• O is a wrapper for oci-cli, providing an alternate interface with shortcuts to all commands, parameters, resource IDs, and output fields.

  • O can be found on GitHub.

• Support for Generic Artifacts Service (oci artifacts)

• Support for Bastion Service (oci bastion)

• Support to provide visualization to view the Automatic Workload Repository (AWR) data for external database in Database Management Service

  • oci database-management get-awr-db-report

  • oci database-management get-awr-db-sql-report

  • oci database-management list-awr-db-snapshots

  • oci database-management list-awr-dbs

  • oci database-management summarize-awr-db-cpu-usages

  • oci database-management summarize-awr-db-metrics

  • oci database-management summarize-awr-db-parameter-changes

  • oci database-management summarize-awr-db-parameters

  • oci database-management summarize-awr-db-snapshot-ranges

  • oci database-management summarize-awr-db-sysstats

  • oci database-management summarize-awr-db-top-wait-events

  • oci database-management summarize-awr-db-wait-event-buckets

  • oci database-management summarize-awr-db-wait-events

• Support for VM.Standard.E3.Flex Flexible Compute Shape with customizable OCPUs and memory for Data Science Notebooks

  • oci data-science notebook-session create --configuration-details

  • oci data-science notebook-session update --configuration-details

• Support for HCX Enterprise Add-on for Oracle Cloud VMware Solution

  • oci ocvs sddc cancel-downgrade-hcx

  • oci ocvs sddc downgrade-hcx

  • oci ocvs sddc refresh-hcx-license-status

  • oci ocvs sddc upgrade-hcx

  • current-sku parameter in oci ocvs esxi-host create is now optional

  • initial-sku parameter in oci ocvs sddc create is now optional

• Support for Secrets Read By Name as part of Secrets in Vault Service

  • oci secrets secret-bundle get-secret-bundle-by-name

• Support for isDynamic field in the response for oci limits definition list

Changed

• Service modules are now dynamically imported at runtime, speeding up CLI invocations

Added

• Sample scripts are available for every command on the CLI public doc page and man pages

• Support for Object storage configuration source in the Resource Manager service

  • oci resource-manager stack create-from-object-storage

  • oci resource-manager stack update-from-object-storage

• Support for spark-submit compatible options in the Data Flow service

  • oci data-flow run submit

Fixed

• Wait for state parameter for the following commands were returning an error on valid states

  • oci mysql db-system start/stop --wait-for-state

  • oci resource-manager stack create --wait-for-state

• Fixed list commands in Artifacts service

  • oci artifacts container image list

  • oci artifacts container image-signature list

  • oci artifacts container repository list