Querying Supported Versions

Function

This API is used to query the versions supported by CDM clusters.

Calling Method

For details, see Calling APIs.

URI

GET /v1.1/{project_id}/datastores

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain the project ID, see Project ID and Account ID.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. This parameter is mandatory when token authentication is used. You can obtain it from the value of X-Subject-Token in the response message header returned by the "Obtaining a User Token" API of the IAM service.

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
datastores	Array of CdmClusterDatastore objects	Specifies the database list.

**Table 4** CdmClusterDatastore
Parameter	Type	Description
id	String	Service ID, which is used to differentiate services.
name	String	Service name
bigclusterEnable	Boolean	Specifies whether large-scale clusters are supported.
defaultVersion	String	Default version.
versions	Array of CdmClusterVersion objects	Indicates the version.

**Table 5** CdmClusterVersion
Parameter	Type	Description
active	String	Version status.
id	String	Version ID.
image	String	Version image.
name	String	Version name.
packages	String	Version package.
datastore	String	Service ID, which is used to differentiate services.
links	Array of ClusterLinks objects	URL information.

**Table 6** ClusterLinks
Parameter	Type	Description
rel	String	Relationship
href	String	Link address

Example Requests

GET /v1.1/1551c7f6c808414d8e9f3c514a170f2e/datastores

Example Responses

Status code: 200

The request is successful.

[ {
  "id" : "736270b9-27c7-4f03-823b-447d8245e1c2",
  "name" : "cdm",
  "bigclusterEnable" : false,
  "defaultVersion" : "2.9.3.300",
  "links" : null,
  "versions" : [ {
    "active" : "1",
    "id" : "e8a8b8cc-63f8-4fb5-8d4a-24c502317b11",
    "image" : null,
    "links" : [ {
      "rel" : "self",
      "href" : "https://10.63.25.93:443/rds/v1.0/datastores/736270b9-27c7-4f03-823b-447d8245e1c2"
    }, {
      "rel" : "bookmark",
      "href" : "https://10.63.25.93:443/datastores/736270b9-27c7-4f03-823b-447d8245e1c2"
    } ],
    "name" : "2.9.3.300",
    "packages" : "cdm",
    "datastore" : "736270b9-27c7-4f03-823b-447d8245e1c2"
  } ]
} ]

Status Codes

Status Code	Description
200	The request is successful.
400	Request error.
401	Authentication failed.
403	No operation permission.
404	No resources found.
500	Internal service error. For details about the returned error code, see Error Codes.
503	Service unavailable.