取得 Blob 屬性

該 Get Blob Properties 作返回 blob 的所有使用者定義的元數據、標準 HTTP 屬性和系統屬性。它不會返回 blob 的內容。

Request

您可以建構 Get Blob Properties 要求，如下所示。建議您使用 HTTPS。以記憶體帳戶的名稱取代 myaccount。

HEAD 方法請求 URI	HTTP version
`https://myaccount.blob.core.windows.net/mycontainer/myblob` `https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>` `https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>`	HTTP/1.1

仿真的記憶體服務 URI

對模擬的儲存服務發出請求時，請將模擬器主機名和 Azure Blob 儲存埠指定為 127.0.0.1:10000，後跟類比的儲存帳戶名稱：

HEAD 方法請求 URI	HTTP version
`http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob`	HTTP/1.1

如需詳細資訊，請參閱使用 Azure 儲存體模擬器進行開發和測試。

URI parameters

您可以在要求 URI 上指定下列其他參數：

Parameter	Description
`snapshot`	Optional. 快照參數是一個不透明 `DateTime` 的值，如果存在，則指定要檢索的 blob 快照。有關使用 blob 快照的詳細資訊，請參閱創建 blob 的快照。
`versionid`	Optional. 版本 2019-12-12 及更高版本。該 `versionid` 參數是一個不透明 `DateTime` 的值，如果存在，則指定要檢索的 blob 的版本。
`timeout`	Optional. `timeout` 參數是以秒為單位來表示。有關詳細資訊，請參閱為 Blob 儲存作設置超時。

Request headers

下表描述必要和選擇性的要求標頭。

Request header	Description
`Authorization`	Required. 指定授權配置、帳戶名稱和簽章。如需詳細資訊，請參閱授權對 Azure 記憶體的要求。
`Date` 或 `x-ms-date`	Required. 指定要求的國際標準時間（UTC）。如需詳細資訊，請參閱授權對 Azure 記憶體的要求。
`x-ms-version`	所有已授權要求的必要專案。對於匿名請求，可選。指定要用於此要求的作業版本。如需詳細資訊，請參閱 Azure 儲存體服務的版本。
`x-ms-lease-id: <ID>`	Optional. 如果指定此標頭，則僅當滿足以下兩個條件時才會執行作 `Get Blob Properties` ： - blob 的租約當前處於活動狀態。 - 請求中指定的租約ID與 blob 的租約ID匹配。如果不滿足這些條件中的任何一個，則請求將失敗，並且 `Get Blob Properties` 作將失敗，狀態代碼為 412（先決條件失敗）。
`x-ms-upn`	Optional. 版本 2020-06-12 及更高版本。適用於啟用了分層命名空間的帳戶。如果為 true，則中 `x-ms-groupx-ms-acl`傳回`x-ms-owner`的使用者標識值和響應標頭將從 Microsoft Entra 物件 ID 轉換為使用者主體名稱。如果該值為 false，則它們將作為 Microsoft Entra 物件 ID 返回。預設值為 false。請注意，不會翻譯組和應用程式物件ID，因為它們沒有唯一的友好名稱。
`x-ms-client-request-id`	Optional. 提供用戶端生成的不透明值，其字元限制為 1 KB （KiB），啟用存儲分析日誌記錄時，該值將記錄在分析日誌中。強烈建議您在將用戶端活動與伺服器所接收的要求相互關聯時，請使用此標頭。有關詳細資訊，請參閱關於 Azure 存儲分析日誌記錄。

此作還支援僅在滿足指定條件時使用條件標頭返回 blob 屬性和元數據。如需詳細資訊，請參閱指定 Blob 記憶體作業的條件式標頭。

要求標頭（客戶提供的加密金鑰）

從版本 2019-02-02 開始，可以在請求中指定以下標頭，以讀取使用客戶提供的密鑰加密的 blob。使用客戶提供的金鑰（和相應的標頭集）進行加密是可選的。如果以前已使用客戶提供的密鑰對 blob 進行加密，則必須在請求中包含這些標頭，以便成功完成讀取作。

