- 产品与解决方案
- 行业解决方案
- 服务
- 支持
- 合作伙伴
- 关于我们
03-时间段命令
本章节下载： 03-时间段命令 (197.12 KB)
目 录
display time-range命令用来显示时间段的配置和状态信息。
【命令】
display time-range { time-range-name | all }
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
time-range-name：显示指定名称时间段的配置和状态信息。time-range-name表示时间段的名称，为1～63个字符的字符串，使用英文字母时不区分大小写。
all：显示所有时间段的配置和状态信息。
【举例】
# 显示时间段t4的配置和状态信息。
<Sysname> display time-range t4
Current time is 17:12:34 11/23/2010 Tuesday
Time-range : t4 (Inactive)
10:00 to 12:00 Mon
14:00 to 16:00 Wed
from 00:00:00 1/1/2011 to 00:00:00 1/1/2012
from 00:00:00 6/1/2011 to 00:00:00 7/1/2011
# 显示所有时间段的配置和状态信息。
<Sysname> display time-range all
Current time is 17:23:41 6/28/2021 Monday
Time-range: aa (Inactive)
Yundi Alias:AA Tenant： aa
Monthly 12:00 1st to 13:00 11th
from 00:00:00 6/28/2021 to 00:00:00 31/12/2021
Time-range: ee (Inactive)
Yundi Alias:BBB Tenant： bb
Description:aaa
Time-range: bb (Inactive)
Yundi Alias:BB Tenant： bb
Weekly 13:00 Mon to 13:11 Fri
from 00:00:00 6/28/2021 to 00:00:00 31/12/2021
表1-1 display time-range命令显示信息描述表
|
字段 |
描述 |
|
Current time |
系统当前的时间 |
|
Time-range |
时间段的配置信息，包括： · 时间段的名称 · 时间段的状态，包括Active（生效）和Inactive（未生效）两种状态 · 时间段的时间范围 |
|
Alias |
时间段别名 |
|
Tenant |
绑定的租户名称 |
|
Description |
时间段描述信息 |
time-range命令用来创建一个时间段，来描述一个特定的时间范围。如果指定的时间段已经创建，则本命令可以修改时间段的时间范围。
undo time-range命令用来删除一个时间段。
【命令】
time-range time-range-name { { monthly | weekly } start-day start-time to end-day end-time [ from time1 date1 ] [ to time2 date2 ] | start-time to end-time days [ from time1 date1 ] [ to time2 date2 ] | from time1 date1 [ to time2 date2 ] | to time2 date2 }
undo time-range time-range-name [ { monthly | weekly } start-day start-time to end-day end-time [ from time1 date1 ] [ to time2 date2 ] | start-time to end-time days [ from time1 date1 ] [ to time2 date2 ] | from time1 date1 [ to time2 date2 ] | to time2 date2 ]
【缺省情况】
不存在时间段。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
time-range-name：指定时间段的名称，为1～63个字符的字符串，不区分大小写。为避免混淆，时间段的名称不允许使用英文单词all。
monthly start-day start-time to end-day end-time：表示每月的指定时间段。其中start-day表示起始日期，end-day表示结束日期，start-day和end-day取值范围为1～31，依次表示每月1号～每月31号，结束日期不小于起始日期。start-time表示起始时间，格式为hh:mm或hh:mm:ss，取值范围为00:00:00～24:00:00；end-time表示结束时间，格式为hh:mm或hh:mm:ss，取值范围为00:00:00～24:00:00，如果起始日期和结束日期在同一天，则结束时间必须大于起始时间。
例如周期时间段指定从每月的1号08:00到10号08:00，期间不间断则可以指定本参数。
weekly start-day start-time to end-day end-time：表示每周的指定时间段
· start-day表示起始日期，end-day表示结束日期，start-day和end-day取值形式如下：
¡ 数字：取值范围为0～6，依次表示周日～周六；
¡ 周几的英文缩写（从周日到周六依次为Sun、Mon、Tue、Wed、Thu、Fri和Sat）。
· start-time表示起始时间，格式为hh:mm或hh:mm:ss，取值范围为00:00:00～24:00:00；end-time表示结束时间，格式为hh:mm或hh:mm:ss，取值范围为00:00:00～24:00:00，如果起始日期和结束日期在同一天，则结束时间必须大于起始时间。例如周期时间段指定从每周一08:00到周三08:00。
start-time to end-time：表示每天的指定时间段。start-time表示起始时间，格式为hh:mm或hh:mm:ss，取值范围为00:00:00～23:59:59；end-time表示结束时间，格式为hh:mm或hh:mm:ss，取值范围为00:00:00～24:00:00，且结束时间必须大于起始时间。
days：指定周期时间段在每周的周几生效。本参数可输入多次，但后输入的值不能与此前输入的值完全重叠（譬如输入6后不允许再输入Sat，但允许再输入off-day），系统将取各次输入值的并集作为最终值（譬如依次输入1、Wed和working-day之后，最终生效的时间将为每周的工作日）。本参数可输入的形式如下：
· 数字：取值范围为0～6，依次表示周日～周六；
· 周几的英文缩写（从周日到周六依次为Sun、Mon、Tue、Wed、Thu、Fri和Sat）；
· 工作日（working-day）：表示从周一到周五；
· 休息日（off-day）：表示周六和周日；
· 每日（daily）：表示一周七天。
from time1 date1：指定绝对时间段的起始时间。time1的格式为hh:mm或hh:mm:ss，取值范围为00:00:00～23:59:59。date1的格式为MM/DD/YYYY或YYYY/MM/DD。MM表示月，取值范围为1～12；DD表示日，取值范围取决于所输入的月份；YYYY表示年，取值范围为1970～2100。若未指定本参数，绝对时间段的起始时间将为系统可表示的最早时间，即1970年1月1日0点0分0秒。
to time2 date2：指定绝对时间段的结束时间。time2的格式为hh:mm或hh:mm:ss，取值范围为00:00:00～24:00:00。date2的格式为MM/DD/YYYY或YYYY/MM/DD。MM表示月，取值范围为1～12；DD表示日，取值范围取决于所输入的月份；YYYY表示年，取值范围为1970～2100。结束时间必须大于起始时间。若未指定本参数，绝对时间段的结束时间将为系统可表示的最晚时间，即2100年12月31日24点0分0秒。
【使用指导】
如果指定名称的时间段不存在，则创建一个新的时间段（最多1024个，配置time-range tenant时，租户关联的空时间段也计算在内）；如果指定名称的时间段已存在，则对旧时间段进行修改，即在其原有内容的基础上叠加新的内容。
在一个时间段中，可以使用以下方式定义时间范围：
· 使用monthly start-day start-time to end-day end-time这组参数所创建的时间段为周期时间段，它将以每月为周期循环生效。如果配置end-day超出当月日期的最大值，则仅根据当月实际日期生效，当月不存在的日期不会生效。例如4月仅有30号，则即使时间段包含了31号也不会生效。
· 使用weekly start-day start-time to end-day end-time这组参数所创建的时间段为周期时间段，它将以每周为周期循环生效。
· 使用start-time to end-time days这组参数所创建的时间段为周期时间段，它将以每天为周期循环生效。
· 使用from time1 date1和to time2 date2这组参数所创建的时间段为绝对时间段，它将在指定时间范围内生效。
如果一个时间段中同时包含以上多种时间范围，将取周期时间段和绝对时间段的交集作为生效的时间范围。例如在一个时间段中定义周期时间段为每周一的8点到12点，定义绝对时间段为2015年全年，那么该时间段的生效时间范围为2015年全年内每周一的8点到12点。
一个时间段内可包含一或多个周期时间段（最多32个）和绝对时间段（最多12个），当包含有多个周期时间段和绝对时间段时，系统将先分别取各周期时间段的并集和各绝对时间段的并集，再取这两个并集的交集作为该时间段最终生效的时间范围。
【举例】
# 创建名为t1的时间段，其时间范围为每周工作日的8点到18点。
<Sysname> system-view
[Sysname] time-range t1 08:00 to 18:00 working-day
# 创建名为t2的时间段，其时间范围为2011年全年。
<Sysname> system-view
[Sysname] time-range t2 from 00:00 1/1/2011 to 24:00 12/31/2011
# 创建名为t3的时间段，其时间范围为2011年全年内每周休息日的8点到12点。
<Sysname> system-view
[Sysname] time-range t3 08:00 to 12:00 off-day from 00:00 1/1/2011 to 24:00 12/31/2011
# 创建名为t4的时间段，其时间范围为2011年1月和6月内每周一的10点到12点以及每周三的14到16点。
<Sysname> system-view
[Sysname] time-range t4 10:00 to 12:00 1 from 00:00 1/1/2011 to 24:00 1/31/2011
[Sysname] time-range t4 14:00 to 16:00 3 from 00:00 6/1/2011 to 24:00 6/30/2011
# 创建名为t5的时间段，其时间范围为2018年1月1日的8点到18点。
<Sysname> system-view
[Sysname] time-range t5 from 08:00:00 1/1/2018 to 18:00:00 1/1/2018
# 创建名为t6的时间段，其时间范围为从2021年1月1日的8点到2021年12月1日的18点的每周一8点到周五晚18点。
<Sysname> system-view
[Sysname] time-range t6 weekly 1 08:00 to 5 18:00 from 08:00 1/1/2021 to 18:00 12/1/2021
【相关命令】
· display time-range
time-range description命令用来配置时间段描述信息。
undo time-range description命令用来删除时间段描述信息。
【命令】
time-range time-range-name description text
undo time-range time-range-name description
【缺省情况】
时间段未配置描述信息。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
time-range-name：指定时间段的名称，为1～63个字符的字符串，不区分大小写。为避免混淆，时间段的名称不允许使用英文单词all。
text：时间段的描述信息，为1～127个字符的字符串，区分大小写。
【举例】
# 指定时间段t1配置描述信息abc。
<Sysname> system-view
[Sysname] time-range t1 description abc
【相关命令】
· display time-range
time-range yundi命令用来配置时间段归属的租户。
undo time-range yundi命令用来恢复缺省情况。
【命令】
time-range time-range-name yundi alias alias-name tenant tenant-id
undo time-range time-range-name yundi
【缺省情况】
时间段未归属任何租户，即租户的安全策略不受时间段限制。
【视图】
系统视图
【缺省用户角色】
network-admin
【参数】
time-range-name：指定时间段的名称，为1～63个字符的字符串，不区分大小写。为避免混淆，时间段的名称不允许使用英文单词all。
alias-name:用户别名，为1～63个字符的字符串，区分大小写。
tenant-id：租户ID，唯一标识一个租户，为1～63个字符的字符串，区分大小写。
【使用指导】
在电信云堤组网场景中，存在大量租户，网络中的控制器将为每个租户唯一分配一个租户ID，并通过Netconf将租户ID及其关联的时间段信息下发给防火墙等安全设备，防火墙通过控制器下发的信息生成本命令，使租户的安全策略在特定时间段内生效。如果与租户绑定的时间段不存在，则系统会创建一个新的时间段。
租户ID通常由远端控制器分配，因此不建议在设备上手工设置本命令。
同一个时间段只能绑定一个租户。
同一个租户可以绑定多个不同时间段，最终生效的时间段为所有时间段的并集。
【举例】
# 指定租户3abcx绑定时间段t1。
<Sysname> system-view
[Sysname] time-range t1 yundi alias abc tenant 3abcx
【相关命令】
· display time-range
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!
支持
