Abort Copy Blob

操作は Abort Copy Blob 保留中 Copy Blob の操作を取り消し、転送先 BLOB の長さと完全なメタデータを残します。 この操作は、バージョン 2012-02-12 以降に適用されます。

要求

操作を Abort Copy Blob 次のように構築します。 HTTPS が推奨されます。 myaccount をストレージ アカウントの名前で、mycontainer をコンテナーの名前で、myblob をコピー先 BLOB の名前でそれぞれ置き換えます。 を、元Copy Blobの操作のヘッダーで指定されたx-ms-copy-idコピー識別子に置き換えます<id>。

バージョン 2013-08-15 以降では、コピー先 BLOB がソース BLOB と同じアカウントにある場合は、その BLOB の共有アクセス署名を指定できます。 バージョン 2015-04-05 以降では、コピー先 BLOB が別のストレージ アカウントにある場合は、共有アクセス署名を指定することもできます。

PUT メソッド要求 URI	HTTP バージョン
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=copy&copyid=<id>	HTTP/1.1

エミュレートされたストレージ サービス URI

ローカル ストレージ サービスに対して要求を行う場合は、ローカル ホスト名と Azure Blob Storage ポートを として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 Storage の開発に Azurite エミュレーターを使用する方法に関するページを参照してください。

URI パラメーター

要求 URI には、次の追加パラメーターを指定できます。

パラメーター	説明
timeout	省略可能。 timeout パラメーターは、秒単位で表されます。 詳細については、「 Blob Storage 操作のタイムアウトの設定」を参照してください。

要求ヘッダー

必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。

要求ヘッダー	説明
Authorization	必須。 承認スキーム、アカウント名、署名を指定します。 詳細については、「Azure Storage への要求を承認する」をご覧ください。
Date または x-ms-date	必須。 要求に対して協定世界時 (UTC) を指定します。 詳細については、「Azure Storage への要求を承認する」をご覧ください。
x-ms-version	すべての承認された要求に必要です。 詳細については、「Azure Storage サービスのバージョン管理」を参照してください。
x-ms-lease-id:<ID>	コピー先 BLOB がアクティブな無限リースを保持している場合は必須です。
x-ms-copy-action: abort	必須。
x-ms-client-request-id	省略可能。 ログ記録の構成時にログに記録される 1 kibibyte (KiB) 文字制限を使用して、クライアントによって生成された不透明な値を提供します。 このヘッダーを使用して、クライアント側のアクティビティとサーバーが受信する要求を関連付けるよう強くお勧めします。 詳細については、「Azure Blob Storageの監視」を参照してください。

要求本文

[なし] :

Response

応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。

status code

操作が正常に終了すると、ステータス コード 204 (No Content) が返されます。 状態コードの詳細については、「 状態とエラー コード」を参照してください。

応答ヘッダー

この操作の応答には、次のヘッダーが含まれています。 応答に追加の標準 HTTP ヘッダーが含まれる場合もあります。 すべての標準ヘッダーは 、HTTP/1.1 プロトコル仕様に準拠しています。

応答ヘッダー	説明
x-ms-request-id	このヘッダーは、行われた要求を一意に識別し、要求のトラブルシューティングに使用できます。 詳細については、「 API 操作のトラブルシューティング」を参照してください。
x-ms-version	要求の実行に使用される Blob Storage のバージョンを示します。
Date	サービスによって生成される、応答の開始時刻を示す UTC 日付/時刻値。
x-ms-client-request-id	このヘッダーを使用して、要求と対応する応答のトラブルシューティングを行うことができます。 このヘッダーの値は、要求に存在する x-ms-client-request-id 場合、ヘッダーの値と同じです。 値は、最大で 1024 文字の可視 ASCII 文字です。 ヘッダーが x-ms-client-request-id 要求に存在しない場合、このヘッダーは応答に存在しません。

承認

Azure Storage でデータ アクセス操作を呼び出す場合は、承認が必要です。 操作は、以下で Abort Copy Blob 説明するように承認できます。

重要

Microsoft では、マネージド ID でMicrosoft Entra IDを使用して、Azure Storage への要求を承認することをお勧めします。 Microsoft Entra IDは、共有キーの承認と比較して優れたセキュリティと使いやすさを提供します。

Microsoft Entra ID (推奨)

Azure Storage では、Microsoft Entra ID を使用して BLOB データへの要求を承認することがサポートされています。 Microsoft Entra IDでは、Azure ロールベースのアクセス制御 (Azure RBAC) を使用して、セキュリティ プリンシパルにアクセス許可を付与できます。 セキュリティ プリンシパルには、ユーザー、グループ、アプリケーション サービス プリンシパル、または Azure マネージド ID を指定できます。 セキュリティ プリンシパルは、OAuth 2.0 トークンを返すためにMicrosoft Entra IDによって認証されます。 その後、そのトークンを、Blob service に対する要求を認可するために使用できます。

Microsoft Entra IDを使用した承認の詳細については、「Microsoft Entra IDを使用して BLOB へのアクセスを承認する」を参照してください。

アクセス許可

Microsoft Entraユーザー、グループ、マネージド ID、またはサービス プリンシパルが操作を呼び出Abort Copy Blobすために必要な RBAC アクションと、このアクションを含む最小特権の組み込み Azure RBAC ロールを次に示します。

