You can call this operation to query the specifications such as CPU and memory of an instance type.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeInstanceType

The operation that you want to perform. Set the value to DescribeInstanceType.

InstanceType String Yes cassandra.c.2xlarge

Examples of valid values:

  • cassandra.c.large: 2 cores, 4 GB
  • cassandra.c.xlarge: 4 cores, 8 GB
  • cassandra.c.2xlarge: 8 cores, 16 GB

If this parameter is not specified, the list of all instance types is returned.

Response parameters

Parameter Type Example Description
InstanceTypeSpecList Array

The list of instance types.

InstanceTypeSpec
CpuSize Long 4

The number of vCPUs.

InstanceType String cassandra.c.large

The instance type. Examples of valid values:

  • cassandra.c.large: 2 cores, 4 GB
  • cassandra.c.xlarge: 4 cores, 8 GB
  • cassandra.c.2xlarge: 8 cores, 16 GB
MemSize Long 8

The memory size. Unit: GB.

RequestId String 4B989A12-FB9A-4D9A-A824-2E9267C911C7

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/? Action=DescribeInstanceType
&InstanceType=cassandra.c5.xlarge
&<Common request parameters>

Sample success responses

XML format

<DescribeInstanceTypeResponse>
  <RequestId>4B989A12-FB9A-4D9A-A824-2E9267C911C7</RequestId>
  <InstanceTypeSpecList>
        <InstanceTypeSpec>
              <CpuSize>4</CpuSize>
              <MemSize>16</MemSize>
              <InstanceType>cassandra.c.large</InstanceType>
        </InstanceTypeSpec>
        <InstanceTypeSpec>
              <CpuSize>4</CpuSize>
              <MemSize>32</MemSize>
              <InstanceType>cassandra.c.large</InstanceType>
        </InstanceTypeSpec>
        <InstanceTypeSpec>
              <CpuSize>4</CpuSize>
              <MemSize>8</MemSize>
              <InstanceType>cassandra.c.large</InstanceType>
        </InstanceTypeSpec>
        <InstanceTypeSpec>
              <CpuSize>8</CpuSize>
              <MemSize>16</MemSize>
              <InstanceType>cassandra.c.2xlarge</InstanceType>
        </InstanceTypeSpec>
        <InstanceTypeSpec>
              <CpuSize>8</CpuSize>
              <MemSize>32</MemSize>
              <InstanceType>cassandra.c.2xlarge</InstanceType>
        </InstanceTypeSpec>
        <InstanceTypeSpec>
              <CpuSize>8</CpuSize>
              <MemSize>32</MemSize>
              <InstanceType>cassandra.c.2xlarge</InstanceType>
        </InstanceTypeSpec>
        <InstanceTypeSpec>
              <CpuSize>2</CpuSize>
              <MemSize>4</MemSize>
              <InstanceType>cassandra.c.large</InstanceType>
        </InstanceTypeSpec>
        <InstanceTypeSpec>
              <CpuSize>2</CpuSize>
              <MemSize>8</MemSize>
              <InstanceType>cassandra.c.large</InstanceType>
        </InstanceTypeSpec>
        <InstanceTypeSpec>
              <CpuSize>4</CpuSize>
              <MemSize>8</MemSize>
              <InstanceType>cassandra.c.xlarge</InstanceType>
        </InstanceTypeSpec>
  </InstanceTypeSpecList>
</DescribeInstanceTypeResponse>

JSON format

{
  "RequestId": "4B989A12-FB9A-4D9A-A824-2E9267C911C7",
  "InstanceTypeSpecList": {
    "InstanceTypeSpec": [
      {
        "CpuSize": 4,
        "MemSize": 16,
        "InstanceType": "cassandra.c.large"
      },
      {
        "CpuSize": 4,
        "MemSize": 32,
        "InstanceType": "cassandra.c.large"
      },
      {
        "CpuSize": 4,
        "MemSize": 8,
        "InstanceType": "cassandra.c.large"
      },
      {
        "CpuSize": 8,
        "MemSize": 16,
        "InstanceType": "cassandra.c.2xlarge"
      },
      {
        "CpuSize": 8,
        "MemSize": 32,
        "InstanceType": "cassandra.c.2xlarge"
      },
      {
        "CpuSize": 8,
        "MemSize": 32,
        "InstanceType": "cassandra.c.2xlarge"
      },
      {
        "CpuSize": 2,
        "MemSize": 4,
        "InstanceType": "cassandra.c.large"
      },
      {
        "CpuSize": 2,
        "MemSize": 8,
        "InstanceType": "cassandra.c.large"
      },
      {
        "CpuSize": 4,
        "MemSize": 8,
        "InstanceType": "cassandra.c.xlarge"
      }
    ]
  }
}

Error codes

For a list of error codes, visit the API Error Center.