Object Storage Service

Products

Object Storage Service

Get Service

Description

The operation carries out Get request to the service address, which can return all Buckets that the requester owns.

The operation requires identity verification to the requesters, you must use AccessKey and AccessKeySecret registered in JD Cloud to complete the verification, which anonymous request cannot list Buckets.

Request

Syntax


GET / HTTP/1.1
Host: s3.<REGION>.jdcloud-oss.com
Date: <date>
Authorization: <authorization string> (see Authenticating Requests (AWS Signature Version4))

Request Parameter

The operation needs no request parameters.

Request Header

The operation only uses general request Header, please see Headers of common requests.

Request Elements

The operation needs no request elements.

Response

Response Element

Name Description
Bucket Bucket Information Set
Type: Container
Children:Name,CreationDate
Ancestor:ListAllMyBucketsResult.Buckets
Buckets Multiple Bucket Information Set
Type: Container
Children: Bucket
Ancestor: ListAllMyBucketsResult
CreationDate Creation date of the Bucket
Type: date ( of the form yyyy-mm-ddThh:mm:ss.timezone, e.g., 2009-02-03T16:45:09.000Z)
Ancestor: ListAllMyBucketsResult.Buckets.Bucket
DispalyName Name of the Bucket Owner
Type: String
Ancestor: ListAllMyBucketsResult.Owner
ID ID of the Bucket Owner
Type: String
Ancestor: ListAllMyBucketsResult.Owner
ListAllMyBucketsResult Response Set
Children: Owner, Buckets
Ancestor: None
Name Bucket Name
Type: String
Ancestor: ListAllMyBucketsResult.Buckets.Bucket
Owner Information Set of the Bucket Owner
Type: Container
Ancestor: ListAllMyBucketsResult

Examples

Request Example


GET / HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Date: Wed, 01 Mar  2006 12:00:00 GMT
Authorization: <authorization string>

Return Example


<?xml version="1.0" encoding="UTF-8"?>
<ListAllMyBucketsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01">
  <Owner>
    <ID>bcaf1ffd86f461ca5fb16fd081034f</ID>
    <DisplayName>webfile</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <Name>quotes</Name>
      <CreationDate>2006-02-03T16:45:09.000Z</CreationDate>
    </Bucket>
    <Bucket>
      <Name>samples</Name>
      <CreationDate>2006-02-03T16:41:58.000Z</CreationDate>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>
Update Time:2019-05-28 16:47:17