Querying Available Specifications of an MRS Cluster Version

Function

This API is used to query available specifications of an MRS cluster version.

Debugging

You can debug this API in API Explorer. Automatic authentication is supported. API Explorer can automatically generate sample SDK code and support sample SDK code debugging.

URI

GET /v2/{project_id}/metadata/version/{version_name}/available-flavor

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.
version_name	Yes	String	MRS cluster version. You can query only one version at a time, for example, MRS 3.1.0. If the request client does not support automatic escape, escape the space to %20, for example, MRS %203.1.0.

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameter
Parameter	Type	Description
version_name	String	Version Name
available_flavors	Array of AzFlavors objects	Flavors supported by different AZs. For details, see Table 3.

**Table 3** AzFlavors
Parameter	Type	Description
az_code	String	AZ code
az_name	String	AZ name
master	Array of Flavor objects	Specifications supported by the master node. For details, see Table 4.
core	Array of Flavor objects	Specifications supported by the core node. For details, see Table 4.
task	Array of Flavor objects	Specifications supported by the task node. For details, see Table 4.

**Table 4** Flavor
Parameter	Type	Description
flavor_name	String	Specification name

Example Request

Obtain details about MRS 3.1.0 metadata.

/v2/f77c10d14a544393a24e5f0bf53202b6/metadata/version/MRS%203.1.0/available-flavor

Example Response

Status code: 200

Available specifications of the current version

{
  "version_name" : "MRS 3.1.0",
  "available_flavors" : [ {
    "az_code" : "cn-north-7a",
    "az_name" : "AZ 1",
    "master" : [ {
      "flavor_name" : "Si3.4xlarge.4"
    }, {
      "flavor_name" : "m3.8xlarge.8"
    }, {
      "flavor_name" : "c6.xlarge.4"
    }, {
      "flavor_name" : "m6.xlarge.8"
    } ],
    "core" : [ {
      "flavor_name" : "Si3.4xlarge.4"
    }, {
      "flavor_name" : "m3.8xlarge.8"
    }, {
      "flavor_name" : "c6.xlarge.4"
    }, {
      "flavor_name" : "m6.xlarge.8"
    } ],
    "task" : [ {
      "flavor_name" : "Si3.4xlarge.4"
    }, {
      "flavor_name" : "m3.8xlarge.8"
    }, {
      "flavor_name" : "c6.xlarge.4"
    }, {
      "flavor_name" : "m6.xlarge.8"
    } ]
  }, {
    "az_code" : "cn-north-7b",
    "az_name" : "AZ 2",
    "master" : [ {
      "flavor_name" : "Si3.4xlarge.4"
    }, {
      "flavor_name" : "m3.8xlarge.8"
    }, {
      "flavor_name" : "c6.xlarge.4"
    }, {
      "flavor_name" : "m6.xlarge.8"
    } ],
    "core" : [ {
      "flavor_name" : "Si3.4xlarge.4"
    }, {
      "flavor_name" : "m3.8xlarge.8"
    }, {
      "flavor_name" : "c6.xlarge.4"
    }, {
      "flavor_name" : "m6.xlarge.8"
    } ],
    "task" : [ {
      "flavor_name" : "Si3.4xlarge.4"
    }, {
      "flavor_name" : "m3.8xlarge.8"
    }, {
      "flavor_name" : "c6.xlarge.4"
    }, {
      "flavor_name" : "m6.xlarge.8"
    } ]
  }, {
    "az_code" : "cn-north-7c",
    "az_name" : "AZ 3",
    "master" : [ {
      "flavor_name" : "Si3.4xlarge.4"
    }, {
      "flavor_name" : "m3.8xlarge.8"
    }, {
      "flavor_name" : "c6.xlarge.4"
    }, {
      "flavor_name" : "m6.xlarge.8"
    } ],
    "core" : [ {
      "flavor_name" : "Si3.4xlarge.4"
    }, {
      "flavor_name" : "m3.8xlarge.8"
    }, {
      "flavor_name" : "c6.xlarge.4"
    }, {
      "flavor_name" : "m6.xlarge.8"
    } ],
    "task" : [ {
      "flavor_name" : "Si3.4xlarge.4"
    }, {
      "flavor_name" : "m3.8xlarge.8"
    }, {
      "flavor_name" : "c6.xlarge.4"
    }, {
      "flavor_name" : "m6.xlarge.8"
    } ]
  } ]
}