Request header	Description
`x-ms-encryption-key`	Required. Base64 編碼的 AES-256 加密金鑰。
`x-ms-encryption-key-sha256`	Optional. 加密金鑰的Base64編碼SHA256哈希。
`x-ms-encryption-algorithm: AES256`	Required. 指定要用於加密的演算法。此標頭的值必須設定為 `AES256`。

Request body

None.

Response

回應包含 HTTP 狀態代碼和一組響應標頭。

Status code

成功的作業會傳回狀態代碼 200 （確定）。

如您需狀態代碼的詳細資訊，請參閱狀態和錯誤碼。

Response headers

此作業的回應包含下表中的標頭。回應也可能包含額外的標準 HTTP 標頭。所有標準標頭都符合 HTTP/1.1 通訊協定規格，。

Response header	Description
`Last-Modified`	上次修改 blob 的日期/時間。日期格式遵循 RFC 1123。如需詳細資訊，請參閱代表標頭中的日期/時間值。修改 blob 的任何作（包括更新 blob 的元資料或屬性）都會更改 blob 的上次修改時間。請注意，對於大於 4 TiB 的託管磁碟和託管磁碟快照，不會返回。`Last-Modified`
`x-ms-creation-time`	版本 2017-11-09 及更高版本。創建 blob 的日期/時間。日期格式遵循 RFC 1123。如需詳細資訊，請參閱代表標頭中的日期/時間值。
`x-ms-meta-name:value`	一組名稱-值對，對應於與此 blob 關聯的使用者定義元數據。
`x-ms-tag-count`	版本 2019-12-12 及更高版本。如果 blob 有任何標記，則返回存儲在 blob 上的標記數。如果 blob 上沒有標記，則不會返回此標頭。
`x-ms-blob-type:<BlockBlob\\|PageBlob\\|AppendBlob>`	Blob 類型。
`x-ms-copy-completion-time:<datetime>`	版本 2012-02-12 及更高版本。上次嘗試 `Copy Blob` 的作的結束時間，其中此 blob 是目標 blob。這個值可以指定完成、中止或失敗複製嘗試的時間。如果副本處於掛起狀態、此 blob 從未是作中的`Copy Blob`目標，或者如果此 blob 在使用 `Set Blob Properties`、 `Put Blob`或 `Put Block List`的已結束`Copy Blob`作後已修改，則不會顯示此標頭。
`x-ms-copy-status-description: <error string>`	版本 2012-02-12 及更高版本。僅當 `x-ms-copy-status` 是 `failed` 或 `pending`時才顯示。描述嚴重或非嚴重複製作業失敗的原因。如果此 blob 從未是作中的`Copy Blob`目標，或者此 blob 在使用 `Set Blob Properties`、 `Put Blob`或的`Put Block List`結束`Copy Blob`作後已修改，則不會顯示此標頭。
`x-ms-copy-id: <id>`	版本 2012-02-12 及更高版本。上次嘗試 `Copy Blob` 的作的字元串標識符，其中此 blob 是目標 blob。如果此 blob 從未是作中的`Copy Blob`目標，或者此 blob 在使用 `Set Blob Properties`、 `Put Blob`或的`Put Block List`結束`Copy Blob`作後已修改，則不會顯示此標頭。
`x-ms-copy-progress: <bytes copied/bytes total>`	版本 2012-02-12 及更高版本。包含上次嘗試 `Copy Blob` 的作中複製的位元組數和源中的總位元組數，其中此 blob 是目標 blob。可以顯示從 0 到 `Content-Length` 複製的位元組。如果此 blob 從未是作中的`Copy Blob`目標，或者此 blob 在使用 `Set Blob Properties`、 `Put Blob`或的`Put Block List`結束`Copy Blob`作後已修改，則不會顯示此標頭。
`x-ms-copy-source: url`	版本 2012-02-12 及更高版本。長度不超過 2 KiB 的 URL，用於指定上次嘗試 `Copy Blob` 作中使用的源 Blob，其中此 Blob 是目標 Blob。如果此 blob 從未是作中的`Copy Blob`目標，或者此 blob 在使用 `Set Blob Properties`、 `Put Blob`或的`Put Block List`結束`Copy Blob`作後已修改，則不會顯示此標頭。
`x-ms-copy-status: <pending \\| success \\| aborted \\| failed>`	版本 2012-02-12 及更高版本。由 x-ms-copy-id 標識的複製作的狀態，具有以下值： - `success`：複製成功完成。 - `pending`：複製正在進行中。檢查 `x-ms-copy-status-description` 間歇性非致命錯誤是否阻礙複製進度，但不會導致失敗。 - `aborted`：副本由結束。`Abort Copy Blob` - `failed`：複製失敗。如需失敗詳細數據，請參閱 `x-ms-copy-status-description`。如果此 blob 從未是作中的`Copy Blob`目標，或者此 blob 在使用 `Set Blob Properties`、 `Put Blob`或`Put Block List`的完成`Copy Blob`作後已修改，則不會顯示此標頭。
`x-ms-incremental-copy: true`	版本 2016-05-31 和更新版本。如果 blob 是增量副本 blob，則包括在內。
`x-ms-copy-destination-snapshot:<datetime>`	版本 2016-05-31 和更新版本。如果 blob 是增量複製 blob 或增量副本快照，則包括在內，如果 `x-ms-copy-status` 是 success。此 Blob 上次成功增量複製快照集的快照集時間。
`x-ms-lease-duration: <infinite \\| fixed>`	當 Blob 租用時，指定租用是無限期還是固定持續時間。包括在使用版本 2012-02-12 及更高版本的請求中。
`x-ms-lease-state: <available \\| leased \\| expired \\| breaking \\| broken>`	Blob 的租約狀態。包括在使用版本 2012-02-12 及更高版本的請求中。
`x-ms-lease-status:<locked\\| unlocked>`	blob 的租約狀態。
`Content-Length`	Blob 的大小（以位元組為單位）。對於頁 blob，此標頭返回與 blob 一起存儲的標頭的 `x-ms-blob-content-length` 值。
`Content-Type`	為 blob 指定的內容類型。如果未指定內容類型，預設內容類型會 `application/octet-stream`。
`Etag`	ETag 包含一個值，可用來有條件地執行作業。如需詳細資訊，請參閱指定 Blob 記憶體作業的條件式標頭。如果要求版本是 2011-08-18 或更新版本，ETag 值會以引號括住。
`Content-MD5`	如果已為 blob 設置標頭，則 `Content-MD5` 返回此響應標頭，以便用戶端可以檢查消息內容的完整性。在版本 2012-02-12 及更高版本中， `Put Blob` 即使請求不包含 MD5 標頭，也會 `Put Blob` 設置塊 blob 的 MD5 值。
`Content-Encoding`	如果之前已為 blob 設置了請求標頭，則 `Content-Encoding` 在此標頭中返回該值。
`Content-Language`	如果之前已為 blob 設置了請求標頭，則 `Content-Language` 在此標頭中返回該值。
`Content-Disposition`	如果之前已為 blob 設置了請求標頭，則 `Content-Disposition` 對於針對版本 2013-08-15 及更高版本的請求，將在此標頭中返回該值。 `Content-Disposition`響應標頭字段傳達有關如何處理回應有效負載的其他資訊，也可用於附加其他元數據。例如，如果標頭設置為 `attachment`，則表示使用者代理不應顯示回應，而是顯示“另存為”對話框。
`Cache-Control`	如果之前已為 blob 設置了請求標頭，則 `Cache-Control` 在此標頭中返回該值。
`x-ms-blob-sequence-number`	分頁 Blob 的目前序號。不會為塊 blob 或追加 blob 傳回此標頭。不會為塊 blob 傳回此標頭。
`x-ms-request-id`	此標頭唯一標識發出的請求，您可以使用它對請求進行故障排除。如需詳細資訊，請參閱針對 API 作業進行疑難解答。
`x-ms-version`	指示用於執行請求的 Blob 儲存版本。對於針對版本 2009-09-19 及更高版本發出的請求，將返回此標頭。如果容器使用 Blob 儲存版本 2009-09-19 標記為公共訪問，則對於沒有指定版本的匿名請求，也會返回此標頭。
`Date`	服務生成的 UTC 日期/時間值，指示啟動回應的時間。
`Accept-Ranges: bytes`	表示服務支援部分 Blob 內容的要求。包括使用版本 2013-08-15 及更高版本發出的請求。
`x-ms-blob-committed-block-count`	Blob 中存在的已認可區塊數目。此標頭只會針對附加 Blob 傳回。
`x-ms-server-encrypted: true/false`	版本 2015-12-11 及更高版本。如果 blob 資料和應用程式元數據使用指定的演算法完全加密，則此標頭的值將設置為 `true` 。否則，該值設定為 `false` （當 blob 未加密時，或者如果僅加密了部分 blob/應用程式元資料）。
`x-ms-encryption-key-sha256`	版本 2019-02-02 和更新版本。如果 blob 使用客戶提供的金鑰進行加密，則返回此標頭。
`x-ms-encryption-context`	版本 2021-08-06 及更高版本。如果已設定加密內容屬性值，則會傳回 set 值。只有在帳戶啟用階層命名空間時才有效。
`x-ms-encryption-scope`	版本 2019-02-02 和更新版本。如果 blob 使用加密範圍進行加密，則返回此標頭。
`x-ms-access-tier`	版本 2017-04-17 和更新版本。高級存儲帳戶上的頁 blob 層或 blob 儲存或常規用途 v2 帳戶中的塊 blob 層。如需允許的進階分頁 Blob 層清單，請參閱 VM 的高效能進階記憶體和受控磁碟。針對 Blob 記憶體或一般用途 v2 帳戶，有效值為 `Hot`、`Cool`、`Cold`和 `Archive`。注意：2021-12-02 版和更新版本支援`Cold` 層。有關標準 Blob 帳戶塊 Blob 級分層的詳細資訊，請參閱熱存儲層、冷存儲層和存檔存儲層。
`x-ms-access-tier-inferred: true`	版本 2017-04-17 和更新版本。僅適用於高級存儲帳戶上的頁 Blob。如果未在 blob 上顯式設定存取層，則會根據其內容長度推斷該層，並傳回此標頭的值 `true`為。對於 Blob 儲存或常規用途 v2 帳戶上的塊 Blob，如果 Blob 未設置訪問層，則可以從存儲帳戶屬性推斷層。僅當推斷塊 blob 層時，才會設置此標頭。
`x-ms-archive-status`	版本 2017-04-17 和更新版本。對於 blob 儲存或常規用途 v2 帳戶，有效值為 `rehydrate-pending-to-hot`、和 `rehydrate-pending-to-coolrehydrate-pending-to-cold`。如果正在解除凍結 blob 且不完整，則返回此標頭，該標頭既指示解除凍結處於掛起狀態，又顯示目標層。有關標準 Blob 帳戶塊 Blob 級分層的詳細資訊，請參閱熱存儲層、冷存儲層和存檔存儲層。
`x-ms-access-tier-change-time`	版本 2017-04-17 和更新版本。指示上次更改物件上的層的時間。僅當設置了塊 blob 上的層時，才會返回此標頭。日期格式遵循 RFC 1123。如需詳細資訊，請參閱代表標頭中的日期/時間值。有關標準 blob 帳戶塊 blob 級分層的詳細資訊，請參閱熱存儲層、冷存儲層和存檔存儲層。
`x-ms-client-request-id`	可用來針對要求及其對應的回應進行疑難解答。此標頭的值等於標頭的 `x-ms-client-request-id` 值（如果請求中存在），並且該值最多為 1,024 個可見的 ASCII 字元。如果要求中沒有 `x-ms-client-request-id` 標頭，則響應中沒有此標頭。
`x-ms-rehydrate-priority`	版本 2019-12-12 及更高版本。如果對象處於解除凍結擱置狀態，則會以解除凍結的優先順序傳回此標頭。合法值為 `High`/`Standard`。有關標準 Blob 帳戶塊 Blob 級分層的詳細資訊，請參閱熱存儲層、冷存儲層和存檔存儲層。
`x-ms-or-{policy-id}_{rule-id}`	版本 2019-12-12 及更高版本，僅針對塊 blob 返回。 `policy-id` 是一個 GUID 值，表示儲存帳戶上物件複製策略的標識碼。 `rule-id` 是一個 GUID 值，表示 blob 容器上策略規則的標識碼。如果帳戶已 `ObjectReplication`啟用，則此標頭的值表示具有給定策略和規則標識碼（ `complete` 或 `failed`）的 blob 的複製狀態。
`x-ms-or-policy-id`	版本 2019-12-12 及更高版本，僅針對塊 blob 返回。如果帳戶是 `ObjectReplication`-enabled，則此標頭的值表示管理複製的策略。
`x-ms-last-access-time`	版本 2020-02-10 及更高版本。指示上次根據存儲帳戶的上次訪問時間跟蹤策略訪問 blob 資料的時間。如果存儲帳戶沒有上次訪問時間跟蹤策略，或者該策略已禁用，則不會返回標頭。有關設置存儲帳戶的上次訪問時間跟蹤策略的資訊，請參閱 Blob 儲存 API。
`x-ms-blob-sealed`	版本 2019-12-12 及更高版本，僅針對追加 blob 返回。如果追加 blob 已密封，則該值將為 true。有關詳細資訊，請參閱追加 Blob Seal
`x-ms-immutability-policy-until-date`	版本 2020-06-12 及更高版本。指定在 blob 上設置的「保留期至」日期。這是可以保護 blob 不被修改或刪除的日期。僅當在 blob 上設置了不可變性策略時才返回。此標頭的值RFC1123格式。
`x-ms-immutability-policy-mode: unlocked/locked`	版本 2020-06-12 及更高版本。如果在 blob 上設置了不可變性策略，則返回不可變性策略模式。值為 `unlocked`/`locked`。 `unlocked` 表示用戶可以通過增加或減少保留期限來更改策略。 `locked` 表示禁止這些行為。
`x-ms-legal-hold: true/false`	版本 2020-06-12 及更高版本。如果 blob 沒有合法保留，則不會返回此標頭。如果 blob 包含合法保留，並且其值為 true，則此標頭的值設置為 true。否則，如果 blob 包含合法保留，並且其值為 false，則該值將設置為 false。
`x-ms-owner`	版本 2020-06-12 及更高版本。僅適用於啟用了分層命名空間的帳戶。返回檔案或目錄的所有者使用者。
`x-ms-group`	版本 2020-06-12 及更高版本。僅適用於啟用了分層命名空間的帳戶。返回檔案或目錄的所有者組。
`x-ms-permissions`	版本 2020-06-12 及更高版本。僅適用於啟用了分層命名空間的帳戶。返回在檔或目錄上為使用者、組和其他人設置的許可權。每個單獨的許可權都是格式化的 `[r,w,x,-]{3}` 。
`x-ms-acl`	版本 2023-11-03 及更高版本。僅適用於啟用了分層命名空間的帳戶。返回為檔案或目錄上的使用者、組和其他人設置的訪問和預設訪問控制清單的組合清單。每個訪問控制條目（ACE）由範圍、類型、使用者或組識別碼以及格式 `[scope]:[type]:[id]:[permissions]`為的許可權組成。作用域指示 `default` ACE 屬於目錄的預設 ACL;否則作用域是隱式的，並且 ACE 屬於訪問 ACL。每個單獨的許可權都是格式化的 `[r,w,x,-]{3}` 。
`x-ms-resource-type`	版本 2020-10-02 及更高版本。僅適用於啟用了分層命名空間的帳戶。傳回路徑的資源類型，可以是 `file` 或 `directory`。
`x-ms-expiry-time`	版本 2020-02-10 及更高版本。僅適用於啟用了分層命名空間的帳戶。返回在 blob 上設置的過期時間。僅針對設置了過期時間的檔返回。

