Service Change Announcements

Review details about Oracle Cloud Infrastructure breaking changes, such as deprecated features, deprecated APIs, and service behavior changes.

API Gateway

Deprecated Ciphers

Service Change: Oracle Cloud Infrastructure API Gateway service support for certain legacy ciphers is deprecated.

Date Announced: March, 2024

Date in Effect: April 1, 2025

Details: Effective April 1, 2025, the API Gateway service no longer supports the following legacy ciphers:

  • ECDHE-RSA-AES128-SHA256
  • ECDHE-RSA-AES256-SHA384
  • DHE-RSA-AES256-SHA256
  • DHE-RSA-AES128-SHA256

Does this impact me? After April 1, 2025, an API gateway will no longer include the legacy ciphers in the list of supported ciphers when establishing a connection with an API client or with a back-end service. An API client or a back-end service that only supports legacy ciphers will no longer be able to connect to an API gateway.

What do I need to do? Make sure that API clients and back-end services connecting to API gateways support one or more of the ciphers that continue to be supported by the API Gateway service (see Supported TLS Versions and Ciphers).

Autonomous Recovery Service

Deprecated subnetId Attribute

Service Change: The required subnetId attribute from the Oracle Cloud Infrastructure's CreateRecoveryServiceSubnet API is deprecated.

The CreateRecoveryServiceSubnet API can instead use the optional Subnets attribute, which later changes to become a required attribute.

Date Announced: May 2023.

Date in Effect: May 2024.

Details: Prior to this service change, the subnetId attribute can be used to specify only a single subnet to be associated with a Recovery Service subnet. After this service change, the subnetId attribute is ignored and subnets will be required attribute. The subnets attribute can be used to specify multiple subnets to be associated with a Recovery Service subnet.

Does this impact me? If you have custom scripts or Terraform scripts that are referencing the CreateRecoveryServiceSubnet API and are explicitly using the subnetId attribute, you might want to modify the scripts to remove this attribute and use subnets instead.

What do I need to do? When using OCI SDKs and command line tools, you must choose to update your custom scripts to use the subnets attribute. After May 2024, the subnets attribute is a required field.

Big Data Service

Oracle Big Data Service with Cloudera Distribution of Hadoop – BDS CDH expansion restriction

Service Change: On January 31, 2023, the agreement between Oracle and Cloudera expires. As a result, starting on January 31, Oracle Big Data Service will no longer support using the Cloudera Distribution including Apache Hadoop (CDH) to launch new clusters or add nodes or cores to existing clusters beyond a set limit. This change doesn't impact ongoing support of existing Big Data Service CDH clusters.

This change is applicable only to Big Data Service CDH. This change does not impact customers who use on-premises Oracle Big Data Appliance (BDA) or Big Data Service with Oracle Distribution of Hadoop (ODH).

Date Announced: December 13, 2022

Date in Effect: January 31, 2023

Details: On January 31, 2023, the limit for Big Data Service CDH expansion of the number of compute cores (OCPUs) freezes. The number of compute cores in a customer's tenancy on January 31 becomes the maximum number of cores allowed for that tenancy, and no further expansion will be allowed.

Does this impact me? This change is only applicable to Big Data Service with CDH. Big Data Service with Oracle Distribution of Hadoop (ODH) is not impacted in any way.

For example, on January 31, 2023 if a tenancy has 2 BDS CDH clusters with 15 nodes each with a total of 120 OCPUs, then after January 31, 2023 the maximum limit for OCPUs will be set to 120 and cannot be increased beyond 120 after that date. For support issues such as replacing failed nodes, new nodes may be added up to that limit. Users can also decrease the number of cores and increase back to the same limit (for example, 120).

Next steps: Oracle recommends planning and implementing any required Big Data Service CDH cluster expansions before January 31, 2023. For customers who want to avoid this expansion constraint after that date, we recommend migrating to Big Data Service ODH.

About Big Data Service with ODH: In 2022, Oracle released Big Data Service ODH, which we developed as a cloud native service for our big data customers. Oracle provides continuous investment and support for ODH, with no licensing requirements from Cloudera. ODH has key enterprise-focused features, including autoscaling, Kerberos, Active Directory integration, HDFS connector for Object Storage, and Bootstrap scripts. And it's one of the most cost-efficient big data products in the market.

Big Data Service ODH has multiple versions with the latest and previous versions of Hadoop components for compatibility with newer and older application stacks. It's also verified with WANdisco Data Migrator for easier migrations at scale and uses Oracle Cloud Lift services to work with Oracle engineers for migrations. For information about migrating to Big Data Service ODH, see the documentation.

Block Volume

Full backups removed from Oracle defined backup policies

Service Change: Oracle defined backup policies no longer include full volume backups.

Date Announced: November 3, 2020

Date in Effect: November 3, 2021

Details: Starting November 3, 2021, Oracle defined backup policies no longer include full volume backups. All volume backups generated from Oracle defined policies are now incremental backups. This change applies to existing volume backup policy assignments and new volume backup policy assignments. This change does not impact user defined policies, which remain unchanged.

