中止複製 Blob

  • 發行項

此 Abort Copy Blob 作業會取消擱置 Copy Blob 的作業，並保留長度為零和完整元數據的目的地 Blob。 這項作業適用於 2012-02-12 版和更新版本。

要求

Abort Copy Blob建構作業，如下所示。 建議使用 HTTPS。 請以您的儲存體帳戶名稱取代 myaccount，以您的容器名稱取代 mycontainer，並以您的目的地 Blob 名稱取代 myblob。 將取代<id>為原始Copy Blob作業標頭中x-ms-copy-id提供的複製標識碼。

從 2013-08-15 版開始，如果目的地 Blob 位於與來源 Blob 相同的帳戶中，您可以指定目的地 Blob 的共用存取簽章。 從 2015-04-05 版開始，如果目的地 Blob 位於不同的記憶體帳戶中，您也可以指定目的地 Blob 的共用存取簽章。

PUT 方法要求 URI HTTP 版本
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=copy&copyid=<id> HTTP/1.1

模擬記憶體服務 URI

當您對本機記憶體服務提出要求時，請將本機主機名和 Azure Blob 儲存體 埠指定為 127.0.0.1:10000，後面接著本機記憶體帳戶名稱：

PUT 方法要求 URI HTTP 版本
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=copy&copyid=<id> HTTP/1.1

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

URI 參數

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

參數 描述
timeout 選擇性。 timeout 參數以秒為單位。 如需詳細資訊，請參閱 設定 Blob 記憶體作業的逾時。

要求標頭

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

要求標頭 描述
Authorization 必要。 指定授權配置、帳戶名稱和簽章。 如需詳細資訊，請參閱授權對 Azure 儲存體提出要求。
Date 或 x-ms-date 必要。 指定要求的「國際標準時間」(UTC)。 如需詳細資訊，請參閱授權對 Azure 儲存體提出要求。
x-ms-version 所有授權要求都需要。 如需詳細資訊，請參閱 Azure 儲存體服務的版本。
x-ms-lease-id:<ID> 如果目的地 Blob 為作用中的無限期租用，則為必要項目。
x-ms-copy-action: abort 必要。
x-ms-client-request-id 選擇性。 提供客戶端產生的不透明值，其中包含 1-kibibyte (KiB) 設定記錄時記錄在記錄中的字元限制。 強烈建議您使用此標頭，將用戶端活動與伺服器收到的要求相互關聯。 如需詳細資訊，請參閱監視 Azure Blob 儲存體。

要求本文

無。

回應

回應包括 HTTP 狀態碼和一組回應標頭。

狀態碼

成功的作業會傳回狀態碼 204 (沒有內容)。 如需狀態代碼的相關信息，請參閱 狀態和錯誤碼。

回應標頭

這項作業的回應包括下列標頭。 回應也可能包括其他標準 HTTP 標頭。 所有標準標頭都符合 HTTP/1.1 通訊協議規格。

回應標頭 描述
x-ms-request-id 此標頭可唯一識別已提出的要求，並可用於對要求進行疑難解答。 如需詳細資訊，請參閱 針對 API 作業進行疑難解答。
x-ms-version 指出用來執行要求的 Blob 記憶體版本。
Date 服務產生的 UTC 日期/時間值，可指出啟動回應的時間。
x-ms-client-request-id 您可以使用此標頭來針對要求和對應的回應進行疑難解答。 如果此標頭存在於要求中， x-ms-client-request-id 這個標頭的值就等於標頭的值。 此值最多為1024個可見的ASCII字元。 x-ms-client-request-id如果要求中沒有標頭，則響應中沒有此標頭。

授權

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

Azure 記憶體支援使用 Microsoft Entra ID 來授權 Blob 數據的要求。 透過 Microsoft Entra ID，您可以使用 Azure 角色型存取控制 (Azure RBAC) ，將許可權授與安全性主體。 安全性主體可能是使用者、群組、應用程式服務主體或 Azure 受控識別。 安全性主體是由 Microsoft Entra ID 驗證，以傳回 OAuth 2.0 令牌。 權杖接著可以用來授權對 Blob 服務的要求。

若要深入瞭解使用 Microsoft Entra ID 授權，請參閱使用 Microsoft Entra ID 授權 Blob 的存取權。

權限

以下是 Microsoft Entra 使用者、群組或服務主體呼叫Abort Copy Blob作業所需的 RBAC 動作，以及包含此動作的最低特殊許可權 Azure RBAC 角色：

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

備註

當您取消擱置 Copy Blob 作業時，目的地 Blob 的 x-ms-copy-status 標頭會設定為 aborted。 取消複製作業會導致區塊 Blob、附加 Blob 和分頁 Blob 的目的地 Blob 長度為零。 不過，目的地 Blob 的元數據會從來源 Blob 複製新的值，或在作業呼叫中 Copy Blob 明確設定。 若要保留複製前的原始中繼資料，請對目的地 Blob 進行快照集，再呼叫 Copy Blob。

您只能取消擱置的複製作業。 嘗試取消已完成或失敗的複本會導致衝突錯誤。 嘗試使用不正確的複製標識碼取消複製作業也會導致衝突錯誤。

計費

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

作業 儲存體帳戶類型 計費類別
中止複製 Blob 進階區塊 Blob
標準一般用途 v2		 其他作業
中止複製 Blob 標準一般用途 v1 寫入作業

若要瞭解指定計費類別的定價，請參閱定價 Azure Blob 儲存體。

另請參閱

授權對 Azure 記憶體的要求
狀態和錯誤碼
Azure Blob 儲存體 錯誤碼
複製 Blob 作業