aws-sdk-euca 1.8.5

data/lib/aws/glacier/config.rb

@@ -0,0 +1,19 @@
+
+# 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.
+
+AWS::Core::Configuration.module_eval do
+
+  add_service 'Glacier', 'glacier', 'glacier.us-east-1.amazonaws.com'
+
+end

data/lib/aws/glacier/errors.rb

@@ -0,0 +1,22 @@
+# 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 Glacier
+    module Errors
+
+      extend Core::LazyErrorClasses
+
+    end
+  end
+end

data/lib/aws/glacier/request.rb

@@ -0,0 +1,34 @@
+# 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 Glacier
+
+    # @private
+    class Request < Core::Http::Request
+
+      include Core::Signature::Version4
+
+      def initialize
+        super
+        self.headers['x-amz-glacier-version'] = Glacier::Client::API_VERSION
+      end
+
+      def service
+        'glacier'
+      end
+
+    end
+
+  end
+end

data/lib/aws/glacier/resource.rb

@@ -0,0 +1,30 @@
+# 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 Glacier
+    class Resource < Core::Resource
+
+      # @private
+      def initialize *args
+        options = args.last.is_a?(Hash) ? args.last : {}
+        @account_id = options[:account_id] || '-'
+        super
+      end
+
+      # @return [String] :account_id
+      attr_reader :account_id
+
+    end
+  end
+end

data/lib/aws/glacier/vault.rb

@@ -0,0 +1,145 @@
+# 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 Glacier
+
+    #
+    # @attr_reader [String] arn
+    #
+    # @attr_reader [Integer] size_in_bytes
+    #
+    # @attr_reader [Integer] number_of_archives
+    #
+    # @attr_reader [Time] creation_date
+    #
+    # @attr_reader [Time] last_inventory_date
+    #
+    class Vault < Resource
+
+      # @param [String] name
+      # @param [Hash] options
+      # @option options [String] :account_id
+      def initialize name, options = {}
+        @name = name
+        super
+      end
+
+      # @return [String]
+      attr_reader :name
+
+      attribute :arn, :from => :vault_arn, :static => true
+
+      attribute :size_in_bytes
+
+      attribute :number_of_archives
+
+      attribute :creation_date, :static => true
+
+      attribute :last_inventory_date
+
+      populates_from(:list_vaults) do |resp|
+        resp.request_options[:account_id] == account_id and
+        resp[:vault_list].find {|vault| vault[:name] == name }
+      end
+
+      populates_from(:describe_vault) do |resp|
+        if resp.request_options[:account_id] == account_id and resp[:name] == name
+          resp
+        end
+      end
+
+      # @return [Boolean] Returns +true+ if the vault exists.
+      def exists?
+        client.describe_vault(:vault_name => name, :account_id => account_id)
+        true
+      rescue Errors::ResourceNotFoundException
+        false
+      end
+
+      # @return [ArchiveCollection]
+      def archives
+        ArchiveCollection.new(self)
+      end
+
+      # @param [String,SNS::Topic] topic The SNS topic ARN string or an
+      #   SNS::Topic object to send event notifications to.
+      # @param [Array<String>] events An array of one or more events for
+      #   which you want Amazon Glacier to send notifications.
+      #   Valid values include:
+      #   * 'ArchiveRetrievalCompleted'
+      #   * 'InventoryRetrievalCompleted'
+      # @return [VaultNotificationConfiguration]
+      def configure_notifications topic, events
+
+        topic_arn = topic.is_a?(String) ? topic : topic.arn
+
+        cfg = VaultNotificationConfiguration.new
+        cfg.sns_topic = SNS::Topic.new(topic_arn, :config => config)
+        cfg.events = events
+        cfg
+
+        self.notification_configuration = cfg
+
+      end
+
+      # @return [VaultNotificationConfiguration,nil]
+      def notification_configuration
+        resp = client.get_vault_notifications(resource_options)
+        cfg = VaultNotificationConfiguration.new
+        cfg.sns_topic = SNS::Topic.new(resp[:sns_topic], :config => config)
+        cfg.events = resp[:events]
+        cfg
+      rescue Errors::ResourceNotFoundException
+        nil
+      end
+
+      # Sets the notification configuration for this vault.  If you pass
+      # a +nil+ value, the notification configuration will be deleted
+      # @param [VaultNotificationConfiguration] cfg
+      def notification_configuration= cfg
+        if cfg
+          opts = {}
+          opts.merge!(resource_options)
+          opts[:vault_notification_config] = {}
+          opts[:vault_notification_config][:sns_topic] = cfg.sns_topic.arn
+          opts[:vault_notification_config][:events] = cfg.events
+          client.set_vault_notifications(opts)
+        else
+          client.delete_vault_notifications(resource_options)
+        end
+      end
+
+      # Deletes the current vault.  You can only delete an empty vault.
+      # @return [nil]
+      def delete
+        client.delete_vault(resource_options)
+        nil
+      end
+
+      protected
+
+      def get_resource attr = nil
+        client.describe_vault(resource_options)
+      end
+
+      def resource_identifiers
+        [
+          [:vault_name, name],
+          [:account_id, account_id],
+        ]
+      end
+
+    end
+  end
+end

