All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog.
- Support for required tags in the Identity service
- Support for work requests on tagging operations in the Identity service
- Support for enumerated tag values in the Identity service
- Support for moving dynamic routing gateway resources across compartments in the Networking service
- Support for migrating zones from Dyn managed DNS to OCI in the DNS service
- Support for fast provisioning for virtual machine databases in the Database service
- Support for selecting the Terraform version to use in the Resource Manager service
- Support for bucket re-encryption in the Object Storage service
- Support for enabling / disabling bucket-level events in the Object Storage service
- Support for importing state files in the Resource Manager service
- Support for Exadata Cloud at Customer in the Database service
- Support for free tier resources and system tags in the Load Balancing service
- Support for free tier resources and system tags in the Compute service
- Support for free tier resources and system tags in the Block Storage service
- Support for free tier and system tags on autonomous databases in the Database service
- The availability_domain parameter is now a kwarg for list_db_system_shapes in DatabaseClient
- The model CreateDbHomeWithDbSystemIdBase was renamed CreateDbHomeBase and the parameter db_system_id was removed
- The parameter create_db_home_with_db_system_id_details for create_db_home in DatabaseClient changed from CreateDbHomeWithDbSystemIdBase to CreateDbHomeBase
- Support for specifying the autoBackupWindow field for scheduling backups in the Database service
- Support for network security groups on autonomous Exadata infrastructure in the Database service
- Support for Kubernetes secrets encryption in customer clusters, regional subnets, and cluster authentication for instance principals in the Container Engine for Kubernetes service
- Support for the Oracle Content and Experience service
- The etag header has been removed from the response for NotificationControlPlaneClient.change_topic_compartment and NotificationDataPlaneClient.change_subscription_compartment
- Support for the Sydney (SYD) region
- Support for managing cluster networks in the Compute Autoscaling service
- Support for tracking asynchronous operations via work requests in the Database service
- Support for the Sao Paulo (GRU) region
- Support for dedicated virtual machine hosts in the Compute service
- Support for resource groups in metrics and alarms in the Monitoring service
- Support for the Limits service
- Support for archiving to Object Storage in the Streaming service
- Support for etags on resources in the Streaming service
- Support for Key Management service (KMS) encryption of file systems in the File Storage service
- Support for moving public IP, DHCP, local peering gateway, internet gateway, network security group, and DRG attachment resources across compartments in the Networking service
- Support for multi-origin, basic cache, certificate mapping, and OCI Monitoring service integration in the Web Application Acceleration and Security service
- Support for the Data Transfer service
- Support for the Zurich (ZRH) region
- oci.waas.WafLog.timestamp type changed from str to datetime
- oci.waas.models.Certificate.issuer_name type changed from oci.waas.models.CertificateSubjectName to oci.waas.models.CerticateIssuerName
- "PURGE_WAAS_POLICY" removed as option for oci.waas.models.WorkRequest.operation_type
- "PURGE_WAAS_POLICY" removed as option for oci.waas.models.WorkRequestSummary.operation_type
- Support for IPv6 load balancers in the Load Balancing service
- Support for IPv6 on VCN and FastConnect resources in the Networking service
- Support for the Mumbai (BOM) region
- Support for the Events service
- Support for moving streams across compartments in the Streaming service
- Support for moving FastConnect resources across compartments in the Networking service
- Support for moving policies across compartments in the Web Application Acceleration and Security service
- Support for tagging FastConnect resources in the Networking service
- Support for moving resources across compartments in the Database service
- Support for moving resources across compartments in the Health Checks service
- Support for moving alarms across compartments in the Monitoring service
- Support for creating instance configurations from running instances in the Compute service
- Support for setting up budget alerts for cost tracking tags in the Budgets service
- Support for the Functions service
- Support for the Quotas service
- Support for moving resources across compartments in the DNS service
- Support for moving instances across compartments in the Compute service
- Support for moving keys and vaults across compartments in the Key Management service
- Support for moving topics and subscriptions across compartments in the Notifications service
- Support for moving load balancers across compartments in the Load Balancing service
- Support for specifying permitted REST methods in load balancer rule sets in the Load Balancing service
- Support for configuring cookie session persistence in backend sets in the Load Balancing service
- Support for ACL rules in rule sets in the Load Balancing service
- Support for move compartment tree in the Identity service
- Support for specifying and returning a KMS key in backup operations in the Block Storage service
- Support for transit routing in the Networking service
- Support for authenticating via Resource Principals. An example of how to use resource principals is available on GitHub. This authentication method is only supported within the Functions service at this time.
- Support for network security groups in the Load Balancing service
- Support for network security groups in Core Services
- Support for network security groups on database systems in the Database service
- Support for creating autonomous transaction processing and autonomous data warehouse previews in the Database service
- Support for getting the load balancer attachments of instance pools in the Compute service
- Support for moving resources across compartments in the Resource Manager service
- Support for moving VCN resources across compartments in the Networking service
- Support for moving images, instance configurations, and instance pools across compartments in Core Services
- Support for moving autoscaling configurations across compartments in the Compute Autoscaling service
- Fixed a bug where the Streaming service's endpoints in Tokyo, Seoul, and future regions were not reachable from the SDK
- Support for moving senders across compartments in the Email service
- Support for moving NAT gateway resources across compartments in Core Services
- Support for moving service gateway resources across compartments in Core Services
- Support for moving block storage resources across compartments in Core Services
- Support for key deletion in the Key Management service
- Support for specifying custom boot volume sizes on instance configurations in the Compute Autoscaling service
- Support for 'Autonomous Transaction Processing - Dedicated' features, as well as maintenance run and backup operations on autonomous databases, autonomous container databases, and autonomous Exadata infrastructure in the Database service
- Support for autoscaling autonomous databases and autonomous data warehouses in the Database service
- Support for specifying fault domains as part of instance configurations in the Compute Autoscaling service
- Support for deleting tag definitions and tag namespaces in the Identity service
- Support for regions in realms other than oraclecloud.com in the Load Balancing service
- Support for the Work Requests service, and tracking of a number of Core Services operations through work requests
- Support for emulated volume attachments in Core Services
- Support for changing the compartment of resources in the File Storage service
- Support for tags in list operations in the File Storage service
- Support for returning UI password creation dates in the Identity service
- Support for returning tags when listing instance configurations, instance pools, or autoscaling configurations in the Compute Autoscaling service
- Support for getting the namespace of another tenancy than the caller's tenancy in the Object Storage service
- Support for BGP dynamic routing and providing pre-shared secrets (PSKs) when establishing tunnels in the Networking service
- Support for the Seoul (ICN) region
- Support for logging context fields on data-plane APIs of the Key Management Service
- Support for reverse pagination on list operations of the Email service
- Support for configuring backup retention windows on database backups in the Database service
- Support for subscribed regions in stop_untagged_instances.py on GitHub.
- New services to showoci.py on GitHub.
- Support for the Tokyo (NRT) region
- A sample demonstrating how to find, stop and report on instances that have been improperly tagged is available on GitHub.
- A sample demonstrating adding and deleting an API key is available on GitHub.
- New services to showoci.py on GitHub.
- Updated example for Streaming service to address issue with encoding in Python 3 is available on GitHub.
- Support for tagging dynamic groups in the Identity service
- Support for updating network ACLs and license types for autonomous databases and autonomous data warehouses in the Database service
- Support for editing static routes and IPSec remote IDs in the Virtual Networking service
- An example for reporting details for multiple Oracle Cloud Infrastructure resources is available on GitHub.
- Support for etag and if-match headers (for optimistic concurrency control) in the Email service
- Support for provider service key names on virtual circuits in the FastConnect service
- Support for customer reference names on cross connects and cross connect groups in the FastConnect service
- A sample showing how to use Streaming service from the SDK is available on GitHub.
- Support for glob patterns and exclusions for object lifecycle management in the Object Storage service
- Documentation enhancements and corrections for traffic management in the DNS service
- Support for specifying metadata on node pools in the Container Engine for Kubernetes service
- Support for provisioning a new autonomous database or autonomous data warehouse as a clone of another in the Database service
- Updated vendored packages. idna==2.8, PyJWT==1.7.1, requests==2.21.0, six==1.12.0, urllib3==1.24.1, requests==2.21.0
- Support for the Budgets service
- Support for managing multifactor authentication in the Identity service
- Support for managing default tags in the Identity service
- Support for account recovery in the Identity service
- Support for authentication policies in the Identity service
- Support for specifying the workload type when creating autonomous databases in the Database service
- Support for I/O resource management for Exadata database systems in the Database service
- Support for customer-specified timezones on database systems in the Database service
- Support for the Monitoring service
- Support for the Notification service
- Support for the Resource Manager service
- Support for the Compute Autoscaling service
- Support for changing the compartment of a tag namespace in the Identity service
- Support for specifying fault domains in the Database service
- Support for managing instance monitoring in the Compute service
- Support for attaching/detaching load balancers to instance pools in the Compute service
- Support for government-realm regions
- Support for the Streaming service
- Support for tags in the Key Management service
- Support for regional subnets in the Virtual Networking service
- Removed unused Announcements service 'NotificationFollowupDetails' model and 'followups' from Announcement model
- Support for the Web Application Acceleration and Security (WAAS) service
- Support for the Health Checks service
- Support for connection strings on Database resources in the Database service
- Support for traffic management in the DNS service
- Support for tagging in the Email service
- Support for the Announcements service
- Support for renaming databases during restore-from-backup operations in the Database service
- Support for calling Oracle Cloud Infrastructure services in the ca-toronto-1 region
- KmsCryptoClient and KmsManagementClient updated to make service_endpoint required
- Explicitly imported path to idna. Addresses GitHub issue 101
- Support for device attributes on volume attachments in the Compute service
- Support for custom header rulesets in the Load Balancing service
- Support for Data Guard for VM shapes in the Database service
- Support for sparse disk groups for Exadata shapes in the Database service
- Support for a new field, isLatestForMajorVersion, when listing DB versions in the Database service
- Support for in-transit encryption for paravirtualized boot volume and data volume attachments in the Block Storage service
- Support for tagging DNS Zones in the DNS service
- Support for resetting credentials for SCIM clients associated with an Identity provider and updating user capabilities in the Identity service
- pyOpenSSL pinning was changed to pyOpenSSL>=17.5.0 and cryptography pinning to cryptography>=2.1.4 to address vulnerability CVE-2018-1000808
- Support for getting bucket statistics in the Object Storage service
- Support for using FIPS compliant libcrypto library
- Block Storage service for copying volume backups across regions is now enabled
- Support for VCN transit routing in the Networking service
- Fixed UploadManager to work with unbuffered streams in Python 3
- Support for modifying the route table, DHCP options and security lists associated with a subnet in the Networking service.
- Support for tagging of File Systems, Mount Targets and Snapshots in the File Storage service.
- Support for nested compartments in the Identity service
- database_size_in_g_bs field in Backup and BackupSummary models renamed to database_size_in_gbs.
- Support for cost tracking tags in the Identity service
- Support for generating and downloading wallets in the Database service
- Support for creating a standalone backup from an on-premises database in the Database service
- Support for db version and additional connection strings in the Autonomous Transaction Processing and Autonomous Data Warehouse resources of the Database service
- Support for copying volume backups across regions in the Block Storage service
- Support for deleting compartments in the Identity service
- Support for reboot migration for virtual machines in the Compute service
- Support for Instance Pools and Instance Configurations in the Compute service
- database_edition field in Backup and model changed from a free format string to a validated string. It will only accept one of the following: “STANDARD_EDITION”, “ENTERPRISE_EDITION”, “ENTERPRISE_EDITION_HIGH_PERFORMANCE”, “ENTERPRISE_EDITION_EXTREME_PERFORMANCE”
- db_data_size_in_mbs field in Backup and BackupSummary models renamed to database_size_in_g_bs. The type changed from int to float.
- Support for trusted partner images through application listings and subscriptions in the Compute service
- Support for object lifecycle policies in the Object Storage service
- Support for copying objects across regions in the Object Storage service
- Support for network address translation (NAT) gateways in the Networking service
- Support for paravirtualized launch mode when importing images in the Compute service
- Support for Key Management service
- Support for encrypting the contents of an Object Storage bucket using a Key Management service key
- Support for specifying a Key Management service key when launching a compute instance in the Compute service
- Support for specifying a Key Management service key when backing up or restoring a block storage volume in the Block Volume service
- ObjectStorageClient requires int value for content_length keyword agruement to put_object and upload_part, but the SDK was not converting the type for the Requests library.
- Added support for updating metadata fields on an instance in the Compute service
- Fixed example wait_for_resource_in_state.py to use existing response objects. The updated example can be found on GitHub.
- Support for fault domains in the Identity service
- Support for resizing an offline volume in the Block Storage service
- Support for Autonomous Data Warehouse and Autonomous Transaction Processing in the Database service
- Opened up the dependency pinning on cryptography due to CVE-2018-10903. OCI does not call the affected method in cryptography, but upgrading is recommended.
- Support for fault domains in the Compute service
- A sample showing how to use Search service from the SDK is available on GitHub.
- Support for the OCI Search service
- Support for specifying a backup policy when creating a boot volume in the Block Storage service
- Added retries to the InstancePrincipalsSecurityTokenSigner when trying to refresh security tokens
- Add six, requests, urllib3, idna, and chardet as vendored packages.
- Downloading an object from Object Storage could fail without an exception if the connection was closed while the object was being transmitted.
- The base exception from requests, requests.exceptions.RequestException, has been wrapped in oci.exceptions.RequestExceptions
- requests.exceptions.ConnectTimeout has been wrapped in oci.exceptions.ConnectTimeout
- Support for tagging Load Balancers in the Load Balancing service
- Support for export options in the File Storage service
- Support for retrieving compartment name and user name as part of events in the Audit service
- Setup.py updated to allow more version of cryptography when installing to an existing environment
- Add PyJWT as a vendored package
- Support for service gateway management in the Networking service
- Support for backup and clone of boot volumes in the Block Storage service
- Setup.py changed to allow more versions of pytz and python-dateutil packages when installing to an existing environment
- Support for the Container Engine service
- A sample showing how to use this service from the SDK is available on GitHub.
- Add dependency to idna >=2.5,<2.7 since cryptography and requests both have a dependency on the library and pip can install a version that is incompatable with requests.
This version was removed from PyPi due to a potential dependency conflict between cryptography and requests.
- Support for the Container Engine service
- A sample showing how to use this service from the SDK is available on GitHub.
- Support for the "soft shutdown" instance action in the Compute service
- Support for Auth Token management in the Identity service
- Bumped required version of python-dateutil to 2.7.3
- Support for launching a database system from a backup in the Database service
- Support for backup or clone of multiple volumes at once using volume groups in the Block Storage service
- Support for tagging virtual cloud network resources in the Networking service
- Support for specifying the PARAVIRTUALIZED remote volume type when creating a virtual image or launching a new instance in the Compute service
- Example to retrieve network information for an instance which can be found on Github.
- Added retrieving and setting the home region to the user_crud.py example which can be found on Github.
- In
FileStorageClient.list_exportsthecompartment_idparameter has moved from a positional to a keyword argument. This requires a code change as a v1.3.x call would look like:file_storage_client.list_exports('ocid1....')but in v1.4.x+ it would look likefile_storage_client.list_exports(compartment_id='ocid1....')
- Support for returning names for events in the Audit service
- Support for multiple hostnames per listener in the Load Balancing service
- Helper function for Base64-ing scripts for user_data in launch instance options
- An example of Base64-ing scripts for user_data can be found on GitHub.
- Add httpsig_cffi as a vendored package
- Multipart object put resume to account when final part is less than part size
- Support for tagging
DbSystemandDatabaseresources in the Database Service - Support for filtering by
DbSystemIdinListDbVersionsoperation in Database Service - Support for composite operations that provide convenience methods for operations that can be chained together (e.g. launching an instance and waiting for it to enter the RUNNING state)
- An example on how to perform these operations can be found on GitHub.
- Added Python 3.6 as a supported Python version
- Python API reference documentation improvements
- Added support for remote VCN peering across regions
- An example on how to perform these operations can be found on GitHub.
- Added support for calling Oracle Cloud Infrastructure services in the uk-london-1 (LHR) region
- Added support for the Email Service
- An example on using the Email Service can be found on GitHub.
- Added support for SMTP credentials in the Identity Service
- An example on managing SMTP credentials can be found on GitHub.
- Added support for paravirtualized volume attachments in Core Services
- An example on using volume attachments can be found on GitHub.
- Added support for variable size boot volumes in Core Services
- Support for File Storage Service
- An example on using the File Storage Service can be found on GitHub.
- Added support for tagging Bucket resources in the Object Storage Service
- An example on tagging buckets can be found on GitHub.
- Added support for specifying a restore period for archived objects in the
RestoreObjectsoperation of the Object Storage service.- An example on using archive storage can be found on GitHub.
- Support for Domain Name System Service
- An example on using the Domain Name System Service can be found on GitHub.
- Support for reserved public IPs in Virtual Networking Service
- An example on using this functionality can be found on GitHub.
- Support for path route sets in Load Balancing Service
- An example on using this functionality can be found on GitHub.
- Support for automated and policy-based backups, read-only volume attachments, and incremental backups in Block Storage Service
- An example on using policy-based backups can be found on GitHub.
- Support for filtering by
backupIdinListDbSystemsoperation in Database Service
- Support for using the
ObjectReadWithoutListpublic access type when creating and updating buckets - Support for dynamic groups in Identity Service
- Support for instance principals authentication when calling OCI services. An example of how to use instance principals authentication can be found on GitHub.
- Support for configuring idle timeout for listeners in Load Balancer Service
- Support for VNC console connections in Compute Service
- Support for tagging:
- Support for creating, updating, retrieving and listing tags and tag namespaces (these operations can be found in Identity Service)
- Support for adding freeform and defined tags to resources in Core Services (Networking, Compute, and Block Volume) and Identity Service
- An example on using tagging can be found on GitHub.
- Support for bringing your own custom image for emulation mode virtual machines in Compute Service
- Added the
oci.paginationmodule, which contains convenience functions so that you don't have to manually deal with page tokens when using list operations. See the documentation for more information
- Upgraded cryptography dependency to 2.1.3
- Added 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
- Support for public peering for FastConnect
- Support for specifying an authorized entity name in a Letter of Authority
- Support for showing a list of bandwidth shapes for a specific provider (the
list_fast_connect_provider_virtual_circuit_bandwidth_shapesinVirtualNetworkClient)
- Audit events now have a
response_payloadattribute which contains metadata of interest. For example, the OCID of a resource
- The
list_virtual_circuit_bandwidth_shapesoperation inVirtualNetworkClienthas been deprecated. Use thelist_fast_connect_provider_virtual_circuit_bandwidth_shapesoperation instead - When using
CreateVirtualCircuitDetails, supplying aprovider_nameis deprecated andprovider_service_idshould be used instead
- Support for initializing model objects from keyword arguments
- Support for VCN to VCN peering within the same region
- Support for sorting and filtering in list APIs in Load Balancing service
- Support for user managed boot volumes
- Support for using a second physical NIC when attaching VNICs on X7 Bare Metal instances
- Model types now check the data types of their attributes prior to data being serialized and sent to the service
- When opc_request_id is specified as a parameter, it is no longer overwritten with a SDK-generated value
- Support for the Audit service
- Support for archive storage tier, object rename and namespace metadata in Object Storage service
- Support for fast clones of volumes in Block Storage service
- Support for backup and restore in Database service
- Support for sorting and filtering in list APIs in Core Services
- Support for passing explicit None values to service operations. Consult the Passing explicit Null/None values section of the docs for more information.
- Support for supplying private key contents through the 'key_content' config field
- Upgraded cryptography dependency to 1.9.
- Minimum version of Mac OS supported is now 10.8
- Creating block volumes and specifying the size in MBs is deprecated. Instead, the new size_in_gbs field should be used to specify the volume size in GBs.
- Support for creating block volumes and specifying the size in GBs.
- Support in UploadManager for handling piped input.
- Support for adding and updating display names for captured instance serial console data.
- Support for VNIC source/destination checks.
- Support for new Database service features: VM DBs, Bring Your Own License, and Data Guard.
- Support for the FRA (eu-frankfurt-1) region.
- The size of block volumes and volume backups is specified in GBs as well as MBs.
- The top level namespace / package name has been changed from oraclebmc to oci. The oraclebmc package is deprecated and will no longer be maintained starting March 2018. Please upgrade to the oci package to avoid interruption at that time. More info is available here.
- The default configuration file location has been changed from ~/.oraclebmc/config to ~/.oci/config. The old location still works if the file at the new location does not exist.
- Support for the Database service
- Support for instance console connections
- Support for the Load Balancer Health Status API
- Support for Compartment renaming
- Support for managing customer secret keys
- The default configuration file location is now ~/.oci/config
- Documentation for UploadManager.
- Upgraded cryptography dependency to 1.8.2.
- Support for VCN multi-VNIC operations.
- Support for VCN secondary IP operations.
- Support for compute image import/export operations.
- Fixed bug in support for load balancing service.
- An UploadManager class to better support large object uploads through multipart and parallel operations.
- Support for object storage pre-authenticated requests and public buckets.
- Support for load balancing service.
- Support for nested instance metadata operations.
- Support for VCN private subnets using the prohibit_public_ip_on_vnic parameter on oci.core.VirtualNetworkClient.create_subnet.
- Support for FastConnect
- Support for list_regions and region subscription operations
- First class support for new IAD region
- For manually created configs (not from a file), use default values for optional fields that are not present (GitHub issue)
- Updated parsing of 'region' config value to enable better support for unrecognized regions
- No longer throwing exceptions for unrecognized enum values returned by services. Any unrecognized enum value returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'.
- Support for DHCP Search Domain Option.
- Support for ComputeClient.get_windows_instance_initial_credentials.
- Allow service responses to deserialize to base classes when unknown subtypes are returned. Previously this would result in an exception.
- Support hostnames for instances and DNS labels for VCNs and subnets.
- Updated cryptography version to 1.8.1
- Support for iPXE script parameter to launch_instance operation
- Support for stateless security list rules
- Support added for Core Services:
- Block Storage
- Compute
- Virtual Network
- Initial Release
- Support added for Identity Service, Object Storage Service