Get API Versions for Profitability and Cost Management REST APIs

Returns information about which versions are available and supported. Multiple versions might be supported simultaneously.

Note:

An API version is always supported even when deprecated.

Required Roles

Service Administrator, Power User, User, Viewer

REST Resource

GET /epm/rest/

Request

Supported Media Types: application/json

Response

Supported Media Types: application/json

Parameters

The following table summarizes the parameters.

Table 24-2 Parameters

Name	Description
details	In case of errors, details are published with the error string
status	See Migration Status Codes
items	Version of the API you are developing with
version	The version, such as v1
lifecycle	Possible values: active, deprecated
isLatest	Whether this resource is the latest, true or false

Example of Response Body

The following shows an example of the response body in JSON format.

{
    "items": [{
        "isLatest": false,
        "lifecycle": "deprecated",
        "version": "11.1.2.4.000",
        "links": [{
            "href": "https://<SERVICE_NAME>-<TENANT_NAME>.<SERVICE_TYPE>.<dcX>.oraclecloud.com/epm/rest/11.1.2.4.000",
            "rel": "canonical"
        }, {
            "href": "https://<SERVICE_NAME>-<TENANT_NAME>.<SERVICE_TYPE>.<dcX>.oraclecloud.com/epm/rest/v1",
            "rel": "successor-version"
        }]
    }, {
        "isLatest": true,
        "lifecycle": "active",
        "version": "v1",
        "links": [{
            "href": "https://<SERVICE_NAME>-<TENANT_NAME>.<SERVICE_TYPE>.<dcX>.oraclecloud.com/epm/rest/v1",
            "rel": "canonical"
        }, {
            "href": "https://<SERVICE_NAME>-<TENANT_NAME>.<SERVICE_TYPE>.<dcX>.oraclecloud.com/epm/rest/11.1.2.4.000",
            "rel": "predecessor-version"
        }]
    }],
    "links": [{
        "href": "https://<SERVICE_NAME>-<TENANT_NAME>.<SERVICE_TYPE>.<dcX>.oraclecloud.com/epm/rest/11.1.2.4.000",
        "rel": "canonical"
    }, {
        "href": "https://<SERVICE_NAME>-<TENANT_NAME>.<SERVICE_TYPE>.<dcX>.oraclecloud.com/epm/rest/v1",
        "rel": "current"
    }]
}