ami#

Exec module for managing EC2 ami.

async idem_aws.exec.aws.ec2.ami.get(hub, ctx, name: str, resource_id: str = None, executable_users: List = None, owners: List = None, include_deprecated: bool = False, most_recent: bool = True, filters: List = None, tags: Dict[str, str] = None) → Dict[source]#

Get EC2 ami from AWS account.

Get a single ami from AWS. Set most_recent=True to return most recent image if more than one resource is found. Otherwise, the first resource returned from AWS will be used. The function returns None when no resource is found.

Parameters:

name (str) – The name of the Idem state.
resource_id (str, Optional) – Image id of the ami.
executable_users (list[str], Optional) – Scopes the images by users with explicit launch permissions. Specify an Amazon Web Services account ID, self (the sender of the request), or all (public AMIs).
owners (list[str], Optional) – Scopes the results to images with the specified owners. You can specify a combination of Amazon Web Services account IDs, self , amazon , and aws-marketplace. If you omit this parameter, the results include all images for which you have launch permissions, regardless of ownership.
include_deprecated (bool, Optional) – If true , all deprecated AMIs are included in the response. If false , no deprecated AMIs are included in the response. If no value is specified, the default value is false .
most_recent (bool, Optional) – If more than one result is returned, use the most recent AMI.
filters (list[str, str], Optional) – One or more filters: for example, tag :<key>, tag-key. A complete list of filters can be found at https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ec2.html#EC2.Client.describe_images
tags (dict[str, str], Optional) –
The dict of tags to filter by in the format {tag-key: tag-value} . For example, to find all resources that have a tag with the key “Owner” and the value “TeamA” , specify {Owner: TeamA}
- Key (str):
  The key name for the tag to be used to filter by.
- Value(str):
  The value associated with this tag to filter by.

Returns:

Returns ami in present format

Return type:

Dict[str, Any]

Examples

Calling this exec module function from the cli with filters

idem exec aws.ec2.ami.get name="my_resource" most_recent="True"  filters=[{'name': 'name', 'values': ['ami-name']}, {'name': 'virtualization-type', 'values': ['hvm']}]

Using in a state:

my_unmanaged_resource:
  exec.run:
    - path: aws.ec2.ami.get
    - kwargs:
        name: my_resource
        most_recent: True
        filters:
            - name: 'name'
              values: ["ami-name"]
            - name: 'virtualization-type'
              values: ["hvm"]

async idem_aws.exec.aws.ec2.ami.list_(hub, ctx, name: str = None, executable_users: List = None, owners: List = None, include_deprecated: bool = False, filters: List = None, tags: Dict[str, str] = None) → Dict[source]#

List EC2 ami from AWS account.

Fetch a list of ami from AWS. The function returns empty list when no resource is found.