gcloud 0.0.7 → 0.1.0

data/packages/gsutil/boto/boto/ec2/autoscale/tag.py

@@ -1,84 +0,0 @@
-# Copyright (c) 2012 Mitch Garnaat http://garnaat.org/
-# Copyright (c) 2012 Amazon.com, Inc. or its affiliates.  All Rights Reserved
-#
-# Permission is hereby granted, free of charge, to any person obtaining a
-# copy of this software and associated documentation files (the
-# "Software"), to deal in the Software without restriction, including
-# without limitation the rights to use, copy, modify, merge, publish, dis-
-# tribute, sublicense, and/or sell copies of the Software, and to permit
-# persons to whom the Software is furnished to do so, subject to the fol-
-# lowing conditions:
-#
-# The above copyright notice and this permission notice shall be included
-# in all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
-# ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
-# SHALL THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
-# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
-# IN THE SOFTWARE.
-
-
-class Tag(object):
-    """
-    A name/value tag on an AutoScalingGroup resource.
-
-    :ivar key: The key of the tag.
-    :ivar value: The value of the tag.
-    :ivar propagate_at_launch: Boolean value which specifies whether the
-        new tag will be applied to instances launched after the tag is created.
-    :ivar resource_id: The name of the autoscaling group.
-    :ivar resource_type: The only supported resource type at this time
-        is "auto-scaling-group".
-    """
-
-    def __init__(self, connection=None, key=None, value=None,
-                 propagate_at_launch=False, resource_id=None,
-                 resource_type='auto-scaling-group'):
-        self.connection = connection
-        self.key = key
-        self.value = value
-        self.propagate_at_launch = propagate_at_launch
-        self.resource_id = resource_id
-        self.resource_type = resource_type
-
-    def __repr__(self):
-        return 'Tag(%s=%s)' % (self.key, self.value)
-
-    def startElement(self, name, attrs, connection):
-        pass
-
-    def endElement(self, name, value, connection):
-        if name == 'Key':
-            self.key = value
-        elif name == 'Value':
-            self.value = value
-        elif name == 'PropogateAtLaunch':
-            if value.lower() == 'true':
-                self.propogate_at_launch = True
-            else:
-                self.propogate_at_launch = False
-        elif name == 'ResourceId':
-            self.resource_id = value
-        elif name == 'ResourceType':
-            self.resource_type = value
-
-    def build_params(self, params, i):
-        """
-        Populates a dictionary with the name/value pairs necessary
-        to identify this Tag in a request.
-        """
-        prefix = 'Tags.member.%d.' % i
-        params[prefix + 'ResourceId'] = self.resource_id
-        params[prefix + 'ResourceType'] = self.resource_type
-        params[prefix + 'Key'] = self.key
-        params[prefix + 'Value'] = self.value
-        if self.propagate_at_launch:
-            params[prefix + 'PropagateAtLaunch'] = 'true'
-        else:
-            params[prefix + 'PropagateAtLaunch'] = 'false'
-
-    def delete(self):
-        return self.connection.delete_tags([self])

data/packages/gsutil/boto/boto/ec2/blockdevicemapping.py

