云服务器内容精选

  • 响应示例 返回状态码为201:设置站点时区成功,响应体参考SiteApiResponse。 HTTP/1.1 201 Created 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" : [ "a99f794e-b510-438c-a75d-de59f02347eb" ], "fail" : [ { "errcode" : "0", "errmsg" : "", "data" : "a99f794e-b510-438c-a75d-de59f02347eb" } ], "processInstanceId" : "" } 返回状态码为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
  • 请求示例 HTTP的示例 PUT /controller/campus/v1/sdwan/net/site/timezone 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 { "siteTimeZones" : [ { "id" : "a99f794e-b510-438c-a75d-de59f02347eb", "timeZone" : "(UTC+08:00)Beijing,Chongqing,Hong Kong,Urumqi", "enableSummerConfig" : false, "enableAutoConfig" : true, "daylightSavingTime" : { "name" : "Atlantic/Canary", "offset" : "01:00", "enableWeekDay" : false, "startTime" : { "month" : "Jan", "time" : "23:59", "week" : "first", "weekday" : "Mon", "day" : 21 }, "stopTime" : { "month" : "Jan", "time" : "23:59", "week" : "first", "weekday" : "Mon", "day" : 21 } } } ] }
  • 请求参数 表1 body参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteTimeZones 是 REFERENCE 详细请参见表2。 修改时区信息列表。 - 表2 SiteTimeZones对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 siteTimeZones 否 ARRAY_REFERENCE 1-100个列表项,详细请参见表3。 - - 表3 SiteTimeZone对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 id 否 uuid - - 站点ID,格式为uuid。修改时必填。 "a99f794e-b510-438c-a75d-de59f02347eb" timeZone 否 string 0~255个字符。 - 时区信息。 "(UTC+08:00)Beijing,Chongqing,Hong Kong,Urumqi" enableSummerConfig 否 boolean true false - 是否开启夏令时。默认值为false。 false enableAutoConfig 否 boolean true false - 是否自动给设备下发夏令时时间,当enableAutoConfig为true时,daylightSavingTime必须为空,控制器会根据时区自动获取夏令时时间并下发给站点内的设备,否则daylightSavingTime必填。默认值为true。 true daylightSavingTime 否 REFERENCE 详细请参见表4。 - - 表4 DaylightSavingTime对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 name 是 string 1~32个字符。 - 时区名称。可配置为英文,数字,特殊字符,其中特殊字符包含:_-/。 "Atlantic/Canary" offset 是 string 1~5个字符。 - 相对零时区间隔,格式为HH:MM,取值范围00:01-02:00。 "01:00" enableWeekDay 是 boolean true false - 夏令时使能周期。当enableWeekDay为true时,startTime和stopTime中week和weekday必填;当enableWeekDay为false时,startTime和stopTime中day必填。默认值为false。 false startTime 是 REFERENCE 详细请参见表5。 夏令时开始时间。 {"month":"Jan","time":"05:00"} stopTime 是 REFERENCE 详细请参见表5。 夏令时结束时间。 {"month":"Jan","time":"05:00"} 表5 DaylightTime对象的参数列表 参数名称 必选 类型 参数值域 默认值 参数说明 参数示例 month 是 string Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec - 指定月份,取值范围为Jan(一月),Feb(二月),Mar(三月),Apr(四月),May(五月),Jun(六月),Jul(七月),Aug(八月),Sep(九月),Oct(十月),Nov(十一月),Dec(十二月)。 "Jan" time 是 string 5个字符。 - 指定时间,24小时制时间,格式为HH:MM。 "23:59" week 否 string 0~64个字符。 - 指定周,取值范围为first(月份起始的第一周),second(月份起始的第二周),third(月份起始的第三周),fourth(月份起始的第四周),fifth(月份起始的第五周),last(月份起始的最后一周)。 "first" weekday 否 string Mon Tue Wed Thu Fri Sat Sun - 指定工作日,取值范围为Mon(周一),Tue(周二),Wed(周三),Thu(周四),Fri(周五),Sat(周六),Sun(周日)。 "Mon" day 否 int16 [1-31] - 指定天,取值范围是1-31,2月只到28号。 21
  • 响应示例 返回状态码为200:查询站点成功,响应体参考QuerySiteTimeZoneRespons。 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" : "", "totalRecords" : 200, "pageSize" : 20, "pageIndex" : 1, "data" : [ { "id" : "a99f794e-b510-438c-a75d-de59f02347eb", "timeZone" : "(UTC+08:00)Beijing,Chongqing,Hong Kong,Urumqi", "enableSummerConfig" : false, "enableAutoConfig" : true, "daylightSavingTime" : { "name" : "Atlantic/Canary", "offset" : "01:00", "enableWeekDay" : false, "startTime" : { "month" : "Jan", "time" : "23:59", "week" : "first", "weekday" : "Mon", "day" : 21 }, "stopTime" : { "month" : "Jan", "time" : "23:59", "week" : "first", "weekday" : "Mon", "day" : 21 } } } ] } 返回状态码为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
  • 请求示例 HTTP的示例 GET /controller/campus/v1/sdwan/net/site/timezone?pageIndex=1&pageSize=20&sort=a99f794e-b510-438c-a75d-de59f02347eb&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
  • 响应参数 返回状态码为200:查询站点成功,响应体参考QuerySiteTimeZoneRespons。 表2 QuerySiteTimeZoneRespons对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string - - 错误码。 "0" errmsg string - - 错误信息。 "" totalRecords int32 - - 总的数据条数。 200 pageSize int32 - - 每页显示数量。 20 pageIndex int32 - - 当前页数。 1 data ARRAY_REFERENCE 0-1000个列表项,详细请参见表3。 Site信息。 - 表3 SiteTimeZone对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 id uuid - - 站点ID,格式为uuid。修改时必填。 "a99f794e-b510-438c-a75d-de59f02347eb" timeZone string 0~255个字符。 - 时区信息。 "(UTC+08:00)Beijing,Chongqing,Hong Kong,Urumqi" enableSummerConfig boolean true false - 是否开启夏令时。默认值为false。 false enableAutoConfig boolean true false - 是否自动给设备下发夏令时时间,当enableAutoConfig为true时,daylightSavingTime必须为空,控制器会根据时区自动获取夏令时时间并下发给站点内的设备,否则daylightSavingTime必填。默认值为true。 true daylightSavingTime REFERENCE 详细请参见表4。 - - 表4 DaylightSavingTime对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 name string 1~32个字符。 - 时区名称。可配置为英文,数字,特殊字符,其中特殊字符包含:_-/。 "Atlantic/Canary" offset string 1~5个字符。 - 相对零时区间隔,格式为HH:MM,取值范围00:01-02:00。 "01:00" enableWeekDay boolean true false - 夏令时使能周期。当enableWeekDay为true时,startTime和stopTime中week和weekday必填;当enableWeekDay为false时,startTime和stopTime中day必填。默认值为false。 false startTime REFERENCE 详细请参见表5。 夏令时开始时间。 {"month":"Jan","time":"05:00"} stopTime REFERENCE 详细请参见表5。 夏令时结束时间。 {"month":"Jan","time":"05:00"} 表5 DaylightTime对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 month string Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec - 指定月份,取值范围为Jan(一月),Feb(二月),Mar(三月),Apr(四月),May(五月),Jun(六月),Jul(七月),Aug(八月),Sep(九月),Oct(十月),Nov(十一月),Dec(十二月)。 "Jan" time string 5个字符。 - 指定时间,24小时制时间,格式为HH:MM。 "23:59" week string 0~64个字符。 - 指定周,取值范围为first(月份起始的第一周),second(月份起始的第二周),third(月份起始的第三周),fourth(月份起始的第四周),fifth(月份起始的第五周),last(月份起始的最后一周)。 "first" weekday string Mon Tue Wed Thu Fri Sat Sun - 指定工作日,取值范围为Mon(周一),Tue(周二),Wed(周三),Thu(周四),Fri(周五),Sat(周六),Sun(周日)。 "Mon" day int16 [1-31] - 指定天,取值范围是1-31,2月只到28号。 21 返回状态码为400:校验异常。 详细信息请参见实际响应消息体。 返回状态码为500:内部错误。 详细信息请参见实际响应消息体。