• Azure RBAC アクション:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write (既存の BLOB への書き込み用) または Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action (新しい BLOB を宛先に書き込む場合)
• 最小特権の組み込みロール:ストレージ BLOB データ共同作成者

Azure RBAC を使用したロールの割り当ての詳細については、「 BLOB データにアクセスするための Azure ロールの割り当て」を参照してください。

共有アクセス署名 (SAS)

Shared Access Signature (SAS) は、ストレージ アカウント内のリソースへのセキュリティで保護された委任されたアクセスを提供します。 SAS を使用すると、クライアントがデータにアクセスする方法をきめ細かく制御できます。 クライアントがアクセスできるリソース、それらのリソースに対するアクセス許可、および SAS が有効な期間を指定できます。

この操作では Abort Copy Blob 、 ユーザー委任 SAS、 サービス SAS、 アカウント SAS の 3 種類の共有アクセス署名がサポートされています。

セキュリティのベスト プラクティスとして、ストレージ アカウント キーではなくMicrosoft Entra資格情報を使用することをお勧めします。これは、より簡単に侵害される可能性があります。 アプリケーション設計で共有アクセス署名が必要な場合は、Microsoft Entra資格情報を使用して、可能な場合はユーザー委任 SAS を作成します。

ストレージ アカウントに対して共有キーアクセスが許可されていない場合、Blob Storage への要求では、サービス SAS トークンまたはアカウント SAS トークンは許可されません。 詳細については、「 共有キーを禁止することが SAS トークンにどのように影響するかを理解する」を参照してください。

ユーザー委任 SAS

ユーザー委任 SAS は、Microsoft Entra資格情報と、SAS に対して指定されたアクセス許可によって保護されます。

BLOB リソースに Abort Copy Blob 委任された SAS トークンを使用して操作を呼び出すには、ユーザー委任 SAS トークンの一部として 書き込み (w) アクセス許可が必要です。

ユーザー委任 SAS の詳細については、「ユーザー委任 SAS のCreate」を参照してください。

サービス SAS

サービス SAS は、ストレージ アカウント キーで保護されます。 サービス SAS は、BLOB ストレージなどの単一の Azure Storage サービス内のリソースへのアクセスを委任します。

BLOB リソースに Abort Copy Blob 委任された SAS トークンを使用して操作を呼び出すには、サービス SAS トークンの一部として 書き込み (w) アクセス許可が必要です。

サービス SAS の詳細については、「サービス SAS のCreate」を参照してください。

アカウント SAS

アカウント SAS は、ストレージアカウント キーで保護されます。 アカウント SAS は、1 つ以上のストレージ サービスのリソースへのアクセスを委任します。 サービスまたはユーザー委任 SAS を介して実行できるすべての操作は、アカウント SAS を介しても実行できます。

次の表は、アクセスの委任時に指定する署名付きリソースの種類と署名付きアクセス許可を示しています。

操作	署名済みサービス	署名付きリソースの種類	署名されたアクセス許可
Abort Copy Blob	BLOB (b)	オブジェクト (o)	書き込み (w)

アカウント SAS の詳細については、「アカウント SAS のCreate」を参照してください。

共有キー

この操作では Abort Copy Blob 、 共有キーの承認がサポートされています。 アカウント キーを使用した承認は、セキュリティが低下するため、ほとんどのシナリオでは推奨されません。

可能な場合は、ストレージ アカウントの共有キーの承認を禁止することをお勧めします。 詳細については、「共有キーによる承認の防止」を参照してください。

注釈

保留中 Copy Blob の操作を取り消すと、ターゲット BLOB の x-ms-copy-status ヘッダーは に aborted設定されます。 コピー操作を取り消すと、ブロック BLOB、追加 BLOB、ページ BLOB の長さが 0 のコピー先 BLOB が作成されます。 ただし、コピー先 BLOB のメタデータには、ソース BLOB からコピーされた新しい値が含まれるか、操作呼び出しで明示的に設定されます Copy Blob 。 コピー前の元のメタデータを保持するには、Copy Blob を呼び出す前に、コピー先 BLOB のスナップショットを作成します。

キャンセルできるのは、保留中のコピー操作のみです。 完了または失敗したコピーを取り消そうとすると、競合エラーが発生します。 正しくないコピー ID を使用してコピー操作を取り消そうとすると、競合エラーも発生します。

請求

価格要求は、Blob Storage REST API を介して直接、または Azure Storage クライアント ライブラリを介して Blob Storage API を使用するクライアントから送信できます。 これらの要求では、トランザクションあたりの料金が発生します。 トランザクションの種類は、アカウントの課金方法に影響します。 たとえば、読み取りトランザクションは、書き込みトランザクションとは異なる課金カテゴリに計上されます。 次の表は、ストレージ アカウントの種類に基づく要求の課金カテゴリ Abort Copy Blob を示しています。

操作	ストレージ アカウントの種類	課金カテゴリ
Abort Copy Blob	Premium ブロック BLOB Standard 汎用 v2	その他の操作
Abort Copy Blob	Standard 汎用 v1	書き込み操作

指定した課金カテゴリの価格については、「Azure Blob Storage価格」を参照してください。

こちらもご覧ください

Azure Storage への要求を承認する
状態コードとエラー コード
エラー コードのAzure Blob Storage
BLOB のコピー操作