文档首页/ 云专线 DC/ API参考 (巴黎) / API/ 链路聚合组/ 创建链路聚合组
更新时间：2024-07-25 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建链路聚合组

功能介绍

创建链路聚合组实例，在创建之前需要申请物理连接资源

调用方法

请参见如何调用API。

URI

POST /v3/{project_id}/dcaas/link-aggregation-groups

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。 获取Token，请参考《统一身份认证服务API参考》的“获取用户Token”章节。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

最小长度：0

最大长度：10240
表3 请求Body参数

参数

是否必选

参数类型

描述

link_aggregation_group

否

CreateLinkAggregationGroup object

链路聚合组请求对象
表4 CreateLinkAggregationGroup

参数

是否必选

参数类型

描述

tenant_id

否

String

归属的租户的项目ID

name

否

String

链路聚合组的名字

最小长度：0

最大长度：64

description

否

String

链路聚合组的描述信息

最小长度：0

最大长度：128

region_id

否

String

链路聚合组归属的区域ID

work_mode

是

String

链路聚合组的协商模式,如果选择Manual，则对端需配置为手工负载模式，如果选择Static，两端通过LACP协议协商

枚举值：

  • Manual
  • Static

min_up_num

否

Integer

链路聚合组的活动的链路数的下限阈值，当前活动物理连接链路数目小于下限阈值时，链路聚合组的状态转为Down

最小长度：1

最大长度：16

admin_state_up

否

Boolean

链路聚合组的管理状态

direct_connect_ids

是

Array of strings

添加到链路聚合组物理连接的ID列表

ies_id

否

String

链路聚合组归属的IES站点的ID，非IES站点ID不指定该参数

enterprise_project_id

否

String

链路聚合组归属的企业项目ID

tags

否

Array of Tag objects

标签列表
表5 Tag

参数

是否必选

参数类型

描述

响应参数

状态码： 201

表6 响应Body参数

参数

参数类型

描述

request_id

String

请求ID

link_aggregation_group

LinkAggregationGroup object

链路聚合组对象
表7 LinkAggregationGroup

参数

参数类型

描述

id

String

链路聚合组的ID

tenant_id

String

归属的租户的项目ID

name

String

链路聚合组的名字

最小长度：0

最大长度：64

description

String

链路聚合组的描述信息

最小长度：0

最大长度：128

work_mode

String

链路聚合组的协商模式,手工模式和LACP模式

枚举值：

  • Manual
  • Static

min_up_num

Integer

链路聚合组的活动的链路数的下限阈值，当前活动物理连接链路数目小于下限阈值时，链路聚合组的状态转为Down

最小长度：1

最大长度：16

device_id

String

链路聚合组归属的设备ID

status

String

链路聚合组的状态

admin_state_up

Boolean

链路聚合组的管理状态

enterprise_project_id

String

链路聚合组归属的企业项目ID

apply_time

String

链路聚合组申请时间。采用UTC时间格式，格式为：yyyy-MM-ddTHH:mm:ss.SSSZ

create_time

String

链路聚合组申请时间。采用UTC时间格式，格式为：yyyy-MM-ddTHH:mm:ss.SSSZ

delete_time

String

链路聚合组删除时间

public_border_group

String

链路聚合组归属的可用区对应的边界组(public border group)

请求示例

创建一个链路聚合组，活动链路下限阈值设置为1，协商模式选择Static。

GET https://{dc_endpoint}/v3/6fbe9263116a4b68818cf1edce16bc4f/dcaas/link-aggregation-groups

{
  "link_aggregation_group" : {
    "name" : "Lag01-02",
    "description" : "to idc1",
    "min_up_num" : 1,
    "work_mode" : "Static",
    "direct_connect_ids" : [ "6ecd9cf3-ca64-46c7-863f-f2eb1b9e838a" ]
  }
}

响应示例

状态码： 201

Created

{
  "request_id" : "9a4f4dfc4fb2fc101e65bba07d908535",
  "link_aggregation_group" : {
    "id" : "a7c5ce8a-62a8-433e-94af-d1894effce59",
    "name" : "Lag01-02",
    "description" : "to idc1",
    "tenant_id" : "ed28c294165741faaeccab26913122a1",
    "min_up_num" : 1,
    "enterprise_project_id" : 0,
    "work_mode" : "Static",
    "device_id" : "26.151.63.100",
    "status" : "DOWN",
    "admin_state_up" : null,
    "public_border_group" : null,
    "apply_time" : "2023-06-14T07:29:25.000Z",
    "create_time" : "2023-06-14T07:29:25.000Z"
  }
}

状态码

状态码

描述

201

Created

错误码

请参见错误码。

父主题： 链路聚合组