aws-sdk-iam 1.33.0 → 1.38.0

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

@@ -6,6 +6,7 @@
 # WARNING ABOUT GENERATED CODE
 
 module Aws::IAM
+
   class CurrentUser
 
     extend Aws::Deprecations
@@ -168,7 +169,8 @@ module Aws::IAM
     # Waiter polls an API operation until a resource enters a desired
     # state.
     #
-    # @note The waiting operation is performed on a copy. The original resource remains unchanged
+    # @note The waiting operation is performed on a copy. The original resource
+    #   remains unchanged.
     #
     # ## Basic Usage
     #
@@ -181,13 +183,15 @@ module Aws::IAM
     #
     # ## Example
     #
-    #     instance.wait_until(max_attempts:10, delay:5) {|instance| instance.state.name == 'running' }
+    #     instance.wait_until(max_attempts:10, delay:5) do |instance|
+    #       instance.state.name == 'running'
+    #     end
     #
     # ## Configuration
     #
     # You can configure the maximum number of polling attempts, and the
-    # delay (in seconds) between each polling attempt. The waiting condition is set
-    # by passing a block to {#wait_until}:
+    # delay (in seconds) between each polling attempt. The waiting condition is
+    # set by passing a block to {#wait_until}:
     #
     #     # poll for ~25 seconds
     #     resource.wait_until(max_attempts:5,delay:5) {|resource|...}
@@ -218,17 +222,16 @@ module Aws::IAM
     #       # resource did not enter the desired state in time
     #     end
     #
+    # @yieldparam [Resource] resource to be used in the waiting condition.
     #
-    # @yield param [Resource] resource to be used in the waiting condition
-    #
-    # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter terminates
-    #   because the waiter has entered a state that it will not transition
-    #   out of, preventing success.
+    # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter
+    #   terminates because the waiter has entered a state that it will not
+    #   transition out of, preventing success.
     #
     #   yet successful.
     #
-    # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is encountered
-    #   while polling for a resource that is not expected.
+    # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is
+    #   encountered while polling for a resource that is not expected.
     #
     # @raise [NotImplementedError] Raised when the resource does not
     #

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

@@ -6,6 +6,55 @@
 # WARNING ABOUT GENERATED CODE
 
 module Aws::IAM
+
+  # When IAM returns an error response, the Ruby SDK constructs and raises an error.
+  # These errors all extend Aws::IAM::Errors::ServiceError < {Aws::Errors::ServiceError}
+  #
+  # You can rescue all IAM errors using ServiceError:
+  #
+  #     begin
+  #       # do stuff
+  #     rescue Aws::IAM::Errors::ServiceError
+  #       # rescues all IAM API errors
+  #     end
+  #
+  #
+  # ## Request Context
+  # ServiceError objects have a {Aws::Errors::ServiceError#context #context} method that returns
+  # information about the request that generated the error.
+  # See {Seahorse::Client::RequestContext} for more information.
+  #
+  # ## Error Classes
+  # * {ConcurrentModificationException}
+  # * {CredentialReportExpiredException}
+  # * {CredentialReportNotPresentException}
+  # * {CredentialReportNotReadyException}
+  # * {DeleteConflictException}
+  # * {DuplicateCertificateException}
+  # * {DuplicateSSHPublicKeyException}
+  # * {EntityAlreadyExistsException}
+  # * {EntityTemporarilyUnmodifiableException}
+  # * {InvalidAuthenticationCodeException}
+  # * {InvalidCertificateException}
+  # * {InvalidInputException}
+  # * {InvalidPublicKeyException}
+  # * {InvalidUserTypeException}
+  # * {KeyPairMismatchException}
+  # * {LimitExceededException}
+  # * {MalformedCertificateException}
+  # * {MalformedPolicyDocumentException}
+  # * {NoSuchEntityException}
+  # * {PasswordPolicyViolationException}
+  # * {PolicyEvaluationException}
+  # * {PolicyNotAttachableException}
+  # * {ReportGenerationLimitExceededException}
+  # * {ServiceFailureException}
+  # * {ServiceNotSupportedException}
+  # * {UnmodifiableEntityException}
+  # * {UnrecognizedPublicKeyEncodingException}
+  #
+  # Additionally, error classes are dynamically generated for service errors based on the error code
+  # if they are not defined above.
   module Errors
 
     extend Aws::Errors::DynamicErrors
@@ -23,7 +72,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class CredentialReportExpiredException < ServiceError
@@ -39,7 +87,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class CredentialReportNotPresentException < ServiceError
@@ -55,7 +102,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class CredentialReportNotReadyException < ServiceError
@@ -71,7 +117,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class DeleteConflictException < ServiceError
@@ -87,7 +132,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class DuplicateCertificateException < ServiceError
@@ -103,7 +147,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class DuplicateSSHPublicKeyException < ServiceError
@@ -119,7 +162,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class EntityAlreadyExistsException < ServiceError
@@ -135,7 +177,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class EntityTemporarilyUnmodifiableException < ServiceError
@@ -151,7 +192,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class InvalidAuthenticationCodeException < ServiceError
@@ -167,7 +207,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class InvalidCertificateException < ServiceError
@@ -183,7 +222,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class InvalidInputException < ServiceError
@@ -199,7 +237,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class InvalidPublicKeyException < ServiceError
@@ -215,7 +252,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class InvalidUserTypeException < ServiceError
@@ -231,7 +267,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class KeyPairMismatchException < ServiceError
@@ -247,7 +282,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class LimitExceededException < ServiceError
@@ -263,7 +297,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class MalformedCertificateException < ServiceError
@@ -279,7 +312,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class MalformedPolicyDocumentException < ServiceError
@@ -295,7 +327,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class NoSuchEntityException < ServiceError
@@ -311,7 +342,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class PasswordPolicyViolationException < ServiceError
@@ -327,7 +357,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class PolicyEvaluationException < ServiceError
@@ -343,7 +372,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class PolicyNotAttachableException < ServiceError
@@ -359,7 +387,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class ReportGenerationLimitExceededException < ServiceError
@@ -375,7 +402,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class ServiceFailureException < ServiceError
@@ -391,7 +417,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class ServiceNotSupportedException < ServiceError
@@ -407,7 +432,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class UnmodifiableEntityException < ServiceError
@@ -423,7 +447,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
     class UnrecognizedPublicKeyEncodingException < ServiceError
