变更实例规格 - ChangingtheCPUandMemorySpecificationsofanInstance
接口约束
- 新规格和旧规格的操作系统架构必须相同。
调试
您可以在API Explorer中调试该接口。
URI
PUT /v3/{project_id}/instances/{instance_id}/flavor
|
名称 |
是否必选 |
说明 |
|---|---|---|
|
project_id |
是 |
参数解释: 租户在某一Region下的项目ID。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为32个字符。 默认取值: 不涉及。 |
|
instance_id |
是 |
参数解释: 实例ID,此参数是用户创建实例的唯一标识。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为36个字符。 默认取值: 不涉及。 |
请求参数
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
flavor_ref |
是 |
String |
参数解释: 规格变更的新规格的资源规格编码。参考表1中的“规格编码”列内容获取。 参考查询数据库规格 - QueryingInstanceSpecifications中“spec_code”字段获取。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
is_auto_pay |
否 |
Boolean |
参数解释: 包周期实例时可指定,表示是否自动从账户中支付,此字段不影响自动续订的支付方式。 约束限制: 不涉及。 取值范围:
默认取值: false。 |
|
cn_concurrent_resize_num |
否 |
Integer |
参数解释: 指定CN节点的规格变更并行数。 调整CN节点并行变更数可以加快规格变更的过程,建议使用系统默认配置的规格。如需调整,请根据当前系统负载评估剩余CN节点业务负载变化情况,确保业务稳定性和中断时长在可接受范围内。 约束限制: 仅对独立部署形态实例生效。 取值范围: [1, floor(总协调节点数/2)],单批次最多变更20个协调节点。 默认取值: 1 |
|
dn_concurrent_resize_num |
否 |
Integer |
参数解释: 指定DN节点的规格变更并行数。 调整DN节点并行变更数可以加快规格变更的过程,建议使用系统默认配置的规格。如需调整,建议根据当前系统负载评估短时间内倒换DN节点数量情况,确保业务稳定性和中断时长在可接受范围内。 约束限制: 不涉及。 取值范围:
默认取值: 不指定分片并发数时,分为以下两种情况:
|
响应参数
|
名称 |
参数类型 |
说明 |
|---|---|---|
|
job_id |
String |
参数解释: 规格变更的任务ID,仅变更按需实例时会返回该参数。 取值范围: 不涉及。 |
|
order_id |
String |
参数解释: 订单ID,仅变更包周期实例会返回该参数。 取值范围: 不涉及。 |
请求示例
变更按需实例的规格,变更为16U128G。
PUT https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in14/flavor
{
"flavor_ref":"gaussdb.opengauss.ee.dn.m6.4xlarge.8.in"
}
PUT https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in14/flavor
{
"flavor_ref":"gaussdb.opengauss.ee.dn.m6.4xlarge.8.in",
"is_auto_pay":true
}
响应示例
变更实例规格成功。
{
"job_id": "2b414788a6004883a02390e2eb0ea227"
}
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。