rds.server-types.list

List available database instance classes

GET /rds/api/server-typesIAM rds:DescribeDBInstancesRead

Request syntax

GET /rds/api/server-types

Response

200 with the machine types, cheapest first: id, description, vcpu, memoryGib, diskGib, cpuType, priceEuroCentsHourly, priceEuroCentsMonthly, clusterCapable, inStock and zones (stock per zone).

A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.

Fields of data

  • [].​idAlways

    string

    Instance type name, e.g. performance-2
  • [].​descriptionAlways

    string

    What the type is
  • [].​vcpuAlways

    number

    vCPUs
  • [].​memoryGibAlways

    number

    Memory, GiB
  • [].​diskGibAlways

    number

    The machine's own disk, GiB (the data volume is separate)
  • [].​cpuTypeAlways

    one of shared, dedicated

    Shared or dedicated vCPUs
  • [].​priceEuroCentsHourlyAlways

    number

    Price per node per hour, euro cents
  • [].​priceEuroCentsMonthlyAlways

    number

    Price per node per month, euro cents
  • [].​clusterCapableAlways

    boolean

    Has the 8 GiB of memory or more a cluster node needs
  • [].​inStockAlways

    boolean, may be null

    Purchasable in the region's default zone now; null: not checked
  • [].​zonesWhen present

    array of object

    Stock per zone; absent when not checked
  • [].​zones[].​zoneIdAlways

    string

    Zone, e.g. de1a
  • [].​zones[].​inStockAlways

    boolean, may be null

    Purchasable there now; null: not known
  • [].​zones[].​changedAtAlways

    string, may be null

    When the stock last changed there

Checked against the handlers: every route test validates their answers against this schema.

Errors

  • 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
  • 401No credentials, or an access key that is unknown, revoked or expired.
  • 403The caller's policies do not allow rds:DescribeDBInstances on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
  • 404The resource does not exist in your organization.

Examples

The required parameters only, with example values. Replace id and the other placeholders with your own.

dcloud rds server-types list

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_rds_server-types_list.