コンテナーのプロパティの取得
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 | unlocked> |
バージョン 2012-02-12 以降。 コンテナーのリース ステータス。 |
x-ms-lease-state: <available | leased | expired | breaking | broken> |
バージョン 2012-02-12 以降。 コンテナーのリースの状態。 |
x-ms-lease-duration: <infinite | 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 のコンテンツを読み取ることができます。 コンテナーがプライベートの場合は、アカウント所有者がこの操作を実行できます。
解説
[なし] :