Chame a operação OpenMetaQuery para ativar o gerenciamento de metadados de um bucket e selecione um modo de recuperação. O OSS cria uma biblioteca de índices de metadados, constrói índices para todos os objetos no bucket e executa varreduras incrementais quase em tempo real para novos objetos.
Observações
Por padrão, uma conta Alibaba Cloud tem permissão para ativar o gerenciamento de metadados. Para usar um usuário RAM, conceda a permissão
oss:OpenMetaQuery. Conceder permissões personalizadas a um usuário RAM.
Sintaxe da solicitação
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>Cabeçalhos da solicitação
Esta operação utiliza apenas Cabeçalhos comuns de solicitação.
Elementos da solicitação
|
Nome |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
mode |
String |
Sim |
basic |
Modo de recuperação. Valores válidos:
|
|
role |
String |
Não |
my-oss-role |
Nome da função RAM para acessar o OSS. Conceda permissões à função no console para garantir acesso seguro. |
Cabeçalhos da resposta
A resposta contém apenas cabeçalhos comuns de resposta. Para mais informações, consulte Cabeçalhos comuns de resposta.
Exemplos
Exemplo de solicitação
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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eExemplo de resposta
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
SDKs suportados:
ossutil
O comando correspondente do ossutil é open-meta-query.