FG
💻 Software☁️ Cloud & DevOpsAmazon

aws ec2 describe-instances --filters tag: seems to be not working (or docs is missing/misleading)

Freshabout 12 years ago
Mar 14, 20260 views
Confidence Score77%
77%

Problem

Trying to use aws ec2 describe-instance (version 1.1.0) with tag: filter which is mentioned in docs at http://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html but it doesn't seem to be working. Quote from documentation: "tag: --filters the response based on a specific tag/value combination." Tried several formats (just guessing, trying format used by http://docs.aws.amazon.com/AWSEC2/latest/CommandLineReference/ApiReference-cmd-DescribeInstances.html) but no luck. This does not complain but returns no instances: aws ec2 describe-instances --filters Name=tag:,Values=Name=ADS-prod-ads This one fails: aws ec2 describe-instances --filters tag:Name=ADS-prod-ads Unknown key 'tag:Name' for parameter --filters, valid choices are: Values, Name Just for reference, using tag-value works (just to show that tag Name=ADS-prod-ads exists): aws ec2 describe-instances --filters Name=tag-value,Values=ADS-prod-ads | jq '.Reservations[].Instances[].Tags[]' { "Key": "Name", "Value": "ADS-prod-ads" }

Unverified for your environment

Select your OS to check compatibility.

1 Fix

Canonical Fix
High Confidence Fix
77% confidence91% success rate9 verificationsLast verified Mar 14, 2026

Solution: aws ec2 describe-instances --filters tag: seems to be not working (or docs is missing/misleading)

Low Risk

To filter on all instances that have a tag with a name or key of `Name` AND a value of `ADS-prod-ads`, you would do this: [code block]

77

Trust Score

9 verifications

91% success
  1. 1

    To filter on all instances that have a tag with a name or key of `Name` AND a va

    To filter on all instances that have a tag with a name or key of `Name` AND a value of `ADS-prod-ads`, you would do this:

    text
    aws ec2 describe-instances --filter Name=tag:Name,Values=ADS-prod-ads

Validation

Resolved in aws/aws-cli GitHub issue #368. Community reactions: 74 upvotes.

Verification Summary

Worked: 9
Partial: 1
Failed: 1
Last verified Mar 14, 2026

Sign in to verify this fix

Environment

Submitted by

AC

Alex Chen

2450 rep

Tags

awscliclouddocumentation