BLOBs の一覧

[アーティクル]
03/16/2023

操作は List Blobs 、指定されたコンテナーの下にある BLOB の一覧を返します。

要求

要求は List Blobs 次のように構築できます。 HTTPS が推奨されます。 myaccount をストレージアカウントの名前に置き換えます。

Method	要求 URI	HTTP バージョン
`GET`	`https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list`	HTTP/1.1

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

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

Method	要求 URI	HTTP バージョン
`GET`	`http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=list`	HTTP/1.1

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

URI パラメーター

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

パラメーター	説明
`prefix`	省略可能。結果をフィルター処理して、指定したプレフィックスで始まる名前の BLOB のみを返します。階層型名前空間を持つアカウントでは、ファイルの名前がプレフィックスパスの中央に表示される場合にエラーが発生します。たとえば、プレフィックスパス `folder1/folder2/readme/readmefile.txt`を使用して、という名前`readmefile.txt`の BLOB を見つけようとします。サブフォルダーにという名前 `readme`のファイルが含まれている場合、エラーが表示されます。
`delimiter`	省略可能。要求にこのパラメーターが含まれている場合、操作は応答本文で要素を返 `BlobPrefix` します。この要素は、区切り文字の外観まで、同じ部分文字列で始まる名前を持つすべての BLOB のプレースホルダーとして機能します。区切り記号には単一文字または文字列を使用できます。
`marker`	省略可能。次の一覧操作で返される一覧の部分を識別する文字列値です。返される一覧が完全ではなかった場合、操作では応答本文にマーカー値が返されます。その後、後続の呼び出しでマーカー値を使用して、リストアイテムの次のセットを要求できます。マーカー値はクライアントに対して非透過的です。
`maxresults`	省略可能。すべての `BlobPrefix` 要素も含め、返される BLOB の最大数を指定します。要求でを指定 `maxresults`しない場合、または 5,000 を超える値を指定した場合、サーバーは最大 5,000 個のアイテムを返します。返される追加の結果がある場合、サービスは応答要素で継続トークンを `NextMarker` 返します。場合によっては、によって指定されたよりも少ない結果がサービスから `maxresults`返され、継続トークンも返される場合があります。 `maxresults` をゼロ以下の値に設定すると、エラー応答コード 400 (Bad Request) が発生します。
`include={snapshots,metadata,uncommittedblobs,copy,deleted,tags,versions,` `deletedwithversions,immutabilitypolicy,legalhold,permissions}`	省略可能。応答に含める 1 つ以上のデータセットを指定します。 - `snapshots`: 列挙にスナップショットを含める必要があることを指定します。応答では、スナップショットは古いものから新しいものの順に列挙されます。 - `metadata`: 応答で BLOB メタデータを返すように指定します。 - `uncommittedblobs`: ブロックがアップロードされたが、 Put Block List を使用してコミットされていない BLOB を応答に含めます。 - `copy`: バージョン 2012-02-12 以降。現在または以前の `Copy Blob` 操作に関連するメタデータを応答に含めるように指定します。 -`deleted`: バージョン 2017-07-29 以降。論理的に削除された BLOB を応答に含める必要があることを指定します。 -`tags`: バージョン 2019-12-12 以降。ユーザー定義の BLOB インデックスタグを応答に含める必要があることを指定します。 -`versions`: バージョン 2019-12-12 以降。 BLOB のバージョンを列挙に含める必要があることを指定します。 -`deletedwithversions`: バージョン 2020-10-02 以降。任意のバージョン (アクティブまたは削除済み) を含む削除された BLOB を応答に含める必要があることを指定します。完全に削除した項目は、ガベージコレクションによって処理されるまで応答に表示されます。タグ `\<HasVersionsOnly\>`と値 `true`を使用します。 -`immutabilitypolicy`: バージョン 2020-06-12 以降。列挙に、期限までの不変ポリシーと BLOB の不変ポリシーモードを含める必要があることを指定します。 -`legalhold`: バージョン 2020-06-12 以降。列挙に BLOB の訴訟ホールドを含める必要があることを指定します。 -`permissions`: バージョン 2020-06-12 以降。階層型名前空間が有効になっているアカウントでのみサポートされます。要求にこのパラメーターが含まれている場合、一覧表示されている BLOB またはディレクトリの所有者、グループ、アクセス許可、およびアクセス制御リストが列挙に含まれます。複数のオプションを URI で指定するには、URL エンコードのコンマ ("%82") で各オプションを区切る必要があります。
`showonly={deleted,files,directories}`	省略可能。応答で返される次のいずれかのデータセットを指定します。 -`deleted`：オプション。バージョン 2020-08-04 以降。階層型名前空間で有効になっているアカウントの場合のみ。要求にこのパラメーターが含まれている場合、一覧には論理的に削除された BLOB のみが含まれます。 POSIX ACL 承認フォールバックは、論理的に削除された BLOB を一覧表示するためにサポートされていないことに注意してください。も指定されている場合 `include=deleted` 、要求は無効な要求 (400) で失敗します。 -`files`：オプション。バージョン 2020-12-06 以降。階層型名前空間で有効になっているアカウントの場合のみ。要求にこのパラメーターが含まれている場合、リストにはファイルのみが含まれます。 -`directories`：オプション。バージョン 2020-12-06 以降。階層型名前空間で有効になっているアカウントの場合のみ。要求にこのパラメーターが含まれている場合、リストにはディレクトリのみが含まれます。
`timeout`	省略可能。 `timeout` パラメーターは、秒単位で表されます。詳細については、「 Blob Storage 操作のタイムアウトの設定」を参照してください。