@@ -1,141 +0,0 @@
-# Copyright (c) 2009-2012 Mitch Garnaat http://garnaat.org/
-# Copyright (c) 2012 Amazon.com, Inc. or its affiliates.  All Rights Reserved
-#
-# Permission is hereby granted, free of charge, to any person obtaining a
-# copy of this software and associated documentation files (the
-# "Software"), to deal in the Software without restriction, including
-# without limitation the rights to use, copy, modify, merge, publish, dis-
-# tribute, sublicense, and/or sell copies of the Software, and to permit
-# persons to whom the Software is furnished to do so, subject to the fol-
-# lowing conditions:
-#
-# The above copyright notice and this permission notice shall be included
-# in all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
-# ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
-# SHALL THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
-# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
-# IN THE SOFTWARE.
-#
-
-
-class BlockDeviceType(object):
-    """
-    Represents parameters for a block device.
-    """
-
-    def __init__(self,
-                 connection=None,
-                 ephemeral_name=None,
-                 no_device=False,
-                 volume_id=None,
-                 snapshot_id=None,
-                 status=None,
-                 attach_time=None,
-                 delete_on_termination=False,
-                 size=None,
-                 volume_type=None,
-                 iops=None):
-        self.connection = connection
-        self.ephemeral_name = ephemeral_name
-        self.no_device = no_device
-        self.volume_id = volume_id
-        self.snapshot_id = snapshot_id
-        self.status = status
-        self.attach_time = attach_time
-        self.delete_on_termination = delete_on_termination
-        self.size = size
-        self.volume_type = volume_type
-        self.iops = iops
-
-    def startElement(self, name, attrs, connection):
-        pass
-
-    def endElement(self, name, value, connection):
-        if name == 'volumeId':
-            self.volume_id = value
-        elif name == 'virtualName':
-            self.ephemeral_name = value
-        elif name == 'NoDevice':
-            self.no_device = (value == 'true')
-        elif name == 'snapshotId':
-            self.snapshot_id = value
-        elif name == 'volumeSize':
-            self.size = int(value)
-        elif name == 'status':
-            self.status = value
-        elif name == 'attachTime':
-            self.attach_time = value
-        elif name == 'deleteOnTermination':
-            self.delete_on_termination = (value == 'true')
-        elif name == 'volumeType':
-            self.volume_type = value
-        elif name == 'iops':
-            self.iops = int(value)
-        else:
-            setattr(self, name, value)
-
-# for backwards compatibility
-EBSBlockDeviceType = BlockDeviceType
-
-
-class BlockDeviceMapping(dict):
-    """
-    Represents a collection of BlockDeviceTypes when creating ec2 instances.
-
-    Example:
-    dev_sda1 = BlockDeviceType()
-    dev_sda1.size = 100   # change root volume to 100GB instead of default
-    bdm = BlockDeviceMapping()
-    bdm['/dev/sda1'] = dev_sda1
-    reservation = image.run(..., block_device_map=bdm, ...)
-    """
-
-    def __init__(self, connection=None):
-        """
-        :type connection: :class:`boto.ec2.EC2Connection`
-        :param connection: Optional connection.
-        """
-        dict.__init__(self)
-        self.connection = connection
-        self.current_name = None
-        self.current_value = None
-
-    def startElement(self, name, attrs, connection):
-        if name == 'ebs' or name == 'virtualName':
-            self.current_value = BlockDeviceType(self)
-            return self.current_value
-
-    def endElement(self, name, value, connection):
-        if name == 'device' or name == 'deviceName':
-            self.current_name = value
-        elif name == 'item':
-            self[self.current_name] = self.current_value
-
-    def build_list_params(self, params, prefix=''):
-        i = 1
-        for dev_name in self:
-            pre = '%sBlockDeviceMapping.%d' % (prefix, i)
-            params['%s.DeviceName' % pre] = dev_name
-            block_dev = self[dev_name]
-            if block_dev.ephemeral_name:
-                params['%s.VirtualName' % pre] = block_dev.ephemeral_name
-            else:
-                if block_dev.no_device:
-                    params['%s.Ebs.NoDevice' % pre] = 'true'
-                if block_dev.snapshot_id:
-                    params['%s.Ebs.SnapshotId' % pre] = block_dev.snapshot_id
-                if block_dev.size:
-                    params['%s.Ebs.VolumeSize' % pre] = block_dev.size
-                if block_dev.delete_on_termination:
-                    params['%s.Ebs.DeleteOnTermination' % pre] = 'true'
-                else:
-                    params['%s.Ebs.DeleteOnTermination' % pre] = 'false'
-                if block_dev.volume_type:
-                    params['%s.Ebs.VolumeType' % pre] = block_dev.volume_type
-                if block_dev.iops is not None:
-                    params['%s.Ebs.Iops' % pre] = block_dev.iops
-            i += 1

data/packages/gsutil/boto/boto/ec2/bundleinstance.py

