Skip to content

Create Export Image Task

appstream_create_export_image_task R Documentation

Creates a task to export a WorkSpaces Applications image to an EC2 AMI

Description

Creates a task to export a WorkSpaces Applications image to an EC2 AMI. This allows you to use your customized WorkSpaces Applications images with other AWS services or for backup purposes.

Usage

appstream_create_export_image_task(ImageName, AmiName, IamRoleArn,
  TagSpecifications, AmiDescription)

Arguments

ImageName

[required] The name of the WorkSpaces Applications image to export. The image must be in an available state and owned by your account.

AmiName

[required] The name for the exported EC2 AMI. This is a required field that must be unique within your account and region.

IamRoleArn

[required] The ARN of the IAM role that allows WorkSpaces Applications to create the AMI. The role must have permissions to copy images, describe images, and create tags, with a trust relationship allowing appstream.amazonaws.com to assume the role.

TagSpecifications

The tags to apply to the exported AMI. These tags help you organize and manage your EC2 AMIs.

AmiDescription

An optional description for the exported AMI. This description will be applied to the resulting EC2 AMI.

Value

A list with the following syntax:

list(
  ExportImageTask = list(
    TaskId = "string",
    ImageArn = "string",
    AmiName = "string",
    CreatedDate = as.POSIXct(
      "2015-01-01"
    ),
    AmiDescription = "string",
    State = "EXPORTING"|"COMPLETED"|"FAILED",
    AmiId = "string",
    TagSpecifications = list(
      "string"
    ),
    ErrorDetails = list(
      list(
        ErrorCode = "string",
        ErrorMessage = "string"
      )
    )
  )
)

Request syntax

svc$create_export_image_task(
  ImageName = "string",
  AmiName = "string",
  IamRoleArn = "string",
  TagSpecifications = list(
    "string"
  ),
  AmiDescription = "string"
)