client.rb in aws-sdk-iam-1.24.0

- old
+ new

@@ -1468,14 +1468,15 @@
     #
     # @option params [required, String] :assume_role_policy_document
     #   The trust relationship policy document that grants an entity
     #   permission to assume the role.
     #
-    #   You must provide policies in JSON format in IAM. However, for AWS
-    #   CloudFormation templates formatted in YAML, you can provide the policy
-    #   in JSON or YAML format. AWS CloudFormation always converts a YAML
-    #   policy to JSON format before submitting it to IAM.
+    #   in IAM, you must provide a JSON policy that has been converted to a
+    #   string. However, for AWS CloudFormation templates formatted in YAML,
+    #   you can provide the policy in JSON or YAML format. AWS CloudFormation
+    #   always converts a YAML policy to JSON format before submitting it to
+    #   IAM.
     #
     #   The [regex pattern][1] used to validate this parameter is a string of
     #   characters consisting of the following:
     #
     #   * Any printable ASCII character ranging from the space character
@@ -1485,12 +1486,15 @@
     #     character set (through \\u00FF)
     #
     #   * The special characters tab (\\u0009), line feed (\\u000A), and
     #     carriage return (\\u000D)
     #
+    #   Upon success, the response includes the same trust policy as a
+    #   URL-encoded JSON string.
     #
     #
+    #
     #   [1]: http://wikipedia.org/wiki/regex
     #
     # @option params [String] :description
     #   A description of the role.
     #
@@ -1540,15 +1544,15 @@
     #   * {Types::CreateRoleResponse#role #role} => Types::Role
     #
     #
     # @example Example: To create an IAM role
     #
-    #   # The following command creates a role named Test-Role and attaches a trust policy to it that is provided as a URL-encoded
-    #   # JSON string.
+    #   # The following command creates a role named Test-Role and attaches a trust policy that you must convert from JSON to a
+    #   # string. Upon success, the response includes the same policy as a URL-encoded JSON string.
     #
     #   resp = client.create_role({
-    #     assume_role_policy_document: "<URL-encoded-JSON>", 
+    #     assume_role_policy_document: "<Stringified-JSON>", 
     #     path: "/", 
     #     role_name: "Test-Role", 
     #   })
     #
     #   resp.to_h outputs the following:
@@ -10960,10 +10964,10 @@
         operation: config.api.operation(operation_name),
         client: self,
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-iam'
-      context[:gem_version] = '1.23.0'
+      context[:gem_version] = '1.24.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 
     # Polls an API operation until a resource enters a desired state.
     #