image_ancestries

Creates, updates, deletes, gets or lists an image_ancestries resource.

Overview

Name	image_ancestries
Type	Resource
Id	aws.ec2.image_ancestries

Fields

The following fields are returned by SELECT queries:

get_image_ancestry

Name	Datatype	Description
image_ancestry_entries	string	A list of entries in the AMI ancestry chain, from the specified AMI to the root AMI.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_image_ancestry	select	ImageId, region	DryRun	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.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
ImageId	string	The ID of the AMI whose ancestry you want to trace.
region	string	AWS region (default: us-east-1)
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.

SELECT examples

get_image_ancestry

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.

SELECT
image_ancestry_entries
FROM aws.ec2.image_ancestries
WHERE ImageId = '{{ ImageId }}' -- required
AND region = '{{ region }}' -- required
AND DryRun = '{{ DryRun }}'
;