기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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**  
클러스터의 이름입니다.  
유형: string  
필수 항목 여부: 예

**nextToken**  
다음 결과 집합에 대한 토큰입니다.  
유형: string  
필수 항목 여부: 아니요

**region**  
클러스터가 AWS 리전 있는 입니다.  
유형: string  
필수사항: 아니요

## 응답 구문
<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>

**events**  
필터링된 이벤트 목록입니다.    
**clientRequestToken**  
이 이벤트를 생성한 액션에 전달된 토큰입니다.  
유형: string  
**eventId**  
이 이벤트의 고유 ID입니다.  
유형: string  
**logicalResourceId**  
템플릿에 지정된 리소스의 논리명입니다.  
유형: string  
**physicalResourceId**  
리소스의 물리적 인스턴스와 연결된 이름 또는 고유 식별자입니다.  
유형: string  
**resourceProperties**  
리소스를 만드는 데 사용되는 속성의 BLOB입니다.  
유형: string  
**resourceStatus**  
리소스 상태입니다.  
유형: string  
유효값: `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**  
리소스와 관련된 성공 또는 실패 메시지입니다.  
유형: string  
**resourceType**  
리소스의 유형입니다.  
유형: string  
**stackId**  
스택 인스턴스의 고유 ID 이름입니다.  
유형: string  
**stackName**  
스택과 연결되어 있는 이름입니다.  
유형: string  
**타임스탬프**  
상태가 업데이트된 시간입니다.  
유형: 날짜/시간

**nextToken**  
다음 결과 집합을 가져오기 위해 사용할 수 있는 토큰이지만 결과가 더 이상 없는 경우에는 `null`입니다.  
유형: string

## 예제
<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())
    },
    ...
  ]
}
```

------