As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# getClusterStackEventos
<a name="get-cluster-stack-events"></a>

Recupera os eventos que estão associados a uma pilha de um cluster.

**nota**  
A partir da versão 3.6.0, AWS ParallelCluster usa pilhas aninhadas para criar os recursos associados às filas e aos recursos computacionais. A API `GetClusterStackEvents` e o comando `pcluster get-cluster-stack-events` retornam apenas os eventos da pilha principal do cluster. Você pode visualizar os eventos da pilha de clusters, incluindo aqueles relacionados a filas e recursos computacionais, no console. CloudFormation 

**Topics**
+ [Sintaxe da solicitação](#get-cluster-stack-events-request)
+ [Corpo da solicitação](#get-cluster-stack-events-request-body)
+ [Sintaxe da resposta](#get-cluster-stack-events-response)
+ [Corpo da resposta](#get-cluster-stack-events-response-body)
+ [Exemplo](#get-cluster-stack-events-example)

## Sintaxe da solicitação
<a name="get-cluster-stack-events-request"></a>

```
GET /v3/clusters/{{{clusterName}}}/stackevents
{
  "nextToken": "string",
  "region": "string"
}
```

## Corpo da solicitação
<a name="get-cluster-stack-events-request-body"></a>

**clusterName**  
O nome do cluster.  
Tipo: string  
Obrigatório: Sim

**nextToken**  
O token para o próximo conjunto de resultados.  
Tipo: string  
Obrigatório: Não

**região**  
O em Região da AWS que o cluster está.  
Tipo: string  
Obrigatório: Não

## Sintaxe da resposta
<a name="get-cluster-stack-events-response"></a>

```
{
  "nextToken": "string",
  "events": [
    {
      "stackId": "string",
      "eventId": "string",
      "stackName": "string",
      "logicalResourceId": "string",
      "physicalResourceId": "string",
      "resourceType": "string",
      "timestamp": "2019-08-24T14:15:22Z",
      "resourceStatus": "CREATE_IN_PROGRESS",
      "resourceStatusReason": "string",
      "resourceProperties": "string",
      "clientRequestToken": "string"
    }
  ]
}
```

## Corpo da resposta
<a name="get-cluster-stack-events-response-body"></a>

**eventos**  
Lista de eventos filtrados.    
**clientRequestToken**  
O token passado para a ação que gerou esse evento.  
Tipo: string  
**eventId**  
O ID exclusivo desse evento.  
Tipo: string  
**logicalResourceId**  
O nome lógico do recurso, conforme definido no modelo.  
Tipo: string  
**physicalResourceId**  
O nome ou o identificador exclusivo que está associado à instância física do recurso.  
Tipo: string  
**resourceProperties**  
Um BLOB das propriedades usadas para criar o recurso.  
Tipo: string  
**resourceStatus**  
O status do recurso.  
Tipo: string  
Valores válidos: `CREATE_IN_PROGRESS | CREATE_FAILED | CREATE_COMPLETE | DELETE_IN_PROGRESS | DELETE_FAILED | DELETE_COMPLETE | DELETE_SKIPPED | UPDATE_IN_PROGRESS | UPDATE_FAILED | UPDATE_COMPLETE | IMPORT_FAILED | IMPORT_COMPLETE | IMPORT_IN_PROGRESS | IMPORT_ROLLBACK_IN_PROGRESS | IMPORT_ROLLBACK_FAILED | IMPORT_ROLLBACK_COMPLETE`  
**resourceStatusReason**  
Uma mensagem de sucesso ou falha associada ao recurso.  
Tipo: string  
**resourceType**  
O tipo de recurso.  
Tipo: string  
**stackId**  
O nome de ID exclusivo da instância da pilha.  
Tipo: string  
**stackName**  
O nome que está associado a uma pilha.  
Tipo: string  
**timestamp**  
A hora em que o status foi atualizado.  
Tipo: datetime

**nextToken**  
Um token que pode ser usado para recuperar o próximo conjunto de resultados ou `null` se não houver resultados adicionais.  
Tipo: string

## Exemplo
<a name="get-cluster-stack-events-example"></a>

------
#### [ Python ]

**Solicitação**

```
$ get_cluster_stack_events({{cluster_name_3x}})
```

**Resposta 200**

```
{
  "events": [
    {
      "event_id": "590b3820-b081-11ec-985e-0a7af5751497",
      "logical_resource_id": "cluster_name_3x",
      "physical_resource_id": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster_name_3x/11a59710-b080-11ec-b8bd-129def1380e9",
      "resource_status": "CREATE_COMPLETE",
      "resource_type": "AWS::CloudFormation::Stack",
      "stack_id": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster_name_3x/11a59710-b080-11ec-b8bd-129def1380e9",
      "stack_name": "cluster_name_3x",
      "timestamp": datetime.datetime(2022, 3, 30, 23, 30, 13, 268000, tzinfo=tzlocal())
    },
    ...
  ]
}
```

------