call the DoMetaQuery operation to query objects that meet specified conditions and list object information by a specified field and sorting order -

Précautions

Pour interroger les objets qui répondent à des conditions spécifiées, vous devez disposer de l'autorisation oss:DoMetaQuery. Accorder des autorisations personnalisées à un utilisateur RAM.

Syntaxe de la requête

Scalar retrieval

POST /?metaQuery&comp=query&mode=basic HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
  <NextToken></NextToken>
  <MaxResults>5</MaxResults>
  <Query>{"Field": "Size","Value": "1048576","Operation": "gt"}</Query>
  <Sort>Size</Sort>
  <Order>asc</Order>
  <Aggregations>
    <Aggregation>
      <Field>Size</Field>
      <Operation>sum</Operation>
    </Aggregation>
    <Aggregation>
      <Field>Size</Field>
      <Operation>max</Operation>
    </Aggregation>
  </Aggregations>
</MetaQuery>

Vector retrieval

POST /?metaQuery&comp=query&mode=semantic HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
  <MaxResults>99</MaxResults>
  <Query>An aerial view of a snow-covered forest</Query>
  <MediaTypes>
    <MediaType>image</MediaType>
  </MediaTypes>  
  <SimpleQuery>{"Operation":"gt", "Field": "Size", "Value": "30"}</SimpleQuery>
</MetaQuery>

En-têtes de requête

DescribeRegions utilise uniquement des en-têtes de requête courants. Pour plus d'informations, consultez la rubrique En-têtes de requête courants.

Éléments de requête

Scalar retrieval

Nom	Type	Obligatoire	Valeur d'exemple	Description
mode	String	Oui	basic	Définit le mode de récupération sur scalar retrieval.
MetaQuery	Container	Oui	N/A	Conteneur pour les conditions de requête. Nœuds enfants : NextToken, MaxResults, Query, Sort, Order et Aggregations
NextToken	String	Non	MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****	Jeton de pagination. Obligatoire lorsque le nombre total d'objets dépasse MaxResults. Les informations sur les objets sont renvoyées dans l'ordre lexicographique à partir de l'objet spécifié par NextToken. Laissez ce champ vide pour la première requête. Nœud parent : MetaQuery
MaxResults	Integer	Non	5	Nombre maximal d'objets à renvoyer. Valeurs valides : 0 à 100. Valeur par défaut : 100. S'applique si le paramètre n'est pas défini ou s'il est défini sur 0. Nœud parent : MetaQuery
Query	String	Oui	{"Field": "Size","Value": "1048576","Operation": "gt"}	Condition de requête. Options : Operation : opérateur. Valeurs valides : eq (égal à), gt (supérieur à), gte (supérieur ou égal à), lt (inférieur à), lte (inférieur ou égal à), match (requête floue), prefix (requête par préfixe), and (ET logique), or (OU logique) et not (NON logique). Field : nom du champ. Les champs et opérateurs pris en charge sont répertoriés dans l'Annexe : Champs et opérateurs pour scalar retrieval. Value : valeur du champ. SubQueries : conditions de sous-requête. Les options sont identiques à celles des conditions de requête simple. Obligatoire uniquement lorsque Operation est un opérateur logique (and, or ou not). Pour des exemples de requêtes, consultez la rubrique DoMetaQuery. Nœud parent : MetaQuery
Sort	String	Non	Size	Trie les résultats selon un champ spécifié. Les champs pouvant être triés sont répertoriés dans l'Annexe : Champs et opérateurs pour scalar retrieval. Nœud parent : MetaQuery
Order	String	Non	asc	Ordre de tri. Valeurs valides : asc : croissant desc (par défaut) : décroissant Nœud parent : MetaQuery
Aggregations	Container	Non	N/A	Conteneur pour les opérations d'agrégation. Nœud enfant : Aggregation Nœud parent : MetaQuery
Aggregation	Container	Non	N/A	Conteneur pour une opération d'agrégation unique. Nœuds enfants : Field et Operation Nœud parent : Aggregations
Field	String	Non	Size	Nom du champ. Les champs et opérateurs pris en charge sont répertoriés dans l'Annexe : Champs et opérateurs pour scalar retrieval. Nœud parent : Aggregation
Operation	String	Non	sum	Opérateur dans l'opération d'agrégation. Valeurs valides : min : valeur minimale max : valeur maximale average : valeur moyenne sum : somme Count distinct : nombre dédupliqué group : nombre de groupes Nœud parent : Aggregation

