ListVectorBuckets - Object Storage Service - Centre de documentation Alibaba Cloud

Permissions

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations sur ses ressources. Les utilisateurs RAM et les rôles RAM n'ont aucune autorisation par défaut. Pour permettre à un utilisateur ou à un rôle RAM d'appeler cette opération, un compte Alibaba Cloud ou un administrateur RAM doit lui accorder les autorisations requises via une politique RAM ou une politique de bucket.

API

Action

Description

ListVectorBuckets

oss:ListVectorBuckets

Répertorie les buckets vectoriels.

Syntaxe de la requête

GET / HTTP/1.1
Host: cn-hangzhou-internal.oss-vectors.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

En-têtes de requête

Cette opération utilise uniquement des en-têtes de requête communs. Pour plus d'informations, consultez la section En-têtes HTTP communs.

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

prefix

String

Non

my

Préfixe obligatoire pour les noms des buckets vectoriels renvoyés.

marker

String

Non

mybucket

Position de départ de l'ensemble des résultats. Les résultats sont renvoyés par ordre alphabétique, à partir de l'entrée suivant immédiatement le marqueur spécifié.

max-keys

Number

Non

100

Nombre maximal de buckets vectoriels à renvoyer. Valeurs possibles : 1 à 1000. Valeur par défaut : 100.

En-têtes de réponse

Cette opération utilise uniquement des en-têtes de réponse communs. Pour plus d'informations, consultez la section En-têtes HTTP communs.

Éléments de réponse

Remarque

Lorsque vous appelez l'opération ListVectorBuckets, si tous les buckets sont renvoyés, la réponse n'inclut pas les éléments Prefix, Marker, MaxKeys, IsTruncated et NextMarker.

Paramètre	Type	Exemple	Description
ListAllMyBucketsResult	Container	N/A	Conteneur de la réponse ListVectorBuckets.
Prefix	String	my	Préfixe spécifié dans la requête. Nœud parent : ListAllMyBucketsResult
Marker	String	mybucket	Position de départ de la requête ListVectorBuckets. Nœud parent : ListAllMyBucketsResult
MaxKeys	Number	10	Nombre maximal de buckets vectoriels à renvoyer dans la réponse. Nœud parent : ListAllMyBucketsResult
IsTruncated	Boolean	true	Indique si tous les buckets vectoriels ont été renvoyés. Valeurs possibles : true : Tous les buckets vectoriels n'ont pas été renvoyés. false : Tous les buckets vectoriels ont été renvoyés. Nœud parent : ListAllMyBucketsResult
NextMarker	String	mybucket10	Si IsTruncated est true, cet élément indique le marqueur de la page suivante. Utilisez cette valeur comme paramètre `marker` dans une requête ListVectorBuckets ultérieure pour récupérer la page suivante. Nœud parent : ListAllMyBucketsResult
Buckets	Container	N/A	Conteneur des détails des buckets vectoriels. Nœud parent : ListAllMyBucketsResult
Name	String	acs:ossvector:cn-shanghai:103735:test-bucket-3	Identifiant du bucket vectoriel, renvoyé sous forme d'ARN de bucket. Nœud parent : Buckets
CreationDate	String	2014-02-07T18:12:43.000Z	Date de création du bucket vectoriel. Nœud parent : Buckets
ExtranetEndpoint	String	cn-shanghai.oss-vectors.aliyuncs.com	Endpoint public du bucket vectoriel. Nœud parent : Buckets
IntranetEndpoint	String	cn-shanghai-internal.oss-vectors.aliyuncs.com	Endpoint interne du bucket vectoriel. Nœud parent : Buckets
Location	String	oss-cn-shanghai	ID de région spécifique à OSS. Nœud parent : Buckets
Region	String	cn-shanghai	ID de région Alibaba Cloud standard. Nœud parent : Buckets

Exemples

Exemple de requête

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

Exemple de réponse

HTTP/1.1 200 OK
Date: Thu, 15 May 2014 11:18:32 GMT
Content-type: application/json
Content-Length: 545
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 5374A2880232A65C2300****

{
  "ListAllMyBucketsResult": {
    "Prefix": "my",
    "Marker": "mybucket",
    "MaxKeys": 10,
    "IsTruncated": true,
    "NextMarker": "mybucket10",
    "Buckets": [
        {
          "CreationDate": "2014-02-07T18:12:43.000Z",
          "ExtranetEndpoint": "cn-shanghai.oss-vectors.aliyuncs.com",
          "IntranetEndpoint": "cn-shanghai-internal.oss-vectors.aliyuncs.com",
          "Location": "oss-cn-shanghai",
          "Name": "acs:ossvector:cn-shanghai:103735**********:test-bucket-3",
          "Region": "cn-shanghai"
        },
        {
          "CreationDate": "2014-02-05T11:21:04.000Z",
          "ExtranetEndpoint": "cn-shanghai.oss-vectors.aliyuncs.com",
          "IntranetEndpoint": "cn-shanghai-internal.oss-vectors.aliyuncs.com",
          "Location": "oss-cn-hangzhou",
          "Name": "acs:ossvector:cn-shanghai:103735**********:test-bucket-4",
          "Region": "cn-hangzhou"
        }
    ]
  }
}

SDK

Vous pouvez appeler l'opération ListVectorBuckets à l'aide des SDK suivants :

Outil de ligne de commande ossutil

Pour obtenir des informations sur la commande ossutil correspondant à l'opération ListVectorBuckets, consultez la section list-vector-buckets.

Codes d'erreur

Code d'erreur

Code d'état HTTP

Description

AccessDenied

403

La requête est rejetée car elle manque d'informations d'authentification.