| rfc9922v1.txt | rfc9922.txt | |||
|---|---|---|---|---|
| skipping to change at line 174 ¶ | skipping to change at line 174 ¶ | |||
| Interval: Refers to an integer that specifies the interval at which | Interval: Refers to an integer that specifies the interval at which | |||
| a recurrence rule repeats. Values are taken from the "INTERVAL" | a recurrence rule repeats. Values are taken from the "INTERVAL" | |||
| rule in Section 3.3.10 of [RFC5545]. | rule in Section 3.3.10 of [RFC5545]. | |||
| For example, "1" means every second for a secondly rule, every | For example, "1" means every second for a secondly rule, every | |||
| minute for a minutely rule, every hour for an hourly rule, etc. | minute for a minutely rule, every hour for an hourly rule, etc. | |||
| System: Refers to an entity that hosts a schedule that is managed | System: Refers to an entity that hosts a schedule that is managed | |||
| using the YANG module defined in this document. | using the YANG module defined in this document. | |||
| "schedule-status-*" refers to any of "schedule-status", "schedule- | ||||
| status-with-time-zone", and "schedule-status-with-name". | ||||
| 3. Module Overview | 3. Module Overview | |||
| 3.1. Features | 3.1. Features | |||
| The "ietf-schedule" data model defines the recurrence-related | The "ietf-schedule" data model defines the recurrence-related | |||
| groupings using a modular approach. To that aim, a variety of | groupings using a modular approach. To that aim, a variety of | |||
| representations of recurrence groupings ranging from basic to | representations of recurrence groupings ranging from basic to | |||
| advanced (iCalender-like) are defined. To allow for different | advanced (iCalender-like) are defined. To allow for different | |||
| options, two features are defined in the data model: | options, two features are defined in the data model: | |||
| skipping to change at line 198 ¶ | skipping to change at line 201 ¶ | |||
| Refer to Section 3.4 and Appendix B.1 for the use of these features. | Refer to Section 3.4 and Appendix B.1 for the use of these features. | |||
| 3.2. Types and Identities | 3.2. Types and Identities | |||
| The "ietf-schedule" module (Section 6) defines the following | The "ietf-schedule" module (Section 6) defines the following | |||
| identities: | identities: | |||
| * "schedule-type": Indicates the type of schedule. The following | * "schedule-type": Indicates the type of schedule. The following | |||
| types are defined so far: | types are defined so far: | |||
| - one-shot: The schedule will trigger an action that has either | - one-shot: This type is used for a schedule that triggers an | |||
| the duration specified as 0 or the end time specified as the | action that has either the duration specified as 0 or the end | |||
| same as the start time, and then the schedule will disable | time specified as the same as the start time, and then the | |||
| itself (Section 3.3 of [RFC3231]). | schedule will disable itself (Section 3.3 of [RFC3231]). | |||
| - period: This type is used for a period-based schedule | - period: This type is used for a period-based schedule | |||
| consisting of either (1) a start and end or (2) a start and | consisting of either (1) a start and end or (2) a start and | |||
| positive duration of time. If neither an end nor a duration is | positive duration of time. If neither an end nor a duration is | |||
| indicated, the period is considered to last forever. | indicated, the period is considered to last forever. | |||
| - recurrence: This type is used for a recurrence-based schedule. | - recurrence: This type is used for a recurrence-based schedule. | |||
| A recurrence may be periodic (i.e., repeat over the same | A recurrence may be periodic (i.e., repeat over the same | |||
| period, e.g., every five minutes) or not (i.e., repeat in a | period, e.g., every five minutes) or not (i.e., repeat in a | |||
| non-regular manner, e.g., every day at 8 and 9 AM). | non-regular manner, e.g., every day at 8 and 9 AM). | |||
| skipping to change at line 285 ¶ | skipping to change at line 288 ¶ | |||
| The "time-zone-identifier" parameter, if provided, specifies the time | The "time-zone-identifier" parameter, if provided, specifies the time | |||
| zone reference [RFC7317] of the local date and time values. This | zone reference [RFC7317] of the local date and time values. This | |||
| parameter MUST be specified if any of the date and time values are in | parameter MUST be specified if any of the date and time values are in | |||
| the format of local time. It MUST NOT be applied to date and time | the format of local time. It MUST NOT be applied to date and time | |||
| values that are specified in the format of UTC or time zone offset to | values that are specified in the format of UTC or time zone offset to | |||
| UTC. | UTC. | |||
| The "validity" parameter specifies the date and time after which a | The "validity" parameter specifies the date and time after which a | |||
| schedule will not be considered as valid. It determines the latest | schedule will not be considered as valid. It determines the latest | |||
| time that a schedule can be started to execute independent of when it | time that a schedule can be started and thus executed independently | |||
| ends, and it takes precedence over similar attributes that are | from when it ends, and it takes precedence over similar attributes | |||
| provided at the schedule instance itself. A requested schedule may | that are provided at the schedule instance itself. A requested | |||
| still be accepted, but any occurrences that start later than the | schedule may still be accepted, but any occurrences that start later | |||
| configured value will not be executed. | than the configured value will not be executed. | |||
| The "max/min-allowed-start" parameters specify the maximum/minimum | The "max/min-allowed-start" parameters specify the maximum/minimum | |||
| scheduled start date and time. A requested schedule will be rejected | scheduled start date and time. A requested schedule will be rejected | |||
| if the first occurrence of the schedule starts later/earlier than the | if the first occurrence of the schedule starts later/earlier than the | |||
| configured values. | configured values. | |||
| The "max-allowed-end" parameter specifies the maximum allowed end | The "max-allowed-end" parameter specifies the maximum allowed end | |||
| time of the last occurrence. A requested schedule will be rejected | time of the last occurrence. A requested schedule will be rejected | |||
| if the end time of the last occurrence is later than the configured | if the end time of the last occurrence is later than the configured | |||
| "max-allowed-end" value. | "max-allowed-end" value. | |||
| The "discard-action" parameter specifies the action if a requested | The "discard-action" parameter specifies the action if a requested | |||
| schedule cannot be accepted for any reason and is discarded. | schedule cannot be accepted for any reason and is discarded. | |||
| Possible reasons include, but are not limited to, the requested | Possible reasons include, but are not limited to, the requested | |||
| schedule failing to satisfy the guards in this grouping, conflicting | schedule failing to satisfy the guards in this grouping, conflicting | |||
| with existing schedules, or being out-of-date (e.g., the expected | with existing schedules, or being out-of-date (e.g., the expected | |||
| start has already passed). | start has already passed). | |||
| * | ||||
| These parameters apply to all schedules on a system and are meant to | These parameters apply to all schedules on a system and are meant to | |||
| provide guards against stale configuration, too short schedule | provide guards against stale configuration, schedule requests that | |||
| requests that would prevent validation by admins of some critical | are too short and that would thus prevent validation by admins of | |||
| systems, etc. | some critical systems, etc. | |||
| 3.3.2. The "period-of-time" Grouping | 3.3.2. The "period-of-time" Grouping | |||
| The "period-of-time" grouping (Figure 2) represents a time period | The "period-of-time" grouping (Figure 2) represents a time period | |||
| using either a start date and time ("period-start") and end date and | using either a start date and time ("period-start") and end date and | |||
| time ("period-end") or a start date and time ("period-start") and a | time ("period-end") or a start date and time ("period-start") and a | |||
| non-negative time duration ("duration"). For the first format, the | non-negative time duration ("duration"). For the first format, the | |||
| start of the period MUST be no later than the end of the period. If | start of the period MUST be no later than the end of the period. If | |||
| neither an end date and time ("period-end") nor a duration | neither an end date and time ("period-end") nor a duration | |||
| ("duration") is indicated, the period is considered to last forever. | ("duration") is indicated, the period is considered to last forever. | |||
| skipping to change at line 373 ¶ | skipping to change at line 374 ¶ | |||
| The frequency parameter ("frequency") identifies the type of | The frequency parameter ("frequency") identifies the type of | |||
| recurrence rule. For example, a "daily" frequency value specifies | recurrence rule. For example, a "daily" frequency value specifies | |||
| repeating events based on an interval of a day or more. | repeating events based on an interval of a day or more. | |||
| Consistent with Section 3.3.10 of [RFC5545], the interval parameter | Consistent with Section 3.3.10 of [RFC5545], the interval parameter | |||
| ("interval") represents at which interval the recurrence rule | ("interval") represents at which interval the recurrence rule | |||
| repeats. For example, within a "daily" recurrence rule, an interval | repeats. For example, within a "daily" recurrence rule, an interval | |||
| value of "8" means every eight days. | value of "8" means every eight days. | |||
| Note that, per Section 4.13 of [YANG-GUIDE], neither a "default" nor | Note that, per Section 4.13 of [YANG-GUIDE], no "default" | |||
| a "mandatory" substatement is defined here for both "frequency" and | substatement is defined here for both "frequency" and "interval" | |||
| "interval" parameters because there are cases (e.g., profiling) where | parameters because there are cases (e.g., profiling) where using | |||
| using these statements is problematic. YANG modules using this | these statements is problematic. No "mandatory" substatement is | |||
| grouping SHOULD refine these two nodes with either a "mandatory" or a | defined here for the same reason. YANG modules using this grouping | |||
| SHOULD refine these two nodes with either a "mandatory" or a | ||||
| "default" statement if they always need to be configured or have | "default" statement if they always need to be configured or have | |||
| default values. This recommendation MAY be ignored in cases such as | default values. This recommendation MAY be ignored in cases such as | |||
| when this grouping is used by another grouping. | when this grouping is used by another grouping. | |||
| The "recurrence-description" parameter includes a description of the | The "recurrence-description" parameter includes a description of the | |||
| period. No constraint is imposed on the structure nor the use of | period. No constraint is imposed on the structure nor the use of | |||
| this parameter. | this parameter. | |||
| 3.3.4. The "recurrence-utc" Grouping | 3.3.4. The "recurrence-utc" Grouping | |||
| skipping to change at line 514 ¶ | skipping to change at line 516 ¶ | |||
| +-- frequency? identityref | +-- frequency? identityref | |||
| +-- interval? uint32 | +-- interval? uint32 | |||
| +-- period-timeticks* [period-start] | +-- period-timeticks* [period-start] | |||
| +-- period-start yang:timeticks | +-- period-start yang:timeticks | |||
| +-- period-end? yang:timeticks | +-- period-end? yang:timeticks | |||
| Figure 6: 'recurrence-utc-with-periods' Grouping Tree Structure | Figure 6: 'recurrence-utc-with-periods' Grouping Tree Structure | |||
| The recurrence instances are specified by the union of occurrences | The recurrence instances are specified by the union of occurrences | |||
| defined by both the recurrence rule and "period-timeticks" list. | defined by both the recurrence rule and "period-timeticks" list. | |||
| This list uses the "yang:timeticks" type defined in [RFC6991]. | This list uses the "yang:timeticks" type defined in [RFC9911]. | |||
| Duplicate instances are ignored. The value of the "period-start" | Duplicate instances are ignored. The value of the "period-start" | |||
| instance MUST NOT exceed the value indicated by the value of the | instance MUST NOT exceed the value of the "frequency" instance, i.e., | |||
| "frequency" instance, i.e., the "timeticks" value must not exceed 100 | the "timeticks" value must not exceed 100 in a secondly recurrence | |||
| in a secondly recurrence rule, and it must not exceed 6000 in a | rule, and it must not exceed 6000 in a minutely recurrence rule, and | |||
| minutely recurrence rule, and so on. | so on. | |||
| 3.3.7. The "recurrence-time-zone-with-periods" Grouping | 3.3.7. The "recurrence-time-zone-with-periods" Grouping | |||
| The "recurrence-time-zone-with-periods" grouping (Figure 7) uses the | The "recurrence-time-zone-with-periods" grouping (Figure 7) uses the | |||
| "recurrence-with-time-zone" grouping (Section 3.3.5) and adds a | "recurrence-with-time-zone" grouping (Section 3.3.5) and adds a | |||
| "period" list to define an aggregate set of repeating occurrences. | "period" list to define an aggregate set of repeating occurrences. | |||
| grouping recurrence-time-zone-with-periods: | grouping recurrence-time-zone-with-periods: | |||
| +-- recurrence-first | +-- recurrence-first | |||
| | +-- start-time? yang:date-and-time | | +-- start-time? yang:date-and-time | |||
| skipping to change at line 638 ¶ | skipping to change at line 640 ¶ | |||
| occurrence within the set of recurrence instances to be specified. | occurrence within the set of recurrence instances to be specified. | |||
| For example, in a "monthly" recurrence rule, the "byday" data node | For example, in a "monthly" recurrence rule, the "byday" data node | |||
| specifies every Monday of the week, and the "bysetpos" with a value | specifies every Monday of the week, and the "bysetpos" with a value | |||
| of "-1" represents the last Monday of the month. Not setting the | of "-1" represents the last Monday of the month. Not setting the | |||
| "bysetpos" data node represents every Monday of the month. | "bysetpos" data node represents every Monday of the month. | |||
| The "workweek-start" data node specifies the day on which the week | The "workweek-start" data node specifies the day on which the week | |||
| starts. This is significant when a "weekly" recurrence rule has an | starts. This is significant when a "weekly" recurrence rule has an | |||
| interval greater than 1, and a "byday" data node is specified. This | interval greater than 1, and a "byday" data node is specified. This | |||
| is also significant when in a "yearly" rule and a "byyearweek" is | is also significant when in a "yearly" rule and a "byyearweek" is | |||
| specified. Note that, per Section 4.13 of [YANG-GUIDE], neither a | specified. Note that, per Section 4.13 of [YANG-GUIDE], no "default" | |||
| "default" nor a "mandatory" substatement is defined here because | substatement is defined here because there are cases (e.g., | |||
| there are cases (e.g., profiling) where using these statements is | profiling) where using these statements is problematic. No | |||
| problematic. YANG modules using this grouping SHOULD refine the | "mandatory" substatement is defined here for the same reason. YANG | |||
| "workweek-start" node with either a "mandatory" or a "default" | modules using this grouping SHOULD refine the "workweek-start" node | |||
| statement if it always needs to be configured or has a default value. | with either a "mandatory" or a "default" statement if it always needs | |||
| This MAY be ignored in cases such as when this grouping is used by | to be configured or has a default value. This MAY be ignored in | |||
| another grouping. | cases such as when this grouping is used by another grouping. | |||
| The "exception-dates" data node specifies a list of exceptions for | The "exception-dates" data node specifies a list of exceptions for | |||
| recurrence. The final recurrence set is generated by gathering all | recurrence. The final recurrence set is generated by gathering all | |||
| of the date and time values created by any of the specified | of the date and time values created by any of the specified | |||
| recurrence rules and date-times and then excluding any start date and | recurrence rules and date-times and then excluding any start date and | |||
| time values specified by "exception-dates" parameter. | time values specified by "exception-dates" parameter. | |||
| 3.3.9. The "schedule-status", "schedule-status-with-time-zone", and | 3.3.9. The "schedule-status", "schedule-status-with-time-zone", and | |||
| "schedule-status-with-name" Groupings | "schedule-status-with-name" Groupings | |||
| skipping to change at line 845 ¶ | skipping to change at line 847 ¶ | |||
| +------------------+-------------------------+ | +------------------+-------------------------+ | |||
| | schedValue | Not applicable | | | schedValue | Not applicable | | |||
| +------------------+-------------------------+ | +------------------+-------------------------+ | |||
| | schedTriggers | counter/failure-counter | | | schedTriggers | counter/failure-counter | | |||
| +------------------+-------------------------+ | +------------------+-------------------------+ | |||
| Table 1: YANG/MIB Mapping | Table 1: YANG/MIB Mapping | |||
| 6. The "ietf-schedule" YANG Module | 6. The "ietf-schedule" YANG Module | |||
| This module imports types defined in [RFC5545], [RFC6991], and | This module imports types defined in [RFC9911] and [RFC7317]. | |||
| [RFC7317]. | ||||
| <CODE BEGINS> | <CODE BEGINS> | |||
| file "ietf-schedule@2026-02-18.yang" | file "ietf-schedule@2026-02-18.yang" | |||
| module ietf-schedule { | module ietf-schedule { | |||
| yang-version 1.1; | yang-version 1.1; | |||
| namespace "urn:ietf:params:xml:ns:yang:ietf-schedule"; | namespace "urn:ietf:params:xml:ns:yang:ietf-schedule"; | |||
| prefix schedule; | prefix schedule; | |||
| import ietf-yang-types { | import ietf-yang-types { | |||
| prefix yang; | prefix yang; | |||
| reference | reference | |||
| "RFC 6991: Common YANG Data Types"; | "RFC 9911: Common YANG Data Types"; | |||
| } | } | |||
| import ietf-system { | import ietf-system { | |||
| prefix sys; | prefix sys; | |||
| reference | reference | |||
| "RFC 7317: A YANG Data Model for System Management"; | "RFC 7317: A YANG Data Model for System Management"; | |||
| } | } | |||
| organization | organization | |||
| "IETF NETMOD Working Group"; | "IETF NETMOD Working Group"; | |||
| skipping to change at line 1744 ¶ | skipping to change at line 1745 ¶ | |||
| RESTCONF protocol operations and content. | RESTCONF protocol operations and content. | |||
| The "ietf-schedule" module defines a set of identities, types, and | The "ietf-schedule" module defines a set of identities, types, and | |||
| groupings. These nodes are intended to be reused by other YANG | groupings. These nodes are intended to be reused by other YANG | |||
| modules. The module by itself does not expose any data nodes that | modules. The module by itself does not expose any data nodes that | |||
| are writable, data nodes that contain read-only state, or RPCs. As | are writable, data nodes that contain read-only state, or RPCs. As | |||
| such, there are no additional security issues related to the "ietf- | such, there are no additional security issues related to the "ietf- | |||
| schedule" module that need to be considered. | schedule" module that need to be considered. | |||
| Modules that use the groupings that are defined in this document | Modules that use the groupings that are defined in this document | |||
| should identify the corresponding security considerations, for | should identify the corresponding security considerations. For | |||
| example: | example, reuising the following groupings will expose privacy-related | |||
| information: | ||||
| * Scheduling depends on reliable and accurate time synchronization. | * Scheduling depends on reliable and accurate time synchronization. | |||
| Inaccurate date and time setting can lead to scheduling events | Inaccurate date and time setting can lead to scheduling events | |||
| being triggered at incorrect intervals, potentially causing system | being triggered at incorrect intervals, potentially causing system | |||
| failures or security vulnerabilities. | failures or security vulnerabilities. | |||
| * Recurring events may conceal abnormal behavior or security | * Recurring events may conceal abnormal behavior or security | |||
| threats, which may be drowned out by normal events, especially | threats, which may be drowned out by normal events, especially | |||
| when they are triggered frequently. | when they are triggered frequently. | |||
| skipping to change at line 1821 ¶ | skipping to change at line 1823 ¶ | |||
| [RFC5545] Desruisseaux, B., Ed., "Internet Calendaring and | [RFC5545] Desruisseaux, B., Ed., "Internet Calendaring and | |||
| Scheduling Core Object Specification (iCalendar)", | Scheduling Core Object Specification (iCalendar)", | |||
| RFC 5545, DOI 10.17487/RFC5545, September 2009, | RFC 5545, DOI 10.17487/RFC5545, September 2009, | |||
| <https://www.rfc-editor.org/info/rfc5545>. | <https://www.rfc-editor.org/info/rfc5545>. | |||
| [RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for | [RFC6020] Bjorklund, M., Ed., "YANG - A Data Modeling Language for | |||
| the Network Configuration Protocol (NETCONF)", RFC 6020, | the Network Configuration Protocol (NETCONF)", RFC 6020, | |||
| DOI 10.17487/RFC6020, October 2010, | DOI 10.17487/RFC6020, October 2010, | |||
| <https://www.rfc-editor.org/info/rfc6020>. | <https://www.rfc-editor.org/info/rfc6020>. | |||
| [RFC6991] Schoenwaelder, J., Ed., "Common YANG Data Types", | ||||
| RFC 6991, DOI 10.17487/RFC6991, July 2013, | ||||
| <https://www.rfc-editor.org/info/rfc6991>. | ||||
| [RFC7317] Bierman, A. and M. Bjorklund, "A YANG Data Model for | [RFC7317] Bierman, A. and M. Bjorklund, "A YANG Data Model for | |||
| System Management", RFC 7317, DOI 10.17487/RFC7317, August | System Management", RFC 7317, DOI 10.17487/RFC7317, August | |||
| 2014, <https://www.rfc-editor.org/info/rfc7317>. | 2014, <https://www.rfc-editor.org/info/rfc7317>. | |||
| [RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language", | [RFC7950] Bjorklund, M., Ed., "The YANG 1.1 Data Modeling Language", | |||
| RFC 7950, DOI 10.17487/RFC7950, August 2016, | RFC 7950, DOI 10.17487/RFC7950, August 2016, | |||
| <https://www.rfc-editor.org/info/rfc7950>. | <https://www.rfc-editor.org/info/rfc7950>. | |||
| [RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC | [RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC | |||
| 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, | 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, | |||
| May 2017, <https://www.rfc-editor.org/info/rfc8174>. | May 2017, <https://www.rfc-editor.org/info/rfc8174>. | |||
| [RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration | [RFC8341] Bierman, A. and M. Bjorklund, "Network Configuration | |||
| Access Control Model", STD 91, RFC 8341, | Access Control Model", STD 91, RFC 8341, | |||
| DOI 10.17487/RFC8341, March 2018, | DOI 10.17487/RFC8341, March 2018, | |||
| <https://www.rfc-editor.org/info/rfc8341>. | <https://www.rfc-editor.org/info/rfc8341>. | |||
| [W3C.XML1.0] | [RFC9911] Schönwälder, J., Ed., "Common YANG Data Types", RFC 9911, | |||
| Bray, T., Ed., Paoli, J., Ed., Sperberg-McQueen, C. M., | DOI 10.17487/RFC9911, December 2025, | |||
| Ed., Maler, E., Ed., and F. Yergeau, Ed., "Extensible | <https://www.rfc-editor.org/info/rfc9911>. | |||
| Markup Language (XML) 1.0 (Fifth Edition)", W3C | ||||
| Recommendation, 26 November 2008, | ||||
| <https://www.w3.org/TR/2008/REC-xml-20081126/>. | ||||
| 9.2. Informative References | 9.2. Informative References | |||
| [NETMOD-ECA-POLICY] | [NETMOD-ECA-POLICY] | |||
| Wu, Q., Bryskin, I., Birkholz, H., Liu, X., and B. Claise, | Wu, Q., Bryskin, I., Birkholz, H., Liu, X., and B. Claise, | |||
| "A YANG Data model for ECA Policy Management", Work in | "A YANG Data model for ECA Policy Management", Work in | |||
| Progress, Internet-Draft, draft-ietf-netmod-eca-policy-01, | Progress, Internet-Draft, draft-ietf-netmod-eca-policy-01, | |||
| 19 February 2021, <https://datatracker.ietf.org/doc/html/ | 19 February 2021, <https://datatracker.ietf.org/doc/html/ | |||
| draft-ietf-netmod-eca-policy-01>. | draft-ietf-netmod-eca-policy-01>. | |||
| skipping to change at line 1889 ¶ | skipping to change at line 1884 ¶ | |||
| <https://www.rfc-editor.org/info/rfc7951>. | <https://www.rfc-editor.org/info/rfc7951>. | |||
| [RFC8040] Bierman, A., Bjorklund, M., and K. Watsen, "RESTCONF | [RFC8040] Bierman, A., Bjorklund, M., and K. Watsen, "RESTCONF | |||
| Protocol", RFC 8040, DOI 10.17487/RFC8040, January 2017, | Protocol", RFC 8040, DOI 10.17487/RFC8040, January 2017, | |||
| <https://www.rfc-editor.org/info/rfc8040>. | <https://www.rfc-editor.org/info/rfc8040>. | |||
| [RFC8340] Bjorklund, M. and L. Berger, Ed., "YANG Tree Diagrams", | [RFC8340] Bjorklund, M. and L. Berger, Ed., "YANG Tree Diagrams", | |||
| BCP 215, RFC 8340, DOI 10.17487/RFC8340, March 2018, | BCP 215, RFC 8340, DOI 10.17487/RFC8340, March 2018, | |||
| <https://www.rfc-editor.org/info/rfc8340>. | <https://www.rfc-editor.org/info/rfc8340>. | |||
| [RFC8345] Clemm, A., Medved, J., Varga, R., Bahadur, N., | ||||
| Ananthakrishnan, H., and X. Liu, "A YANG Data Model for | ||||
| Network Topologies", RFC 8345, DOI 10.17487/RFC8345, March | ||||
| 2018, <https://www.rfc-editor.org/info/rfc8345>. | ||||
| [RFC8413] Zhuang, Y., Wu, Q., Chen, H., and A. Farrel, "Framework | [RFC8413] Zhuang, Y., Wu, Q., Chen, H., and A. Farrel, "Framework | |||
| for Scheduled Use of Resources", RFC 8413, | for Scheduled Use of Resources", RFC 8413, | |||
| DOI 10.17487/RFC8413, July 2018, | DOI 10.17487/RFC8413, July 2018, | |||
| <https://www.rfc-editor.org/info/rfc8413>. | <https://www.rfc-editor.org/info/rfc8413>. | |||
| [RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol | [RFC8446] Rescorla, E., "The Transport Layer Security (TLS) Protocol | |||
| Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018, | Version 1.3", RFC 8446, DOI 10.17487/RFC8446, August 2018, | |||
| <https://www.rfc-editor.org/info/rfc8446>. | <https://www.rfc-editor.org/info/rfc8446>. | |||
| [RFC9000] Iyengar, J., Ed. and M. Thomson, Ed., "QUIC: A UDP-Based | [RFC9000] Iyengar, J., Ed. and M. Thomson, Ed., "QUIC: A UDP-Based | |||
| Multiplexed and Secure Transport", RFC 9000, | Multiplexed and Secure Transport", RFC 9000, | |||
| DOI 10.17487/RFC9000, May 2021, | DOI 10.17487/RFC9000, May 2021, | |||
| <https://www.rfc-editor.org/info/rfc9000>. | <https://www.rfc-editor.org/info/rfc9000>. | |||
| [RFC9657] Birrane, III, E., Kuhn, N., Qu, Y., Taylor, R., and L. | [RFC9657] Birrane, III, E., Kuhn, N., Qu, Y., Taylor, R., and L. | |||
| Zhang, "Time-Variant Routing (TVR) Use Cases", RFC 9657, | Zhang, "Time-Variant Routing (TVR) Use Cases", RFC 9657, | |||
| DOI 10.17487/RFC9657, October 2024, | DOI 10.17487/RFC9657, October 2024, | |||
| <https://www.rfc-editor.org/info/rfc9657>. | <https://www.rfc-editor.org/info/rfc9657>. | |||
| [W3C.XML1.0] | ||||
| Bray, T., Ed., Paoli, J., Ed., Sperberg-McQueen, C. M., | ||||
| Ed., Maler, E., Ed., and F. Yergeau, Ed., "Extensible | ||||
| Markup Language (XML) 1.0 (Fifth Edition)", W3C | ||||
| Recommendation, 26 November 2008, | ||||
| <https://www.w3.org/TR/2008/REC-xml-20081126/>. | ||||
| [YANG-CONFIG-SCHEDULE] | [YANG-CONFIG-SCHEDULE] | |||
| Liu, X., Bryskin, I., Beeram, V. P., Saad, T., Shah, H. | Liu, X., Bryskin, I., Beeram, V. P., Saad, T., Shah, H. | |||
| C., and O. G. de Dios, "A YANG Data Model for | C., and O. G. de Dios, "A YANG Data Model for | |||
| Configuration Scheduling", Work in Progress, Internet- | Configuration Scheduling", Work in Progress, Internet- | |||
| Draft, draft-liu-netmod-yang-schedule-05, 1 March 2018, | Draft, draft-liu-netmod-yang-schedule-05, 1 March 2018, | |||
| <https://datatracker.ietf.org/doc/html/draft-liu-netmod- | <https://datatracker.ietf.org/doc/html/draft-liu-netmod- | |||
| yang-schedule-05>. | yang-schedule-05>. | |||
| [YANG-GUIDE] | [YANG-GUIDE] | |||
| Bierman, A., Boucadair, M., and Q. Wu, "Guidelines for | Bierman, A., Boucadair, M., and Q. Wu, "Guidelines for | |||
| skipping to change at line 2433 ¶ | skipping to change at line 2440 ¶ | |||
| organization | organization | |||
| "Example, Inc."; | "Example, Inc."; | |||
| contact | contact | |||
| "Support at example.com"; | "Support at example.com"; | |||
| description | description | |||
| "Example of a module defining a scheduled-based backup | "Example of a module defining a scheduled-based backup | |||
| operation."; | operation."; | |||
| revision "2023-01-19" { | revision "2026-02-20" { | |||
| description | description | |||
| "Initial version."; | "Initial version."; | |||
| reference | reference | |||
| "RFC 9922: A YANG Data Model for Scheduling."; | "RFC 9922: A YANG Data Model for Scheduling."; | |||
| } | } | |||
| container scheduled-backup-tasks { | container scheduled-backup-tasks { | |||
| description | description | |||
| "A container for backing up all current running configurations | "A container for backing up all current running configurations | |||
| on the device."; | on the device."; | |||
| skipping to change at line 2538 ¶ | skipping to change at line 2545 ¶ | |||
| } | } | |||
| } | } | |||
| B.2. Example: Schedule Network Properties to Change Based on Date and | B.2. Example: Schedule Network Properties to Change Based on Date and | |||
| Time | Time | |||
| Network properties may change over a specific period of time or based | Network properties may change over a specific period of time or based | |||
| on a recurrence rule, e.g., [RFC9657]. The following example module, | on a recurrence rule, e.g., [RFC9657]. The following example module, | |||
| which augments the "recurrence-utc-with-periods" grouping from the | which augments the "recurrence-utc-with-periods" grouping from the | |||
| "ietf-schedule" module, shows how a scheduled attribute could be | "ietf-schedule" module, shows how a scheduled attribute could be | |||
| defined. | defined. Note that | |||
| [RFC8345] and this document are referenced in the module. | ||||
| module example-scheduled-link-bandwidth { | module example-scheduled-link-bandwidth { | |||
| yang-version 1.1; | yang-version 1.1; | |||
| namespace "http://example.com/example-scheduled-link-bandwidth"; | namespace "http://example.com/example-scheduled-link-bandwidth"; | |||
| prefix "ex-scattr"; | prefix "ex-scattr"; | |||
| import ietf-network { | import ietf-network { | |||
| prefix "nw"; | prefix "nw"; | |||
| reference | reference | |||
| "RFC 8345: A YANG Data Model for Network Topologies"; | "RFC 8345: A YANG Data Model for Network Topologies"; | |||
| skipping to change at line 2566 ¶ | skipping to change at line 2574 ¶ | |||
| organization | organization | |||
| "Example, Inc."; | "Example, Inc."; | |||
| contact | contact | |||
| "Support at example.com"; | "Support at example.com"; | |||
| description | description | |||
| "Example of a module defining a scheduled link bandwidth."; | "Example of a module defining a scheduled link bandwidth."; | |||
| revision "2023-01-19" { | revision "2026-02-20" { | |||
| description | description | |||
| "Initial version."; | "Initial version."; | |||
| reference | reference | |||
| "RFC 9922: A YANG Data Model for Scheduling"; | "RFC 9922: A YANG Data Model for Scheduling"; | |||
| } | } | |||
| grouping link-bandwidth-grouping { | grouping link-bandwidth-grouping { | |||
| description | description | |||
| "Grouping of the link bandwidth definition."; | "Grouping of the link bandwidth definition."; | |||
| leaf scheduled-bandwidth { | leaf scheduled-bandwidth { | |||
| End of changes. 19 change blocks. | ||||
| 50 lines changed or deleted | 58 lines changed or added | |||
This html diff was produced by rfcdiff 1.48. | ||||