Import Image

You can create WorkSpaces Applications images by importing your customized EC2 AMIs or WorkSpaces images. Here's how it works:

WorkSpaces Applications images created through EC2 AMI or WorkSpaces Windows Server image import are of type = "custom". WorkSpaces Windows BYOL images import will create WorkSpaces Applications images with type = "BYOL". WorkSpaces Applications provided images are of type = "native".

You can use stream.* instance types for images with type = "native" and type = "BYOL". To use any of the following instance types, you must import your AMI and create an image with type = "custom".

Prerequisites for EC2 AMI image import

All these prerequisites are important for a successful workflow execution. Supported EC2 AMI configurations and other mandatory requirements are listed below. Note these do not apply to importing WorkSpaces images, as that is managed by the WorkSpaces service.

Required AMI Properties

Operating System Properties

If you want to use image with graphics instances such as Accelerated.g4dn, Accelerated.g5, Accelerated.G6, or Accelerated.G6e you must install proper GRID driver on your AMI. For more details please refer to https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html. If the drivers are not setup correctly the streaming will work, however, graphics card may not be available.

IAM Role Requirements

{  
    "Version": "2012-10-17",  
    "Statement": [  
        {  
            "Sid": "AllowModifyImageAttributeWithTagCondition",  
            "Effect": "Allow",  
            "Action": "ec2:ModifyImageAttribute",  
            "Resource": "*"  
        },  
        {  
            "Sid": "AllowDescribeImages",  
            "Effect": "Allow",  
            "Action": "ec2:DescribeImages",  
            "Resource": "*"  
        }  
    ]  
}

Add the following trust relationship for this IAM role

{  
    "Version": "2012-10-17",  
    "Statement": [  
        {  
            "Effect": "Allow",  
            "Principal": {  
                "Service": "appstream.amazonaws.com"  
            },  
            "Action": "sts:AssumeRole"  
        }  
    ]  
}

Requirements for WorkSpaces image import

When importing an Amazon WorkSpaces image into WorkSpaces Applications, the following operating system and protocol requirements apply:

To import an image