You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: draft-ietf-httpapi-ratelimit-headers.md
+15-15Lines changed: 15 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -104,7 +104,7 @@ The following features are out of the scope of this document:
104
104
105
105
The term Origin is to be interpreted as described in Section 7 of{{!WEB-ORIGIN=RFC6454}}.
106
106
107
-
This document uses the terms List, Item and Integer from {{Section 3 of !STRUCTURED-FIELDS=RFC8941}} to specify syntax and parsing, along with the concept of "bare item".
107
+
This document uses the terms List, Item and Integer from {{Section 3 of !STRUCTURED-FIELDS=RFC9651}} to specify syntax and parsing, along with the concept of "bare item".
108
108
109
109
The term "problem type" in this document is to be interpreted as described in [PROBLEM].
110
110
@@ -129,25 +129,25 @@ The term "problem type" in this document is to be interpreted as described in [P
129
129
: A service limit is the currently remaining quota from a specific quota policy and, if defined, the remaining time before quota is reallocated.
130
130
131
131
List:
132
-
: A {{!STRUCTURED-FIELDS=RFC8941}} list of Items
132
+
: A {{!STRUCTURED-FIELDS=RFC9651}} list of Items
133
133
134
134
Item:
135
-
: A {{!STRUCTURED-FIELDS=RFC8941}} item with a set of associated parameters
135
+
: A {{!STRUCTURED-FIELDS=RFC9651}} item with a set of associated parameters
136
136
137
137
# RateLimit-Policy Field {#ratelimit-policy-field}
138
138
139
-
The "RateLimit-Policy" response header field is a non-empty List{{!RFC8941}} of Quota Policy Items ({{quotapolicy-item}}). The Item{{!RFC8941}} value MUST be a String{{!RFC8941}}.
139
+
The "RateLimit-Policy" response header field is a non-empty List{{!RFC9651}} of Quota Policy Items ({{quotapolicy-item}}). The Item{{!RFC9651}} value MUST be a String{{!RFC9651}}.
140
140
141
141
The field value SHOULD remain consistent over a sequence of HTTP responses. It is this characteristic that differentiates it from the [RateLimit](#ratelimit-field) field that contains information that MAY change on every request. The "RateLimit-Policy" field enables clients to control their own flow of requests based on policy information provided by the server. Situations where throttling constraints are highly dynamic are better served using the (RateLimit field)[{#ratelimit-field}] that communicates the latest service information a client can react to. Both fields can be communicated by the server when appropriate.
142
142
143
-
Lists of Quota Policy Items ({{quotapolicy-item}}) can be split over multiple "RateLimit-Policy" fields in the same HTTP response as described in {{Section 3.1 of !STRUCTURED-FIELDS=RFC8941}}.
143
+
Lists of Quota Policy Items ({{quotapolicy-item}}) can be split over multiple "RateLimit-Policy" fields in the same HTTP response as described in {{Section 3.1 of !STRUCTURED-FIELDS=RFC9651}}.
A quota policy Item contains an identifier for the policy and a set of Parameters{{!RFC8941}} that contain information about a server's capacity allocation for the policy.
150
+
A quota policy Item contains an identifier for the policy and a set of Parameters{{!RFC9651}} that contain information about a server's capacity allocation for the policy.
151
151
152
152
The following parameters are defined:
153
153
@@ -224,17 +224,17 @@ The following example shows a policy with a partition key and a quota unit:
224
224
225
225
A server uses the "RateLimit" response header field to communicate the current service limit for a quota policy for a particular partition key.
226
226
227
-
The field is expressed as a List{{!RFC8941}} of Service Limit Items ({{servicelimit-item}}).
227
+
The field is expressed as a List{{!RFC9651}} of Service Limit Items ({{servicelimit-item}}).
228
228
229
-
Lists of Service Limit Items can be split over multiple "RateLimit" fields in the same HTTP response as described in {{Section 3.1 of !STRUCTURED-FIELDS=RFC8941}}.
229
+
Lists of Service Limit Items can be split over multiple "RateLimit" fields in the same HTTP response as described in {{Section 3.1 of !STRUCTURED-FIELDS=RFC9651}}.
230
230
231
231
~~~
232
232
RateLimit: "default";r=50;t=30
233
233
~~~
234
234
235
235
## Service Limit Item {#servicelimit-item}
236
236
237
-
Each service limit Item{{!RFC8941}} identifies the quota policy ({{quotapolicy-item}}) associated with the request and contains Parameters{{!RFC8941}} with information about the current service limit.
237
+
Each service limit Item{{!RFC9651}} identifies the quota policy ({{quotapolicy-item}}) associated with the request and contains Parameters{{!RFC9651}} with information about the current service limit.
238
238
239
239
The following parameters are defined in this specification:
240
240
@@ -560,12 +560,12 @@ IANA is requested to update two registries and create one new registry.
560
560
Please add the following entries to the
561
561
"Hypertext Transfer Protocol (HTTP) Field Name Registry"registry ({{HTTP}}):
0 commit comments