要求ヘッダー

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

要求ヘッダー	説明
`Authorization`	必須。承認スキーム、アカウント名、署名を指定します。詳細については、「Azure Storage への要求を承認する」をご覧ください。
`Date` または `x-ms-date`	必須。要求に対して協定世界時 (UTC) を指定します。詳細については、「Azure Storage への要求を承認する」をご覧ください。
`x-ms-version`	すべての承認された要求には必須、匿名要求の場合は省略可能です。この要求に使用する操作のバージョンを指定します。詳細については、「Azure Storage サービスのバージョン管理」を参照してください。
`x-ms-client-request-id`	省略可能。ログ記録の構成時にログに記録される 1 kibibyte (KiB) 文字制限を使用して、クライアントによって生成された不透明な値を提供します。このヘッダーを使用して、クライアント側のアクティビティとサーバーが受信する要求を関連付けるよう強くお勧めします。詳細については、「Azure Blob Storageの監視」を参照してください。
`x-ms-upn`	省略可能。階層型名前空間がアカウントに対して有効で、 `include=permissions` 要求で指定されている場合にのみ有効です。の場合`true`、Owner>、Group>、<Acl><の各フィールドで<返されるユーザー ID 値は、Microsoft Entraオブジェクト ID からユーザープリンシパル名に変換されます。の場合`false`、値はオブジェクト ID Microsoft Entraとして返されます。既定値は `false` です。グループおよびアプリケーションオブジェクト ID は一意のフレンドリ名を持たないため、変換されないことに注意してください。

要求本文

[なし] :

要求のサンプル

サンプル要求については、「 BLOB リソースの列挙」を参照してください。

Response

応答には HTTP ステータスコード、一連の応答ヘッダー、および応答の本文が XML 形式で含まれます。

status code

操作に成功すると、状態コード 200 (OK) が返されます。状態コードの詳細については、「状態とエラーコード」を参照してください。

応答ヘッダー

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

応答ヘッダー	説明
`Content-Type`	返される結果の形式を指定します。現在、この値は `application/xml` です。
`x-ms-request-id`	このヘッダーは、行われた要求を一意に識別し、要求のトラブルシューティングに使用できます。詳細については、「 API 操作のトラブルシューティング」を参照してください。
`x-ms-version`	要求の実行に使用される Blob Storage のバージョンを示します。このヘッダーは、バージョン 2009-09-19 以降を使用して行われた要求に対して返されます。このヘッダーは、2009-09-19 バージョンの Blob Storage を使用してコンテナーがパブリックアクセス用にマークされている場合、バージョンが指定されていない匿名要求にも返されます。
`Date`	応答が開始された時刻を示す UTC 日付/時刻値。サービスによってこの値が生成されます。
`x-ms-client-request-id`	このヘッダーを使用して、要求と対応する応答のトラブルシューティングを行うことができます。このヘッダーの値は、要求に存在する `x-ms-client-request-id` 場合、ヘッダーの値と同じです。この値は、最大 1024 文字の ASCII 文字で表示されます。ヘッダーが `x-ms-client-request-id` 要求に存在しない場合、このヘッダーは応答に存在しません。

応答本文

XML 応答の形式は次のとおりです。

