调用CreateDeploymentSet在指定的地域内创建一个部署集。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateDeploymentSet |
系统规定参数。取值:CreateDeploymentSet。 |
RegionId | String | 是 | cn-hangzhou |
部署集所属地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
OnUnableToRedeployFailedInstance | String | 否 | CancelMembershipAndStart |
部署集内实例宕机迁移后,缺乏可供打散的实例库存的紧急处理方案。取值范围:
默认值:CancelMembershipAndStart。 |
Description | String | 否 | testDescription |
部署集描述信息。长度为2~256个英文或中文字符,不能以 |
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-426655440000 |
保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。更多信息,请参见如何保证幂等性。 |
DeploymentSetName | String | 否 | testDeploymentSetName |
部署集名称。长度为2~128个英文或中文字符。必须以大小字母或中文开头,不能以 |
Domain | String | 否 | Default |
部署域。当前仅支持Default。 Default:在当前可用区内,部署集内的实例会在同可用区内分布。 |
Granularity | String | 否 | host |
部署粒度。当前仅支持host。 host:部署集内实例会按照宿主机维度进行打散。 |
Strategy | String | 否 | Availability |
部署策略。取值范围:
默认值:Availability。 |
GroupCount | Long | 否 | 1 |
为部署集组高可用策略设置分组数量。取值范围:1~7。 默认值:3。 说明 该参数仅当
Strategy=AvailabilityGroup 时生效。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
DeploymentSetId | String | ds-bp1frxuzdg87zh4pzq**** |
部署集ID。 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
请求ID。 |
示例
请求示例
http(s)://ecs.aliyuncs.com/?Action=CreateDeploymentSet
&RegionId=cn-hangzhou
&DeploymentSetName=testDeploymentSetName
&Strategy=Availability
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateDeploymentSetResponse>
<DeploymentSetId>ds-bp1frxuzdg87zh4pzq****</DeploymentSetId>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</CreateDeploymentSetResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"DeploymentSetId" : "ds-bp1frxuzdg87zh4pzq****",
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | MissingParameter | The input parameter RegionId that is mandatory for processing this request is not supplied. | 参数 RegionId 不得为空。 |
400 | InvalidDeploymentSetName.Malformed | Specified deployment set name is not valid. | 指定的参数 DeploymentSetName 不合法。 |
400 | InvalidDescription.Malformed | The specified parameter Description is not valid. | 指定的资源描述格式不合法。长度为 2-256 个字符,不能以 http:// 和 https:// 开头。 |
400 | InvalidParameter.Domain | The specified parameter Domain is not valid. | 指定的Domain参数不合法。 |
400 | InvalidParameter.Strategy | The specified parameter Strategy is not valid | 指定的 Strategy 不合法。 |
400 | InvalidParameter.granularity | The specified parameter Granularity is not valid. | 指定的 Granularity 参数不合法。 |
400 | DependencyViolation.domain.granularity | The DeploymentSet domain and granularity is violation. | 部署集域与数据粒度冲突。 |
400 | DependencyViolation.strategy.granularity | The DeploymentSet strategy and granularity is violation. | 部署集策略与数据粒度冲突。 |
400 | DEPLOYMENTSET.QUOTA_FULL | The deploymentSet quota is full | 部署集配额已满,请您减少部署集数量。 |
400 | DeploymentSet.GroupQuotaFull | The deploymentSet group quota is full. | 创建的部署集组的组数量超过quota限制,请尝试更小的组数量 |
访问错误中心查看更多错误码。