DescribeDiskReplicaGroups_块存储_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

当您需要分页查询时,请使用 MaxResults 与 NextToken 参数进行查询。

分页查询首页时,设置MaxResults以限制返回信息的条目数,返回结果中的NextToken将作为查询后续页的凭证。查询后续页时,将NextToken参数设置为上一次返回结果中获取到的NextToken作为查询凭证,并设置 MaxResults 限制返回条目数。

流控信息

请求速率为40/1(s)。更多流控信息,请前往配额中心查看

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
ebs:DescribeDiskReplicaGroups
List
DiskReplicaGroup
acs:ebs:{#regionId}:{#accountId}:diskreplicagroup/*
DiskReplicaGroup
acs:ebs:{#regionId}:{#accountId}:diskreplicagroup/{#ReplicaGroupId}

请求参数

字段名称字段详情
RegionIdstring

一致性复制组所属的地域 ID。

示例值:cn-beijing参考取值来源:
    DescribeRegions
MaxResultsinteger<int64>

本次调用期望查询的最大条目数。可配合 NextToken 参数一起使用。展开详情

注意 该字段类型为 Long,在序列化/反序列化的过程中可能导致精度丢失,请注意数值不得大于 9007199254740991。
示例值:10
NextTokenstring

查询凭证(Token)。取值为上一次调用该接口返回的 NextToken 参数值,初次调用接口时无需设置该参数。如果设置了 NextToken,则请求参数 PageSize 和 PageNumber 将失效,且返回数据中的 TotalCount 无效。

示例值:AAAAAdDWBF2****
GroupIdsstring

一致性复制组的 ID 列表。您可以指定一个或多个一致性复制组的 ID 进行查询。多个一致性复制组的 ID 之间用半角逗号(,)分隔。展开详情

示例值:AAAAAdDWBF2****
Sitestring

查询并返回指定站点的记录,主要应用于跨可用区复制对的场景。展开详情

示例值:production
PageNumberinteger<int32>

分页查询时的页码。

示例值:5
PageSizeinteger<int32>

分页查询时设置的每页行数。展开详情

示例值:10
ResourceGroupIdstring

一致性复制组所在的企业资源组 ID。

示例值:rg-aekz*****
Namestring

复制组名称,支持模糊搜索。

示例值:pg-name***
Tagarray<object>

标签列表,最多包含 20 个子项。

子级条数 <= 21

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:AAA478A0-BEE6-1D42-BEB6-A9CFEAD6****
NextTokenstring

本次调用返回的查询凭证(Token)。

示例值:AAAAAdDWBF2****
ReplicaGroupsarray<object>

一致性复制组的信息组成的集合。

PageNumberinteger<int32>

分页查询时的页码。

示例值:1
PageSizeinteger<int32>

分页查询时设置的每页行数。

示例值:10
TotalCountinteger<int64>

分页查询时的结果总条数。

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:60

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
403
OperationDenied
The operation is not allowed.诊断
403
OperationDenied.InvalidStatus
The operation is not allowed in current status.诊断
403
Forbidden
User is not authorized to operate.诊断
403
Forbidden.Action
User is not authorized to operate this action.诊断
404
NoSuchResource
The specified resource does not exist.诊断
500
InternalError
The request processing has failed due to some unknown error, exception or failure.诊断
504
RequestTimeout
The request is timeout, please try again later.诊断

变更历史

变更时间变更内容概要操作
2024-08-14
新增请求参数Name
2023-07-19
删除返回参数
2023-01-03
新增请求参数ResourceGroupId
新增请求参数Tag
变更返回参数
2022-10-28
变更请求参数NextToken
新增请求参数PageNumber
新增请求参数PageSize
变更返回参数
2022-08-16
变更返回参数
2022-06-06
变更返回参数

相关示例