Prefix、Marker、MaxResults、Delimiter の各要素は、要求 URI で指定された場合にのみ存在します。要素には NextMarker 、リストの結果が完全でない場合にのみ値があります。

スナップショット、BLOB メタデータ、およびコミットされていない BLOB は、要求の URI の include パラメーターで指定されている場合にのみ、応答に含まれます。

バージョン 2009-09-19 以降では、BLOB のプロパティは要素内に Properties カプセル化されます。

バージョン 2009-09-19 以降、List Blobs の応答本文で返される要素の名前は以下のように変更されています。

Last-Modified (旧称 LastModified)
Content-Length (旧称 Size)
Content-Type (旧称 ContentType)
Content-Encoding (旧称 ContentEncoding)
Content-Language (旧称 ContentLanguage)

要素は Content-MD5 、バージョン 2009-09-19 以降で作成された BLOB に対して表示されます。バージョン 2012-02-12 以降では、Put BLOB を使用して BLOB をアップロードすると、Blob Storage によって値が計算Content-MD5されます。 Blob Storage では、 Put Block List を使用して BLOB を作成しても、この計算は行われません。 BLOB を作成するとき、または Put Block List 操作または Set Blob Properties 操作を呼び出すことで、値を明示的にContent-MD5設定できます。

2009-09-19 以降のバージョンでは、バージョン 2015-02-21 より前のバージョンでは、追加 BLOB を含むコンテナーでを呼び出 List Blobs すことはできません。リストの結果に追加 BLOB が含まれている場合、サービスは状態コード 409 (競合) を返します。

LeaseState バージョン LeaseDuration 2012-02-12 以降でのみ表示されます。

CopyId、CopyStatus、CopySource、CopyProgress、CopyCompletionTime、および CopyStatusDescription が含まれるのは、バージョン 2012-02-12 以降で、この操作に include={copy} パラメーターが含まれている場合に限られます。この BLOB が操作の宛先 Copy Blob になっていない場合、これらの要素は表示されません。、、または Put Block Listを使用してPut BlobSet Blob Properties、終了操作の後にこの BLOB が変更されたCopy Blob場合、要素は表示されません。これらの要素は、バージョン 2012-02-12 より前のバージョンの Blob のコピーによって作成された BLOB には表示されません。

バージョン 2013-08-15 以降では、 EnumerationResults 要素には BLOB エンドポイントを ServiceEndpoint 指定する属性が含まれています。この要素には、コンテナーの ContainerName 名前を指定するフィールドも含まれています。以前のバージョンでは、これら 2 つの属性がフィールドで ContainerName 結合されていました。バージョン 2013-08-15 以降でも、の UrlBlob 要素は削除されています。

バージョン 2015-02-21 以降では、 List Blobs すべての型 (ブロック、ページ、および追加 BLOB) の BLOB を返します。

バージョン 2015-12-11 以降では、 List Blobs 要素を ServerEncrypted 返します。この要素は、BLOB とアプリケーションのメタデータが完全に暗号化されている場合はに true 設定され false 、それ以外の場合はに設定されます。

バージョン 2016-05-31 以降では、 List Blobs 増分コピー BLOB とスナップショットの要素を返 IncrementalCopy し、値はに true設定されます。

バージョン 2017-04-17 以降では、 List Blobs アクセス層が明示的に設定されている場合は、要素を返 AccessTier します。許可される Premium ページ BLOB 層の一覧については、「 VM の高パフォーマンス Premium Storage とマネージドディスク」を参照してください。 Blob Storage または汎用 v2 アカウントの場合、有効な値は Hot、 Cool、および Archiveです。 BLOB がリハイドレート保留中の状態の場合、 ArchiveStatus 要素は有効な値 (rehydrate-pending-to-hot、、 rehydrate-pending-to-coolまたは rehydrate-pending-to-cold) のいずれかで返されます。ブロック BLOB の階層化の詳細については、「ホット、クール、アーカイブストレージ層」を参照してください。

バージョン 2017-04-17 以降では、 List Blobs Blob Storage または汎用 v2 アカウントの要素を返 AccessTierInferred します。ブロック BLOB にアクセス層が設定されていない場合、層情報はストレージアカウントのプロパティから推論され、この値はに true設定されます。このヘッダーは、層が account プロパティから推論された場合にのみ存在します。

バージョン 2017-04-17 以降では、 List Blobs Blob Storage または汎用 v2 アカウントの要素を返 AccessTierChangeTime します。これは、ブロック BLOB の層が設定された場合にのみ返されます。詳細については、「ヘッダー内の日時値の表現」を参照してください。