Response body

None.

Sample response

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-meta-Name: myblob.txt  
x-ms-meta-DateUploaded: <date>  
x-ms-blob-type: AppendBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CAE97120C1FF22"  
Accept-Ranges: bytes  
x-ms-blob-committed–block-count: 1  
x-ms-version: 2015-02-21  
Last-Modified: <date>  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>

Authorization

在 Azure 記憶體中呼叫任何數據存取作業時，需要授權。您可以授權 Get Blob Properties 作業，如下所示。

Important

Microsoft建議搭配受控識別使用 Microsoft Entra ID 來授權對 Azure 記憶體的要求。相較於共用密鑰授權，Microsoft Entra ID 提供更高的安全性和易於使用性。

Azure 儲存體支援使用 Microsoft Entra ID 來授權對 Blob 資料的要求。使用 Microsoft Entra 識別符，您可以使用 Azure 角色型存取控制（Azure RBAC）將權限授與安全性主體。安全性主體可能是使用者、群組、應用程式服務主體或 Azure 受控識別。安全性主體會由 Microsoft Entra ID 驗證，以傳回 OAuth 2.0 令牌。令牌接著可用來授權對 Blob 服務的要求。

若要深入瞭解使用 Microsoft Entra 識別符進行授權，請參閱使用 Microsoft Entra ID授權 Blob 存取權。

