SSM / Paginator / DescribeInstancePatches

DescribeInstancePatches

class SSM.Paginator.DescribeInstancePatches

paginator = client.get_paginator('describe_instance_patches')

paginate(**kwargs)

Creates an iterator that will paginate through responses from SSM.Client.describe_instance_patches().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    InstanceId='string',
    Filters=[
        {
            'Key': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

• InstanceId (string) –

  [REQUIRED]

  The ID of the managed node whose patch state information should be retrieved.

• Filters (list) –

  Each element in the array is a structure containing a key-value pair.

  Supported keys for ``DescribeInstancePatches``include the following:

  • Classification Sample values: Security | SecurityUpdates

  • KBId Sample values: KB4480056 | java-1.7.0-openjdk.x86_64

  • Severity Sample values: Important | Medium | Low

  • State Sample values: Installed | InstalledOther | InstalledPendingReboot For lists of all State values, see Understanding patch compliance state values in the Amazon Web Services Systems Manager User Guide.

  • (dict) –

    Defines a filter used in Patch Manager APIs. Supported filter keys depend on the API operation that includes the filter. Patch Manager API operations that use PatchOrchestratorFilter include the following:

    • DescribeAvailablePatches

    • DescribeInstancePatches

    • DescribePatchBaselines

    • DescribePatchGroups

    • Key (string) –

      The key for the filter.

    • Values (list) –

      The value for the filter.

      • (string) –

• PaginationConfig (dict) –

  A dictionary that provides parameters to control pagination.

  • MaxItems (integer) –

    The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

  • PageSize (integer) –

    The size of each page.

  • StartingToken (string) –

    A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'Patches': [
        {
            'Title': 'string',
            'KBId': 'string',
            'Classification': 'string',
            'Severity': 'string',
            'State': 'INSTALLED'|'INSTALLED_OTHER'|'INSTALLED_PENDING_REBOOT'|'INSTALLED_REJECTED'|'MISSING'|'NOT_APPLICABLE'|'FAILED',
            'InstalledTime': datetime(2015, 1, 1),
            'CVEIds': 'string'
        },
    ],

}

Response Structure

• (dict) –

  • Patches (list) –

    Each entry in the array is a structure containing:

    • Title (string)

    • KBId (string)

    • Classification (string)

    • Severity (string)

    • State (string, such as “INSTALLED” or “FAILED”)

    • InstalledTime (DateTime)

    • InstalledBy (string)

    • (dict) –

      Information about the state of a patch on a particular managed node as it relates to the patch baseline used to patch the node.

      • Title (string) –

        The title of the patch.

      • KBId (string) –

        The operating system-specific ID of the patch.

      • Classification (string) –

        The classification of the patch, such as SecurityUpdates, Updates, and CriticalUpdates.

      • Severity (string) –

        The severity of the patch such as Critical, Important, and Moderate.

      • State (string) –

        The state of the patch on the managed node, such as INSTALLED or FAILED.

        For descriptions of each patch state, see About patch compliance in the Amazon Web Services Systems Manager User Guide.

      • InstalledTime (datetime) –

        The date/time the patch was installed on the managed node. Not all operating systems provide this level of information.

      • CVEIds (string) –

        The IDs of one or more Common Vulnerabilities and Exposure (CVE) issues that are resolved by the patch.

        Note

        Currently, CVE ID values are reported only for patches with a status of Missing or Failed.