doc-exports/docs/dws/api-ref/dws_02_0022.html

Querying the Supported Node Types

Function

This API is used to query the node types supported by GaussDB(DWS).

URI

• URI format

  GET /v2/{project_id}/node-types

  Table 1 URI parameters

  Parameter	Mandatory	Type	Description
  project_id	Yes	String	Project ID. For details about how to obtain the ID, see Obtaining a Project ID.

Request Message

• Request example

  GET https://{Endpoint}/v2/89cd04f168b84af6be287f71730fdb4b/node-types

Response Message

• Example response

  {
    "node_types" : [ {
      "spec_name" : "dws.d2.xlarge",
      "id" : "ebe532d6-665f-40e6-a4d4-3c51545b6a67",
      "datastore_type" : "dws",
      "available_zones" : [ {
        "code" : "az1",
        "status" : "normal"
      } ],
      "ram" : 32,
      "vcpus" : 4,
      "datastores" : [ {
        "version" : "8.1.3.200",
        "attachments" : {
          "min_cn" : 2,
          "max_cn" : 20
        }
      } ],
      "volume" : {
        "type" : "SSD",
        "size" : 160
      },
      "elastic_volume_specs" : [ {
        "type" : "SSD",
        "step" : 100,
        "min_size" : 100,
        "max_size" : 32000
      } ],
      "detail" : [ {
        "type" : "vCPU",
        "value" : "4"
      }, {
        "value" : "1675",
        "type" : "LOCAL_DISK",
        "unit" : "GB"
      }, {
        "type" : "mem",
        "value" : "32",
        "unit" : "GB"
      } ]
    } ],
    "count" : 1
  }

• Parameter description

  Table 2 Response parameter description

  Parameter	Type	Description
  node_types	Array of NodeTypes objects	List of node type objects
  count	Integer	Total number of node types.

  Table 3 NodeTypes

  Parameter	Type	Description
  spec_name	String	Name of a node type
  detail	Array of Detail objects	Node type details
  id	String	Node type ID
  datastore_type	String	Product type dws: standard data warehouse. hybrid: hybrid data warehouse. stream: stream data warehouse.
  available_zones	Array of NodeTypeAvailableZones objects	Supported AZs and their statuses
  ram	Integer	Memory size
  vcpus	Integer	Number of CPUs
  datastores	Array of NodeTypeDatastores objects	Kernel version information
  volume	VolumeResp object	For a fixed storage flavor, the value is the storage of its typical configuration. For an elastic storage flavor, the value null.
  elastic_volume_specs	Array of NodeTypeElasticVolumeSpecs objects	If the specification is elastic, this attribute indicates the typical specification, including the storage type, minimum capacity, maximum capacity, and step. If the specification is fixed, this attribute is null.

  Table 4 Detail

  Parameter	Type	Description
  type	String	Attribute type
  value	String	Attribute value
  unit	String	Attribute unit

  Table 5 NodeTypeAvailableZones

  Parameter	Type	Description
  code	String	AZ ID
  status	String	Availability status of a node type. normal: The node type is available. sellout: The VM has been sold out. abandon: The node type is unavailable.

  Table 6 NodeTypeDatastores

  Parameter	Type	Description
  version	String	OS kernel version
  attachments	Attachments object	Additional information about the kernel version

  Table 7 attachments

  Parameter	Type	Description
  min_cn	String	Minimum CNs allowed by the kernel version
  max_cn	String	Maximum CNs allowed by the kernel version

  Table 8 VolumeResp

  Parameter	Type	Description
  type	String	Disk type. Only SSD is supported.
  size	Integer	Available disk capacity (GB)

  Table 9 NodeTypeElasticVolumeSpecs

  Parameter	Type	Description
  type	String	Cloud disk type.
  step	String	Cloud disk size increment
  min_size	Integer	Minimum cloud disk size
  max_size	Integer	Maximum cloud disk size

Status Code

• Normal

  200

• Exception

  Table 10 Returned values

  Returned Value	Description
  400 Bad Request	Request error.
  401 Unauthorized	Authorization failed.
  403 Forbidden	No operation permission.
  404 Not Found	No resources found.
  500 Internal Server Error	Internal service error.
  503 Service Unavailable	The service is unavailable.

Parent topic: Cluster Management APIs