Vector retrieval

Nom	Type	Obligatoire	Exemple	Description
mode	String	Oui	semantic	Définit le mode de récupération sur vector retrieval.
MetaQuery	Container	Oui	N/A	Conteneur pour les conditions de requête. Nœuds enfants : MaxResults, Query, MediaTypes et SimpleQuery
MaxResults	Integer	Non	5	Nombre maximal d'objets à renvoyer. Valeurs valides : 0 à 100. Valeur par défaut : 100. S'applique si le paramètre n'est pas défini ou s'il est défini sur 0. Nœud parent : MetaQuery
Query	String	Oui	An aerial view of a snow-covered forest	Contenu à récupérer. Nœud parent : MetaQuery
MediaTypes	Container	Oui	N/A	Conditions de récupération des métadonnées multimédias. Nœud parent : MetaQuery
MediaType	String	Oui	image	Type de contenu multimédia à récupérer. Valeurs valides : Image : video audio document Nœud parent : MediaTypes
SimpleQuery	String	Non	{"Operation":"gt", "Field": "Size", "Value": "30"}	Condition de requête. Options : Operation : opérateur. Valeurs valides : eq (égal à), gt (supérieur à), gte (supérieur ou égal à), lt (inférieur à), lte (inférieur ou égal à), match (requête floue), prefix (requête par préfixe), and (ET logique), or (OU logique) et not (NON logique). Field : nom du champ. Les champs et opérateurs pris en charge sont répertoriés dans l'Annexe : Champs et opérateurs pour vector retrieval. Value : valeur du champ. SubQueries : conditions de sous-requête. Les options sont identiques à celles des conditions de requête simple. Obligatoire uniquement lorsque Operation est un opérateur logique (and, or ou not). Nœud parent : MetaQuery

En-têtes de réponse

La réponse contient uniquement des en-têtes de réponse courants. Pour plus d'informations, consultez la rubrique En-têtes de réponse courants.

Éléments de réponse

Récupération scalaire

Nom	Type	Exemple	Description
MetaQuery	Container	N/A	Conteneur pour les résultats de la requête. Nœuds enfants : NextToken, Files et Aggregations
NextToken	String	MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****	Jeton de pagination. Requis lorsque le nombre total d'objets dépasse MaxResults. Transmettez cette valeur en tant que NextToken dans la requête suivante pour récupérer les résultats restants. Renvoyé uniquement si tous les objets ne sont pas inclus dans la réponse. Nœud parent : MetaQuery
Files	Container	N/A	Conteneur pour les informations sur l'objet. Nœud enfant : File Nœud parent : MetaQuery
File	Container	N/A	Conteneur pour un seul objet. Nœuds enfants : Filename, Size, FileModifiedTime, OSSObjectType, OSSStorageClass, ObjectACL, ETag, OSSTaggingCount, OSSTagging et OSSCRC64 Nœud parent : Files
Filename	String	exampleobject.txt	Chemin complet de l'objet. Nœud parent : File
Size	Integer	120	Taille de l'objet en octets. Nœud parent : File
FileModifiedTime	String	2025-05-19T16:14:38+08:00	Dernière date de modification de l'objet. Le format est RFC3339Nano. Nœud parent : File
OSSObjectType	String	Normal	Type de l'objet. Valeurs possibles : Normal : L'objet est téléchargé via l'appel de l'opération PutObject ou créé via l'appel de l'opération CreateDirectory. Appendable : L'objet est téléchargé via l'appel de l'opération AppendObject. Multipart : L'objet est téléchargé via l'appel de l'opération MultipartUpload. Symlink : Le lien symbolique est créé via l'appel de l'opération PutSymlink. Nœud parent : File
OSSStorageClass	String	Standard	Classe de stockage de l'objet. Valeurs possibles : Standard : Stockage hautement fiable, hautement disponible et performant pour les données fréquemment consultées. IA : Adapté au stockage à long terme avec un accès peu fréquent (une ou deux fois par mois en moyenne). Archive : Adapté à l'archivage à long terme de données rarement consultées (recommandé pour six mois ou plus). Nécessite environ 1 minute pour la restauration avant lecture. ColdArchive : Adapté au stockage à long terme de données rarement consultées. Nœud parent : File
ObjectACL	String	default	ACL de l'objet. Valeurs possibles : default : Hérite de l'ACL du bucket. private : Seul le propriétaire de l'objet et les utilisateurs autorisés peuvent lire et écrire. Les autres utilisateurs ne peuvent pas accéder à l'objet. public-read : Le propriétaire et les utilisateurs autorisés peuvent lire et écrire. Les autres utilisateurs peuvent uniquement lire. À utiliser avec précaution. public-read-write : Tous les utilisateurs peuvent lire et écrire. À utiliser avec précaution. Nœud parent : File
ETag	String	"fba9dede5f27731c9771645a3986****"	Un ETag est généré lors de la création d'un objet. Il identifie le contenu de l'objet. Pour un objet créé par une requête PutObject, la valeur ETag correspond au hachage MD5 de son contenu. Pour les objets créés par d'autres méthodes, l'ETag est une valeur unique mais ne correspond pas au hachage MD5 du contenu. Remarque Vous pouvez utiliser l'ETag pour vérifier si le contenu de l'objet a changé, mais ne l'utilisez pas comme hachage MD5 pour la vérification de l'intégrité des données. Nœud parent : File
OSSTaggingCount	Integer	2	Nombre de tags de l'objet. Nœud parent : File
OSSTagging	Container	N/A	Conteneur pour les informations de tag. Nœud enfant : Tagging Nœud parent : File
Tagging	Container	N/A	Conteneur pour un seul tag. Nœuds enfants : Key et Value Nœud parent : OSSTagging
Key	String	owner	Clé du tag ou des métadonnées définies par l'utilisateur. La clé des métadonnées définies par l'utilisateur doit être préfixée par `x-oss-meta-`. Nœuds parents : Tagging et UserMeta
Value	String	John	Valeur du tag ou des métadonnées définies par l'utilisateur. Nœuds parents : Tagging et UserMeta
OSSCRC64	String	4858A48BD1466884	Valeur CRC 64 bits de l'objet. La valeur CRC 64 bits est calculée selon la norme CRC-64/XZ. Nœud parent : File
Aggregations	Container	N/A	Conteneur pour les opérations d'agrégation. Nœuds enfants : Field, Operation, Operation, Value et Groups Nœud parent : MetaQuery
Field	String	Size	Nom du champ. Nœud parent : Aggregations
Operation	String	sum	Opérateur d'agrégation. Nœud parent : Aggregations
Value	Floating-point number	200	Valeur résultant de l'opération d'agrégation. Nœud parent : Aggregations
Groups	Container	N/A	Liste des résultats de regroupement et d'agrégation. Nœuds enfants : Value et Count Nœud parent : Aggregations
Value	String	100	Valeur du regroupement et de l'agrégation. Nœud parent : Groups
Count	Integer	5	Nombre de résultats de regroupement et d'agrégation. Nœud parent : Groups

Récupération de vecteurs

Nom	Type	Exemple	Description
MetaQuery	Container	N/A	Conteneur des résultats de la requête. Nœud enfant : Files
Files	Container	N/A	Liste des informations relatives aux objets. Nœud enfant : File Nœud parent : MetaQuery
File	Container	N/A	Informations concernant un objet unique. Nœud parent : Files
URI	String	oss://examplebucket/test-object.jpg	Chemin d'accès complet de l'objet. Nœud parent : File
Filename	String	exampleobject.txt	Nom de l'objet. Nœud parent : File
Size	Integer	120	Taille de l'objet en octets. Nœud parent : File
ObjectACL	String	default	Liste de contrôle d'accès (ACL) de l'objet. Valeurs valides : default : Hérite de l'ACL du bucket. private : Seul le propriétaire de l'objet et les utilisateurs autorisés peuvent lire et écrire. Les autres utilisateurs ne peuvent pas accéder à l'objet. public-read : Le propriétaire et les utilisateurs autorisés peuvent lire et écrire. Les autres utilisateurs peuvent uniquement lire. Utilisez cette option avec précaution. public-read-write : Tous les utilisateurs peuvent lire et écrire. Utilisez cette option avec précaution. Nœud parent : File
FileModifiedTime	String	2025-05-19T16:15:33+08:00	Dernière heure de modification de l'objet. Le format est RFC3339Nano. Nœud parent : File
ETag	String	"fba9dede5f27731c9771645a3986****"	Une valeur ETag est générée lors de la création d'un objet. Elle identifie le contenu de l'objet. Pour un objet créé par une requête PutObject, la valeur ETag correspond au hachage MD5 de son contenu. Pour les objets créés par d'autres méthodes, la valeur ETag est unique mais ne correspond pas au hachage MD5 du contenu. Remarque Vous pouvez utiliser la valeur ETag pour vérifier si le contenu de l'objet a changé, mais ne l'utilisez pas comme hachage MD5 pour la vérification de l'intégrité des données. Nœud parent : File
OSSCRC64	String	4858A48BD1466884	Valeur CRC 64 bits de l'objet. La valeur CRC 64 bits est calculée selon la norme CRC-64/XZ. Nœud parent : File
ProduceTime	String	2021-06-29T14:50:13.011643661+08:00	Heure à laquelle la photo ou la vidéo a été capturée par l'appareil. Nœud parent : File
ContentType	String	image/jpeg	Type MIME (Multipurpose Internet Mail Extensions). Nœud parent : File
MediaType	String	image	Type de média. Nœud parent : File
LatLong	String	30.134390,120.074997	Informations de latitude et de longitude. Nœud parent : File
Title	String	test	Titre du fichier. Nœud parent : File
OSSExpiration	String	2124-12-01T12:00:00.000Z	Heure d'expiration du fichier. Nœud parent : File
AccessControlAllowOrigin	String	https://aliyundoc.com	Origine autorisée à envoyer des requêtes cross-origin. Nœud parent : File
AccessControlRequestMethod	String	PUT	Méthode utilisée dans la requête cross-origin. Nœud parent : File
CacheControl	String	no-cache	Comportement de mise en cache de la page web lors du téléchargement de l'objet. Nœud parent : File
ContentDisposition	String	attachment; filename =test.jpg	Nom de l'objet lors du téléchargement. Nœud parent : File
ContentEncoding	String	UTF-8	Format d'encodage du contenu lors du téléchargement de l'objet. Nœud parent : File
ContentLanguage	String	zh-CN	Langue utilisée dans le contenu de l'objet. Nœud parent : File
ImageHeight	Integer	500	Hauteur de l'image en pixels (px). Nœud parent : File
ImageWidth	Integer	270	Largeur de l'image en pixels (px). Nœud parent : File
VideoWidth	Integer	1080	Largeur de la trame vidéo en pixels (px). Nœud parent : File
VideoHeight	Integer	1920	Hauteur de la trame vidéo en pixels (px). Nœud parent : File
VideoStreams	Container	N/A	Liste des flux vidéo. Nœud parent : File
VideoStream	Container	N/A	Flux vidéo. Nœud parent : VideoStreams
CodecName	String	h264	Nom du codec. Nœud parent : VideoStream
Language	String	en	Langue utilisée dans le flux vidéo. Le format est BCP 47. Nœud parent : VideoStream
Bitrate	Integer	5407765	Débit binaire en bit/s. Nœud parent : VideoStream
FrameRate	String	25/1	Fréquence d'images du flux vidéo. Nœud parent : VideoStream
StartTime	Double-precision floating-point number	0.000000	Heure de début du flux vidéo en secondes (s). Nœud parent : VideoStream
Duration	Double-precision floating-point number	22.88	Durée du flux vidéo en secondes (s). Nœud parent : VideoStream
FrameCount	Integer	572	Nombre de trames vidéo. Nœud parent : VideoStream
BitDepth	Integer	8	Profondeur de bits des pixels. Nœud parent : VideoStream
PixelFormat	String	yuv420p	Format de pixel du flux vidéo. Nœud parent : VideoStream

ColorSpace	String	bt709	L'espace colorimétrique. Nœud parent : VideoStream
Height	Integer	720	La hauteur de la trame du flux vidéo, en pixels (px). Nœud parent : VideoStream
Width	Integer	1280	La largeur de la trame du flux vidéo, en pixels (px). Nœud parent : VideoStream
AudioStreams	Container	N/A	La liste des flux audio. Nœud parent : File
AudioStream	Container	N/A	Le flux audio. Nœud parent : AudioStreams
CodecName	String	aac	Le nom de l'encodeur. Nœud parent : AudioStream
Bitrate	Integer	320087	Le débit binaire, en bits par seconde (bit/s). Nœud parent : AudioStream
SampleRate	Integer	48000	La fréquence d'échantillonnage, en hertz (Hz). Nœud parent : AudioStream
StartTime	Double-precision floating-point number	0.0235	L'heure de début du flux audio, en secondes (s). Nœud parent : AudioStream
Duration	Double-precision floating-point number	3.690667	La durée du flux audio, en secondes (s). Nœud parent : AudioStream
Channels	Integer	2	Le nombre de canaux audio. Nœud parent : AudioStream
Language	String	en	La langue utilisée dans le flux audio. Le format est BCP 47. Nœud parent : AudioStream
Subtitles	Container	N/A	La liste des flux de sous-titres. Nœud parent : File
Subtitle	Container	N/A	Le flux de sous-titres. Nœud parent : Subtitles
CodecName	String	mov_text	Le nom de l'encodeur. Nœud parent : Subtitle
Language	String	en	La langue du sous-titre. Le format est BCP 47. Nœud parent : Subtitle
StartTime	Double-precision floating-point number	0.000000	L'heure de début du flux de sous-titres, en secondes (s). Nœud parent : Subtitle
Duration	Double-precision floating-point number	71.378	La durée du flux de sous-titres, en secondes (s). Nœud parent : Subtitle
Bitrate	Integer	13091201	Le débit binaire, en bits par seconde (bit/s). Nœud parent : File
Artist	String	Jane	L'artiste. Nœud parent : File
AlbumArtist	String	Jenny	Artiste. Nœud parent : File
Composer	String	Jane	Le compositeur. Nœud parent : File
Performer	String	Jane	L'interprète. Nœud parent : File
Album	String	FirstAlbum	L'album. Nœud parent : File
Duration	Double-precision floating-point number	15.263000	La durée totale de la vidéo, en secondes. Nœud parent : File
Addresses	Container	N/A	Les informations d'adresse. Nœud parent : File
Address	Container	N/A	Les informations d'adresse. Nœud parent : Addresses
AddressLine	String	No. 969, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China	L'adresse complète. Nœud parent : Address
City	String	Hangzhou	La ville. Nœud parent : Address
District	String	Yuhang District	Le district. Nœud parent : Address
Language	String	zh-Hans	La langue. Le format est BCP 47. Nœud parent : Address
Province	String	Zhejiang	La province. Nœud parent : Address
Township	String	Wenyi West Road	La rue. Nœud parent : Address
OSSObjectType	String	Normal	Le type d'objet. Nœud parent : File
OSSStorageClass	String	Standard	La classe de stockage de l'objet. Nœud parent : File
OSSTaggingCount	Integer	2	Le nombre de tags de l'objet. Nœud parent : File
OSSTagging	Container	N/A	La liste des informations de tag. Nœud enfant : Tagging Nœud parent : File
Tagging	Container	N/A	Le conteneur pour un seul tag. Nœuds enfants : Key et Value Nœud parent : OSSTagging
Key	String	owner	La clé du tag. Nœud parent : Tagging
Value	String	John	La valeur du tag. Nœud parent : Tagging
Key	String	owner	La clé des métadonnées définies par l'utilisateur. Nœud parent : Tagging
Value	String	John	La valeur des métadonnées définies par l'utilisateur. Nœud parent : Tagging

