Deprecation Notice for Service Instances
Review the following notice about about resource paths and endpoints to use for creating and managing service instances, and the resource paths and endpoints that are deprecated.
The URL structure to use for accessing a REST resource is https://rest_server/resource_path
, where rest_server
is the REST server to contact for your identity domain or Cloud Account, and resource_path
is the relative path that defines the REST endpoint.
What Resource Paths and Endpoints Were Changed
The resource paths and endpoints for creating and managing service instances (including scaling and working with Coherence data tiers) were changed in the:
-
October 2017 release of Oracle Java Cloud Service (17.4.1) on Oracle Cloud Infrastructure Classic
-
December 2017 release of Oracle Java Cloud Service (17.4.1) on Oracle Cloud at Customer
What Resource Paths and Endpoints to Use Now
The following resource paths and endpoints are now available on all Oracle Cloud deployments, namely, Oracle Cloud Infrastructure, Oracle Cloud Infrastructure Classic, and Oracle Cloud at Customer. They can be used for creating and managing new service instances, including scaling and working with Coherence data tiers.
They can also be used for managing service instances on Oracle Cloud Infrastructure Classic that were provisioned before the October 2017 release of Oracle Java Cloud Service (17.4.1). On Oracle Cloud at Customer, they can also be used for managing service instances that were provisioned before the December 2017 release of Oracle Java Cloud Service (17.4.1).
Endpoints | Resource Paths |
---|---|
These are paths for creating, listing, and managing service instances. |
|
Create a service instance |
Method: Path: |
List all service instances in an identity domain |
Method: Path: |
List a service instance |
Method: Path: |
Stop, start, and restart a service instance and individual VMs |
Method: Path: Path: Path: |
Delete a service instance |
Method: Path: |
The following request parameter for deleting a service instance isdeprecated:
The replacement parameter is |
|
Scale out a service instance |
Method: Path: |
Scale in a service instance |
Method: Path: |
Scale up or scale down a service instance |
Method: Path: |
Add a local load balancer (OTD) to a service instance |
Method: Path: |
Add block storage to an existing or new volume |
Method: Path: |
Get healthcheck data and metrics for a service instance |
Method: Path: |
List tags for a service instance |
Method: Path: |
What Resource Paths and Endpoints are Deprecated
The following old resource paths and endpoints (which are not available on Oracle Cloud Infrastructure) are deprecated.
Endpoints | Resource Paths |
---|---|
Create, list, control lifecycle state, and delete a service instance |
|
Add and scale a Coherence data tier using a capacity or scaling unit Delete a Coherence data tier cluster |
|
List managed servers and server operations on a service instance |
|
Scale out and scale in a service instance Scale nodes on a service instance |
|
Note:
-
Although deprecated resource paths and endpoints may continue to be supported for the near term, they will become obsolete in the future. End of deprecation dates will be announced.
-
The deprecated resource path and endpoint for creating new Oracle Java Cloud Service instances will become obsolete in Release 18.4.2. This means starting from 18.4.2, you will no longer be able to use
/paas/service/jcs/api/v1.1/instances/{identityDomainId}
to create a new service instance. -
It is recommended that you migrate your applications to use the new paths and endpoints at your earliest convenience. This will minimize any disruption in the future when the deprecated URL structures are no longer supported.