Does this impact me? If you have assigned an Oracle defined policy to boot volumes or block volumes for scheduled backups, full backups are no longer generated after November 3, 2021.

What do I need to do? Incremental backups are functionally the same as full backups for data recovery purposes, for more information, see Volume Backup types. No action is needed for data recovery scenarios. Some compliance scenarios may require scheduled full backups. For these compliance scenarios, change the backup policy assignment to a user defined backup policy prior to November 1, 2021. You can create a new user defined policy from an existing backup policy, see Duplicating Existing Backup Policies.

Classic Migration

Classic Migration Service End of Life

Service Change: End-of-life for OCI Classic Migration Service effective March 31, 2024.

Date Announced: March 04, 2024

Date in Effect: March 31, 2024

Details: Oracle announces the end-of-distribution and end-of-life updates for OCI Classic Migration Service effective March 31, 2024.

Classic Migration Service (formerly known as Application Migration Service) simplifies the migration of applications from Oracle Cloud Infrastructure Classic to Oracle Cloud Infrastructure. Classic Migration Service migrates applications such as Oracle Java Cloud Service, SOA Cloud Service, and Integration Classic applications, from Oracle Cloud Infrastructure Classic and Oracle Cloud@Customer to Oracle Cloud Infrastructure.

Does this impact me? There should be no impact to existing customers. Application versions that were supported by Classic Migrations have been obsolete for a number of years and customers are already running on more recent versions.

What do I need to do? No expected actions from customers. If you do find that you have a Classic application that needs to be migrated out then please contact the associated Cloud Application service.

Compute

PCI-NIC fault class for Compute bare metal instance health monitoring is deprecated

Service Change: The PCI-NIC fault class for Compute bare metal instance health monitoring is deprecated.

Date Announced: June 21, 2022

Date in Effect: June 21, 2023

Details: The PCI-NIC fault class provides information about a hardware issue with your bare metal instances, specifically when a fault in the instance network interface card (NIC) has been detected. The PCI-NIC fault class will no longer be emitted.

Does this impact me? When support ends, you will no longer receive health monitoring notifications for the PCI-NIC fault class. Infrastructure health metrics will no longer be emitted for the PCI-NIC fault class.

What do I need to do? Migrate to the PCI fault class for similar functionality. For more information, see Compute Health Monitoring for Bare Metal Instances and Infrastructure Health Metrics.

Developer Tools

OCI Java SDK Version 2 Is Deprecated

Service Change: OCI Java SDK version 2 is being deprecated.

Date Announced: April 6, 2023

Date in Effect: June 30, 2023

Details: Oracle has recently released Oracle Cloud Infrastructure (OCI) Java SDK version 3. OCI Java SDK version 3 is a major SDK release, and we recommend that you upgrade to this latest version. We will continue to fully support OCI Java SDK version 2 until the end of June 2023. During this time, both OCI Java SDK versions 2 and 3 will receive regular updates to add support for new service APIs, critical bug fixes and security patches, and documentation modifications.

Does this impact me? After June 30, 2023, OCI Java SDK version 2 will no longer receive updates to add support for new regions, new services, or features in existing services, unless otherwise specified. For older versions of the OCI Java SDK version 2 that are less than 12 months old, upon request, OCI will backport critical bug fixes and security issues only.

What do I need to do? Upgrade to OCI Java SDK version 3.

Database

Changed Autonomous Database API default values for isMTLConnectionRequired attribute

Service Change: The default value of the isMTLSConnectionRequired attribute will change from true to false on July 1, 2023 in the following APIs:

Date Announced: February 7, 2023.

Date in Effect: July 1, 2023.

Details: Prior to this service change, the isMTLSConnectionRequired attribute default value was true. This is applicable for Autonomous Database on shared Exadata infrastructure.

Does this impact me? If you have custom scripts or Terraform scripts that are referencing the CreateAutonomousDatabase, GetAutonomousDatabase, or UpdateAutonomousDatabase APIs, you might want to modify the scripts to account for the changed default value of this attribute. However, should you choose not to make any changes to your scripts, the API calls containing this attribute will continue to work except that the default value will switch from "true" to "false".

What do I need to do? When using OCI SDKs and command line tools, you might choose to update your custom scripts to explicitly set the isMTLSConnectionRequired attribute to "true".

Deprecated Autonomous Database APIs and Fields and Changed Success Response Values

Service Change: The following APIs have changes where the API or certain API fields are deprecated.

Date Announced: May 17, 2023.

Date in Effect: May 17, 2024.

Details: Prior to this service change, these APIs included the APIs or the API fields mentioned. After this service change, the mentioned APIs or APIs fields will be removed. This is applicable for Autonomous Database on shared Exadata infrastructure.

Support for these Autonomous Database API Fields will end on May 2, 2024. Oracle recommends that you migrate your scripts to discontinue the use of these Fields as soon as possible. Where provided, switch to use the replacement field or API.

Deprecated Autonomous Database APIs:
  • AutonomousDataWarehouse
  • AutonomousDataWarehouseSummary
