7. IANA 考虑事项
7.1. 缓存指令注册表
"Hypertext Transfer Protocol (HTTP) Cache Directive Registry" 定义了缓存指令的命名空间. 它已经建立, 目前维护于 http://www.iana.org/assignments/http-cache-directives.
7.1.1. 流程
注册 MUST 包含以下字段:
-
Cache Directive Name
-
Pointer to specification text
要添加到该命名空间的值需要 IETF Review (见 [RFC5226] 第 4.1 节).
7.1.2. 新 Cache-Control 指令的考虑事项
新的扩展指令应当考虑定义:
-
某个指令被多次指定意味着什么,
-
当指令不接受参数时, 出现参数意味着什么,
-
当指令要求参数时, 缺少参数意味着什么,
-
该指令是特定于请求、特定于响应, 还是两者皆可使用.
另见第 5.2.3 节.
7.1.3. 注册项
该注册表已按下列注册项填充:
| 缓存指令 | 参考 |
|---|---|
| max-age | 第 5.2.1.1 节, 第 5.2.2.8 节 |
| max-stale | 第 5.2.1.2 节 |
| min-fresh | 第 5.2.1.3 节 |
| must-revalidate | 第 5.2.2.1 节 |
| no-cache | 第 5.2.1.4 节, 第 5.2.2.2 节 |
| no-store | 第 5.2.1.5 节, 第 5.2.2.3 节 |
| no-transform | 第 5.2.1.6 节, 第 5.2.2.4 节 |
| only-if-cached | 第 5.2.1.7 节 |
| private | 第 5.2.2.6 节 |
| proxy-revalidate | 第 5.2.2.7 节 |
| public | 第 5.2.2.5 节 |
| s-maxage | 第 5.2.2.9 节 |
| stale-if-error | [RFC5861] 第 4 节 |
| stale-while-revalidate | [RFC5861] 第 3 节 |
7.2. 警告码注册表
"Hypertext Transfer Protocol (HTTP) Warn Codes" 注册表定义了警告码的命名空间. 它已经建立, 目前维护于 http://www.iana.org/assignments/http-warn-codes.
7.2.1. 流程
注册 MUST 包含以下字段:
-
Warn Code (3 digits)
-
Short Description
-
Pointer to specification text
要添加到该命名空间的值需要 IETF Review (见 [RFC5226] 第 4.1 节).
7.2.2. 注册项
该注册表已按下列注册项填充:
| 警告码 | 简短描述 | 参考 |
|---|---|---|
| 110 | Response is Stale | 第 5.5.1 节 |
| 111 | Revalidation Failed | 第 5.5.2 节 |
| 112 | Disconnected Operation | 第 5.5.3 节 |
| 113 | Heuristic Expiration | 第 5.5.4 节 |
| 199 | Miscellaneous Warning | 第 5.5.5 节 |
| 214 | Transformation Applied | 第 5.5.6 节 |
| 299 | Miscellaneous Persistent Warning | 第 5.5.7 节 |
7.3. 头字段注册
HTTP 头字段在维护于 http://www.iana.org/assignments/message-headers/ 的 "Message Headers" 注册表中注册.
本文档定义了以下 HTTP 头字段, 因此 "Permanent Message Header Field Names" 注册表已相应更新 (见 [BCP90]).
| 头字段名 | 协议 | 状态 | 参考 |
|---|---|---|---|
| Age | http | standard | 第 5.1 节 |
| Cache-Control | http | standard | 第 5.2 节 |
| Expires | http | standard | 第 5.3 节 |
| Pragma | http | standard | 第 5.4 节 |
| Warning | http | standard | 第 5.5 节 |
变更控制方 (change controller) 是: "IETF ([email protected]) - Internet Engineering Task Force".