# Copyright 2018 Capital One Services, LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License 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.
from __future__ import absolute_import, division, print_function, unicode_literals
from c7n.actions import Action
from c7n.filters.metrics import MetricsFilter
from c7n.filters.vpc import SecurityGroupFilter, SubnetFilter
from c7n.manager import resources
from c7n.query import QueryResourceManager
from c7n.utils import local_session, type_schema
from c7n.tags import RemoveTag, Tag, TagDelayedAction, TagActionFilter
[docs]@resources.register('message-broker')
class MessageBroker(QueryResourceManager):
[docs] class resource_type(object):
service = 'mq'
enum_spec = ('list_brokers', 'BrokerSummaries', None)
detail_spec = (
'describe_broker', 'BrokerId', 'BrokerId', None)
id = 'BrokerId'
arn = 'BrokerArn'
name = 'BrokerName'
date = None
dimension = 'Broker'
filter_name = None
metrics_namespace = 'AWS/AmazonMQ'
[docs] def augment(self, resources):
super(MessageBroker, self).augment(resources)
for r in resources:
r['Tags'] = [{'Key': k, 'Value': v} for k, v in r.get('Tags', {}).items()]
return resources
[docs]@MessageBroker.filter_registry.register('marked-for-op')
class MarkedForOp(TagActionFilter):
permissions = ('mq:ListBrokers',)
[docs]@MessageBroker.filter_registry.register('subnet')
class MQSubnetFilter(SubnetFilter):
RelatedIdsExpression = 'SubnetIds[]'
[docs]@MessageBroker.filter_registry.register('security-group')
class MQSGFilter(SecurityGroupFilter):
RelatedIdsExpression = 'SecurityGroups[]'
[docs]@MessageBroker.filter_registry.register('metrics')
class MQMetrics(MetricsFilter):
[docs] def get_dimensions(self, resource):
# Fetching for Active broker instance only, https://amzn.to/2tLBhEB
return [{'Name': self.model.dimension,
'Value': "{}-1".format(resource['BrokerName'])}]
[docs]@MessageBroker.action_registry.register('delete')
class Delete(Action):
"""Delete a set of message brokers
"""
schema = type_schema('delete')
permissions = ("mq:DeleteBroker",)
[docs] def process(self, resources):
client = local_session(self.manager.session_factory).client('mq')
for r in resources:
try:
client.delete_broker(BrokerId=r['BrokerId'])
except client.exceptions.NotFoundException:
continue
[docs]@MessageBroker.action_registry.register('tag')
class TagMessageBroker(Tag):
"""Action to create tag(s) on a mq
:example:
.. code-block:: yaml
policies:
- name: tag-mq
resource: message-broker
filters:
- "tag:target-tag": absent
actions:
- type: tag
key: target-tag
value: target-tag-value
"""
permissions = ('mq:TagMessageBroker',)
[docs] def process_resource_set(self, client, mq, new_tags):
for r in mq:
try:
client.create_tags(
ResourceArn=r['BrokerArn'],
Tags={t['Key']: t['Value'] for t in new_tags})
except client.exceptions.ResourceNotFound:
continue
[docs]@MessageBroker.action_registry.register('remove-tag')
class UntagMessageBroker(RemoveTag):
"""Action to remove tag(s) on mq
:example:
.. code-block:: yaml
policies:
- name: mq-remove-tag
resource: message-broker
filters:
- "tag:OutdatedTag": present
actions:
- type: remove-tag
tags: ["OutdatedTag"]
"""
permissions = ('mq:UntagMessageBroker',)
[docs] def process_resource_set(self, client, mq, tags):
for r in mq:
try:
client.delete_tags(ResourceArn=r['BrokerArn'], TagKeys=tags)
except client.exceptions.ResourceNotFound:
continue
[docs]@MessageBroker.action_registry.register('mark-for-op')
class MarkForOpMessageBroker(TagDelayedAction):
"""Action to specify an action to occur at a later date
:example:
.. code-block:: yaml
policies:
- name: mq-delete-unused
resource: message-broker
filters:
- "tag:custodian_cleanup": absent
actions:
- type: mark-for-op
tag: custodian_cleanup
msg: "Unused mq"
op: delete
days: 7
"""