getImageStackEvents - Amazon ParallelCluster
Request syntaxRequest bodyResponse syntaxResponse bodyExample
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

getImageStackEvents

Retrieve the events that are associated with the stack for an image build.

Request syntax

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

Request body

imageId

The ID of the image.

Type: string

Required: Yes

nextToken

A token that's used for paginated requests.

Type: string

Required: No

region

The Amazon Web Services Region that the image is in.

Type: string

Required: No

Response syntax

{
  "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"
    }
  ]
}

Response body

events

A list of filtered events.

clientRequestToken

The token passed to the action that generated this event.

Type: string

eventId

The unique ID of this event.

Type: string

logicalResourceId

The logical name of the resource specified in the template.

Type: string

physicalResourceId

The name or unique identifier that's associated with the physical instance of the resource.

Type: string

resourceProperties

A BLOB of the properties that are used to create the resource.

Type: string

resourceStatus

The resource status.

Type: string

Valid values: 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

A success or failure message that's associated with the resource.

Type: string

resourceType

The type of resource.

Type: string

stackId

The unique ID name of the instance of the stack.

Type: string

stackName

The name that's associated with a stack.

Type: string

timestamp

The time when the status was updated.

Type: datetime

nextToken

A token that's used for paginated requests.

Type: string

Example

Python

Request

$ get_image_stack_events(image_id)

200 Response

{
  '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())
    },
    ...
  ]
}