The tag URI scheme is a uniform resource identifier (URI) scheme for unique identifiers called tags, defined by RFC 4151 in October 2005.[1][2]

The RFC identifies four requirements for tags:[1]

Tags are used extensively in YAML.[3]

Format

The general syntax of a tag URI is:[1] 

"tag:" authorityName "," YYYY-MM-DD-date ":" specific [ "#" fragment ]

In this syntax, the authorityName is either a domain name or an email address, and the date is in the YYYY-MM-DD format, such as 2017-01-01. Thus, a specific tag is tied to a specific domain name or email address at a specific point of time. It is required that the "tagging entity" creating the tag be in control of the specified domain or email address as of 00:00 UTC on the specified date. This requirement makes each tag globally and persistently unique. The authority name alone would not suffice for global uniqueness, since the ownership of domains and email addresses is subject to change.

The date used in a tag may be a past date, provided the tagging entity controlled the authority name on that past date. An entity which acquires control of an authority name immediately after a period when it was unassigned is allowed to mint tags as if it controlled the authority name during the unassigned period, provided the entity has evidence that the name was unassigned. The date used in a newly-minted tag may not be a date in the future.

The date may be abbreviated; the month and day default to 01, but tags which have defaulted month and day values are reckoned as different from tags where the 01 value is specified. Thus,

are all different tags and might have different referents. They all should have been minted by the same tagging entity (specifically, whoever controlled example.com on January 1, 2004 00:00 UTC). If a different entity gained control of example.com at 00:05 UTC on that date, it would not be allowed to mint tags until the following date, and it would not ever be able to use the abbreviated forms, 2004 or 2004-01.

Examples of tag URIs are:

See also

References

  1. ^ a b c Kindberg, T.; Hawke, S. (October 2005). "The 'tag' URI Scheme". Internet Engineering Task Force. Retrieved 1 September 2015.
  2. ^ "Tag URI". Retrieved 2007-11-02.
  3. ^ "YAML specification". Retrieved 2007-11-02.
Categories