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.

Availability represents the High Availability strategy. All the ECS instances in the deployment set are strictly distributed across different physical servers in the region. This design applies to scenarios where several ECS instances need to be isolated from each other to significantly reduce the chances of service being unavailable.

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:
  • (Default) CancelMembershipAndStart: Allows you to move the instance out of the deployment set and start the instance immediately after the instance has been shut down and migrated. However, the instance specification may change.
  • KeepStopped: The instance is not allowed to be moved out of the deployment set. The instance stays in an abnormal status until the new resources become available in the region. When the required resources become available, the instance can be started.
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

Request example
https://ecs.aliyuncs.com/?Action=CreateDeploymentSet
&RegionId=cn-hangzhou
&DeploymentStrategy=Availability
&DeploymentSetName=AvailMySet
&<Common Request Parameters>
Response examples

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.