Class: Aws::SSM::Types::CommandFilter

Inherits:
Struct
  • Object
show all
Includes:
Aws::Structure
Defined in:
lib/aws-sdk-ssm/types.rb

Overview

Note:

When making an API call, you may pass CommandFilter data as a hash:

{
  key: "InvokedAfter", # required, accepts InvokedAfter, InvokedBefore, Status, ExecutionStage, DocumentName
  value: "CommandFilterValue", # required
}

Describes a command filter.

<note markdown=“1”> An instance ID can't be specified when a command status is `Pending` because the command hasn't run on the instance yet.

</note>

Constant Summary collapse

SENSITIVE =
[]

Instance Attribute Summary collapse

Instance Attribute Details

#keyString

The name of the filter.

Returns:

  • (String)

2051
2052
2053
2054
2055
2056
# File 'lib/aws-sdk-ssm/types.rb', line 2051

class CommandFilter < Struct.new(
  :key,
  :value)
  SENSITIVE = []
  include Aws::Structure
end

#valueString

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

  • InvokedAfter: Specify a timestamp to limit your results. For example, specify `2021-07-07T00:00:00Z` to see a list of command executions occurring July 7, 2021, and later.

  • InvokedBefore: Specify a timestamp to limit your results. For example, specify `2021-07-07T00:00:00Z` to see a list of command executions from before July 7, 2021.

  • 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: Specify name of the Amazon Web Services Systems Manager document (SSM document) for which you want to see command execution results. For example, specify `AWS-RunPatchBaseline` to see command executions that used this SSM document to perform security patching operations on instances.

  • ExecutionStage: Specify one of the following values:

    • `Executing`: Returns a list of command executions that are currently still running.

    • `Complete`: Returns a list of command executions that have already completed.

Returns:

  • (String)

2051
2052
2053
2054
2055
2056
# File 'lib/aws-sdk-ssm/types.rb', line 2051

class CommandFilter < Struct.new(
  :key,
  :value)
  SENSITIVE = []
  include Aws::Structure
end