DDM实例节点缩容
功能介绍
对指定的DDM实例的节点个数进行缩容。
接口约束
请确保实例关联的RDS状态正常并且没有进行其他操作。包周期实例不支持该操作。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v2/{project_id}/instances/{instance_id}/action/reduce
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
租户在某一region下的project ID。 获取方法请参见获取项目ID。 |
|
instance_id |
是 |
String |
DDM实例ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务的“获取用户Token”接口来获取。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
node_number |
是 |
Integer |
需要缩容的节点数量,最大值为实例节点数减1。 |
|
group_id |
否 |
String |
组ID,指定当前进行节点扩容的组。当实例的组大于1时,必填。 |
响应参数
状态码: 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
instanceId |
String |
DDM实例ID。 |
|
instanceName |
String |
DDM实例名称。 |
|
jobId |
String |
任务ID,仅按需实例时会返回该参数。 |
|
orderId |
String |
订单号,仅包年包月实例时返回该参数。 |
状态码: 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
errCode |
String |
业务错误码。 |
|
externalMessage |
String |
错误信息。 |
状态码: 500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
errCode |
String |
业务错误码。 |
|
externalMessage |
String |
错误信息。 |
请求示例
- 缩容实例节点,需要缩容的节点数量为2。
POST https://{endpoint}/v2/{project_id}/instances/{instance_id}/action/reduce { "node_number" : 2 } - 缩容实例节点,实例有多个组,需要缩容的节点数量为1。
POST https://{endpoint}/v2/{project_id}/instances/{instance_id}/action/reduce { "group_id" : "f080abf2010d45118068c28c8958f5fcgr09", "node_number" : 1 }
响应示例
状态码: 200
ok
{
"instanceId" : "28e8841d0b9c4f6a9a30742ee60e1068in09",
"instanceName" : "BUG-ddm-fb88-test",
"jobId" : "1eb697c0-1842-43a3-8671-f562d0385cb9"
}
状态码: 400
bad request
{
"externalMessage" : "Parameter error.",
"errCode" : "DBS.280001"
}
状态码: 500
server error
{
"externalMessage" : "Server failure.",
"errCode" : "DBS.200412"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
ok |
|
400 |
bad request |
|
500 |
server error |
错误码
请参见错误码。