AWS Systems Manager
API Reference (API Version 2014-11-06)

CommandFilter

Describes a command filter.

Contents

key

The name of the filter.

Type: String

Valid Values: InvokedAfter | InvokedBefore | Status | ExecutionStage | DocumentName

Required: Yes

value

The filter value. Valid values for each filter key are as follows:

  • InvokedAfter: A timestamp to limit your results. For example, specify 2018-07-07T00:00:00Z to see results occurring July 7, 2018, and later.

  • InvokedBefore: A timestamp to limit your results. For example, specify 2018-07-07T00:00:00Z to see results before July 7, 2018.

  • Status: Specify a valid command status to see a list of all command executions with that status. Status values you can specify include:

    • Pending

    • InProgress

    • Success

    • Cancelled

    • Failed

    • TimedOut

    • Cancelling

  • DocumentName: The name of the SSM document for which you want to see command results.

    For example, specify AWS-RunPatchBaseline to see command executions that used this SSM document to perform security patching operations on instances.

  • ExecutionStage: An enum whose value can be either Executing or Complete.

    • Specify Executing to see a list of command executions that are currently still running.

    • Specify Complete to see a list of command exeuctions that have already completed.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 128.

Required: Yes

See Also

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

On this page: