-
响应示例 返回状态码为200：查询站点成功，响应体参考QuerySiteTimeZoneRespons。 HTTP/1.1 200 OK
Date: Sun,11 May 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,11 May 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,11 May 2025 10:00:00 GMT
Server: example-server
Content-Type: application/json;charset=UTF-8
Content-Length: 250
Connection: keep-alive
-
响应参数 返回状态码为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：内部错误。 详细信息请参见实际响应消息体。
-
请求示例 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-AC
CES S-TOKEN: x-yyyyyy
-
响应示例 返回状态码为201：设置站点时区成功，响应体参考SiteApiResponse。 HTTP/1.1 201 Created
Date: Sun,11 May 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,11 May 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,11 May 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-ACCESS-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
