AWS cli documentation change
Summary
Added new --filters option for scaling activity queries, updated activity-ids behavior documentation, added warning about account-wide operations, and updated AWS CLI version references.
Security assessment
The changes introduce new filtering capabilities and clarify existing parameters without addressing security vulnerabilities. The added warning about account-wide operations causing slower/timed-out requests relates to performance, not security vulnerabilities. No evidence of security patches, vulnerability disclosures, or security feature enhancements exists in the diff.
Diff
diff --git a/cli/latest/reference/autoscaling/describe-scaling-activities.md b/cli/latest/reference/autoscaling/describe-scaling-activities.md index 887d63be6..e0f578d37 100644 --- a//cli/latest/reference/autoscaling/describe-scaling-activities.md +++ b//cli/latest/reference/autoscaling/describe-scaling-activities.md @@ -15 +15 @@ - * [AWS CLI 2.33.2 Command Reference](../../index.html) » + * [AWS CLI 2.33.4 Command Reference](../../index.html) » @@ -76,0 +77 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/autosc + [--filters <value>] @@ -106 +107 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/autosc -> The activity IDs of the desired scaling activities. If you omit this property, all activities for the past six weeks are described. If unknown activities are requested, they are ignored with no error. If you specify an Auto Scaling group, the results are limited to that group. +> The activity IDs of the desired scaling activities. If unknown activity IDs are requested, they are ignored with no error. Only activities started within the last six weeks can be returned regardless of the activity IDs specified. If other filters are specified with the request, only results matching all filter criteria can be returned. @@ -127,0 +129,4 @@ Syntax: +> ### Warning +> +> Omitting this property performs an account-wide operation, which can result in slower or timed-out requests. +> @@ -139,0 +145,97 @@ Syntax: +`--filters` (list) + +> One or more filters to limit the results based on specific criteria. The following filters are supported: +> +> * `StartTimeLowerBound` \- The earliest scaling activities to return based on the activity start time. Scaling activities with a start time earlier than this value are not included in the results. Only activities started within the last six weeks can be returned regardless of the value specified. +> * `StartTimeUpperBound` \- The latest scaling activities to return based on the activity start time. Scaling activities with a start time later than this value are not included in the results. Only activities started within the last six weeks can be returned regardless of the value specified. +> * `Status` \- The `StatusCode` value of the scaling activity. This filter can only be used in combination with the `AutoScalingGroupName` parameter. For valid `StatusCode` values, see [Activity](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_Activity.html) in the _Amazon EC2 Auto Scaling API Reference_ . +> + +> +> (structure) +> +>> Describes a filter that is used to return a more specific list of results from a describe operation. +>> +>> If you specify multiple filters, the filters are automatically logically joined with an `AND` , and the request returns only the results that match all of the specified filters. +>> +>> For more information, see [Tag Auto Scaling groups and instances](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-tagging.html) in the _Amazon EC2 Auto Scaling User Guide_ . +>> +>> Name -> (string) +>> +>>> The name of the filter. +>>> +>>> The valid values for `Name` depend on which API operation you’re using with the filter. +>>> +>>>> ** [DescribeAutoScalingGroups](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_DescribeAutoScalingGroups.html) ** +>>> +>>> Valid values for `Name` include the following: +>>> +>>> * `tag-key` \- Accepts tag keys. The results only include information about the Auto Scaling groups associated with these tag keys. +>>> * `tag-value` \- Accepts tag values. The results only include information about the Auto Scaling groups associated with these tag values. +>>> * `tag:<key>` \- Accepts the key/value combination of the tag. Use the tag key in the filter name and the tag value as the filter value. The results only include information about the Auto Scaling groups associated with the specified key/value combination. +>>> + +>>> +>>>> ** [DescribeTags](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_DescribeTags.html) ** +>>> +>>> Valid values for `Name` include the following: +>>> +>>> * `auto-scaling-group` \- Accepts the names of Auto Scaling groups. The results only include information about the tags associated with these Auto Scaling groups. +>>> * `key` \- Accepts tag keys. The results only include information about the tags associated with these tag keys. +>>> * `value` \- Accepts tag values. The results only include information about the tags associated with these tag values. +>>> * `propagate-at-launch` \- Accepts a Boolean value, which specifies whether tags propagate to instances at launch. The results only include information about the tags associated with the specified Boolean value. +>>> + +>>> +>>>> ** [DescribeScalingActivities](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_DescribeScalingActivities.html) ** +>>> +>>> Valid values for `Name` include the following: +>>> +>>> * `StartTimeLowerBound` \- The earliest scaling activities to return based on the activity start time. Scaling activities with a start time earlier than this value are not included in the results. Only activities started within the last six weeks can be returned regardless of the value specified. +>>> * `StartTimeUpperBound` \- The latest scaling activities to return based on the activity start time. Scaling activities with a start time later than this value are not included in the results. Only activities started within the last six weeks can be returned regardless of the value specified. +>>> * `Status` \- The `StatusCode` value of the scaling activity. This filter can only be used in combination with the `AutoScalingGroupName` parameter. For valid `StatusCode` values, see [Activity](https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_Activity.html) in the _Amazon EC2 Auto Scaling API Reference_ . +>>> + +>>> +>>> Constraints: +>>> +>>> * pattern: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*` +>>> + +>> +>> Values -> (list) +>> +>>> One or more filter values. Filter values are case-sensitive. +>>> +>>> If you specify multiple values for a filter, the values are automatically logically joined with an `OR` , and the request returns all results that match any of the specified values. +>>> +>>>> **DescribeAutoScalingGroups example:** Specify “[tag:environment](tag:environment)” for the filter name and “production,development” for the filter values to find Auto Scaling groups with the tag “environment=production” or “environment=development”. +>>>> +>>>> **DescribeScalingActivities example:** Specify “Status” for the filter name and “Successful,Failed” for the filter values to find scaling activities with a status of either “Successful” or “Failed”. +>>> +>>> (string) +>>> +>>>> Constraints: +>>>> +>>>> * pattern: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*` +>>>> + + +Shorthand Syntax: + + + Name=string,Values=string,string ... + + +JSON Syntax: + + + [ + { + "Name": "string", + "Values": ["string", ...] + } + ... + ] + + @@ -523 +625 @@ NextToken -> (string) - * [AWS CLI 2.33.2 Command Reference](../../index.html) » + * [AWS CLI 2.33.4 Command Reference](../../index.html) »