list-bucket-antid-dos-info

Updated at:

Queries the protection list of an Anti-DDoS instance of a bucket.

Important

Anti-DDoS for OSS may incur significant costs. Enable it only when necessary.

Usage notes

By default, an Alibaba Cloud account has permission to call this command. To run it as a RAM user or using Security Token Service (STS) credentials, grant the oss:ListBucketAntiDDosInfo permission. For details, see Attach a custom policy to a RAM user.

Command syntax

ossutil api list-bucket-antid-dos-info [--marker <string>] [--max-keys <string>]

All parameters are optional.

For supported global options, see Global command-line options.

Parameters

ParameterTypeDescription
--markerstringReturns Anti-DDoS instances whose names are alphabetically after the specified marker value.
--max-keysstringThe maximum number of Anti-DDoS instances that can be returned.
This command maps to the ListBucketAntiDDosInfo API operation. For the full list of request and response parameters, see the API reference.

Examples

List all Anti-DDoS instances for a bucket:

ossutil api list-bucket-antid-dos-info

Return results in JSON format:

ossutil api list-bucket-antid-dos-info --output-format json

Return results in YAML format:

ossutil api list-bucket-antid-dos-info --output-format yaml

Return instances whose names are alphabetically after a marker value:

ossutil api list-bucket-antid-dos-info --marker marker

Limit the response to a maximum of 10 instances:

ossutil api list-bucket-antid-dos-info --max-keys 10