Consultar eventos em um cluster - : Central de Documentação do Alibaba Cloud

Chame a operação DescribeEvents para consultar eventos em um cluster específico do Container Service for Kubernetes (ACK).

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 /events?cluster_id=String&type=String&page_size=Long&page_number=Long HTTP/1.1
Content-Type:application/json

Parâmetros da solicitação

Tabela 1. Parâmetros de consulta da solicitação
Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
cluster_id	String	Não	cf62854ac2130470897be7a27ed1f****	ID do cluster.
type	String	Não	nodepool_upgrade	Tipo do evento. Valores válidos: `cluster_create`: criação de cluster. `cluster_scaleout`: expansão de cluster. `cluster_attach`: adição de nós existentes. `cluster_delete`: exclusão de cluster. `cluster_upgrade`: atualização de cluster. `cluster_migrate`: migração de cluster. `cluster_node_delete`: remoção de nó. `cluster_node_drain`: drenagem de nó. `cluster_modify`: modificação de cluster. `cluster_configuration_modify`: modificação nas configurações de controle do cluster. `cluster_addon_install`: instalação de componente. `cluster_addon_upgrade`: atualização de componente. `cluster_addon_uninstall`: desinstalação de componente. `runtime_upgrade`: atualização de runtime. `nodepool_upgrade`: atualização de pool de nós. `nodepool_update`: atualização de pool de nós.
page_size	Long	Não	50	Número de entradas retornadas por página.
page_number	Long	Não	1	Número da página a retornar.

Sintaxe da resposta

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

{
  "events" : [ {
    "event_id" : "String",
    "type" : "String",
    "source" : "String",
    "subject" : "String",
    "time" : "String",
    "cluster_id" : "String",
    "data" : {
      "level" : "String",
      "reason" : "String",
      "message" : "String"
    }
  } ],
  "page_info" : {
    "page_size" : Long,
    "page_number" : Long,
    "total_count" : Long
  }
}

Parâmetros da resposta

Tabela 2. Parâmetros do corpo da resposta
Parâmetro	Tipo	Exemplo	Descrição
events	Array of event		Detalhes do evento.
event_id	String	A234-1234-1234	ID do evento.
type	String	nodepool_upgrade	Tipo do evento. Valores válidos: `cluster_create`: criação de cluster. `cluster_scaleout`: expansão de cluster. `cluster_attach`: adição de nós existentes. `cluster_delete`: exclusão de cluster. `cluster_upgrade`: atualização de cluster. `cluster_migrate`: migração de cluster. `cluster_node_delete`: remoção de nó. `cluster_node_drain`: drenagem de nó. `cluster_modify`: modificação de cluster. `cluster_configuration_modify`: modificação nas configurações de controle do cluster. `cluster_addon_install`: instalação de componente. `cluster_addon_upgrade`: atualização de componente. `cluster_addon_uninstall`: desinstalação de componente. `runtime_upgrade`: atualização de runtime. `nodepool_upgrade`: atualização de pool de nós. `nodepool_update`: atualização de pool de nós.
source	String	/clusters/cf62854ac2130470897be7a27ed1f****/nodepools	source do evento.
subject	String	nodePool-id	Assunto do evento.
time	String	2022-11-23T20:48:01+08:00	Horário de início do evento.
cluster_id	String	cluster-id	ID do cluster.
data	object		Descrição do evento.
level	String	info	Nível do evento.
reason	String	Started	Estado do evento.
message	String	Start to upgrade NodePool nodePool/nodePool-A	Detalhes do evento.
page_info	object		Detalhes de paginação.
page_size	Long	50	Número de entradas retornadas por página.
page_number	Long	1	Número da página a retornar.
total_count	Long	3	Número total de entradas retornadas.

Exemplos

Exemplos de solicitações

GET /events?cluster_id=cf62854ac2130470897be7a27ed1f****&type=nodePool_upgrade&page_size=50&page_number=1 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

<events>
    <event_id>A234-1234-1234</event_id>
    <type>nodePool_upgrade</type>
    <source>/clusters/cf62854ac2130470897be7a27ed1f****/nodepools</source>
    <subject>nodePool-id</subject>
    <time>2020-12-01T17:31:00Z</time>
    <cluster_id>cluster-id</cluster_id>
    <data>
        <level>info</level>
        <reason>Started</reason>
        <message>Start to upgrade NodePool nodePool/nodePool-A</message>
    </data>
</events>
<page_info>
    <page_size>50</page_size>
    <page_number>1</page_number>
    <total_count>3</total_count>
</page_info>

Formato JSON

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

{
  "events" : [ {
    "event_id" : "A234-1234-1234",
    "type" : "nodePool_upgrade",
    "source" : "/clusters/cf62854ac2130470897be7a27ed1f****/nodepools",
    "subject" : "nodePool-id",
    "time" : "2020-12-01T17:31:00Z",
    "cluster_id" : "cluster-id",
    "data" : {
      "level" : "info",
      "reason" : "Started",
      "message" : "Start to upgrade NodePool nodePool/nodePool-A"
    }
  } ],
  "page_info" : {
    "page_size" : 50,
    "page_number" : 1,
    "total_count" : 3
  }
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.