Exemples

Exemples de requête

Récupération scalaire

POST /?metaQuery&comp=query&mode=basic HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
  <NextToken></NextToken>
  <MaxResults>5</MaxResults>
  <Query>{"Field": "Size","Value": "1048576","Operation": "gt"}</Query>
  <Sort>Size</Sort>
  <Order>asc</Order>
  <Aggregations>
    <Aggregation>
      <Field>Size</Field>
      <Operation>sum</Operation>
    </Aggregation>
    <Aggregation>
      <Field>Size</Field>
      <Operation>max</Operation>
    </Aggregation>
  </Aggregations>
</MetaQuery>

Récupération vectorielle

POST /?metaQuery&comp=query&mode=semantic HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 12 Sep 2024 13:08:38 GMT
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
  <MaxResults>99</MaxResults>
  <Query>An aerial view of a snow-covered forest</Query> // Required
  <MediaTypes>
    <MediaType>image</MediaType>
  </MediaTypes>
  // SimpleQuery is equivalent to the Query field in simple mode.
  <SimpleQuery>{"Operation":"gt", "Field": "Size", "Value": "30"}</SimpleQuery>
</MetaQuery>

Exemples de réponse

Récupération scalaire

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 118
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
  <NextToken>MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****</NextToken>
  <Files>
    <File>
      <Filename>exampleobject.txt</Filename>
      <Size>120</Size>
      <FileModifiedTime>2025-05-19T16:14:38+08:00</FileModifiedTime>
      <OSSObjectType>Normal</OSSObjectType>
      <OSSStorageClass>Standard</OSSStorageClass>
      <ObjectACL>default</ObjectACL>
      <ETag>"fba9dede5f27731c9771645a3986****"</ETag>
      <OSSCRC64>4858A48BD1466884</OSSCRC64>
      <OSSTaggingCount>2</OSSTaggingCount>
      <OSSTagging>
        <Tagging>
          <Key>owner</Key>
          <Value>John</Value>
        </Tagging>
        <Tagging>
          <Key>type</Key>
          <Value>document</Value>
        </Tagging>
      </OSSTagging>
    </File>
  </Files>
</MetaQuery>

Récupération vectorielle

Exemple de réponse pour une requête de recherche d'image

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Thu, 12 Sep 2024 13:08:38 GMT
Content-Length: 118
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<MetaQuery>
  <Files>
    <File>
      <URI>oss://examplebucket/test-object.jpg</URI>
      <Filename>sampleobject.jpg</Filename>
      <Size>1000</Size>
      <ObjectACL>default</ObjectACL>
      <FileModifiedTime>2025-05-19T16:14:38+08:00</FileModifiedTime>
      <ETag>\"1D9C280A7C4F67F7EF873E28449****\"</ETag>
      <OSSCRC64>559890638950338001</OSSCRC64>
      <ProduceTime>2021-06-29T14:50:15.011643661+08:00</ProduceTime>
      <ContentType>image/jpeg</ContentType>
      <MediaType>image</MediaType>
      <LatLong>30.134390,120.074997</LatLong>
      <Title>test</Title>
      <OSSExpiration>2024-12-01T12:00:00.000Z</OSSExpiration>
      <AccessControlAllowOrigin>https://aliyundoc.com</AccessControlAllowOrigin>
      <AccessControlRequestMethod>PUT</AccessControlRequestMethod>
      <CacheControl>no-cache</CacheControl>
      <ContentDisposition>attachment; filename =test.jpg</ContentDisposition>
      <ContentEncoding>UTF-8</ContentEncoding>
      <ContentLanguage>zh-CN</ContentLanguage>
      <ImageHeight>500</ImageHeight>
      <ImageWidth>270</ImageWidth>
      <Addresses>
        <Address>
          <AddressLine>No. 969, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China</AddressLine>
          <City>Hangzhou</City>
          <Country>China</Country>
          <District>Yuhang District</District>
          <Language>zh-Hans</Language>
          <Province>Zhejiang</Province>
          <Township>Wenyi West Road</Township>
        </Address>
        <Address>
          <AddressLine>No. 970, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China</AddressLine>
          <City>Hangzhou</City>
          <Country>China</Country>
          <District>Yuhang District</District>
          <Language>zh-Hans</Language>
          <Province>Zhejiang</Province>
          <Township>Wenyi West Road</Township>
        </Address>
      </Addresses>
      <OSSObjectType>Normal</OSSObjectType>
      <OSSStorageClass>Standard</OSSStorageClass>
      <OSSTaggingCount>2</OSSTaggingCount>
      <OSSTagging>
        <Tagging>
          <Key>key</Key>
          <Value>val</Value>
        </Tagging>
        <Tagging>
          <Key>key</Key>
          <Value>val</Value>
        </Tagging>
      </OSSTagging>
    </File>
  </Files>
