ListBuckets - 查询存储空间列表_边缘节点服务 ENS(ENS)-阿里云帮助中心

调用ListBuckets查询指定用户拥有的所有存储空间（Bucket）。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
Prefix	string	否	限定返回的 bucket name 必须以 prefix 作为前缀。可以不设定该参数，不设定时则不过滤前缀信息。	image
PageNumber	string	否	翻页页码，从 1 开始。	1
PageSize	string	否	限定此次返回 bucket 的最⼤数。可以不设定该参数，不设定时默认值为 10，取值不能⼤于 100。	5

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	435769C7-AA6F-4DC5-B3DB-A3DC0DE7E853
BucketInfos	object []	Bucket 信息列表
BucketAcl	string	Bucket 读写权限类型： public-read-write：公共读写 public-read：公共读 private：私有（默认值）	private
BucketName	string	Bucket 名称。	test
Comment	string	备注。	numb
CreateTime	string	Bucket 创建时间。按照 ISO8601 标准表示，并需要使用 UTC 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。	2022-10-12T05:45:00Z
LogicalBucketType	string	单节点存储，取值：sink	sink
ModifyTime	string	Bucket 修改时间。按照 ISO8601 标准表示，并需要使用 UTC 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。	2022-10-12T06:45:00Z
EnsRegionId	string	节点区域 ID。	cn-dalian-unicom
TotalCount	long	命中条件 Bucket 总数。	1

示例

正常返回示例

JSON格式

{
  "RequestId": "435769C7-AA6F-4DC5-B3DB-A3DC0DE7E853",
  "BucketInfos": [
    {
      "BucketAcl": "private",
      "BucketName": "test",
      "Comment": "numb",
      "CreateTime": "2022-10-12T05:45:00Z",
      "LogicalBucketType": "sink",
      "ModifyTime": "2022-10-12T06:45:00Z",
      "EnsRegionId": "cn-dalian-unicom"
    }
  ],
  "TotalCount": 1
}

错误码

HTTP status code	错误码	错误信息	描述
400	MissingParameter	MissingParameter	-
400	NoPermission	Permission denied.	没有足够的权限，请联系云账号管理员授予您相应权限。
400	InvalidParameter.%s	The specified field %s invalid. Please check it again.	-
403	AccessDenied	auth is not valid	-
404	NoSuchBucket	The specified bucket does not exist	-

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作

暂无变更历史