Permissions

以下列出Microsoft Entra 使用者、群組、受控識別或服務主體呼叫 Get Blob Properties 作業所需的 RBAC 動作，以及包含此動作的最低特殊許可權內建 Azure RBAC 角色：

Azure RBAC作：Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
最低特權內置角色：存儲 Blob 數據讀取者

若要深入瞭解如何使用 Azure RBAC 指派角色，請參閱指派 Azure 角色以存取 blob 資料。

共用存取簽章（SAS）可為記憶體帳戶中的資源提供安全的委派存取權。透過 SAS，您可以更細微地控制用戶端如何存取數據。您可以指定用戶端可存取哪些資源、這些資源具有哪些許可權，以及 SAS 有效時間。

Get Blob Properties 作業支援三種類型的共用存取簽章：使用者委派 SAS、服務 SAS和帳戶 SAS。

作為安全性最佳做法，我們建議您使用 Microsoft Entra 認證，而不是記憶體帳戶密鑰，這更容易遭到入侵。如果您的應用程式設計需要共用存取簽章，請盡可能使用 Microsoft Entra 認證來建立使用者委派 SAS。

不允許記憶體帳戶的共用密鑰存取時，Blob 記憶體的要求不允許服務 SAS 令牌或帳戶 SAS 令牌。若要深入瞭解，請參閱瞭解不允許共用密鑰如何影響 SAS 令牌。

