imagebuilder / Paginator / ListImageBuildVersions

ListImageBuildVersions¶

class imagebuilder.Paginator.ListImageBuildVersions¶

paginator = client.get_paginator('list_image_build_versions')

paginate(**kwargs)¶

Creates an iterator that will paginate through responses from imagebuilder.Client.list_image_build_versions().

Request Syntax

response_iterator = paginator.paginate(
    imageVersionArn='string',
    filters=[
        {
            'name': 'string',
            'values': [
                'string',
            ]
        },
    ],
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

imageVersionArn (string) –
[REQUIRED]

The Amazon Resource Name (ARN) of the image whose build versions you want to retrieve.
filters (list) –
Use the following filters to streamline results:
- name
- osVersion
- platform
- type
- version
- (dict) –
  
  A filter name and value pair that is used to return a more specific list of results from a list operation. Filters can be used to match a set of resources by specific criteria, such as tags, attributes, or IDs.
  - name (string) –
    
    The name of the filter. Filter names are case-sensitive.
  - values (list) –
    
    The filter values. Filter values are case-sensitive.
    - (string) –
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
- MaxItems (integer) –
  
  The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
- PageSize (integer) –
  
  The size of each page.
- StartingToken (string) –
  
  A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'requestId': 'string',
    'imageSummaryList': [
        {
            'arn': 'string',
            'name': 'string',
            'type': 'AMI'|'DOCKER',
            'version': 'string',
            'platform': 'Windows'|'Linux'|'macOS',
            'osVersion': 'string',
            'state': {
                'status': 'PENDING'|'CREATING'|'BUILDING'|'TESTING'|'DISTRIBUTING'|'INTEGRATING'|'AVAILABLE'|'CANCELLED'|'FAILED'|'DEPRECATED'|'DELETED'|'DISABLED',
                'reason': 'string'
            },
            'owner': 'string',
            'dateCreated': 'string',
            'outputResources': {
                'amis': [
                    {
                        'region': 'string',
                        'image': 'string',
                        'name': 'string',
                        'description': 'string',
                        'state': {
                            'status': 'PENDING'|'CREATING'|'BUILDING'|'TESTING'|'DISTRIBUTING'|'INTEGRATING'|'AVAILABLE'|'CANCELLED'|'FAILED'|'DEPRECATED'|'DELETED'|'DISABLED',
                            'reason': 'string'
                        },
                        'accountId': 'string'
                    },
                ],
                'containers': [
                    {
                        'region': 'string',
                        'imageUris': [
                            'string',
                        ]
                    },
                ]
            },
            'tags': {
                'string': 'string'
            },
            'buildType': 'USER_INITIATED'|'SCHEDULED'|'IMPORT'|'IMPORT_ISO',
            'imageSource': 'AMAZON_MANAGED'|'AWS_MARKETPLACE'|'IMPORTED'|'CUSTOM',
            'deprecationTime': datetime(2015, 1, 1),
            'lifecycleExecutionId': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) –
- requestId (string) –
  
  The request ID that uniquely identifies this request.
- imageSummaryList (list) –
  
  The list of image build versions.
  - (dict) –
    
    An image summary.
    - arn (string) –
      
      The Amazon Resource Name (ARN) of the image.
    - name (string) –
      
      The name of the image.
    - type (string) –
      
      Specifies whether this image produces an AMI or a container image.
    - version (string) –
      
      The version of the image.
    - platform (string) –
      
      The image operating system platform, such as Linux or Windows.
    - osVersion (string) –
      
      The operating system version of the instances that launch from this image. For example, Amazon Linux 2, Ubuntu 18, or Microsoft Windows Server 2019.
    - state (dict) –
      
      The state of the image.
      - status (string) –
        
        The status of the image.
      - reason (string) –
        
        The reason for the status of the image.
    - owner (string) –
      
      The owner of the image.
    - dateCreated (string) –
      
      The date on which Image Builder created this image.
    - outputResources (dict) –
      
      The output resources that Image Builder produced when it created this image.
      - amis (list) –
        
        The Amazon EC2 AMIs created by this image.
        
        (dict) –
        
        Details of an Amazon EC2 AMI.
        
        region (string) –
        
        The Amazon Web Services Region of the Amazon EC2 AMI.
        
        image (string) –
        
        The AMI ID of the Amazon EC2 AMI.
        
        name (string) –
        
        The name of the Amazon EC2 AMI.
        
        description (string) –
        
        The description of the Amazon EC2 AMI. Minimum and maximum length are in characters.
        
        state (dict) –
        
        Image status and the reason for that status.
        
        status (string) –
        
        The status of the image.
        
        reason (string) –
        
        The reason for the status of the image.
        
        accountId (string) –
        
        The account ID of the owner of the AMI.
      - containers (list) –
        
        Container images that the pipeline has generated and stored in the output repository.
        
        (dict) –
        
        A container encapsulates the runtime environment for an application.
        
        region (string) –
        
        Containers and container images are Region-specific. This is the Region context for the container.
        
        imageUris (list) –
        
        A list of URIs for containers created in the context Region.
        
        (string) –
    - tags (dict) –
      
      The tags that apply to this image.
      - (string) –
        
        (string) –
    - buildType (string) –
      
      Indicates the type of build that created this image. The build can be initiated in the following ways:
      - USER_INITIATED – A manual pipeline build request.
      - SCHEDULED – A pipeline build initiated by a cron expression in the Image Builder pipeline, or from EventBridge.
      - IMPORT – A VM import created the image to use as the base image for the recipe.
      - IMPORT_ISO – An ISO disk import created the image.
    - imageSource (string) –
      
      The origin of the base image that Image Builder used to build this image.
    - deprecationTime (datetime) –
      
      The time when deprecation occurs for an image resource. This can be a past or future date.
    - lifecycleExecutionId (string) –
      
      Identifies the last runtime instance of the lifecycle policy to take action on the image.
- NextToken (string) –
  
  A token to resume pagination.