DoMetaQuery - consultar e classificar objetos por condições de campo no OSS - : Central de Documentação do Alibaba Cloud

A operação DoMetaQuery consulta objetos que atendem a condições especificadas e lista informações dos objetos por um campo e ordem de classificação especificados. Você também pode aninhar elementos Query para consultas complexas e usar operações de agregação para coletar estatísticas sobre valores de campos.

Precauções

Para consultar objetos que atendem a condições especificadas, você precisa ter a permissão oss:DoMetaQuery. Conceder permissões personalizadas a um usuário RAM.

Sintaxe da solicitação

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>

Cabeçalhos da solicitação

DescribeRegions uses only common request headers. For more information, see Common request headers.

Elementos da solicitação

Recuperação escalar

Nome	Tipo	Obrigatório	Exemplo	Descrição
mode	String	Sim	basic	Define o modo de recuperação como recuperação escalar.
MetaQuery	Container	Sim	N/A	O contêiner para condições de consulta. Nós filho: NextToken, MaxResults, Query, Sort, Order e Aggregations
NextToken	String	Não	MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****	O token de paginação. Obrigatório quando o número total de objetos excede MaxResults. As informações dos objetos são retornadas em ordem lexicográfica a partir do objeto especificado por NextToken. Deixe este campo vazio na primeira solicitação. Nó pai: MetaQuery
MaxResults	Integer	Não	5	O número máximo de objetos a retornar. Valores válidos: 0 a 100. Padrão: 100. Aplica-se quando não definido ou definido como 0. Nó pai: MetaQuery
Query	String	Sim	{"Field": "Size","Value": "1048576","Operation": "gt"}	A condição de consulta. Opções: Operation: o operador. Valores válidos: eq (igual a), gt (maior que), gte (maior ou igual a), lt (menor que), lte (menor ou igual a), match (consulta difusa), prefix (consulta por prefixo), and (AND lógico), or (OR lógico) e not (NOT lógico). Field: o nome do campo. Os campos e operadores compatíveis estão listados em Apêndice: campos e operadores para recuperação escalar. Value: o valor do campo. SubQueries: as condições de subconsulta. As opções são as mesmas das condições de consulta simples. Obrigatório apenas quando Operation é um operador lógico (and, or ou not). Exemplos de consulta: DoMetaQuery. Nó pai: MetaQuery
Sort	String	Não	Size	Classifica os resultados por um campo especificado. Os campos classificáveis estão listados em Apêndice: campos e operadores para recuperação escalar. Nó pai: MetaQuery
Order	String	Não	asc	A ordem de classificação. Valores válidos: asc: crescente desc (padrão): decrescente Nó pai: MetaQuery
Aggregations	Container	Não	N/A	O contêiner para operações de agregação. Nó filho: Aggregation Nó pai: MetaQuery
Aggregation	Container	Não	N/A	O contêiner para uma única operação de agregação. Nós filho: Field e Operation Nó pai: Aggregations
Field	String	Não	Size	O nome do campo. Os campos e operadores compatíveis estão listados em Apêndice: campos e operadores para recuperação escalar. Nó pai: Aggregation
Operation	String	Não	sum	O operador na operação de agregação. Valores válidos: min: valor mínimo max: valor máximo average: valor médio sum: soma count: contagem distinct: contagem sem duplicatas group: contagem por grupo Nó pai: Aggregation

Recuperação vetorial