Deprecated Autonomous Database API Fields:
  • CreateAutonomousDatabaseBase Deprecated API Fields:
    • isDataGuardEnabled
    • isLocalDataGuardEnabled
  • CreateRefreshableAutonomousDatabaseCloneDetails Deprecated API Fields:
    • autoRefreshPolicy
    • autoRefreshFrequencyInSeconds
    • autoRefreshPointInSeconds
    • timeOfAutoRefreshStart
  • UpdateAutonomousDatabaseDetails Deprecated API Fields:
    • autoRefreshPolicy
    • autoRefreshFrequencyInSeconds
    • autoRefreshPointInSeconds
    • timeOfAutoRefreshStart
    • isDataGuardEnabled
  • AutonomousDatabaseSummary Deprecated API Fields:
    • standbyDb
    • dataguardRegionType
    • timeDataGuardRoleChanged
    • isDataGuardEnabled
    • isLocalDataGuardEnabled
    • serviceConsoleUrl
  • UpdateAutonomousDatabaseWalletDetails Deprecated API Field:
    • shouldRotate
  • AutonomousDatabaseStandbySummary Deprecated API Field:
    • timeDataGuardRoleChange
Replacement for Deprecated APIs:
Deprecated API Replacement API
CreateCrossRegionAutonomousDatabaseDataGuardDetails CreateCrossRegionDisasterRecoveryDetails
AutonomousDataWarehouse No replacement
AutonomousDataWarehouseSummary No replacement
Replacement for Deprecated API Fields:
Deprecated API Field Replacement API Field
UpdateAutonomousDatabaseDetails.isDataGuardEnabled UpdateAutonomousDatabaseDetails.isLocalDataGuardEnabled
AutonomousDatabaseSummary.standbyDb AutonomousDatabaseSummary.localStandbyDb
AutonomousDatabaseSummary.isDataGuardEnabled AutonomousDatabaseSummary.localDisasterRecoveryType
AutonomousDatabaseStandbySummary.timeDataGuardRoleChange AutonomousDatabaseStandbySummary.timeDisasterRecoveryRoleChanged
Changed Success Response Values for APIs:
Autonomous Database API Current Success Response Value Updated Sucess Response Value
createAutonomousDatabase 200 202
updateAutonomousDatabase 200 202
restoreAutonomousDatabase 200 202
startAutonomousDatabase 200 202
restartAutonomousDatabase 200 202
stopAutonomousDatabase 200 202
failOverAutonomousDatabase 200 202
switchoverAutonomousDatabase 200 202
autonomousDatabaseManualRefresh 200 202

Does this impact me?: If you have custom scripts or Terraform scripts that are referencing these APIs, or the mentioned fields, you should modify the scripts to account for these changes.

What do I need to do?: When using OCI SDKs and command line tools, you update your custom scripts to either remove use of the deprecated APIs or fields or use the replacements.

Changed Autonomous Database return values for APIs

Service Change: The return values for certain APIs changes, where return the value of 409 Incorrect State in some cases, as appropriate, is changed to 409 Conflict.

Date Announced: October 2023.

Date in Effect: October 2024.

Details: Prior to this service change, certain API calls fail with 409 Incorrect State error code. After this service change, in certain cases as appropriate, the API calls will fail with error code 409 Conflict.

Before this change, many APIs return 409 Incorrect State when the Autonomous Database is Stopped or is Unavailable. For these states, according to the API guidelines the correct return is 409 Conflict. For other Autonomous Database states, such as Starting, Stopping, and Provisioning, the current return of 409 Incorrect State is correct and this will not change after this update.

The 409 Incorrect State return should be used to indicate that retries are OK and that the resource will eventually reach the correct state, and the return 409 Conflict indicates that the resource will not reach the correct state on its own and that retries should not be performed. This service change changes the error code value in these APIs for the cases where 409 Conflict is representative of the known Autonomous Database state.

This service change applies to the following APIs:

Does this impact me?: If you have custom scripts or Terraform scripts that are handling the 409 Incorrect State return from these APIs, you might want to modify the scripts to handle the 409 Conflict return, as appropriate.

What do I need to do?: When using OCI SDKs and command line tools, you might choose to update your custom scripts.

Autonomous Database Serverless Manual Backup Deprecated

Service Change: On Autonomous Database Serverless the ability to take manual backups, which aren't long-term backups, is being deprecated.

Autonomous Database Serverless automatically backs up the database up to 60 days. Due to this change, on February 15, 2025 when you call the CreateAutonomousDatabaseBackupDetails API with the isLongTermBackup attribute, the value must be set to true. The default value of the isLongTermBackup attribute will also change to true.

Date Announced: February 15, 2024.

Date in Effect: February 15, 2025.

Details: Prior to this service change, the attribute isLongTermBackup default value was false. After this service change, the only valid value for the isLongTermBackup attribute is true. This change is applicable for Autonomous Database Serverless.

