获取磁盘空间使用量 - ShowStorageUsedSpace

功能介绍

获取单个实例的磁盘空间使用量。

• 调用接口前，您需要了解API认证鉴权。
• 调用接口前，您需要了解请求Header参数说明。

调试

您可以在API Explorer中调试该接口。

接口约束

该接口仅支持MySQL、SQL Server数据库引擎。

对于PostgreSQL实例的磁盘空间使用量，可以调用查询数据库实例列表接口，通过响应参数“storage_used_space”获取。

授权信息

URI

• URI格式

  GET /v3/{project_id}/instances/{instance_id}/storage-used-space

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	参数解释： 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。
  instance_id	是	参数解释： 要查询的实例ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。

请求消息

• 请求参数

  无。

• URI样例

  GET https://{Endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/314958daf6904c478d17c642ac209abbin01/storage-used-space

响应消息

• 正常响应要素说明

  表2 要素说明

  名称	参数类型	说明
  node_id	String	参数解释： 实例的节点ID。 取值范围： 不涉及。
  used	String	参数解释： 磁盘空间使用量（单位GB）。 取值范围： 不涉及。

• 正常响应样例

  {
    "node_id" : "0314958daf6904c478d17c642ac209abbin01",
    "used" : "14.21"
  }

• 异常响应

  请参见异常请求结果。

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。