バケットに関する情報をクエリします。
使用上の注意
- 任意のObject Storage Service (OSS) エンドポイントからGetBucketInfoリクエストを開始できます。
- デフォルトでは、Alibaba Cloudアカウントにはバケットに関する情報を照会する権限があります。 RAMユーザーまたはSecurity Token Service (STS) を使用してバケットに関する情報を照会するには、
oss:GetBucketInfo
権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。
リクエスト構文
GET /?bucketInfo HTTP/1.1
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue
リクエストヘッダー
このリクエストには、共通リクエストヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。
レスポンスヘッダー
このリクエストには、共通のレスポンスヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。
レスポンス要素
要素 | データ型 | 例 | 説明 |
BucketInfo | Container | N/A | バケット情報を格納するコンテナー。 子ノード: バケット 親ノード: なし |
Bucket | Container | N/A | バケット情報を格納するコンテナー。 親ノード: BucketInfo |
CreationDate | 時間 | 2013-07-31T10:56:21.000Z | バケットが作成された時刻。 時刻は UTC です。 親ノード: BucketInfo.Bucket |
ExtranetEndpoint | String | oss-cn-hangzhou.aliyuncs.com | インターネット経由でバケットにアクセスするために使用されるパブリックエンドポイント。 親ノード: BucketInfo.Bucket |
IntranetEndpoint | String | oss-cn-hangzhou-internal.aliyuncs.com | バケットと同じリージョンにあるECS (Elastic Compute Service) インスタンスからバケットにアクセスするために使用される内部エンドポイント。 親ノード: BucketInfo.Bucket |
場所 | String | oss-cn-hangzhou | バケットが配置されているリージョン。 親ノード: BucketInfo.Bucket |
StorageClass | String | 標準 | バケットのストレージクラス。 有効な値: Standard、IA、Archive、ColdArchive ストレージクラスの詳細については、「概要」をご参照ください。 |
名前 | String | oss-example | バケットの名前です。 親ノード: BucketInfo.Bucket |
ResourceGroupId | String | rg-aek27tc ******** | バケットが属するリソースグループのID。 バケットがデフォルトリソースグループに属している場合、リソースグループIDはrg-default-idです。 親ノード: BucketInfo.Bucket |
所有者 | Container | N/A | バケット所有者に関する情報を格納するコンテナー。 親ノード: BucketInfo.Bucket |
ID | String | 27183473914 **** | バケット所有者のユーザーID。 親ノード: BucketInfo.Bucket.Owner |
DisplayName | String | username | バケット所有者の名前。バケット所有者のユーザーIDと同じです。 親ノード: BucketInfo.Bucket.Owner |
AccessControlList | Container | N/A | バケットに関するアクセス制御リスト (ACL) 情報を格納するコンテナー。 バケットACLの詳細については、「バケットACL」をご参照ください。 親ノード: BucketInfo.Bucket |
助成金 | Enumerated string | 非公開 | バケットのACL。 有効な値:private、public-read、public-read-write 親ノード: BucketInfo.Bucket.AccessControlList |
DataRedundancyType | Enumerated string | LRS | バケットのディザスタリカバリタイプ。 有効な値:LRS と ZRS 親ノード: BucketInfo.Bucket |
バージョン管理 | String | Enabled | バケットのバージョン管理が有効かどうかを示します。 有効な値: EnabledおよびSuspended バージョン管理の詳細については、「PutBucketVersioning」をご参照ください。 親ノード: BucketInfo.Bucket |
ServerSideEncryptionRule | Container | N/A | サーバー側の暗号化方式を格納するコンテナー。 サーバー側の暗号化の詳細については、「サーバー側の暗号化」をご参照ください。 親ノード: BucketInfo.Bucket |
ApplyServerSideEncryptionByDefault | Container | N/A | デフォルトで使用されるサーバー側の暗号化方法を格納するコンテナー。 親ノード: BucketInfo.Bucket |
SSEAlgorithm | String | KMS | デフォルトで使用されるサーバー側の暗号化方法。 有効な値: KMSおよびAES256 親ノード: BucketInfo.Bucket |
KMSMasterKeyID | String | ****** | 使用中の顧客マスターキー (CMK) ID。 SSEAlgorithmをKMSに設定し、CMK IDを指定した場合にのみ、有効な値が返されます。 それ以外の場合は、空の値が返されます。 親ノード: BucketInfo.Bucket |
CrossRegionReplication | String | 無効 | バケットに対してクロスリージョンレプリケーション (CRR) が有効になっているかどうかを示します。 有効な値: 有効および無効 親ノード: BucketInfo.Bucket |
TransferAcceleration | String | 無効 | バケットの転送アクセラレーションが有効になっているかどうかを示します。 有効な値: 有効および無効 親ノード: BucketInfo.Bucket |
HierarchicalNamespace | String | Enabled | バケットの階層名前空間が有効かどうかを示します。 有効値: Enabled 親ノード: BucketInfo.Bucket |
AccessMonitor | String | Enabled | バケットのアクセス追跡が有効かどうかを示します。 有効な値: 有効および無効 親ノード: BucketInfo.Bucket |
BucketPolicy | Container | N/A | ログを保存するコンテナー。 親ノード: BucketInfo.Bucket |
LogBucket | String | examplebucket | ログを保存するバケットの名前。 |
LogPrefix | String | ログ / | ログが保存されるディレクトリ。 |
例
リクエストの例
Get /?bucketInfo HTTP/1.1
ホスト: examplebucket.oss-cn-hangzhou.aliyuncs.com
日付: 9月12日土曜日2015 07:51:28 GMT
承認: OSS qn6qrrqxo2oawuk53otf ****: BuG4rRK + zNhH1AcF51NNHD39 ****
- <x id="1" type="exclude" text="codeblock id="codeblock_vow_acp_88d" props="china">HTTP/1.1 200x-oss-request-id: 534B371674E88A4D8906 *** サーバー日付: Sat、OSS: 531-Aliyt: 19 /6接続: 10G28-ファイル: 2015 *6; サーバーの長xml version="1.0" エンコード="UTF-8" ?& gt;<BucketInfo>< バケット><AccessMonitor> 有効</AccessMonitor><<CreationDate>2013-07-31T10:56:21.000Z extranetEndpoint</ExtranetEndpoint><IntranetEndpoint&g t;oss-cn-hangzhou-internal.aliyuncs.com</IntranetEndpoint>< 加速; ロケーション>oss-cn-hangzhou<<CrossRegionReplication> 無効化された</CrossRegionReplication>< 名前>oss-example</Name><ResourceGroupId>rg-aek27tc ***g***< Dist; 所有者の名前&ID>27183473914 ****</ID></所有者><AccessControlList>< グラント> プライベート< logBucket>examplebucket</LogBucket><LogPrefix>log/</LogPrefix></BucketPolicy></バケット></BucketInfo></codeblock"/>
HTTP/1.1 200 x-oss-request-id: 534B371674E88A4D8906 **** 日付: 9月12日土曜日2015 07:51:28 GMT 接続: キープアライブ コンテンツ-長さ: 531 サーバー: AliyunOSS <?xml version="1.0" encoding="UTF-8"?> <BucketInfo> <Bucket> <CreationDate>2013-07-31T10:56:21.000Z</CreationDate> <ExtranetEndpoint>oss-cn-hangzhou.aliyuncs.com</ExtranetEndpoint> <IntranetEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</IntranetEndpoint> <Location>oss-cn-hangzhou</Location> <StorageClass>Standard</StorageClass> <TransferAcceleration> 無効 </TransferAcceleration> <CrossRegionReplication> 無効 </CrossRegionReplication> <HierarchicalNamespace> 有効 </HierarchicalNamespace> <Name>oss-example</Name> <ResourceGroupId>rg-aek27tc ********</ResourceGroupId> <Owner> <DisplayName>username</DisplayName> <ID>27183473914****</ID> </Owner> <AccessControlList> <Grant>private</Grant> </AccessControlList> <Comment>test</Comment> <BucketPolicy> <LogBucket>examplebucket</LogBucket> <LogPrefix> ログ /</LogPrefix> </BucketPolicy> </バケット> </BucketInfo>
- 指定されたバケットが存在し
ない場合のサンプルエラー応答HTTP/1.1 404 x-oss-request-id: 534B371674E88A4D8906 **** 日付: 9月12日土曜日2015 07:51:28 GMT 接続: キープアライブ コンテンツ-長さ: 308 サーバー: AliyunOSS <?xml version="1.0" encoding="UTF-8"?> <エラー> <Code>NoSuchBucket</Code> <Message> 指定されたバケットは存在しません。</Message> <RequestId>568D547F31243C673BA1****</RequestId> <HostId>nosuchbucket.oss.aliyuncs.com</HostId> <BucketName>nosuchbucket</BucketName> </エラー>
- バケット
のHTTP/1.1 403にアクセスする権限がない場合のサンプルエラー応答 x-oss-request-id: 534B371674E88A4D8906 **** 日付: 9月12日土曜日2015 07:51:28 GMT 接続: キープアライブ コンテンツ-長さ: 209 サーバー: AliyunOSS <?xml version="1.0" encoding="UTF-8"?> <エラー> <Code>AccessDenied</Code> <Message>AccessDenied</Message> <RequestId>568D5566F2D0F89F5C0E****</RequestId> <HostI d>test.oss.aliyuncs.com</HostId> </エラー>
SDK
次のプログラミング言語のOSS SDKを使用して、GetBucketInfo操作を呼び出すことができます。
エラーコード
エラーコード | HTTPステータスコード | 説明 |
NoSuchBucket | 404 | バケットが存在しない場合に返されるエラーメッセージ。 |
AccessDenied | 403 | バケットに関する情報を照会する権限がない場合に返されるエラーメッセージ。 バケットに関する情報を照会できるのは、バケット所有者だけです。 |