DescribeDiskReplicaPairs_块存储_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.

接口说明

  • 异步复制功能支持的地域请参见云盘异步复制概述

  • 当您指定某一地域进行查询后,如果异步复制关系中主盘或者从盘属于该地域,则查询结果中将包含该异步复制关系的信息。

  • 当您需要分页查询时,请使用MaxResultsNextToken参数进行查询。具体使用说明:分页查询首页时,设置MaxResults以限制返回信息的条目数,返回结果中的 NextToken 将作为查询后续页的凭证。查询后续页时,将 NextToken 参数设置为上一次返回结果中获取到的 NextToken 作为查询凭证,并设置 MaxResults 限制返回条目数。

流控信息

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

授权信息

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

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
ebs:DescribeDiskReplicaPairs
Get
DiskReplicaPair
acs:ebs:{#regionId}:{#accountId}:diskreplicapair/*
DiskReplicaPair
acs:ebs:{#regionId}:{#accountId}:diskreplicapair/{#ReplicaPairId}

请求参数

字段名称字段详情
RegionIdstring

异步复制关系中主盘或从盘所属的地域 ID。您可以调用 DescribeRegions 查询异步复制功能支持的地域信息。

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

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

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

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

示例值:AAAAAdDWBF2****
PairIdsstring

异步复制关系 ID 列表。您可以指定一个或多个异步复制关系 ID 进行查询。格式为:pair-cn-dsa****,pair-cn-asd****展开详情

示例值:pair-cn-dsa****
Sitestring

获取本 Region 为生产站点或灾备站点的复制对数据。取值范围:展开详情

示例值:production
ReplicaGroupIdstring

一致性复制组 ID,您可以指定一个一致性复制组 ID 来查询组内的复制对。格式为:pg-****展开详情

示例值:pg-****参考取值来源:
    CreateDiskReplicaGroup
    DescribeDiskReplicaGroups
    AddDiskReplicaPair
PageNumberinteger<int32>

分页查询时的页码。

示例值:5
PageSizeinteger<int32>

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

示例值:10
ResourceGroupIdstring

异步复制对所在的企业资源组 ID。

示例值:rg-acfmvs******参考取值来源:
    DescribeDiskReplicaGroups
Namestring

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

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

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

子级条数 <= 21

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

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

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

示例值:AAAAAdDWBF2****
ReplicaPairsarray<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
2024-06-17
删除返回参数
2023-01-03
新增请求参数ResourceGroupId
变更返回参数
2022-12-13
新增请求参数Tag
变更返回参数
2022-07-18
变更请求参数NextToken
变更请求参数Site
新增请求参数PageNumber
新增请求参数PageSize
变更返回参数
2021-11-03
变更请求参数MaxResults
变更请求参数NextToken
变更请求参数PairIds
变更请求参数Site
变更请求参数ReplicaGroupId
变更返回参数

相关示例