/ - Amazon Simple Systems Manager (SSM)

Retrieves the current effective patches (the patch and the approval state) for the specified patch baseline. Applies to patch baselines for Windows only.

curl --location -g --request POST 'http://ssm.{region}.amazonaws.com/' \ --header 'X-Amz-Target;' \ --header 'Content-Type: application/json' \ --data-raw '{ "BaselineId": "string", "MaxResults": 0, "NextToken": "string" }'

Request

Query Params

MaxResults

string

optional

Pagination limit

NextToken

string

optional

Pagination token

Header Params

X-Amz-Target

string

required

Body Params application/json

BaselineId

string

required

The ID of the patch baseline to retrieve the effective patches for.

>= 20 characters<= 128 characters

Match pattern:

^[a-zA-Z0-9_\-:/]{20,128}$

MaxResults

integer

optional

The maximum number of patches to return (per page).

>= 1<= 100

NextToken

string

optional

The token for the next set of items to return. (You received this token from a previous call.)

Examples

Responses

🟢200Success

application/json

Body

EffectivePatches

array[object (EffectivePatch) {2}]

optional

An array of patches and patch status.

Patch

object

optional

Provides metadata for a patch, including information such as the KB ID, severity, classification and a URL for where more information can be obtained about the patch.

PatchStatus

object

optional

The status of the patch in a patch baseline. This includes information about whether the patch is currently approved, due to be approved by a rule, explicitly approved, or explicitly rejected and the date the patch was or will be approved.

NextToken

string

optional

The token to use when requesting the next set of items. If there are no additional items to return, the string is empty.

🟠480InvalidResourceId

🟠481DoesNotExistException

🟠482UnsupportedOperatingSystem

🟠483InternalServerError