AssociateSoftwareToImageBuilder - Amazon AppStream 2.0

AssociateSoftwareToImageBuilder

Associates license included application(s) with an existing image builder instance.

Request Syntax

{ "ImageBuilderName": "string", "SoftwareNames": [ "string" ] }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

ImageBuilderName

The name of the target image builder instance.

Type: String

Pattern: ^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,100}$

Required: Yes

SoftwareNames

The list of license included applications to associate with the image builder.

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

Type: Array of strings

Length Constraints: Minimum length of 1.

Required: Yes

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

Errors

For information about the errors that are common to all actions, see Common Errors.

ConcurrentModificationException

An API error occurred. Wait a few minutes and try again.

Message

The error message in the exception.

HTTP Status Code: 400

IncompatibleImageException

The image can't be updated because it's not compatible for updates.

Message

The error message in the exception.

HTTP Status Code: 400

InvalidParameterCombinationException

Indicates an incorrect combination of parameters, or a missing parameter.

Message

The error message in the exception.

HTTP Status Code: 400

OperationNotPermittedException

The attempted operation is not permitted.

Message

The error message in the exception.

HTTP Status Code: 400

ResourceNotFoundException

The specified resource was not found.

Message

The error message in the exception.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: