アクセスポイントのパブリックアクセスブロックを有効にし、アクセスポイント経由のパブリックアクセスを防止します。
注意事項
-
Alibaba Cloud アカウントには、デフォルトでアクセスポイントのパブリックアクセスブロックを有効にする権限があります。RAM ユーザーとして、または Security Token Service (STS) の認証情報を使用してこの API を実行するには、
oss:PutAccessPointPublicAccessBlock権限が必要です。詳細については、「RAM ポリシーの一般的な例」をご参照ください。 -
パブリックアクセスブロックを有効にすると、既存のパブリックアクセス権限はすべて無視され、新しいパブリックアクセス権限を設定できなくなります。パブリックアクセスブロックを無効にすると、既存のパブリックアクセス権限が有効になり、設定できます。
リクエスト構文
PUT /?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
<?xml version="1.0" encoding="UTF-8"?>
<PublicAccessBlockConfiguration>
<BlockPublicAccess>true</BlockPublicAccess>
</PublicAccessBlockConfiguration>
リクエストヘッダー
この API は、共通リクエストヘッダーのみを使用します。詳細については、「共通リクエストヘッダー」をご参照ください。
リクエスト要素
|
要素 |
タイプ |
必須 |
例 |
説明 |
|
x-oss-access-point-name |
文字列 |
はい |
ap-01 |
アクセスポイントの名前。 |
|
PublicAccessBlockConfiguration |
コンテナー |
はい |
N/A |
パブリックアクセスブロックの設定を格納するコンテナー。 親ノード: なし 子ノード: BlockPublicAccess |
|
BlockPublicAccess |
ブール値 |
いいえ |
true |
アクセスポイントのパブリックアクセスブロックを有効にするかどうかを指定します。
|
レスポンスヘッダー
この API は、共通レスポンスヘッダーのみを返します。詳細については、「共通レスポンスヘッダー」をご参照ください。
例
-
リクエスト例
PUT /?publicAccessBlock&x-oss-access-point-name=ap-01 HTTP/1.1 Date: Mon, 19 Feb 2024 08:40:17 GMT Content-Length: 148 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 <?xml version="1.0" encoding="UTF-8"?> <PublicAccessBlockConfiguration> <BlockPublicAccess>true</BlockPublicAccess> </PublicAccessBlockConfiguration> -
成功レスポンスの例
HTTP/1.1 200 OK x-oss-request-id: 534B371674E88A4D8906**** Date: Mon, 19 Feb 2024 08:40:17 GMT Server: AliyunOSS
OSS SDK
次のプログラミング言語の OSS SDK を使用して PutAccessPointPublicAccessBlock を呼び出すことができます:
ossutil
この API に対応する ossutil コマンドについては、「put-access-point-public-access-block」をご参照ください。