使用者委派 SAS

使用者委派 SAS 會使用 Microsoft Entra 認證，以及透過為 SAS 指定的權限來加以保護。

使用委託給容器或 blob 資源的 SAS 令牌調用作需要Get Blob Properties讀取（r） 權限作為使用者委派 SAS 令牌的一部分。

若要深入瞭解使用者委派 SAS，請參閱建立使用者委派 SAS。

Service SAS

服務 SAS 會使用儲存體帳戶金鑰加以保護。服務 SAS 會將存取權委派給單一 Azure 記憶體服務中的資源，例如 Blob 記憶體。

使用委託給容器或 blob 資源的 SAS 令牌調用作需要Get Blob Properties讀取（r） 權限作為服務 SAS 令牌的一部分。

若要深入瞭解服務 SAS，請參閱建立服務 SAS。

Account SAS

帳戶 SAS 會使用儲存體帳戶金鑰加以保護。帳戶 SAS 會將存取權委派給一或多個記憶體服務中的資源。透過服務或使用者委派 SAS 提供的所有作業，也可透過帳戶 SAS 取得。

下表指出委派存取權時要指定的已簽署資源類型和已簽署權限：

Operation	Signed service	已簽署的資源類型	Signed permission
取得 Blob 屬性	Blob (b)	Object (o)	Read (r)

