Invoque la operación OpenMetaQuery para habilitar la gestión de metadatos de un bucket y seleccione un modo de recuperación. OSS crea una biblioteca de índices de metadatos, genera índices para todos los objetos del bucket y realiza escaneos incrementales casi en tiempo real para los nuevos objetos.
Notas
De forma predeterminada, una cuenta de Alibaba Cloud tiene permiso para habilitar la gestión de metadatos. Para utilizar un usuario RAM, otorgue el permiso
oss:OpenMetaQuery. Grant custom permissions to a RAM user.
Sintaxis de la solicitud
POST /?metaQuery&comp=add&mode=basic HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValuePOST /?metaQuery&comp=add&mode=basic HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 13:08:38 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<MetaQuery>
<WorkflowParameters>
<WorkflowParameter>
<Name>VideoInsightEnable</Name>
<Value>True</Value> // Specifies whether to enable video content awareness.
</WorkflowParameter>
<WorkflowParameter>
<Name>ImageInsightEnable</Name>
<Value>True</Value> // Specifies whether to enable image content awareness.
</WorkflowParameter>
</WorkflowParameters>
<Filters>
<Filter>Size > 1024, FileModifiedTime > 2025-06-03T09:20:47.999Z</Filter> // Configures file filter conditions.
<Filter>Filename prefix (YWEvYmIv)</Filter>
</Filters>
</MetaQuery>Encabezados de la solicitud
Esta operación utiliza únicamente Common request headers.
Elementos de la solicitud
|
Nombre |
Tipo |
Obligatorio |
Ejemplo |
Descripción |
|
mode |
String |
Sí |
basic |
El modo de recuperación. Valores válidos:
|
|
role |
String |
No |
my-oss-role |
El nombre del rol de RAM para acceder a OSS. Puede otorgar permisos al rol en la consola para garantizar un acceso seguro. |
Encabezados de la respuesta
La respuesta contiene únicamente encabezados de respuesta comunes. Para obtener más información, consulte Common response headers.
Ejemplos
Ejemplo de solicitud
POST /?metaQuery&comp=add&mode=basic HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 13:08:38 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eEjemplo de respuesta
HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422299D
x-oss-server-time: 544SDK
SDK compatibles:
ossutil
El comando correspondiente de ossutil es open-meta-query.