本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# getImageStack活动
<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。  
类型：字符串。  
必需：是

**nextToken**  
用于获取下一组结果的令牌。  
类型：字符串  
必需：否

**region**  
图像所在 AWS 区域 的那个。  
类型：字符串  
必需：否

## 响应语法
<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**  
传递给生成此事件的操作的令牌。  
类型：字符串  
**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-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())
    },
    ...
  ]
}
```

------