Skip to content

ImageBuilder

Source code in docs_src/capo_appstream/types/image_builder.py
class ImageBuilder(TypedDict, closed=True):
    name: NotRequired["capo_appstream.types.string.String"]
    """<p>The name of the image builder.</p>"""
    arn: NotRequired["capo_appstream.types.arn.Arn"]
    """<p>The ARN for the image builder.</p>"""
    image_arn: NotRequired["capo_appstream.types.arn.Arn"]
    """<p>The ARN of the image from which this builder was created.</p>"""
    description: NotRequired["capo_appstream.types.string.String"]
    """<p>The description to display.</p>"""
    display_name: NotRequired["capo_appstream.types.string.String"]
    """<p>The image builder name to display.</p>"""
    vpc_config: NotRequired["capo_appstream.types.vpc_config.VpcConfig"]
    """<p>The VPC configuration of the image builder.</p>"""
    instance_type: NotRequired["capo_appstream.types.string.String"]
    """<p>The instance type for the image builder. The following instance types are available:</p> <ul> <li> <p>stream.standard.small</p> </li> <li> <p>stream.standard.medium</p> </li> <li> <p>stream.standard.large</p> </li> <li> <p>stream.compute.large</p> </li> <li> <p>stream.compute.xlarge</p> </li> <li> <p>stream.compute.2xlarge</p> </li> <li> <p>stream.compute.4xlarge</p> </li> <li> <p>stream.compute.8xlarge</p> </li> <li> <p>stream.memory.large</p> </li> <li> <p>stream.memory.xlarge</p> </li> <li> <p>stream.memory.2xlarge</p> </li> <li> <p>stream.memory.4xlarge</p> </li> <li> <p>stream.memory.8xlarge</p> </li> <li> <p>stream.memory.z1d.large</p> </li> <li> <p>stream.memory.z1d.xlarge</p> </li> <li> <p>stream.memory.z1d.2xlarge</p> </li> <li> <p>stream.memory.z1d.3xlarge</p> </li> <li> <p>stream.memory.z1d.6xlarge</p> </li> <li> <p>stream.memory.z1d.12xlarge</p> </li> <li> <p>stream.graphics.g4dn.xlarge</p> </li> <li> <p>stream.graphics.g4dn.2xlarge</p> </li> <li> <p>stream.graphics.g4dn.4xlarge</p> </li> <li> <p>stream.graphics.g4dn.8xlarge</p> </li> <li> <p>stream.graphics.g4dn.12xlarge</p> </li> <li> <p>stream.graphics.g4dn.16xlarge</p> </li> <li> <p>stream.graphics.g5.xlarge</p> </li> <li> <p>stream.graphics.g5.2xlarge</p> </li> <li> <p>stream.graphics.g5.4xlarge</p> </li> <li> <p>stream.graphics.g5.8xlarge</p> </li> <li> <p>stream.graphics.g5.16xlarge</p> </li> <li> <p>stream.graphics.g5.12xlarge</p> </li> <li> <p>stream.graphics.g5.24xlarge</p> </li> <li> <p>stream.graphics.g6.xlarge</p> </li> <li> <p>stream.graphics.g6.2xlarge</p> </li> <li> <p>stream.graphics.g6.4xlarge</p> </li> <li> <p>stream.graphics.g6.8xlarge</p> </li> <li> <p>stream.graphics.g6.16xlarge</p> </li> <li> <p>stream.graphics.g6.12xlarge</p> </li> <li> <p>stream.graphics.g6.24xlarge</p> </li> <li> <p>stream.graphics.gr6.4xlarge</p> </li> <li> <p>stream.graphics.gr6.8xlarge</p> </li> <li> <p>stream.graphics.g6f.large</p> </li> <li> <p>stream.graphics.g6f.xlarge</p> </li> <li> <p>stream.graphics.g6f.2xlarge</p> </li> <li> <p>stream.graphics.g6f.4xlarge</p> </li> <li> <p>stream.graphics.gr6f.4xlarge</p> </li> </ul>"""
    platform: NotRequired["capo_appstream.types.platform_type.PlatformType"]
    """<p>The operating system platform of the image builder.</p>"""
    iam_role_arn: NotRequired["capo_appstream.types.arn.Arn"]
    """<p>The ARN of the IAM role that is applied to the image builder. To assume a role, the image builder calls the AWS Security Token Service (STS) <code>AssumeRole</code> API operation and passes the ARN of the role to use. The operation creates a new session with temporary credentials. WorkSpaces Applications retrieves the temporary credentials and creates the <b>appstream_machine_role</b> credential profile on the instance.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/appstream2/latest/developerguide/using-iam-roles-to-grant-permissions-to-applications-scripts-streaming-instances.html">Using an IAM Role to Grant Permissions to Applications and Scripts Running on WorkSpaces Applications Streaming Instances</a> in the <i>Amazon WorkSpaces Applications Administration Guide</i>.</p>"""
    state: NotRequired["capo_appstream.types.image_builder_state.ImageBuilderState"]
    """<p>The state of the image builder.</p>"""
    state_change_reason: NotRequired[
        "capo_appstream.types.image_builder_state_change_reason.ImageBuilderStateChangeReason"
    ]
    """<p>The reason why the last state change occurred.</p>"""
    created_time: NotRequired["capo_appstream.types.timestamp.Timestamp"]
    """<p>The time stamp when the image builder was created.</p>"""
    enable_default_internet_access: NotRequired[
        "capo_appstream.types.boolean_object.BooleanObject"
    ]
    """<p>Enables or disables default internet access for the image builder.</p>"""
    domain_join_info: NotRequired[
        "capo_appstream.types.domain_join_info.DomainJoinInfo"
    ]
    """<p>The name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain. </p>"""
    network_access_configuration: NotRequired[
        "capo_appstream.types.network_access_configuration.NetworkAccessConfiguration"
    ]
    image_builder_errors: NotRequired[
        "capo_appstream.types.resource_errors.ResourceErrors"
    ]
    """<p>The image builder errors.</p>"""
    appstream_agent_version: NotRequired[
        "capo_appstream.types.appstream_agent_version.AppstreamAgentVersion"
    ]
    """<p>The version of the WorkSpaces Applications agent that is currently being used by the image builder. </p>"""
    access_endpoints: NotRequired[
        "capo_appstream.types.access_endpoint_list.AccessEndpointList"
    ]
    """<p>The list of virtual private cloud (VPC) interface endpoint objects. Administrators can connect to the image builder only through the specified endpoints.</p>"""
    root_volume_config: NotRequired["capo_appstream.types.volume_config.VolumeConfig"]
    """<p>The current configuration of the root volume for the image builder, including the storage size in GB.</p>"""
    latest_appstream_agent_version: NotRequired[
        "capo_appstream.types.latest_appstream_agent_version.LatestAppstreamAgentVersion"
    ]
    """<p>Indicates whether the image builder is using the latest WorkSpaces Applications agent version or not.</p>"""
    disable_imdsv1: NotRequired["capo_appstream.types.boolean_object.BooleanObject"]
    """<p>Indicates whether Instance Metadata Service Version 1 (IMDSv1) is disabled for the image builder.</p>"""