data/lib/aws/glacier/vault_collection.rb

@@ -0,0 +1,75 @@
+# 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 Glacier
+
+    class VaultCollection
+
+      include Core::Collection::WithLimitAndNextToken
+
+      # @param [Hash] options
+      # @option options [String] :account_id
+      def initialize options = {}
+        @account_id = options[:account_id] || '-'
+        super
+      end
+
+      # @return [String]
+      attr_reader :account_id
+
+      # @param [String] name
+      def create name
+
+        options = {}
+        options[:vault_name] = name
+        options[:account_id] = account_id
+        client.create_vault(options)
+
+        self[name]
+
+      end
+
+      # @param [String] name The name of the vault.
+      # @return [Vault] Returns a vault with the given name.
+      def [] name
+        Vault.new(name, :config => config, :account_id => account_id)
+      end
+
+      protected
+
+      def _each_item next_token, limit, options, &block
+
+        options[:limit] = limit if limit
+        options[:marker] = next_token if next_token
+        options[:account_id] = account_id
+
+        resp = client.list_vaults(options)
+        resp[:vault_list].each do |v|
+
+          vault = Vault.new_from(:list_vaults, v,
+            v[:vault_name],
+            :config => config, 
+            :account_id => account_id)
+
+          yield(vault)
+
+        end
+
+        resp[:marker]
+
+      end
+
+    end
+  end
+end

data/lib/aws/glacier/vault_notification_configuration.rb

@@ -0,0 +1,29 @@
+# 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 Glacier
+    class VaultNotificationConfiguration
+
+      # @return [SNS::Topic] The SNS topic Glacier will publish events to.
+      attr_accessor :sns_topic
+
+      alias_method :topic, :sns_topic
+
+      # @return [Array<String>] events An array of one or more events for
+      #   which Amazon Glacier will send notifications.
+      attr_accessor :events
+
+    end
+  end
+end

data/lib/aws/iam.rb

