Listing Buckets

Function

This API is used to list buckets.

Calling Method

For details, see Calling APIs.

URI

POST /v2/{project_id}/objectstorage/buckets

**Table 1** Path parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	The project ID. Minimum length: 1 character Maximum length: 1,024 characters

Request

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	The IAM token authentication. Ensure that the project ID in the token matches the project ID in the request URI. Minimum length: 1 character Maximum length: 16,384 characters

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
cloud_type	Yes	String	The cloud service provider. AWS Aliyun: Alibaba Cloud Qiniu: Qiniu Cloud QingCloud Tencent: Tencent Cloud Baidu: Baidu Cloud KingsoftCloud Azure: Microsoft Azure UCloud HuaweiCloud: Huawei Cloud Google: Google Cloud URLSource: URL data sources HEC: HEC Default value: Aliyun Minimum length: 0 characters Maximum length: 100 characters
ak	No	String	The AK for accessing the source bucket. Enter a maximum of 100 characters. This parameter is mandatory when task_type is not url_list. Minimum length: 0 characters Maximum length: 100 characters
sk	No	String	The SK for accessing the source bucket. Enter a maximum of 100 characters. This parameter is mandatory when task_type is not url_list. Minimum length: 0 characters Maximum length: 100 characters
json_auth_file	No	String	The file used for Google Cloud Storage authentication. Minimum length: 0 characters Maximum length: 65,535 characters
app_id	No	String	This parameter is returned when cloud_type is Tencent. Minimum length: 0 characters Maximum length: 255 characters

Response

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
[Array elements]	Array of strings	A list of bucket names.

Status code: 400

**Table 5** Response body parameters
Parameter	Type	Description
error_msg	String	The error message.
error_code	String	The error code.

Example Request

This example lists all buckets in an account using an AK/SK pair.

POST https://{endpoint}/v2/{project_id}/objectstorage/buckets

{
  "cloud_type" : "HuaweiCloud",
  "ak" : "xxxxak",
  "sk" : "xxxxsk",
  "app_id" : "apptest123"
}