文档中心

云服务器

请输入

存储放置组

DescribePlacementGroupDetails - 查询放置组云盘

调用DescribePlacementGroupDetails查询存储放置组绑定的云盘信息。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：DescribePlacementGroupDetails

要执行的操作，取值：DescribePlacementGroupDetails。

Version string 必选示例值：2020-04-01

API的版本，取值：2020-04-01。

PlacementGroupId string 必选示例值：pg-bp67acfmxazb4ph****

存储放置组ID。

说明

您可以调用DescribePlacementGroups接口查询存储放置组ID。

VolumeIds.N string[] 可选示例值：vol-jv4gkgfal98bv6pz****

云盘ID。

PlacementSubgroupNumbers.N integer[] 可选示例值：2

存储放置组子组编号。

PageNumber integer 可选示例值：1

起始页码，默认为1。

PageSize integer 可选示例值：15

页大小，最大100，默认为15。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

Volumes object[] 示例值：1

云盘信息。

VolumeId string 示例值：vol-jv4gkgfal98bv6pz****

云盘ID。

VolumeName string 示例值：test-vol

云盘名称。

VolumeType string 示例值：ESSD_PL0

云盘类型，取值说明如下：

ESSD_PL0：极速型SSD云盘，PL0规格。

ESSD_FlexPL: 极速型SSD云盘，FlexPL规格。

ZoneId string 示例值：cn-beijing-a

云盘所在可用区。

PlacementGroupId string 示例值：pg-bp67acfmxazb4ph****

存储放置组ID。

SubgroupNumber integer 示例值：3

存储子放置组编号。

CreatedAt string 示例值：2023-07-05T15:48:58+08:00

云盘创建时间。

UpdatedAt string 示例值：2023-07-05T15:48:58+08:00

云盘修改时间。

PageNumber integer 示例值：1

页数。

PageSize integer 示例值：100

每页大小。

TotalCount integer 示例值：2

云盘的数量

请求示例

POST /?Action=DescribePlacementGroupDetails&Version=2020-04-01 HTTP/1.1​
Host: open.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20250730T085401Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250730/cn-beijing/storage_ebs/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
  "PlacementGroupId": "1"​
}​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "2025073016540703420501617025****",​
    "Action": "DescribePlacementGroupDetails",​
    "Version": "2020-04-01",​
    "Service": "storage_ebs",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "Volumes": [​
      {​
        "VolumeId": "vol-jv4gkgfal98bv6pz****",​
        "VolumeName": "test-vol",​
        "VolumeType": "ESSD_PL0",​
        "ZoneId": "cn-beijing-a",​
        "PlacementGroupId": "pg-bp67acfmxazb4ph****",​
        "SubgroupNumber": 3,​
        "CreatedAt": "2023-07-05T15:48:58+08:00",​
        "UpdatedAt": "2023-07-05T15:48:58+08:00"​
      }​
    ],​
    "PageNumber": 1,​
    "PageSize": 100,​
    "TotalCount": 1​
  }​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
404	InvalidPlacementGroup.NotFound	placement group not found	反亲和组不存在。

最近更新时间：2026.01.09 15:37:00

这个页面对您有帮助吗？

有用

无用