Appelez l'opération OpenMetaQuery pour activer la gestion des métadonnées d'un compartiment et sélectionner un mode de recherche. OSS crée une bibliothèque d'index de métadonnées, génère des index pour tous les objets du compartiment et effectue des analyses incrémentielles en quasi temps réel pour les nouveaux objets.
Notes
Par défaut, un compte Alibaba Cloud dispose des autorisations nécessaires pour activer la gestion des métadonnées. Pour utiliser un utilisateur RAM, accordez l'autorisation
oss:OpenMetaQuery. Accorder des autorisations personnalisées à un utilisateur RAM.
Syntaxe de la requête
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>En-têtes de requête
Cette opération utilise uniquement les En-têtes de requête communs.
Éléments de requête
|
Nom |
Type |
Obligatoire |
Exemple |
Description |
|
mode |
String |
Oui |
basic |
Le mode de recherche. Valeurs possibles :
|
|
role |
String |
Non |
my-oss-role |
Nom du rôle RAM pour accéder à OSS. Accordez des autorisations au rôle dans la console afin de garantir un accès sécurisé. |
En-têtes de réponse
La réponse contient uniquement des en-têtes de réponse communs. Pour plus d'informations, consultez les En-têtes de réponse communs.
Exemples
Exemple de requête
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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eExemple de réponse
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 pris en charge :
ossutil
La commande ossutil correspondante est open-meta-query.