ListOssBucket - Security Center - Alibaba Cloud Documentation Center

Queries Object Storage Service (OSS) buckets.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
BucketName	string	No	The name of the bucket.	iboxpublic****
Lang	string	No	The language of the content in the request and response. Default value: zh. Valid values: zh: Chinese. en: English.	en

Response parameters

Parameter	Type	Description	Example
	object	The response parameters.
RequestId	string	The request ID.	3956048F-9D73-5EDB-834B-4827BB48****
Data	object []	The data returned.
BucketName	string	The name of the bucket.	iboxpublic****
Support	boolean	Indicates whether the bucket can be checked. Valid values: true false	true
Message	string	The reason why the bucket cannot be checked.	Unsupported Region.
StorageClass	string	The storage class of the bucket. Valid values: Standard (default) IA Archive ColdArchive	Standard
RegionId	string	The region ID.	cn-hangzhou
SupportConfig	string	Whether to support config. Valid values: true false	true

Examples

Sample success responses

JSONformat

{
  "RequestId": "3956048F-9D73-5EDB-834B-4827BB48****",
  "Data": [
    {
      "BucketName": "iboxpublic****",
      "Support": true,
      "Message": "Unsupported Region.",
      "StorageClass": "Standard",
      "RegionId": "cn-hangzhou",
      "SupportConfig": "true"
    }
  ]
}

Error codes

HTTP status code	Error code	Error message	Description
403	NoPermission	caller has no permission	You are not authorized to do this operation.
500	ServerError	ServerError	-

For a list of error codes, visit the Service error codes.

Change history

Change time

Summary of changes

Operation

2023-12-07

The Error code has changed. The response structure of the API has changed

see changesets

Change item	Change content
Error Codes	The Error code has changed.
	delete Error Codes: 403
	delete Error Codes: 500
Output Parameters	The response structure of the API has changed.