put-bucket-public-access-block

put-bucket-public-access-block用于设置存储空间上的阻止公共访问的配置信息。

注意事项

阿里云账号默认拥有设置存储空间上的阻止公共访问的配置信息的权限。如果您需要通过RAM用户或者STS的方式设置存储空间上的阻止公共访问的配置信息,您必须拥有oss:PutBucketPublicAccessBlock权限。具体操作,请参见RAM用户授权自定义的权限策略

命令格式

ossutil api put-bucket-public-access-block --bucket value --public-access-block-configuration value [flags]

参数

类型

说明

--bucket

string

Bucket名称。

--public-access-block-configuration

string

Bucket阻止公共访问配置信息。

说明

put-bucket-public-access-block命令对应API接口PutBucketPublicAccessBlock。关于API中的具体参数含义,请参见PutBucketPublicAccessBlock

--public-access-block-configuration

--public-access-block-configuration配置选项既支持XML语法也支持JSON语法,当选项值包含file://前缀时,表示从文件中读取配置。

  • XML语法:

    <PublicAccessBlockConfiguration>
      <BlockPublicAccess>true</BlockPublicAccess>
    </PublicAccessBlockConfiguration>
  • JSON语法:

    {
      "BlockPublicAccess": "string"
    }
说明

关于支持的全局命令行选项,请参见支持的全局命令行选项

使用示例

开启存储空间examplebucket阻止公共访问的配置信息。

  • 使用XML配置文件,public-access-block-configuration.xml内容如下:

    <?xml version="1.0" encoding="UTF-8"?>
    <PublicAccessBlockConfiguration>
      <BlockPublicAccess>true</BlockPublicAccess>
    </PublicAccessBlockConfiguration>

命令示例如下:

ossutil api put-bucket-public-access-block --bucket examplebucket --public-access-block-configuration file://public-access-block-configuration.xml
  • 使用JSON配置文件,public-access-block-configuration.json内容如下:

    {
      "BlockPublicAccess": "true"
    }

    命令示例如下:

    ossutil api put-bucket-public-access-block --bucket examplebucket --public-access-block-configuration file://public-access-block-configuration.json
  • 使用JSON配置参数,命令示例如下:

    ossutil api put-bucket-public-access-block --bucket examplebucket --public-access-block-configuration "{\"BlockPublicAccess\":\"true\"}"