Obtaining Specified DB Instance Specifications

Function

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

URI

• URI format

  PATH: /v1.0/{project_id}/flavors/{flavorId}

  Method: GET

• Parameter description

  Table 1 Parameter description

  Name	Mandatory	Description
  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

None

Normal Response

• Parameter description

  Table 2 Parameter description

  Name	Type	Description
  ram	Int	Indicates the memory specifications in GB.
  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 name, such a cpu or mem.
  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 in GB.
  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.

last updated: 2024-12-10 15:16 UTC - commit: 148bbcaa587d5f60ca229a738ab0fb7c0ed09ff7