对服务地址做Get请求可以返回请求者拥有的所有存储空间（Bucket），其中正斜线（/）表示根目录。

说明 GetService (ListBuckets)接口仅对验证通过的用户有效。

请求语法

1
2
3
4
GET / HTTP/1.1
Host: oss.example.com
Date: GMT Date
Authorization: SignatureValue

请求参数

说明 GetService(ListBucket)时，可以通过prefix、marker和max-keys对list做限定，返回部分结果。
名称 类型 是否必需 描述
prefix 字符串 否 限定返回的bucket name必须以prefix作为前缀，可以不设定。不设定时则不过滤前缀信息。

默认值：无
marker 字符串 否 设定结果从marker之后按字母排序的第一个开始返回，可以不设定。不设定时则从头开始返回数据。

默认值：无
max-keys Integer 否 限定此次返回bucket的最大数，可以不设定。如果不设定，默认为100，max-keys取值不能大于1000。

默认值：100

响应元素

说明 当所有的Bucket都返回时，返回的xml中不包含Prefix、Marker、MaxKeys、IsTruncated、NextMarker节点，如果还有部分Bucket未返回，则增加上述节点。
名称 类型 描述
ListAllMyBucketsResult 容器 保存Get Service请求结果的容器。

子节点：Owner、Buckets

父节点：None
Prefix 字符串 本次查询结果的前缀。

父节点：ListAllMyBucketsResult
Marker 字符串 标明这次GetService (ListBucket)的起点。

父节点：ListAllMyBucketsResult
MaxKeys 字符串 响应请求内返回结果的最大数目。

父节点：ListAllMyBucketsResult
IsTruncated 枚举字符串 指明是否所有的结果都已经返回。
有效值： true、 false
  • true表示本次没有返回全部结果。
  • false表示本次已经返回了全部结果。

父节点：ListAllMyBucketsResult
NextMarker 字符串 用于继续查询时给marker赋值。表示下一次GetService (ListBucket)可以以此为marker，将未返回的结果返回。

父节点：ListAllMyBucketsResult
Owner 容器 用于存放Bucket拥有者信息的容器。

父节点：ListAllMyBucketsResult
ID 字符串 Bucket拥有者的用户ID。

父节点：ListAllMyBucketsResult.Owner
DisplayName 字符串 Bucket拥有者的名称 （目前和ID一致）。

父节点：ListAllMyBucketsResult.Owner
Buckets 容器 保存多个Bucket信息的容器。

子节点：Bucket

父节点：ListAllMyBucketsResult
Bucket 容器 保存bucket信息的容器。

子节点：Name, CreationDate, Location

父节点：ListAllMyBucketsResult.Buckets
Name 字符串 Bucket名称。

父节点：ListAllMyBucketsResult.Buckets.Bucket
CreateDate 时间 （格式：yyyy-mm-ddThh:mm:ss.timezone, 例如 2011-12-01T12:27:13.000Z） Bucket创建时间。

父节点：ListAllMyBucketsResult.Buckets.Bucket
Location 字符串 Bucket所在的数据中心。

父节点：ListAllMyBucketsResult.Buckets.Bucket
ExtranetEndpoint 字符串 Bucket访问的外网域名。

父节点：ListAllMyBucketsResult.Buckets.Bucket
IntranetEndpoint 字符串 同区域ECS访问Bucket的内网域名。

父节点：ListAllMyBucketsResult.Buckets.Bucket
StorageClass 字符串 Bucket存储类型，支持Standard、IA、Archive和ColdArchive四种存储类型。

父节点：ListAllMyBucketsResult.Buckets.Bucket

示例

  • 请求示例1
    1
    2
    3
    4
    GET / HTTP/1.1
    Date: Thu, 15 May 2014 11:18:32 GMT
    Host: oss-cn-hangzhou.aliyuncs.com
    Authorization: OSS nxj7dtlhcyl5hpvnhi:COS3OQkfQPnKmYZTEHYv2******
    返回示例1
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    HTTP/1.1 200 OK
    Date: Thu, 15 May 2014 11:18:32 GMT
    Content-Type: application/xml
    Content-Length: 556
    Connection: keep-alive
    Server: AliyunOSS
    x-oss-request-id: 5374A2880232A65C2300****
    <?xml version="1.0" encoding="UTF-8"?>
    <ListAllMyBucketsResult>
      <Owner>
        <ID>512**</ID>
        <DisplayName>51264</DisplayName>
      </Owner>
      <Buckets>
        <Bucket>
          <CreationDate>2015-12-17T18:12:43.000Z</CreationDate>
          <ExtranetEndpoint>oss-cn-shanghai.aliyuncs.com</ExtranetEndpoint>
          <IntranetEndpoint>oss-cn-shanghai-internal.aliyuncs.com</IntranetEndpoint>
          <Location>oss-cn-shanghai</Location>
          <Name>app-base-oss</Name>
          <Region>cn-shanghai</Region>
          <StorageClass>Standard</StorageClass>
        </Bucket>
        <Bucket>
          <CreationDate>2014-12-25T11:21:04.000Z</CreationDate>
          <ExtranetEndpoint>oss-cn-hangzhou.aliyuncs.com</ExtranetEndpoint>
          <IntranetEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</IntranetEndpoint>
          <Location>oss-cn-hangzhou</Location>
          <Name>atestleo23</Name>
          <Region>cn-hangzhou</Region>
          <StorageClass>IA</StorageClass>
        </Bucket>
      </Buckets>
    </ListAllMyBucketsResult>
  • 请求示例2
    1
    2
    3
    4
    GET /?prefix=xz02tphky6fjfiuc&max-keys=1 HTTP/1.1
    Date: Thu, 15 May 2014 11:18:32 GMT
    Host: oss-cn-hangzhou.aliyuncs.com
    Authorization: OSS nxj7dtwhcyl5hpvnhi:COS3OQkfQPnKmYZTEHYv2****
    返回示例2
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    HTTP/1.1 200 OK
    Date: Thu, 15 May 2014 11:18:32 GMT
    Content-Type: application/xml
    Content-Length: 545
    Connection: keep-alive
    Server: AliyunOSS
    x-oss-request-id: 5374A2880232A65C2300****
    <?xml version="1.0" encoding="UTF-8"?>
    <ListAllMyBucketsResult>
      <Prefix>xz02tphky6fjfiuc</Prefix>
      <Marker></Marker>
      <MaxKeys>1</MaxKeys>
      <IsTruncated>true</IsTruncated>
      <NextMarker>xz02tphky6fjfiuc0</NextMarker>
      <Owner>
        <ID>ut_test_put_bucket</ID>
        <DisplayName>ut_test_put_bucket</DisplayName>
      </Owner>
      <Buckets>
        <Bucket>
          <CreationDate>2014-05-15T11:18:32.000Z</CreationDate>
          <ExtranetEndpoint>oss-cn-hangzhou.aliyuncs.com</ExtranetEndpoint>
          <IntranetEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</IntranetEndpoint>
          <Location>oss-cn-hangzhou</Location>
          <Name>xz02tphky6fjfiuc0</Name>
          <Region>cn-hangzhou</Region>
          <StorageClass>Standard</StorageClass>
        </Bucket>
      </Buckets>
    </ListAllMyBucketsResult>

SDK

此接口所对应的各语言SDK如下：

错误码

错误码 HTTP 状态码 描述
AccessDenied 403 请求中没有用户验证信息（即匿名访问）。