调用ModifyDiskReplicaPair修改一个异步复制关系的名称或者描述信息。
接口说明
- 异步复制功能支持的地域请参见云盘异步复制概述。
- 当异步复制关系处于已创建（
created）或已停止（stopped）状态时，可以修改名称或者描述信息。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
|
名称 |
类型 |
是否必选 |
示例值 |
描述 |
| Action | String | 是 | ModifyDiskReplicaPair | 系统规定参数。取值：ModifyDiskReplicaPair。 |
| RegionId | String | 是 | cn-beijing | 异步复制关系中主盘或从盘所属的地域ID。您可以调用DescribeRegions查询异步复制功能支持的地域信息。 |
| ReplicaPairId | String | 是 | pair-cn-dsa**** | 异步复制关系的ID。 |
| PairName | String | 否 | TestReplicaPair | 异步复制关系的名称。 |
| Description | String | 否 | This is description. | 异步复制关系的描述信息。 |
| ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** | 保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多信息，请参见如何保证幂等性。 |
| Bandwidth | Long | 否 | 10240 | 云盘之间异步复制数据时的带宽。单位为Kbps。取值范围：
默认值：10240。 |
| RPO | Long | 否 | 900 | 一致性组设定的RPO值，单位：秒。当前仅支持900秒。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
| RequestId | String | C123F94F-4E38-19AE-942A-A8D6F44F**** | 请求ID。 |
示例
请求示例
http(s)://ebs.cn-beijing.aliyuncs.com/?Action=ModifyDiskReplicaPair
&RegionId=cn-beijing
&ReplicaPairId=pair-cn-dsa****
&PairName=TestReplicaPair
&Description=This is description.
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&Bandwidth=10240
&RPO=900
&公共请求参数正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyDiskReplicaPairResponse>
<RequestId>C123F94F-4E38-19AE-942A-A8D6F44F****</RequestId>
</ModifyDiskReplicaPairResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "C123F94F-4E38-19AE-942A-A8D6F44F****"
}错误码
|
HttpCode |
错误码 |
错误信息 |
描述 |
| 403 | OperationDenied | The operation is not allowed. | 当前操作不允许执行。 |
| 403 | OperationDenied.InvalidStatus | The operation is not allowed in current status. | 当前状态下该操作不允许执行。 |
| 403 | OperationDenied.OperateNotAllowedForPrimary | Operation is not allowed on the primary site. | 当前操作在主端不被允许。 |
| 403 | OperationDenied.OperateNotAllowedForStandby | Operation is not allowed on the secondary site. | 当前操作在从端不被允许。 |
| 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. | 该请求超时，请稍后再重试。 |
访问错误中心查看更多错误码。