文档首页/企业路由器 ER/API参考（安卡拉区域）/API/VPC连接/创建VPC连接
更新时间：2024-12-27 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建VPC连接

功能介绍

给ER实例创建VPC连接。

调用方法

请参见如何调用API。

URI

POST /v3/{project_id}/enterprise-router/{er_id}/vpc-attachments

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

er_id

是

String

企业路由器实例ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Client-Token

否

String

幂等性标识

最小长度：1

最大长度：64

表3 请求Body参数

参数

是否必选

参数类型

描述

vpc_attachment

是

VpcAttachmentCreateRequest object

VPC类型连接

表4 VpcAttachmentCreateRequest

参数

是否必选

参数类型

描述

vpc_id

是

String

VPC的id，取值范围：最大长度36字节，带“-”连字符的UUID格式

name

是

String

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

最小长度：1

最大长度：64

virsubnet_id

是

String

VPC子网id，取值范围：最大长度36字节，带“-”连字符的UUID格式

description

否

String

描述信息，取值范围：0-255个字符，不能包含“<”和“>”

最小长度：0

最大长度：255

auto_create_vpc_routes

否

Boolean

默认为false，为true表示自动为vpc配置指向企业路由器的路由

缺省值：false

tags

否

Array of Tag objects

标签信息

表5 Tag

参数

是否必选

参数类型

描述

key

否

String

标签键，规则：

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

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

  • 标签key不能为空（长度不能为0）。

  • 长度在1-128之间。

最小长度：1

最大长度：128

value

否

String

标签值，规则：

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

  • 资源标签值可以为空（empty or null）。

  • 长度在0-255之间。

最小长度：0

最大长度：255

响应参数

状态码： 202

表6 响应Header参数

参数

参数类型

描述

X-Client-Token

String

幂等性标识

表7 响应Body参数

参数

参数类型

描述

vpc_attachment

VpcAttachmentDetails object

VPC类型连接

request_id

String

请求id

表8 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|invalid

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

route_synchronization

RouteSynchronization object

路由同步配置

表9 Tag

参数

参数类型

描述

key

String

标签键，规则：

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

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

  • 标签key不能为空（长度不能为0）。

  • 长度在1-128之间。

最小长度：1

最大长度：128

value

String

标签值，规则：

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

  • 资源标签值可以为空（empty or null）。

  • 长度在0-255之间。

最小长度：0

最大长度：255

表10 RouteSynchronization

参数

参数类型

描述

route_synchronization_enable

Boolean

路由同步开关

vpc_route_table_type

String

需要同步的VPC路由表

route_type

String

需要同步的路由类型

conflict_policy

String

冲突策略 目标地址相同并指向当前实例的路由执行的发布策略

请求示例

创建一个VPC连接，名称为“vpc-atta”，并指定连接的VPC和子网资源

POST https://{erouter_endpoint}/v3/08d5a9564a704afda6039ae2babbef3c/enterprise-router/4ab54142-7c92-48ad-8288-77727a231052/vpc-attachments

{
  "vpc_attachment" : {
    "name" : "vpc-atta",
    "vpc_id" : "b715e131-3371-4e17-a2de-4f669e24439a",
    "virsubnet_id" : "aacdc21d-90f9-45ef-ab48-80ec1bbe15b8"
  }
}

响应示例

状态码： 202

Accepted

{
  "vpc_attachment" : {
    "id" : "6f83b848-8331-4271-ac0c-ef94b7686402",
    "name" : "vpc-atta",
    "vpc_id" : "b715e131-3371-4e17-a2de-4f669e24439a",
    "virsubnet_id" : "aacdc21d-90f9-45ef-ab48-80ec1bbe15b8",
    "project_id" : "08d5a9564a704afda6039ae2babbef3c",
    "state" : "pending",
    "auto_create_vpc_routes" : false,
    "created_at" : "2020-03-11T15:13:31Z",
    "updated_at" : "2020-03-11T15:13:31Z"
  },
  "request_id" : "915a14a6-867b-4af7-83d1-70efceb146f9"
}

状态码

状态码

描述

202

Accepted

错误码

请参见错误码。

父主题：VPC连接