Skip to content

Distribute Image

imagebuilder_distribute_image R Documentation

DistributeImage distributes existing AMIs to additional regions and accounts without rebuilding the image

Description

DistributeImage distributes existing AMIs to additional regions and accounts without rebuilding the image.

Usage

imagebuilder_distribute_image(sourceImage, distributionConfigurationArn,
  executionRole, tags, clientToken, loggingConfiguration)

Arguments

sourceImage

[required] The source image Amazon Resource Name (ARN) to distribute.

distributionConfigurationArn

[required] The Amazon Resource Name (ARN) of the distribution configuration to use.

executionRole

[required] The IAM role to use for the distribution.

tags

The tags to apply to the distributed image.

clientToken

[required] Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see Ensuring idempotency in the Amazon EC2 API Reference.

loggingConfiguration

The logging configuration for the distribution.

Value

A list with the following syntax:

list(
  clientToken = "string",
  imageBuildVersionArn = "string"
)

Request syntax

svc$distribute_image(
  sourceImage = "string",
  distributionConfigurationArn = "string",
  executionRole = "string",
  tags = list(
    "string"
  ),
  clientToken = "string",
  loggingConfiguration = list(
    logGroupName = "string"
  )
)