2.4.21

Added

• Support for the following features for the Database service:
  • Tagging support for the following resources
    • Update database (oci db database update --defined-tags --freeform-tags)
    • Launch and update database system (oci db system launch|update --defined-tags --freeform-tags)
  • Filter set of database versions based on database system ID (oci db version list --db-system-id)

2.4.20

Added

• An example of how to scale existing VM instances using CLI can be found on Github
• A warning message informing use of --all flag to get all items during list operations.

Fixed

• Multipart bulk download in Object Store service to correctly enable downloads as per size thresholds set by the user.
• Check all required parameters are present before prompting for deleting resource

Changed

• Use root compartment OCID (tenancy OCID) as default value for --compartment-id in oci iam compartment list command.

2.4.19

Added

• Support for managing SMTP credentials in the Identity Service (oci iam smtp-credential)
• Support for remote VCN peering across regions (oci network remote-peering-connection)
• Support for calling Oracle Cloud Infrastructure services in the uk-london-1 (LHR) region

Changed

• When listing audit events (oci audit event list) the --start-time and --end-time parameters specify values with granularity to the minute. If you provide values which have non-zero seconds or milliseconds, these will be rounded to the nearest minute with greater than or equal to 30 seconds rounding upwards and less than 30 seconds rounding downwards

Fixed

• When providing a datetime parameter to the CLI, v2.4.18 and below did not parse datetimes correctly but instead of failing they silently coverted values to midnight of the date provided and sent this value to the service. This version fixes the datetime parsing and the following inputs will be considered valid:

  • YYYY-MM-DDTHH:mm:ss.sssTZD (UTC) with milliseconds, e.g. 2017-09-15T20:30:00.123Z
  • YYYY-MM-DDTHH:mm:ssTZD (UTC) without milliseconds, e.g. 2017-09-15T20:30:00Z
  • YYYY-MM-DDTHH:mmTZD (UTC) with minute precision, e.g. 2017-09-15T20:30Z
  • YYYY-MM-DDTHH:mm:ssTZD (timzone with offset) with milliseconds, e.g. 2017-09-15T12:30:00.456-08:00, 2017-09-15T12:30:00.456-0800
  • YYYY-MM-DDTHH:mm:ssTZD (timezone with offset) without milliseconds, e.g. 2017-09-15T12:30:00-08:00, 2017-09-15T12:30:00-0800
  • YYYY-MM-DDTHH:mmTZD (timezone with offset) with minute precision, e.g. 2017-09-15T12:35-08:00, 2017-09-15T12:35-0800
  • YYYY-MM-DD, e.g. 2017-09-15. This date will be taken as midnight UTC of that day
  • Unix time in seconds, e.g. 1412195400

Security Notice

• Versions of oci-cli prior to 2.4.10 are affected by a security vulnerability. Versions 2.4.11 and later will automatically detect vulnerable installations, and if issues are detected, a warning will be displayed to the user. These issues can be remediated automatically by running the oci setup repair-file-permissions command.

2.4.18

Added

• Support for the Email Service. (oci email)
  • A sample test using the email feature can be found on Github
• Support for the following features in the Core Services:
  • paravirtualized volume attachments (--type option for oci compute volume-attachment attach)
  • variable size boot volumes (--boot-volume-size-in-gbs option for oci compute instance launch)
• Support for auto-pagination for the Domain Name System Service. (--all, --page-size options for oci dns record domain get, oci dns record rrset get, oci dns record zone get)
• Support for no-overwrite flag for the object put operation for the Object Service (--no-overwrite for oci os object put).

Fixed

• Updated config / key file permissions logic on Windows to depend on well known SIDs instead of account / group name to fix localization issues. This affects oci setup config, oci setup repair-file-permissions, and the general config / key file permissions check performed by other commands.

2.4.17

Added

• Support for the File Storage Service. (oci fs)
  • An example can be found on GitHub
• Support for Path Route Sets in the Load Balancer Service. An example can be found on GitHub (oci lb path-route-set)
• Tagging support for Bucket resources in the Object Storage Service
  • Create a bucket with tags: oci os bucket create --defined-tags --freeform-tags
  • Update a bucket with tags: oci os bucket update --defined-tags --freeform-tags
  • List buckets and display defined and freeform tags in the results: oci os bucket list --fields tags
