查询数据库磁盘类型
功能介绍
查询当前区域下的数据库磁盘类型。
调试
您可以在API Explorer中调试该接口。
URI
|
名称 |
是否必选 |
类型 |
IN |
描述 |
|---|---|---|---|---|
|
project_id |
是 |
string |
path |
参数解释： 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
|
名称 |
是否必选 |
类型 |
IN |
描述 |
|---|---|---|---|---|
|
engine_name |
否 |
string |
query |
参数解释： 数据库版本类型。获取方法请参见查询数据库版本信息。 约束限制： 取值为“DDS-Community”。 取值范围： 不涉及。 默认取值： 不涉及。 |
请求参数
|
名称 |
是否必选 |
类型 |
IN |
描述 |
|---|---|---|---|---|
|
x-auth-token |
是 |
string |
header |
参数解释： 从IAM服务获取的用户Token。请参考认证鉴权。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
响应参数
|
名称 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
storage_type |
是 |
Array of objects |
参数解释： 数据库磁盘信息列表。详情请参见表5。 取值范围： 不涉及。 |
|
dss_pool_info |
是 |
Array of objects |
参数解释： 实例专属存储规格信息列表。详情请参见表6。
说明：
仅支持Dec用户查询。 取值范围： 不涉及。 |
|
名称 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
是 |
String |
参数解释： 磁盘类型名称。 取值范围：
|
|
az_status |
是 |
Map<String,String> |
参数解释： 其中key是可用区编号，value是规格所在az的状态。 取值范围：
|
|
名称 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
az_name |
是 |
String |
参数解释： 专属存储池所在az。 取值范围： 不涉及。 |
|
free_capacity_gb |
是 |
String |
参数解释： 专属存储可用容量。单位：GB。 取值范围： 不涉及。 |
|
dss_pool_volume_type |
是 |
String |
参数解释： 专属存储磁盘类型。 取值范围： 不涉及。 |
|
dss_pool_id |
是 |
String |
参数解释： 专属存储ID。 取值范围： 不涉及。 |
|
dss_pool_status |
是 |
String |
参数解释： 专属存储池当前状态。 取值范围：
|
响应示例中“az_status”字段下可用区的值为示例值。
请求示例
GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/storage-type
响应示例
{
"storage_type": [
{
"name": "ULTRAHIGH",
"az_status": {
"az1": "normal",
"az2": "normal"
}
}
],
"dss_pool_info": [
{
"az_name": "az1xahz",
"free_capacity_gb": 150,
"dss_pool_volume_type": "ULTRAHIGH",
"dss_pool_id": "f5f84ed7-6f19-4bd4-99d7-b450ad6cc4df",
"dss_pool_status": "available"
}
]
}
- Dec用户查询响应示例
{ "storage_type": [ { "name": "ULTRAHIGH", "az_status": { "cn-north-1a": "normal", "cn-north-1b": "normal", "cn-north-1c": "unsupported" } } ], "dss_pool_info": [ { "az_name": "cn-north-1a", "free_capacity_gb": "8656", "dss_pool_volume_type": "ULTRAHIGH", "dss_pool_id": "f5f84ed7-6f19-4bd4-99d7-b450ad6cc4dd", "dss_pool_status": "available" } ] }
SDK
单击文档数据库服务 DDS SDK，下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
状态码
详情请参见状态码。
错误码
详情请参见错误码。