@@ -1,78 +0,0 @@
-# Copyright (c) 2010 Mitch Garnaat http://garnaat.org/
-#
-# Permission is hereby granted, free of charge, to any person obtaining a
-# copy of this software and associated documentation files (the
-# "Software"), to deal in the Software without restriction, including
-# without limitation the rights to use, copy, modify, merge, publish, dis-
-# tribute, sublicense, and/or sell copies of the Software, and to permit
-# persons to whom the Software is furnished to do so, subject to the fol-
-# lowing conditions:
-#
-# The above copyright notice and this permission notice shall be included
-# in all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
-# ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
-# SHALL THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 
-# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
-# IN THE SOFTWARE.
-
-"""
-Represents an EC2 Bundle Task 
-"""
-
-from boto.ec2.ec2object import EC2Object
-
-class BundleInstanceTask(EC2Object):
-    
-    def __init__(self, connection=None):
-        EC2Object.__init__(self, connection)
-        self.id = None
-        self.instance_id = None
-        self.progress = None
-        self.start_time = None
-        self.state = None
-        self.bucket = None
-        self.prefix = None
-        self.upload_policy = None
-        self.upload_policy_signature = None
-        self.update_time = None 
-        self.code = None
-        self.message = None
-
-    def __repr__(self):
-        return 'BundleInstanceTask:%s' % self.id
-
-    def startElement(self, name, attrs, connection):
-        return None
-
-    def endElement(self, name, value, connection):
-        if name == 'bundleId':
-            self.id = value
-        elif name == 'instanceId':
-            self.instance_id = value
-        elif name == 'progress':
-            self.progress = value
-        elif name == 'startTime':
-            self.start_time = value
-        elif name == 'state':
-            self.state = value
-        elif name == 'bucket':
-            self.bucket = value
-        elif name == 'prefix':
-            self.prefix = value
-        elif name == 'uploadPolicy':
-            self.upload_policy = value
-        elif name == 'uploadPolicySignature':
-            self.upload_policy_signature = value
-        elif name == 'updateTime':
-            self.update_time = value
-        elif name == 'code':
-            self.code = value
-        elif name == 'message':
-            self.message = value
-        else:
-            setattr(self, name, value)
-

data/packages/gsutil/boto/boto/ec2/buyreservation.py

@@ -1,84 +0,0 @@
-# Copyright (c) 2006-2009 Mitch Garnaat http://garnaat.org/
-#
-# Permission is hereby granted, free of charge, to any person obtaining a
-# copy of this software and associated documentation files (the
-# "Software"), to deal in the Software without restriction, including
-# without limitation the rights to use, copy, modify, merge, publish, dis-
-# tribute, sublicense, and/or sell copies of the Software, and to permit
-# persons to whom the Software is furnished to do so, subject to the fol-
-# lowing conditions:
-#
-# The above copyright notice and this permission notice shall be included
-# in all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
-# ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
-# SHALL THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 
-# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
-# IN THE SOFTWARE.
-
-import boto.ec2
-from boto.sdb.db.property import StringProperty, IntegerProperty
-from boto.manage import propget
-
-InstanceTypes = ['m1.small', 'm1.large', 'm1.xlarge',
-                 'c1.medium', 'c1.xlarge', 'm2.xlarge',
-                 'm2.2xlarge', 'm2.4xlarge', 'cc1.4xlarge',
-                 't1.micro']
-
-class BuyReservation(object):
-
-    def get_region(self, params):
-        if not params.get('region', None):
-            prop = StringProperty(name='region', verbose_name='EC2 Region',
-                                  choices=boto.ec2.regions)
-            params['region'] = propget.get(prop, choices=boto.ec2.regions)
-
-    def get_instance_type(self, params):
-        if not params.get('instance_type', None):
-            prop = StringProperty(name='instance_type', verbose_name='Instance Type',
-                                  choices=InstanceTypes)
-            params['instance_type'] = propget.get(prop)
-
-    def get_quantity(self, params):
-        if not params.get('quantity', None):
-            prop = IntegerProperty(name='quantity', verbose_name='Number of Instances')
-            params['quantity'] = propget.get(prop)
-
-    def get_zone(self, params):
-        if not params.get('zone', None):
-            prop = StringProperty(name='zone', verbose_name='EC2 Availability Zone',
-                                  choices=self.ec2.get_all_zones)
-            params['zone'] = propget.get(prop)
-            
-    def get(self, params):
-        self.get_region(params)
-        self.ec2 = params['region'].connect()
-        self.get_instance_type(params)
-        self.get_zone(params)
-        self.get_quantity(params)
-
-if __name__ == "__main__":
-    obj = BuyReservation()
-    params = {}
-    obj.get(params)
-    offerings = obj.ec2.get_all_reserved_instances_offerings(instance_type=params['instance_type'],
-                                                             availability_zone=params['zone'].name)
-    print '\nThe following Reserved Instances Offerings are available:\n'
-    for offering in offerings:
-        offering.describe()
-    prop = StringProperty(name='offering', verbose_name='Offering',
-                          choices=offerings)
-    offering = propget.get(prop)
-    print '\nYou have chosen this offering:'
-    offering.describe()
-    unit_price = float(offering.fixed_price)
-    total_price = unit_price * params['quantity']
-    print '!!! You are about to purchase %d of these offerings for a total of $%.2f !!!' % (params['quantity'], total_price)
-    answer = raw_input('Are you sure you want to do this?  If so, enter YES: ')
-    if answer.strip().lower() == 'yes':
-        offering.purchase(params['quantity'])
-    else:
-        print 'Purchase cancelled'

