aws-sdk-iam 1.0.0.rc1

data/lib/aws-sdk-iam/group_policy.rb

@@ -0,0 +1,178 @@
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing for info on making contributions:
+# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+module Aws
+  module IAM
+    class GroupPolicy
+
+      extend Aws::Deprecations
+
+      # @overload def initialize(group_name, name, options = {})
+      #   @param [String] group_name
+      #   @param [String] name
+      #   @option options [Client] :client
+      # @overload def initialize(options = {})
+      #   @option options [required, String] :group_name
+      #   @option options [required, String] :name
+      #   @option options [Client] :client
+      def initialize(*args)
+        options = Hash === args.last ? args.pop.dup : {}
+        @group_name = extract_group_name(args, options)
+        @name = extract_name(args, options)
+        @data = options.delete(:data)
+        @client = options.delete(:client) || Client.new(options)
+      end
+
+      # @!group Read-Only Attributes
+
+      # @return [String]
+      def group_name
+        @group_name
+      end
+
+      # @return [String]
+      def name
+        @name
+      end
+      alias :policy_name :name
+
+      # The policy document.
+      # @return [String]
+      def policy_document
+        data.policy_document
+      end
+
+      # @!endgroup
+
+      # @return [Client]
+      def client
+        @client
+      end
+
+      # Loads, or reloads {#data} for the current {GroupPolicy}.
+      # Returns `self` making it possible to chain methods.
+      #
+      #     group_policy.reload.data
+      #
+      # @return [self]
+      def load
+        resp = @client.get_group_policy(
+          group_name: @group_name,
+          policy_name: @name
+        )
+        @data = resp.data
+        self
+      end
+      alias :reload :load
+
+      # @return [Types::GetGroupPolicyResponse]
+      #   Returns the data for this {GroupPolicy}. Calls
+      #   {Client#get_group_policy} if {#data_loaded?} is `false`.
+      def data
+        load unless @data
+        @data
+      end
+
+      # @return [Boolean]
+      #   Returns `true` if this resource is loaded.  Accessing attributes or
+      #   {#data} on an unloaded resource will trigger a call to {#load}.
+      def data_loaded?
+        !!@data
+      end
+
+      # @!group Actions
+
+      # @example Request syntax with placeholder values
+      #
+      #   group_policy.delete()
+      # @param [Hash] options ({})
+      # @return [EmptyStructure]
+      def delete(options = {})
+        options = options.merge(
+          group_name: @group_name,
+          policy_name: @name
+        )
+        resp = @client.delete_group_policy(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   group_policy.put({
+      #     policy_document: "policyDocumentType", # required
+      #   })
+      # @param [Hash] options ({})
+      # @option options [required, String] :policy_document
+      #   The policy document.
+      #
+      #   The [regex pattern][1] for this parameter is a string of characters
+      #   consisting of any printable ASCII character ranging from the space
+      #   character (\\u0020) through end of the ASCII character range
+      #   (\\u00FF). It also includes the special characters tab (\\u0009), line
+      #   feed (\\u000A), and carriage return (\\u000D).
+      #
+      #
+      #
+      #   [1]: http://wikipedia.org/wiki/regex
+      # @return [EmptyStructure]
+      def put(options = {})
+        options = options.merge(
+          group_name: @group_name,
+          policy_name: @name
+        )
+        resp = @client.put_group_policy(options)
+        resp.data
+      end
+
+      # @!group Associations
+
+      # @return [Group]
+      def group
+        Group.new(
+          name: @group_name,
+          client: @client
+        )
+      end
+
+      # @deprecated
+      # @api private
+      def identifiers
+        {
+          group_name: @group_name,
+          name: @name
+        }
+      end
+      deprecated(:identifiers)
+
+      private
+
+      def extract_group_name(args, options)
+        value = args[0] || options.delete(:group_name)
+        case value
+        when String then value
+        when nil then raise ArgumentError, "missing required option :group_name"
+        else
+          msg = "expected :group_name to be a String, got #{value.class}"
+          raise ArgumentError, msg
+        end
+      end
+
+      def extract_name(args, options)
+        value = args[1] || options.delete(:name)
+        case value
+        when String then value
+        when nil then raise ArgumentError, "missing required option :name"
+        else
+          msg = "expected :name to be a String, got #{value.class}"
+          raise ArgumentError, msg
+        end
+      end
+
+      class Collection < Aws::Resources::Collection; end
+    end
+  end
+end

data/lib/aws-sdk-iam/instance_profile.rb

@@ -0,0 +1,264 @@
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing for info on making contributions:
+# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+module Aws
+  module IAM
+    class InstanceProfile
+
+      extend Aws::Deprecations
+
+      # @overload def initialize(name, options = {})
+      #   @param [String] name
+      #   @option options [Client] :client
+      # @overload def initialize(options = {})
+      #   @option options [required, String] :name
+      #   @option options [Client] :client
+      def initialize(*args)
+        options = Hash === args.last ? args.pop.dup : {}
+        @name = extract_name(args, options)
+        @data = options.delete(:data)
+        @client = options.delete(:client) || Client.new(options)
+      end
+
+      # @!group Read-Only Attributes
+
+      # @return [String]
+      def name
+        @name
+      end
+      alias :instance_profile_name :name
+
+      # The path to the instance profile. For more information about paths,
+      # see [IAM Identifiers][1] in the *Using IAM* guide.
+      #
+      #
+      #
+      # [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html
+      # @return [String]
+      def path
+        data.path
+      end
+
+      # The stable and unique string identifying the instance profile. For
+      # more information about IDs, see [IAM Identifiers][1] in the *Using
+      # IAM* guide.
+      #
+      #
+      #
+      # [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html
+      # @return [String]
+      def instance_profile_id
+        data.instance_profile_id
+      end
+
+      # The Amazon Resource Name (ARN) specifying the instance profile. For
+      # more information about ARNs and how to use them in policies, see [IAM
+      # Identifiers][1] in the *Using IAM* guide.
+      #
+      #
+      #
+      # [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html
+      # @return [String]
+      def arn
+        data.arn
+      end
+
+      # The date when the instance profile was created.
+      # @return [Time]
+      def create_date
+        data.create_date
+      end
+
+      # @!endgroup
+
+      # @return [Client]
+      def client
+        @client
+      end
+
+      # Loads, or reloads {#data} for the current {InstanceProfile}.
+      # Returns `self` making it possible to chain methods.
+      #
+      #     instance_profile.reload.data
+      #
+      # @return [self]
+      def load
+        resp = @client.get_instance_profile(instance_profile_name: @name)
+        @data = resp.instanceprofile
+        self
+      end
+      alias :reload :load
+
+      # @return [Types::InstanceProfile]
+      #   Returns the data for this {InstanceProfile}. Calls
+      #   {Client#get_instance_profile} if {#data_loaded?} is `false`.
+      def data
+        load unless @data
+        @data
+      end
+
+      # @return [Boolean]
+      #   Returns `true` if this resource is loaded.  Accessing attributes or
+      #   {#data} on an unloaded resource will trigger a call to {#load}.
+      def data_loaded?
+        !!@data
+      end
+
+      # @param [Hash] options ({})
+      # @return [Boolean]
+      #   Returns `true` if the InstanceProfile exists.
+      def exists?(options = {})
+        begin
+          wait_until_exists(options.merge(max_attempts: 1))
+          true
+        rescue Aws::Waiters::Errors::UnexpectedError => e
+          raise e.error
+        rescue Aws::Waiters::Errors::WaiterFailed
+          false
+        end
+      end
+
+      # @param [Hash] options ({})
+      # @option options [Integer] :max_attempts (40)
+      # @option options [Float] :delay (1)
+      # @option options [Proc] :before_attempt
+      # @option options [Proc] :before_wait
+      # @return [InstanceProfile]
+      def wait_until_exists(options = {})
+        options, params = separate_params_and_options(options)
+        waiter = Waiters::InstanceProfileExists.new(options)
+        yield_waiter_and_warn(waiter, &Proc.new) if block_given?
+        waiter.wait(params.merge(instance_profile_name: @name))
+        InstanceProfile.new({
+          name: @name,
+          client: @client
+        })
+      end
+
+      # @!group Actions
+
+      # @example Request syntax with placeholder values
+      #
+      #   instance_profile.add_role({
+      #     role_name: "roleNameType", # required
+      #   })
+      # @param [Hash] options ({})
+      # @option options [required, String] :role_name
+      #   The name of the role to add.
+      #
+      #   The [regex pattern][1] for this parameter is a string of characters
+      #   consisting of upper and lowercase alphanumeric characters with no
+      #   spaces. You can also include any of the following characters: =,.@-
+      #
+      #
+      #
+      #   [1]: http://wikipedia.org/wiki/regex
+      # @return [EmptyStructure]
+      def add_role(options = {})
+        options = options.merge(instance_profile_name: @name)
+        resp = @client.add_role_to_instance_profile(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   instance_profile.delete()
+      # @param [Hash] options ({})
+      # @return [EmptyStructure]
+      def delete(options = {})
+        options = options.merge(instance_profile_name: @name)
+        resp = @client.delete_instance_profile(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   instance_profile.remove_role({
+      #     role_name: "roleNameType", # required
+      #   })
+      # @param [Hash] options ({})
+      # @option options [required, String] :role_name
+      #   The name of the role to remove.
+      #
+      #   The [regex pattern][1] for this parameter is a string of characters
+      #   consisting of upper and lowercase alphanumeric characters with no
+      #   spaces. You can also include any of the following characters: =,.@-
+      #
+      #
+      #
+      #   [1]: http://wikipedia.org/wiki/regex
+      # @return [EmptyStructure]
+      def remove_role(options = {})
+        options = options.merge(instance_profile_name: @name)
+        resp = @client.remove_role_from_instance_profile(options)
+        resp.data
+      end
+
+      # @!group Associations
+
+      # @return [Role::Collection]
+      def roles
+        batch = []
+        data.roles.each do |r|
+          batch << Role.new(
+            name: r.role_name,
+            data: r,
+            client: @client
+          )
+        end
+        Role::Collection.new([batch], size: batch.size)
+      end
+
+      # @deprecated
+      # @api private
+      def identifiers
+        { name: @name }
+      end
+      deprecated(:identifiers)
+
+      private
+
+      def extract_name(args, options)
+        value = args[0] || options.delete(:name)
+        case value
+        when String then value
+        when nil then raise ArgumentError, "missing required option :name"
+        else
+          msg = "expected :name to be a String, got #{value.class}"
+          raise ArgumentError, msg
+        end
+      end
+
+      def yield_waiter_and_warn(waiter, &block)
+        if !@waiter_block_warned
+          msg = "pass options to configure the waiter; "
+          msg << "yielding the waiter is deprecated"
+          warn(msg)
+          @waiter_block_warned = true
+        end
+        yield(waiter.waiter)
+      end
+
+      def separate_params_and_options(options)
+        opts = Set.new([:client, :max_attempts, :delay, :before_attempt, :before_wait])
+        waiter_opts = {}
+        waiter_params = {}
+        options.each_pair do |key, value|
+          if opts.include?(key)
+            waiter_opts[key] = value
+          else
+            waiter_params[key] = value
+          end
+        end
+        waiter_opts[:client] ||= @client
+        [waiter_opts, waiter_params]
+      end
+
+      class Collection < Aws::Resources::Collection; end
+    end
+  end
+end

data/lib/aws-sdk-iam/login_profile.rb

@@ -0,0 +1,196 @@
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing for info on making contributions:
+# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+module Aws
+  module IAM
+    class LoginProfile
+
+      extend Aws::Deprecations
+
+      # @overload def initialize(user_name, options = {})
+      #   @param [String] user_name
+      #   @option options [Client] :client
+      # @overload def initialize(options = {})
+      #   @option options [required, String] :user_name
+      #   @option options [Client] :client
+      def initialize(*args)
+        options = Hash === args.last ? args.pop.dup : {}
+        @user_name = extract_user_name(args, options)
+        @data = options.delete(:data)
+        @client = options.delete(:client) || Client.new(options)
+      end
+
+      # @!group Read-Only Attributes
+
+      # @return [String]
+      def user_name
+        @user_name
+      end
+
+      # The date when the password for the user was created.
+      # @return [Time]
+      def create_date
+        data.create_date
+      end
+
+      # Specifies whether the user is required to set a new password on next
+      # sign-in.
+      # @return [Boolean]
+      def password_reset_required
+        data.password_reset_required
+      end
+
+      # @!endgroup
+
+      # @return [Client]
+      def client
+        @client
+      end
+
+      # Loads, or reloads {#data} for the current {LoginProfile}.
+      # Returns `self` making it possible to chain methods.
+      #
+      #     login_profile.reload.data
+      #
+      # @return [self]
+      def load
+        resp = @client.get_login_profile(user_name: @user_name)
+        @data = resp.loginprofile
+        self
+      end
+      alias :reload :load
+
+      # @return [Types::LoginProfile]
+      #   Returns the data for this {LoginProfile}. Calls
+      #   {Client#get_login_profile} if {#data_loaded?} is `false`.
+      def data
+        load unless @data
+        @data
+      end
+
+      # @return [Boolean]
+      #   Returns `true` if this resource is loaded.  Accessing attributes or
+      #   {#data} on an unloaded resource will trigger a call to {#load}.
+      def data_loaded?
+        !!@data
+      end
+
+      # @!group Actions
+
+      # @example Request syntax with placeholder values
+      #
+      #   loginprofile = login_profile.create({
+      #     password: "passwordType", # required
+      #     password_reset_required: false,
+      #   })
+      # @param [Hash] options ({})
+      # @option options [required, String] :password
+      #   The new password for the user.
+      #
+      #   The [regex pattern][1] for this parameter is a string of characters
+      #   consisting of almost any printable ASCII character from the space
+      #   (\\u0020) through the end of the ASCII character range (\\u00FF). You
+      #   can also include the tab (\\u0009), line feed (\\u000A), and carriage
+      #   return (\\u000D) characters. Although any of these characters are
+      #   valid in a password, note that many tools, such as the AWS Management
+      #   Console, might restrict the ability to enter certain characters
+      #   because they have special meaning within that tool.
+      #
+      #
+      #
+      #   [1]: http://wikipedia.org/wiki/regex
+      # @option options [Boolean] :password_reset_required
+      #   Specifies whether the user is required to set a new password on next
+      #   sign-in.
+      # @return [LoginProfile]
+      def create(options = {})
+        options = options.merge(user_name: @user_name)
+        resp = @client.create_login_profile(options)
+        LoginProfile.new(
+          user_name: resp.data.login_profile.user_name,
+          data: resp.data.login_profile,
+          client: @client
+        )
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   login_profile.delete()
+      # @param [Hash] options ({})
+      # @return [EmptyStructure]
+      def delete(options = {})
+        options = options.merge(user_name: @user_name)
+        resp = @client.delete_login_profile(options)
+        resp.data
+      end
+
+      # @example Request syntax with placeholder values
+      #
+      #   login_profile.update({
+      #     password: "passwordType",
+      #     password_reset_required: false,
+      #   })
+      # @param [Hash] options ({})
+      # @option options [String] :password
+      #   The new password for the specified IAM user.
+      #
+      #   The [regex pattern][1] for this parameter is a string of characters
+      #   consisting of any printable ASCII character ranging from the space
+      #   character (\\u0020) through end of the ASCII character range
+      #   (\\u00FF). It also includes the special characters tab (\\u0009), line
+      #   feed (\\u000A), and carriage return (\\u000D). However, the format can
+      #   be further restricted by the account administrator by setting a
+      #   password policy on the AWS account. For more information, see
+      #   UpdateAccountPasswordPolicy.
+      #
+      #
+      #
+      #   [1]: http://wikipedia.org/wiki/regex
+      # @option options [Boolean] :password_reset_required
+      #   Allows this new password to be used only once by requiring the
+      #   specified IAM user to set a new password on next sign-in.
+      # @return [EmptyStructure]
+      def update(options = {})
+        options = options.merge(user_name: @user_name)
+        resp = @client.update_login_profile(options)
+        resp.data
+      end
+
+      # @!group Associations
+
+      # @return [User]
+      def user
+        User.new(
+          name: @user_name,
+          client: @client
+        )
+      end
+
+      # @deprecated
+      # @api private
+      def identifiers
+        { user_name: @user_name }
+      end
+      deprecated(:identifiers)
+
+      private
+
+      def extract_user_name(args, options)
+        value = args[0] || options.delete(:user_name)
+        case value
+        when String then value
+        when nil then raise ArgumentError, "missing required option :user_name"
+        else
+          msg = "expected :user_name to be a String, got #{value.class}"
+          raise ArgumentError, msg
+        end
+      end
+
+      class Collection < Aws::Resources::Collection; end
+    end
+  end
+end