aws-sdk 1.51.0 → 1.52.0

data/lib/aws/iam/policy.rb

@@ -1,46 +0,0 @@
-# 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 IAM
-
-    # (see AWS::Core::Policy)
-    class Policy < Core::Policy
-
-      def to_h
-        hash = super
-        hash.delete('Id')
-        hash['Statement'].each do |statement|
-          statement.delete('Sid')
-          statement.delete('Principal')
-        end
-        hash
-      end
-
-      class Statement < Core::Policy::Statement
-
-        ACTION_MAPPING = { }
-
-        protected
-        def resource_arn resource
-          case resource
-          when User then resource.arn
-          else super(resource)
-          end
-        end
-
-      end
-
-    end
-  end
-end

data/lib/aws/iam/policy_collection.rb

@@ -1,188 +0,0 @@
-# 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 'uri'
-
-module AWS
-  class IAM
-
-    # Shared methods exposing a collection of policy documents
-    # associated with an IAM resource (a {User} or a {Group}).  Policy
-    # collections can be constructed using {Group#policies} and
-    # {User#policies}.
-    module PolicyCollection
-
-      include Collection
-
-      # Retrieves a policy document by name.
-      #
-      # @param [String] name The name of the policy to retrieve.
-      #
-      # @return [Policy] The policy with the given name.  If no such
-      #   policy exists, this method returns `nil`.
-      def [] name
-        resp = get_policy(:policy_name => name)
-        Policy.from_json(URI.unescape(resp.policy_document))
-      rescue Errors::NoSuchEntity => e
-        nil
-      end
-
-      # Adds or replaces a policy document.
-      #
-      # @param [String] name The name of the policy document.
-      #
-      # @param [Policy,String] document The policy document.  This can
-      #   be a JSON string, or any object that responds to `to_json`.
-      #   The {Policy} class provides a convenient way to construct
-      #   policy documents that you can use with AWS IAM.
-      def []= name, document
-        document = document.to_json if document.respond_to?(:to_json) and
-          !document.kind_of?(String)
-        put_policy(:policy_name => name,
-                   :policy_document => document)
-      end
-
-      # Deletes a policy by name.  This method is idempotent; if no
-      # policy exists with the given name, the method does nothing.
-      #
-      # @param [String] name The name of the policy document.
-      def delete(name)
-        delete_policy(:policy_name => name)
-        nil
-      rescue Errors::NoSuchEntity => e
-        nil
-      end
-
-      # Retrieves multiple policy documents by name.  This method
-      # makes one request to AWS IAM per argument.
-      #
-      # @param names Each argument is the name of a policy to retrieve.
-      #
-      # @return [Array<Policy>] An array containing the requested
-      #   policy documents, in the same order as the argument list.
-      #   If a requested policy does not exist, the array member
-      #   corresponding to that argument will be `nil`.
-      def values_at(*names)
-        names.map { |n| self[n] }
-      end
-
-      # @return [Enumerator<String>] An enumerator for retrieving all
-      #   the policy names that are currently associated with the
-      #   resource.
-      def keys
-        enumerator(:names_only => true)
-      end
-      alias_method :names, :keys
-
-      # @return [Enumerator<Policy>] An enumerator for retrieving all
-      #   the policy documents that are currently associated with the
-      #   resource.
-      def values
-        enumerator(:values_only => true)
-      end
-
-      # Removes all policies from the collection.
-      def clear
-        keys.each { |k| delete(k) }
-      end
-
-      # @param [String] name The name of the policy to check.
-      #
-      # @return [Boolean] True if there is a policy with the given name.
-      def has_key? name
-        get_policy(:policy_name => name)
-        true
-      rescue Errors::NoSuchEntity => e
-        false
-      end
-      alias_method :include?, :has_key?
-      alias_method :key?, :has_key?
-      alias_method :member?, :has_key?
-
-      # @yield [name, policy] The name and document for each policy
-      #   that is associated with the resource.  Like `Hash#each`,
-      #   this method is sensitive to the arity of the provided block;
-      #   if the block takes two arguments, they will be the name and
-      #   document.  If it accepts only one argument, it will be an
-      #   array containing the name and document.
-      def each opts = {}, &block
-        opts = opts.dup
-        names_only = opts.delete(:names_only)
-        values_only = opts.delete(:values_only)
-        super(client_opts(opts)) do |pn|
-          case
-          when names_only
-            yield pn
-          when values_only
-            yield self[pn]
-          when block.arity == 2
-            yield pn, self[pn]
-          else
-            yield [pn, self[pn]]
-          end
-        end
-      end
-
-      # @return [Hash] The contents of the collection as a hash.
-      def to_h
-        inject({}) do |hash, (name, policy)|
-          hash[name] = policy
-          hash
-        end
-      end
-
-      protected
-      def get_policy(opts = {})
-        client.send("get_#{resource_name}_policy",
-                    client_opts(opts))
-      end
-
-      protected
-      def put_policy(opts = {})
-        client.send("put_#{resource_name}_policy",
-                    client_opts(opts))
-      end
-
-      protected
-      def request_method
-        :"list_#{resource_name}_policies"
-      end
-
-      protected
-      def delete_policy(opts = {})
-        client.send("delete_#{resource_name}_policy",
-                    client_opts(opts))
-      end
-
-      protected
-      def client_opts(opts = {})
-        Hash[[[:"#{resource_name}_name",
-               send(resource_name).name]]].merge(opts)
-      end
-
-      protected
-      def resource_name
-        raise NotImplementedError unless
-          self.class.name =~ /AWS::IAM::(.*)PolicyCollection$/
-        $1.downcase
-      end
-
-      protected
-      def each_item(response, &block)
-        response.data[:policy_names].each(&block)
-      end
-
-    end
-
-  end
-end

data/lib/aws/iam/resource.rb

@@ -1,62 +0,0 @@
-# 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 IAM
-    class Resource < Core::Resource
-
-      # @return [Boolean] Returns `true` if the resource exists.
-      def exists?
-        get_resource
-        true
-      rescue Errors::NoSuchEntity => e
-        false
-      end
-
-      private
-
-      def update_resource attr, value
-        options = { :"#{self.class.update_prefix}#{attr.set_as}" => value }
-        client_method = update_resource_client_method
-        client.send(client_method, options.merge(resource_options))
-      end
-
-      def get_resource attribute = nil
-        client.send(get_resource_client_method, resource_options)
-      end
-
-      def get_resource_client_method
-        "get_#{ruby_name}"
-      end
-
-      def update_resource_client_method
-        "update_#{ruby_name}"
-      end
-
-      class << self
-
-        # @api private
-        def prefix_update_attributes prefix = 'new_'
-          @update_prefix = prefix
-        end
-
-        # @api private
-        def update_prefix
-          @update_prefix
-        end
-
-      end
-
-    end
-  end
-end

data/lib/aws/iam/server_certificate.rb

@@ -1,148 +0,0 @@
-# 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 IAM
-
-    # Respresents a server certificate.
-    #
-    #     certificate = iam.server_certificates["MyCert"]
-    #
-    # You can use this class to get information about a certificate
-    # and to delete it.
-    #
-    # @attr [String] name The name that identifies the server certificate.
-    #
-    # @attr_reader [String] id The stable and unique string identifying
-    #   the server certificate.
-    #
-    # @attr_reader [Time] updload_date The date when the server certificate was
-    #   uploaded.
-    #
-    # @attr_reader [String] arn The Amazon Resource Name (ARN)
-    #   specifying the server certificate. For more information
-    #   about ARNs and how to use them in policies, see
-    #   {http://docs.amazonwebservices.com/IAM/latest/UserGuide/index.html?Using_Identifiers.html
-    #   Identifiers for IAM Entities} in <i>Using AWS Identity and
-    #   Access Management</i>.
-    #
-    # @attr [String] path Path to the server certificate.
-    #
-    # @attr_reader [String] certificate_body The contents of the public key
-    #   certificate.
-    #
-    # @attr_reader [String] certificate_chain The contents of the public key
-    #   certificate chain.
-    #
-    class ServerCertificate < Resource
-
-      prefix_update_attributes
-
-      # @api private
-      def initialize(name, opts={})
-        opts[:name] = name
-        super(opts)
-      end
-
-      mutable_attribute :name, :static => true, :from => :server_certificate_name
-
-      attribute :id, :static => true, :from => :server_certificate_id
-
-      attribute :upload_date, :static => true
-
-      attribute :arn
-
-      mutable_attribute :path do
-        translates_input do |path|
-          path = "/#{path}" unless path[0] == ?/
-          path = "#{path}/" unless path[-1] == ?/
-          path
-        end
-      end
-
-      attribute :certificate_body
-
-      attribute :certificate_chain
-
-      provider(:get_server_certificate) do |provider|
-        # for metadata attributes
-        provider.find do |resp|
-          cert, meta = response_objects(resp)
-          meta
-        end
-        provider.provides :name, :id, :upload_date, :arn, :path
-      end
-
-      provider(:get_server_certificate) do |provider|
-        # for data attributes
-        provider.find do |resp|
-          cert, meta = response_objects(resp)
-          cert
-        end
-        provider.provides :certificate_body, :certificate_chain
-      end
-
-      populates_from(:upload_server_certificate) do |resp|
-        resp.server_certificate_metadata if
-          resp.server_certificate_metadata.server_certificate_name == name
-      end
-
-      populates_from(:list_server_certificates) do |resp|
-        resp.server_certificate_metadata_list.find do |sc|
-          sc.server_certificate_name == name
-        end
-      end
-
-      # Deletes the specified server certificate.
-      #
-      # @note If you are using a server certificate with Elastic Load
-      #   Balancing, deleting the certificate could have implications
-      #   for your application. If Elastic Load Balancing doesn't
-      #   detect the deletion of bound certificates, it may continue
-      #   to use the certificates. This could cause Elastic Load
-      #   Balancing to stop accepting traffic. We recommend that you
-      #   remove the reference to the certificate from Elastic Load
-      #   Balancing before using this command to delete the
-      #   certificate. For more information, go to
-      #   {http://docs.amazonwebservices.com/ElasticLoadBalancing/latest/APIReference/API_DeleteLoadBalancerListeners.html
-      #   DeleteLoadBalancerListeners} in the _Elastic Load Balancing
-      #   API Reference_.
-      #
-      # @return [nil]
-      def delete
-        client.delete_server_certificate(resource_options)
-        nil
-      end
-
-      # @api private
-      protected
-      def resource_identifiers
-        [[:server_certificate_name, name]]
-      end
-
-      # extract response objects from get_server_certificate
-      private
-      def response_objects(resp)
-        if cert = resp.server_certificate and
-            meta = cert.server_certificate_metadata and
-            meta.server_certificate_name == name
-          [cert, meta]
-        else
-          [nil, nil]
-        end
-      end
-
-    end
-
-  end
-end

