Todos os produtos
Search
Central de documentação

:QueryTagByParam

Última atualização: Jun 27, 2026

Consulta de tags

Descrição

A operação QueryTagByParam consulta tags.

Parâmetros da solicitação

Nome

Tipo

Obrigatório

Descrição

Action

String

Sim

Parâmetro obrigatório. Defina o valor como QueryTagByParam.

KeyWord

String

Não

Nome da tag, com 1 a 50 caracteres. Caso não especifique este parâmetro, o sistema retorna todas as tags. Exemplo: 1aTag

PageNo

Integer

Não

Número da página.

PageSize

Integer

Não

Quantidade de entradas por página.

Para obter informações sobre outros parâmetros de solicitação, consulte Parâmetros de solicitação comuns.

Parâmetros de resposta

Nome

Tipo

Descrição

PageNumber

Integer

Número da página atual.

PageSize

Integer

Quantidade de entradas por página.

TotalCount

Integer

Número total de entradas.

data

Object []

Registros de dados.

RequestId

String

ID da solicitação.

data

Nome

Tipo

Descrição

TagId

String

ID da tag.

TagName

String

Nome da tag.

Exemplos

Exemplo de solicitação

http(s)://dm.aliyuncs.com/?Action=QueryTagByParam
&KeyWord=123
&PageNumber=1
&PageSize=5
&<Common request parameters>

Exemplo de resposta bem-sucedida

Formato JSON

{
  "TotalCount": 1,
  "RequestId": "E3BB15D6-8B36-5445-BFD6-1648D46C6464",
  "PageSize": 500,
  "data": {
    "tag": [
      {
        "TagName": "dtest",
        "TagId": 84223
      }
    ]
  },
  "PageNumber": 1
}

Códigos de erro

HttpCode

Descrição

Código de status HTTP

Semântica

InvalidKeyword.Malformed

A palavra-chave especificada é inválida.

400

O formato da palavra-chave especificada é inválido.