更新實體
Update Entity 作業會更新資料表中的現有實體。 作業 Update Entity 會取代整個實體，而且您可以使用 作業來移除屬性。
要求
您可以依照下列方式建構 Update Entity 要求。 建議使用 HTTPS。 以儲存體帳戶的名稱取代 myaccount ，並以 mytable 資料表的名稱取代 myaccount。 以識別要更新之實體的資料分割索引鍵和資料列索引鍵名稱取代 myPartitionKey 和 myRowKey 。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
PUT |
https://myaccount.table.core.windows.net/mytable(PartitionKey='myPartitionKey', RowKey='myRowKey') |
HTTP/1.1 |
要更新之實體的位址可以在要求 URI 上採用許多表單。 如需詳細資訊，請參閱 OData 通訊協定 。
模擬儲存體服務 URI
當您對模擬儲存體服務提出要求時，請將模擬器主機名稱和 Azure 資料表儲存體埠指定為 127.0.0.1:10002 ，後面接著模擬的儲存體帳戶名稱。
| 方法 | 要求 URI | HTTP 版本 |
|---|---|---|
PUT |
http://127.0.0.1:10002/devstoreaccount1/mytable(PartitionKey='myPartitionKey', RowKey='myRowKey') |
HTTP/1.1 |
儲存體模擬器中的資料表儲存體與 Azure 資料表儲存體有數種方式不同。 如需詳細資訊，請參閱 儲存體模擬器與 Azure 儲存體服務之間的差異。
URI 參數
您可以在要求 URI 上指定下列其他參數。
| 參數 | 描述 |
|---|---|
timeout |
選擇性。
timeout 參數以秒為單位。 如需詳細資訊，請參閱 設定資料表儲存體作業的逾時。 |
要求標頭
下表描述必要的和選用的要求標頭。
| 要求標頭 | 描述 |
|---|---|
Authorization |
必要。 指定授權配置、帳戶名稱和簽章。 如需詳細資訊，請參閱授權對 Azure 儲存體提出要求。 |
Date 或 x-ms-date |
必要。 指定要求的「國際標準時間」(UTC)。 如需詳細資訊，請參閱授權對 Azure 儲存體提出要求。 |
x-ms-version |
選擇性。 指定用於這個要求的作業版本。 如需詳細資訊，請參閱 Azure 儲存體服務的版本。 |
Content-Type |
必要。 指定承載的內容類型。 可能的值是 application/atom+xml 和 application/json。如需有效內容類型的詳細資訊，請參閱 資料表儲存體作業的承載格式。 |
Content-Length |
必要。 要求本文的長度。 |
If-Match |
必要。 用戶端可以在要求上指定 ETag 實體的 ，以便與服務為了開放式平行存取而維護的 比較 ETag 。 只有在用戶端所傳送的 符合伺服器所維護的值時 ETag ，才會執行更新作業。 此比對表示實體自用戶端擷取後尚未修改。若要強制執行無條件更新，請將 If-Match 設為萬用字元 (*)。 |
x-ms-client-request-id |
選擇性。 提供用戶端產生的不透明值，其中包含 1-kibibyte (KiB) 設定記錄時記錄在記錄中的字元限制。 強烈建議您使用此標頭，將用戶端活動與伺服器收到的要求相互關聯。 如需詳細資訊，請參閱 監視 Azure 資料表儲存體。 |
要求本文
作業 Update Entity 會傳送要更新為 OData 實體集的實體，可以是 JSON 或 Atom 摘要。 如需詳細資訊，請參閱 插入和更新實體。
注意
JSON 是建議的承載格式，它是 2015-12-11 版和更新版本唯一支援的格式。
範例要求
JSON (2013-08-15 版和更新版本)
此範例顯示 JSON 摘要的範例要求 URI、相關聯的要求標頭和要求主體。
Request Headers:
x-ms-version: 2015-12-11
Accept-Charset: UTF-8
Content-Type: application/json
If-Match: *
x-ms-date: Mon, 27 Jun 2016 18:10:24 GMT
Authorization: SharedKeyLite myaccount:u0sWZKmjBD1B7LY/CwXWCnHdqK4B1P4z8hKy9SVW49o=
Content-Length: ###
DataServiceVersion: 3.0;NetFx
MaxDataServiceVersion: 3.0;NetFx
{
"Address":"Santa Clara",
"Age":23,
"AmountDue":200.23,
"CustomerCode@odata.type":"Edm.Guid",
"CustomerCode":"c9da6455-213d-42c9-9a79-3e9149a57833",
"CustomerSince@odata.type":"Edm.DateTime",
"CustomerSince":"2008-07-10T00:00:00",
"IsActive":false,
"NumberOfOrders@odata.type":"Edm.Int64",
"NumberOfOrders":"255",
"PartitionKey":"mypartitionkey",
"RowKey":"myrowkey"
}
Atom 摘要 (2015-12-11 之前的版本)
此範例顯示範例要求 URI、相關聯的要求標頭，以及 Atom 摘要的要求本文。
Request URI:
https://myaccount.table.core.windows.net/mytable(PartitionKey='myPartitionKey',RowKey='myRowKey')
Request Headers:
x-ms-version: 2013-08-15
Accept: application/atom+xml,application/xml
Accept-Charset: UTF-8
Content-Type: application/atom+xml
If-Match: *
x-ms-date: Wed, 20 Nov 2013 18:10:24 GMT
Authorization: SharedKeyLite myaccount:u0sWZKmjBD1B7LY/CwXWCnHdqK4B1P4z8hKy9SVW49o=
Content-Length: ###
DataServiceVersion: 1.0;NetFx
MaxDataServiceVersion: 2.0;NetFx
Request Body:
<?xml version="1.0" encoding="utf-8"?>
<entry xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">
<title />
<updated>2008-09-18T23:46:37.168836Z</updated>
<author>
<name />
</author>
<id>https://myaccount.table.core.windows.net/mytable(PartitionKey='mypartitionkey',RowKey='myrowkey')</id>
<content type="application/xml">
<m:properties>
<d:Address>Santa Clara</d:Address>
<d:Age m:type="Edm.Int32">23</d:Age>
<d:AmountDue m:type="Edm.Double">200.23</d:AmountDue>
<d:CustomerCode m:type="Edm.Guid">c9da6455-213d-42c9-9a79-3e9149a57833</d:CustomerCode>
<d:CustomerSince m:type="Edm.DateTime">2008-07-10T00:00:00Z</d:CustomerSince>
<d:IsActive m:type="Edm.Boolean">false</d:IsActive>
<d:NumOfOrders m:type="Edm.Int64">255</d:NumOfOrders>
<d:PartitionKey>mypartitionkey</d:PartitionKey>
<d:RowKey>myrowkey</d:RowKey>
</m:properties>
</content>
</entry>
回應
回應包括 HTTP 狀態碼和一組回應標頭。
狀態碼
成功的作業會傳回狀態碼 204 (沒有內容)。 如需狀態碼的相關資訊，請參閱 狀態和錯誤碼 和 資料表儲存體錯誤碼。
回應標頭
回應包含下列標頭。 回應也可以包含額外的標準 HTTP 標頭。 所有標準標頭都符合 HTTP/1.1 通訊協定規格。
| 回應標頭 | 描述 |
|---|---|
ETag |
實體 ETag 的 。 |
x-ms-request-id |
此標頭可唯一識別已提出的要求，並可用於對要求進行疑難排解。 如需詳細資訊，請參閱 針對 API 作業進行疑難排解。 |
x-ms-version |
指出用來執行要求的資料表儲存體版本。 對 2009-09-19 及更新版本提出要求會傳回此標頭。 |
Date |
UTC 日期/時間值，指出起始回應的時間。 服務會產生此值。 |
x-ms-client-request-id |
您可以使用此標頭來針對要求和對應的回應進行疑難排解。 如果此標頭存在於要求中，這個標頭的值會等於標頭的值 x-ms-client-request-id 。 此值最多為 1，024 個可見的 ASCII 字元。
x-ms-client-request-id如果要求中沒有標頭，則此標頭不會出現在回應中。 |
回應本文
無。
範例回應
Response Status:
HTTP/1.1 204 No Content
Response Headers:
Connection: Keep-Alive
x-ms-request-id: 2c085f8f-11a4-4e1d-bd49-82c6bd87649d
Content-Length: 0
Cache-Control: no-cache
Date: Mon, 27 Jun 2016 18:12:54 GMT
ETag: W/"0x5B168C7B6E589D2"
DataServiceVersion: 3.0;NetFx
MaxDataServiceVersion: 3.0;NetFx
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0
授權
帳戶擁有者可以執行這項作業。 此外，具有共用存取簽章的任何人都可以執行這項作業。
備註
當您更新實體時，您必須將 和 RowKey 系統屬性指定 PartitionKey 為更新作業的一部分。
實體會 ETag 提供更新作業的預設開放式平行存取。 此值 ETag 不透明，不應讀取或依賴。 在更新作業發生之前，資料表儲存體會確認實體的目前 ETag 值與標頭中 If-Match 更新要求中包含的值相同 ETag 。 如果值相同，資料表儲存體會判斷實體自擷取後尚未修改，而且更新作業會繼續進行。
如果實體 ETag 與更新要求指定的不同，更新作業會失敗，狀態碼為 412 (前置條件失敗) 。 此錯誤表示伺服器上的實體自擷取後已經變更。 若要解決這個錯誤，請重新擷取實體並重新發出要求。
若要強制執行無條件更新作業，請將要求中的 If-Match 標頭值設為萬用字元 (*)。 將此值傳遞至作業會覆寫預設開放式平行存取，並忽略值中的任何 ETag 不符。
If-Match如果 2011-08-18 版或更新版本中的要求遺漏標頭，服務會執行Insert 或 Replace Entity (upsert) 作業。 在 2011-08-18 之前的版本中，服務會傳回狀態碼 400 (不正確的要求) 。
資料表儲存體不會保存 null 屬性的值。 指定具有 null 值的屬性相當於省略要求中的該屬性。
注意
您可以利用任一行為，從實體中移除屬性。
若要明確輸入屬性，請在 Atom 摘要中設定 m:type 屬性定義內的屬性，以指定適當的 OData 資料類型。 如需輸入屬性的詳細資訊，請參閱 插入和更新實體。
任何可以授權和傳送 HTTP PUT 要求的應用程式都可以更新實體。
如需執行批次更新作業的相關資訊，請參閱 執行實體群組交易。