@@ -439,7 +462,6 @@ module Aws::IAM
       def message
         @message || @data[:message]
       end
-
     end
 
   end

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

@@ -6,6 +6,7 @@
 # WARNING ABOUT GENERATED CODE
 
 module Aws::IAM
+
   class Group
 
     extend Aws::Deprecations
@@ -118,7 +119,8 @@ module Aws::IAM
     # Waiter polls an API operation until a resource enters a desired
     # state.
     #
-    # @note The waiting operation is performed on a copy. The original resource remains unchanged
+    # @note The waiting operation is performed on a copy. The original resource
+    #   remains unchanged.
     #
     # ## Basic Usage
     #
@@ -131,13 +133,15 @@ module Aws::IAM
     #
     # ## Example
     #
-    #     instance.wait_until(max_attempts:10, delay:5) {|instance| instance.state.name == 'running' }
+    #     instance.wait_until(max_attempts:10, delay:5) do |instance|
+    #       instance.state.name == 'running'
+    #     end
     #
     # ## Configuration
     #
     # You can configure the maximum number of polling attempts, and the
-    # delay (in seconds) between each polling attempt. The waiting condition is set
-    # by passing a block to {#wait_until}:
+    # delay (in seconds) between each polling attempt. The waiting condition is
+    # set by passing a block to {#wait_until}:
     #
     #     # poll for ~25 seconds
     #     resource.wait_until(max_attempts:5,delay:5) {|resource|...}
@@ -168,17 +172,16 @@ module Aws::IAM
     #       # resource did not enter the desired state in time
     #     end
     #
+    # @yieldparam [Resource] resource to be used in the waiting condition.
     #
-    # @yield param [Resource] resource to be used in the waiting condition
-    #
-    # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter terminates
-    #   because the waiter has entered a state that it will not transition
-    #   out of, preventing success.
+    # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter
+    #   terminates because the waiter has entered a state that it will not
+    #   transition out of, preventing success.
     #
     #   yet successful.
     #
-    # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is encountered
-    #   while polling for a resource that is not expected.
+    # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is
+    #   encountered while polling for a resource that is not expected.
     #
     # @raise [NotImplementedError] Raised when the resource does not
     #
@@ -335,7 +338,7 @@ module Aws::IAM
     # @return [GroupPolicy]
     def create_policy(options = {})
       options = options.merge(group_name: @name)
-      resp = @client.put_group_policy(options)
+      @client.put_group_policy(options)
       GroupPolicy.new(
         group_name: @name,
         name: options[:policy_name],
@@ -431,7 +434,7 @@ module Aws::IAM
     # @return [Group]
     def update(options = {})
       options = options.merge(group_name: @name)
-      resp = @client.update_group(options)
+      @client.update_group(options)
       Group.new(
         name: options[:new_group_name],
         client: @client

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

@@ -6,6 +6,7 @@
 # WARNING ABOUT GENERATED CODE
 
 module Aws::IAM
+
   class GroupPolicy
 
     extend Aws::Deprecations
@@ -94,7 +95,8 @@ module Aws::IAM
     # Waiter polls an API operation until a resource enters a desired
     # state.
     #
-    # @note The waiting operation is performed on a copy. The original resource remains unchanged
+    # @note The waiting operation is performed on a copy. The original resource
+    #   remains unchanged.
     #
     # ## Basic Usage
     #
@@ -107,13 +109,15 @@ module Aws::IAM
     #
     # ## Example
     #
-    #     instance.wait_until(max_attempts:10, delay:5) {|instance| instance.state.name == 'running' }
+    #     instance.wait_until(max_attempts:10, delay:5) do |instance|
+    #       instance.state.name == 'running'
+    #     end
     #
     # ## Configuration
     #
     # You can configure the maximum number of polling attempts, and the
-    # delay (in seconds) between each polling attempt. The waiting condition is set
-    # by passing a block to {#wait_until}:
+    # delay (in seconds) between each polling attempt. The waiting condition is
+    # set by passing a block to {#wait_until}:
     #
     #     # poll for ~25 seconds
     #     resource.wait_until(max_attempts:5,delay:5) {|resource|...}
@@ -144,17 +148,16 @@ module Aws::IAM
     #       # resource did not enter the desired state in time
     #     end
     #
+    # @yieldparam [Resource] resource to be used in the waiting condition.
     #
-    # @yield param [Resource] resource to be used in the waiting condition
-    #
-    # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter terminates
-    #   because the waiter has entered a state that it will not transition
-    #   out of, preventing success.
+    # @raise [Aws::Waiters::Errors::FailureStateError] Raised when the waiter
+    #   terminates because the waiter has entered a state that it will not
+    #   transition out of, preventing success.
     #
     #   yet successful.
     #
-    # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is encountered
-    #   while polling for a resource that is not expected.
+    # @raise [Aws::Waiters::Errors::UnexpectedError] Raised when an error is
+    #   encountered while polling for a resource that is not expected.
     #
     # @raise [NotImplementedError] Raised when the resource does not
     #