调用 ModifyInstanceDeployment 接口调整实例所属部署集,您可以向指定部署集内添加一台实例,或者将一台实例从部署集中移除。
调用该接口之前,请务必先查看调整实例所属部署集,充分了解其中的注意事项,以确保操作的准确性和合规性。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyInstanceDeployment | 要执行的操作,取值:ModifyInstanceDeployment。 |
Version | String | 是 | 2020-04-01 | API的版本,取值:2020-04-01。 |
ClientToken | String | 否 | 333456899ff**** | 保证请求幂等性。由客户端自动生成一个参数值,确保不同请求间该参数值唯一,避免当调用API超时或服务器内部错误时,客户端多次重试导致重复性操作。 |
DeploymentSetGroupNumber | Integer | 否 | 1 | 部署集组的序号,取值范围:1~7。 |
DeploymentSetId | String | 是 | dps-yc1o9aahks5m57nk**** | 目标部署集ID。
|
InstanceId | String | 是 | i-3tigy72q3u3vj0x2**** | 实例ID。 |
本接口无特有的返回参数。更多信息请见返回结构。
GET /?Action=ModifyInstanceDeployment&Version=2020-04-01&DeploymentSetId=dps-yc1o9aahks5m57nk****&InstanceId=i-3tigy72q3u3vj0x2**** HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing ServiceName: ecs
text
{
"ResponseMetadata": {
"RequestId": "2021062415303301022514515207C4****",
"Action": "ModifyInstanceDeployment",
"Version": "2020-04-01",
"Service": "ecs",
"Region": "cn-beijing"
},
"Result": {}
}
json
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | IdempotentParameterMismatch | The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical. | 幂等参数不一致。 |
400 | Insufficient.Balance | The request is denied due to the lack of balance. | 账户余额不足。 |
400 | InvalidClientToken.Malformed | The specified ClientToken is malformed. | 指定的ClientToken不合法。 |
400 | InvalidDedicatedHostInstanceForModifyInstanceDeploymentSet.Unsupported | The specified dedicated host instance does not support modify instance deployment set. | 指定的专有宿主机实例不支持修改部署集。 |
400 | InvalidInstanceStatus | The status of the specified instance does not support this request. | 当前实例的状态不支持此操作。 |
400 | InvalidInstanceTypeForModifyInstanceDeployment.Unsupported | The specified InstanceType does not support modification of deployment set. | 指定的实例规格不支持修改部署集。 |
400 | InvalidScheduledInstanceForModifyInstanceDeploymentSet.Unsupported | The specified scheduled instance does not support modify instance deployment set. | 指定的弹性预约实例不支持修改部署集。 |
400 | InvalidStoppedModeForModifyInstanceDeploymentSet.Unsupported | The specified instance of StoppedMode cannot be added to DeploymentSet. | 指定的节省停机模式实例不支持加入到部署集。 |
400 | LimitExceeded.MaximumDeploymentSetInstances | You've reached the limit on the number of instances that can be added to the deployment set. | 指定的部署集内的实例数量超过最大限制。 |
400 | MissingParameter.DeploymentSetId | The required parameter DeploymentSetId is not supplied. | 部署集ID不能为空。 |
400 | MissingParameter.InstanceId | The required parameter InstanceId is not supplied. | 参数实例ID不能为空。 |
404 | InvalidDeploymentSet.NotFound | The specified DeploymentSet does not exist. | 指定的部署集不存在。 |
404 | InvalidInstance.NotFound | The specified instance does not exist. | 指定的实例不存在。 |
412 | IdempotentProcessing | The request uses the same client token as a previous one that is still in process. | 先前的幂等请求仍在处理中,请稍后重试。 |
412 | OperationDenied.ResourceLocked | The specified operation is denied as your resource is locked for another operation. | 指定的操作被拒绝,因为您的资源已被其他操作锁定。 |
500 | InternalError | An internal error has occurred. | 内部错误,请重试。如果多次尝试失败,请提交工单。 |