ListVectorBuckets - Object Storage Service - Centro de documentación de Alibaba Cloud

Enumera todos los vector buckets de su cuenta. Especifique prefix, marker y max-keys para filtrar los resultados.

Permisos

De forma predeterminada, una cuenta de Alibaba Cloud tiene permisos completos sobre sus recursos. Los usuarios de RAM y los roles de RAM no tienen permisos por defecto. Para permitir que un usuario o rol de RAM ejecute esta operación, una cuenta de Alibaba Cloud o un administrador de RAM debe otorgar los permisos obligatorios al usuario o rol correspondiente mediante una RAM policy o una bucket policy.

API	Acción	Descripción
ListVectorBuckets	`oss:ListVectorBuckets`	Enumera los vector buckets.

Sintaxis de la solicitud

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

Encabezados de la solicitud

Esta operación utiliza únicamente encabezados de solicitud comunes. Para obtener más información, consulte Common HTTP Headers.

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
prefix	String	No	my	Prefijo con el que deben comenzar los nombres de los vector buckets devueltos.
marker	String	No	mybucket	Posición inicial del conjunto de resultados. Los resultados se devuelven en orden alfabético, a partir de la entrada inmediatamente posterior al marker especificado.
max-keys	Number	No	100	Número máximo de vector buckets por devolver. Valores válidos: de 1 a 1000. Valor predeterminado: 100.

Encabezados de la respuesta

Esta operación utiliza únicamente encabezados de respuesta comunes. Para obtener más información, consulte Common HTTP Headers.

Elementos de la respuesta

Nota

Si al ejecutar la operación ListVectorBuckets se devuelven todos los buckets, la respuesta no incluye los elementos Prefix, Marker, MaxKeys, IsTruncated ni NextMarker.

Parámetro	Tipo	Ejemplo	Descripción
ListAllMyBucketsResult	Contenedor	N/A	Contenedor de la respuesta de ListVectorBuckets.
Prefix	String	my	Prefijo especificado en la solicitud. Nodo padre: ListAllMyBucketsResult
Marker	String	mybucket	Posición inicial de la consulta ListVectorBuckets. Nodo padre: ListAllMyBucketsResult
MaxKeys	Number	10	Número máximo de vector buckets por devolver en la respuesta. Nodo padre: ListAllMyBucketsResult
IsTruncated	Boolean	true	Indica si se devolvieron todos los vector buckets. Valores válidos: true: No se devolvieron todos los vector buckets. false: Se devolvieron todos los vector buckets. Nodo padre: ListAllMyBucketsResult
NextMarker	String	mybucket10	Si IsTruncated es true, este elemento indica el marker de la siguiente página. Utilice este valor como parámetro `marker` en una solicitud posterior de ListVectorBuckets para recuperar la siguiente página. Nodo padre: ListAllMyBucketsResult
Buckets	Contenedor	N/A	Contenedor de los detalles de los vector buckets. Nodo padre: ListAllMyBucketsResult
Name	String	acs:ossvector:cn-shanghai:103735:test-bucket-3	Identificador del vector bucket, devuelto como ARN del bucket. Nodo padre: Buckets
CreationDate	String	2014-02-07T18:12:43.000Z	Hora de creación del vector bucket. Nodo padre: Buckets
ExtranetEndpoint	String	cn-shanghai.oss-vectors.aliyuncs.com	Endpoint público del vector bucket. Nodo padre: Buckets
IntranetEndpoint	String	cn-shanghai-internal.oss-vectors.aliyuncs.com	Endpoint interno del vector bucket. Nodo padre: Buckets
Location	String	oss-cn-shanghai	ID de región específico de OSS. Nodo padre: Buckets
Region	String	cn-shanghai	ID de región de propósito general de Alibaba Cloud. Nodo padre: Buckets

Ejemplos

Solicitud de ejemplo

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

Respuesta de ejemplo

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

Ejecute la operación ListVectorBuckets mediante los siguientes SDK:

Herramienta de línea de comandos ossutil

Para obtener información sobre el comando de ossutil correspondiente a la operación ListVectorBuckets, consulte list-vector-buckets.

Códigos de error

Código de error	Código de estado HTTP	Descripción
AccessDenied	403	La solicitud se rechazó porque carece de información de autenticación.