查询实例磁盘信息

接口说明

查询实例磁盘信息。

调试

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

URI

• URI格式

  GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/disk-usage

• URI样例
  https://dds.cn-north-1.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/520c58ba00a3497e97ce0b9604874dd6in02/disk-usage

  表1 请求参数

  参数	是否必选	参数类型	描述
  X-Auth-Token	是	String	从IAM服务获取的用户Token。请参考认证鉴权。
  project_id	是	String	租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。
  instance_id	是	String	实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

请求消息

无。

响应消息

• 参数说明

  表2 响应Body参数

  参数	参数类型	说明
  volumes	Array of 表3 objects	磁盘信息列表。

  表3 DiskVolumes

  参数	参数类型	说明
  entity_id	String	实例ID或组ID或节点ID。
  entity_name	String	实例名称或组名称或节点名称。
  group_type	String	group_type。取值范围： mongos，表示集群mongos节点类型。 shard，表示集群shard节点类型。 config，表示集群config节点类型。 replica，表示副本集类型。 single，表示单节点类型。 readonly，表示只读节点类型。
  used	String	使用量，保留两位小数，单位(GB)。
  size	String	总大小，单位(GB)。

• 响应示例

  { 
    "volumes" : [ { 
      "entity_id" : "f04553d9ad2942e7a44facc518dc5699gr02", 
      "entity_name" : "single01", 
      "group_type" : "single", 
      "used" : "3.18", 
      "size" : "60"
    } ] 
  }

状态码

详情请参见状态码。

错误码

详情请参见错误码。