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

# getImageStackEvents
<a name="get-image-stack-events"></a>

이미지 빌드의 스택과 관련된 이벤트를 검색합니다.

**Topics**
+ [요청 구문](#get-image-stack-events-request)
+ [요청 본문](#get-image-stack-events-request-body)
+ [응답 구문](#get-image-stack-events-response)
+ [응답 본문](#get-image-stack-events-response-body)
+ [예제](#get-image-stack-events-example)

## 요청 구문
<a name="get-image-stack-events-request"></a>

```
GET /v3/images/custom/{{{imageId}}}/stackevents
{
  "nextToken": "string",
  "region": "string"
}
```

## 요청 본문
<a name="get-image-stack-events-request-body"></a>

**imageId**  
이미지의 ID입니다.  
유형: string  
필수 항목 여부: 예

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

**region**  
이미지가 AWS 리전 있는 입니다.  
유형: string  
필수사항: 아니요

## 응답 구문
<a name="get-image-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-image-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-image-stack-events-example"></a>

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

**요청**

```
$ get_image_stack_events({{image_id}})
```

**200 응답**

```
{
  'events': [
    {
      'event_id': 'ParallelClusterImage-CREATE_IN_PROGRESS-2022-03-30T23:26:33.499Z',
      'logical_resource_id': 'ParallelClusterImage',
      'physical_resource_id': 'arn:aws:imagebuilder:us-east-1:123456789012:image/parallelclusterimage-alinux2-image/3.2.1/1',
      'resource_properties': {
        "InfrastructureConfigurationArn":"arn:aws:imagebuilder:us-east-1:123456789012:infrastructure-configuration/parallelclusterimage-6accc570-b080-11ec-845e-0e2dc6386985",
        "ImageRecipeArn":"arn:aws:imagebuilder:us-east-1:123456789012:image-recipe/parallelclusterimage-alinux2-image/3.2.1",
        "DistributionConfigurationArn":"arn:aws:imagebuilder:us-east-1:123456789012:distribution-configuration/parallelclusterimage-6accc570-b080-11ec-845e-0e2dc6386985",
        "EnhancedImageMetadataEnabled":"false",
        "Tags": {
          "parallelcluster:image_name":"alinux2-image","parallelcluster:image_id":"alinux2-image"
        }
      },
      'resource_status': 'CREATE_IN_PROGRESS',
      'resource_status_reason': 'Resource creation Initiated',
      'resource_type': 'AWS::ImageBuilder::Image',
      'stack_id': 'arn:aws:cloudformation:us-east-1:123456789012:stack/alinux2-image/6accc570-b080-11ec-845e-0e2dc6386985',
      'stack_name': 'alinux2-image',
      'timestamp': datetime.datetime(2022, 3, 30, 23, 26, 33, 499000, tzinfo=tzlocal())
    },
    ...
  ]
}
```

------