Does this impact me?: If you have custom scripts or Terraform scripts that are referencing the CreateAutonomousDatabaseBackupDetails API, you might want to modify the scripts to account for the changed default value of this attribute. However, if you choose not to make any changes to your scripts, the API calls containing this attribute will continue to work except that the default value will switch from false to true.

What do I need to do?: When using OCI SDKs and command line tools, update your custom scripts to explicitly set the isLongTermBackup attribute to true.

Deprecated isShared Parameter for autonomousDatabaseCharacterSets

Service Change: The isShared parameter from the Oracle Cloud Infrastructure's ListAutonomousDatabaseCharacterSets is deprecated.

Date Announced: October 2023.

Date in Effect: October 2024.

Details: Prior to this service change, the optional isShared parameter can be used. This change introduces the optional isDedicated parameter, and the isShared parameter will be removed after October 2024.

Does this impact me?: If you have custom scripts or Terraform scripts that are referencing the ListAutonomousDatabaseCharacterSets API using the isShared parameter with the value TRUE, modify the scripts to replace this parameter with the isDedicated parameter with the value FALSE, and if you are referencing the ListAutonomousDatabaseCharacterSets API using the isShared parameter with the value FALSE, modify the scripts to replace this parameter with the isDedicated attribute with the value TRUE.

What do I need to do?: When using OCI SDKs and command line tools, update your custom scripts to replace the isShared parameter with the isDedicated parameter.

Deprecated Exadata Database Service on Dedicated Infrastructure APIs

Oracle Cloud Infrastructure's Exadata DB system APIs were deprecated on November 15, 2020.

Important!: No new systems can be provisioned with the old DB system resource model/APIs after May 15th, 2021. Support for the old DB system resource model/APIs on existing systems will end on November 15th, 2021. Oracle recommends that you migrate your Exadata Database Service on Dedicated Infrastructure instances to the new resource model APIs as soon as possible. Converting to the new resource model does not involve any system downtime.

Unsupported API Replacement APIs
LaunchDbSystem (deprecated for Exadata systems only) CreateCloudExadataInfrastructure and CreateCloudVmCluster
ListDbSystems (deprecated for Exadata systems only) ListCloudExadataInfrastructures and ListCloudVmClusters
GetDbSystem (deprecated for Exadata systems only) GetCloudExadataInfrastructure and GetCloudVmCluster
ChangeDbSystemCompartment (deprecated for Exadata systems only) ChangeCloudExadataInfrastructureCompartment and ChangeCloudVmClusterCompartment
UpdateDbSystem (deprecated for Exadata systems only) UpdateCloudExadataInfrastructure and UpdateCloudVmCluster
GetExadataIormConfig (deprecated for Exadata systems only) GetCloudVmClusterIormConfig
UpdateExadataIormConfig (Exadata systems only) UpdateCloudVmClusterIormConfig
TerminateDbSystem (deprecated for Exadata systems only) DeleteCloudExadataInfrastructure and DeleteCloudVmCluster
Deprecated database workload attribute

Service Change: The optional dbWorkload attribute from the Oracle Cloud Infrastructure's CreateDatabase API is deprecated.

Date Announced: November 2022.

Date in Effect: November 2023.

Details: Prior to this service change, the dbWorkload attribute can be used to choose between either the OLTP (Online Transaction Processing) or the Data Warehouse (Analytic) workload, and is used internally to determine memory settings based on the database workload. After this service change, the dbWorkload attribute is treated as a "no-op" (no operation), which means that while API calls containing the deprecated attribute will not fail, the passed value will be ignored and the system will instead use a default value internally. This is applicable for Exadata Database Service on Dedicated Infrastructure, Exadata Database Service on Cloud@Customer, and Base Database Service.

Does this impact me? If you have custom scripts or Terraform scripts that are referencing the CreateDatabase API and are explicitly using the dbWorkload attribute, you might want to modify the scripts to remove this attribute. However, should you choose not to make any changes to your scripts, the API calls containing this attribute will continue to work except that the value passed for the dbWorkload attribute will not be considered.

What do I need to do? When using OCI SDKs and command line tools, you might choose to update your custom scripts to exclude the dbWorkload attribute. After November 2023, if you pass a value to the dbWorkload attribute, it will be ignored.

Database Migration

Deprecated Database Migration APIs

Service Change: Oracle Cloud Infrastructure's Database Migration APIs of version 20200720 were deprecated on October 6, 2021.

Date Announced: October 6, 2021

Date in Effect: October 5, 2022

Details: Starting October 5, 2022, Database Migration APIs of version 20200720 is deprecated.

  • Any resource created with the deprecated version is automatically converted to the latest resource model (version 20210929). (Before this date, any created with the deprecated version remains accessible on its basePath of /20200720.)
  • OCI Console users are automatically migrated to the latest resource model (version 20210929).
  • OCI SDKs and command line tools that were released before October 6, 2021, are limited to the features of the deprecated resource model (version 20200720).
  • Database Migration Service Agent Kits that were downloaded before October 6, 2021, are limited to the features of the deprecated resource model (version 20200720).

Does this impact me? Yes, if you have an older client or agent kit.

