AWS API Changes

2025/11/10 - Amazon AppStream - 6 updated api methods

Changes AWS Appstream support for IPv6

CreateImageBuilder (updated)

Link ¶
Changes (response)

{'ImageBuilder': {'NetworkAccessConfiguration': {'EniIpv6Addresses': ['string']}}}

Creates an image builder. An image builder is a virtual machine that is used to create an image.

The initial state of the builder is PENDING. When it is ready, the state is RUNNING.

See also: AWS API Documentation

Request Syntax

client.create_image_builder(
    Name='string',
    ImageName='string',
    ImageArn='string',
    InstanceType='string',
    Description='string',
    DisplayName='string',
    VpcConfig={
        'SubnetIds': [
            'string',
        ],
        'SecurityGroupIds': [
            'string',
        ]
    },
    IamRoleArn='string',
    EnableDefaultInternetAccess=True|False,
    DomainJoinInfo={
        'DirectoryName': 'string',
        'OrganizationalUnitDistinguishedName': 'string'
    },
    AppstreamAgentVersion='string',
    Tags={
        'string': 'string'
    },
    AccessEndpoints=[
        {
            'EndpointType': 'STREAMING',
            'VpceId': 'string'
        },
    ],
    SoftwaresToInstall=[
        'string',
    ],
    SoftwaresToUninstall=[
        'string',
    ]
)

type Name:

string

param Name:

[REQUIRED]

A unique name for the image builder.

type ImageName:

string

param ImageName:

The name of the image used to create the image builder.

type ImageArn:

string

param ImageArn:

The ARN of the public, private, or shared image to use.

type InstanceType:

string

param InstanceType:

[REQUIRED]

The instance type to use when launching 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-design.large
stream.graphics-design.xlarge
stream.graphics-design.2xlarge
stream.graphics-design.4xlarge
stream.graphics-desktop.2xlarge
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-pro.4xlarge
stream.graphics-pro.8xlarge
stream.graphics-pro.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

type Description:

string

param Description:

The description to display.

type DisplayName:

string

param DisplayName:

The image builder name to display.

type VpcConfig:

dict

param VpcConfig:

The VPC configuration for the image builder. You can specify only one subnet.

SubnetIds (list) --

The identifiers of the subnets to which a network interface is attached from the fleet instance or image builder instance. Fleet instances use one or more subnets. Image builder instances use one subnet.
- (string) --
SecurityGroupIds (list) --

The identifiers of the security groups for the fleet or image builder.
- (string) --

type IamRoleArn:

string

param IamRoleArn:

The Amazon Resource Name (ARN) of the IAM role to apply 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. AppStream 2.0 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 AppStream 2.0 Streaming Instances in the Amazon AppStream 2.0 Administration Guide.

type EnableDefaultInternetAccess:

boolean

param EnableDefaultInternetAccess:

Enables or disables default internet access for the image builder.

type DomainJoinInfo:

dict

param DomainJoinInfo:

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

DirectoryName (string) --

The fully qualified name of the directory (for example, corp.example.com).
OrganizationalUnitDistinguishedName (string) --

The distinguished name of the organizational unit for computer accounts.

type AppstreamAgentVersion:

string

param AppstreamAgentVersion:

The version of the AppStream 2.0 agent to use for this image builder. To use the latest version of the AppStream 2.0 agent, specify [LATEST].

type Tags:

dict

param Tags:

The tags to associate with the image builder. A tag is a key-value pair, and the value is optional. For example, Environment=Test. If you do not specify a value, Environment=.

Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following special characters:

_ . : / = + - @

If you do not specify a value, the value is set to an empty string.

For more information about tags, see Tagging Your Resources in the Amazon AppStream 2.0 Administration Guide.

(string) --
- (string) --

type AccessEndpoints:

list

param AccessEndpoints:

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

(dict) --

Describes an interface VPC endpoint (interface endpoint) that lets you create a private connection between the virtual private cloud (VPC) that you specify and AppStream 2.0. When you specify an interface endpoint for a stack, users of the stack can connect to AppStream 2.0 only through that endpoint. When you specify an interface endpoint for an image builder, administrators can connect to the image builder only through that endpoint.
- EndpointType (string) -- [REQUIRED]
  
  The type of interface endpoint.
- VpceId (string) --
  
  The identifier (ID) of the VPC in which the interface endpoint is used.

type SoftwaresToInstall:

list

param SoftwaresToInstall:

The list of license included applications to install on the image builder during creation.

Possible values include the following:

Microsoft_Office_2021_LTSC_Professional_Plus_32Bit
Microsoft_Office_2021_LTSC_Professional_Plus_64Bit
Microsoft_Office_2024_LTSC_Professional_Plus_32Bit
Microsoft_Office_2024_LTSC_Professional_Plus_64Bit
Microsoft_Visio_2021_LTSC_Professional_32Bit
Microsoft_Visio_2021_LTSC_Professional_64Bit
Microsoft_Visio_2024_LTSC_Professional_32Bit
Microsoft_Visio_2024_LTSC_Professional_64Bit
Microsoft_Project_2021_Professional_32Bit
Microsoft_Project_2021_Professional_64Bit
Microsoft_Project_2024_Professional_32Bit
Microsoft_Project_2024_Professional_64Bit
Microsoft_Office_2021_LTSC_Standard_32Bit
Microsoft_Office_2021_LTSC_Standard_64Bit
Microsoft_Office_2024_LTSC_Standard_32Bit
Microsoft_Office_2024_LTSC_Standard_64Bit
Microsoft_Visio_2021_LTSC_Standard_32Bit
Microsoft_Visio_2021_LTSC_Standard_64Bit
Microsoft_Visio_2024_LTSC_Standard_32Bit
Microsoft_Visio_2024_LTSC_Standard_64Bit
Microsoft_Project_2021_Standard_32Bit
Microsoft_Project_2021_Standard_64Bit
Microsoft_Project_2024_Standard_32Bit
Microsoft_Project_2024_Standard_64Bit

(string) --

type SoftwaresToUninstall:

list

param SoftwaresToUninstall:

The list of license included applications to uninstall from the image builder during creation.

Possible values include the following:

