Creates a deployment set in the specified region.
Request parameters
Name | Type | Required | Description |
---|---|---|---|
Action | String | Yes | Name of this interface. Value: CreateDeploymentSet. |
RegionId | String | Yes | The region ID where the deployment set is located.For more information, call DescribeRegions to obtain the latest region list. |
DeploymentStrategy | String | Yes | Deployment strategy. Optional value: Availability .
|
DeploymentSetName | String | No | Deployment set name.The name is a string of 2 to 128 characters. It must begin with an English or a Chinese character. It can contain A-Z, a-z, Chinese characters, numbers, periods (.), colons (:), underscores (_), and hyphens (-). |
Description | String | No | Deployment set description.It cannot begin with http:// or https://. |
OnUnableToRedeployFailedInstance | String | No | After the instances in the deployment set are shut down and migrated, you need to set an emergency solution in case that the instances cannot be strictly distributed to physical servers. Optional values:
|
ClientToken | String | No | Guarantees the idempotence of the request. The value is generated by a client and must be globally unique. Only ASCII characters are allowed. It can contain a maximum of 64 ASCII characters. For more information, see How to ensure idempotence. |
Response parameters
Name | Type | Description |
---|---|---|
DeploymentSetId | String | Deployment set ID. |
Examples
https://ecs.aliyuncs.com/?Action=CreateDeploymentSet
&RegionId=cn-hangzhou
&DeploymentStrategy=Availability
&DeploymentSetName=AvailMySet
&<Common Request Parameters>
XML format
<CreateDeploymentSetResponse>
<RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
<DeploymentSetId>ds-bp1frxuzdg87zh4pzqkcm</DeploymentSetId>
</CreateDeploymentSetResponse>
JSON format
{
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
"DeploymentSetId": "ds-bp1frxuzdg87zh4pzqkc"
}
Error codes
Error codes specific to this interface are as follows. For more information, see API Error Center.
Error code | Error message | HTTP status code | Description |
---|---|---|---|
InvalidDescription.Malformed | The specified parameter Description is not valid. | 400 | The specified Description is invalid. |
InvalidParameter.Strategy | The specified parameter Strategy is not valid. | 400 | The specified deployment strategy is invalid. |
MissingParameter | The input parameter "RegionId" that is necessary for processing this request is not specified. | 400 | You must specify the RegionId parameter. You are not authorized to use the specified region. |
DEPLOYMENTSET.QUOTA_FULL | The deploymentSet quota is full. | 403 | The number of deployment sets you can create has reached the limit. |
InvalidRegionId.NotFound | The RegionId provided does not exist in our records. | 404 | The specified RegionId does not exist. |