InitBucketAntiDDosInfo初始化Bucket防护_对象存储(OSS)-阿里云帮助中心

init-bucket-antid-dos-info 命令用于初始化Bucket防护。

重要

使用OSS的高防功能可能会产生高额费用，请您谨慎开启该功能。

注意事项

阿里云账号默认拥有初始化Bucket防护的权限。如果您需要通过RAM用户或者STS的方式进行初始化，您必须拥有oss:InitBucketAntiDDosInfo权限。具体操作，请参见为RAM用户授权自定义的权限策略。

命令格式

ossutil api init-bucket-antid-dos-info --bucket value --defender-instance value --defender-type value --bucket-antiddos-configuration value [flags]

参数	类型	说明
--bucket	string	Bucket的名称。
--bucket-antiddos-configuration	string	保存高防实例配置信息的容器。
--defender-instance	string	高防实例Id。
--defender-type	string	高防实例类型。

说明

init-bucket-antid-dos-info命令对应API接口InitBucketAntiDDosInfo。关于API中的具体参数含义，请参见InitBucketAntiDDosInfo。

--bucket-antiddos-configuration

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

XML语法：

<BucketAntiDDOSConfiguration>
  <Cnames>
    <Domain>string</Domain>
    ...
  </Cnames>
</BucketAntiDDOSConfiguration>

JSON语法：

{
  "Cnames": {
    "Domain": ["string", ...]
  }
}

说明

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

使用示例

以下示例展示了如何为存储空间 examplebucket 配置待防护的自定义域名 abc1.example.cn 和 abc2.example.cn，并为其初始化高防服务。高防实例的ID为 123，实例类型为 AntiDDosPremimum。

使用XML配置文件，bucket-antiddos-configuration.xml内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<AntiDDOSConfiguration>
<Cnames>
  <Domain>abc1.example.cn</Domain>
  <Domain>abc2.example.cn</Domain>
</Cnames>
</AntiDDOSConfiguration>

命令示例如下：

ossutil api init-bucket-antid-dos-info --bucket examplebucket  --defender-instance 123 --defender-type AntiDDosPremimum --bucket-antiddos-configuration file://bucket-antiddos-configuration.xml

使用JSON配置文件，bucket-antiddos-configuration.json 内容如下：

{
  "Cnames": {
    "Domains": ["abc1.example.cn", "abc2.example.cn"]
  }
}

命令示例如下：

ossutil api init-bucket-antid-dos-info --bucket examplebucket  --defender-instance 123 --defender-type AntiDDosPremimum --bucket-antiddos-configuration file://bucket-antiddos-configuration.json

使用JSON配置参数，命令示例如下：

ossutil api init-bucket-antid-dos-info --bucket examplebucket  --defender-instance 123 --defender-type AntiDDosPremimum --bucket-antiddos-configuration "{\"Cnames\":{\"Domains\":[\"abc1.example.cn\",\"abc2.example.cn\"]}}"