バージョン 2017-07-29 以降の場合、DeletedDeletedTimeRemainingRetentionDaysこの操作にパラメーターが含まれている場合は、 include={deleted} が表示されます。この BLOB が削除されていない場合、これらの要素は表示されません。これらの要素は、論理的な削除機能が有効になっているときに、操作で DELETE 削除された BLOB またはスナップショットに対して表示されます。 Deleted論理的に削除された BLOB とスナップショットの場合、要素はにtrue設定されます。 Deleted-Time は、BLOB が削除された時刻に対応します。 RemainingRetentionDays は、論理的に削除された BLOB が完全に削除されてからの日数を示します。

バージョン 2017-11-09 以降では、 Creation-Time この BLOB が作成された時刻を返します。

バージョン 2019-02-02 以降では、 List Blobs BLOB が顧客指定の CustomerProvidedKeySha256 キーで暗号化されている場合は、要素を返します。値は、BLOB の暗号化に使用されるキーの SHA-256 ハッシュに設定されます。さらに、操作にパラメーターが include={metadata} 含まれており、顧客が指定したキーで暗号化された BLOB にアプリケーションメタデータが存在する場合、 Metadata 要素には属性が Encrypted="true" 含まれます。この属性は、操作の一部 List Blobs として復号化できないメタデータが BLOB にあることを示します。これらの BLOB のメタデータにアクセスするには、顧客が指定したキーを使用して Get Blob Properties または Get BLOB Metadata を呼び出します。

バージョン 2019-02-02 以降では、 List Blobs BLOB が暗号化スコープで暗号化されている場合は、要素を返 EncryptionScope します。値は、BLOB の暗号化に使用される暗号化スコープの名前に設定されます。操作にパラメーターが include={metadata} 含まれている場合、BLOB 上のアプリケーションメタデータは透過的に復号化され、要素で Metadata 使用できます。

バージョン 2019-12-12 以降では、オブジェクトが状態の場合は、 List Blobs Blob Storage または汎用 v2 アカウントの要素をrehydrate pending返RehydratePriorityします。有効な値は High と Standard です。

バージョン 2019-12-12 以降では、 List Blobs アカウントでバージョン管理が有効になっている場合、BLOB と生成された BLOB バージョンの要素を返 VersionId します。

バージョン 2019-12-12 以降では、 List Blobs 現在のバージョンの BLOB の要素を返 IsCurrentVersion します。値が true に設定されています。この要素を使用すると、現在のバージョンと、自動的に生成された読み取り専用バージョンを区別できます。

バージョン 2019-12-12 以降では、 List Blobs 任意のタグを TagCount 持つ BLOB の要素を返します。要素は、 Tags この操作にパラメーターが include={tags} 含まれている場合にのみ表示されます。 BLOB にタグがない場合、これらの要素は表示されません。

バージョン 2019-12-12 以降では、 List Blobs 追加 BLOB の要素を Sealed 返します。要素は、 Sealed 追加 BLOB がシールされている場合にのみ表示されます。追加 BLOB がシールされていない場合、これらの要素は表示されません。

バージョン 2020-02-10 以降では、 List Blobs 要素を LastAccessTime 返します。要素は、ストレージアカウントの最終アクセス時間追跡ポリシーに従って、BLOB のデータが最後にアクセスされた日時を示します。ストレージアカウントにこのポリシーがない場合、またはポリシーが無効になっている場合、要素は返されません。アカウントの最終アクセス時間追跡ポリシーの設定については、 BLOB サービス API に関するページを参照してください。要素は LastAccessTime 、BLOB のメタデータに最後にアクセスした時刻を追跡しません。

バージョン 2020-06-12 以降の場合、List Blobsこの操作にパラメーターが含まれていると、要素と ImmutabilityPolicyMode 要素がinclude={immutabilitypolicy}返ImmutabilityPolicyUntilDateされます。

バージョン 2020-06-12 以降の場合、 List Blobs この操作にパラメーターが LegalHold 含まれていると、要素が include={legalhold} 返されます。

バージョン 2020-06-12 以降の場合、階層型名前空間が有効になっているアカウントの場合、、Group、 List BlobsPermissions、および Acl 要素がOwner返されます。要求にはパラメーターが include={permissions} 含まれている必要があります。 Acl要素は、ファイルまたはディレクトリに設定されたアクセスと既定のアクセス制御リストの組み合わせリストであることに注意してください。

