指定されたアクセスポイントのパブリックアクセスブロック設定を照会します。
注意事項
デフォルトでは、Alibaba Cloud アカウントには、アクセスポイントのパブリックアクセスブロック設定を照会する権限があります。RAM ユーザーとして、または Security Token Service (STS) の認証情報を使用してこの操作を実行するには、oss:GetAccessPointPublicAccessBlock 権限が必要です。詳細については、「RAMポリシーの一般的な例」をご参照ください。
リクエスト構文
GET /?publicAccessBlock&x-oss-access-point-name=ap-01 HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
リクエストヘッダー
GetAccessPointPublicAccessBlock リクエストは、共通リクエストヘッダーのみを使用します。詳細については、「共通リクエストヘッダー」をご参照ください。
リクエスト要素
|
要素 |
タイプ |
必須 |
例 |
説明 |
|
x-oss-access-point-name |
文字列 |
はい |
ap-01 |
アクセスポイントの名前。 |
レスポンスヘッダー
GetAccessPointPublicAccessBlock レスポンスには、共通レスポンスヘッダーのみが含まれます。詳細については、「共通レスポンスヘッダー」をご参照ください。
レスポンス要素
|
要素 |
タイプ |
例 |
説明 |
|
PublicAccessBlockConfiguration |
コンテナー |
該当なし |
パブリックアクセスブロック設定を格納するコンテナー。 親ノード:なし 子ノード: BlockPublicAccess |
|
BlockPublicAccess |
ブール値 |
true |
アクセスポイントに対してパブリックアクセスブロックが有効になっているかどうかを示します。
|
例
-
リクエストの例
GET /?publicAccessBlock&x-oss-access-point-name=ap-01 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********************/20240219/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 を使用して GetAccessPointPublicAccessBlock を呼び出すことができます。
ossutil
GetAccessPointPublicAccessBlock API に対応する ossutil コマンドの詳細については、「get-access-point-public-access-block」をご参照ください。