若要深入瞭解帳戶 SAS，請參閱建立帳戶 SAS。

Remarks

若要確定作是否 Copy Blob 已完成，請首先檢查以確保 x-ms-copy-id 標頭值與原始調用 Copy Blob提供的副本 ID 匹配。匹配可確保另一個應用程式不會中止副本並啟動新 Copy Blob 作。接下來，檢查 x-ms-copy-status: success 標題。但請注意，除、和Put BlockPut Page作之外，對 Leaseblob 的所有寫入作都會從 blob 中刪除所有x-ms-copy-*屬性。使用 2012-02-12 之前版本的作也不會複製 Copy Blob 這些屬性。

x-ms-copy-status-description 包含有關失敗的更多資訊 Copy Blob 。下表描述了這些 x-ms-copy-status-description 值：

Component	Description
HTTP 狀態代碼	指定失敗的標準 3 位整數。
Error code	描述 Azure 在 ErrorCode> 元素中<提供的錯誤的關鍵字。如果未 <顯示 ErrorCode> 元素，則使用與 HTTP 規範中的 3 位 HTTP 狀態代碼關聯的具有標準錯誤文本的關鍵字。如需詳細資訊，請參閱常見 REST API 錯誤碼。
Information	故障的詳細說明，用引弧括起來。