• Support for specifying a restore period for archived objects in the RestoreObjects operation of the Object Storage service. (oci os object restore --hours)
• Added support for filtering by backupId in ListDbSystems operation in the Database Service. (oci db system list --backup-id)
• Support for getting plink (the PuTTY command line interface) compatible instance console connection string for Windows users. (oci compute instance-console-connection get-plink-connection-string)

2.4.16

Added

• Support for Domain Name System Service (oci dns)
  • An example on using the Domain Name System Service can be found on GitHub.
• Support for Reserved Public IPs in Virtual Networking Service (oci network public-ip)
• Support for the following features in Block Storage Service
  • Automated and policy-based scheduled backups (oci bv volume-backup-policy | volume-backup-policy-assignment)
  • Read-only volume attachments (--is-read-only option while attaching volume)
  • Incremental backups (--type option while creating a volume backup)

2.4.15

Added

• Support for using the ObjectReadWithoutList public access type when creating and updating buckets
• Support for managing dynamic groups (oci iam dynamic-group)
• Support for instance principal auth (using --auth instance_principal option)

2.4.14

Added

• Support for tagging
  • Tags and tag namespaces can be managed via the 'oci iam tag-namespace' and 'oci iam tag' commands
  • Operations which support applying tags will have --defined-tags and --freeform-tags options. Check the help dump (https://github.com/oracle/oci-cli/blob/master/tests/output/inline_help_dump.txt) for resources which support tags. A general list of taggable resources can also be found in: https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/taggingoverview.htm#Taggable
  • An example of using tagging can be found at https://github.com/oracle/oci-cli/blob/master/scripts/tagging_example.sh
• Support for bringing your own custom image for emulation mode virtual machines in Compute Service (--launch-mode parameter on create image)
• Support for returning unquoted strings when the result of a JMESPath --query is a single string value (using --raw-output option)
• Support for launching an instance from an image or boot volume using the --image-id or --source-boot-volume-id parameters (these are alternatives to specifying --source-details)
• Support for boot volume attachment operations (oci compute boot-volume-attachment)
• Support wait for state on detach operations (e.g. oci compute volume-attachment detach --wait-for-state)

Changed

• Upgraded cryptography dependency to 2.1.3
  • Changed dependency on pyOpenSSL <= 17.4.0 as the minimum cryptography version for pyOpenSSL 17.5.0 is 2.1.4
• Upgraded six dependency to 1.11.0
• Ugraded requests dependency to 2.18.4

2.4.13

Added

• Support for Load Balancing Service operations ('oci lb')

  • An example of creating a load balancer can be found at https://github.com/oracle/oci-cli/blob/master/scripts/create_load_balancer.sh

• Support for user managed boot volumes: 'oci bv boot-volume', 'oci compute instance launch --source-details', 'oci compute instance terminate --preserve-boot-volume'

• Operations which create, update or delete resources with a lifecycle-state now support a --wait-for-state option which allows you to perform the action and then wait until the resource reaches a given state

• Support for specifying --profile option through OCI_CLI_PROFILE environment variable

Changed

• When listing audit events ('oci audit event list'), audit events can now have a 'response-payload' attribute which contains metadata of interest. For example, the OCID of a resource

2.4.12

Added

• Support option for using second physical NIC on X7 Bare Metal instances (--nic-index option on 'oci compute instance attach-vnic')
• Support for Local Peering Gateway operations ('oci network local-peering-gateway')
• Support for specifying a default for the --profile option in the oci_cli_rc file
• Support create database from backup (oci db database create-from-backup)
• Support for getting archived object restore status ('oci os object restore-status') more details in sample (https://github.com/oracle/oci-cli/scripts/restore_archived_object.sh)

Changed

• Help displayed via the --help/-h/-? option is now formatted like man pages found on Unix (or Unix-like) systems. To switch back to the previous way of displaying help, add use_click_help = True to the OCI_CLI_SETTINGS section of your oci_cli_rc file