云服务器内容精选

  • 请求示例 HTTP的示例 POST /v1/netcfg/sites/dfs-groups/13874933-09ae-cfff-9883-bcaa33422118/m-lags HTTPS 1.1 Host:192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-AC CES S-TOKEN:CA48D152F6B19D84:637C38259E6974E17788348128A430FEE150E874752CE754B6BF855281219925 { "dfsGroupName": "MLAG01", "mode": "active-active", "peerLink": [ { "deviceId": "cfff4933-39aa-cfaf-9833-bcaa13874933", "deviceName": "device1", "ifName": "Eth-Trunk1", "priority": 150, "peerDeviceId": "09ae4933-196e-cfef-9183-bcaa13874a3c", "peerDeviceName": "device2", "peerIfName": "Eth-Trunk1", "peerPriority": 100 }], "mLagMemberList": [ { "mLagId": "1", "mLagMemberlink": { "deviceId": "cfff4933-39aa-cfaf-9833-bcaa13874933", "deviceName": "device1", "ifName": "Eth-Trunk2", "peerDeviceId": "09ae4933-196e-cfef-9183-bcaa13874a3c", "peerDeviceName": "device2", "peerIfName": "Eth-Trunk2", } }] }
  • 响应示例 返回状态码为204:初始化配置成功 HTTP/1.1 204 No Content Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为400:参数校验异常 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500:服务内部错误。 HTTP/1.1 500 Internal Server Error Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive
  • 请求参数 表2 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 mlagConfiguration 是 REFERENCE 详细请参见表3。 Dfs-Group、Peer-Link以及成员口相关的配置 - 表3 MlagConfigration对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 dfsGroupName 否 string 0~64个字符。满足正则表达^[a-zA-Z0-9_.@-]+$。 - Dfs-Group组名称。 "dfsGroup1" mode 否 string 0~14个字符。满足正则表达active-standby|active-active。 active-active Dfs-Group组级别的工作模式,可不填,默认双活模式, 可指定主备模式。 "active-active" dualActiveDetectLink 否 REFERENCE 详细请参见表4。 配置双主检测链路。 - peerLink 否 ARRAY_REFERENCE 0-1个列表项,详细请参见表5。 为Dfs-Group指定的Peer-Link链路,仅能指定一条 - mLagMemberList 否 ARRAY_REFERENCE 0-1024个列表项,详细请参见表6。 成员列表。 - 表4 DualActiveDetectLink对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceId 否 string 0~36个字符。 - 设备ID,uuid格式。 "fbde1c5d-5b94-49e3-a912-48641015e45c" deviceName 否 string 0~64个字符。 - 本端设备名称。 "fw1" ifName 否 string 0~64个字符。 - 双主检测本端接口名称,物理口,非Eth-Trunk口。 "10GE 1/0/7" peerDeviceId 否 string 0~36个字符。 - 设备ID,uuid格式。 "fbde1c5d-5b94-49e3-a912-48641015e45d" peerDeviceName 否 string 0~64个字符。 - 对端设备名称。 "fw2" peerIfName 否 string 0~64个字符。 - 双主检测对端接口名称,物理口,非Eth-Trunk口。 "10GE 1/0/7" ipPoolName 否 string 0~32个字符。 - 为接口分配IP地址的资源池名称。 "CoreIpPool" 表5 MlagLinkDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 deviceId 否 string 0~36个字符。 - 设备ID,uuid格式。 "fbde1c5d-5b94-49e3-a912-48641015e45c" deviceName 否 string 0~64个字符。 - 设备名称。 "fw1" ifName 否 string 0~64个字符。 - 设备名称。 "fw1" priority 否 int32 [1-254] 150 本端设备优先级。 100 peerDeviceId 否 string 0~36个字符。 - 设备ID,uuid格式。 "fbde1c5d-5b94-49e3-a912-48641015e45c" peerDeviceName 否 string 0~64个字符。 - 设备名称。 "fw1" peerIfName 否 string 0~64个字符。 - 设备名称。 "fw1" peerPriority 否 int32 [1-254] 100 对端设备优先级。 100 表6 MlagMembersDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 mLagId 否 string 0~36个字符。 - M-LAG的组id。 "1" mLagMemberlink 否 REFERENCE 详细请参见表5。 M-LAG的成员链路。 -
  • 响应示例 返回状态码为200:查询单个设备上M-LAG配置以及Peer-Link、成员口信息 { "currentMLag": { "dfsGroupId": "1", "dfsGroupName": "MLAG01", "mode": "active-standby", "peerLink": [{ "deviceId": "cfff4933-39aa-cfaf-9833-bcaa13874933", "deviceName": "device1", "ifName": "Eth-Trunk1", "priority": 150, "peerDeviceId": "09ae4933-196e-cfef-9183-bcaa13874a3c", "peerDeviceName": "device2", "peerIfName": "Eth-Trunk1", "peerPriority": 100 }], "mLagMemberList": [ { "mLagId": "1", "mLagMemberlink": { "deviceId": "cfff4933-39aa-cfaf-9833-bcaa13874933", "deviceName": "device1", "ifName": "Eth-Trunk2", "peerDeviceId": "09ae4933-196e-cfef-9183-bcaa13874a3c", "peerDeviceName": "device2", "peerIfName": "Eth-Trunk2", } } ] }, "peerLinks": [ { "deviceId": "cfff4933-39aa-cfaf-9833-bcaa13874933", "deviceName": "device1", "ifName": "Eth-Trunk4", "peerDeviceId": "09ae4933-196e-cfef-9183-bcaa13874a3c", "peerDeviceName": "device2", "peerIfName": "Eth-Trunk4" },{ "deviceId": "cfff4933-39aa-cfaf-9833-bcaa13874933", "deviceName": "device1", "ifName": "Eth-Trunk5", "peerDeviceId": "09ae4933-196e-cfef-9183-bcaa13874a3c", "peerDeviceName": "device2", "peerIfName": "Eth-Trunk5" } ], "localPorts": [ { "ifName": "Eth-Trunk1" },{ "ifName": "Eth-Trunk2" },{ "ifName": "Eth-Trunk3" },{ "ifName": "Eth-Trunk4" },{ "ifName": "Eth-Trunk5" },{ "ifName": "Eth-Trunk6" },{ "ifName": "Eth-Trunk7" } ], "peerPorts": [ { "ifName": "Eth-Trunk1" },{ "ifName": "Eth-Trunk2" },{ "ifName": "Eth-Trunk3" },{ "ifName": "Eth-Trunk4" },{ "ifName": "Eth-Trunk5" },{ "ifName": "Eth-Trunk6" },{ "ifName": "Eth-Trunk7" } ] } 返回状态码为400:参数校验异常 HTTP/1.1 400 Bad Request Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive 返回状态码为500:服务内部错误 HTTP/1.1 500 Internal Server Error Date: Sun,16 Feb 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive
  • 响应参数 返回状态码为200:查询单个设备上M-LAG配置以及Peer-Link、成员口信息 表2 QueryMLagInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 currentMLag REFERENCE 详细请参见表3。 当前的M-LAG配置信息 - peerLinks ARRAY_REFERENCE 0-1个列表项,详细请参见表6。 成员设备间的Trunk链路列表 - localPorts ARRAY_REFERENCE 0-1024个列表项,详细请参见表7。 Eth-Trunk接口。 - localPortsForPeerLink ARRAY_REFERENCE 0-1024个列表项,详细请参见表7。 Eth-Trunk接口。 - peerPorts ARRAY_REFERENCE 0-1024个列表项,详细请参见表7。 Eth-Trunk接口。 - peerPortsForPeerLink ARRAY_REFERENCE 0-1024个列表项,详细请参见表7。 Eth-Trunk接口。 - 表3 MlagConfigration对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 dfsGroupName string 0~64个字符。满足正则表达^[a-zA-Z0-9_.@-]+$。 - Dfs-Group组名称。 "dfsGroup1" mode string 0~14个字符。满足正则表达active-standby|active-active。 active-active Dfs-Group组级别的工作模式,可不填,默认双活模式, 可指定主备模式。 "active-active" dualActiveDetectLink REFERENCE 详细请参见表4。 配置双主检测链路。 - peerLink ARRAY_REFERENCE 0-1个列表项,详细请参见表6。 为Dfs-Group指定的Peer-Link链路,仅能指定一条 - mLagMemberList ARRAY_REFERENCE 0-1024个列表项,详细请参见表5。 成员列表。 - 表4 DualActiveDetectLink对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 deviceId string 0~36个字符。 - 设备ID,uuid格式。 "fbde1c5d-5b94-49e3-a912-48641015e45c" deviceName string 0~64个字符。 - 本端设备名称。 "fw1" ifName string 0~64个字符。 - 双主检测本端接口名称,物理口,非Eth-Trunk口。 "10GE 1/0/7" peerDeviceId string 0~36个字符。 - 设备ID,uuid格式。 "fbde1c5d-5b94-49e3-a912-48641015e45d" peerDeviceName string 0~64个字符。 - 对端设备名称。 "fw2" peerIfName string 0~64个字符。 - 双主检测对端接口名称,物理口,非Eth-Trunk口。 "10GE 1/0/7" ipPoolName string 0~32个字符。 - 为接口分配IP地址的资源池名称。 "CoreIpPool" 表5 MlagMembersDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 mLagId string 0~36个字符。 - M-LAG的组id。 "1" mLagMemberlink REFERENCE 详细请参见表6。 M-LAG的成员链路。 - 表6 MlagLinkDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 deviceId string 0~36个字符。 - 设备ID,uuid格式。 "fbde1c5d-5b94-49e3-a912-48641015e45c" deviceName string 0~64个字符。 - 设备名称。 "fw1" ifName string 0~64个字符。 - 设备名称。 "fw1" priority int32 [1-254] 150 本端设备优先级。 100 peerDeviceId string 0~36个字符。 - 设备ID,uuid格式。 "fbde1c5d-5b94-49e3-a912-48641015e45c" peerDeviceName string 0~64个字符。 - 设备名称。 "fw1" peerIfName string 0~64个字符。 - 设备名称。 "fw1" peerPriority int32 [1-254] 100 对端设备优先级。 100 表7 Eth-TrunkIf对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 ifName string 0~64个字符。 - 接口名称。 "Eth-Trunk1" 返回状态码为400:参数校验异常 详细信息请参见实际响应消息体。 返回状态码为500:服务内部错误 详细信息请参见实际响应消息体。
  • 请求示例 HTTP的示例 GET /v1/netcfg/sites/dfs-groups/DBB702C3-7719-4FE6-A5AD-3A9C9E265309/m-lags HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy