Returns a list of image build versions¶

Description¶

Returns a list of image build versions.

Usage¶

imagebuilder_list_image_build_versions(imageVersionArn, filters,
  maxResults, nextToken)

Arguments¶

imageVersionArn

The Amazon Resource Name (ARN) of the image version whose build versions you want to retrieve. The ARN must specify an exact version (<major>.<minor>.<patch>) - wildcards aren't allowed. This parameter is optional. If you don't specify it, Image Builder returns build versions for all of the images in your account.
filters

Use the following filters to streamline results:
- name
- osVersion
- platform
- type
- version
maxResults

The maximum number of items to return in a single request.
nextToken

A token to specify where to start paginating. Use the nextToken value from a previously truncated response.

Value¶

A list with the following syntax:

list(
  requestId = "string",
  imageSummaryList = list(
    list(
      arn = "string",
      name = "string",
      type = "AMI"|"DOCKER",
      version = "string",
      platform = "Windows"|"Linux"|"macOS",
      osVersion = "string",
      state = list(
        status = "PENDING"|"CREATING"|"BUILDING"|"TESTING"|"DISTRIBUTING"|"INTEGRATING"|"AVAILABLE"|"CANCELLED"|"FAILED"|"DEPRECATED"|"DELETED"|"DISABLED",
        reason = "string",
        failureContext = list(
          imageStatus = "PENDING"|"CREATING"|"BUILDING"|"TESTING"|"DISTRIBUTING"|"INTEGRATING"|"AVAILABLE"|"CANCELLED"|"FAILED"|"DEPRECATED"|"DELETED"|"DISABLED",
          workflowExecutionId = "string",
          workflowArn = "string",
          stepExecutionId = "string",
          failedStep = "string",
          componentFailure = list(
            componentArn = "string",
            phaseName = "string",
            stepName = "string",
            action = "string",
            errorMessage = "string"
          ),
          distributionFailure = list(
            errorMessage = "string",
            regionFailures = list(
              list(
                region = "string",
                status = "FAILED"|"CANCELLED"|"TIMED_OUT",
                imageConfigurationStep = "ASSOCIATE_LICENSES"|"UPDATE_LAUNCH_TEMPLATES"|"PUT_SSM_PARAMETERS"|"UPDATE_FAST_LAUNCH_CONFIGURATIONS"|"EXPORT_AMI",
                errorMessage = "string",
                targetAccountId = "string"
              )
            )
          )
        )
      ),
      owner = "string",
      dateCreated = "string",
      outputResources = list(
        amis = list(
          list(
            region = "string",
            image = "string",
            name = "string",
            description = "string",
            state = list(
              status = "PENDING"|"CREATING"|"BUILDING"|"TESTING"|"DISTRIBUTING"|"INTEGRATING"|"AVAILABLE"|"CANCELLED"|"FAILED"|"DEPRECATED"|"DELETED"|"DISABLED",
              reason = "string",
              failureContext = list(
                imageStatus = "PENDING"|"CREATING"|"BUILDING"|"TESTING"|"DISTRIBUTING"|"INTEGRATING"|"AVAILABLE"|"CANCELLED"|"FAILED"|"DEPRECATED"|"DELETED"|"DISABLED",
                workflowExecutionId = "string",
                workflowArn = "string",
                stepExecutionId = "string",
                failedStep = "string",
                componentFailure = list(
                  componentArn = "string",
                  phaseName = "string",
                  stepName = "string",
                  action = "string",
                  errorMessage = "string"
                ),
                distributionFailure = list(
                  errorMessage = "string",
                  regionFailures = list(
                    list(
                      region = "string",
                      status = "FAILED"|"CANCELLED"|"TIMED_OUT",
                      imageConfigurationStep = "ASSOCIATE_LICENSES"|"UPDATE_LAUNCH_TEMPLATES"|"PUT_SSM_PARAMETERS"|"UPDATE_FAST_LAUNCH_CONFIGURATIONS"|"EXPORT_AMI",
                      errorMessage = "string",
                      targetAccountId = "string"
                    )
                  )
                )
              )
            ),
            accountId = "string"
          )
        ),
        containers = list(
          list(
            region = "string",
            imageUris = list(
              "string"
            )
          )
        )
      ),
      tags = list(
        "string"
      ),
      buildType = "USER_INITIATED"|"SCHEDULED"|"IMPORT"|"IMPORT_ISO",
      imageSource = "AMAZON_MANAGED"|"AWS_MARKETPLACE"|"IMPORTED"|"CUSTOM",
      deprecationTime = as.POSIXct(
        "2015-01-01"
      ),
      lifecycleExecutionId = "string",
      loggingConfiguration = list(
        logGroupName = "string"
      )
    )
  ),
  nextToken = "string"
)

Request syntax¶

svc$list_image_build_versions(
  imageVersionArn = "string",
  filters = list(
    list(
      name = "string",
      values = list(
        "string"
      )
    )
  ),
  maxResults = 123,
  nextToken = "string"
)