ModifyDiskReplicaGroup - 云服务器 ECS

接口说明

一致性复制组功能支持的地域请参见云盘异步复制概述。
一致性复制组必须处于已创建（created）或者已停止（stopped）状态。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	ModifyDiskReplicaGroup	系统规定参数。取值：ModifyDiskReplicaGroup。
RegionId	String	是	cn-beijing	一致性复制组所属的地域ID。
ReplicaGroupId	String	是	pg-myreplica****	一致性复制组ID。您可以调用DescribeDiskReplicaGroups查询一致性复制组ID。
GroupName	String	否	myreplicagrouptest	一致性复制组名称。长度为2~128个英文或中文字符。必须以大小写字母或中文开头，不能以`http://`或`https://`开头。可以包含数字、半角冒号（:）、下划线（_）或者短划线（-）。
Description	String	否	This is description.	一致性组的描述信息。长度为2~256个英文或中文字符，不能以`http://`或`https://`开头。
RPO	Long	否	900	一致性组设定的RPO值，单位：秒。当前仅支持900秒。
ClientToken	String	否	123e4567-e89b-12d3-a456-42665544****	保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多信息，请参见如何保证幂等性。
Bandwidth	Long	否	null	带宽值，单位Kbps。说明该参数暂未开放使用。

返回数据

名称	类型	示例值	描述
RequestId	String	C123F94F-4E38-19AE-942A-A8D6F44F****	请求ID。

示例

请求示例

http(s)://ecs.aliyuncs.com/?Action=ModifyDiskReplicaGroup
&RegionId=cn-beijing
&ReplicaGroupId=pg-myreplica****
&GroupName=myreplicagrouptest
&Description=This is description.
&RPO=900
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyDiskReplicaGroupResponse>
    <RequestId>C123F94F-4E38-19AE-942A-A8D6F44F****</RequestId>
</ModifyDiskReplicaGroupResponse>

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.GroupHasPair	The group cannot be deleted due to not empty.	当前一致性组中包含有复制对，不能被删除。
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.	该请求超时，请稍后再重试。

访问错误中心查看更多错误码。