Object Storage Service:update-bucket-antid-dos-info

Usage notes

By default, an Alibaba Cloud account has the permissions to update the status of the Anti-DDoS instances of a bucket. To update the status of the Anti-DDoS instances of a bucket by using a RAM user or Security Token Service (STS), you must have the oss:UpdateBucketAntiDDosInfo permission. For more information, see Attach a custom policy to a RAM user.

Command syntax

ossutil api update-bucket-antid-dos-info --bucket value --defender-instance value --defender-status value --bucket-antiddos-configuration value [flags]

--bucket-antiddos-configuration

The --bucket-antiddos-configuration option supports both the XML and JSON formats. If the value of the option contains the file:// prefix, ossutil reads configurations from a configuration file.

• XML format:

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

• JSON format:

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

Examples

The following examples show how to add the abc1.example.cn and abc2.example.cn custom domain names to the protection list of the Anti-DDoS instance whose ID is 123 of the examplebucket bucket and change the status of the Anti-DDoS instance to Init.

• Create a configuration file named bucket-antiddos-configuration.xml and add the following code to the configuration file:

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

Sample command:

ossutil api update-bucket-antid-dos-info --bucket examplebucket --defender-instance 123 --defender-status Init --bucket-antiddos-configuration file://bucket-antiddos-configuration.xml

• Create a configuration file named bucket-antiddos-configuration.json and add the following code to the configuration file:

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

  Sample command:

  ossutil api update-bucket-antid-dos-info --bucket examplebucket --defender-instance 123 --defender-status Init --bucket-antiddos-configuration file://bucket-antiddos-configuration.json

• Configure parameters in the following command in the JSON format:

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