Nome	Tipo	Obrigatório	Exemplo	Descrição
mode	String	Sim	semantic	Define o modo de recuperação como recuperação vetorial.
MetaQuery	Container	Sim	N/A	O contêiner para condições de consulta. Nós filho: MaxResults, Query, MediaTypes e SimpleQuery
MaxResults	Integer	Não	5	O número máximo de objetos a retornar. Valores válidos: 0 a 100. Padrão: 100. Aplica-se quando não definido ou definido como 0. Nó pai: MetaQuery
Query	String	Sim	An aerial view of a snow-covered forest	O conteúdo a recuperar. Nó pai: MetaQuery
MediaTypes	Container	Sim	N/A	As condições de recuperação de metadados multimídia. Nó pai: MetaQuery
MediaType	String	Sim	image	O tipo de multimídia a recuperar. Valores válidos: image video audio document Nó pai: MediaTypes
SimpleQuery	String	Não	{"Operation":"gt", "Field": "Size", "Value": "30"}	A condição de consulta. Opções: Operation: o operador. Valores válidos: eq (igual a), gt (maior que), gte (maior ou igual a), lt (menor que), lte (menor ou igual a), match (consulta difusa), prefix (consulta por prefixo), and (AND lógico), or (OR lógico) e not (NOT lógico). Field: o nome do campo. Os campos e operadores compatíveis estão listados em Apêndice: campos e operadores para recuperação vetorial. Value: o valor do campo. SubQueries: as condições de subconsulta. As opções são as mesmas das condições de consulta simples. Obrigatório apenas quando Operation é um operador lógico (and, or ou not). Nó pai: MetaQuery

Cabeçalhos da resposta

The response contains only common response headers. For more information, see Common response headers.

Elementos da resposta

Recuperação escalar

Nome	Tipo	Exemplo	Descrição
MetaQuery	Container	N/A	O contêiner para resultados da consulta. Nós filho: NextToken, Files e Aggregations
NextToken	String	MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****	O token de paginação. Obrigatório quando o número total de objetos excede MaxResults. Informe este valor como NextToken na próxima solicitação para recuperar os resultados restantes. Retornado apenas quando nem todos os objetos estão incluídos na resposta. Nó pai: MetaQuery
Files	Container	N/A	O contêiner para informações do objeto. Nó filho: File Nó pai: MetaQuery
File	Container	N/A	O contêiner para um único objeto. Nós filho: Filename, Size, FileModifiedTime, OSSObjectType, OSSStorageClass, ObjectACL, ETag, OSSTaggingCount, OSSTagging e OSSCRC64 Nó pai: Files
Filename	String	exampleobject.txt	O caminho completo do objeto. Nó pai: File
Size	Integer	120	O tamanho do objeto em bytes. Nó pai: File
FileModifiedTime	String	2025-05-19T16:14:38+08:00	A hora da última modificação do objeto. O formato é RFC3339Nano. Nó pai: File
OSSObjectType	String	Normal	O tipo do objeto. Valores válidos: Normal: o objeto foi enviado pela operação PutObject ou criado pela operação CreateDirectory. Appendable: o objeto foi enviado pela operação AppendObject. Multipart: o objeto foi enviado pela operação MultipartUpload. Symlink: o link simbólico foi criado pela operação PutSymlink. Nó pai: File
OSSStorageClass	String	Standard	A classe de armazenamento do objeto. Valores válidos: Standard: armazenamento altamente confiável, altamente disponível e de alto desempenho para dados acessados com frequência. IA: adequado para armazenamento de longo prazo com acesso pouco frequente (uma ou duas vezes por mês, em média). Archive: adequado para arquivamento de longo prazo de dados raramente acessados (recomendado seis meses ou mais). Requer aproximadamente 1 minuto para restauração antes da leitura. ColdArchive: adequado para armazenamento de longo prazo de dados raramente acessados. Nó pai: File
ObjectACL	String	default	A ACL do objeto. Valores válidos: default: herda a ACL do bucket. private: apenas o proprietário do objeto e os usuários autorizados podem ler e gravar. Os demais usuários não podem acessar o objeto. public-read: o proprietário e os usuários autorizados podem ler e gravar. Os demais usuários podem apenas ler. Use com cautela. public-read-write: todos os usuários podem ler e gravar. Use com cautela. Nó pai: File
ETag	String	"fba9dede5f27731c9771645a3986****"	Um ETag é gerado quando um objeto é criado. Ele identifica o conteúdo do objeto. Para um objeto criado por uma solicitação PutObject, o valor do ETag é o hash MD5 do conteúdo. Para objetos criados por outros métodos, o ETag é um valor único, mas não o hash MD5 do conteúdo. null Você pode usar o ETag para verificar se o conteúdo do objeto foi alterado, mas não o utilize como hash MD5 para verificação de integridade de dados. Nó pai: File
OSSTaggingCount	Integer	2	O número de tags do objeto. Nó pai: File
OSSTagging	Container	N/A	O contêiner para informações de tag. Nó filho: Tagging Nó pai: File
Tagging	Container	N/A	O contêiner para uma única tag. Nós filho: Key e Value Nó pai: OSSTagging
Key	String	owner	A chave da tag ou dos metadados definidos pelo usuário. A chave dos metadados definidos pelo usuário deve ter o prefixo `x-oss-meta-`. Nós pai: Tagging e UserMeta
Value	String	John	O valor da tag ou dos metadados definidos pelo usuário. Nós pai: Tagging e UserMeta
OSSCRC64	String	4858A48BD1466884	O valor CRC de 64 bits do objeto. O valor CRC de 64 bits é calculado com base no padrão CRC-64/XZ. Nó pai: File
Aggregations	Container	N/A	O contêiner para operações de agregação. Nós filho: Field, Operation, Operation, Value e Groups Nó pai: MetaQuery
Field	String	Size	O nome do campo. Nó pai: Aggregations
Operation	String	sum	O operador de agregação. Nó pai: Aggregations
Value	Número de ponto flutuante	200	O valor do resultado da operação de agregação. Nó pai: Aggregations
Groups	Container	N/A	A lista de resultados de agrupamento e agregação. Nós filho: Value e Count Nó pai: Aggregations
Value	String	100	O valor do agrupamento e da agregação. Nó pai: Groups
Count	Integer	5	A contagem dos resultados de agrupamento e agregação. Nó pai: Groups

