Skip to content

Commit 831938e

Browse files
committed
last-minute change
1 parent d3e34a4 commit 831938e

File tree

3 files changed

+8
-6
lines changed

3 files changed

+8
-6
lines changed

docs/odata-protocol/odata-protocol.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2326,12 +2326,12 @@ <h4 id="11411-use-of-etags-for-avoiding-update-conflicts"><a id="UseofETagsforAv
23262326
<p>If the client does not specify an <a href="#HeaderIfMatch"><code>If-Match</code></a> request header in a <a href="#DataModification">Data Modification Request</a> or <a href="#Actions">Action Request</a> on a resource that requires optimistic concurrency control, the service responds with a <code>428 Precondition Required</code> and MUST ensure that no observable change occurs as a result of the request. Clients can attempt to disable optimistic concurrency control by specifying <code>If-Match</code> with a value of <code>*</code>. Services MAY reject such requests.</p>
23272327
<p>For requests including an <a href="#HeaderODataVersion"><code>OData-Version</code></a> header value of <code>4.01</code>, any ETag values specified in the request body of a <a href="#UpdateanEntity">request to modify an entity</a> MUST be <code>*</code> or match the current value for the record being updated.</p>
23282328
<div class="example">
2329-
<p>Example <a id="antietag" href="#antietag">81</a>: <code>Category</code> is a single-valued nullable non-containment navigation property on the product entity type. Note that an ETag used in the <code>If-Match</code> header in the request</p>
2329+
<p>Example <a id="antietag" href="#antietag">81</a>: <code>Category</code> is a single-valued nullable non-containment navigation property on the product entity type. Note that an ETag used in the <code>If-Match</code> header in the following request applies to the category currently associated with the product.</p>
23302330
<div class="sourceCode" id="cb99"><pre class="sourceCode json"><code class="sourceCode json"><span id="cb99-1"><a href="#cb99-1" aria-hidden="true" tabindex="-1"></a><span class="er">PATCH</span> <span class="er">http://host/service/Products(57)/Category</span></span>
23312331
<span id="cb99-2"><a href="#cb99-2" aria-hidden="true" tabindex="-1"></a><span class="er">If-Match:</span> <span class="er">&quot;&lt;ETag&gt;&quot;</span></span>
23322332
<span id="cb99-3"><a href="#cb99-3" aria-hidden="true" tabindex="-1"></a></span>
23332333
<span id="cb99-4"><a href="#cb99-4" aria-hidden="true" tabindex="-1"></a><span class="fu">{</span><span class="dt">&quot;CategoryID&quot;</span><span class="fu">:</span> <span class="dv">5</span><span class="fu">}</span></span></code></pre></div>
2334-
<p>applies to the category currently associated with the product. To make the category update conditional on the ETag of the product, the following request could be made instead:</p>
2334+
<p>To make the category update conditional on the ETag of the product, the following request could be made instead:</p>
23352335
<div class="sourceCode" id="cb100"><pre class="sourceCode json"><code class="sourceCode json"><span id="cb100-1"><a href="#cb100-1" aria-hidden="true" tabindex="-1"></a><span class="er">PATCH</span> <span class="er">http://host/service/Products(57)</span></span>
23362336
<span id="cb100-2"><a href="#cb100-2" aria-hidden="true" tabindex="-1"></a><span class="er">If-Match:</span> <span class="er">&quot;&lt;ETag&gt;&quot;</span></span>
23372337
<span id="cb100-3"><a href="#cb100-3" aria-hidden="true" tabindex="-1"></a></span>

docs/odata-protocol/odata-protocol.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4147,14 +4147,15 @@ for the record being updated.
41474147

41484148
::: example
41494149
Example <a id="antietag" href="#antietag">81</a>: `Category` is a single-valued nullable non-containment navigation property
4150-
on the product entity type. Note that an ETag used in the `If-Match` header in the request
4150+
on the product entity type. Note that an ETag used in the `If-Match` header in the following request
4151+
applies to the category currently associated with the product.
41514152
```json
41524153
PATCH http://host/service/Products(57)/Category
41534154
If-Match: "<ETag>"
41544155

41554156
{"CategoryID": 5}
41564157
```
4157-
applies to the category currently associated with the product. To make the category
4158+
To make the category
41584159
update conditional on the ETag of the product, the following request could be made instead:
41594160
```json
41604161
PATCH http://host/service/Products(57)

odata-protocol/11.4 Data Modification.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -75,14 +75,15 @@ for the record being updated.
7575

7676
::: example
7777
Example ##ex_antietag: `Category` is a single-valued nullable non-containment navigation property
78-
on the product entity type. Note that an ETag used in the `If-Match` header in the request
78+
on the product entity type. Note that an ETag used in the `If-Match` header in the following request
79+
applies to the category currently associated with the product.
7980
```json
8081
PATCH http://host/service/Products(57)/Category
8182
If-Match: "<ETag>"
8283

8384
{"CategoryID": 5}
8485
```
85-
applies to the category currently associated with the product. To make the category
86+
To make the category
8687
update conditional on the ETag of the product, the following request could be made instead:
8788
```json
8889
PATCH http://host/service/Products(57)

0 commit comments

Comments
 (0)