DescribeBuckets - Cloud Phone - Alibaba Cloud Documentation Center

Queries information about buckets. This operation returns only the buckets whose names start with `cloudphone-saved-bucket-`.

Operation description

Currently, you can save backup files generated by Cloud Phone only to Object Storage Service (OSS).

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
FileType	string	No	The type of the OSS file. Note This parameter is not yet available.	docx

Response elements

Element	Type	Description	Example
	object	The response elements.
Data	array<object>	The returned result object.
	object	The returned result object.
GmtCreated	string	The time when the bucket was created.	2024-05-15 17:33:59
RegionId	string	The region ID.	cn-hangzhou
BucketName	string	The name of the bucket.	zydctest
ExtranetEndpoint	string	The public endpoint that is used to access the bucket.	oss-cn-hangzhou.aliyuncs.com
IntranetEndpoint	string	The internal endpoint that is used by a same-region ECS instance to access the bucket.	oss-cn-hangzhou-internal.aliyuncs.com
Location	string	The storage path, such as a path in Hadoop Distributed File System (HDFS) or OSS.	center
OssObjectList	array<object>	The information about the objects in the bucket.
	object	The information about the objects in the bucket.
BucketName	string	The name of the bucket.	tf-testacceu-central-1ensbucketlifecycle44222
Key	string	The tag key.	con
ETag	string	The Entity Tag (ETag) is created when an object is generated. It is used to identify the content of an object. For an object created by a PutObject request, the ETag value is the MD5 hash of the object content. For an object created by other methods, the ETag value is a unique value generated based on specific calculation rules. It is not the MD5 hash of the object content. The ETag value can be used to check if the object content has changed. Do not use the ETag value as the MD5 hash to verify the data integrity of the object.	5B3C1A2E053D763E1B002CC607C5A0FE1****
Size	integer	The size of the file. Unit: KB.	9
LastModified	string	The time when the object was last modified.	2012-02-24T08:42:32.000Z
StorageClass	string	The storage class of the bucket. Valid values: Standard (default): Standard IA: Infrequent Access Archive: Archive Storage ColdArchive: Cold Archive DeepColdArchive: Deep Cold Archive	ARCHIVE
Owner	object	The information about the bucket owner.
DisplayName	string	The name of the bucket owner.	佳钰
Id	string	The unique identifier of the bucket owner.	395
Type	string	The type of the trigger method.	InstanceGroup
RestoreInfo	string	The information about database recovery if the database type is MSSQL. The value is a JSON string that contains the following parameters: name: The name of the database. files: The path of the database file.	ongoing-request="true"
RequestId	string	The request ID.	425F351C-3F8E-5218-A520-B6311D0D****
Success	boolean	The result of the request.	True
Code	string	The error code. Note This parameter is returned only when the call fails.	200
Message	string	The returned message.	Success.
HttpStatusCode	integer	The return status code of the request.	200

Examples

Success response

JSON format

{
  "Data": [
    {
      "GmtCreated": "2024-05-15 17:33:59",
      "RegionId": "cn-hangzhou",
      "BucketName": "zydctest",
      "ExtranetEndpoint": "oss-cn-hangzhou.aliyuncs.com",
      "IntranetEndpoint": "oss-cn-hangzhou-internal.aliyuncs.com\n\n",
      "Location": "center",
      "OssObjectList": [
        {
          "BucketName": "tf-testacceu-central-1ensbucketlifecycle44222",
          "Key": "con",
          "ETag": "5B3C1A2E053D763E1B002CC607C5A0FE1****\n\n",
          "Size": 9,
          "LastModified": "2012-02-24T08:42:32.000Z",
          "StorageClass": "ARCHIVE",
          "Owner": {
            "DisplayName": "佳钰",
            "Id": "395"
          },
          "Type": "InstanceGroup",
          "RestoreInfo": "ongoing-request=\"true\""
        }
      ]
    }
  ],
  "RequestId": "425F351C-3F8E-5218-A520-B6311D0D****",
  "Success": true,
  "Code": "200",
  "Message": "Success.",
  "HttpStatusCode": 200
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.