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: azure/Guidelines.md
+5-3Lines changed: 5 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1039,19 +1039,21 @@ The HTTP Standard does not allow precondition headers to be ignored, as it can b
1039
1039
1040
1040
<ahref="#condreq-unsupported-error"name="condreq-unsupported-error">:white_check_mark:</a> **DO** return the appropriate precondition failed error response if the service cannot verify the truth of the precondition.
1041
1041
1042
+
Note: A GA service that currently ignores precondition headers should not switch to honoring them as this could break production applications. This change should only be made prior to GA for the service or as part of a formal breaking change.
1043
+
1042
1044
While conditional requests can be implemented using last modified dates, entity tags ("ETags") are strongly
1043
1045
preferred since last modified dates cannot distinguish updates made less than a second apart.
1044
1046
1045
1047
<ahref="#condreq-return-etags"name="condreq-return-etags">:ballot_box_with_check:</a> **YOU SHOULD** return an `ETag` with any operation returning the resource or part of a resource or any update of the resource (whether the resource is returned or not).
1046
1048
1047
1049
#### Conditional Request behavior
1048
1050
1049
-
This section gives a summary of the processing to perform for conditional headers.
1051
+
This section gives a summary of the processing to perform for precondition headers.
1050
1052
See the [Conditional Requests section of the HTTP Standard][] for details on how and when to evaluate these headers.
1051
1053
1052
1054
[Conditional Requests section of the HTTP Standard]: https://datatracker.ietf.org/doc/html/rfc9110#name-conditional-requests
1053
1055
1054
-
<ahref="#condreq-for-read-behavior"name="condreq-for-read-behavior">:white_check_mark:</a> **DO** adhere to the following table for processing a GET request with conditional headers:
1056
+
<ahref="#condreq-for-read-behavior"name="condreq-for-read-behavior">:white_check_mark:</a> **DO** adhere to the following table for processing a GET request with precondition headers:
@@ -1060,7 +1062,7 @@ See the [Conditional Requests section of the HTTP Standard][] for details on how
1060
1062
1061
1063
For more control over caching, please refer to the `cache-control`[HTTP header](https://developer.mozilla.org/docs/Web/HTTP/Headers/Cache-Control).
1062
1064
1063
-
<ahref="#condreq-behavior"name="condreq-behavior">:white_check_mark:</a> **DO** adhere to the following table for processing a PUT, PATCH, or DELETE request with conditional headers:
1065
+
<ahref="#condreq-behavior"name="condreq-behavior">:white_check_mark:</a> **DO** adhere to the following table for processing a PUT, PATCH, or DELETE request with precondition headers:
0 commit comments