data/lib/aws/iam/server_certificate_collection.rb

@@ -1,138 +0,0 @@
-# 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 IAM
-
-    # A collection that provides access to IAM server certificates
-    # belonging to this account.
-    #
-    #     iam = AWS::IAM.new
-    #     certificates = iam.server_certificates
-    #
-    # ## Uploading A Server Certificate
-    #
-    # You can upload any valid, signed certificate using {#upload}.
-    #
-    #     certificates.upload(:name => "MyCert",
-    #                         :certificate_body => my_certificate_body,
-    #                         :private_key => my_private_key)
-    #
-    # For information about generating a server certificate for use
-    # with IAM, see
-    # {http://docs.amazonwebservices.com/IAM/latest/UserGuide/InstallCert.html
-    # Creating and Uploading Server Certificates} in <i>Using AWS
-    # Identity and Access Management</i>.
-    #
-    # ## Getting a Server Certificate by Name
-    #
-    # You can get a reference to a server certificate using array notation:
-    #
-    #     certificate = certificates['MyCert']
-    #
-    # ## Enumerating Server Certificates
-    #
-    # Server certificate collections can also be used to enumerate
-    # certificates:
-    #
-    #     certificates.each do |cert|
-    #       puts cert.name
-    #     end
-    #
-    # You can limit the certificates returned by passing a `:prefix`
-    # option to any of the enumerator methods.  When you pass a
-    # prefix, only the certificates whose paths start with the given
-    # string will be returned.
-    class ServerCertificateCollection
-
-      include Collection::WithPrefix
-
-      # Uploads a server certificate entity for the AWS account. The
-      # server certificate entity includes a public key certificate, a
-      # private key, and an optional certificate chain, which should
-      # all be PEM-encoded.
-      #
-      # @param [Hash] options Options for uploading the certificate.
-      #   `:name`, `:certificate_body`, and `:private_key` are
-      #   required.
-      #
-      # @option options [String] :certificate_body The contents of the
-      #   public key certificate in PEM-encoded format.
-      #
-      # @option options [String] :name The name for the server
-      #   certificate. Do not include the path in this value.
-      #
-      # @option options [String] :path The path for the server
-      #   certificate. For more information about paths, see
-      #   {http://docs.amazonwebservices.com/IAM/latest/UserGuide/index.html?Using_Identifiers.html
-      #   Identifiers for IAM Entities} in <i>Using AWS Identity and
-      #   Access Management</i>.
-      #
-      # @option options [String] :private_key The contents of the
-      #   private key in PEM-encoded format.
-      #
-      # @option options [String] :certificate_chain The contents of
-      #   the certificate chain. This is typically a concatenation of
-      #   the PEM-encoded public key certificates of the chain.
-      #
-      # @return [ServerCertificate] The newly created server
-      #   certificate.
-      def create options = {}
-
-        client_opts = options.dup
-        client_opts[:server_certificate_name] = client_opts.delete(:name)
-
-        if path = client_opts[:path]
-          client_opts[:path] = "/#{path}/".
-            sub(%r{^//}, "/").
-            sub(%r{//$}, "/")
-        end
-
-        resp = client.upload_server_certificate(client_opts)
-
-        ServerCertificate.new(
-          resp[:server_certificate_metadata][:server_certificate_name],
-          :config => config)
-
-      end
-      alias_method :upload, :create
-
-      # Returns a reference to the server certificate with the given
-      # name:
-      #
-      #   certificate = iam.server_certificates['MyCert']
-      #
-      # @param [String] name Name of the server certificate.
-      #
-      # @return [ServerCertificate] Returns a reference to the named
-      #   server certificate.
-      def [] name
-        ServerCertificate.new(name, :config => config)
-      end
-
-      # @api private
-      protected
-      def each_item response, &block
-        response.server_certificate_metadata_list.each do |sc|
-          certificate = ServerCertificate.new_from(:list_server_certificates,
-                                                   sc,
-                                                   sc.server_certificate_name,
-                                                   :config => config)
-          yield(certificate)
-        end
-      end
-
-    end
-
-  end
-end