コンテナーのプロパティの取得

Get Container Properties 操作は、すべてのユーザー定義メタデータと、指定されたコンテナーのシステム プロパティを返します。 返されるデータにコンテナーの BLOB 一覧は含まれません。

Request

Get Container Properties 要求の構成は次のとおりです。 HTTPS が推奨されます。 myaccount をストレージ アカウントの名前に置き換えます。

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

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

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

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

詳細については、「開発とテストにAzure Storage Emulatorを使用する」を参照してください。

URI パラメーター

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

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

要求ヘッダー

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

要求ヘッダー 説明
Authorization 必須。 承認スキーム、アカウント名、および署名を指定します。 詳細については、「Azure Storage要求を承認する」を参照してください。
Date or x-ms-date 必須。 要求に対して協定世界時 (UTC) を指定します。 詳細については、「Azure Storage要求を承認する」を参照してください。
x-ms-lease-id: <ID> バージョン 2012-02-12 以降では省略可能。 この要求ヘッダーを指定すると、コンテナーのリースがアクティブであり、この ID に一致する場合にのみ、Get Container Properties が正常に実行されます。 アクティブなリースがない場合や ID が一致しない場合は、412 (Precondition Failed) が返されます。
x-ms-version すべての承認された要求に必要です。匿名要求の場合は省略可能です。 この要求に使用する操作のバージョンを指定します。 詳細については、「Azure Storage サービスのバージョン管理」を参照してください。
x-ms-client-request-id 省略可能。 ストレージ分析ログが有効になっているときに分析ログに記録される 1 KiB 文字制限を持つ、クライアントによって生成された不透明な値を提供します。 クライアント側のアクティビティをサーバーが受信した要求と関連付けるには、このヘッダーを使用することが強く推奨されます。 詳細については、「Storage AnalyticsログAzure ログ: ログを使用したStorage要求の追跡」を参照してください。

要求本文

[なし] :

応答

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

状態コード

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

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

レスポンス ヘッダー

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

応答ヘッダー 説明
x-ms-meta-name:value メタデータとしてコンテナーに関連付けられた名前と値のペアを含む文字列を返します。
ETag コンテナーのエンティティ タグ。 要求バージョンが 2011-08-18 またはそれ以降である場合、ETag 値は引用符で囲まれます。
Last-Modified コンテナーが最後に更新された日時を返します。 日付形式は RFC 1123 に従います。 詳細については、「 ヘッダーのDate-Time値の表現」を参照してください。

コンテナーまたはそのプロパティやメタデータを変更する操作を行うと、最終更新時刻が更新されます。 BLOB に対する操作は、コンテナーの最終更新時刻に影響しません。
x-ms-lease-status: <locked &#124; unlocked> バージョン 2012-02-12 以降。 コンテナーのリース ステータス。
x-ms-lease-state: <available &#124; leased &#124; expired &#124; breaking &#124; broken> バージョン 2012-02-12 以降。 コンテナーのリースの状態。
x-ms-lease-duration: <infinite &#124; fixed > バージョン 2012-02-12 以降で、コンテナーをリースしている場合にのみ使用されます。 コンテナーのリース期間が無限と固定のどちらであるかを指定します。
x-ms-request-id このヘッダーは要求を一意に識別するので、要求のトラブルシューティングに使用できます。 詳細については、「 API 操作のトラブルシューティング」を参照してください
x-ms-version バージョン 2009-09-19 以降。 要求の実行に使用する BLOB サービスのバージョンを示します。

コンテナーが 2009-09-19 バージョンの BLOB サービスを使用するパブリック アクセス用にマークされている場合は、バージョン指定のない匿名要求に対しても返されます。
Date サービスによって生成される、応答の開始時刻を示す UTC 日付/時刻値。
x-ms-blob-public-access バージョン 2016-05-31 以降 コンテナー内のデータにパブリックにアクセスできるかどうかを示し、アクセスレベルを指定します。 次の値を指定できます。

container: コンテナーと BLOB データの完全なパブリック読み取りアクセスを示します。 クライアントは匿名要求でコンテナー内の BLOB を列挙できますが、ストレージ アカウント内のコンテナーを列挙することはできません。

BLOB: BLOB のパブリック読み取りアクセスを示します。 該当するコンテナー内の BLOB データは匿名要求で読み取り可能ですが、コンテナー データは参照できません。 クライアントはコンテナー内の BLOB を匿名要求で列挙することはできません。

このヘッダーが応答で返されない場合、コンテナーはアカウント所有者に対してプライベートです。
x-ms-has-immutability-policy バージョン 2017-11-09 以降。 コンテナーに不変ポリシーが設定されているかどうかを示します。 値はポリシー true セット false がある場合、それ以外の場合です。
x-ms-has-legal-hold バージョン 2017-11-09 以降。 コンテナーに訴訟ホールドがあるかどうかを示します。 値は、 true 1 つ以上の訴訟ホールドがある場合です。それ以外の false 場合。
x-ms-client-request-id このヘッダーは、要求と対応する応答のトラブルシューティングに使用できます。 このヘッダーの値は、要求に存在し、その値 x-ms-client-request-id が最大 1024 文字の ASCII 文字で表示される場合、ヘッダーの値と同じです。 ヘッダーが x-ms-client-request-id 要求に存在しない場合、このヘッダーは応答に存在しません。

応答本文

[なし] :

応答のサンプル

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Transfer-Encoding: chunked  
x-ms-meta-Name: StorageSample  
Date: Sun, 25 Sep 2016 12:43:08 GMT  
ETag: "0x8CAFB82EFF70C46"  
Last-Modified: Sun, 25 Sep 2016 10:42:18 GMT  
x-ms-version: 2016-05-31
x-ms-blob-public-access: blob  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  

承認

コンテナーのアクセス制御リスト (ACL: Access Control List) がコンテナーへの匿名アクセスを許可するように設定されている場合、クライアントはこの操作を呼び出して BLOB のコンテンツを読み取ることができます。 コンテナーがプライベートの場合は、アカウント所有者がこの操作を実行できます。

解説

[なし] :

関連項目

コンテナーに対する操作