文档首页/ 企业路由器 ER/ API参考/ API/ VPC连接/ 更新VPC连接基本信息
更新时间:2024-04-19 GMT+08:00

更新VPC连接基本信息

功能介绍

修改VPC连接基本信息。

调用方法

请参见如何调用API

URI

PUT /v3/{project_id}/enterprise-router/{er_id}/vpc-attachments/{vpc_attachment_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

er_id

String

企业路由器实例ID

vpc_attachment_id

String

VPC连接ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

vpc_attachment

UpdateVpcAttachmentBody object

更新vpc基本信息请求体

表3 UpdateVpcAttachmentBody

参数

是否必选

参数类型

描述

description

String

VPC连接描述信息,取值范围:最大长度36字节,带“-”连字符的UUID格式

最小长度:0

最大长度:255

name

String

VPC连接名称,取值范围:1-64个字符,支持数字、字母、中文、_(下划线)、-(中划线)、.(点)

最小长度:1

最大长度:64

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

vpc_attachment

VpcAttachmentDetails object

VPC类型连接

request_id

String

请求id

表5 VpcAttachmentDetails

参数

参数类型

描述

id

String

VPC连接ID

name

String

VPC连接名称

vpc_id

String

VPC id

virsubnet_id

String

VPC子网id

auto_create_vpc_routes

Boolean

默认为false,当设置true时,会自动为VPC配置10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16三条路由,下一跳指向企业路由器。

缺省值:false

state

String

VPC连接状态:pending|available|modifying|deleting|deleted|failed|initiating_request|rejected|pending_acceptance|freezed

created_at

String

创建时间,格式:YYYY-MM-DDTHH:mm:ss.sssZ

updated_at

String

更新时间,格式:YYYY-MM-DDTHH:mm:ss.sssZ

tags

Array of Tag objects

标签信息

description

String

VPC连接描述信息

project_id

String

项目ID

vpc_project_id

String

vpc所属项目ID

表6 Tag

参数

参数类型

描述

key

String

标签键,规则:

  • 可用 UTF-8 格式表示的字母(包含中文)、数字和空格,以及字符:下划线“_”,点“.”,冒号“:”,等号“=”,加号“+”,中划线“-”,“@”。

  • _sys_开头属于系统标签,租户不能输入。

  • 标签key不能为空(长度不能为0)。

  • 长度在1-128之间。

最小长度:1

最大长度:128

value

String

标签值,规则:

  • 可用 UTF-8 格式表示的字母(包含中文)、数字和空格,以及字符:下划线“_”,点“.”,冒号“:”,等号“=”,加号“+”,中划线“-”,“@”。

  • 资源标签值可以为空(empty or null)。

  • 长度在0-255之间。

最小长度:0

最大长度:255

请求示例

更新VPC连接的信息,修改连接名称为“new-vpc-attach”

PUT https://{erouter_endpoint}/v3/08d5a9564a704afda6039ae2babbef3c/enterprise-router/f1a28dfd-186f-4625-b6b1-f05e5e8609c0/vpc-attachments/3b9724e9-49ec-4d21-9191-3d703133b910

{
  "vpc_attachment" : {
    "name" : "new-vpc-attach"
  }
}

响应示例

状态码: 200

OK

{
  "vpc_attachment" : {
    "id" : "3b9724e9-49ec-4d21-9191-3d703133b910",
    "name" : "new-vpc-attach",
    "vpc_id" : "b715e131-3371-4e17-a2de-4f669e24439a",
    "virsubnet_id" : "aacdc21d-90f9-45ef-ab48-80ec1bbe15b8",
    "auto_create_vpc_routes" : false,
    "project_id" : "08d5a9564a704afda6039ae2babbef3c",
    "state" : "available",
    "created_at" : "2020-03-11T15:13:31Z",
    "updated_at" : "2020-03-11T15:13:31Z"
  },
  "request_id" : "915a14a6-867b-4af7-83d1-70efceb146f9"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码