Microsoft_Office_2021_LTSC_Professional_Plus_32Bit
Microsoft_Office_2021_LTSC_Professional_Plus_64Bit
Microsoft_Office_2024_LTSC_Professional_Plus_32Bit
Microsoft_Office_2024_LTSC_Professional_Plus_64Bit
Microsoft_Visio_2021_LTSC_Professional_32Bit
Microsoft_Visio_2021_LTSC_Professional_64Bit
Microsoft_Visio_2024_LTSC_Professional_32Bit
Microsoft_Visio_2024_LTSC_Professional_64Bit
Microsoft_Project_2021_Professional_32Bit
Microsoft_Project_2021_Professional_64Bit
Microsoft_Project_2024_Professional_32Bit
Microsoft_Project_2024_Professional_64Bit
Microsoft_Office_2021_LTSC_Standard_32Bit
Microsoft_Office_2021_LTSC_Standard_64Bit
Microsoft_Office_2024_LTSC_Standard_32Bit
Microsoft_Office_2024_LTSC_Standard_64Bit
Microsoft_Visio_2021_LTSC_Standard_32Bit
Microsoft_Visio_2021_LTSC_Standard_64Bit
Microsoft_Visio_2024_LTSC_Standard_32Bit
Microsoft_Visio_2024_LTSC_Standard_64Bit
Microsoft_Project_2021_Standard_32Bit
Microsoft_Project_2021_Standard_64Bit
Microsoft_Project_2024_Standard_32Bit
Microsoft_Project_2024_Standard_64Bit

(string) --

rtype:

dict

returns:

Response Syntax

{
    'ImageBuilder': {
        'Name': 'string',
        'Arn': 'string',
        'ImageArn': 'string',
        'Description': 'string',
        'DisplayName': 'string',
        'VpcConfig': {
            'SubnetIds': [
                'string',
            ],
            'SecurityGroupIds': [
                'string',
            ]
        },
        'InstanceType': 'string',
        'Platform': 'WINDOWS'|'WINDOWS_SERVER_2016'|'WINDOWS_SERVER_2019'|'WINDOWS_SERVER_2022'|'AMAZON_LINUX2'|'RHEL8'|'ROCKY_LINUX8',
        'IamRoleArn': 'string',
        'State': 'PENDING'|'UPDATING_AGENT'|'RUNNING'|'STOPPING'|'STOPPED'|'REBOOTING'|'SNAPSHOTTING'|'DELETING'|'FAILED'|'UPDATING'|'PENDING_QUALIFICATION'|'PENDING_SYNCING_APPS'|'SYNCING_APPS',
        'StateChangeReason': {
            'Code': 'INTERNAL_ERROR'|'IMAGE_UNAVAILABLE',
            'Message': 'string'
        },
        'CreatedTime': datetime(2015, 1, 1),
        'EnableDefaultInternetAccess': True|False,
        'DomainJoinInfo': {
            'DirectoryName': 'string',
            'OrganizationalUnitDistinguishedName': 'string'
        },
        'NetworkAccessConfiguration': {
            'EniPrivateIpAddress': 'string',
            'EniIpv6Addresses': [
                'string',
            ],
            'EniId': 'string'
        },
        'ImageBuilderErrors': [
            {
                'ErrorCode': 'IAM_SERVICE_ROLE_MISSING_ENI_DESCRIBE_ACTION'|'IAM_SERVICE_ROLE_MISSING_ENI_CREATE_ACTION'|'IAM_SERVICE_ROLE_MISSING_ENI_DELETE_ACTION'|'NETWORK_INTERFACE_LIMIT_EXCEEDED'|'INTERNAL_SERVICE_ERROR'|'IAM_SERVICE_ROLE_IS_MISSING'|'MACHINE_ROLE_IS_MISSING'|'STS_DISABLED_IN_REGION'|'SUBNET_HAS_INSUFFICIENT_IP_ADDRESSES'|'IAM_SERVICE_ROLE_MISSING_DESCRIBE_SUBNET_ACTION'|'SUBNET_NOT_FOUND'|'IMAGE_NOT_FOUND'|'INVALID_SUBNET_CONFIGURATION'|'SECURITY_GROUPS_NOT_FOUND'|'IGW_NOT_ATTACHED'|'IAM_SERVICE_ROLE_MISSING_DESCRIBE_SECURITY_GROUPS_ACTION'|'FLEET_STOPPED'|'FLEET_INSTANCE_PROVISIONING_FAILURE'|'DOMAIN_JOIN_ERROR_FILE_NOT_FOUND'|'DOMAIN_JOIN_ERROR_ACCESS_DENIED'|'DOMAIN_JOIN_ERROR_LOGON_FAILURE'|'DOMAIN_JOIN_ERROR_INVALID_PARAMETER'|'DOMAIN_JOIN_ERROR_MORE_DATA'|'DOMAIN_JOIN_ERROR_NO_SUCH_DOMAIN'|'DOMAIN_JOIN_ERROR_NOT_SUPPORTED'|'DOMAIN_JOIN_NERR_INVALID_WORKGROUP_NAME'|'DOMAIN_JOIN_NERR_WORKSTATION_NOT_STARTED'|'DOMAIN_JOIN_ERROR_DS_MACHINE_ACCOUNT_QUOTA_EXCEEDED'|'DOMAIN_JOIN_NERR_PASSWORD_EXPIRED'|'DOMAIN_JOIN_INTERNAL_SERVICE_ERROR',
                'ErrorMessage': 'string',
                'ErrorTimestamp': datetime(2015, 1, 1)
            },
        ],
        'AppstreamAgentVersion': 'string',
        'AccessEndpoints': [
            {
                'EndpointType': 'STREAMING',
                'VpceId': 'string'
            },
        ],
        'LatestAppstreamAgentVersion': 'TRUE'|'FALSE'
    }
}

Response Structure