x-ms-copy-status下表描述了常見故障方案的和 x-ms-copy-status-description 值：

Important

即使沒有版本更改，以下錯誤描述也可能在沒有警告的情況下更改，因此文本可能不完全匹配。

Scenario	x-ms-copy-status value	x-ms-copy-status-description value
複製作業成功完成。	success	empty
用戶在複製作完成之前中止了複製作。	aborted	empty
在複製作期間從源 blob 讀取時發生故障，但將重試該作。	pending	502 BadGateway「讀取來源時發生可重試的錯誤。 Will retry. 失效時間： <time>”
寫入複製作的目標 blob 時發生故障，但將重試該作。	pending	500 InternalServerError「遇到可重試的錯誤。 Will retry. 失效時間： <time>”
從複製作業的來源 Blob 讀取時發生無法復原的失敗。	failed	404 ResourceNotFound 「讀取源時複製失敗」。注意：當服務報告此基礎錯誤時，它會在 ErrorCode> 元素中<返回`ResourceNotFound`。如果回應中未 <出現 ErrorCode> 元素，則會出現 HTTP 狀態的標準字串表示形式，例如 `NotFound`。
限制所有複製作業經過的逾時期間。（目前，超時期限為兩周。	failed	500 OperationCancelled「複製超過允許的時間上限」。
從源讀取時，複製作經常失敗，並且未達到嘗試與成功的最低比率。（此逾時可防止在失敗前兩周內重試非常糟糕的來源。	failed	500 OperationCancelled「讀取來源時複製失敗」。

x-ms-last-access-time 根據存儲帳戶的上次訪問時間跟蹤策略，跟蹤訪問 Blob 資料的時間。訪問 blob 的元資料不會更改其上次存取時間。

Billing

定價要求可能來自使用 Blob 記憶體 API 的用戶端，無論是直接透過 Blob 記憶體 REST API，還是來自 Azure 記憶體用戶端連結庫。這些要求會依交易產生費用。交易類型會影響帳戶的收費方式。例如，讀取交易累算到與寫入交易不同的計費類別。下表根據記憶體帳戶類型顯示 Get Blob Properties 要求的計費類別：

Operation	記憶體帳戶類型	Billing category
取得 Blob 屬性	進階區塊 Blob 標準一般用途 v2	Other operations
取得 Blob 屬性	標準一般用途 v1	Read operations

若要瞭解指定計費類別的定價，請參閱 azure Blob 記憶體定價。

共用方式為