云服务器内容精选

  • 响应示例 返回状态码为200:删除成功,返回结构体参见SiteTemplateDeleteAptunnelResponse。 HTTPS/1.1 200 OK Date: Thu,13 MAY 2023 10:00:00 GMT Server: example-server Content-Type: application/json { "errcode" : "0", "errmsg" : "", "success" : [ "00000000000000000000000000000000" ], "fail" : [ { "errcode" : "0123455", "errmsg" : "xxxxxxx", "data" : "00000000000000000000000000000001" } ] } 返回状态码为204:Success 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
  • URI /controller/campus/v3/networkconfig/site-templates/{siteTemplateId}/aptunnel 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteTemplateId 是 string 36个字符。 - 站点ID。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e"
  • 响应示例 返回状态码为200:修改成功 HTTP/1.1 200 OK 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 { "errcode" : "0", "errmsg" : "", "data" : { "networkOffPeriod" : 100 } } 返回状态码为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
  • 请求参数 表2 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 body 是 REFERENCE 详细请参见表3。 站点模板AP隧道全局配置参数体 - 表3 ApTunnelGlobalDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 networkOffPeriod 否 int64 [0-120] 0 主备隧道倒换用户接入间隔时间(单位:秒) 100
  • 请求示例 HTTP的示例 PUT /controller/campus/v3/networkconfig/site-templates/fbb684c8-0d37-496f-bafa-4b06d5151e2e/aptunnel-config HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-AC CES S-TOKEN: x-yyyyyy { "networkOffPeriod" : 100 }
  • URI /controller/campus/v3/networkconfig/site-templates/{siteTemplateId}/aptunnel-config 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteTemplateId 是 string 36个字符。 - 站点ID。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e"
  • 请求示例 HTTP的示例 { "id" : "00000000000000000000000000000000", "tunnelName" : "tunnel1", "masterTunnelIp" : "192.168.0.1", "slaveTunnelIp" : "192.168.0.2", "autoRestoreEnable" : true, "autoRestoreDelay" : 100, "vlanRanges" : "20,30-200,500", "dtlsType" : "disable", "backUpDtlsType" : "disable" }
  • 响应示例 返回状态码为200:修改成功,结构体参见SiteTemplateAptunnelResponseDto。 HTTPS/1.1 200 OK Date: Thu,13 MAY 2023 10:00:00 GMT Server: example-server Content-Type: application/json { "errcode" : "0", "errmsg" : "", "data" : [ { "id" : "00000000000000000000000000000000", "tunnelName" : "tunnel1", "masterTunnelIp" : "192.168.0.1", "slaveTunnelIp" : "192.168.0.2", "autoRestoreEnable" : true, "autoRestoreDelay" : 100, "vlanRanges" : "20,30-200,500", "dtlsType" : "disable", "backUpDtlsType" : "disable" } ] }
  • 请求参数 表2 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 ApTunnelDto 是 REFERENCE 详细请参见表3。 站点模板AP隧道配置参数,结构体参见ApTunnelDto。 - 表3 ApTunnelDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 id 否 string 32个字符。 - 隧道ID。 "00000000000000000000000000000000" tunnelName 是 string 1~35个字符。 - 隧道名称。取值范围:1~35个半角字符,不能以双引号开头或结尾且不能包含空格和问号。不支持修改。 "tunnel1" masterTunnelIp 是 string 7~15个字符。 - 主隧道IP。 "192.168.0.1" slaveTunnelIp 否 string 7~15个字符。 - 备隧道IP。 "192.168.0.2" autoRestoreEnable 否 boolean true false false 自动恢复。默认值为false。 true autoRestoreDelay 否 int32 [60-600] - 自动恢复延时。 100 vlanRanges 是 string 1~100个字符。 - 2-4094范围内的整数或段,多个整数或段间用“,”分割,最多可输入10组。且配置的隧道VLAN不能与管理VLAN相同,否则隧道VLAN不生效。 "20,30-200,500" dtlsType 否 string 1~20个字符。满足正则表达disable|psk|mandatory-cert。 - 主隧道传输层数据包安全协议。取值范围:disable---不配置、psk---秘钥、mandatory-cert---证书。 "disable" securityKey 否 password 1~64个字符。 - 该字段可能包含敏感信息和个人数据,请妥善做好保护。 主隧道认证秘钥,当传输层数据包安全协议选择psk时生效。取值范围:8~32个字符,至少包含大写字母、小写字母、数字或特殊字符中的两种,不能包含问号和空格。 "tunnelkey" backUpDtlsType 否 string 1~20个字符。满足正则表达disable|psk|mandatory-cert。 - 备隧道传输层数据包安全协议。取值范围:disable---不配置、psk---秘钥、mandatory-cert---证书。 "disable" backUpSecurityKey 否 password 1~64个字符。 - 该字段可能包含敏感信息和个人数据,请妥善做好保护。 备隧道认证秘钥,当传输层数据包安全协议选择psk时生效。取值范围:8~32个字符,至少包含大写字母、小写字母、数字或特殊字符中的两种,不能包含问号和空格。 "tunnelkey" backUpKeyInvalid 否 boolean true false false 备用密钥是否有效。默认值为false。 true keyInvalid 否 boolean true false false 主密钥是否有效。默认值为false。 true isForceOverride 否 boolean true false false 是否强制覆盖。默认为false。 true
  • URI /controller/campus/v3/networkconfig/site-templates/{siteTemplateId}/aptunnel 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteTemplateId 是 string 36个字符。 - 站点ID。 "fbb684c8-0d37-496f-bafa-4b06d5151e2e"
  • 响应示例 返回状态码为200:创建成功,返回结构体参见SiteTemplateAptunnelResponseDto。 HTTPS/1.1 200 OK Date: Thu,13 MAY 2023 10:00:00 GMT Server: example-server Content-Type: application/json { "errcode" : "0", "errmsg" : "", "data" : [ { "id" : "00000000000000000000000000000000", "tunnelName" : "tunnel1", "masterTunnelIp" : "192.168.0.1", "slaveTunnelIp" : "192.168.0.2", "autoRestoreEnable" : true, "autoRestoreDelay" : 100, "vlanRanges" : "20,30-200,500", "dtlsType" : "disable", "backUpDtlsType" : "disable" } ] } 返回状态码为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:创建成功,返回结构体参见SiteTemplateAptunnelResponseDto。 表4 SiteTemplateAptunnelResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 0~64个字符。 - 错误码。 "0" errmsg string 0~256个字符。 - 错误信息。 "" data ARRAY_REFERENCE 0-8个列表项,详细请参见表5。 站点模板AP隧道配置信息,结构体参见AptunnelResponseDto。 - 表5 AptunnelResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id string 32个字符。 - 隧道ID。 "00000000000000000000000000000000" tunnelName string 1~35个字符。 - 隧道名称。取值范围:1~35个半角字符,不能以双引号开头或结尾且不能包含空格和问号。不支持修改。 "tunnel1" masterTunnelIp string 7~15个字符。 - 主隧道IP。 "192.168.0.1" slaveTunnelIp string 7~15个字符。 - 备隧道IP。 "192.168.0.2" autoRestoreEnable boolean true false false 自动恢复。默认值为false。 true autoRestoreDelay int32 [60-600] - 自动恢复延时。 100 vlanRanges string 1~100个字符。 - 2-4094范围内的整数或段,多个整数或段间用“,”分割,最多可输入10组。且配置的隧道VLAN不能与管理VLAN相同,否则隧道VLAN不生效。 "20,30-200,500" dtlsType string 1~20个字符。 disable psk mandatory-cert - 主隧道传输层数据包安全协议。取值范围:disable---不配置、psk---秘钥、mandatory-cert---证书。 "disable" backUpDtlsType string 1~20个字符。 disable psk mandatory-cert - 备隧道传输层数据包安全协议。取值范围:disable---不配置、psk---秘钥、mandatory-cert---证书。 "disable" backUpKeyInvalid boolean true false false 备用密钥是否有效。默认值为false。 true keyInvalid boolean true false false 主密钥是否有效。默认值为false。 true 返回状态码为400:校验异常。 详细信息请参见实际响应消息体。 返回状态码为500:内部服务错误。 详细信息请参见实际响应消息体。
  • 请求示例 HTTP的示例 { "tunnelName" : "tunnel1", "masterTunnelIp" : "192.168.0.1", "slaveTunnelIp" : "192.168.0.2", "autoRestoreEnable" : true, "autoRestoreDelay" : 100, "vlanRanges" : "20,30-200,500", "dtlsType" : "disable", "backUpDtlsType" : "disable" }
  • 请求参数 表2 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 ApTunnelCreateDto 是 REFERENCE 详细请参见表3。 站点模板AP隧道配置参数,结构体参见ApTunnelCreateDto - 表3 ApTunnelCreateDto对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 tunnelName 是 string 1~35个字符。 - 隧道名称。取值范围:1~35个半角字符,不能以双引号开头或结尾且不能包含空格和问号。不支持修改。 "tunnel1" masterTunnelIp 是 string 7~15个字符。 - 主隧道IP。 "192.168.0.1" slaveTunnelIp 否 string 7~15个字符。 - 备隧道IP。 "192.168.0.2" autoRestoreEnable 否 boolean true false false 自动恢复。默认值为false。 true autoRestoreDelay 否 int32 [60-600] - 自动恢复延时。 100 vlanRanges 是 string 1~100个字符。 - 2-4094范围内的整数或段,多个整数或段间用“,”分割,最多可输入10组。且配置的隧道VLAN不能与管理VLAN相同,否则隧道VLAN不生效。 "20,30-200,500" dtlsType 否 string 1~20个字符。满足正则表达disable|psk|mandatory-cert。 - 主隧道传输层数据包安全协议。取值范围:disable---不配置、psk---秘钥、mandatory-cert---证书。 "disable" securityKey 否 password 1~64个字符。 - 该字段可能包含敏感信息和个人数据,请妥善做好保护。 主隧道认证秘钥,当传输层数据包安全协议选择psk时生效。取值范围:8~32个字符,至少包含大写字母、小写字母、数字或特殊字符中的两种,不能包含问号和空格。 "tunnelkey" backUpDtlsType 否 string 1~20个字符。满足正则表达disable|psk|mandatory-cert。 - 备隧道传输层数据包安全协议。取值范围:disable---不配置、psk---秘钥、mandatory-cert---证书。 "disable" backUpSecurityKey 否 password 1~64个字符。 - 该字段可能包含敏感信息和个人数据,请妥善做好保护。 备隧道认证秘钥,当传输层数据包安全协议选择psk时生效。取值范围:8~32个字符,至少包含大写字母、小写字母、数字或特殊字符中的两种,不能包含问号和空格。 "tunnelkey" backUpKeyInvalid 否 boolean true false false 备用密钥是否有效。默认值为false。 true keyInvalid 否 boolean true false false 主密钥是否有效。默认值为false。 true
  • URI /controller/campus/v3/networkconfig/site-templates/{siteTemplateId}/aptunnel 表1 path参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteTemplateId 是 string 36个字符。 - 站点模板标识,UUID格式。 "fbde1c5d-5b94-49e3-a912-48641015e45c"