access_endpoints instance-attribute

access_endpoints: NotRequired[AccessEndpointList]

The list of virtual private cloud (VPC) interface endpoint objects. Administrators can connect to the image builder only through the specified endpoints.

appstream_agent_version instance-attribute

appstream_agent_version: NotRequired[AppstreamAgentVersion]

The version of the WorkSpaces Applications agent that is currently being used by the image builder.

arn instance-attribute

arn: NotRequired[Arn]

The ARN for the image builder.

created_time instance-attribute

created_time: NotRequired[Timestamp]

The time stamp when the image builder was created.

description instance-attribute

description: NotRequired[String]

The description to display.

disable_imdsv1 instance-attribute

disable_imdsv1: NotRequired[BooleanObject]

Indicates whether Instance Metadata Service Version 1 (IMDSv1) is disabled for the image builder.

display_name instance-attribute

display_name: NotRequired[String]

The image builder name to display.

domain_join_info instance-attribute

domain_join_info: NotRequired[DomainJoinInfo]

The name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain.

enable_default_internet_access instance-attribute

enable_default_internet_access: NotRequired[BooleanObject]

Enables or disables default internet access for the image builder.

iam_role_arn instance-attribute

iam_role_arn: NotRequired[Arn]

The ARN of the IAM role that is applied to the image builder. To assume a role, the image builder calls the AWS Security Token Service (STS) AssumeRole API operation and passes the ARN of the role to use. The operation creates a new session with temporary credentials. WorkSpaces Applications retrieves the temporary credentials and creates the appstream_machine_role credential profile on the instance.