バージョン 2020-06-12 以降の場合、階層型名前空間が有効になっているアカウントの場合、List Blobs区切り記号は要素の要素をBlobPrefix返しますProperties。これは、ディレクトリのプロパティに対応します。

バージョン 2020-08-04 以降では、階層型名前空間が有効になっているアカウントの場合、 List Blobs 削除された BLOB の要素が DeletionId 返されます。 DeletionId は符号なし 64 ビット識別子です。要素は、論理的に削除されたパスを一意に識別し、同じパスを持つ他の削除された BLOB と区別します。

バージョン 2020-10-02 以降では、階層型名前空間が有効になっているアカウントの場合、 List Blobs パスの ResourceType プロパティ要素を返します。 file または directory を指定できます。

バージョン 2021-02-12 以降では、 List Blobs (RFC 2396 に従って) すべて BlobName または BlobPrefixName 要素の値をパーセントエンコードします。具体的には、XML (U+FFFE または U+FFFF) で無効な文字を含む値に対して行われます。エンコードされた場合、要素には Name 属性が Encoded=true 含まれます。これは、応答内の Name 残りの Name 要素ではなく、XML で無効な文字を含む要素値に対してのみ発生することに注意してください。

バージョン 2021-06-08 以降の場合、階層型名前空間が有効になっているアカウントの場合、 List Blobs properties 要素が Placeholder 返されます。削除された BLOB を区切り記号で BlobPrefix 一覧表示すると、プレースホルダーディレクトリの要素でこの要素が返されます。これらのプレースホルダーディレクトリは、論理的に削除された BLOB へのナビゲーションを容易にするために存在します。

バージョン 2021-06-08 以降の場合、階層型名前空間が有効になっているアカウントでは、 List Blobs 要素が EncryptionContext 返されます。暗号化コンテキストのプロパティ値が設定されている場合は、設定値が返されます。

バージョン 2020-02-10 以降では、階層型名前空間が有効になっているアカウントの場合、 List Blobs 削除された BLOB の要素を Expiry-Time 返します。 Expiry-Time はファイルの有効期限が切れる時刻であり、有効期限が同じに設定されている場合はファイルに対して返されます。

<?xml version="1.0" encoding="utf-8"?>  
<EnumerationResults ServiceEndpoint="http://myaccount.blob.core.windows.net/"  ContainerName="mycontainer">  
  <Prefix>string-value</Prefix>  
  <Marker>string-value</Marker>  
  <MaxResults>int-value</MaxResults>  
  <Delimiter>string-value</Delimiter>  
  <Blobs>  
    <Blob>  
      <Name>blob-name</name>  
      <Snapshot>date-time-value</Snapshot>  
      <VersionId>date-time-vlue</VersionId>
      <IsCurrentVersion>true</IsCurrentVersion>
      <Deleted>true</Deleted>
      <Properties> 
        <Creation-Time>date-time-value</Creation-Time>
        <Last-Modified>date-time-value</Last-Modified>  
        <Etag>etag</Etag>
        <Owner>owner user id</Owner>
        <Group>owning group id</Group>
        <Permissions>permission string</Permissions>
        <Acl>access control list</Acl>
        <ResourceType>file | directory</ResourceType>
        <Placeholder>true</Placeholder>
        <Content-Length>size-in-bytes</Content-Length>  
        <Content-Type>blob-content-type</Content-Type>  
        <Content-Encoding />  
        <Content-Language />  
        <Content-MD5 />  
        <Cache-Control />  
        <x-ms-blob-sequence-number>sequence-number</x-ms-blob-sequence-number>  
        <BlobType>BlockBlob|PageBlob|AppendBlob</BlobType>  
        <AccessTier>tier</AccessTier>  
        <LeaseStatus>locked|unlocked</LeaseStatus>  
        <LeaseState>available | leased | expired | breaking | broken</LeaseState>  
        <LeaseDuration>infinite | fixed</LeaseDuration>  
        <CopyId>id</CopyId>  
        <CopyStatus>pending | success | aborted | failed </CopyStatus>  
        <CopySource>source url</CopySource>  
        <CopyProgress>bytes copied/bytes total</CopyProgress>  
        <CopyCompletionTime>datetime</CopyCompletionTime>  
        <CopyStatusDescription>error string</CopyStatusDescription>  
        <ServerEncrypted>true</ServerEncrypted> 
        <CustomerProvidedKeySha256>encryption-key-sha256</CustomerProvidedKeySha256>
        <EncryptionContext>encryption-context<EncryptionContext>
        <EncryptionScope>encryption-scope-name</EncryptionScope>
        <IncrementalCopy>true</IncrementalCopy>
        <AccessTierInferred>true</AccessTierInferred>
        <AccessTierChangeTime>datetime</AccessTierChangeTime>
        <DeletedTime>datetime</DeletedTime>
        <RemainingRetentionDays>no-of-days</RemainingRetentionDays>
        <TagCount>number of tags between 1 to 10</TagCount>
        <RehydratePriority>rehydrate priority</RehydratePriority>
        <Expiry-Time>date-time-value</Expiry-Time>
      </Properties>  
      <Metadata>     
        <Name>value</Name>  
      </Metadata>  
      <Tags>
          <TagSet>
              <Tag>
                  <Key>TagName</Key>
                  <Value>TagValue</Value>
              </Tag>
          </TagSet>
      </Tags>
      <OrMetadata />
    </Blob>  
    <BlobPrefix>  
      <Name>blob-prefix</Name>  
    </BlobPrefix>  
  </Blobs>  
  <NextMarker />  
