EC2 / Client / get_image_ancestry

get_image_ancestry¶

EC2.Client.get_image_ancestry(**kwargs)¶

Retrieves the ancestry chain of the specified AMI, tracing its lineage back to the root AMI. For more information, see AMI ancestry in Amazon EC2 User Guide.

Request Syntax

response = client.get_image_ancestry(
    ImageId='string',
    DryRun=True|False
)

Parameters:

ImageId (string) –
[REQUIRED]

The ID of the AMI whose ancestry you want to trace.
DryRun (boolean) – Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

Return type:

dict

Returns:

Response Syntax

{
    'ImageAncestryEntries': [
        {
            'CreationDate': datetime(2015, 1, 1),
            'ImageId': 'string',
            'ImageOwnerAlias': 'string',
            'SourceImageId': 'string',
            'SourceImageRegion': 'string'
        },
    ]
}

Response Structure

(dict) –
- ImageAncestryEntries (list) –
  
  A list of entries in the AMI ancestry chain, from the specified AMI to the root AMI.
  - (dict) –
    
    Information about a single AMI in the ancestry chain and its source (parent) AMI.
    - CreationDate (datetime) –
      
      The date and time when this AMI was created.
    - ImageId (string) –
      
      The ID of this AMI.
    - ImageOwnerAlias (string) –
      
      The owner alias ( amazon | aws-backup-vault | aws-marketplace ) of this AMI, if one is assigned. Otherwise, the value is null.
    - SourceImageId (string) –
      
      The ID of the parent AMI.
    - SourceImageRegion (string) –
      
      The Amazon Web Services Region of the parent AMI.