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	Explanation Project ID. For details about how to obtain the project ID, see Obtaining a Project ID. Constraints N/A Value range The value must consist of 1 to 64 characters. Only letters and digits are allowed. Default value N/A
version_name	Yes	String	Explanation Cluster version, 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. Constraints N/A Value range The value can contain 1 to 64 characters. Default value N/A

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameter
Parameter	Type	Description
version_name	String	Explanation Version name. Constraints N/A Value range N/A Default value N/A
available_flavors	Array of AzFlavors objects	Explanation Flavors supported by different AZs. For details, see Table 3. Constraints N/A Value range N/A Default value N/A

**Table 3** AzFlavors
Parameter	Type	Description
az_code	String	Explanation AZ code. Constraints N/A Value range N/A Default value N/A
az_name	String	Explanation AZ name Constraints N/A Value range N/A Default value N/A
master	Array of Flavor objects	Explanation Specifications supported by the master node. For details, see Table 4. Constraints N/A Value range N/A Default value N/A
core	Array of Flavor objects	Explanation Specifications supported by the core node. For details, see Table 4. Constraints N/A Value range N/A Default value N/A
task	Array of Flavor objects	Explanation Specifications supported by the task node. For details, see Table 4. Constraints N/A Value range N/A Default value N/A

**Table 4** Flavor
Parameter	Type	Description
flavor_name	String	Explanation Flavor name. Constraints N/A Value range N/A Default value N/A

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"
    } ]
  } ]
}