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

Precauciones

Para consultar objetos que cumplen con condiciones específicas, debe contar con el permiso oss:DoMetaQuery. Grant custom permissions to a RAM user.

Sintaxis de la solicitud

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>

Encabezados de la solicitud

DescribeRegions utiliza únicamente encabezados de solicitud comunes. Para obtener más información, consulte Common request headers.

Elementos de la solicitud

Scalar retrieval

Nombre	Tipo	Obligatorio	Valor de ejemplo	Descripción
mode	String	Sí	basic	Establece el modo de recuperación como recuperación escalar.
MetaQuery	Container	Sí	N/A	Contenedor de las condiciones de consulta. Nodos secundarios: NextToken, MaxResults, Query, Sort, Order y Aggregations
NextToken	String	No	MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****	Token de paginación. Es obligatorio cuando el número total de objetos supera MaxResults. La información de los objetos se devuelve en orden lexicográfico a partir del objeto especificado por NextToken. Deje este campo vacío en la primera solicitud. Nodo principal: MetaQuery
MaxResults	Integer	No	5	Número máximo de objetos a devolver. Valores válidos: de 0 a 100. Predeterminado: 100. Surte efecto cuando no se establece o se define en 0. Nodo principal: MetaQuery
Query	String	Sí	{"Field": "Size","Value": "1048576","Operation": "gt"}	Condición de consulta. Opciones: Operation: El operador. Valores válidos: eq (igual a), gt (mayor que), gte (mayor o igual que), lt (menor que), lte (menor o igual que), match (consulta difusa), prefix (consulta de prefijo), and (AND lógico), or (OR lógico) y not (NOT lógico). Field: Nombre del campo. Los campos y operadores compatibles se listan en Appendix: Fields and operators for scalar retrieval. Value: Valor del campo. SubQueries: Condiciones de subconsulta. Las opciones son las mismas que para las condiciones de consulta simple. Es obligatorio solo cuando Operation es un operador lógico (and, or o not). Para ver ejemplos de consultas, consulte DoMetaQuery. Nodo principal: MetaQuery
Sort	String	No	Size	Ordena los resultados por un campo específico. Los campos ordenables se listan en Appendix: Fields and operators for scalar retrieval. Nodo principal: MetaQuery
Order	String	No	asc	Orden de clasificación. Valores válidos: asc: ascendente desc (predeterminado): descendente Nodo principal: MetaQuery
Aggregations	Container	No	N/A	Contenedor de las operaciones de agregación. Nodo secundario: Aggregation Nodo principal: MetaQuery
Aggregation	Container	No	N/A	Contenedor de una sola operación de agregación. Nodos secundarios: Field y Operation Nodo principal: Aggregations
Field	String	No	Size	Nombre del campo. Los campos y operadores compatibles se listan en Appendix: Fields and operators for scalar retrieval. Nodo principal: Aggregation
Operation	String	No	sum	Operador en la operación de agregación. Valores válidos: min: valor mínimo max: valor máximo average: valor promedio sum: suma Count distinct: recuento sin duplicados group: recuento por grupo Nodo principal: Aggregation

Vector retrieval

Nombre	Tipo	Obligatorio	Ejemplo	Descripción
mode	String	Sí	semantic	Establece el modo de recuperación como recuperación vectorial.
MetaQuery	Container	Sí	N/A	Contenedor de las condiciones de consulta. Nodos secundarios: MaxResults, Query, MediaTypes y SimpleQuery
MaxResults	Integer	No	5	Número máximo de objetos a devolver. Valores válidos: de 0 a 100. Predeterminado: 100. Surte efecto cuando no se establece o se define en 0. Nodo principal: MetaQuery
Query	String	Sí	An aerial view of a snow-covered forest	Contenido a recuperar. Nodo principal: MetaQuery
MediaTypes	Container	Sí	N/A	Condiciones de recuperación de metadatos multimedia. Nodo principal: MetaQuery
MediaType	String	Sí	image	Tipo de contenido multimedia a recuperar. Valores válidos: Image: video audio document Nodo principal: MediaTypes
SimpleQuery	String	No	{"Operation":"gt", "Field": "Size", "Value": "30"}	Condición de consulta. Opciones: Operation: El operador. Valores válidos: eq (igual a), gt (mayor que), gte (mayor o igual que), lt (menor que), lte (menor o igual que), match (consulta difusa), prefix (consulta de prefijo), and (AND lógico), or (OR lógico) y not (NOT lógico). Field: Nombre del campo. Los campos y operadores compatibles se listan en Appendix: Fields and operators for vector retrieval. Value: Valor del campo. SubQueries: Condiciones de subconsulta. Las opciones son las mismas que para las condiciones de consulta simple. Es obligatorio solo cuando Operation es un operador lógico (and, or o not). Nodo principal: MetaQuery