@@ -0,0 +1,420 @@
+# 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.
+
+require 'aws/core'
+require 'aws/iam/config'
+
+module AWS
+
+  # This class is the starting point for working with 
+  # AWS Identity and Access Management (IAM).
+  #
+  # For more information about IAM:
+  #
+  # * {AWS Identity and Access Management}[http://aws.amazon.com/iam/]
+  # * {AWS Identity and Access Management Documentation}[http://aws.amazon.com/documentation/iam/]
+  #
+  # = Credentials
+  #
+  # You can setup default credentials for all AWS services via 
+  # AWS.config:
+  #
+  #   AWS.config(
+  #     :access_key_id => 'YOUR_ACCESS_KEY_ID',
+  #     :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
+  # 
+  # Or you can set them directly on the IAM interface:
+  #
+  #   iam = AWS::IAM.new(
+  #     :access_key_id => 'YOUR_ACCESS_KEY_ID',
+  #     :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
+  #
+  # = Account Summary
+  #
+  # You can get account level information about entity usage and IAM quotas
+  # directly from an IAM interface object.
+  #
+  #   summary = iam.account_summary
+  #
+  #   puts "Num users: #{summary[:users]}"
+  #   puts "Num user quota: #{summary[:users_quota]}"
+  #
+  # For a complete list of summary attributes see the {#account_summary} method.
+  #
+  # = Account Aliases
+  #
+  # Currently IAM only supports a single account alias for each AWS account.
+  # You can set the account alias on the IAM interface.
+  #
+  #   iam.account_alias = 'myaccountalias'
+  #   iam.account_alias
+  #   #=> 'myaccountalias'
+  #
+  # You can also remove your account alias:
+  #
+  #   iam.remove_account_alias
+  #   iam.account_alias
+  #   #=> nil
+  #
+  # = Access Keys
+  #
+  # You can create up to 2 access for your account and 2 for each user.
+  # This makes it easy to rotate keys if you need to.  You can also
+  # deactivate/activate access keys.
+  #
+  #   # get your current access key
+  #   old_access_key = iam.access_keys.first
+  #
+  #   # create a new access key
+  #   new_access_key = iam.access_keys.create
+  #   new_access_key.credentials
+  #   #=> { :access_key_id => 'ID', :secret_access_key => 'SECRET' }
+  #
+  #   # go rotate your keys/credentials ...
+  #
+  #   # now disable the old access key
+  #   old_access_key.deactivate!
+  #
+  #   # go make sure everything still works ...
+  #
+  #   # all done, lets clean up
+  #   old_access_key.delete
+  #
+  # Users can also have access keys:
+  #
+  #   u = iam.users['someuser']
+  #   access_key = u.access_keys.create
+  #   access_key.credentials
+  #   #=> { :access_key_id => 'ID', :secret_access_key => 'SECRET' }
+  #
+  # See {AccessKeyCollection} and {AccessKey} for more information about
+  # working with access keys.
+  #
+  # = Users & Groups
+  #
+  # Each AWS account can have multiple users.  Users can be used to easily
+  # manage permissions.  Users can also be organized into groups.  
+  #
+  #   user = iam.users.create('JohnDoe')
+  #   group = iam.groups.create('Developers')
+  #
+  #   # add a user to a group
+  #   user.groups.add(group)
+  #
+  #   # remove a user from a group
+  #   user.groups.remove(group)
+  #
+  #   # add a user to a group
+  #   group.users.add(user)
+  #
+  #   # remove a user from a group
+  #   group.users.remove(user)
+  #
+  # See {User}, {UserCollection}, {Group} and {GroupCollection} for more
+  # information on how to work with users and groups.
+  #
+  # = Other Interfaces
+  #
+  # Other useful IAM interfaces:
+  # * User Login Profiles ({LoginProfile})
+  # * Policies ({Policy})
+  # * Server Certificates ({ServerCertificateCollection}, {ServerCertificate})
+  # * Signing Certificates ({SigningCertificateCollection}, {SigningCertificate})
+  # * Multifactor Authentication Devices ({MFADeviceCollection}, {MFADevice})
+  #
+  # @!attribute [r] client
+  #   @return [Client] the low-level IAM client object
+  class IAM
+
+    AWS.register_autoloads(self) do
+      autoload :AccessKey,                    'access_key'
+      autoload :AccessKeyCollection,          'access_key_collection'
+      autoload :AccountAliasCollection,       'account_alias_collection'
+      autoload :Client,                       'client'
+      autoload :Collection,                   'collection'
+      autoload :Errors,                       'errors'
+      autoload :Group,                        'group'
+      autoload :GroupCollection,              'group_collection'
+      autoload :GroupPolicyCollection,        'group_policy_collection'
+      autoload :GroupUserCollection,          'group_user_collection'
+      autoload :LoginProfile,                 'login_profile'
+      autoload :MFADevice,                    'mfa_device'
+      autoload :MFADeviceCollection,          'mfa_device_collection'
+      autoload :Policy,                       'policy'
+      autoload :PolicyCollection,             'policy_collection'
+      autoload :Request,                      'request'
+      autoload :Resource,                     'resource'
+      autoload :ServerCertificate,            'server_certificate'
+      autoload :ServerCertificateCollection,  'server_certificate_collection'
+      autoload :SigningCertificate,           'signing_certificate'
+      autoload :SigningCertificateCollection, 'signing_certificate_collection'
+      autoload :User,                         'user'
+      autoload :UserCollection,               'user_collection'
+      autoload :UserGroupCollection,          'user_group_collection'
+      autoload :UserPolicy,                   'user_policy'
+      autoload :UserPolicyCollection,         'user_policy_collection'
+      autoload :VirtualMfaDeviceCollection,   'virtual_mfa_device_collection'
+      autoload :VirtualMfaDevice,             'virtual_mfa_device'
+    end
+
+    include Core::ServiceInterface
+
+    # Returns a collection that represents all AWS users for this account:
+    #
+    # @example Getting a user by name
+    #
+    #   user = iam.users['username']
+    #
+    # @example Enumerating users
+    #
+    #   iam.users.each do |user|
+    #     puts user.name
+    #   end
+    # 
+    # @return [UserCollection] Returns a collection that represents all of
+    #   the IAM users for this AWS account.
+    def users
+      UserCollection.new(:config => config)
+    end
+
+    # Returns a collection that represents all AWS groups for this account:
+    #
+    # @example Getting a group by name
+    #
+    #   group = iam.groups['groupname']
+    #
+    # @example Enumerating groups
+    #
+    #   iam.groups.each do |group|
+    #     puts group.name
+    #   end
+    #
+    # @return [GroupCollection] Returns a collection that represents all of
+    #   the IAM groups for this AWS account.
+    def groups
+      GroupCollection.new(:config => config)
+    end
+
+    # Returns a collection that represents the access keys for this 
+    # AWS account.
+    #
+    #   iam = AWS::IAM.new
+    #   iam.access_keys.each do |access_key|
+    #     puts access_key.id
+    #   end
+    #
+    # @return [AccessKeyCollection] Returns a collection that represents all
+    #   access keys for this AWS account.
+    def access_keys
+      AccessKeyCollection.new(:config => config)
+    end
+
+    # Returns a collection that represents the signing certificates
+    # for this AWS account.  
+    #
+    #   iam = AWS::IAM.new
+    #   iam.signing_certificates.each do |cert|
+    #     # ...
+    #   end
+    #
+    # If you need to access the signing certificates of a specific user,
+    # see {User#signing_certificates}.
+    # 
+    # @return [SigningCertificateCollection] Returns a collection that
+    #   represents signing certificates for this AWS account.
+    def signing_certificates
+      SigningCertificateCollection.new(:config => config)
+    end
+
+    # @note Currently, Amazon Elastic Load Balancing is the only
+    #   service to support the use of server certificates with
+    #   IAM. Using server certificates with Amazon Elastic Load
+    #   Balancing is described in the
+    #   {http://docs.amazonwebservices.com/ElasticLoadBalancing/latest/DeveloperGuide/US_SettingUpLoadBalancerHTTPSIntegrated.html
+    #   Amazon Elastic Load Balancing} Developer Guide.
+    #
+    # Returns a collection that represents the server certificates
+    # for this AWS account.
+    #
+    #   iam = AWS::IAM.new
+    #   iam.server_certificates.each do |cert|
+    #     # ...
+    #   end
+    #
+    # @return [ServerCertificateCollection] Returns a collection that
+    #   represents server certificates for this AWS account.
+    def server_certificates
+      ServerCertificateCollection.new(:config => config)
+    end
+
+    # Returns a collection that represents the virtual MFA devices
+    # that are not assigned to an IAM user.
+    #
+    #   iam = AWS::IAM.new
+    #   iam.virtual_mfa_devices.each do |cert|
+    #     # ...
+    #   end
+    #
+    # @return [VirtualMfaDeviceCollection] Returns a collection that
+    #   represents the virtual MFA devices that are not assigned to an
+    #   IAM user.
+    def virtual_mfa_devices
+      VirtualMfaDeviceCollection.new(:config => config)
+    end
+
+    # Sets the account alias for this AWS account.
+    # @param [String] account_alias
+    # @return [String] Returns the account alias passed.
+    def account_alias= account_alias
+      account_alias.nil? ?
+        remove_account_alias :
+        account_aliases.create(account_alias)
+    end
+
+    # @return [String,nil] Returns the account alias.  If this account has
+    #   no alias, then +nil+ is returned.
+    def account_alias
+      account_aliases.first
+    end
+
+    # Deletes the account alias (if one exists).
+    # @return [nil] 
+    def remove_account_alias
+      account_aliases.each do |account_alias|
+        account_aliases.delete(account_alias)
+      end
+      nil
+    end
+
+    # @private
+    def account_aliases
+      AccountAliasCollection.new(:config => config)
+    end
+
+    # Retrieves account level information about account entity usage
+    # and IAM quotas.  The returned hash contains the following keys:
+    #
+    # [+:users+] Number of users for the AWS account
+    #
+    # [+:users_quota+] Maximum users allowed for the AWS account
+    #
+    # [+:groups+] Number of Groups for the AWS account
+    #
+    # [+:groups_quota+] Maximum Groups allowed for the AWS account
+    #
+    # [+:server_certificates+] Number of Server Certificates for the
+    #                          AWS account
+    #
+    # [+:server_certificates_quota+] Maximum Server Certificates
+    #                                allowed for the AWS account
+    #
+    # [+:user_policy_size_quota+] Maximum allowed size for user policy
+    #                             documents (in kilobytes)
+    #
+    # [+:group_policy_size_quota+] Maximum allowed size for Group
+    #                              policy documents (in kilobyes)
+    #
+    # [+:groups_per_user_quota+] Maximum number of groups a user can
+    #                            belong to
+    #
+    # [+:signing_certificates_per_user_quota+] Maximum number of X509
+    #                                          certificates allowed
+    #                                          for a user
+    #
+    # [+:access_keys_per_user_quota+] Maximum number of access keys
+    #                                 that can be created per user
+    #
+    # @return [Hash]
+    def account_summary
+      client.get_account_summary.data[:summary_map].inject({}) do |h,(k,v)|
+        h.merge(Core::Inflection.ruby_name(k).to_sym => v)
+      end
+    end
+
+    # Changes the web password associated with the current IAM user.
+    # In order to change your password you must configure the sdk
+    # to use your IAM user credentials.
+    #
+    #
+    # To change a user password, you must be using credentials from the
+    # user you want to change:
+    #
+    #   # pass in a key pair generated for the user you want to change 
+    #   # the password for
+    #   iam = AWS::IAM.new(:access_key_id => '...', :secret_access_key => '...)
+    #   iam.change_password('old-password', 'new-password')
+    #
+    # @param [String] old_password
+    #
+    # @param [String] new_password
+    #
+    # @return [nil]
+    #
+    def change_password old_password, new_password
+      client_opts = {}
+      client_opts[:old_password] = old_password
+      client_opts[:new_password] = new_password
+      client.change_password(client_opts)
+      nil
+    end
+
+    # Updates the account password policy for all IAM accounts.
+    # @param [Hash] options
+    # @option options [Integer] :minimum_password_length 
+    # @option options [Boolean] :require_symbols
+    # @option options [Boolean] :require_numbers
+    # @option options [Boolean] :require_uppercase_characters
+    # @option options [Boolean] :require_lowercase_characters
+    # @return [nil]
+    def update_account_password_policy options = {}
+      client.update_account_password_policy(options)
+      nil
+    end
+
+    # Removes the account password policy.
+    # @return [nil]
+    def delete_account_password_policy
+      client.delete_account_password_policy
+      nil
+    end
+
+    # Returns the account password policy details as a hash.  This method
+    # returns nil if no password policy has been set for this account.
+    #
+    #   # set the policy
+    #   iam.update_account_password_policy :minimum_password_length => 8
+    #
+    #   iam.account_password_policy
+    #   #=> {:require_symbols=>false, :require_numbers=>false, :require_uppercase_characters=>false, :require_lowercase_characters=>false, :minimum_password_length=>8}
+    #
+    # @return [Hash,nil]
+    def account_password_policy
+      begin
+        policy = client.get_account_password_policy.password_policy
+        [
+          :minimum_password_length,
+          :require_symbols?,
+          :require_numbers?,
+          :require_uppercase_characters?,
+          :require_lowercase_characters?,
+        ].inject({}) do |hash,method|
+          key = method.to_s.sub(/\?/, '').to_sym
+          hash.merge(key => policy.send(method))
+        end
+      rescue Errors::NoSuchEntity
+        nil
+      end
+    end
+
+  end
+end