文档首页/ 分布式缓存服务 DCS/ API参考/ API V2（推荐）/ 实例管理/ 切换指定实例的子网信息 - SwitchInstanceSubnet
更新时间：2025-10-23 GMT+08:00
在线调试
CLI示例
查看PDF
分享

切换指定实例的子网信息 - SwitchInstanceSubnet

功能介绍

实例子网切换。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

POST /v2/{project_id}/instances/{instance_id}/resources/subnet

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID。获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

instance_id

是

String

参数解释：

实例ID。可通过DCS控制台进入实例详情界面查看。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

action

否

String

参数解释：

实例切换VPC子网

约束限制：

不涉及。

取值范围：

switch：标识子网切换

默认取值：

不涉及。

vpc_id

否

String

参数解释：

目标VPC ID

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

subnet_id

否

String

参数解释：

目标子网ID

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

job_id

String

参数解释：

实例子网切换下发任务ID

取值范围：

不涉及。

状态码：400

表4 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

error_code

String

参数解释：

错误码。

取值范围：

请参见错误码。

error_ext_msg

String

参数解释：

扩展错误信息（暂未使用，赋值为null）。

取值范围：

不涉及。

状态码：401

表5 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

error_code

String

参数解释：

错误码。

取值范围：

请参见错误码。

error_ext_msg

String

参数解释：

扩展错误信息（暂未使用，赋值为null）。

取值范围：

不涉及。

状态码：403

表6 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

error_code

String

参数解释：

错误码。

取值范围：

请参见错误码。

error_ext_msg

String

参数解释：

扩展错误信息（暂未使用，赋值为null）。

取值范围：

不涉及。

状态码：404

表7 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

error_code

String

参数解释：

错误码。

取值范围：

请参见错误码。

error_ext_msg

String

参数解释：

扩展错误信息（暂未使用，赋值为null）。

取值范围：

不涉及。

状态码：500

表8 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

error_code

String

参数解释：

错误码。

取值范围：

请参见错误码。

error_ext_msg

String

参数解释：

扩展错误信息（暂未使用，赋值为null）。

取值范围：

不涉及。

请求示例

POST https://{dcs_endpoint}/v2/{project_id}/instances/{instance_id}/resources/subnet

{
  "action" : "switch",
  "vpc_id" : "c0a0a222-bac8-45d9-9d3e-9e7d0f9177c9",
  "subnet_id" : "3e803f66-fbb0-47ad-b6cb-fb87f5bed4aa"
}

响应示例

状态码：200

实例子网切换任务下发成功。

{
  "job_id" : "8abfa7aa88ad5aa50188aef7ec0936d1"
}

状态码：400

非法请求。

{
  "error_code" : "DCS.4062",
  "error_msg" : "Invalid subnet_id parameter in the request."
}

状态码

状态码

描述

200

实例子网切换任务下发成功。

400

非法请求。

401

认证信息非法。

403

请求被拒绝访问。

404

所请求的资源不存在。

500

内部服务错误。

错误码

请参见错误码。

父主题： 实例管理