</MetaQuery>

Exemple de réponse pour une requête de recherche audio ou vidéo

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Thu, 12 Sep 2024 13:08:38 GMT
Content-Length: 118
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<MetaQuery>
  <Files>
    <File>
      <URI>oss://examplebucket/test-object.jpg</URI>
      <Filename>sampleobject.jpg</Filename>
      <Size>1000</Size>
      <ObjectACL>default</ObjectACL>
      <FileModifiedTime>2021-06-29T14:50:14.011643661+08:00</FileModifiedTime>
      <ETag>\"1D9C280A7C4F67F7EF873E28449****\"</ETag>
      <OSSCRC64>559890638950338001</OSSCRC64>
      <ProduceTime>2021-06-29T14:50:15.011643661+08:00</ProduceTime>
      <ContentType>image/jpeg</ContentType>
      <MediaType>image</MediaType>
      <LatLong>30.134390,120.074997</LatLong>
      <Title>test</Title>
      <OSSExpiration>2024-12-01T12:00:00.000Z</OSSExpiration>
      <AccessControlAllowOrigin>https://aliyundoc.com</AccessControlAllowOrigin>
      <AccessControlRequestMethod>PUT</AccessControlRequestMethod>
      <CacheControl>no-cache</CacheControl>
      <ContentDisposition>attachment; filename =test.jpg</ContentDisposition>
      <ContentEncoding>UTF-8</ContentEncoding>
      <ContentLanguage>zh-CN</ContentLanguage>
      <VideoWidth>1080</VideoWidth>
      <VideoHeight>1920</VideoHeight>
      <VideoStreams>
        <VideoStream>
          <CodecName>h264</CodecName>
          <Language>en</Language>
          <Bitrate>5407765</Bitrate>
          <FrameRate>25/1</FrameRate>
          <StartTime>0</StartTime>
          <Duration>22.88</Duration>
          <FrameCount>572</FrameCount>
          <BitDepth>8</BitDepth>
          <PixelFormat>yuv420p</PixelFormat>
          <ColorSpace>bt709</ColorSpace>
          <Height>720</Height>
          <Width>1280</Width>
        </VideoStream>
        <VideoStream>
          <CodecName>h264</CodecName>
          <Language>en</Language>
          <Bitrate>5407765</Bitrate>
          <FrameRate>25/1</FrameRate>
          <StartTime>0</StartTime>
          <Duration>22.88</Duration>
          <FrameCount>572</FrameCount>
          <BitDepth>8</BitDepth>
          <PixelFormat>yuv420p</PixelFormat>
          <ColorSpace>bt709</ColorSpace>
          <Height>720</Height>
          <Width>1280</Width>
        </VideoStream>
      </VideoStreams>
      <AudioStreams>
        <AudioStream>
          <CodecName>aac</CodecName>
          <Bitrate>1048576</Bitrate>
          <SampleRate>48000</SampleRate>
          <StartTime>0.0235</StartTime>
          <Duration>3.690667</Duration>
          <Channels>2</Channels>
          <Language>en</Language>
        </AudioStream>
      </AudioStreams>
      <Subtitles>
        <Subtitle>
          <CodecName>mov_text</CodecName>
          <Language>en</Language>
          <StartTime>0</StartTime>
          <Duration>71.378</Duration>
        </Subtitle>
        <Subtitle>
          <CodecName>mov_text</CodecName>
          <Language>en</Language>
          <StartTime>72</StartTime>
          <Duration>71.378</Duration>
        </Subtitle>
      </Subtitles>
      <Bitrate>5407765</Bitrate>
      <Artist>Jane</Artist>
      <AlbumArtist>Jenny</AlbumArtist>
      <Composer>Jane</Composer>
      <Performer>Jane</Performer>
      <Album>FirstAlbum</Album>
      <Duration>71.378</Duration>
      <Addresses>
        <Address>
          <AddressLine>No. 969, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China</AddressLine>
          <City>Hangzhou</City>
          <Country>China</Country>
          <District>Yuhang District</District>
          <Language>zh-Hans</Language>
          <Province>Zhejiang</Province>
          <Township>Wenyi West Road</Township>
        </Address>
        <Address>
          <AddressLine>No. 970, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China</AddressLine>
          <City>Hangzhou</City>
          <Country>China</Country>
          <District>Yuhang District</District>
          <Language>zh-Hans</Language>
          <Province>Zhejiang</Province>
          <Township>Wenyi West Road</Township>
        </Address>
      </Addresses>
      <OSSObjectType>Normal</OSSObjectType>
      <OSSStorageClass>Standard</OSSStorageClass>
      <OSSTaggingCount>2</OSSTaggingCount>
      <OSSTagging>
        <Tagging>
          <Key>key</Key>
          <Value>val</Value>
        </Tagging>
        <Tagging>
          <Key>key</Key>
          <Value>val</Value>
        </Tagging>
      </OSSTagging>
    </File>
  </Files>