(dict) --
- ImageBuilder (dict) --
  
  Information about the image builder.
  - Name (string) --
    
    The name of the image builder.
  - Arn (string) --
    
    The ARN for the image builder.
  - ImageArn (string) --
    
    The ARN of the image from which this builder was created.
  - Description (string) --
    
    The description to display.
  - DisplayName (string) --
    
    The image builder name to display.
  - VpcConfig (dict) --
    
    The VPC configuration of the image builder.
    - SubnetIds (list) --
      
      The identifiers of the subnets to which a network interface is attached from the fleet instance or image builder instance. Fleet instances use one or more subnets. Image builder instances use one subnet.
      - (string) --
    - SecurityGroupIds (list) --
      
      The identifiers of the security groups for the fleet or image builder.
      - (string) --
  - InstanceType (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-design.large
    - stream.graphics-design.xlarge
    - stream.graphics-design.2xlarge
    - stream.graphics-design.4xlarge
    - stream.graphics-desktop.2xlarge
    - 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-pro.4xlarge
    - stream.graphics-pro.8xlarge
    - stream.graphics-pro.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
  - Platform (string) --
    
    The operating system platform of the image builder.
  - IamRoleArn (string) --
    
    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. AppStream 2.0 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 AppStream 2.0 Streaming Instances in the Amazon AppStream 2.0 Administration Guide.
  - State (string) --
    
    The state of the image builder.
  - StateChangeReason (dict) --
    
    The reason why the last state change occurred.
    - Code (string) --
      
      The state change reason code.
    - Message (string) --
      
      The state change reason message.
  - CreatedTime (datetime) --
    
    The time stamp when the image builder was created.
  - EnableDefaultInternetAccess (boolean) --
    
    Enables or disables default internet access for the image builder.
  - DomainJoinInfo (dict) --
    
    The name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain.
    - DirectoryName (string) --
      
      The fully qualified name of the directory (for example, corp.example.com).
    - OrganizationalUnitDistinguishedName (string) --
      
      The distinguished name of the organizational unit for computer accounts.
  - NetworkAccessConfiguration (dict) --
    
    Describes the network details of the fleet or image builder instance.
    - EniPrivateIpAddress (string) --
      
      The private IP address of the elastic network interface that is attached to instances in your VPC.
    - EniIpv6Addresses (list) --
      
      The IPv6 addresses of the elastic network interface that is attached to instances in your VPC.
      - (string) --
    - EniId (string) --
      
      The resource identifier of the elastic network interface that is attached to instances in your VPC. All network interfaces have the eni-xxxxxxxx resource identifier.
  - ImageBuilderErrors (list) --
    
    The image builder errors.
    - (dict) --
      
      Describes a resource error.
      - ErrorCode (string) --
        
        The error code.
      - ErrorMessage (string) --
        
        The error message.
      - ErrorTimestamp (datetime) --
        
        The time the error occurred.
  - AppstreamAgentVersion (string) --
    
    The version of the AppStream 2.0 agent that is currently being used by the image builder.
  - AccessEndpoints (list) --
    
    The list of virtual private cloud (VPC) interface endpoint objects. Administrators can connect to the image builder only through the specified endpoints.
    - (dict) --
      
      Describes an interface VPC endpoint (interface endpoint) that lets you create a private connection between the virtual private cloud (VPC) that you specify and AppStream 2.0. When you specify an interface endpoint for a stack, users of the stack can connect to AppStream 2.0 only through that endpoint. When you specify an interface endpoint for an image builder, administrators can connect to the image builder only through that endpoint.
      - EndpointType (string) --
        
        The type of interface endpoint.
      - VpceId (string) --
        
        The identifier (ID) of the VPC in which the interface endpoint is used.
  - LatestAppstreamAgentVersion (string) --
    
    Indicates whether the image builder is using the latest AppStream 2.0 agent version or not.

DeleteImageBuilder (updated)

Link ¶
Changes (response)

{'ImageBuilder': {'NetworkAccessConfiguration': {'EniIpv6Addresses': ['string']}}}

Deletes the specified image builder and releases the capacity.

See also: AWS API Documentation

Request Syntax

client.delete_image_builder(
    Name='string'
)

type Name:

string

param Name:

[REQUIRED]

The name of the image builder.

rtype:

dict

returns:

Response Syntax

{
    'ImageBuilder': {
        'Name': 'string',
        'Arn': 'string',
        'ImageArn': 'string',
        'Description': 'string',
        'DisplayName': 'string',
        'VpcConfig': {
            'SubnetIds': [
                'string',
            ],
            'SecurityGroupIds': [
                'string',
            ]
        },
        'InstanceType': 'string',
        'Platform': 'WINDOWS'|'WINDOWS_SERVER_2016'|'WINDOWS_SERVER_2019'|'WINDOWS_SERVER_2022'|'AMAZON_LINUX2'|'RHEL8'|'ROCKY_LINUX8',
        'IamRoleArn': 'string',
        'State': 'PENDING'|'UPDATING_AGENT'|'RUNNING'|'STOPPING'|'STOPPED'|'REBOOTING'|'SNAPSHOTTING'|'DELETING'|'FAILED'|'UPDATING'|'PENDING_QUALIFICATION'|'PENDING_SYNCING_APPS'|'SYNCING_APPS',
        'StateChangeReason': {
            'Code': 'INTERNAL_ERROR'|'IMAGE_UNAVAILABLE',
            'Message': 'string'
        },
        'CreatedTime': datetime(2015, 1, 1),
        'EnableDefaultInternetAccess': True|False,
        'DomainJoinInfo': {
            'DirectoryName': 'string',
            'OrganizationalUnitDistinguishedName': 'string'
        },
        'NetworkAccessConfiguration': {
            'EniPrivateIpAddress': 'string',
            'EniIpv6Addresses': [
                'string',
            ],
            'EniId': 'string'
        },
        'ImageBuilderErrors': [
            {
                'ErrorCode': 'IAM_SERVICE_ROLE_MISSING_ENI_DESCRIBE_ACTION'|'IAM_SERVICE_ROLE_MISSING_ENI_CREATE_ACTION'|'IAM_SERVICE_ROLE_MISSING_ENI_DELETE_ACTION'|'NETWORK_INTERFACE_LIMIT_EXCEEDED'|'INTERNAL_SERVICE_ERROR'|'IAM_SERVICE_ROLE_IS_MISSING'|'MACHINE_ROLE_IS_MISSING'|'STS_DISABLED_IN_REGION'|'SUBNET_HAS_INSUFFICIENT_IP_ADDRESSES'|'IAM_SERVICE_ROLE_MISSING_DESCRIBE_SUBNET_ACTION'|'SUBNET_NOT_FOUND'|'IMAGE_NOT_FOUND'|'INVALID_SUBNET_CONFIGURATION'|'SECURITY_GROUPS_NOT_FOUND'|'IGW_NOT_ATTACHED'|'IAM_SERVICE_ROLE_MISSING_DESCRIBE_SECURITY_GROUPS_ACTION'|'FLEET_STOPPED'|'FLEET_INSTANCE_PROVISIONING_FAILURE'|'DOMAIN_JOIN_ERROR_FILE_NOT_FOUND'|'DOMAIN_JOIN_ERROR_ACCESS_DENIED'|'DOMAIN_JOIN_ERROR_LOGON_FAILURE'|'DOMAIN_JOIN_ERROR_INVALID_PARAMETER'|'DOMAIN_JOIN_ERROR_MORE_DATA'|'DOMAIN_JOIN_ERROR_NO_SUCH_DOMAIN'|'DOMAIN_JOIN_ERROR_NOT_SUPPORTED'|'DOMAIN_JOIN_NERR_INVALID_WORKGROUP_NAME'|'DOMAIN_JOIN_NERR_WORKSTATION_NOT_STARTED'|'DOMAIN_JOIN_ERROR_DS_MACHINE_ACCOUNT_QUOTA_EXCEEDED'|'DOMAIN_JOIN_NERR_PASSWORD_EXPIRED'|'DOMAIN_JOIN_INTERNAL_SERVICE_ERROR',
                'ErrorMessage': 'string',
                'ErrorTimestamp': datetime(2015, 1, 1)
            },
        ],
        'AppstreamAgentVersion': 'string',
        'AccessEndpoints': [
            {
                'EndpointType': 'STREAMING',
                'VpceId': 'string'
            },
        ],
        'LatestAppstreamAgentVersion': 'TRUE'|'FALSE'
    }
}

Response Structure

(dict) --
- ImageBuilder (dict) --
  
  Information about the image builder.
  - Name (string) --
    
    The name of the image builder.
  - Arn (string) --
    
    The ARN for the image builder.
  - ImageArn (string) --
    
    The ARN of the image from which this builder was created.
  - Description (string) --
    
    The description to display.
  - DisplayName (string) --
    
    The image builder name to display.
  - VpcConfig (dict) --
    
    The VPC configuration of the image builder.
    - SubnetIds (list) --
      
      The identifiers of the subnets to which a network interface is attached from the fleet instance or image builder instance. Fleet instances use one or more subnets. Image builder instances use one subnet.
      - (string) --
    - SecurityGroupIds (list) --
      
      The identifiers of the security groups for the fleet or image builder.
      - (string) --
  - InstanceType (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-design.large
    - stream.graphics-design.xlarge
    - stream.graphics-design.2xlarge
    - stream.graphics-design.4xlarge
    - stream.graphics-desktop.2xlarge
    - 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-pro.4xlarge
    - stream.graphics-pro.8xlarge
    - stream.graphics-pro.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
  - Platform (string) --
    
    The operating system platform of the image builder.
  - IamRoleArn (string) --
    
    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. AppStream 2.0 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 AppStream 2.0 Streaming Instances in the Amazon AppStream 2.0 Administration Guide.
  - State (string) --
    
    The state of the image builder.
  - StateChangeReason (dict) --
    
    The reason why the last state change occurred.
    - Code (string) --
      
      The state change reason code.
    - Message (string) --
      
      The state change reason message.
  - CreatedTime (datetime) --
    
    The time stamp when the image builder was created.
  - EnableDefaultInternetAccess (boolean) --
    
    Enables or disables default internet access for the image builder.
  - DomainJoinInfo (dict) --
    
    The name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain.
    - DirectoryName (string) --
      
      The fully qualified name of the directory (for example, corp.example.com).
    - OrganizationalUnitDistinguishedName (string) --
      
      The distinguished name of the organizational unit for computer accounts.
  - NetworkAccessConfiguration (dict) --
    
    Describes the network details of the fleet or image builder instance.
    - EniPrivateIpAddress (string) --
      
      The private IP address of the elastic network interface that is attached to instances in your VPC.
    - EniIpv6Addresses (list) --
      
      The IPv6 addresses of the elastic network interface that is attached to instances in your VPC.
      - (string) --
    - EniId (string) --
      
      The resource identifier of the elastic network interface that is attached to instances in your VPC. All network interfaces have the eni-xxxxxxxx resource identifier.
  - ImageBuilderErrors (list) --
    
    The image builder errors.
    - (dict) --
      
      Describes a resource error.
      - ErrorCode (string) --
        
        The error code.
      - ErrorMessage (string) --
        
        The error message.
      - ErrorTimestamp (datetime) --
        
        The time the error occurred.
  - AppstreamAgentVersion (string) --
    
    The version of the AppStream 2.0 agent that is currently being used by the image builder.
  - AccessEndpoints (list) --
    
    The list of virtual private cloud (VPC) interface endpoint objects. Administrators can connect to the image builder only through the specified endpoints.
    - (dict) --
      
      Describes an interface VPC endpoint (interface endpoint) that lets you create a private connection between the virtual private cloud (VPC) that you specify and AppStream 2.0. When you specify an interface endpoint for a stack, users of the stack can connect to AppStream 2.0 only through that endpoint. When you specify an interface endpoint for an image builder, administrators can connect to the image builder only through that endpoint.
      - EndpointType (string) --
        
        The type of interface endpoint.
      - VpceId (string) --
        
        The identifier (ID) of the VPC in which the interface endpoint is used.
  - LatestAppstreamAgentVersion (string) --
    
    Indicates whether the image builder is using the latest AppStream 2.0 agent version or not.

DescribeImageBuilders (updated)

Link ¶
Changes (response)

{'ImageBuilders': {'NetworkAccessConfiguration': {'EniIpv6Addresses': ['string']}}}

Retrieves a list that describes one or more specified image builders, if the image builder names are provided. Otherwise, all image builders in the account are described.

See also: AWS API Documentation

Request Syntax

client.describe_image_builders(
    Names=[
        'string',
    ],
    MaxResults=123,
    NextToken='string'
)

type Names:

list

param Names:

The names of the image builders to describe.

(string) --

type MaxResults:

integer

param MaxResults:

The maximum size of each page of results.

type NextToken:

string

param NextToken:

The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.

rtype:

dict

returns:

Response Syntax

{
    'ImageBuilders': [
        {
            'Name': 'string',
            'Arn': 'string',
            'ImageArn': 'string',
            'Description': 'string',
            'DisplayName': 'string',
            'VpcConfig': {
                'SubnetIds': [
                    'string',
                ],
                'SecurityGroupIds': [
                    'string',
                ]
            },
            'InstanceType': 'string',
            'Platform': 'WINDOWS'|'WINDOWS_SERVER_2016'|'WINDOWS_SERVER_2019'|'WINDOWS_SERVER_2022'|'AMAZON_LINUX2'|'RHEL8'|'ROCKY_LINUX8',
            'IamRoleArn': 'string',
            'State': 'PENDING'|'UPDATING_AGENT'|'RUNNING'|'STOPPING'|'STOPPED'|'REBOOTING'|'SNAPSHOTTING'|'DELETING'|'FAILED'|'UPDATING'|'PENDING_QUALIFICATION'|'PENDING_SYNCING_APPS'|'SYNCING_APPS',
            'StateChangeReason': {
                'Code': 'INTERNAL_ERROR'|'IMAGE_UNAVAILABLE',
                'Message': 'string'
            },
            'CreatedTime': datetime(2015, 1, 1),
            'EnableDefaultInternetAccess': True|False,
            'DomainJoinInfo': {
                'DirectoryName': 'string',
                'OrganizationalUnitDistinguishedName': 'string'
            },
            'NetworkAccessConfiguration': {
                'EniPrivateIpAddress': 'string',
                'EniIpv6Addresses': [
                    'string',
                ],
                'EniId': 'string'
            },
            'ImageBuilderErrors': [
                {
                    'ErrorCode': 'IAM_SERVICE_ROLE_MISSING_ENI_DESCRIBE_ACTION'|'IAM_SERVICE_ROLE_MISSING_ENI_CREATE_ACTION'|'IAM_SERVICE_ROLE_MISSING_ENI_DELETE_ACTION'|'NETWORK_INTERFACE_LIMIT_EXCEEDED'|'INTERNAL_SERVICE_ERROR'|'IAM_SERVICE_ROLE_IS_MISSING'|'MACHINE_ROLE_IS_MISSING'|'STS_DISABLED_IN_REGION'|'SUBNET_HAS_INSUFFICIENT_IP_ADDRESSES'|'IAM_SERVICE_ROLE_MISSING_DESCRIBE_SUBNET_ACTION'|'SUBNET_NOT_FOUND'|'IMAGE_NOT_FOUND'|'INVALID_SUBNET_CONFIGURATION'|'SECURITY_GROUPS_NOT_FOUND'|'IGW_NOT_ATTACHED'|'IAM_SERVICE_ROLE_MISSING_DESCRIBE_SECURITY_GROUPS_ACTION'|'FLEET_STOPPED'|'FLEET_INSTANCE_PROVISIONING_FAILURE'|'DOMAIN_JOIN_ERROR_FILE_NOT_FOUND'|'DOMAIN_JOIN_ERROR_ACCESS_DENIED'|'DOMAIN_JOIN_ERROR_LOGON_FAILURE'|'DOMAIN_JOIN_ERROR_INVALID_PARAMETER'|'DOMAIN_JOIN_ERROR_MORE_DATA'|'DOMAIN_JOIN_ERROR_NO_SUCH_DOMAIN'|'DOMAIN_JOIN_ERROR_NOT_SUPPORTED'|'DOMAIN_JOIN_NERR_INVALID_WORKGROUP_NAME'|'DOMAIN_JOIN_NERR_WORKSTATION_NOT_STARTED'|'DOMAIN_JOIN_ERROR_DS_MACHINE_ACCOUNT_QUOTA_EXCEEDED'|'DOMAIN_JOIN_NERR_PASSWORD_EXPIRED'|'DOMAIN_JOIN_INTERNAL_SERVICE_ERROR',
                    'ErrorMessage': 'string',
                    'ErrorTimestamp': datetime(2015, 1, 1)
                },
            ],
            'AppstreamAgentVersion': 'string',
            'AccessEndpoints': [
                {
                    'EndpointType': 'STREAMING',
                    'VpceId': 'string'
                },
            ],
            'LatestAppstreamAgentVersion': 'TRUE'|'FALSE'
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) --
- ImageBuilders (list) --
  
  Information about the image builders.
  - (dict) --
    
    Describes a virtual machine that is used to create an image.
    - Name (string) --
      
      The name of the image builder.
    - Arn (string) --
      
      The ARN for the image builder.
    - ImageArn (string) --
      
      The ARN of the image from which this builder was created.
    - Description (string) --
      
      The description to display.
    - DisplayName (string) --
      
      The image builder name to display.
    - VpcConfig (dict) --
      
      The VPC configuration of the image builder.
      - SubnetIds (list) --
        
        The identifiers of the subnets to which a network interface is attached from the fleet instance or image builder instance. Fleet instances use one or more subnets. Image builder instances use one subnet.
        
        (string) --
      - SecurityGroupIds (list) --
        
        The identifiers of the security groups for the fleet or image builder.
        
        (string) --
    - InstanceType (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-design.large
      - stream.graphics-design.xlarge
      - stream.graphics-design.2xlarge
      - stream.graphics-design.4xlarge
      - stream.graphics-desktop.2xlarge
      - 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-pro.4xlarge
      - stream.graphics-pro.8xlarge
      - stream.graphics-pro.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
    - Platform (string) --
      
      The operating system platform of the image builder.
    - IamRoleArn (string) --
      
      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. AppStream 2.0 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 AppStream 2.0 Streaming Instances in the Amazon AppStream 2.0 Administration Guide.
    - State (string) --
      
      The state of the image builder.
    - StateChangeReason (dict) --
      
      The reason why the last state change occurred.
      - Code (string) --
        
        The state change reason code.
      - Message (string) --
        
        The state change reason message.
    - CreatedTime (datetime) --
      
      The time stamp when the image builder was created.
    - EnableDefaultInternetAccess (boolean) --
      
      Enables or disables default internet access for the image builder.
    - DomainJoinInfo (dict) --
      
      The name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain.
      - DirectoryName (string) --
        
        The fully qualified name of the directory (for example, corp.example.com).
      - OrganizationalUnitDistinguishedName (string) --
        
        The distinguished name of the organizational unit for computer accounts.
    - NetworkAccessConfiguration (dict) --
      
      Describes the network details of the fleet or image builder instance.
      - EniPrivateIpAddress (string) --
        
        The private IP address of the elastic network interface that is attached to instances in your VPC.
      - EniIpv6Addresses (list) --
        
        The IPv6 addresses of the elastic network interface that is attached to instances in your VPC.
        
        (string) --
      - EniId (string) --
        
        The resource identifier of the elastic network interface that is attached to instances in your VPC. All network interfaces have the eni-xxxxxxxx resource identifier.
    - ImageBuilderErrors (list) --
      
      The image builder errors.
      - (dict) --
        
        Describes a resource error.
        
        ErrorCode (string) --
        
        The error code.
        
        ErrorMessage (string) --
        
        The error message.
        
        ErrorTimestamp (datetime) --
        
        The time the error occurred.
    - AppstreamAgentVersion (string) --
      
      The version of the AppStream 2.0 agent that is currently being used by the image builder.
    - AccessEndpoints (list) --
      
      The list of virtual private cloud (VPC) interface endpoint objects. Administrators can connect to the image builder only through the specified endpoints.
      - (dict) --
        
        Describes an interface VPC endpoint (interface endpoint) that lets you create a private connection between the virtual private cloud (VPC) that you specify and AppStream 2.0. When you specify an interface endpoint for a stack, users of the stack can connect to AppStream 2.0 only through that endpoint. When you specify an interface endpoint for an image builder, administrators can connect to the image builder only through that endpoint.
        
        EndpointType (string) --
        
        The type of interface endpoint.
        
        VpceId (string) --
        
        The identifier (ID) of the VPC in which the interface endpoint is used.
    - LatestAppstreamAgentVersion (string) --
      
      Indicates whether the image builder is using the latest AppStream 2.0 agent version or not.
- NextToken (string) --
  
  The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

DescribeSessions (updated)

Link ¶
Changes (response)

{'Sessions': {'NetworkAccessConfiguration': {'EniIpv6Addresses': ['string']}}}

Retrieves a list that describes the streaming sessions for a specified stack and fleet. If a UserId is provided for the stack and fleet, only streaming sessions for that user are described. If an authentication type is not provided, the default is to authenticate users using a streaming URL.

See also: AWS API Documentation

Request Syntax

client.describe_sessions(
    StackName='string',
    FleetName='string',
    UserId='string',
    NextToken='string',
    Limit=123,
    AuthenticationType='API'|'SAML'|'USERPOOL'|'AWS_AD',
    InstanceId='string'
)

type StackName:

string

param StackName:

[REQUIRED]

The name of the stack. This value is case-sensitive.

type FleetName:

string

param FleetName:

[REQUIRED]

The name of the fleet. This value is case-sensitive.

type UserId:

string

param UserId:

The user identifier (ID). If you specify a user ID, you must also specify the authentication type.

type NextToken:

string

param NextToken:

The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.

type Limit:

integer

param Limit:

The size of each page of results. The default value is 20 and the maximum value is 50.

type AuthenticationType:

string

param AuthenticationType:

The authentication method. Specify API for a user authenticated using a streaming URL or SAML for a SAML federated user. The default is to authenticate users using a streaming URL.

type InstanceId:

string

param InstanceId:

The identifier for the instance hosting the session.

rtype:

dict

returns:

Response Syntax

{
    'Sessions': [
        {
            'Id': 'string',
            'UserId': 'string',
            'StackName': 'string',
            'FleetName': 'string',
            'State': 'ACTIVE'|'PENDING'|'EXPIRED',
            'ConnectionState': 'CONNECTED'|'NOT_CONNECTED',
            'StartTime': datetime(2015, 1, 1),
            'MaxExpirationTime': datetime(2015, 1, 1),
            'AuthenticationType': 'API'|'SAML'|'USERPOOL'|'AWS_AD',
            'NetworkAccessConfiguration': {
                'EniPrivateIpAddress': 'string',
                'EniIpv6Addresses': [
                    'string',
                ],
                'EniId': 'string'
            },
            'InstanceId': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) --
- Sessions (list) --
  
  Information about the streaming sessions.
  - (dict) --
    
    Describes a streaming session.
    - Id (string) --
      
      The identifier of the streaming session.
    - UserId (string) --
      
      The identifier of the user for whom the session was created.
    - StackName (string) --
      
      The name of the stack for the streaming session.
    - FleetName (string) --
      
      The name of the fleet for the streaming session.
    - State (string) --
      
      The current state of the streaming session.
    - ConnectionState (string) --
      
      Specifies whether a user is connected to the streaming session.
    - StartTime (datetime) --
      
      The time when a streaming instance is dedicated for the user.
    - MaxExpirationTime (datetime) --
      
      The time when the streaming session is set to expire. This time is based on the MaxUserDurationinSeconds value, which determines the maximum length of time that a streaming session can run. A streaming session might end earlier than the time specified in SessionMaxExpirationTime, when the DisconnectTimeOutInSeconds elapses or the user chooses to end his or her session. If the DisconnectTimeOutInSeconds elapses, or the user chooses to end his or her session, the streaming instance is terminated and the streaming session ends.
    - AuthenticationType (string) --
      
      The authentication method. The user is authenticated using a streaming URL ( API) or SAML 2.0 federation ( SAML).
    - NetworkAccessConfiguration (dict) --
      
      The network details for the streaming session.
      - EniPrivateIpAddress (string) --
        
        The private IP address of the elastic network interface that is attached to instances in your VPC.
      - EniIpv6Addresses (list) --
        
        The IPv6 addresses of the elastic network interface that is attached to instances in your VPC.
        
        (string) --
      - EniId (string) --
        
        The resource identifier of the elastic network interface that is attached to instances in your VPC. All network interfaces have the eni-xxxxxxxx resource identifier.
    - InstanceId (string) --
      
      The identifier for the instance hosting the session.
- NextToken (string) --
  
  The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

StartImageBuilder (updated)

Link ¶
Changes (response)

{'ImageBuilder': {'NetworkAccessConfiguration': {'EniIpv6Addresses': ['string']}}}

Starts the specified image builder.

See also: AWS API Documentation

Request Syntax

client.start_image_builder(
    Name='string',
    AppstreamAgentVersion='string'
)

type Name:

string

param Name:

[REQUIRED]

The name of the image builder.

type AppstreamAgentVersion:

string

param AppstreamAgentVersion:

The version of the AppStream 2.0 agent to use for this image builder. To use the latest version of the AppStream 2.0 agent, specify [LATEST].

rtype:

dict

returns:

Response Syntax

{
    'ImageBuilder': {
        'Name': 'string',
        'Arn': 'string',
        'ImageArn': 'string',
        'Description': 'string',
        'DisplayName': 'string',
        'VpcConfig': {
            'SubnetIds': [
                'string',
            ],
            'SecurityGroupIds': [
                'string',
            ]
        },
        'InstanceType': 'string',
        'Platform': 'WINDOWS'|'WINDOWS_SERVER_2016'|'WINDOWS_SERVER_2019'|'WINDOWS_SERVER_2022'|'AMAZON_LINUX2'|'RHEL8'|'ROCKY_LINUX8',
        'IamRoleArn': 'string',
        'State': 'PENDING'|'UPDATING_AGENT'|'RUNNING'|'STOPPING'|'STOPPED'|'REBOOTING'|'SNAPSHOTTING'|'DELETING'|'FAILED'|'UPDATING'|'PENDING_QUALIFICATION'|'PENDING_SYNCING_APPS'|'SYNCING_APPS',
        'StateChangeReason': {
            'Code': 'INTERNAL_ERROR'|'IMAGE_UNAVAILABLE',
            'Message': 'string'
        },
        'CreatedTime': datetime(2015, 1, 1),
        'EnableDefaultInternetAccess': True|False,
        'DomainJoinInfo': {
            'DirectoryName': 'string',
            'OrganizationalUnitDistinguishedName': 'string'
        },
        'NetworkAccessConfiguration': {
            'EniPrivateIpAddress': 'string',
            'EniIpv6Addresses': [
                'string',
            ],
            'EniId': 'string'
        },
        'ImageBuilderErrors': [
            {
                'ErrorCode': 'IAM_SERVICE_ROLE_MISSING_ENI_DESCRIBE_ACTION'|'IAM_SERVICE_ROLE_MISSING_ENI_CREATE_ACTION'|'IAM_SERVICE_ROLE_MISSING_ENI_DELETE_ACTION'|'NETWORK_INTERFACE_LIMIT_EXCEEDED'|'INTERNAL_SERVICE_ERROR'|'IAM_SERVICE_ROLE_IS_MISSING'|'MACHINE_ROLE_IS_MISSING'|'STS_DISABLED_IN_REGION'|'SUBNET_HAS_INSUFFICIENT_IP_ADDRESSES'|'IAM_SERVICE_ROLE_MISSING_DESCRIBE_SUBNET_ACTION'|'SUBNET_NOT_FOUND'|'IMAGE_NOT_FOUND'|'INVALID_SUBNET_CONFIGURATION'|'SECURITY_GROUPS_NOT_FOUND'|'IGW_NOT_ATTACHED'|'IAM_SERVICE_ROLE_MISSING_DESCRIBE_SECURITY_GROUPS_ACTION'|'FLEET_STOPPED'|'FLEET_INSTANCE_PROVISIONING_FAILURE'|'DOMAIN_JOIN_ERROR_FILE_NOT_FOUND'|'DOMAIN_JOIN_ERROR_ACCESS_DENIED'|'DOMAIN_JOIN_ERROR_LOGON_FAILURE'|'DOMAIN_JOIN_ERROR_INVALID_PARAMETER'|'DOMAIN_JOIN_ERROR_MORE_DATA'|'DOMAIN_JOIN_ERROR_NO_SUCH_DOMAIN'|'DOMAIN_JOIN_ERROR_NOT_SUPPORTED'|'DOMAIN_JOIN_NERR_INVALID_WORKGROUP_NAME'|'DOMAIN_JOIN_NERR_WORKSTATION_NOT_STARTED'|'DOMAIN_JOIN_ERROR_DS_MACHINE_ACCOUNT_QUOTA_EXCEEDED'|'DOMAIN_JOIN_NERR_PASSWORD_EXPIRED'|'DOMAIN_JOIN_INTERNAL_SERVICE_ERROR',
                'ErrorMessage': 'string',
                'ErrorTimestamp': datetime(2015, 1, 1)
            },
        ],
        'AppstreamAgentVersion': 'string',
        'AccessEndpoints': [
            {
                'EndpointType': 'STREAMING',
                'VpceId': 'string'
            },
        ],
        'LatestAppstreamAgentVersion': 'TRUE'|'FALSE'
    }
}

Response Structure

(dict) --
- ImageBuilder (dict) --
  
  Information about the image builder.
  - Name (string) --
    
    The name of the image builder.
  - Arn (string) --
    
    The ARN for the image builder.
  - ImageArn (string) --
    
    The ARN of the image from which this builder was created.
  - Description (string) --
    
    The description to display.
  - DisplayName (string) --
    
    The image builder name to display.
  - VpcConfig (dict) --
    
    The VPC configuration of the image builder.
    - SubnetIds (list) --
      
      The identifiers of the subnets to which a network interface is attached from the fleet instance or image builder instance. Fleet instances use one or more subnets. Image builder instances use one subnet.
      - (string) --
    - SecurityGroupIds (list) --
      
      The identifiers of the security groups for the fleet or image builder.
      - (string) --
  - InstanceType (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-design.large
    - stream.graphics-design.xlarge
    - stream.graphics-design.2xlarge
    - stream.graphics-design.4xlarge
    - stream.graphics-desktop.2xlarge
    - 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-pro.4xlarge
    - stream.graphics-pro.8xlarge
    - stream.graphics-pro.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
  - Platform (string) --
    
    The operating system platform of the image builder.
  - IamRoleArn (string) --
    
    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. AppStream 2.0 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 AppStream 2.0 Streaming Instances in the Amazon AppStream 2.0 Administration Guide.
  - State (string) --
    
    The state of the image builder.
  - StateChangeReason (dict) --
    
    The reason why the last state change occurred.
    - Code (string) --
      
      The state change reason code.
    - Message (string) --
      
      The state change reason message.
  - CreatedTime (datetime) --
    
    The time stamp when the image builder was created.
  - EnableDefaultInternetAccess (boolean) --
    
    Enables or disables default internet access for the image builder.
  - DomainJoinInfo (dict) --
    
    The name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain.
    - DirectoryName (string) --
      
      The fully qualified name of the directory (for example, corp.example.com).
    - OrganizationalUnitDistinguishedName (string) --
      
      The distinguished name of the organizational unit for computer accounts.
  - NetworkAccessConfiguration (dict) --
    
    Describes the network details of the fleet or image builder instance.
    - EniPrivateIpAddress (string) --
      
      The private IP address of the elastic network interface that is attached to instances in your VPC.
    - EniIpv6Addresses (list) --
      
      The IPv6 addresses of the elastic network interface that is attached to instances in your VPC.
      - (string) --
    - EniId (string) --
      
      The resource identifier of the elastic network interface that is attached to instances in your VPC. All network interfaces have the eni-xxxxxxxx resource identifier.
  - ImageBuilderErrors (list) --
    
    The image builder errors.
    - (dict) --
      
      Describes a resource error.
      - ErrorCode (string) --
        
        The error code.
      - ErrorMessage (string) --
        
        The error message.
      - ErrorTimestamp (datetime) --
        
        The time the error occurred.
  - AppstreamAgentVersion (string) --
    
    The version of the AppStream 2.0 agent that is currently being used by the image builder.
  - AccessEndpoints (list) --
    
    The list of virtual private cloud (VPC) interface endpoint objects. Administrators can connect to the image builder only through the specified endpoints.
    - (dict) --
      
      Describes an interface VPC endpoint (interface endpoint) that lets you create a private connection between the virtual private cloud (VPC) that you specify and AppStream 2.0. When you specify an interface endpoint for a stack, users of the stack can connect to AppStream 2.0 only through that endpoint. When you specify an interface endpoint for an image builder, administrators can connect to the image builder only through that endpoint.
      - EndpointType (string) --
        
        The type of interface endpoint.
      - VpceId (string) --
        
        The identifier (ID) of the VPC in which the interface endpoint is used.
  - LatestAppstreamAgentVersion (string) --
    
    Indicates whether the image builder is using the latest AppStream 2.0 agent version or not.

StopImageBuilder (updated)

Link ¶
Changes (response)

{'ImageBuilder': {'NetworkAccessConfiguration': {'EniIpv6Addresses': ['string']}}}

Stops the specified image builder.

See also: AWS API Documentation

Request Syntax

client.stop_image_builder(
    Name='string'
)

type Name:

string

param Name:

[REQUIRED]

The name of the image builder.

rtype:

dict

returns:

Response Syntax

{
    'ImageBuilder': {
        'Name': 'string',
        'Arn': 'string',
        'ImageArn': 'string',
        'Description': 'string',
        'DisplayName': 'string',
        'VpcConfig': {
            'SubnetIds': [
                'string',
            ],
            'SecurityGroupIds': [
                'string',
            ]
        },
        'InstanceType': 'string',
        'Platform': 'WINDOWS'|'WINDOWS_SERVER_2016'|'WINDOWS_SERVER_2019'|'WINDOWS_SERVER_2022'|'AMAZON_LINUX2'|'RHEL8'|'ROCKY_LINUX8',
        'IamRoleArn': 'string',
        'State': 'PENDING'|'UPDATING_AGENT'|'RUNNING'|'STOPPING'|'STOPPED'|'REBOOTING'|'SNAPSHOTTING'|'DELETING'|'FAILED'|'UPDATING'|'PENDING_QUALIFICATION'|'PENDING_SYNCING_APPS'|'SYNCING_APPS',
        'StateChangeReason': {
            'Code': 'INTERNAL_ERROR'|'IMAGE_UNAVAILABLE',
            'Message': 'string'
        },
        'CreatedTime': datetime(2015, 1, 1),
        'EnableDefaultInternetAccess': True|False,
        'DomainJoinInfo': {
            'DirectoryName': 'string',
            'OrganizationalUnitDistinguishedName': 'string'
        },
        'NetworkAccessConfiguration': {
            'EniPrivateIpAddress': 'string',
            'EniIpv6Addresses': [
                'string',
            ],
            'EniId': 'string'
        },
        'ImageBuilderErrors': [
            {
                'ErrorCode': 'IAM_SERVICE_ROLE_MISSING_ENI_DESCRIBE_ACTION'|'IAM_SERVICE_ROLE_MISSING_ENI_CREATE_ACTION'|'IAM_SERVICE_ROLE_MISSING_ENI_DELETE_ACTION'|'NETWORK_INTERFACE_LIMIT_EXCEEDED'|'INTERNAL_SERVICE_ERROR'|'IAM_SERVICE_ROLE_IS_MISSING'|'MACHINE_ROLE_IS_MISSING'|'STS_DISABLED_IN_REGION'|'SUBNET_HAS_INSUFFICIENT_IP_ADDRESSES'|'IAM_SERVICE_ROLE_MISSING_DESCRIBE_SUBNET_ACTION'|'SUBNET_NOT_FOUND'|'IMAGE_NOT_FOUND'|'INVALID_SUBNET_CONFIGURATION'|'SECURITY_GROUPS_NOT_FOUND'|'IGW_NOT_ATTACHED'|'IAM_SERVICE_ROLE_MISSING_DESCRIBE_SECURITY_GROUPS_ACTION'|'FLEET_STOPPED'|'FLEET_INSTANCE_PROVISIONING_FAILURE'|'DOMAIN_JOIN_ERROR_FILE_NOT_FOUND'|'DOMAIN_JOIN_ERROR_ACCESS_DENIED'|'DOMAIN_JOIN_ERROR_LOGON_FAILURE'|'DOMAIN_JOIN_ERROR_INVALID_PARAMETER'|'DOMAIN_JOIN_ERROR_MORE_DATA'|'DOMAIN_JOIN_ERROR_NO_SUCH_DOMAIN'|'DOMAIN_JOIN_ERROR_NOT_SUPPORTED'|'DOMAIN_JOIN_NERR_INVALID_WORKGROUP_NAME'|'DOMAIN_JOIN_NERR_WORKSTATION_NOT_STARTED'|'DOMAIN_JOIN_ERROR_DS_MACHINE_ACCOUNT_QUOTA_EXCEEDED'|'DOMAIN_JOIN_NERR_PASSWORD_EXPIRED'|'DOMAIN_JOIN_INTERNAL_SERVICE_ERROR',
                'ErrorMessage': 'string',
                'ErrorTimestamp': datetime(2015, 1, 1)
            },
        ],
        'AppstreamAgentVersion': 'string',
        'AccessEndpoints': [
            {
                'EndpointType': 'STREAMING',
                'VpceId': 'string'
            },
        ],
        'LatestAppstreamAgentVersion': 'TRUE'|'FALSE'
    }
}

Response Structure

(dict) --
- ImageBuilder (dict) --
  
  Information about the image builder.
  - Name (string) --
    
    The name of the image builder.
  - Arn (string) --
    
    The ARN for the image builder.
  - ImageArn (string) --
    
    The ARN of the image from which this builder was created.
  - Description (string) --
    
    The description to display.
  - DisplayName (string) --
    
    The image builder name to display.
  - VpcConfig (dict) --
    
    The VPC configuration of the image builder.
    - SubnetIds (list) --
      
      The identifiers of the subnets to which a network interface is attached from the fleet instance or image builder instance. Fleet instances use one or more subnets. Image builder instances use one subnet.
      - (string) --
    - SecurityGroupIds (list) --
      
      The identifiers of the security groups for the fleet or image builder.
      - (string) --
  - InstanceType (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-design.large
    - stream.graphics-design.xlarge
    - stream.graphics-design.2xlarge
    - stream.graphics-design.4xlarge
    - stream.graphics-desktop.2xlarge
    - 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-pro.4xlarge
    - stream.graphics-pro.8xlarge
    - stream.graphics-pro.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
  - Platform (string) --
    
    The operating system platform of the image builder.
  - IamRoleArn (string) --
    
    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. AppStream 2.0 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 AppStream 2.0 Streaming Instances in the Amazon AppStream 2.0 Administration Guide.
  - State (string) --
    
    The state of the image builder.
  - StateChangeReason (dict) --
    
    The reason why the last state change occurred.
    - Code (string) --
      
      The state change reason code.
    - Message (string) --
      
      The state change reason message.
  - CreatedTime (datetime) --
    
    The time stamp when the image builder was created.
  - EnableDefaultInternetAccess (boolean) --
    
    Enables or disables default internet access for the image builder.
  - DomainJoinInfo (dict) --
    
    The name of the directory and organizational unit (OU) to use to join the image builder to a Microsoft Active Directory domain.
    - DirectoryName (string) --
      
      The fully qualified name of the directory (for example, corp.example.com).
    - OrganizationalUnitDistinguishedName (string) --
      
      The distinguished name of the organizational unit for computer accounts.
  - NetworkAccessConfiguration (dict) --
    
    Describes the network details of the fleet or image builder instance.
    - EniPrivateIpAddress (string) --
      
      The private IP address of the elastic network interface that is attached to instances in your VPC.
    - EniIpv6Addresses (list) --
      
      The IPv6 addresses of the elastic network interface that is attached to instances in your VPC.
      - (string) --
    - EniId (string) --
      
      The resource identifier of the elastic network interface that is attached to instances in your VPC. All network interfaces have the eni-xxxxxxxx resource identifier.
  - ImageBuilderErrors (list) --
    
    The image builder errors.
    - (dict) --
      
      Describes a resource error.
      - ErrorCode (string) --
        
        The error code.
      - ErrorMessage (string) --
        
        The error message.
      - ErrorTimestamp (datetime) --
        
        The time the error occurred.
  - AppstreamAgentVersion (string) --
    
    The version of the AppStream 2.0 agent that is currently being used by the image builder.
  - AccessEndpoints (list) --
    
    The list of virtual private cloud (VPC) interface endpoint objects. Administrators can connect to the image builder only through the specified endpoints.
    - (dict) --
      
      Describes an interface VPC endpoint (interface endpoint) that lets you create a private connection between the virtual private cloud (VPC) that you specify and AppStream 2.0. When you specify an interface endpoint for a stack, users of the stack can connect to AppStream 2.0 only through that endpoint. When you specify an interface endpoint for an image builder, administrators can connect to the image builder only through that endpoint.
      - EndpointType (string) --
        
        The type of interface endpoint.
      - VpceId (string) --
        
        The identifier (ID) of the VPC in which the interface endpoint is used.
  - LatestAppstreamAgentVersion (string) --
    
    Indicates whether the image builder is using the latest AppStream 2.0 agent version or not.