Encabezados de la respuesta

La respuesta contiene únicamente encabezados de respuesta comunes. Para obtener más información, consulte Common response headers.

Elementos de respuesta

Recuperación escalar

Nombre	Tipo	Ejemplo	Descripción
MetaQuery	Container	N/A	Contenedor de los resultados de la consulta. Nodos secundarios: NextToken, Files y Aggregations
NextToken	String	MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****	Token de paginación. Es obligatorio cuando el número total de objetos supera MaxResults. Pase este valor como NextToken en la siguiente solicitud para recuperar los resultados restantes. Se devuelve solo cuando no todos los objetos se incluyen en la respuesta. Nodo principal: MetaQuery
Files	Container	N/A	Contenedor de la información del objeto. Nodo secundario: File Nodo principal: MetaQuery
File	Container	N/A	Contenedor de un solo objeto. Nodos secundarios: Filename, Size, FileModifiedTime, OSSObjectType, OSSStorageClass, ObjectACL, ETag, OSSTaggingCount, OSSTagging y OSSCRC64 Nodo principal: Files
Filename	String	exampleobject.txt	Ruta completa del objeto. Nodo principal: File
Size	Integer	120	Tamaño del objeto en bytes. Nodo principal: File
FileModifiedTime	String	2025-05-19T16:14:38+08:00	Hora de la última modificación del objeto. El formato es RFC3339Nano. Nodo principal: File
OSSObjectType	String	Normal	Tipo del objeto. Valores válidos: Normal: El objeto se carga mediante la operación PutObject o se crea mediante la operación CreateDirectory. Appendable: El objeto se carga mediante la operación AppendObject. Multipart: El objeto se carga mediante la operación MultipartUpload. Symlink: El enlace simbólico se crea mediante la operación PutSymlink. Nodo principal: File
OSSStorageClass	String	Standard	Clase de almacenamiento del objeto. Valores válidos: Standard: Almacenamiento de alta confiabilidad, alta disponibilidad y alto rendimiento para datos de acceso frecuente. IA: Adecuado para almacenamiento a largo plazo con acceso poco frecuente (una o dos veces al mes en promedio). Archive: Ideal para el archivado a largo plazo de datos a los que se accede rara vez (se recomienda seis meses o más). Requiere aproximadamente 1 minuto para restaurarse antes de su lectura. ColdArchive: Apropiado para el almacenamiento a largo plazo de datos de acceso raro. Nodo principal: File
ObjectACL	String	default	ACL del objeto. Valores válidos: default: Hereda la ACL del bucket. private: Solo el propietario del objeto y los usuarios autorizados pueden leer y escribir. Otros usuarios no pueden acceder al objeto. public-read: El propietario y los usuarios autorizados pueden leer y escribir. Otros usuarios solo pueden leer. Utilice esta opción con precaución. public-read-write: Todos los usuarios pueden leer y escribir. Utilice esta opción con precaución. Nodo principal: File
ETag	String	"fba9dede5f27731c9771645a3986****"	Se genera un ETag cuando se crea un objeto. Este identifica el contenido del objeto. Para un objeto creado mediante una solicitud PutObject, el valor ETag es el hash MD5 de su contenido. Para objetos creados por otros métodos, el ETag es un valor único, pero no corresponde al hash MD5 del contenido. Nota Puede usar el ETag para comprobar si el contenido del objeto ha cambiado, pero no lo utilice como hash MD5 para verificar la integridad de los datos. Nodo principal: File
OSSTaggingCount	Integer	2	Número de etiquetas del objeto. Nodo principal: File
OSSTagging	Container	N/A	Contenedor de la información de etiquetas. Nodo secundario: Tagging Nodo principal: File
Tagging	Container	N/A	Contenedor de una sola etiqueta. Nodos secundarios: Key y Value Nodo principal: OSSTagging
Key	String	owner	Clave de la etiqueta o de los metadatos definidos por el usuario. La clave de los metadatos definidos por el usuario debe tener el prefijo `x-oss-meta-`. Nodos principales: Tagging y UserMeta
Value	String	John	Valor de la etiqueta o de los metadatos definidos por el usuario. Nodos principales: Tagging y UserMeta
OSSCRC64	String	4858A48BD1466884	Valor CRC de 64 bits del objeto. Este valor se calcula según el estándar CRC-64/XZ. Nodo principal: File
Aggregations	Container	N/A	Contenedor de las operaciones de agregación. Nodos secundarios: Field, Operation, Operation, Value y Groups Nodo principal: MetaQuery
Field	String	Size	Nombre del campo. Nodo principal: Aggregations
Operation	String	sum	Operador de agregación. Nodo principal: Aggregations
Value	Floating-point number	200	Valor resultante de la operación de agregación. Nodo principal: Aggregations
Groups	Container	N/A	Lista de resultados de agrupación y agregación. Nodos secundarios: Value y Count Nodo principal: Aggregations
Value	String	100	Valor de la agrupación y agregación. Nodo principal: Groups
Count	Integer	5	Recuento de resultados de agrupación y agregación. Nodo principal: Groups

