バケットのパブリックアクセスブロック構成を照会します。
使用上の注意
デフォルトでは、Alibaba Cloud アカウントはバケットの Block Public Access 設定をクエリする権限を持っています。 RAM ユーザーまたは Security Token Service (STS) によって提供されるアクセス認証情報を使用してバケットの Block Public Access 設定をクエリする場合は、oss:GetBucketPublicAccessBlock 権限が必要です。 詳細については、「RAM ポリシーの一般的な例」をご参照ください。
リクエスト構文
GET /?publicAccessBlock HTTP/1.1
Date: GMT 日付
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValueリクエストヘッダー
GetBucketPublicAccessBlock リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通リクエストヘッダー」をご参照ください。
レスポンスヘッダー
GetBucketPublicAccessBlock リクエストへのレスポンスには、共通のレスポンスヘッダーのみが含まれています。 詳細については、「共通レスポンスヘッダー」をご参照ください。
レスポンス要素
要素 | タイプ | 例 | 説明 |
PublicAccessBlockConfiguration | コンテナー | 該当なし | パブリックアクセスブロック構成が格納されているコンテナー。 親ノード: なし 子ノード: BlockPublicAccess |
BlockPublicAccess | ブール値 | true | バケットに対してパブリックアクセスブロックが有効になっているかどうかを示します。
|
例
リクエストの例
GET /?publicAccessBlock HTTP/1.1 Date: Mon, 19 Feb 2024 08:40:17 GMT Content-Length: 0 Content-Type: application/xml Host: examplebucket.oss-cn-hangzhou.aliyuncs.com Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e成功レスポンスの例
HTTP/1.1 200 OK x-oss-request-id: 534B371674E88A4D8906**** Date: Mon, 19 Feb 2024 08:40:17 GMT Server: AliyunOSS <?xml version="1.0" encoding="UTF-8"?> <PublicAccessBlockConfiguration> <BlockPublicAccess>true</BlockPublicAccess> </PublicAccessBlockConfiguration>
OSS SDK
以下のプログラミング言語の OSS SDK を使用して、GetBucketPublicAccessBlock を呼び出すことができます。
ossutil
GetBucketPublicAccessBlock 操作に対応する ossutil コマンドについては、「get-bucket-public-access-block」をご参照ください。