Recuperação vetorial

Nome	Tipo	Exemplo	Descrição
MetaQuery	Container	N/A	O contêiner para resultados da consulta. Nó filho: Files
Files	Container	N/A	A lista de informações do objeto. Nó filho: File Nó pai: MetaQuery
File	Container	N/A	As informações sobre um único objeto. Nó pai: Files
URI	String	oss://examplebucket/test-object.jpg	O caminho completo do objeto. Nó pai: File
Filename	String	exampleobject.txt	O nome do objeto. Nó pai: File
Size	Integer	120	O tamanho do objeto em bytes. Nó pai: File
ObjectACL	String	default	A ACL do objeto. Valores válidos: default: herda a ACL do bucket. private: apenas o proprietário do objeto e os usuários autorizados podem ler e gravar. Os demais usuários não podem acessar o objeto. public-read: o proprietário e os usuários autorizados podem ler e gravar. Os demais usuários podem apenas ler. Use com cautela. public-read-write: todos os usuários podem ler e gravar. Use com cautela. Nó pai: File
FileModifiedTime	String	2025-05-19T16:15:33+08:00	A hora da última modificação do objeto. O formato é RFC3339Nano. Nó pai: File
ETag	String	"fba9dede5f27731c9771645a3986****"	Um ETag é gerado quando um objeto é criado. Ele identifica o conteúdo do objeto. Para um objeto criado por uma solicitação PutObject, o valor do ETag é o hash MD5 do conteúdo. Para objetos criados por outros métodos, o ETag é um valor único, mas não o hash MD5 do conteúdo. null Você pode usar o ETag para verificar se o conteúdo do objeto foi alterado, mas não o utilize como hash MD5 para verificação de integridade de dados. Nó pai: File
OSSCRC64	String	4858A48BD1466884	O valor CRC de 64 bits do objeto. O valor CRC de 64 bits é calculado com base no padrão CRC-64/XZ. Nó pai: File
ProduceTime	String	2021-06-29T14:50:13.011643661+08:00	A hora em que a foto ou vídeo foi capturado pelo dispositivo. Nó pai: File
ContentType	String	image/jpeg	O tipo Multipurpose Internet Mail Extensions (MIME). Nó pai: File
MediaType	String	image	O tipo de mídia. Nó pai: File
LatLong	String	30.134390,120.074997	As informações de latitude e longitude. Nó pai: File
Title	String	test	O título do arquivo. Nó pai: File
OSSExpiration	String	2124-12-01T12:00:00.000Z	A hora de expiração do arquivo. Nó pai: File
AccessControlAllowOrigin	String	https://aliyundoc.com	A origem autorizada a enviar solicitações entre origens. Nó pai: File
AccessControlRequestMethod	String	PUT	O método usado na solicitação entre origens. Nó pai: File
CacheControl	String	no-cache	O comportamento de cache da página web ao baixar o objeto. Nó pai: File
ContentDisposition	String	attachment; filename =test.jpg	O nome do objeto ao ser baixado. Nó pai: File
ContentEncoding	String	UTF-8	O formato de codificação do conteúdo ao baixar o objeto. Nó pai: File
ContentLanguage	String	zh-CN	O idioma usado no conteúdo do objeto. Nó pai: File
ImageHeight	Integer	500	A altura da imagem em pixels (px). Nó pai: File
ImageWidth	Integer	270	A largura da imagem em pixels (px). Nó pai: File
VideoWidth	Integer	1080	A largura do quadro de vídeo em pixels (px). Nó pai: File
VideoHeight	Integer	1920	A altura do quadro de vídeo em pixels (px). Nó pai: File
VideoStreams	Container	N/A	A lista de fluxos de vídeo. Nó pai: File
VideoStream	Container	N/A	O fluxo de vídeo. Nó pai: VideoStreams
CodecName	String	h264	O nome do codificador. Nó pai: VideoStream
Language	String	en	O idioma usado no fluxo de vídeo. O formato é BCP 47. Nó pai: VideoStream
Bitrate	Integer	5407765	A taxa de bits em bit/s. Nó pai: VideoStream
FrameRate	String	25/1	A taxa de quadros do fluxo de vídeo. Nó pai: VideoStream
StartTime	Número de ponto flutuante de precisão dupla	0.000000	O tempo de início do fluxo de vídeo em segundos (s). Nó pai: VideoStream
Duration	Número de ponto flutuante de precisão dupla	22.88	A duração do fluxo de vídeo em segundos (s). Nó pai: VideoStream
FrameCount	Integer	572	O número de quadros de vídeo. Nó pai: VideoStream
BitDepth	Integer	8	A profundidade de bits do pixel. Nó pai: VideoStream
PixelFormat	String	yuv420p	O formato de pixel do fluxo de vídeo. Nó pai: VideoStream
ColorSpace	String	bt709	O espaço de cores. Nó pai: VideoStream
Height	Integer	720	A altura do quadro do fluxo de vídeo em pixels (px). Nó pai: VideoStream
Width	Integer	1280	A largura do quadro do fluxo de vídeo em pixels (px). Nó pai: VideoStream
AudioStreams	Container	N/A	A lista de fluxos de áudio. Nó pai: File
AudioStream	Container	N/A	O fluxo de áudio. Nó pai: AudioStreams
CodecName	String	aac	O nome do codificador. Nó pai: AudioStream
Bitrate	Integer	320087	A taxa de bits em bit/s. Nó pai: AudioStream
SampleRate	Integer	48000	A taxa de amostragem em hertz (Hz). Nó pai: AudioStream
StartTime	Número de ponto flutuante de precisão dupla	0.0235	O tempo de início do fluxo de áudio em segundos (s). Nó pai: AudioStream
Duration	Número de ponto flutuante de precisão dupla	3.690667	A duração do fluxo de áudio em segundos (s). Nó pai: AudioStream
Channels	Integer	2	O número de canais de som. Nó pai: AudioStream
Language	String	en	O idioma usado no fluxo de áudio. O formato é BCP 47. Nó pai: AudioStream
Subtitles	Container	N/A	A lista de fluxos de legenda. Nó pai: File
Subtitle	Container	N/A	O fluxo de legenda. Nó pai: Subtitles
CodecName	String	mov_text	O nome do codificador. Nó pai: Subtitle
Language	String	en	O idioma da legenda. O formato é BCP 47. Nó pai: Subtitle
StartTime	Número de ponto flutuante de precisão dupla	0.000000	O tempo de início do fluxo de legenda em segundos (s). Nó pai: Subtitle
Duration	Número de ponto flutuante de precisão dupla	71.378	A duração do fluxo de legenda em segundos (s). Nó pai: Subtitle
Bitrate	Integer	13091201	A taxa de bits em bit/s. Nó pai: File
Artist	String	Jane	O artista. Nó pai: File
AlbumArtist	String	Jenny	Artista. Nó pai: File
Composer	String	Jane	O compositor. Nó pai: File
Performer	String	Jane	O intérprete. Nó pai: File
Album	String	FirstAlbum	O álbum. Nó pai: File
Duration	Número de ponto flutuante de precisão dupla	15.263000	A duração total do vídeo em segundos. Nó pai: File
Addresses	Container	N/A	As informações de endereço. Nó pai: File
Address	Container	N/A	As informações de endereço. Nó pai: Addresses
AddressLine	String	No. 969, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China	O endereço completo. Nó pai: Address
City	String	Hangzhou	A cidade. Nó pai: Address
District	String	Yuhang District	O distrito. Nó pai: Address
Language	String	zh-Hans	O idioma. O formato é BCP 47. Nó pai: Address
Province	String	Zhejiang	A província. Nó pai: Address
Township	String	Wenyi West Road	A rua. Nó pai: Address
OSSObjectType	String	Normal	O tipo do objeto. Nó pai: File
OSSStorageClass	String	Standard	A classe de armazenamento do objeto. Nó pai: File
OSSTaggingCount	Integer	2	O número de tags do objeto. Nó pai: File
OSSTagging	Container	N/A	A lista de informações de tag. Nó filho: Tagging Nó pai: File
Tagging	Container	N/A	O contêiner para uma única tag. Nós filho: Key e Value Nó pai: OSSTagging
Key	String	owner	A chave da tag. Nó pai: Tagging
Value	String	John	O valor da tag. Nó pai: Tagging
Key	String	owner	A chave dos metadados definidos pelo usuário. Nó pai: Tagging
Value	String	John	O valor dos metadados definidos pelo usuário. Nó pai: Tagging

Exemplos

Exemplos de solicitação

Recuperação 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>

Vector retrieval

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>

Response examples

Recuperação 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>

Vector retrieval

Exemplo de resposta para uma solicitação de recuperação de imagem

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>

Example of a response for an audio or video retrieval request

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>

Exemplos de consulta

Aninhe elementos Query para construir condições de consulta complexas e recuperar com precisão o conteúdo desejado.

Para buscar um objeto chamado exampleobject.txt menor que 1.000 bytes, configure o elemento Query da seguinte forma:


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

Para buscar objetos com o prefixo exampledir/, que contenham a tag type=document ou owner=John, e sejam maiores que 10 MB, configure o elemento Query da seguinte forma:


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

Além das condições de busca, você pode usar operações de agregação para realizar análises estatísticas — como tamanho total, contagem, média, máximo ou mínimo — nos objetos que atendem aos critérios, ou analisar a distribuição de tamanho das imagens correspondentes.

SDK

SDKs disponíveis para esta operação:

Ferramenta de linha de comando ossutil

A operação DoMetaQuery corresponde ao comando do-meta-query no ossutil.