Todos os produtos
Search
Central de documentação

Object Storage Service:Apêndice: Lista de campos e operadores para recuperação escalar

Última atualização: Jul 03, 2026

A recuperação escalar do OSS oferece suporte a campos e operadores específicos para consultas simples, operações de agregação e ordenação.

Observações

  • Consultas simples aceitam os seguintes operadores: eq (igual a), gt (maior que), gte (maior ou igual a), lt (menor que), lte (menor ou igual a), match (consulta difusa) e prefix (consulta por prefixo). Operações de agregação incluem: min (mínimo), max (máximo), average (média), sum (soma), count (contagem), distinct (contagem com deduplicação) e group (contagem agrupada).

  • Para pesquisar arquivos com o campo OSSUserMeta.*, substitua o asterisco (*) pela chave dos metadados definidos pelo usuário. A correspondência ocorre pelo par chave-valor. A chave não diferencia maiúsculas de minúsculas, mas o valor diferencia.

    Por exemplo, para localizar arquivos com o metadado definido pelo usuário x-oss-meta-location=hangzhou, defina a condição de consulta como {"Field": "OSSUserMeta.x-oss-meta-location", "Value": "hangzhou", "Operation": "eq"}.

  • Para pesquisar arquivos com o campo OSSTagging.*, substitua o asterisco (*) pela chave da tag do objeto. A correspondência ocorre pelo par chave-valor. Tanto a chave quanto o valor diferenciam maiúsculas de minúsculas.

    Por exemplo, para localizar arquivos com a tag owner=John, defina a condição de consulta como {"Field": "OSSTagging.owner", "Value": "John", "Operation": "eq"}.

Lista de suporte

A tabela a seguir lista os campos e os respectivos operadores compatíveis com consultas simples, operações de agregação e ordenação.

Nela, ✓ indica que o campo aceita o operador e × indica que não aceita.

Campo

Descrição

Operadores (em condições de consulta simples)

Operadores (em operações de agregação)

Ordenação

eq, gt,

gte, lt, lte

match

prefix

min, max,

sum, average

count,

distinct, group

ETag

Identifica o conteúdo do objeto.

×

×

FileModifiedTime

Hora da última modificação do objeto.

×

×

×

Filename

Nome do objeto, incluindo o caminho completo e o nome do arquivo.

×

ObjectACL

Lista de controle de acesso (ACL) do objeto.

×

×

OSSCRC64

Valor CRC-64 de 64 bits do objeto.

×

×

OSSObjectType

Tipo do objeto.

×

×

OSSStorageClass

Classe de armazenamento do objeto.

×

×

OSSTagging.*

Tag do objeto.

×

×

×

×

OSSTaggingCount

Número de tags do objeto.

×

×

Size

Tamanho do objeto.

×

×