Todos os produtos
Search
Central de documentação

:GetMetaQueryStatus

Última atualização: Sep 24, 2026

Consulta as informações da biblioteca de índice de metadados de um bucket.

Observações de uso

Para consultar as informações da biblioteca de índice de metadados de um bucket, você precisa ter a permissão oss:GetMetaQueryStatus. Para obter mais informações, consulte Grant a custom policy.

Sintaxe da requisição

GET /?metaQuery HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Cabeçalhos da requisição

Todos os cabeçalhos desta requisição são cabeçalhos comuns de requisição. Para obter mais informações, consulte Common Request Headers.

Cabeçalhos da resposta

Todos os cabeçalhos da resposta são cabeçalhos comuns de resposta. Para obter mais informações, consulte Common Response Headers.

Elementos da resposta

Elemento

Tipo

Exemplo

Descrição

MetaQueryStatus

Container

N/A

Contêiner que armazena as informações de metadados.

Nós filhos: State, Phase, CreateTime e UpdateTime.

Phase

String

FullScanning

Tipo de varredura. Valores válidos:

  • FullScanning: a varredura completa está em andamento.

  • IncrementalScanning: a varredura incremental está em andamento.

Nó pai: MetaQueryStatus

State

String

Running

Status da biblioteca de índice de metadados. Valores válidos:

  • Ready: a biblioteca de índice de metadados está sendo preparada após a criação.

    Nesse caso, não é possível usar a biblioteca de índice de metadados para consultar dados.

  • Stop: a biblioteca de índice de metadados está pausada.

  • Running: a biblioteca de índice de metadados está em execução.

  • Retrying: houve falha na criação da biblioteca de índice de metadados, e uma nova tentativa está em andamento.

  • Failed: a criação da biblioteca de índice de metadados falhou.

  • Deleted: a biblioteca de índice de metadados foi excluída.

Nó pai: MetaQueryStatus

CreateTime

String

2021-08-02T10:49:17.289372919+08:00

Data e hora de criação da biblioteca de índice de metadados. O valor segue o padrão RFC 3339 no formato YYYY-MM-DDTHH:mm:ss+TIMEZONE. YYYY-MM-DD indica o ano, o mês e o dia. T indica o início do elemento de hora. HH:mm:ss indica a hora, o minuto e o segundo. TIMEZONE indica o fuso horário.

Nó pai: MetaQueryStatus

UpdateTime

String

2021-08-02T10:49:17.289372919+08:00

Data e hora da última atualização da biblioteca de índice de metadados. O valor segue o padrão RFC 3339 no formato YYYY-MM-DDTHH:mm:ss+TIMEZONE. YYYY-MM-DD indica o ano, o mês e o dia. T indica o início do elemento de hora. HH:mm:ss indica a hora, o minuto e o segundo. TIMEZONE indica o fuso horário.

Nó pai: MetaQueryStatus

MetaQueryMode

String

basic

Modos de recuperação:

  • basic: busca escalar

  • semantic: busca vetorial

Nó pai: MetaQueryStatus

Exemplos

Exemplos de requisição

GET /?metaQuery HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 11 Sep 2024 13:08:38 GMT
Authorization: OSS qn6q**************:77Dv****************

Exemplos de resposta

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Wed, 11 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"?>
<MetaQueryStatus>
  <State>Running</State>
  <Phase>FullScanning</Phase>
  <CreateTime>2024-09-11T10:49:17.289372919+08:00</CreateTime>
  <UpdateTime>2024-09-11T10:49:17.289372919+08:00</UpdateTime>
  <MetaQueryMode>basic<MetaQueryMode>
</MetaQueryStatus>

OSS SDKs

Use os OSS SDKs para as seguintes linguagens de programação para chamar a operação GetMetaQueryStatus:

ossutil

Para obter informações sobre o comando ossutil correspondente à operação GetMetaQueryStatus, consulte get-meta-query-status.