For more information, see Using an IAM Role to Grant Permissions to Applications and Scripts Running on WorkSpaces Applications Streaming Instances in the Amazon WorkSpaces Applications Administration Guide.

image_arn instance-attribute

image_arn: NotRequired[Arn]

The ARN of the image from which this builder was created.

image_builder_errors instance-attribute

image_builder_errors: NotRequired[ResourceErrors]

The image builder errors.

instance_type instance-attribute

instance_type: NotRequired[String]

The instance type for the image builder. The following instance types are available:

  • stream.standard.small

  • stream.standard.medium

  • stream.standard.large

  • stream.compute.large

  • stream.compute.xlarge

  • stream.compute.2xlarge

  • stream.compute.4xlarge

  • stream.compute.8xlarge

  • stream.memory.large

  • stream.memory.xlarge

  • stream.memory.2xlarge

  • stream.memory.4xlarge

  • stream.memory.8xlarge

  • stream.memory.z1d.large

  • stream.memory.z1d.xlarge

  • stream.memory.z1d.2xlarge

  • stream.memory.z1d.3xlarge

  • stream.memory.z1d.6xlarge

  • stream.memory.z1d.12xlarge

  • stream.graphics.g4dn.xlarge

  • stream.graphics.g4dn.2xlarge

  • stream.graphics.g4dn.4xlarge

  • stream.graphics.g4dn.8xlarge

  • stream.graphics.g4dn.12xlarge

  • stream.graphics.g4dn.16xlarge

  • stream.graphics.g5.xlarge

  • stream.graphics.g5.2xlarge

  • stream.graphics.g5.4xlarge

  • stream.graphics.g5.8xlarge

  • stream.graphics.g5.16xlarge

  • stream.graphics.g5.12xlarge

  • stream.graphics.g5.24xlarge

  • stream.graphics.g6.xlarge

  • stream.graphics.g6.2xlarge

  • stream.graphics.g6.4xlarge

  • stream.graphics.g6.8xlarge

  • stream.graphics.g6.16xlarge

  • stream.graphics.g6.12xlarge

  • stream.graphics.g6.24xlarge

  • stream.graphics.gr6.4xlarge

  • stream.graphics.gr6.8xlarge

  • stream.graphics.g6f.large

  • stream.graphics.g6f.xlarge

  • stream.graphics.g6f.2xlarge

  • stream.graphics.g6f.4xlarge

  • stream.graphics.gr6f.4xlarge

latest_appstream_agent_version instance-attribute

latest_appstream_agent_version: NotRequired[LatestAppstreamAgentVersion]

Indicates whether the image builder is using the latest WorkSpaces Applications agent version or not.

name instance-attribute

name: NotRequired[String]

The name of the image builder.

network_access_configuration instance-attribute

network_access_configuration: NotRequired[NetworkAccessConfiguration]

platform instance-attribute

platform: NotRequired[PlatformType]

The operating system platform of the image builder.

root_volume_config instance-attribute

root_volume_config: NotRequired[VolumeConfig]

The current configuration of the root volume for the image builder, including the storage size in GB.

state instance-attribute

state: NotRequired[ImageBuilderState]

The state of the image builder.

state_change_reason instance-attribute

state_change_reason: NotRequired[ImageBuilderStateChangeReason]

The reason why the last state change occurred.

vpc_config instance-attribute

vpc_config: NotRequired[VpcConfig]

The VPC configuration of the image builder.