Deletes a replication pair-consistent group.
Description
- The replication pair-consistent group feature is supported in the China (Hangzhou), China (Shanghai), China (Beijing), China (Shenzhen), China (Heyuan), China (Chengdu), China (Hong Kong), Singapore (Singapore), US (Silicon Valley), and US (Virginia) regions.
- Before you can delete a replication pair-consistent group, make sure that no replication pairs are present in the group.
- The replication pair-consistent group that you want to delete must be in the Created (
created
), Creation Failed (create_failed
), Stopped (stopped
), Failover Failed (failovered
), Deleting (deleting
), Deletion Failed (delete_failed
), or Invalid (invalid
) state.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DeleteDiskReplicaGroup |
The operation that you want to perform. Set the value to DeleteDiskReplicaGroup. |
RegionId | String | Yes | cn-beijing |
The region ID of the replication pair-consistent group. |
ReplicaGroupId | String | Yes | pg-myreplica**** |
The ID of the replication pair-consistent group. You can call the DescribeDiskReplicaGroups operation to query the IDs of replication pair-consistent groups. |
ClientToken | String | No | 123e4567-e89b-12d3-a456-42665544**** |
The client token that is used to ensure the idempotence of the request. You can use the client to generate the value, but you must make sure that the value is unique among different requests. The ClientToken value can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure idempotence. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | C123F94F-4E38-19AE-942A-A8D6F44F**** |
The ID of the request. |
Examples
Sample requests
http(s)://ecs.aliyuncs.com/?Action=DeleteDiskReplicaGroup
&RegionId=cn-beijing
&ReplicaGroupId=pg-myreplica****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&<Common request parameters>
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<DeleteDiskReplicaGroupResponse>
<RequestId>C123F94F-4E38-19AE-942A-A8D6F44F****</RequestId>
</DeleteDiskReplicaGroupResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "C123F94F-4E38-19AE-942A-A8D6F44F****"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | The error message returned because the specified region ID does not exist. |
404 | InvalidZoneId.NotFound | The specified ZoneId does not exist. | The error message returned because the specified zone ID does not exist. |
404 | NoSuchResource | The specified resource does not exist. | The error message returned because the specified resource does not exist. |
504 | RequestTimeout | The request is timeout, please try again later. | The error message returned because the request timed out. Try again later. |
500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | The error message returned because an internal error has occurred. |
403 | InvalidPayMethod | The specified pay method is not valid. | The error message returned because the billing method is not supported. Check whether the chargeType parameter is valid. |
403 | Forbidden | User is not authorized to operate. | The error message returned because you are not authorized to manage the resource. Check the permissions of your account or contact your Alibaba Cloud account administrator. |
403 | Forbidden.Action | User is not authorized to operate this action. | The error message returned because you are not authorized to perform this operation. Check the permissions of your account or contact your Alibaba Cloud account administrator. |
403 | NoPermission.SLR | The RAM user does not have the permission to create service linked role: AliyunServiceLinkedRoleForEBS. | The error message returned because you are not authorized to create service-linked roles. |
403 | LastTokenProcessing | The last token request is processing. | The error message returned because the ClientToken value is used in another request that is being processed. Try again later. |
403 | InvalidAccountStatus.NotEnoughBalance | Your account does not have enough balance. | The error message returned because your account balance is insufficient. |
403 | InvalidDiskCategory.NotSupported | The specified disk category is not supported. | The error message returned because the specified disk category is not supported by this operation. Check the specified value and refer to related API documentation. |
403 | OperationDenied | The operation is not allowed. | The error message returned because the operation is not supported. |
403 | OperationDenied.QuotaExceed | The operation is not allowed due to quota exceed. | The error message returned because the operation is not supported while the quota is exceeded. |
403 | NotOnSale.Region | The specified region is not on sale. | The error message returned because requested resources are unavailable for purchase or out of stock in the region. |
403 | NotOnSale.Zone | The specified zone is not on sale. | The error message returned because requested resources are unavailable for purchase or out of stock in the zone. |
403 | OperationDenied.PairInAnotherGroup | The operation is not allowed because pair is already in another group. | The error message returned because the operation is not supported while the replication pair is already added to another replication pair-consistent group. |
403 | OperationDenied.PairNotInGroup | The operation is not allowed because pair is not in any group. | The error message returned because the operation is not supported while the specified replication pair is not added to replication pair-consistent groups. |
403 | OperationDenied.NoPairInGroup | The operation is not allowed because no pair in the group. | The error message returned because the operation is not supported while no replication pairs are present in the specified replication pair-consistent group. |
403 | OperationDenied.PairsExceedInGroup | The operation is not allowed due to too much pair in the group. | The error message returned because the operation is not supported while the maximum number of replication pairs in the replication pair-consistent group has been reached. |
403 | OperationDenied.ManualSyncLimit | One shot start manual syncing too frequently, please try again later. | The error message returned because the cooldown time of manual synchronization is invalid. |
403 | OperationDenied.GroupTotalDiskCapacityLimit | Operation failed because of total disk capacity in group over limit. | The error message returned because the total capacity of disks in the replication pair-consistent group exceeds the maximum allowed value. |
For a list of error codes, visit the API Error Center.