ModifyInstanceType

1. 接口描述

本接口(ModifyInstanceType)用于变更实例的规格

注意事项

  • 仅实例状态为STOPPED 状态的实例才能进行此操作。

  • GPU实例不允许执行该操作。

2. 请求参数

以下请求参数列表仅列出了接口中需要的请求参数

参数名称
必选
类型
描述

instanceId

String

要变更的实例ID。

instanceType

String

变更的目标实例规格。

3. 响应结果

参数名称
类型
描述

requestId

String

唯一请求 ID。

每次请求都会返回。定位问题时需要提供该次请求的 requestId。

orderNumber

String

变更产生订单的编号。

4. 代码示例

1. 变更实例的规格。

POST /api/v2/zec HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: ModifyInstanceType
<Common Request Params>

Request:
{
  "instanceId": "instanceId",
  "instanceType": "z2a.cpu.4"
}

Response:
{
  "requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3",
  "response": {
    "requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3"
  }
}

5. 开发者工具

Zenlayer Cloud API 2.0 提供了配套的开发工具集(SDK),未来会陆续支持更多开发语言,方便快速接入和使用Zenlayer的产品和服务。

6. 错误码

下面包含业务逻辑中遇到的错误码,其他错误码见公共错误码

HTTP状态码
错误码
说明

404

INVALID_INSTANCE_NOT_FOUND

服务器实例不存在。

404

INVALID_INSTANCE_TYPE_NOT_FOUND

实例规格不存在。

400

OPERATION_DENIED_GPU_INSTANCE_NOT_SUPPORT

实例类型为GPU不允许该操作。

400

OPERATION_DENIED_INSTANCE_STATUS_NOT_SUPPORT

实例状态不允许操作。

400

OPERATION_FAILED_INSTANCE_TYPE_UNSUPPORTED

实例规格不支持,无法操作。

最后更新于