# 查询数据库磁盘类型 - QueryingtheDiskTypeofaDBInstance #### 功能介绍 查询数据库引擎的磁盘类型。 - 调用接口前，您需要了解API [认证鉴权](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_011.html)。 - 调用接口前，您需要提前获取到[地区和终端节点](https://developer.huaweicloud.com/endpoint)。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=GaussDBforopenGauss&api=ListStorageTypes)中调试该接口。 #### URI GET /v3/{project_id}/storage-type 表1参数说明 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 租户在某一Region下的项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_196.html)。 **约束限制：** 不涉及。 **取值范围：** 只能由英文字母、数字组成，且长度为32个字符。 **默认取值**： 不涉及。 | | version | 是 | String | **参数解释：** 数据库版本号。可通过[查询数据库引擎的版本](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_083.html)查询。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值** **：** 不涉及。 | | ha_mode | 否 | String | **参数解释：** 实例类型。 **约束限制：** 不区分大小写。 **取值范围：** - **enterprise**(分布式版) - **centralization_standard**(集中式版) **默认取值** **：** 不涉及。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取。 请求响应成功后在响应消息头中包含的"X-Subject-Token"的值即为Token值。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值** **：** 不涉及。 | | X-Language | 否 | String | **参数解释：** 指定接口返回信息的语言类型。 **约束限制：** 不涉及。 **取值范围：** - **zh-cn**：中文 - **en-us**：英文 **默认取值** **：** **en-us** | #### 响应参数 表3响应参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | storage_type | Array of objects | **参数解释：** 实例磁盘类型信息。 详情请参见[表4]。 | 表4storage_type字段数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | **参数解释：** 磁盘类型名称。 **取值范围：** - ULTRAHIGH，表示SSD。 - ESSD，表示极速云盘。 | | az_status | map\ | **参数解释：** 其中key是可用区编号，value是规格所在AZ的状态。 - normal，在售。 - unsupported，暂不支持该规格。 - sellout，售罄。 | | support_compute_group_type | List\ | **参数解释：** 磁盘类型所支持的计算资源规格类型。 - normal：独享型（1:8）。 - normal2：独享型（1:4）。 - armFlavors：鲲鹏独享型（1:8）。 - armFlavors2：鲲鹏独享型（1:4）。 - armFlavors2Shared：鲲鹏通用计算增强II型（共享型）。 - general：通用型（1:4）。 - exclusive：独享型（1:4）。仅基础版集中式实例支持。 - armExclusive：鲲鹏独享型（1:4）。仅基础版集中式实例支持。 - economical：惠选型（1:4）。 - economical2：惠选型（1:8）。 | #### 请求示例 - 查询分布式版数据库磁盘类型 ``` GET https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3/054b61972980d4552f0bc00ac8d3f5cd/storage-type?version=3.208&ha_mode=enterprise ``` - 查询集中式版数据库磁盘类型 ``` GET https://gaussdb-opengauss.cn-north-4.myhuaweicloud.com/v3/054b61972980d4552f0bc00ac8d3f5cd/storage-type?version=3.208&ha_mode=centralization_standard ``` #### 响应示例 查询数据库磁盘类型列表成功。 ``` { "storage_type": [ { "name": "ULTRAHIGH", "az_status": { "aaa": "normal", "bbb": "normal", "ccc": "normal" }, "support_compute_group_type": [ "normal", "armFlavors", "armFlavors2Shared", "normal2" ] }, { "name": "ESSD", "az_status": { "az2xahz": "normal", "az1xahz": "normal", "az3xahz": "normal" }, "support_compute_group_type": [ "normal", "armFlavors", "armFlavors2Shared", "normal2" ] } ] } ``` #### 状态码 - 正常 200 - 异常 请参见[状态码](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_194.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-gaussdb/gaussdb_api_195.html)。