v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141381,185842.7 KB

Retrieves the current snapshot for the patch baseline the managed node uses. This API is primarily used by the AWS-RunPatchBaseline Systems Manager document (SSM document).

If you run the command locally, such as with the Command Line Interface (CLI), the system attempts to use your local Amazon Web Services credentials and the operation fails. To avoid this, you can run the command in the Amazon Web Services Systems Manager console. Use Run Command, a capability of Amazon Web Services Systems Manager, with an SSM document that enables you to target a managed node with a script or command. For example, run the command using the AWS-RunShellScript document or the AWS-RunPowerShellScript document.

post/#X-Amz-Target=AmazonSSM.GetDeployablePatchSnapshotForInstance

Headers

X-Amz-Target'AmazonSSM.GetDeployablePatchSnapshotForInstance' required

Request body

InstanceIdstring required

The ID of the managed node for which the appropriate patch snapshot should be retrieved.

SnapshotIdstring required

The snapshot ID provided by the user when running <code>AWS-RunPatchBaseline</code>.

Response

Success

InstanceIdstring

The managed node ID.

SnapshotIdstring

The user-defined snapshot ID.

SnapshotDownloadUrlstring

A pre-signed Amazon Simple Storage Service (Amazon S3) URL that can be used to download the patch snapshot.

Productstring

Returns the specific operating system (for example Windows Server 2012 or Amazon Linux 2015.09) on the managed node for the specified patch snapshot.