Creates a deployment set in a specific region.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
RegionId | string | Yes | Creates a deployment set in a specific region. | cn-hangzhou |
OnUnableToRedeployFailedInstance | string | No | The region ID of the deployment set. You can call the DescribeRegions operation to query the most recent list of regions. | CancelMembershipAndStart |
Description | string | No | The emergency solution to use in the situation where instances in the deployment set cannot be evenly distributed to different zones due to resource insufficiency after the instances failover. Valid values:
Default value: CancelMembershipAndStart. | testDescription |
ClientToken | string | No | The description of the deployment set. The description must be 2 to 256 characters in length and cannot start with | 123e4567-e89b-12d3-a456-426655440000 |
DeploymentSetName | string | No | The client token that is used to ensure the idempotence of the request. You can use the client to generate a client token. Make sure that a unique client token is used for each request. The ClientToken value can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure idempotence. | testDeploymentSetName |
Domain | string | No | The name of the deployment set. The name must be 2 to 128 characters in length, It must start with a letter and cannot start with | Default |
Granularity | string | No | The deployment domain. Set the value to Default. Default: Instances in the deployment set are distributed only within the current zone. | host |
Strategy | string | No | The deployment granularity. Set the value to host. host: Instances in the deployment set are dispersed at the granularity of hosts. | Availability |
GroupCount | long | No | The deployment strategy. Valid values:
Default value: Availability. | 1 |
Response parameters
Examples
Sample success responses
JSON
format
{
"DeploymentSetId": "ds-bp1frxuzdg87zh4pzq****",
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | MissingParameter | The input parameter RegionId that is mandatory for processing this request is not supplied. | - |
400 | InvalidDeploymentSetName.Malformed | Specified deployment set name is not valid. | The specified DeploymentSetName parameter is invalid. |
400 | InvalidDescription.Malformed | The specified parameter Description is not valid. | The resource description is invalid. The description must be 2 to 256 characters in length and cannot start with http:// or https://. |
400 | InvalidParameter.Domain | The specified parameter Domain is not valid. | The specified Domain parameter is invalid. |
400 | InvalidParameter.Strategy | The specified parameter Strategy is not valid | The specified Strategy parameter is invalid. |
400 | InvalidParameter.GroupCount | The specified parameter GroupCount is not valid | - |
400 | InvalidParameter.granularity | The specified parameter Granularity is not valid. | The specified Granularity parameter is invalid. |
400 | DependencyViolation.domain.granularity | The DeploymentSet domain and granularity is violation. | The specified Domain and Granularity parameters do not correspond to each other. |
400 | DependencyViolation.strategy.granularity | The DeploymentSet strategy and granularity is violation. | The DeploymentSet strategy conflicts with granularity. |
400 | DEPLOYMENTSET.QUOTA_FULL | The deploymentSet quota is full | The maximum number of deployment sets has been reached. Reduce the number of deployment sets. |
400 | DeploymentSet.GroupQuotaFull | The deploymentSet group quota is full. | The maximum number of deployment set groups that can be created is exceeded. Reduce the number of deployment set groups to be created. |
404 | InvalidZoneId.NotFound | The ZoneId provided does not exist in our records. | The specified zone ID does not exist. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation | ||||||
---|---|---|---|---|---|---|---|---|
2023-08-21 | The Error code has changed | see changesets | ||||||
| ||||||||
2022-06-10 | The Error code has changed | see changesets | ||||||
|