ListBuckets
列举请求者拥有的所有存储空间（Bucket）
服务地址：
华东1 金融云
输入参数
只看必填
prefix限定返回的Bucket名称必须以pre...
marker设定结果从marker之后按字母排序的...
max-keys限定此次返回Bucket的最大个数
x-oss-resource-group-id指定资源组ID
tag-key指定Bucket标签键
tag-value指定Bucket标签值
tagging指定标签列表
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

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

请求语法

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

Bucket 所属资源组 Id

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
变更返回参数