</MetaQuery>

Exemples de requête

Imbriquez des éléments Query pour construire des conditions de recherche complexes et récupérer précisément le contenu souhaité.

Pour rechercher un objet nommé exampleobject.txt dont la taille est inférieure à 1 000 octets, configurez l'élément Query comme suit :


{
  "SubQueries":[
    {
      "Field":"Filename",
      "Value": "exampleobject.txt",
      "Operation":"eq"
    },         
    {
      "Field":"Size",
      "Value":"1000",
      "Operation":"lt"
    }
  ],
  "Operation":"and"
}

Pour rechercher des objets dont le nom commence par le préfixe exampledir/, qui contiennent le tag type=document ou owner=John, et dont la taille est supérieure à 10 Mo, configurez l'élément Query comme suit :


{
  "SubQueries": [
    {
      "Field": "Filename",
      "Value": "exampledir/",
      "Operation": "prefix"
    },
    {
      "Field": "Size",
      "Value": "1048576",
      "Operation": "gt"
    },
    {
      "SubQueries": [
        {
          "Field": "OSSTagging.type",
          "Value": "document",
          "Operation": "eq"
        },
        {
          "Field": "OSSTagging.owner",
          "Value": "John",
          "Operation": "eq"
        }
      ],
      "Operation": "or"
    }
  ],
  "Operation": "and"
}

Au-delà des conditions de recherche, utilisez des opérations d'agrégation pour effectuer des analyses statistiques — telles que la taille totale, le nombre, la moyenne, le maximum ou le minimum — sur les objets correspondant aux critères, ou analysez la distribution des tailles des images correspondantes.

SDK

SDK disponibles pour cette opération :

Outil de ligne de commande ossutil

L'opération DoMetaQuery correspond à la commande do-meta-query dans ossutil.