URL から BLOB を配置する

Put Blob From URL 操作では、指定した URL から BLOB の内容が読み取られた新しいブロック BLOB が作成されます。 この API は、バージョン 2020-04-08 以降で使用できます。

部分的な更新は、Put Blob From URLではサポートされていません。 既存の BLOB の内容は、新しい BLOB の内容で上書きされます。 ソース URL を使用してブロック BLOB のコンテンツの部分的な更新を実行するには、Put Block From URL API を Put Block Listと組み合わせて使用します。

ソース BLOB のサイズは、最大 5,000 メガバイト (MiB) までです。

依頼

Put Blob From URL は次のように構築できます。 HTTPS を使用することをお勧めします。 myaccount ストレージ アカウントの名前に置き換えます。

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

エミュレートされたストレージ サービスに対して要求を行う場合は、エミュレーター ホスト名と BLOB サービス ポートを 127.0.0.1:10000として指定し、その後にエミュレートされたストレージ アカウント名を指定します。

ストレージ エミュレーターでは、最大 2 ギビバイト (GiB) の BLOB サイズのみがサポートされます。

詳細については、「ローカルの Azure Storage 開発に Azurite エミュレーターを使用する」を参照してください。

URI パラメーター

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

要求ヘッダー

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

この操作では、特定の条件が満たされた場合にのみ、条件付きヘッダーを使用して BLOB を書き込むこともできます。 詳細については、「Blob Storage 操作の条件付きヘッダーを指定する」を参照してください。

要求ヘッダー (顧客が指定した暗号化キー)

次のヘッダーは、顧客が指定したキーを使用して BLOB を暗号化する要求で指定できます。 顧客が指定したキー (および対応するヘッダーのセット) を使用した暗号化は省略可能です。

要求本文

何一つ。

要求のサンプル

次の例は、ブロック BLOB を作成する要求を示しています。

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblockblob HTTP/1.1  
  
Request Headers:  
x-ms-version: 2020-04-08  
x-ms-date: <date>  
Content-Type: text/plain; charset=UTF-8  
x-ms-blob-content-disposition: attachment; filename="fname.ext"  
x-ms-blob-type: BlockBlob  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
x-ms-copy-source: https://myaccount.blob.core.windows.net/mycontainer/myblob
x-ms-expiry-option: RelativeToNow
x-ms-expiry-time: 30000
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  
Content-Length: 0

応答

応答には、HTTP 状態コードと一連の応答ヘッダーが含まれます。

状態コード

操作が成功すると、状態コード 201 (Created) が返されます。

状態コードの詳細については、「状態コードとエラー コードを参照してください。

応答ヘッダー

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

応答本文

何一つ。

応答のサンプル

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Content-MD5: sQqNsWTgdUEFt6mb5y4/5Q==  
x-ms-content-crc64: 77uWZTolTHU
Date: <date>  
ETag: "0x8CB171BA9E94B0B"  
Last-Modified: <date>  
Access-Control-Allow-Origin: http://contoso.com  
Access-Control-Expose-Headers: Content-MD5  
Access-Control-Allow-Credentials: True  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-version-id: <DateTime>  

認可

Azure Storage でデータ アクセス操作を呼び出す場合は、承認が必要です。 次の説明に従って、Put Blob From URL 操作を承認できます。

要求で x-ms-tags 要求ヘッダーを持つタグが指定されている場合、呼び出し元は、BLOB タグの設定 操作の承認要件を満たす必要があります。

備考

Put Blob From URL 操作は、バージョン 2020-04-08 以降でサポートされています。

バージョン 2020-10-02 以降では、コピー操作のソースに対して Microsoft Entra 承認がサポートされています。

ソース BLOB には、ブロック BLOB、追加 BLOB、ページ BLOB など、任意の種類を指定できます。 ただし、ターゲット BLOB はブロック BLOB である必要があります。

Put Blob From URL 操作では、常にソース BLOB 全体がコピーされます。 バイト範囲またはブロックのセットのコピーはサポートされていません。 部分的な更新を実行するには、「URL からブロック 」を参照してください。 コピー先 BLOB は、既存のブロック BLOB にすることも、操作によって作成された新しい BLOB にすることもできます。

ブロック BLOB をソース オブジェクトとして使用している場合は、コミットされたすべての BLOB コンテンツがコピーされます。 ただし、ブロック リストは保持されず、コミットされていないブロックはコピーされません。 コピー先 BLOB の内容はソースの内容と同じですが、コミットされたブロック リストは保持されません。

Put BLOB のプロパティとメタデータの の

コピー ソースからブロック BLOB を作成する場合、標準の BLOB プロパティは既定でソース BLOB からコピーされます。 要求でアプリケーション メタデータが指定されている場合は、ソース BLOB メタデータをコピーせずに格納されます。 HTTP コンテンツ ヘッダーを明示的に設定するには、要求で対応するヘッダーを指定します。

• Content-Type

• Content-Encoding

• Content-Length

• Cache-Control

• Content-Disposition

コピー先 BLOB のサイズは、常にソース BLOB のサイズと一致します。 Content-Length ヘッダーは、Put Blob From URL 要求で 0 である必要があります (要求本文がないため)。宛先 BLOB のコンテンツ長プロパティは、ソースのサイズから推論されます。

URL から BLOB を配置するカスタム プロパティ

Put Blob From Url は、標準の HTTP ヘッダーに関連付けられているカスタム プロパティを設定する Put Blob と同じセマンティクスに従います。 詳細については、「BLOB カスタム プロパティ を参照してください。

BLOB インデックス タグの

宛先 BLOB のタグが x-ms-tags ヘッダーに指定されている場合は、クエリ文字列でエンコードする必要があります。 タグ キーと値は、Set Blob Tagsで指定されている名前付けと長さの要件に準拠している必要があります。 また、x-ms-tags ヘッダーは、最大2 KiBのタグを含み得る。 さらにタグが必要な場合は、Set Blob Tags 操作を使用します。

x-ms-tags ヘッダーにタグが指定されていない場合、それらはソース BLOB からコピーされません。

暗号化スコープと顧客が提供するキー

Put Blob From URL API では、x-ms-encryption-scope ヘッダーと x-ms-encryption-key ヘッダーをそれぞれ使用して、暗号化スコープと顧客が指定したキーの両方をサポートしています。

x-ms-copy-source ヘッダーが要求 URI の宛先 BLOB と同じソース BLOB を参照している場合、Put Blob From URL 操作は BLOB の同期インプレース書き換えを実行します。 これにより、BLOB を書き換えて別の暗号化キーまたは暗号化スコープを使用できるようになります。

請求

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

¹書き込みを開始するために、1 つのトランザクションに対して宛先アカウントに課金されます。
²ソース アカウントでは、ソース オブジェクトへの読み取り要求ごとに 1 つのトランザクションが発生します。

さらに、送信元アカウントと移行先アカウントが異なるリージョン (たとえば、米国北部と米国南部) に存在する場合、要求の転送に使用される帯域幅は、エグレスとしてソース ストレージ アカウントに課金されます。 同じリージョン内のアカウント間のエグレスは無料です。

最後に、同じストレージ アカウント内に別の名前を持つ新しい BLOB を作成すると、追加のストレージ リソースが使用されるため、操作によって、それらの追加リソースに対するストレージ アカウントの容量使用量に対する料金が発生します。

指定した課金カテゴリの価格については、Azure Blob Storage の価格に関するページを参照してください。

関連項目

Blob service のエラー コードAzure Storageの状態とエラー コードに対する要求の承認BLOB サービス操作のタイムアウトを設定する