</EnumerationResults>

応答のサンプル

サンプル応答については、「 BLOB リソースの列挙」を参照してください。

承認

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

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ユーザー、グループ、またはサービスプリンシパルが操作を呼び出List Blobsすために必要な RBAC アクションと、このアクションを含む最小限の特権を持つ組み込み Azure RBAC ロールを次に示します。

Azure RBAC アクション:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
最小特権の組み込みロール:ストレージ BLOB データ閲覧者

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

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

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

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

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

ユーザー委任 SAS

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

コンテナーリソースに List Blobs 委任された SAS トークンを使用して操作を呼び出すには、ユーザー委任 SAS トークンの一部として List (l) アクセス許可が必要です。

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

サービス SAS

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

コンテナーリソースに List Blobs 委任された SAS トークンを使用して操作を呼び出すには、サービス SAS トークンの一部として List (l) アクセス許可が必要です。

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

アカウント SAS

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

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

操作	署名済みサービス	署名されたリソースの種類	署名されたアクセス許可
BLOBs の一覧	BLOB (b)	コンテナー (c)	リスト (l)

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

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

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

注釈

応答の BLOB プロパティ

コミットされていない BLOB を列挙に含める必要がある場合は、BLOB がコミットされるまで一部のプロパティが設定されないことに注意してください。応答で一部のプロパティが返されない場合があります。

x-ms-blob-sequence-number 要素は、ページ BLOB に対してのみ返されます。

要素は OrMetadata 、ブロック BLOB に対してのみ返されます。

ページ BLOB の場合、Content-Length 要素で返される値は、BLOB の x-ms-blob-content-length ヘッダーの値に対応します。

要素は Content-MD5 、バージョン 2009-09-19 以降を使用して BLOB に設定されている場合にのみ、応答本文に表示されます。このプロパティは Content-MD5 、BLOB の作成時に設定することも、 Blob プロパティの設定を呼び出すことで設定することもできます。バージョン 2012-02-12 以降では、 Put Blob 要求に MD5 ヘッダーが含まれていない場合 Put Blob でも、ブロック BLOB の MD5 値を設定します。

応答内のメタデータ

Metadata 要素は、include=metadata パラメーターが URI に指定された場合にのみ存在します。 Metadata 要素内では、名前と値の各ペアの値が、ペアの名前に対応する要素内に一覧表示されます。

このパラメーターで要求されたメタデータは、2009-09-19 バージョンの Blob Storage によって課される名前付け制限に従って格納する必要があります。このバージョン以降、すべてのメタデータ名は C# 識別子の名前付け規則に従う必要があります。

メタデータ名と値のペアがこれらの名前付け制限に違反している場合、応答本文は要素内の問題のある名前を x-ms-invalid-name 示します。次の XML フラグメントは、これを示しています。

  
…  
<Metadata>  
  <MyMetadata1>first value</MyMetadata1>  
  <MyMetadata2>second value</MyMetadata2>  
  <x-ms-invalid-name>invalid-metadata-name</x-ms-invalid-name>  
</Metadata>  
…

応答内のタグ

要素は Tags 、パラメーターが URI で指定され、BLOB にタグがある場合にのみ include=tags 存在します。要素内ではTagSet、最大 10 Tag 個の要素が返されます。それぞれに、ユーザー定義の BLOB インデックスタグのと value が含まれますkey。タグの順序は、応答では保証されません。

