You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.
Class: Aws::SSM::Types::DocumentKeyValuesFilter
- Inherits:
-
Struct
- Object
- Struct
- Aws::SSM::Types::DocumentKeyValuesFilter
- Defined in:
- (unknown)
Overview
When passing DocumentKeyValuesFilter as input to an Aws::Client method, you can use a vanilla Hash:
{
key: "DocumentKeyValuesFilterKey",
values: ["DocumentKeyValuesFilterValue"],
}
One or more filters. Use a filter to return a more specific list of documents.
For keys, you can specify one or more tags that have been applied to a document.
You can also use AWS-provided keys, some of which have specific allowed values. These keys and their associated values are as follows:
- DocumentType
-
-
ApplicationConfiguration
-
ApplicationConfigurationSchema
-
Automation
-
ChangeCalendar
-
Command
-
DeploymentStrategy
-
Package
-
Policy
-
Session
-
- Owner
-
Note that only one
Owner
can be specified in a request. For example:Key=Owner,Values=Self
.-
Amazon
-
Private
-
Public
-
Self
-
ThirdParty
-
- PlatformTypes
-
-
Linux
-
Windows
-
Name
is another AWS-provided key. If you use Name
as a key, you can use a name prefix to return a list of documents. For example, in the AWS CLI, to return a list of all documents that begin with Te
, run the following command:
aws ssm list-documents --filters Key=Name,Values=Te
You can also use the TargetType
AWS-provided key. For a list of valid resource type values that can be used with this key, see AWS resource and property types reference in the AWS CloudFormation User Guide.
If you specify more than two keys, only documents that are identified by all the tags are returned in the results. If you specify more than two values for a key, documents that are identified by any of the values are returned in the results.
To specify a custom key and value pair, use the format Key=tag:tagName,Values=valueName
.
For example, if you created a key called region and are using the AWS CLI to call the list-documents
command:
aws ssm list-documents --filters Key=tag:region,Values=east,west Key=Owner,Values=Self
Instance Attribute Summary collapse
-
#key ⇒ String
The name of the filter key.
-
#values ⇒ Array<String>
The value for the filter key.
Instance Attribute Details
#key ⇒ String
The name of the filter key.
#values ⇒ Array<String>
The value for the filter key.