ListBuckets (GetService) - List all buckets | OSS API - Object Storage Service

Notes d'utilisation

Pour répertorier les buckets Object Storage Service (OSS), vous devez disposer de l'autorisation oss:ListBuckets.

Pour plus d'informations, consultez la rubrique Grant a custom policy.

Syntaxe de la requête

GET / HTTP/1.1
Host: oss.example.com
Date: GMT Date
Authorization: SignatureValue

En-têtes de requête

Header

Type

Required

Example

Description

x-oss-resource-group-id

String

No

rg-aek27tc****

ID du groupe de ressources.

Si cet en-tête est défini sur un ID de groupe de ressources, la réponse inclut les buckets de ce groupe.

Si la valeur est rg-default-id, la réponse inclut les buckets du groupe de ressources par défaut.
Si l'en-tête est présent mais sans valeur, la réponse inclut les buckets du groupe de ressources par défaut.
Si l'en-tête est omis, la réponse inclut tous les buckets de votre compte Alibaba Cloud.

Récupérez l'ID du groupe de ressources depuis la console Resource Management ou en appelant ListResourceGroups. Pour plus d'informations, consultez les rubriques View a resource group et ListResourceGroups.

Pour plus d'informations sur les autres en-têtes de requête courants inclus dans une requête ListBuckets (GetService), tels que Host et Date, consultez la rubrique Common request headers.

Paramètres de requête

Header	Type	Required	Example	Description
prefix	String	No	my	Préfixe que les noms de bucket retournés doivent contenir. Si ce paramètre n'est pas spécifié, aucun filtre par préfixe n'est appliqué. Valeur par défaut : vide.
marker	String	No	mybucket10	Nom de bucket à partir duquel le listage commence. Seuls les buckets dont le nom suit alphabétiquement cette valeur sont retournés. Si ce paramètre n'est pas spécifié, tous les buckets sont retournés. Valeur par défaut : vide.
max-keys	Integer	No	10	Nombre maximal de buckets à retourner. Valeurs valides : 1 à 1000. Valeur par défaut : 100.

En-têtes de réponse

Tous les en-têtes de la réponse à une requête ListBuckets (GetService) sont des en-têtes de réponse courants. Pour plus d'informations, consultez la rubrique Common response headers.

Éléments de réponse

Remarque

La réponse XML de ListBuckets (GetService) omet les éléments Prefix, Marker, MaxKeys, IsTruncated et NextMarker lorsque tous les buckets sont retournés.

Header	Type	Example	Description
ListAllMyBucketsResult	Container	N/A	Conteneur racine pour les résultats de ListBuckets (GetService). Nœuds enfants : Owner et Buckets Nœuds parents : aucun
Prefix	String	my	Préfixe utilisé pour filtrer les buckets retournés. Nœuds parents : ListAllMyBucketsResult
Marker	String	mybucket	Nom de bucket à partir duquel le listage ListBuckets (GetService) commence. Nœuds parents : ListAllMyBucketsResult
MaxKeys	String	10	Nombre maximal de buckets retournés. Nœuds parents : ListAllMyBucketsResult
IsTruncated	Enumerated string	true	Indique si tous les résultats ont été retournés. Valeurs valides : true : tous les résultats n'ont pas été retournés. false : tous les résultats ont été retournés. Nœuds parents : ListAllMyBucketsResult
NextMarker	String	mybucket10	Marqueur de pagination pour récupérer les résultats restants. Nœuds parents : ListAllMyBucketsResult
Owner	Container	N/A	Conteneur contenant les détails du propriétaire du bucket. Nœuds parents : ListAllMyBucketsResult
ID	String	ut_test_put_bucket	ID utilisateur du propriétaire du bucket. Nœuds parents : ListAllMyBucketsResult.Owner
DisplayName	String	ut_test_put_bucket	Nom d'affichage du propriétaire du bucket, identique à l'ID utilisateur. Nœuds parents : ListAllMyBucketsResult.Owner
Buckets	Container	N/A	Conteneur regroupant plusieurs entrées de bucket. Nœud enfant : Bucket Nœuds parents : ListAllMyBucketsResult
Bucket	Container	N/A	Conteneur contenant les détails d'un bucket individuel. Nœuds enfants : Name, CreationDate et Location Nœuds parents : ListAllMyBucketsResult.Buckets
Name	String	mybucket01	Nom du bucket. Nœuds parents : ListAllMyBucketsResult.Buckets.Bucket
CreationDate	Time	2014-05-15T11:18:32.000Z	Date de création du bucket. Format : `yyyy-mm-ddThh:mm:ss.timezone`. Nœuds parents : ListAllMyBucketsResult.Buckets.Bucket
Location	String	oss-cn-hangzhou	ID de région OSS. Nœuds parents : ListAllMyBucketsResult.Buckets.Bucket
ExtranetEndpoint	String	oss-cn-hangzhou.aliyuncs.com	Endpoint public du bucket. Nœuds parents : ListAllMyBucketsResult.Buckets.Bucket
IntranetEndpoint	String	oss-cn-hangzhou-internal.aliyuncs.com	Endpoint interne du bucket. Nœuds parents : ListAllMyBucketsResult.Buckets.Bucket
Region	String	cn-hangzhou	ID de région Alibaba Cloud. Nœuds parents : ListAllMyBucketsResult.Buckets.Bucket
StorageClass	String	Standard	Classe de stockage du bucket. Valeurs valides : Standard, IA, Archive, ColdArchive et DeepColdArchive. Nœuds parents : ListAllMyBucketsResult.Buckets.Bucket
ResourceGroupId	String	rg-aek27tc****	ID du groupe de ressources du bucket. Les buckets appartenant au groupe de ressources par défaut retournent rg-default-id. Nœuds parents : ListAllMyBucketsResult.Buckets.Bucket

Exemples

Répertorier tous les buckets de votre compte

Exemple de requête

GET / HTTP/1.1
Date: Thu, 15 May 2014 11:18:32 GMT
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Exemple de réponse réussie

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>2014-02-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-02-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>mybucket</Name>
      <Region>cn-hangzhou</Region>
      <StorageClass>IA</StorageClass>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

Répertorier les buckets par préfixe et max-keys

Exemple de requête

GET /?prefix=my&max-keys=10 HTTP/1.1
Date: Thu, 15 May 2014 11:18:32 GMT
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Exemple de réponse réussie

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>my</Prefix>
  <Marker>mybucket</Marker>
  <MaxKeys>10</MaxKeys>
  <IsTruncated>true</IsTruncated>
  <NextMarker>mybucket10</NextMarker>
  <Owner>
    <ID>ut_test_put_bucket</ID>
    <DisplayName>ut_test_put_bucket</DisplayName>
  </Owner>
  <Buckets>
    <Bucket>
      <CreationDate>2014-05-14T11: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>mybucket01</Name>
      <Region>cn-hangzhou</Region>
      <StorageClass>Standard</StorageClass>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

Répertorier les buckets d'un groupe de ressources spécifique

Exemple de requête

GET / HTTP/1.1
Date: Thu, 15 May 2014 11:18:32 GMT
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
x-oss-resource-group-id: rg-aek27tc********

Exemple de réponse réussie

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>2014-02-07T18: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>test-bucket-1</Name>
      <Region>cn-shanghai</Region>
      <StorageClass>Standard</StorageClass>
      <ResourceGroupId>rg-aek27tc********</ResourceGroupId>
    </Bucket>
    <Bucket>
      <CreationDate>2014-02-05T11: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>test-bucket-2</Name>
      <Region>cn-hangzhou</Region>
      <StorageClass>IA</StorageClass>
      <ResourceGroupId>rg-aek27tc********</ResourceGroupId>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

Répertorier les buckets du groupe de ressources par défaut

Exemple de requête

GET / HTTP/1.1
Date: Thu, 15 May 2014 11:18:32 GMT
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
x-oss-resource-group-id: rg-default-id

Exemple de réponse réussie

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>2014-02-07T18: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>test-bucket-3</Name>
      <Region>cn-shanghai</Region>
      <StorageClass>Standard</StorageClass>
      <ResourceGroupId>rg-default-id</ResourceGroupId>
    </Bucket>
    <Bucket>
      <CreationDate>2014-02-05T11: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>test-bucket-4</Name>
      <Region>cn-hangzhou</Region>
      <StorageClass>IA</StorageClass>
      <ResourceGroupId>rg-default-id</ResourceGroupId>
    </Bucket>
  </Buckets>
</ListAllMyBucketsResult>

SDK

Utilisez les SDK OSS pour les langages de programmation suivants afin d'appeler ListBuckets (GetService) :

ossutil

Pour obtenir des informations sur la commande ossutil correspondant à l'opération ListBuckets, consultez la rubrique list-buckets (get-service).

Codes d'erreur

Error code

HTTP status code

Description

AccessDenied

403

La requête provient d'un utilisateur anonyme et ne contient pas d'informations d'authentification.