Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1465286243.1 KB

Creates a new image with the latest Windows operating system updates, driver updates, and AppStream 2.0 agent software.

For more information, see the "Update an Image by Using Managed AppStream 2.0 Image Updates" section in Administer Your AppStream 2.0 Images, in the Amazon AppStream 2.0 Administration Guide.

post/#X-Amz-Target=PhotonAdminProxyService.CreateUpdatedImage

Headers

X-Amz-Target'PhotonAdminProxyService.CreateUpdatedImage' required

Request body

existingImageNamestring required

The name of the image to update.

newImageNamestring required

The name of the new image. The name must be unique within the AWS account and Region.

newImageDescriptionstring

The description to display for the new image.

newImageDisplayNamestring

The name to display for the new image.

newImageTagsobject
<p>The tags to associate with the new image. A tag is a key-value pair, and the value is optional. For example, Environment=Test. If you do not specify a value, Environment=. </p> <p>Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following special characters: </p> <p>_ . : / = + \ - @</p> <p>If you do not specify a value, the value is set to an empty string.</p> <p>For more information about tags, see <a href="https://docs.aws.amazon.com/appstream2/latest/developerguide/tagging-basic.html">Tagging Your Resources</a> in the <i>Amazon AppStream 2.0 Administration Guide</i>.</p>
dryRunboolean

Indicates whether to display the status of image update availability before AppStream 2.0 initiates the process of creating a new updated image. If this value is set to <code>true</code>, AppStream 2.0 displays whether image updates are available. If this value is set to <code>false</code>, AppStream 2.0 initiates the process of creating a new updated image without displaying whether image updates are available.

Response

Success

canUpdateImageboolean

Indicates whether a new image can be created.