Tags BLOB にタグがない場合、要素と TagCount 要素は返されません。

ストレージサービスは、BLOB とそのタグの間で強力な一貫性を維持しますが、最終的にはセカンダリインデックスに一貫性があります。タグは、操作に表示される前に、への List Blobs 応答で Find Blobs by Tags 表示できます。

応答内のスナップショット

スナップショットは、URI で include=snapshots パラメーターが指定されていた場合にのみ、応答の一覧に含まれます。スナップショットはアクティブなリースを持つことができないため、応答に一覧表示されるスナップショットには要素は含 LeaseStatus まれません。

サービスバージョン 2021-06-08 以降を使用すると、区切り記号を使用してを呼び出 List Blobs し、列挙にスナップショットを含めることができます。 2021-06-08 より前のサービスバージョンの場合、両方を含む要求は InvalidQueryParameter エラー (HTTP 状態コード 400 – Bad Request) を返します。

応答内のコミットされていない BLOB

コミットされていない BLOB は、include=uncommittedblobs パラメーターが URI で指定されている場合にのみ、応答の一覧に含まれます。応答に一覧表示されているコミットされていない BLOB には、次の要素は含まれません。

Last-Modified
Etag
Content-Type
Content-Encoding
Content-Language
Content-MD5
Cache-Control
Metadata

応答で削除された BLOB

削除された BLOB は、パラメーターが URI で指定されている場合 include=deleted にのみ、応答に一覧表示されます。削除された BLOB はアクティブなリースを持つことができないため、応答に一覧表示されている削除された BLOB には Lease 要素は含まれません。

URI で指定されている場合 include=deleted,snapshot 、削除されたスナップショットはリスト応答に含まれます。

応答のオブジェクトレプリケーションメタデータ

要素は OrMetadata 、BLOB でオブジェクトレプリケーションポリシーが評価され、 List Blobs バージョン 2019-12-12 以降を使用して呼び出しが行われた場合に存在します。 OrMetadata 要素内では、名前と値の各ペアの値が、ペアの名前に対応する要素内に一覧表示されます。名前の形式はです or-{policy-id}_{rule-id}。ここで {policy-id} 、はストレージアカウントのオブジェクトレプリケーションポリシー識別子を表す GUID です。 {rule-id} は、ストレージコンテナーのルール識別子を表す GUID です。有効な値は complete または failedです。

  
…  
<OrMetadata>  
  <or-e524bba7-4323-4b93-91f8-d09d5d0b7057_d86c51de-ef02-4264-bdcf-dcd389a6c7ac>complete</or-e524bba7-4323-4b93-91f8-d09d5d0b7057_d86c51de-ef02-4264-bdcf-dcd389a6c7ac>  
  <or-2b302b5d-fcd5-44d6-a5ed-455bf27e17ea_4a398ff5-2a89-4090-879b-10248f23428e>failed</or-2b302b5d-fcd5-44d6-a5ed-455bf27e17ea_4a398ff5-2a89-4090-879b-10248f23428e>  
</OrMetadata>  
…

応答の不変性ポリシー

ImmutabilityPolicyUntilDate要素と ImmutabilityPolicyMode 要素は、パラメーターが include=immutabilitypolicy URI で指定された場合にのみ存在します。

<Properties> 
   <ImmutabilityPolicyUntilDate>date-time-value</ImmutabilityPolicyUntilDate>   
   <ImmutabilityPolicyMode>unlocked | locked </ImmutabilityPolicyMode>  
</Properties>

対応に関する訴訟ホールド

LegalHold 要素は、include=legalhold パラメーターが URI に指定された場合にのみ存在します。

<Properties> 
  <LegalHold>true | false </LegalHold>  
</Properties>

マーカー値を使用して結果セットを返す

パラメーターに値 maxresults を指定し、返す BLOB の数がこの値を超えるか、の既定値 maxresultsを超えた場合、応答本文には要素が NextMarker 含まれます。この要素は、後続の要求で返される次の BLOB を示します。場合によっては、返される結果の数がの NextMarker 値 maxresultsより少ない場合でも、サービスから要素が返されることがあります。

次の項目セットを返すには、後続の要求の URI で NextMarker の値をマーカーパラメーターとして指定します。 NextMarker の値は非透過的に扱う必要があります。

区切り記号を使用して BLOB 名前空間を走査する