What do I need to do?

List of unsupported and replacement APIs

DevOps

Deprecated DevOps APIs

Service Change: Oracle Cloud Infrastructure's DevOps APIs (two APIs) of version 20210630 were deprecated on March 29, 2022.

Date Announced: March 29, 2022

Date in Effect: March 29, 2023

Details: Starting March 29, 2022, two DevOps APIs of version 20210630 were deprecated. From March 29, 2023, onwards the deprecated APIs will be unavailable.

Event Hub

Event Hub service deprecated

Service Change: The Event Hub service is deprecated.

Date Announced: April 29, 2022

Date in Effect: May 31, 2023

Details: Effective May 31, 2023, the Oracle Event Hub service will reach end of life (EOL). Prior to the EOL date, we recommend that you migrate your data streams from Event Hub to Oracle Cloud Infrastructure Streaming.

Does this impact me? If you use Event Hub service to create Kafka Clusters and/or Event Hub topics, you will no longer be able to after May 31, 2023. Previously created clusters will continue to operate in your tenancy without changes.

What do I need to do? All Event Hub customers can now use Streaming to move data using its tight integrations with Oracle Cloud Infrastructure (OCI), Database, GoldenGate, and Integration Cloud. The service uses a Kafka Connect harness to provide out-of-the-box integrations for hundreds of third-party products across categories such as DevOps, databases, big data, and SaaS applications.

File Storage

New service limit introduced for number of file systems attached to a snapshot policy

Service Change: A maximum of 100 file systems may be attached to any particular snapshot policy.

Date Announced: August 5, 2023

Date in Effect: August 7, 2023

Details: Starting August 7, 2023, a new service limit will be introduced to limit the total number of file systems attached to a snapshot policy. This change will allow up to 100 file systems to be attached per snapshot policy per tenant per availability domain.

Does this impact me? If you're planning to attach more than 100 file systems to any particular snapshot policy, then you won't be able to do so after August 7, 2023. Any existing tenants who have more than 100 file systems attached per snapshot policy before August 7, 2023 will be given an exception. No exceptions will be given after August 7, 2023.

What do I need to do? If you need to attach more than 100 file systems to a snapshot policy, then create a second snapshot policy or use any other existing snapshot policy. You can create 100 snapshot policy per tenant per availability domain. You can still generate policy-based snapshots for file systems, but you might have to use more than one snapshot policy.

Full Stack Disaster Recovery

Deprecated Member Type

Service Change: The COMPUTE_INSTANCE member type in DrProtectionGroupMemberType is getting deprecated and will no longer be supported.

Date Announced: October 31, 2023

Date in Effect: October 31, 2024.

Details: The member type COMPUTE_INSTANCE is getting deprecated and will be replaced by the following alternate member types:
  • COMPUTE_INSTANCE_MOVABLE: Used for compute instances that move during DR operations.
  • COMPUTE_INSTANCE_NON_MOVABLE: Used for compute instances that do not move during DR operations.

Migrate to one of the new instance types before the effective deprecation date.

Does this impact me? If you use the COMPUTE_INSTANCE member type in your DR configuration, this change affects you. Make sure that you migrate to one of the new instance types before the effective deprecation date.

What do I need to do? To migrate from an existing COMPUTE_INSTANCE to one of the new instance types, follow these instructions.

Functions

Fn Project CLI version 0.5.x (and earlier) no longer supported

Service Change: Fn Project CLI version 0.5.x (and earlier) will no longer be supported.

Date Announced: June 29, 2021

Date in Effect: August 1, 2021

Details: Starting August 1, 2021, Fn Project CLI version 0.5.x (and earlier) will no longer work with OCI Functions.

Does this impact me? If you are currently using Fn Project CLI version 0.5.x (or earlier), you will need to upgrade to Fn Project CLI version 0.6.x (or later).

What do I need to do? Upgrade to Fn Project CLI version 0.6.x (or later), by following the instructions in Upgrading the Fn Project CLI.

Fn Project FDK build-time and runtime base images built on Oracle Linux 8 (Alpine/Debian FDK base images deprecated)

Service Change: From December 15, 2021, the Fn Project Function Development Kits (FDKs) build-time and runtime base images, with the exception of the FDK for Python 3.7, are built on top of the Oracle Linux 8 slim distribution. The Alpine/Debian FDK base images are deprecated.

Date Announced: November 15, 2021

Date in Effect: December 15, 2021

Details: Starting December 15, 2021, most of the Fn Project Function Development Kits (FDKs) build-time and runtime base images for the different supported languages are built on top of the Oracle Linux 8 slim distribution (instead of the Alpine and Debian Linux distributions). New functions you deploy will use these Oracle Linux 8 FDK base images. The only exceptions are the FDK build-time and runtime base images for Python 3.7, which continue to be built on top of the Debian Linux distribution.

The Alpine/Debian Linux distributions and the Oracle Linux 8 slim distribution have different package managers. After the transition to the Oracle Linux 8 FDK base images, the temporary Dockerfile created by OCI Functions when deploying new functions contains Oracle Linux 8 package manager commands.

