本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

擷取與叢集堆疊相關聯的事件。

**注意**  
從 3.6.0 版開始， AWS ParallelCluster 會使用巢狀堆疊來建立與佇列和運算資源相關聯的資源。`GetClusterStackEvents` API 和 `pcluster get-cluster-stack-events`命令只會傳回叢集主要堆疊事件。您可以在 CloudFormation 主控台中檢視叢集堆疊事件，包括與佇列和運算資源相關的事件。

**Topics**
+ [請求語法](#get-cluster-stack-events-request)
+ [請求內文](#get-cluster-stack-events-request-body)
+ [回應語法](#get-cluster-stack-events-response)
+ [回應內文](#get-cluster-stack-events-response-body)
+ [範例](#get-cluster-stack-events-example)

## 請求語法
<a name="get-cluster-stack-events-request"></a>

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

## 請求內文
<a name="get-cluster-stack-events-request-body"></a>

**clusterName**  
叢集的名稱。  
類型：字串  
必要：是

**nextToken**  
下一組結果的字符。  
類型：字串  
必要：否

**region**  
 AWS 區域 叢集所在的 。  
類型：字串  
必要：否

## 回應語法
<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"
    }
  ]
}
```

## 回應內文
<a name="get-cluster-stack-events-response-body"></a>

**事件**  
篩選的事件清單。    
**clientRequestToken**  
權杖會傳遞至產生此事件的動作。  
類型：字串  
**eventId**  
此事件的唯一 ID。  
類型：字串  
**logicalResourceId**  
範本中指定資源的邏輯名稱。  
類型：字串  
**physicalResourceId**  
與資源實體執行個體相關聯的名稱或唯一識別符。  
類型：字串  
**resourceProperties**  
用來建立資源的屬性 BLOB。  
類型：字串  
**resourceStatus**  
資源狀態。  
類型：字串  
有效值：`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**  
與資源相關聯的成功或失敗訊息。  
類型：字串  
**resourceType**  
資源的類型。  
類型：字串  
**stackId**  
堆疊執行個體的唯一 ID 名稱。  
類型：字串  
**stackName**  
與堆疊相關聯的名稱。  
類型：字串  
**timestamp**  
狀態更新的時間。  
類型：日期時間

**nextToken**  
可用於擷取下一組結果的字符，或如果沒有其他結果則為 `null`。  
類型：字串

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

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

**請求**

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

**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())
    },
    ...
  ]
}
```

------