delimiter パラメーターは、呼び出し元がユーザー定義の区切り記号を使用して BLOB 名前空間をスキャンできるようにします。この方法で、BLOB の仮想階層をファイルシステムと同様にスキャンできます。区切り記号には単一文字または文字列を使用できます。

要求にこのパラメーターが含まれている場合、この操作によって BlobPrefix 要素が返されます。要素は BlobPrefix 、区切り文字の外観まで、同じ部分文字列で始まる名前を持つすべての BLOB の代わりに返されます。要素の BlobPrefix 値は substring+ delimiter です。ここで、 substring は 1 つ以上の BLOB 名を開始する共通の部分文字列であり、 delimiter はパラメーターの delimiter 値です。

の BlobPrefix 値を使用すると、後続の呼び出しを行って、このプレフィックスで始まる BLOB を一覧表示できます。これを行うには、要求 URI のパラメーターの BlobPrefixprefix の値を指定します。

返される各 BlobPrefix 要素が、各 Blob 要素と同じように、結果の最大件数に加算されることに注意してください。

BLOB は、応答本文でアルファベット順に一覧表示されます (大文字が最初に表示されます)。

[状態のコピーの説明] でエラーをコピーする

CopyStatusDescription には、Copy Blob のエラーに関する詳細情報が含まれます。

コピーの試行が失敗した場合、 CopyStatus Blob Storage がまだ操作を再試行している場合は、がに pending 設定されます。このテキストは CopyStatusDescription 、最後のコピー試行中に発生した可能性のあるエラーを示しています。
CopyStatus が failed に設定されている場合、CopyStatusDescription のテキストでは、コピー操作を失敗させたエラーについて説明されます。

次の表では、すべての CopyStatusDescription 値のフィールドについて説明します。

コンポーネント	説明
HTTP 状態コード	エラーを指定する標準の 3 桁の整数。
エラーコード	エラーを記述するキーワード。これは、ErrorCode> 要素で <Azure によって提供されます。 ErrorCode> 要素が表示されない<場合、サービスは HTTP 仕様の 3 桁の HTTP 状態コードに関連付けられている標準エラーテキストを含むキーワード (keyword)を返します。詳細については、一般的な REST API のエラーコードに関するページを参照してください。
Information	エラーの詳細な説明 (引用符)。

一般的なエラーシナリオの CopyStatus と CopyStatusDescription の値を次の表に示します。

重要

ここに示す説明テキストは、バージョンを変更しなくても、警告なしで変更できます。この正確なテキストの一致に依存しないでください。

シナリオ	状態の値をコピーする	状態の説明の値をコピーする
コピー操作が正常に完了した。	success	empty
ユーザーは、完了する前にコピー操作を中止しました。	aborted	empty
コピー操作中にソース BLOB からの読み取り中にエラーが発生しました。操作が再試行されます。	pending	502 BadGateway "コピー元の読み取り時に再試行可能なエラーが発生しました。再試行します。失敗時刻: <time>"
コピー操作のコピー先 BLOB への書き込み中にエラーが発生しました。操作が再試行されます。	pending	500 InternalServerError "再試行可能なエラーが発生しました。再試行します。失敗時刻: <time>"
コピー操作でコピー元 BLOB からの読み取り時に回復不能なエラーが発生した。	失敗	404 ResourceNotFound "ソースの読み取り時にコピーに失敗しました。サービスは、この基になるエラーを報告すると、ErrorCode> 要素でを<返`ResourceNotFound`します。応答に ErrorCode> 要素が表示されない<場合は、などの `NotFound`HTTP 状態の標準的な文字列表現が表示されます。
すべてのコピー操作を制限するタイムアウト期間が経過した (現在、タイムアウト期間は 2 週間です。	失敗	500 OperationCancelled "コピーの最大許容時間を超えました。"
コピー元からの読み取り時にコピー操作が何度も失敗しており、試行の最小成功率に達していなかった (このタイムアウトにより、失敗する前に 2 週間にわたって非常に貧弱なソースを再試行できなくなります)。	失敗	500 OperationCancelled "コピー元の読み取り時にコピーに失敗しました。"

請求

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

操作	ストレージアカウントの種類	課金カテゴリ
BLOBs の一覧	Premium ブロック BLOB Standard 汎用 v2 Standard 汎用 v1	コンテナー操作の一覧表示と作成

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

こちらもご覧ください

状態コードとエラーコード
 Blob Storage のエラーコード