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

更新链路聚合组

功能介绍

更新端口聚合组的内容，包括名字和描述

调用方法

请参见如何调用API。

URI

PUT /v3/{project_id}/dcaas/link-aggregation-groups/{dc_lag_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户项目ID

dc_lag_id

是

String

链路聚合组资源ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

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

最小长度：0

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

参数

是否必选

参数类型

描述

link_aggregation_group

否

UpdateLinkAggregationGroup object

更新链路聚合组对象
表4 UpdateLinkAggregationGroup

参数

是否必选

参数类型

描述

name

否

String

链路聚合组的名字

最小长度：0

最大长度：64

description

否

String

链路聚合组的描述信息

最小长度：0

最大长度：128

min_up_num

否

Integer

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

最小长度：1

最大长度：16

associate_dc

否

Array of strings

需要增加到链路聚合组物理连接ID列表

disassociate_dc

否

Array of strings

需要从链路聚合组中删除物理连接ID列表

响应参数

状态码： 200

表5 响应Body参数

参数

参数类型

描述

request_id

String

请求ID

link_aggregation_group

LinkAggregationGroup object

链路聚合组对象
表6 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)

请求示例

更新链路聚合组的名称和描述信息。

PUT https://{dc_endpoint}/v3/6fbe9263116a4b68818cf1edce16bc4f/dcaas/link-aggregation-groups/a7c5ce8a-62a8-433e-94af-d1894effce59

{
  "link_aggregation_group" : {
    "name" : "Lag01-02",
    "description" : "to idc1"
  }
}

响应示例

状态码： 200

OK

{
  "request_id" : "9a4f4dfc4fb2fc101e65bba07d908535",
  "link_aggregation_group" : {
    "id" : "a7c5ce8a-62a8-433e-94af-d1894effce59",
    "name" : "Lag02-02",
    "description" : "to bj1",
    "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"
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 链路聚合组