Does this impact me?

For existing functions already deployed to OCI Functions:

  • If OCI Functions uses the settings in a function's func.yaml file to create a temporary Dockerfile containing the instructions from which to build the function's Docker image, the function will build and deploy without errors. The temporary Dockerfile includes the correct Oracle Linux 8 package manager commands.
  • If you have created a custom Dockerfile for a function (for example, by modifying the Dockerfile that OCI Functions creates, and setting runtime: docker in the function's func.yaml file), the function might now build and deploy with errors such as missing apt-get .... The errors occur if the custom Dockerfile includes Alpine/Debian package manager commands.

What do I need to do? If you have created custom Dockerfiles that contain Alpine/Debian package manager commands, replace those commands with Oracle Linux 8 package manager commands.

If you cannot immediately start using the Oracle Linux 8 FDK base images because you have functions that still require the Alpine or Debian Linux distributions, there is a temporary workaround. Until December 15, 2022, the Alpine/Debian FDK base images remain available but with modified image tags. You can update custom Dockerfiles to use the deprecated Alpine/Debian FDK base images instead of the Oracle Linux 8 base images by explicitly specifying the modified image tags. See My functions still require the Alpine and Debian Linux distributions. Is there a temporary workaround?.

GoldenGate

Deprecated GoldenGate Database Registration APIs

Service change: Oracle Cloud Infrastructure's GoldenGate APIs for DatabaseRegistrations are deprecated as of November 01, 2022.

Date announced: November 01, 2022

Date in effect: November 01, 2023

Details: Starting November 01, 2022, DatabaseRegistrations APIs are deprecated and replaced by Connections APIs. From November 01, 2023, the deprecated APIs will be unavailable.

Does this impact me? Yes. DatabaseRegistrations APIs worked for Oracle Database connections, whereas the new, extensible Connections APIs let you connect to many other types of data technologies.

What do I need to do? Use the Connections APIs instead of the DatabaseRegistrations APIs to connect to the source and target technologies.

Deprecated timeUpgradeRequired Property

Service change: The timeUpgradeRequired property of the Deployment and DeploymentSummary APIs are deprecated as of March 14, 2023.

Date announced: March 14, 2023

Date in effect: March 14, 2024

Details: With the new Maintenance features rolled out on March 14 2023, the timeUpgradeRequired property of the Deployment and DeploymentSummary APIs are deprecated.

Does this impact me? The read-only timeUpgradeRequired property was used to help you determine how long you had to manually upgrade to a new deployment version, but the service didn't automatically upgrade your deployment when the deadline passed. The new Maintenance feature schedules one or more upgrades and automatically upgrades your deployment on the given date. You can find these dates on your deployment details page.

What do I need to do? You can adjust the scheduled upgrades as needed when you create the deployment, or from the deployment details page.

Deprecated adminPassword Property

Service change: The adminPassword property used in CreateOggDeploymentDetails and UpdateOggDeploymentDetails model objects of the CreateDeploymentDetails and UpdateDeploymentDetails APIs were deprecated as of August 15, 2023.

Date announced: August 15, 2023

Date in effect: August 15, 2024

Details: With the new single-sign on feature introduced on August 15, 2023, the adminPassword property used in CreateOggDeploymentDetails and UpdateOggDeploymentDetails model objects of the CreateDeploymentDetails and UpdateDeploymentDetails APIs are now deprecated.

Does this impact me? Yes.

What do I need to do? New deployments created from August 15, 2023, require you to select a Credential store (OCI Identity and Access Management (IAM) or GoldenGate) in tenancies where OCI IAM with Identity Domains is enabled. If you select OCI IAM, you can log in to the deployment console using your Oracle Cloud account, whereas GoldenGate requires you to create a Vault and add a secret in which to store your password, that you'll use to log in to the deployment console with.

Deprecated privateIP Property

Service change: The privateIp property of all CreateConnectionDetails model objects in the Connection APIs is deprecated as of December 5, 2023.

Date announced: December 5, 2023

Date in effect: December 5, 2024

Details: With the release of updated network options, the privateIp property of all CreateConnectionDetails model objects in the Connection APIs is deprecated as of December 5, 2023.

Does this impact me? You can continue to use your old connections. Any new connections you create December 5, 2023 and onward will use new Network connectivity settings that you select.

What do I need to do? When you create a new connection, you can provide either the host name or the IP address in the FQDN, host, connectionString property (related to your connection type). If you provide a host name, GoldenGate forwards the DNS resolution to your subnet. If you provide a privateIp, GoldenGate connects to it directly.

IAM

AuditEvents APIs and Reports APIs

Service Change: The Oracle Cloud Infrastructure Identity and Access Management Audit Events APIs and some reports templates for the Reports APIs, which you can use with IAM identity domains, will be deprecated.

Date Announced: May 15, 2023

Date in Effect: December 15, 2024

Details: Starting December 15, 2024, the IAM APIs for AuditEvents and certain reports templates in the Reports APIs no longer work with IAM.

Does this impact me? If you're currently using IAM APIs for AuditEvents, and the APIs for Reports which are based on AuditEvents, you will need to use the OCI Audit service APIs instead.

What do I need to do? You can now use OCI Audit APIs.

Deprecated AuditEvents APIs

The following IAM AuditEvents APIs are deprecated:

  • AuditEvents

Deprecated Reports APIs

The following IAM reports templates in the Reports APIs are deprecated:

  • User Login
  • System Log
  • Sync Failure
  • Suspicious Events
  • Notification Delivery
  • AppRole Assignment
  • Application Access

Java Management Service (JMS)

Custom log required for JMS Fleet creation

Service Change: Effective July 15, 2022, the CreateFleet API will require the custom log OCID in the inventoryLog property.

Date Announced: April 15, 2022

Date in Effect: July 15, 2022

Details: As of March 30, 2022, JMS uses the Oracle Cloud Infrastructure Logging service to store inventory and operation logs. Inventory logs are custom logs that store the Java Runtime inventory and usage related information reported from the hosts by the Management Agent. With this change, the CreateFleet API includes an additional property, inventoryLog, to specify the custom log to use.

What do I need to do? Existing fleets must be migrated using the UpdateFleet API by July 15, 2022. After July 15, 2022 the inventoryLog property of CreateFleet API will be a required parameter. See the CreateFleet and UpdateFleet operations for details. Agents need to be on 220302.1455 or later.

Language

Deprecated Language APIs

Starting October 26, 2022, the Detect Language APIs of version 20221001 were deprecated. From October 10, 2023, onwards the deprecated APIs will be unavailable.

Removed Language Classes

Starting October 26, 2022, the BatchDetect Language APIs have a new supported API version of 20221001. With the introduction of API version 20221001, the following classes have been removed and replaced with the common class, com.oracle.bmc.ailanguage.model.TextDocument.

Removed Class in Language Replacement Class
com.oracle.bmc.ailanguage.model.EntityDocument com.oracle.bmc.ailanguage.model.TextDocument
com.oracle.bmc.ailanguage.model.KeyPhraseDocument
com.oracle.bmc.ailanguage.model.SentimentsDocument
com.oracle.bmc.ailanguage.model.TextClassificationDocument

MySQL Heatwave

DB System Backup Retention Period Reduction

Service Change: The DB System backup retention period has been reduced from 10,000 to 365 days.

Date Announced: September 2020

Date in Effect: October 2020

Details: The DB System backup retention period has been reduced from 10,000 to 365 days.

Does this impact me? No.

What do I need to do? Nothing.

DB System Deletion Policy

Service Change: The default value of AutomaticBackupRetention is changed from DELETE to RETAIN.

Date Announced: January 2024

Date in Effect: January 2025

Details: Before this service change, the AutomaticBackupRetention attribute default value in DB System Deletion Policy was DELETE. With this change, the default value of AutomaticBackupRetention is changed to RETAIN. Note that this change doesn't impact the deletion policy of existing DB Systems. The change is solely applicable to DB Systems created after the date in effect.

Does this impact me? Yes, if you use defaults for deletion policy.

What do I need to do? If you prefer the default to be DELETE for AutomaticBackupRetention and are using SDK/CLI/Terraform without the value being set, you must set the preferred value explicitly.

Network Load Balancer

Deprecated Network Load Balancer APIs

The Oracle Cloud Infrastructure's Network Load Balancer ListNetworkLoadBalancerProtocol API is deprecated as of January 12, 2022. Support for ListNetworkLoadBalancerProtocol ends on March 1, 2023. See ListenerDetails for the current list of supported protocol values.

Search with OpenSearch

Permissions for Networking resources changing from service to user permissions

Service Change: The IAM permissions for Networking resources required to create and work with OpenSearch clusters are changing from service permissions to user permissions.

Date Announced: February 20, 2024

Date in Effect: March 20, 2024

Details: To create and manage clusters in Search with OpenSearch, you must create IAM policies for your tenancy that grants permissions to specific Networking resources. Currently, the required permissions are service permissions, with policy statements such as the following snippet:

Allow service opensearch to manage <Networking_Resource>...

Search with OpenSearch is transitioning to requiring user permissions to grant access to Networking resources instead of service permissions. During the transition period your tenancy needs to have both types of policies.

Does this impact me? All tenancies where users are creating and managing OpenSearch clusters need to have new policies that specify user permissions in addition to the existing policies with service permissions for access to the required Networking resources.

What do I need to do? To prepare for this transition, create a policy for Search with OpenSearch in your tenancy that grants the required user permissions to Networking resources. The following policy example includes these permissions:
Allow group SearchOpenSearchAdmins to manage vnics in compartment <NETWORK_RESOURCES_COMPARTMENT>
Allow group SearchOpenSearchAdmins to manage vcns in compartment <NETWORK_RESOURCES_COMPARTMENT>
Allow group SearchOpenSearchAdmins to use subnets in compartment <NETWORK_RESOURCES_COMPARTMENT>
Allow group SearchOpenSearchAdmins to use network-security-groups in compartment <NETWORK_RESOURCES_COMPARTMENT>
Allow group SearchOpenSearchAdmins to manage opensearch-family in compartment <CLUSTER_RESOURCES_COMPARTMENT> 

You need to keep any existing policies you have for Search with OpenSearch that include service permissions statements for Networking resources until the transition to user permissions statements has been completed. See Search with OpenSearch IAM Policies for documentation about the permissions required for Search with OpenSearch.

Service Mesh

Deprecated Service Mesh APIs

Service Change: Oracle Cloud Infrastructure's Service Mesh APIs of version 20210930 were deprecated on December 14, 2022.

Date Announced: December 14, 2022

Date in Effect: December 15, 2023

Details: Starting December 14, 2022, Service Mesh APIs of version 20210930 was deprecated. From December 15, 2023, onwards the deprecated APIs will be unavailable.

  • Update/Delete/Get/List Operations on any resources created by deprecated APIs will be supported by the new APIs (version 20220615).
  • OCI SDKs and command line tools that were released before December 14, 2022, are limited to the features of the deprecated resource model (version 20210930).

List of unsupported and replacement APIs

Unsupported API (version 20210930) Replacement API (version 20220615)
ChangeAccessPolicyCompartment ChangeAccessPolicyCompartment
CreateAccessPolicy CreateAccessPolicy
DeleteAccessPolicy DeleteAccessPolicy
GetAccessPolicy GetAccessPolicy
ListAccessPolicies ListAccessPolicies
UpdateAccessPolicy UpdateAccessPolicy
ChangeIngressGatewayCompartment ChangeIngressGatewayCompartment
CreateIngressGateway CreateIngressGateway
DeleteIngressGateway DeleteIngressGateway
GetIngressGateway GetIngressGateway
ListIngressGateways ListIngressGateways
UpdateIngressGateway UpdateIngressGateway
ChangeIngressGatewayRouteTableCompartment ChangeIngressGatewayRouteTableCompartment
CreateIngressGatewayRouteTable CreateIngressGatewayRouteTable
DeleteIngressGatewayRouteTable DeleteIngressGatewayRouteTable
GetIngressGatewayRouteTable GetIngressGatewayRouteTable
ListIngressGatewayRouteTables ListIngressGatewayRouteTables
UpdateIngressGatewayRouteTable UpdateIngressGatewayRouteTable
ChangeMeshCompartment ChangeMeshCompartment
CreateMesh CreateMesh
DeleteMesh DeleteMesh
GetMesh GetMesh
ListMeshes ListMeshes
UpdateMesh UpdateMesh
GetProxyDetails GetProxyDetails
ChangeMeshCompartment ChangeMeshCompartment
CreateVirtualDeployment CreateVirtualDeployment
DeleteVirtualDeployment DeleteVirtualDeployment
GetVirtualDeployment GetVirtualDeployment
ListVirtualDeployments ListVirtualDeployments
UpdateVirtualDeployment UpdateVirtualDeployment
ChangeVirtualServiceCompartment ChangeVirtualServiceCompartment
CreateVirtualService CreateVirtualService
DeleteVirtualService DeleteVirtualService
GetVirtualService GetVirtualService
ListVirtualServices ListVirtualServices
UpdateVirtualService UpdateVirtualService
ChangeVirtualServiceRouteTableCompartment ChangeVirtualServiceRouteTableCompartment
CreateVirtualServiceRouteTable CreateVirtualServiceRouteTable
DeleteVirtualServiceRouteTable DeleteVirtualServiceRouteTable
GetVirtualServiceRouteTable GetVirtualServiceRouteTable
ListVirtualServiceRouteTables ListVirtualServiceRouteTables
UpdateVirtualServiceRouteTable UpdateVirtualServiceRouteTable
GetWorkRequest GetWorkRequest
ListWorkRequestErrors ListWorkRequestErrors
ListWorkRequestLogs ListWorkRequestLogs
ListWorkRequests ListWorkRequests

Vision

Deprecated Vision APIs

Service Change: Oracle Cloud Infrastructure Vision's document analysis APIs were deprecated January 30, 2023. The document analysis functionality is now offered through the Oracle Cloud Infrastructure Document Understanding service.

Date Announced: January 30, 2023

Date in Effect: January 31, 2024

Details:

The following APIs were deprecated January 10, 2023:

  • AnalyzeDocument
  • CreateDocumentJob
  • GetDocumentJob
  • CancelDocumentJob

Any output data stored in an Object Storage bucket that resulted from previous Document Jobs will remain accessible after Document API deprecation. From January 31, 2024 onwards, the deprecated APIs will be unavailable in the Oracle Cloud Infrastructure Vision service.

Does this impact me? This change impacts customers using the document analysis functionality in the Oracle Cloud Infrastructure Vision service.

What do I need to do? Customers using the document analysis functionality in the Oracle Cloud Infrastructure Vision service should instead use the document analysis functionality offered through the Oracle Cloud Infrastructure Document Understanding service.