Todos os produtos
Search
Central de documentação

:Consultar um gatilho de aplicativo

Última atualização: Jul 09, 2026

Chame a operação DescribeTrigger para consultar um gatilho de aplicativo específico.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Sintaxe da solicitação

GET /clusters/[cluster_id]/triggers?Namespace=String&Type=String&Name=String&action=String HTTP/1.1
Content-Type:application/json

Parâmetros da solicitação

Tabela 1. Parâmetros de caminho da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

cluster_id

String

Sim

c5cdf7e3938bc4f8eb0e44b21a80f****

ID do cluster.

Tabela 2. Parâmetros de consulta da solicitação
ParâmetroTipoObrigatórioExemploDescrição
NamespaceStringSimdefault

Namespace ao qual o aplicativo pertence.

TypeStringNãodeployment

Tipo do gatilho. Valores válidos:

  • deployment: executa ações em Deployments.
  • application: executa ações em aplicativos implantados no Application Center.

Valor padrão: deployment.

Sem esse parâmetro, os gatilhos não são filtrados por tipo.

NameStringSimweb-server

Nome do aplicativo.

actionStringNãoredeploy

Ação executada pelo gatilho. Defina o valor como redeploy.

redeploy: reimplanta os recursos especificados por project_id.

Sem esse parâmetro, os gatilhos não são filtrados por ação.

Sintaxe da resposta

HTTP/1.1 200 OK
Content-Type:application/json

[ {
  "id" : "String",
  "name" : "String",
  "cluster_id" : "String",
  "project_id" : "String",
  "type" : "String",
  "action" : "String",
  "token" : "String"
} ]

Parâmetros da resposta

Tabela 3. Parâmetros do corpo da resposta
ParâmetroTipoExemploDescrição
Array of trigger_info

Detalhes dos gatilhos retornados.

idString1234

ID do gatilho.

nameStringtest

Nome do gatilho.

cluster_idStringc259f563386444ebb8d7****

ID do cluster.

project_idStringdefault/test-app

Nome do projeto.

Composto pelo namespace de implantação do aplicativo e pelo nome do aplicativo. Formato: ${namespace}/${name}. Exemplo: default/test-app.

typeStringdeployment

Tipo do gatilho.

Valores válidos:

  • deployment: o gatilho executa ações em Deployments.
  • application: o gatilho executa ações em aplicativos implantados no Application Center.

Valor padrão: deployment.

actionStringredeploy

Ação executada pelo gatilho. Valor válido:

redeploy: o gatilho reimplanta os recursos especificados por project_id.

tokenStringeyJhbGci***

Informações do token.

Exemplos

Exemplos de solicitações

GET /clusters/[cluster_id]/triggers?Namespace=default&Type=deployment&Name=web-server&action=redeploy HTTP/1.1
Host:cs.aliyuncs.com
Content-Type:application/json

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeTriggerResponse>
    <id>1234</id>
    <name>test</name>
    <cluster_id>c259f563386444ebb8d7****</cluster_id>
    <project_id>default/test-app</project_id>
    <type>deployment</type>
    <action>redeploy</action>
    <token>eyJhbGci***</token>
</DescribeTriggerResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

[ {
  "id" : "1234",
  "name" : "test",
  "cluster_id" : "c259f563386444ebb8d7****",
  "project_id" : "default/test-app",
  "type" : "deployment",
  "action" : "redeploy",
  "token" : "eyJhbGci***"
} ]

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.