• Relational Database Service

rds
  1. Help Center
  2. Relational Database Service
  3. API Reference
  4. OpenStack trove API v1.0
  5. DB Instance Management
  6. Obtaining Specified DB Instance Specifications

Obtaining Specified DB Instance Specifications

Function

This API is used to obtain DB instance specifications of a specified specification ID.

URI

  • URI format

    PATH: /{versionId}/{project_id}/flavors/{flavorId}

    Method: GET

  • Parameter description
    Table 1 Parameter description

    Name

    Mandatory

    Description

    versionId

    Yes

    Specifies the API version. It is case-sensitive and the value is v1.0.

    project_id

    Yes

    Specifies the project ID of a tenant in a region.

    flavorId

    Yes

    Specifies the specification ID.

    When this parameter is empty, the URLs of all DB instance specifications are obtained. For details, see str_id in flavors in section Obtaining All DB Instance Specifications.

  • Restrictions

    Currently, only the DB engines MySQL and PostgreSQL are supported by the API.

Request

N/A

Normal Response

  • Parameter description
    Table 2 Parameter description

    Name

    Type

    Description

    ram

    Int

    Indicates the memory specifications.

    id

    Int

    Indicates the specification ID (Int type). Its default value is 1 because RDS uses UUID to store the specification ID and cannot convert it to the Int type.

    links

    List data structure

    Indicates the link address.

    name

    String

    Indicates the specification item name.

    str_id

    String

    Indicates the specification ID.

    flavor_detail

    List data structure. For details, see Table 4.

    Indicates the specification information.

    price_detail

    List data structure. For details, see Table 5.

    Indicates the price information.

    flavor

    Dictionary data structure. For details, see Table 6.

    Indicates the embedded specification information.

    Table 3 links field data structure description

    Name

    Type

    Description

    rel

    String

    Indicates the link property.

    href

    String

    Indicates the API link. Its value is "".

    Table 4 flavor_detail field data structure description

    Name

    Type

    Description

    name

    String

    Indicates the specification item name. Its value is cpu, mem, or flavor. Currently, the value flavor has no meanings.

    value

    String

    Indicates the specification item value.

    Table 5 price_detail field data structure description

    Name

    Type

    Description

    timeUnit

    Int

    Indicates the pricing unit.

    price

    Float

    Indicates the unit price.

    Table 6 flavor field data structure description

    Name

    Type

    Description

    ram

    Int

    Indicates the memory specifications.

    id

    Int

    Indicates the specification ID (Int type). Its default value is 1 because RDS uses UUID to store the specification ID and cannot convert it to the Int type.

    links

    List data structure. For details, see Table 3.

    Indicates the link address.

    name

    String

    Indicates the specification item name.

    str_id

    String

    Indicates the specification ID.

  • Response example
    {
        "ram": 2,
        "id": 1,
        "links": null,
        "name": "rds.pg.c2.medium",
        "str_id": "9ff2a3a5-c859-bbc0-67f7-86ce59432b1d",
        "flavor_detail": [
          {
            "name": "cpu",
            "value": "1"
          },
          {
            "name": "mem",
            "value": "2"
          },
          {
            "name": "flavor",
            "value": "normal1"
          },
          {
            "name": "dbType",
            "value": "MySQL"
          },
          {
            "name": "serverType",
            "value": "XEN"
          }
        ],
        "price_detail": [],
        "flavor": {
          "ram": 2048,
          "id": 1,
          "links": [
            {
              "rel": "self",
              "href": ""
            },
            {
              "rel": "bookmark",
              "href": ""
            }
          ],
          "name": "rds.pg.c2.medium",
          "str_id": "9ff2a3a5-c859-bbc0-67f7-86ce59432b1d"
        }
    }

Abnormal Response

For details, see Abnormal Request Results.