All Products
Search
Document Center

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

Last Updated:Dec 20, 2024

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

Important

High fees may be incurred by the usage of Anti-DDoS for OSS. We recommend that you enable this feature only when it is necessary.

Usage notes

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

Command syntax

ossutil api list-bucket-antid-dos-info [flags]

Parameter

Type

Description

--marker

string

The name of the Anti-DDoS instance after which the list starts. If this parameter is specified, Anti-DDoS instances whose names are alphabetically after the marker value are returned.

--max-keys

string

The maximum number of Anti-DDoS instances that can be returned.

Note
  • The list-bucket-antid-dos-info command corresponds to the ListBucketAntiDDosInfo operation. For more information about the parameters in the ListBucketAntiDDosInfo operation, see ListBucketAntiDDosInfo.

  • For more information about supported global command-line options, see Global command-line options.

Examples

  • Query the protection list of an Anti-DDoS instance of a bucket:

    ossutil api list-bucket-antid-dos-info
  • Query the protection list of an Anti-DDoS instance of a bucket and display the query results in the JSON format:

    ossutil api list-bucket-antid-dos-info --output-format json
  • Query the protection list of an Anti-DDoS instance of a bucket and display the query results in the YAML format:

    ossutil api list-bucket-antid-dos-info --output-format yaml
  • Query the protection list of Anti-DDoS instances whose names are alphabetically after the marker value of a bucket:

    ossutil api list-bucket-antid-dos-info --marker marker
  • Query the protection list of a maximum of 10 Anti-DDoS instances of a bucket:

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