DDM实例节点扩容
功能介绍
对指定的DDM实例的节点个数进行扩容，支持按需实例与包周期实例。
接口约束
请确保实例关联的RDS状态正常并且没有进行其他操作。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v2/{project_id}/instances/{instance_id}/action/enlarge
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
租户在某一region下的project ID。 获取方法请参见获取项目ID。 |
|
instance_id |
是 |
String |
DDM实例ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务的“获取用户Token”接口来获取。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
flavor_id |
是 |
String |
当前进行节点扩容的DDM实例底层虚拟机规格ID。 |
|
node_number |
是 |
Integer |
需要扩容的节点个数。 |
|
group_id |
否 |
String |
组ID，指定当前进行节点扩容的组。当实例的组大于1时，必填。 |
|
is_auto_pay |
否 |
Boolean |
变更包年包月实例规格时可指定，表示是否自动从账户中支付，此字段不影响自动续订的支付方式。
|
|
available_zones |
否 |
Array of strings |
可用区Code，仅包年包月实例传递该参数，个数需与node_number一致。请参见地区和终端节点。 |
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
instanceId |
String |
DDM实例ID。 |
|
instanceName |
String |
DDM实例名称，仅按需实例时会返回该参数。 |
|
jobId |
String |
任务ID，仅按需实例时会返回该参数。 |
|
orderId |
String |
订单号，仅包年包月实例时返回该参数。 |
状态码： 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
errCode |
String |
业务错误码。 |
|
externalMessage |
String |
错误信息。 |
状态码： 500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
errCode |
String |
业务错误码。 |
|
externalMessage |
String |
错误信息。 |
请求示例
- 扩容按需实例的节点，需要扩容的节点数量为1。
POST https://{endpoint}/v2/{project_id}/instances/{instance_id}/action/enlarge { "flavor_id" : "8f2e696c-a9c1-30bd-af90-25522bc67606", "node_number" : 1 } - 扩容按需实例的节点，实例有多个组，需要扩容的节点数量为1。
POST https://{endpoint}/v2/{project_id}/instances/{instance_id}/action/enlarge { "flavor_id" : "8f2e696c-a9c1-30bd-af90-25522bc67606", "group_id" : "f080abf2010d45118068c28c8958f5fcgr09", "node_number" : 1 } - 扩容包周期实例的节点，需要扩容的节点数量为1，自动从账户余额中支付。
POST https://{endpoint}/v2/{project_id}/instances/{instance_id}/action/enlarge { "flavor_id" : "8f2e696c-a9c1-30bd-af90-25522bc67606", "node_number" : 1, "is_auto_pay" : true, "available_zones": [ "az1xahz" ] }
响应示例
状态码： 200
ok
{
"instanceId" : "28e8841d0b9c4f6a9a30742ee60e1068in09",
"instanceName" : "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 |
错误码
请参见错误码。
