1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
|
# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License"). You
# may not use this file except in compliance with the License. A copy of
# the License is located at
#
# http://aws.amazon.com/apache2.0/
#
# or in the "license" file accompanying this file. This file is
# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
# ANY KIND, either express or implied. See the License for the specific
# language governing permissions and limitations under the License.
module AWS
class EC2
# Most of the AWS::EC2 collections include TaggedCollection. This
# module provides methods for filtering the collection with
# tags.
#
# collecion.tagged('prod').each do {|obj| ... }
#
module TaggedCollection
# Filters the collection by a paired tag key and value.
#
# ec2.instances.with_tag('role', 'web')
#
# You can filter a single tag key with multiple values:
#
# ec2.instances.with_tag('role', ['web', 'db'])
#
# @param [String] tag_key
# @param [String, Array<String>] tag_value
def with_tag(tag_key, *values)
filter("tag:#{tag_key}", *values)
end
# Filter the collection by one or more tag keys. If you pass multiple
# tag keys they will be be treated as OR conditions. If you want to
# AND them together call tagged multiple times (chained).
#
# Filter the collection to items items tagged 'live' OR 'test'
#
# collection.tagged('live', 'test')
#
# Filter the collection to items tagged 'live' AND 'webserver'
#
# collection.tagged('live').tagged('webserver')
#
def tagged *keys
filter('tag-key', *keys)
end
# Filter the collection by one or more tag values. If you pass multiple
# tag values they will be be treated as OR conditions. If you want to
# AND them together call tagged multiple times (chained).
#
# collection.tagged('stage').tagged_values('production')
#
def tagged_values *values
filter('tag-value', *values)
end
end
end
end
|
