云服务器内容精选

  • 响应示例 返回状态码为200:修改NTP成功,响应体参考NtpResponse。 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" : "", "success" : [ { "tnpId" : "b09a0266-f34e-125d-ce23-ad1278b6c590", "vpnId" : "b09a0266-f34e-125d-ce23-ad1278b6c590", "deviceId" : "a99f794e-b510-438c-a75d-de59f02347eb", "sourceInterfaceId" : "LoopBack610", "ntpInfo" : { "id" : "00000000-0000-0000-0000-000000000000", "ntpType" : "IPv6", "preferEn" : false, "serverIP" : "fc00:3::1", "authentication" : false, "mode" : "HMAC-SHA256", "authKey" : "******", "authId" : 10 } } ], "fail" : [ { "errcode" : "0", "errmsg" : "", "data" : { "tnpId" : "b09a0266-f34e-125d-ce23-ad1278b6c590", "vpnId" : "b09a0266-f34e-125d-ce23-ad1278b6c590", "deviceId" : "a99f794e-b510-438c-a75d-de59f02347eb", "sourceInterfaceId" : "LoopBack610", "ntpInfo" : { "id" : "00000000-0000-0000-0000-000000000000", "ntpType" : "IPv6", "preferEn" : false, "serverIP" : "fc00:3::1", "authentication" : false, "mode" : "HMAC-SHA256", "authKey" : "******", "authId" : 10 } } } ] } 返回状态码为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:修改NTP成功,响应体参考NtpResponse。 表5 NtpResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" success ARRAY_REFERENCE 0-10个列表项,详细请参见表4。 成功的NTP信息列表。 - fail ARRAY_REFERENCE 0-10个列表项,详细请参见表6。 失败的NTP信息列表。 - 表6 FailNtpInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" data REFERENCE 详细请参见表4。 - - 返回状态码为400:校验异常。 详细信息请参见实际响应消息体。 返回状态码为500:内部错误。 详细信息请参见实际响应消息体。
  • 请求示例 HTTP的示例 PUT /controller/campus/v1/sdwan/net/ntp 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 { "siteId" : "a99f794e-b510-438c-a75d-de59f02347eb", "enableServerAuthentication" : true, "authenKey" : "", "authKeyId" : "12", "enableAutoClient" : false, "ntps" : [ { "tnpId" : "b09a0266-f34e-125d-ce23-ad1278b6c590", "vpnId" : "b09a0266-f34e-125d-ce23-ad1278b6c590", "deviceId" : "a99f794e-b510-438c-a75d-de59f02347eb", "sourceInterfaceId" : "LoopBack610", "ntpInfo" : { "id" : "00000000-0000-0000-0000-000000000000", "ntpType" : "IPv6", "preferEn" : false, "serverIP" : "fc00:3::1", "authentication" : false, "mode" : "HMAC-SHA256", "authKey" : "******", "authId" : 10 } } ] }
  • 请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 ntpInfos 是 REFERENCE 详细请参见表2。 修改NTP对象。 - 表2 NtpInfos对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteId 否 uuid - - 站点ID,UUID格式。 "a99f794e-b510-438c-a75d-de59f02347eb" enableServerAuthentication 否 boolean true false - 是否开启server认证。只有站点角色为边缘站点和控制站点合设时支持开启。默认为false。 true authenKey 否 string 0~255个字符。 - 该字段可能包含敏感信息和个人数据,请妥善做好保护。 认证密码,enableServerAuthentication开启时必填。V300系列设备密码长度必须在6-255位,且必须满足复杂度,即必须包含特殊字符("`!@#$%^&()_+=-[]{},.;)、英文大写字母(A~Z)、英文小写字母(a~z)、数字(0~9)中的任意两种组合及以上。V600系列设备仅V600R021C00及之后版本设备的密码必须包含12-255个字符,并且必须包含以下内容:大写字母,小写字母,数字和特殊字符("`!@#$%^&()_+=-[]{},.;)。 - authKeyId 否 string 0~32个字符。 - authenKeyId。enableServerAuthentication开启时必填。范围0~32,不能与客户端模式中手工配置下的认证ID重复。 "12" enableAutoClient 否 boolean true false - 是否开启客户端跟随父站点。只有站点角色为边缘站点时支持开启,当开启开关后,无需再手工配置链路的TNP配置。默认为false。 false ntps 否 ARRAY_REFERENCE 0-256个列表项,详细请参见表3。 手工配置ntp详情 - 表3 ManualNtpInfo对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 tnpId 否 string 0~64个字符。 - TNP ID,UUID格式。 "b09a0266-f34e-125d-ce23-ad1278b6c590" vpnId 否 string 0~64个字符。 - overlay网络上的VPN ID,UUID格式。 "b09a0266-f34e-125d-ce23-ad1278b6c590" deviceId 否 uuid - - 设备ID,UUID格式。 "a99f794e-b510-438c-a75d-de59f02347eb" sourceInterfaceId 否 string 0~32个字符。 - NTP服务器部署在overlay网络时,client接入server的源接口 "LoopBack610" ntpInfo 否 REFERENCE 详细请参见表4。 - - 表4 NtpInfo对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 id 否 uuid - - NTP ID,uuid格式。 "00000000-0000-0000-0000-000000000000" ntpType 否 string 4个字符。 IPv4 NTP服务器地址类型,取值范围:IPv4、IPv6。 "IPv6" preferEn 否 boolean true false false 是否指定该远程服务器为优先选择的服务器。 false serverIP 是 string 0~39个字符。 - NTP服务器地址。当ntpType为IPv4,serverIp为IPv4地址,如:192.168.1.1;当ntpType为IPv6,serverIp为IPv6地址,如:fc00:3::1。 "fc00:3::1" authentication 是 boolean true false false 是否认证。 false mode 否 string 0~16个字符。 - 认证模式,取值范围:MD5、HMAC-SHA256。当authentication为true时,mode必填。V600版本设备不支持MD5。 "HMAC-SHA256" authKey 否 string 6~255个字符。 - 该字段可能包含敏感信息和个人数据,请妥善做好保护。 认证密码,当authentication为true时,authKey必填。V300系列设备密码长度必须在6-255位,且必须满足复杂度,即必须包含特殊字符("`!@#$%^&()_+=-[]{},.;)、英文大写字母(A~Z)、英文小写字母(a~z)、数字(0~9)中的任意两种组合及以上。V600系列设备仅V600R021C00及之后版本设备的密码必须包含12-255个字符,并且必须包含以下内容:大写字母,小写字母,数字和特殊字符("`!@#$%^&()_+=-[]{},.;)。建议密码长度配置在12位以上。 "******" authId 否 int64 - - 认证ID。取值范围:1-4294967295,其中V600版本设备在配置IPv6服务器时最大值为65535。当authentication为true时,authId必填。 10
  • 响应示例 返回状态码为200:查询NTP成功,响应体参考QueryNtpResponse。 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" : { "siteId" : "a99f794e-b510-438c-a75d-de59f02347eb", "enableServerAuthentication" : true, "authenKey" : "", "authKeyId" : "12", "enableAutoClient" : false, "ntps" : [ { "tnpId" : "b09a0266-f34e-125d-ce23-ad1278b6c590", "vpnId" : "b09a0266-f34e-125d-ce23-ad1278b6c590", "deviceId" : "a99f794e-b510-438c-a75d-de59f02347eb", "sourceInterfaceId" : "LoopBack610", "ntpInfo" : { "id" : "00000000-0000-0000-0000-000000000000", "ntpType" : "IPv6", "preferEn" : false, "serverIP" : "fc00:3::1", "authentication" : false, "mode" : "HMAC-SHA256", "authKey" : "******", "authId" : 10 } } ] } } 返回状态码为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:查询NTP成功,响应体参考QueryNtpResponse。 表2 QueryNtpResponse对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" data REFERENCE 详细请参见表3。 - - 表3 NtpInfos对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 siteId uuid - - 站点ID,UUID格式。 "a99f794e-b510-438c-a75d-de59f02347eb" enableServerAuthentication boolean true false - 是否开启server认证。只有站点角色为边缘站点和控制站点合设时支持开启。默认为false。 true authenKey string 0~255个字符。 - 该字段可能包含敏感信息和个人数据,请妥善做好保护。 认证密码,enableServerAuthentication开启时必填。V300系列设备密码长度必须在6-255位,且必须满足复杂度,即必须包含特殊字符("`!@#$%^&()_+=-[]{},.;)、英文大写字母(A~Z)、英文小写字母(a~z)、数字(0~9)中的任意两种组合及以上。V600系列设备仅V600R021C00及之后版本设备的密码必须包含12-255个字符,并且必须包含以下内容:大写字母,小写字母,数字和特殊字符("`!@#$%^&()_+=-[]{},.;)。 - authKeyId string 0~32个字符。 - authenKeyId。enableServerAuthentication开启时必填。范围0~32,不能与客户端模式中手工配置下的认证ID重复。 "12" enableAutoClient boolean true false - 是否开启客户端跟随父站点。只有站点角色为边缘站点时支持开启,当开启开关后,无需再手工配置链路的TNP配置。默认为false。 false ntps ARRAY_REFERENCE 0-256个列表项,详细请参见表4。 手工配置ntp详情 - 表4 ManualNtpInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 tnpId string 0~64个字符。 - TNP ID,UUID格式。 "b09a0266-f34e-125d-ce23-ad1278b6c590" vpnId string 0~64个字符。 - overlay网络上的VPN ID,UUID格式。 "b09a0266-f34e-125d-ce23-ad1278b6c590" deviceId uuid - - 设备ID,UUID格式。 "a99f794e-b510-438c-a75d-de59f02347eb" sourceInterfaceId string 0~32个字符。 - NTP服务器部署在overlay网络时,client接入server的源接口 "LoopBack610" ntpInfo REFERENCE 详细请参见表5。 - - 表5 NtpInfo对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id uuid - - NTP ID,uuid格式。 "00000000-0000-0000-0000-000000000000" ntpType string 4个字符。 IPv4 NTP服务器地址类型,取值范围:IPv4、IPv6。 "IPv6" preferEn boolean true false false 是否指定该远程服务器为优先选择的服务器。 false serverIP string 0~39个字符。 - NTP服务器地址。当ntpType为IPv4,serverIp为IPv4地址,如:192.168.1.1;当ntpType为IPv6,serverIp为IPv6地址,如:fc00:3::1。 "fc00:3::1" authentication boolean true false false 是否认证。 false mode string 0~16个字符。 - 认证模式,取值范围:MD5、HMAC-SHA256。当authentication为true时,mode必填。V600版本设备不支持MD5。 "HMAC-SHA256" authKey string 6~255个字符。 - 该字段可能包含敏感信息和个人数据,请妥善做好保护。 认证密码,当authentication为true时,authKey必填。V300系列设备密码长度必须在6-255位,且必须满足复杂度,即必须包含特殊字符("`!@#$%^&()_+=-[]{},.;)、英文大写字母(A~Z)、英文小写字母(a~z)、数字(0~9)中的任意两种组合及以上。V600系列设备仅V600R021C00及之后版本设备的密码必须包含12-255个字符,并且必须包含以下内容:大写字母,小写字母,数字和特殊字符("`!@#$%^&()_+=-[]{},.;)。建议密码长度配置在12位以上。 "******" authId int64 - - 认证ID。取值范围:1-4294967295,其中V600版本设备在配置IPv6服务器时最大值为65535。当authentication为true时,authId必填。 10 返回状态码为400:校验异常。 详细信息请参见实际响应消息体。 返回状态码为500:内部错误。 详细信息请参见实际响应消息体。
  • 请求示例 HTTP的示例 GET /controller/campus/v1/sdwan/net/ntp?siteId=a99f794e-b510-438c-a75d-de59f02347eb 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