Recuperación vectorial

Nombre	Tipo	Ejemplo	Descripción
MetaQuery	Container	N/A	Contenedor de los resultados de la consulta. Nodo secundario: Files
Files	Container	N/A	Lista de información de objetos. Nodo secundario: File Nodo principal: MetaQuery
File	Container	N/A	Información sobre un solo objeto. Nodo principal: Files
URI	String	oss://examplebucket/test-object.jpg	Ruta completa del objeto. Nodo principal: File
Filename	String	exampleobject.txt	Nombre del objeto. Nodo principal: File
Size	Integer	120	Tamaño del objeto en bytes. Nodo principal: File
ObjectACL	String	default	ACL del objeto. Valores válidos: default: Hereda la ACL del bucket. private: Solo el propietario del objeto y los usuarios autorizados pueden leer y escribir. Otros usuarios no pueden acceder al objeto. public-read: El propietario y los usuarios autorizados pueden leer y escribir. Otros usuarios solo pueden leer. Utilice esta opción con precaución. public-read-write: Todos los usuarios pueden leer y escribir. Utilice esta opción con precaución. Nodo principal: File
FileModifiedTime	String	2025-05-19T16:15:33+08:00	Hora de la última modificación del objeto. El formato es RFC3339Nano. Nodo principal: File
ETag	String	"fba9dede5f27731c9771645a3986****"	Se genera un ETag cuando se crea un objeto. Este identifica el contenido del objeto. Para un objeto creado mediante una solicitud PutObject, el valor ETag es el hash MD5 de su contenido. Para objetos creados por otros métodos, el ETag es un valor único, pero no corresponde al hash MD5 del contenido. Nota Puede usar el ETag para comprobar si el contenido del objeto ha cambiado, pero no lo utilice como hash MD5 para verificar la integridad de los datos. Nodo principal: File
OSSCRC64	String	4858A48BD1466884	Valor CRC de 64 bits del objeto. Este valor se calcula según el estándar CRC-64/XZ. Nodo principal: File
ProduceTime	String	2021-06-29T14:50:13.011643661+08:00	Momento en que el dispositivo capturó la foto o el video. Nodo principal: File
ContentType	String	image/jpeg	Tipo de extensiones multipropósito de correo de Internet (MIME). Nodo principal: File
MediaType	String	image	Tipo de medio. Nodo principal: File
LatLong	String	30.134390,120.074997	Información de latitud y longitud. Nodo principal: File
Title	String	test	Título del archivo. Nodo principal: File
OSSExpiration	String	2124-12-01T12:00:00.000Z	Fecha de caducidad del archivo. Nodo principal: File
AccessControlAllowOrigin	String	https://aliyundoc.com	Origen permitido para enviar solicitudes de origen cruzado. Nodo principal: File
AccessControlRequestMethod	String	PUT	Método utilizado en la solicitud de origen cruzado. Nodo principal: File
CacheControl	String	no-cache	Comportamiento de caché de la página web al descargar el objeto. Nodo principal: File
ContentDisposition	String	attachment; filename =test.jpg	Nombre del objeto al descargarse. Nodo principal: File
ContentEncoding	String	UTF-8	Formato de codificación del contenido al descargar el objeto. Nodo principal: File
ContentLanguage	String	zh-CN	Idioma utilizado en el contenido del objeto. Nodo principal: File
ImageHeight	Integer	500	Altura de la imagen en píxeles (px). Nodo principal: File
ImageWidth	Integer	270	Ancho de la imagen en píxeles (px). Nodo principal: File
VideoWidth	Integer	1080	Ancho del cuadro de video en píxeles (px). Nodo principal: File
VideoHeight	Integer	1920	Altura del cuadro de video en píxeles (px). Nodo principal: File
VideoStreams	Container	N/A	Lista de secuencias de video. Nodo principal: File
VideoStream	Container	N/A	Secuencia de video. Nodo principal: VideoStreams
CodecName	String	h264	Nombre del codificador. Nodo principal: VideoStream
Language	String	en	Idioma utilizado en la secuencia de video. El formato es BCP 47. Nodo principal: VideoStream
Bitrate	Integer	5407765	Tasa de bits en bit/s. Nodo principal: VideoStream
FrameRate	String	25/1	Velocidad de cuadros de la secuencia de video. Nodo principal: VideoStream
StartTime	Double-precision floating-point number	0.000000	Tiempo de inicio de la secuencia de video en segundos (s). Nodo principal: VideoStream
Duration	Double-precision floating-point number	22.88	Duración de la secuencia de video en segundos (s). Nodo principal: VideoStream
FrameCount	Integer	572	Número de cuadros de video. Nodo principal: VideoStream
BitDepth	Integer	8	Profundidad de bits del píxel. Nodo principal: VideoStream
PixelFormat	String	yuv420p	Formato de píxel de la secuencia de video. Nodo principal: VideoStream
ColorSpace	String	bt709	Espacio de color. Nodo principal: VideoStream
Height	Integer	720	Altura del cuadro de la secuencia de video en píxeles (px). Nodo principal: VideoStream
Width	Integer	1280	Ancho del cuadro de la secuencia de video en píxeles (px). Nodo principal: VideoStream
AudioStreams	Container	N/A	Lista de secuencias de audio. Nodo principal: File
AudioStream	Container	N/A	Secuencia de audio. Nodo principal: AudioStreams
CodecName	String	aac	Nombre del codificador. Nodo principal: AudioStream
Bitrate	Integer	320087	Tasa de bits en bit/s. Nodo principal: AudioStream
SampleRate	Integer	48000	Frecuencia de muestreo en hercios (Hz). Nodo principal: AudioStream
StartTime	Double-precision floating-point number	0.0235	Tiempo de inicio de la secuencia de audio en segundos (s). Nodo principal: AudioStream
Duration	Double-precision floating-point number	3.690667	Duración de la secuencia de audio en segundos (s). Nodo principal: AudioStream
Channels	Integer	2	Número de canales de sonido. Nodo principal: AudioStream
Language	String	en	Idioma utilizado en la secuencia de audio. El formato es BCP 47. Nodo principal: AudioStream
Subtitles	Container	N/A	Lista de secuencias de subtítulos. Nodo principal: File
Subtitle	Container	N/A	Secuencia de subtítulos. Nodo principal: Subtitles
CodecName	String	mov_text	Nombre del codificador. Nodo principal: Subtitle
Language	String	en	Idioma del subtítulo. El formato es BCP 47. Nodo principal: Subtitle
StartTime	Double-precision floating-point number	0.000000	Tiempo de inicio de la secuencia de subtítulos en segundos (s). Nodo principal: Subtitle
Duration	Double-precision floating-point number	71.378	Duración de la secuencia de subtítulos en segundos (s). Nodo principal: Subtitle
Bitrate	Integer	13091201	Tasa de bits en bit/s. Nodo principal: File
Artist	String	Jane	Artista. Nodo principal: File
AlbumArtist	String	Jenny	Artista. Nodo principal: File
Composer	String	Jane	Compositor. Nodo principal: File
Performer	String	Jane	Intérprete. Nodo principal: File
Album	String	FirstAlbum	Álbum. Nodo principal: File
Duration	Double-precision floating-point number	15.263000	Duración total del video en segundos. Nodo principal: File
Addresses	Container	N/A	Información de dirección. Nodo principal: File
Address	Container	N/A	Información de dirección. Nodo principal: Addresses
AddressLine	String	No. 969, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China	Dirección completa. Nodo principal: Address
City	String	Hangzhou	Ciudad. Nodo principal: Address
District	String	Yuhang District	Distrito. Nodo principal: Address
Language	String	zh-Hans	Idioma. El formato es BCP 47. Nodo principal: Address
Province	String	Zhejiang	Provincia. Nodo principal: Address
Township	String	Wenyi West Road	Calle. Nodo principal: Address
OSSObjectType	String	Normal	Tipo del objeto. Nodo principal: File
OSSStorageClass	String	Standard	Clase de almacenamiento del objeto. Nodo principal: File
OSSTaggingCount	Integer	2	Número de etiquetas del objeto. Nodo principal: File
OSSTagging	Container	N/A	Lista de información de etiquetas. Nodo secundario: Tagging Nodo principal: File
Tagging	Container	N/A	Contenedor de una sola etiqueta. Nodos secundarios: Key y Value Nodo principal: OSSTagging
Key	String	owner	Clave de la etiqueta. Nodo principal: Tagging
Value	String	John	Valor de la etiqueta. Nodo principal: Tagging
Key	String	owner	Clave de los metadatos definidos por el usuario. Nodo principal: Tagging
Value	String	John	Valor de los metadatos definidos por el usuario. Nodo principal: Tagging

Ejemplos

Ejemplos de solicitud

Recuperación escalar

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>

Recuperación vectorial

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>

Ejemplos de respuesta

Recuperación escalar

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>

Recuperación vectorial

Ejemplo de respuesta para una solicitud de recuperación de imágenes

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>

Ejemplo de respuesta para una solicitud de recuperación de audio o video

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>

Ejemplos de consulta

Anide elementos Query para construir condiciones de consulta complejas y recuperar con precisión el contenido que necesita.

Para buscar un objeto llamado exampleobject.txt cuyo tamaño sea menor a 1000 bytes, configure el elemento Query de la siguiente manera:


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

Para buscar objetos que tengan el prefijo exampledir/, contengan la etiqueta type=document o owner=John y sean mayores a 10 MB, configure el elemento Query de la siguiente manera:


{
  "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"
}

Además de las condiciones de búsqueda, puede usar operaciones de agregación para realizar análisis estadísticos —como tamaño total, conteo, promedio, máximo o mínimo— sobre los objetos que cumplen los criterios, o bien analizar la distribución de tamaño de las imágenes coincidentes.

SDK

SDK disponibles para esta operación:

Herramienta de línea de comandos ossutil

La operación DoMetaQuery corresponde al comando do-meta-query en ossutil.