data/packages/gsutil/boto/boto/ec2/cloudwatch/__init__.py

@@ -1,603 +0,0 @@
-# Copyright (c) 2006-2011 Mitch Garnaat http://garnaat.org/
-#
-# Permission is hereby granted, free of charge, to any person obtaining a
-# copy of this software and associated documentation files (the
-# "Software"), to deal in the Software without restriction, including
-# without limitation the rights to use, copy, modify, merge, publish, dis-
-# tribute, sublicense, and/or sell copies of the Software, and to permit
-# persons to whom the Software is furnished to do so, subject to the fol-
-# lowing conditions:
-#
-# The above copyright notice and this permission notice shall be included
-# in all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
-# ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
-# SHALL THE AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
-# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
-# IN THE SOFTWARE.
-#
-"""
-This module provides an interface to the Elastic Compute Cloud (EC2)
-CloudWatch service from AWS.
-"""
-from boto.compat import json
-from boto.connection import AWSQueryConnection
-from boto.ec2.cloudwatch.metric import Metric
-from boto.ec2.cloudwatch.alarm import MetricAlarm, MetricAlarms, AlarmHistoryItem
-from boto.ec2.cloudwatch.datapoint import Datapoint
-from boto.regioninfo import RegionInfo
-import boto
-
-RegionData = {
-    'us-east-1': 'monitoring.us-east-1.amazonaws.com',
-    'us-west-1': 'monitoring.us-west-1.amazonaws.com',
-    'us-west-2': 'monitoring.us-west-2.amazonaws.com',
-    'sa-east-1': 'monitoring.sa-east-1.amazonaws.com',
-    'eu-west-1': 'monitoring.eu-west-1.amazonaws.com',
-    'ap-northeast-1': 'monitoring.ap-northeast-1.amazonaws.com',
-    'ap-southeast-1': 'monitoring.ap-southeast-1.amazonaws.com',
-    'ap-southeast-2': 'monitoring.ap-southeast-2.amazonaws.com',
-}
-
-
-def regions():
-    """
-    Get all available regions for the CloudWatch service.
-
-    :rtype: list
-    :return: A list of :class:`boto.RegionInfo` instances
-    """
-    regions = []
-    for region_name in RegionData:
-        region = RegionInfo(name=region_name,
-                            endpoint=RegionData[region_name],
-                            connection_cls=CloudWatchConnection)
-        regions.append(region)
-    return regions
-
-
-def connect_to_region(region_name, **kw_params):
-    """
-    Given a valid region name, return a
-    :class:`boto.ec2.cloudwatch.CloudWatchConnection`.
-
-    :param str region_name: The name of the region to connect to.
-
-    :rtype: :class:`boto.ec2.CloudWatchConnection` or ``None``
-    :return: A connection to the given region, or None if an invalid region
-        name is given
-    """
-    for region in regions():
-        if region.name == region_name:
-            return region.connect(**kw_params)
-    return None
-
-
-class CloudWatchConnection(AWSQueryConnection):
-
-    APIVersion = boto.config.get('Boto', 'cloudwatch_version', '2010-08-01')
-    DefaultRegionName = boto.config.get('Boto', 'cloudwatch_region_name',
-                                        'us-east-1')
-    DefaultRegionEndpoint = boto.config.get('Boto',
-                                            'cloudwatch_region_endpoint',
-                                            'monitoring.us-east-1.amazonaws.com')
-
-    def __init__(self, aws_access_key_id=None, aws_secret_access_key=None,
-                 is_secure=True, port=None, proxy=None, proxy_port=None,
-                 proxy_user=None, proxy_pass=None, debug=0,
-                 https_connection_factory=None, region=None, path='/',
-                 security_token=None, validate_certs=True):
-        """
-        Init method to create a new connection to EC2 Monitoring Service.
-
-        B{Note:} The host argument is overridden by the host specified in the
-        boto configuration file.
-        """
-        if not region:
-            region = RegionInfo(self, self.DefaultRegionName,
-                                self.DefaultRegionEndpoint)
-        self.region = region
-
-        # Ugly hack to get around both a bug in Python and a
-        # misconfigured SSL cert for the eu-west-1 endpoint
-        if self.region.name == 'eu-west-1':
-            validate_certs = False
-
-        AWSQueryConnection.__init__(self, aws_access_key_id,
-                                    aws_secret_access_key,
-                                    is_secure, port, proxy, proxy_port,
-                                    proxy_user, proxy_pass,
-                                    self.region.endpoint, debug,
-                                    https_connection_factory, path,
-                                    security_token,
-                                    validate_certs=validate_certs)
-
-    def _required_auth_capability(self):
-        return ['ec2']
-
-    def build_dimension_param(self, dimension, params):
-        prefix = 'Dimensions.member'
-        i = 0
-        for dim_name in dimension:
-            dim_value = dimension[dim_name]
-            if dim_value:
-                if isinstance(dim_value, basestring):
-                    dim_value = [dim_value]
-                for value in dim_value:
-                    params['%s.%d.Name' % (prefix, i+1)] = dim_name
-                    params['%s.%d.Value' % (prefix, i+1)] = value
-                    i += 1
-            else:
-                params['%s.%d.Name' % (prefix, i+1)] = dim_name
-                i += 1
-
-    def build_list_params(self, params, items, label):
-        if isinstance(items, basestring):
-            items = [items]
-        for index, item in enumerate(items):
-            i = index + 1
-            if isinstance(item, dict):
-                for k, v in item.iteritems():
-                    params[label % (i, 'Name')] = k
-                    if v is not None:
-                        params[label % (i, 'Value')] = v
-            else:
-                params[label % i] = item
-
-    def build_put_params(self, params, name, value=None, timestamp=None,
-                        unit=None, dimensions=None, statistics=None):
-        args = (name, value, unit, dimensions, statistics, timestamp)
-        length = max(map(lambda a: len(a) if isinstance(a, list) else 1, args))
-
-        def aslist(a):
-            if isinstance(a, list):
-                if len(a) != length:
-                    raise Exception('Must specify equal number of elements; expected %d.' % length)
-                return a
-            return [a] * length
-
-        for index, (n, v, u, d, s, t) in enumerate(zip(*map(aslist, args))):
-            metric_data = {'MetricName': n}
-
-            if timestamp:
-                metric_data['Timestamp'] = t.isoformat()
-
-            if unit:
-                metric_data['Unit'] = u
-
-            if dimensions:
-                self.build_dimension_param(d, metric_data)
-
-            if statistics:
-                metric_data['StatisticValues.Maximum'] = s['maximum']
-                metric_data['StatisticValues.Minimum'] = s['minimum']
-                metric_data['StatisticValues.SampleCount'] = s['samplecount']
-                metric_data['StatisticValues.Sum'] = s['sum']
-                if value != None:
-                    msg = 'You supplied a value and statistics for a metric.'
-                    msg += 'Posting statistics and not value.'
-                    boto.log.warn(msg)
-            elif value != None:
-                metric_data['Value'] = v
-            else:
-                raise Exception('Must specify a value or statistics to put.')
-
-            for key, value in metric_data.iteritems():
-                params['MetricData.member.%d.%s' % (index + 1, key)] = value
-
-    def get_metric_statistics(self, period, start_time, end_time, metric_name,
-                              namespace, statistics, dimensions=None,
-                              unit=None):
-        """
-        Get time-series data for one or more statistics of a given metric.
-
-        :type period: integer
-        :param period: The granularity, in seconds, of the returned datapoints.
-            Period must be at least 60 seconds and must be a multiple
-            of 60. The default value is 60.
-
-        :type start_time: datetime
-        :param start_time: The time stamp to use for determining the
-            first datapoint to return. The value specified is
-            inclusive; results include datapoints with the time stamp
-            specified.
-
-        :type end_time: datetime
-        :param end_time: The time stamp to use for determining the
-            last datapoint to return. The value specified is
-            exclusive; results will include datapoints up to the time
-            stamp specified.
-
-        :type metric_name: string
-        :param metric_name: The metric name.
-
-        :type namespace: string
-        :param namespace: The metric's namespace.
-
-        :type statistics: list
-        :param statistics: A list of statistics names Valid values:
-            Average | Sum | SampleCount | Maximum | Minimum
-
-        :type dimensions: dict
-        :param dimensions: A dictionary of dimension key/values where
-                           the key is the dimension name and the value
-                           is either a scalar value or an iterator
-                           of values to be associated with that
-                           dimension.
-
-        :type unit: string
-        :param unit: The unit for the metric.  Value values are:
-            Seconds | Microseconds | Milliseconds | Bytes | Kilobytes |
-            Megabytes | Gigabytes | Terabytes | Bits | Kilobits |
-            Megabits | Gigabits | Terabits | Percent | Count |
-            Bytes/Second | Kilobytes/Second | Megabytes/Second |
-            Gigabytes/Second | Terabytes/Second | Bits/Second |
-            Kilobits/Second | Megabits/Second | Gigabits/Second |
-            Terabits/Second | Count/Second | None
-
-        :rtype: list
-        """
-        params = {'Period': period,
-                  'MetricName': metric_name,
-                  'Namespace': namespace,
-                  'StartTime': start_time.isoformat(),
-                  'EndTime': end_time.isoformat()}
-        self.build_list_params(params, statistics, 'Statistics.member.%d')
-        if dimensions:
-            self.build_dimension_param(dimensions, params)
-        if unit:
-            params['Unit'] = unit
-        return self.get_list('GetMetricStatistics', params,
-                             [('member', Datapoint)])
-
-    def list_metrics(self, next_token=None, dimensions=None,
-                     metric_name=None, namespace=None):
-        """
-        Returns a list of the valid metrics for which there is recorded
-        data available.
-
-        :type next_token: str
-        :param next_token: A maximum of 500 metrics will be returned
-            at one time.  If more results are available, the ResultSet
-            returned will contain a non-Null next_token attribute.
-            Passing that token as a parameter to list_metrics will
-            retrieve the next page of metrics.
-
-        :type dimensions: dict
-        :param dimensions: A dictionary containing name/value
-            pairs that will be used to filter the results.  The key in
-            the dictionary is the name of a Dimension.  The value in
-            the dictionary is either a scalar value of that Dimension
-            name that you want to filter on, a list of values to
-            filter on or None if you want all metrics with that
-            Dimension name.
-
-        :type metric_name: str
-        :param metric_name: The name of the Metric to filter against.  If None,
-            all Metric names will be returned.
-
-        :type namespace: str
-        :param namespace: A Metric namespace to filter against (e.g. AWS/EC2).
-            If None, Metrics from all namespaces will be returned.
-        """
-        params = {}
-        if next_token:
-            params['NextToken'] = next_token
-        if dimensions:
-            self.build_dimension_param(dimensions, params)
-        if metric_name:
-            params['MetricName'] = metric_name
-        if namespace:
-            params['Namespace'] = namespace
-
-        return self.get_list('ListMetrics', params, [('member', Metric)])
-
-    def put_metric_data(self, namespace, name, value=None, timestamp=None,
-                        unit=None, dimensions=None, statistics=None):
-        """
-        Publishes metric data points to Amazon CloudWatch. Amazon Cloudwatch
-        associates the data points with the specified metric. If the specified
-        metric does not exist, Amazon CloudWatch creates the metric. If a list
-        is specified for some, but not all, of the arguments, the remaining
-        arguments are repeated a corresponding number of times.
-
-        :type namespace: str
-        :param namespace: The namespace of the metric.
-
-        :type name: str or list
-        :param name: The name of the metric.
-
-        :type value: float or list
-        :param value: The value for the metric.
-
-        :type timestamp: datetime or list
-        :param timestamp: The time stamp used for the metric. If not specified,
-            the default value is set to the time the metric data was received.
-
-        :type unit: string or list
-        :param unit: The unit of the metric.  Valid Values: Seconds |
-            Microseconds | Milliseconds | Bytes | Kilobytes |
-            Megabytes | Gigabytes | Terabytes | Bits | Kilobits |
-            Megabits | Gigabits | Terabits | Percent | Count |
-            Bytes/Second | Kilobytes/Second | Megabytes/Second |
-            Gigabytes/Second | Terabytes/Second | Bits/Second |
-            Kilobits/Second | Megabits/Second | Gigabits/Second |
-            Terabits/Second | Count/Second | None
-
-        :type dimensions: dict
-        :param dimensions: Add extra name value pairs to associate
-            with the metric, i.e.:
-            {'name1': value1, 'name2': (value2, value3)}
-
-        :type statistics: dict or list
-        :param statistics: Use a statistic set instead of a value, for example::
-
-            {'maximum': 30, 'minimum': 1, 'samplecount': 100, 'sum': 10000}
-        """
-        params = {'Namespace': namespace}
-        self.build_put_params(params, name, value=value, timestamp=timestamp,
-            unit=unit, dimensions=dimensions, statistics=statistics)
-
-        return self.get_status('PutMetricData', params, verb="POST")
-
-    def describe_alarms(self, action_prefix=None, alarm_name_prefix=None,
-                        alarm_names=None, max_records=None, state_value=None,
-                        next_token=None):
-        """
-        Retrieves alarms with the specified names. If no name is specified, all
-        alarms for the user are returned. Alarms can be retrieved by using only
-        a prefix for the alarm name, the alarm state, or a prefix for any
-        action.
-
-        :type action_prefix: string
-        :param action_name: The action name prefix.
-
-        :type alarm_name_prefix: string
-        :param alarm_name_prefix: The alarm name prefix. AlarmNames cannot
-            be specified if this parameter is specified.
-
-        :type alarm_names: list
-        :param alarm_names: A list of alarm names to retrieve information for.
-
-        :type max_records: int
-        :param max_records: The maximum number of alarm descriptions
-            to retrieve.
-
-        :type state_value: string
-        :param state_value: The state value to be used in matching alarms.
-
-        :type next_token: string
-        :param next_token: The token returned by a previous call to
-            indicate that there is more data.
-
-        :rtype list
-        """
-        params = {}
-        if action_prefix:
-            params['ActionPrefix'] = action_prefix
-        if alarm_name_prefix:
-            params['AlarmNamePrefix'] = alarm_name_prefix
-        elif alarm_names:
-            self.build_list_params(params, alarm_names, 'AlarmNames.member.%s')
-        if max_records:
-            params['MaxRecords'] = max_records
-        if next_token:
-            params['NextToken'] = next_token
-        if state_value:
-            params['StateValue'] = state_value
-
-        result = self.get_list('DescribeAlarms', params,
-                               [('MetricAlarms', MetricAlarms)])
-        ret = result[0]
-        ret.next_token = result.next_token
-        return ret
-
-    def describe_alarm_history(self, alarm_name=None,
-                               start_date=None, end_date=None,
-                               max_records=None, history_item_type=None,
-                               next_token=None):
-        """
-        Retrieves history for the specified alarm. Filter alarms by date range
-        or item type. If an alarm name is not specified, Amazon CloudWatch
-        returns histories for all of the owner's alarms.
-
-        Amazon CloudWatch retains the history of deleted alarms for a period of
-        six weeks. If an alarm has been deleted, its history can still be
-        queried.
-
-        :type alarm_name: string
-        :param alarm_name: The name of the alarm.
-
-        :type start_date: datetime
-        :param start_date: The starting date to retrieve alarm history.
-
-        :type end_date: datetime
-        :param end_date: The starting date to retrieve alarm history.
-
-        :type history_item_type: string
-        :param history_item_type: The type of alarm histories to retreive
-            (ConfigurationUpdate | StateUpdate | Action)
-
-        :type max_records: int
-        :param max_records: The maximum number of alarm descriptions
-            to retrieve.
-
-        :type next_token: string
-        :param next_token: The token returned by a previous call to indicate
-            that there is more data.
-
-        :rtype list
-        """
-        params = {}
-        if alarm_name:
-            params['AlarmName'] = alarm_name
-        if start_date:
-            params['StartDate'] = start_date.isoformat()
-        if end_date:
-            params['EndDate'] = end_date.isoformat()
-        if history_item_type:
-            params['HistoryItemType'] = history_item_type
-        if max_records:
-            params['MaxRecords'] = max_records
-        if next_token:
-            params['NextToken'] = next_token
-        return self.get_list('DescribeAlarmHistory', params,
-                             [('member', AlarmHistoryItem)])
-
-    def describe_alarms_for_metric(self, metric_name, namespace, period=None,
-                                   statistic=None, dimensions=None, unit=None):
-        """
-        Retrieves all alarms for a single metric. Specify a statistic, period,
-        or unit to filter the set of alarms further.
-
-        :type metric_name: string
-        :param metric_name: The name of the metric
-
-        :type namespace: string
-        :param namespace: The namespace of the metric.
-
-        :type period: int
-        :param period: The period in seconds over which the statistic
-            is applied.
-
-        :type statistic: string
-        :param statistic: The statistic for the metric.
-
-        :param dimension_filters: A dictionary containing name/value
-            pairs that will be used to filter the results.  The key in
-            the dictionary is the name of a Dimension.  The value in
-            the dictionary is either a scalar value of that Dimension
-            name that you want to filter on, a list of values to
-            filter on or None if you want all metrics with that
-            Dimension name.
-
-        :type unit: string
-
-        :rtype list
-        """
-        params = {'MetricName': metric_name,
-                  'Namespace': namespace}
-        if period:
-            params['Period'] = period
-        if statistic:
-            params['Statistic'] = statistic
-        if dimensions:
-            self.build_dimension_param(dimensions, params)
-        if unit:
-            params['Unit'] = unit
-        return self.get_list('DescribeAlarmsForMetric', params,
-                             [('member', MetricAlarm)])
-
-    def put_metric_alarm(self, alarm):
-        """
-        Creates or updates an alarm and associates it with the specified Amazon
-        CloudWatch metric. Optionally, this operation can associate one or more
-        Amazon Simple Notification Service resources with the alarm.
-
-        When this operation creates an alarm, the alarm state is immediately
-        set to INSUFFICIENT_DATA. The alarm is evaluated and its StateValue is
-        set appropriately. Any actions associated with the StateValue is then
-        executed.
-
-        When updating an existing alarm, its StateValue is left unchanged.
-
-        :type alarm: boto.ec2.cloudwatch.alarm.MetricAlarm
-        :param alarm: MetricAlarm object.
-        """
-        params = {
-                    'AlarmName': alarm.name,
-                    'MetricName': alarm.metric,
-                    'Namespace': alarm.namespace,
-                    'Statistic': alarm.statistic,
-                    'ComparisonOperator': alarm.comparison,
-                    'Threshold': alarm.threshold,
-                    'EvaluationPeriods': alarm.evaluation_periods,
-                    'Period': alarm.period,
-                 }
-        if alarm.actions_enabled is not None:
-            params['ActionsEnabled'] = alarm.actions_enabled
-        if alarm.alarm_actions:
-            self.build_list_params(params, alarm.alarm_actions,
-                                   'AlarmActions.member.%s')
-        if alarm.description:
-            params['AlarmDescription'] = alarm.description
-        if alarm.dimensions:
-            self.build_dimension_param(alarm.dimensions, params)
-        if alarm.insufficient_data_actions:
-            self.build_list_params(params, alarm.insufficient_data_actions,
-                                   'InsufficientDataActions.member.%s')
-        if alarm.ok_actions:
-            self.build_list_params(params, alarm.ok_actions,
-                                   'OKActions.member.%s')
-        if alarm.unit:
-            params['Unit'] = alarm.unit
-        alarm.connection = self
-        return self.get_status('PutMetricAlarm', params)
-    create_alarm = put_metric_alarm
-    update_alarm = put_metric_alarm
-
-    def delete_alarms(self, alarms):
-        """
-        Deletes all specified alarms. In the event of an error, no
-        alarms are deleted.
-
-        :type alarms: list
-        :param alarms: List of alarm names.
-        """
-        params = {}
-        self.build_list_params(params, alarms, 'AlarmNames.member.%s')
-        return self.get_status('DeleteAlarms', params)
-
-    def set_alarm_state(self, alarm_name, state_reason, state_value,
-                        state_reason_data=None):
-        """
-        Temporarily sets the state of an alarm. When the updated StateValue
-        differs from the previous value, the action configured for the
-        appropriate state is invoked. This is not a permanent change. The next
-        periodic alarm check (in about a minute) will set the alarm to its
-        actual state.
-
-        :type alarm_name: string
-        :param alarm_name: Descriptive name for alarm.
-
-        :type state_reason: string
-        :param state_reason: Human readable reason.
-
-        :type state_value: string
-        :param state_value: OK | ALARM | INSUFFICIENT_DATA
-
-        :type state_reason_data: string
-        :param state_reason_data: Reason string (will be jsonified).
-        """
-        params = {'AlarmName': alarm_name,
-                  'StateReason': state_reason,
-                  'StateValue': state_value}
-        if state_reason_data:
-            params['StateReasonData'] = json.dumps(state_reason_data)
-
-        return self.get_status('SetAlarmState', params)
-
-    def enable_alarm_actions(self, alarm_names):
-        """
-        Enables actions for the specified alarms.
-
-        :type alarms: list
-        :param alarms: List of alarm names.
-        """
-        params = {}
-        self.build_list_params(params, alarm_names, 'AlarmNames.member.%s')
-        return self.get_status('EnableAlarmActions', params)
-
-    def disable_alarm_actions(self, alarm_names):
-        """
-        Disables actions for the specified alarms.
-
-        :type alarms: list
-        :param alarms: List of alarm names.
-        """
-        params = {}
-        self.build_list_params(params, alarm_names, 'AlarmNames.member.%s')
-        return self.get_status('DisableAlarmActions', params)