ListBuckets_对象存储_API文档-阿里云OpenAPI开发者门户

接口说明

您也可以通过设置 prefix、marker 或者 max-keys 参数列举满足指定条件的存储空间。
要列举存储空间，您必须有 oss:GetService (ListBuckets)权限。具体操作，请参见为 RAM 用户授权自定义的权限策略。
调用接口时，如果所有 Bucket 已返回，则返回参数的 XML 中不包含 Prefix、Marker、MaxKeys、IsTruncated 和 NextMarker 响应元素。

当前云产品API请求速率暂未透出。

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

oss:ListBuckets	List	全部资源 *	acs:UserAgent acs:AccessId oss:TLSVersion	无

GET / HTTP/1.1
Host: oss-cn-hangzhou.aliyuncs.com
x-oss-resource-group-id: string

字段名称	字段详情
prefixstring	限定返回的 Bucket 名称必须以 prefix 作为前缀。如果不设定，则不过滤前缀信息。展开详情示例值:my
markerstring	设定结果从 marker 之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。展开详情示例值:mybucket10
max-keysinteger<int64>	限定此次返回 Bucket 的最大个数。展开详情注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:100
x-oss-resource-group-idResourceGroupId	指定资源组 ID。展开详情示例值:rg-aekz****
tag-keystring	指定 Bucket 标签键。列举结果中仅会包含那些打上了对应标签的 Bucket。示例值:test-key
tag-valuestring	指定 Bucket 标签值。如果请求指定了该参数，那么必须同时指定 tag-value，列举结果中仅会包含那些打上了对应标签键值对的 Bucket。示例值:test-value
taggingstring	指定标签列表。如："k1":"v1","k2":"v2"，只有 Bucket 匹配列表中所有的标签键值对，才会出现在列举结果中。展开详情示例值:"test-key":"test-value"

字段名称	字段详情
ListAllMyBucketsResultobject	保存 ListBuckets（GetService）请求结果的容器。

	变更时间	变更内容概要	操作
	2024-12-04	新增请求参数tag-key 新增请求参数tag-value 新增请求参数tagging
	2024-11-28	变更请求参数prefix 变更请求参数marker 变更请求参数max-keys 变更请求参数x-oss-resource-group-id 变更返回参数
	2024-02-22	变更返回参数
	2024-02-21	变更返回参数