feat(aws-android-sdk-core): update models to latest (#3282)

Author: awsmobilesdk

aws-android-sdk-core/src/main/java/com/amazonaws/services/securitytoken/AWSSecurityTokenService.java

@@ -62,10 +62,10 @@
  * >Session Policies</a> in the <i>IAM User Guide</i>.
  * </p>
  * <p>
- * When you create a role, you create two policies: A role trust policy that
- * specifies <i>who</i> can assume the role and a permissions policy that
+ * When you create a role, you create two policies: a role trust policy that
+ * specifies <i>who</i> can assume the role, and a permissions policy that
  * specifies <i>what</i> can be done with the role. You specify the trusted
- * principal who is allowed to assume the role in the role trust policy.
+ * principal that is allowed to assume the role in the role trust policy.
  * </p>
  * <p>
  * To assume a role from a different account, your Amazon Web Services account
@@ -75,7 +75,7 @@
  * </p>
  * <p>
  * A user who wants to access a role in a different account must also have
- * permissions that are delegated from the user account administrator. The
+ * permissions that are delegated from the account administrator. The
  * administrator must attach a policy that allows the user to call
  * <code>AssumeRole</code> for the ARN of the role in the other account.
  * </p>

aws-android-sdk-core/src/main/java/com/amazonaws/services/securitytoken/AWSSecurityTokenServiceClient.java

@@ -125,7 +125,7 @@ public class AssumeRoleWithSAMLResult implements Serializable {
      * </ul>
      * <p>
      * The combination of <code>NameQualifier</code> and <code>Subject</code>
-     * can be used to uniquely identify a federated user.
+     * can be used to uniquely identify a user.
      * </p>
      * <p>
      * The following pseudocode shows how the hash value is calculated:
@@ -680,7 +680,7 @@ public AssumeRoleWithSAMLResult withAudience(String audience) {
      * </ul>
      * <p>
      * The combination of <code>NameQualifier</code> and <code>Subject</code>
-     * can be used to uniquely identify a federated user.
+     * can be used to uniquely identify a user.
      * </p>
      * <p>
      * The following pseudocode shows how the hash value is calculated:
@@ -712,8 +712,7 @@ public AssumeRoleWithSAMLResult withAudience(String audience) {
      *         </ul>
      *         <p>
      *         The combination of <code>NameQualifier</code> and
-     *         <code>Subject</code> can be used to uniquely identify a federated
-     *         user.
+     *         <code>Subject</code> can be used to uniquely identify a user.
      *         </p>
      *         <p>
      *         The following pseudocode shows how the hash value is calculated:
@@ -749,7 +748,7 @@ public String getNameQualifier() {
      * </ul>
      * <p>
      * The combination of <code>NameQualifier</code> and <code>Subject</code>
-     * can be used to uniquely identify a federated user.
+     * can be used to uniquely identify a user.
      * </p>
      * <p>
      * The following pseudocode shows how the hash value is calculated:
@@ -781,8 +780,7 @@ public String getNameQualifier() {
      *            </ul>
      *            <p>
      *            The combination of <code>NameQualifier</code> and
-     *            <code>Subject</code> can be used to uniquely identify a
-     *            federated user.
+     *            <code>Subject</code> can be used to uniquely identify a user.
      *            </p>
      *            <p>
      *            The following pseudocode shows how the hash value is
@@ -819,7 +817,7 @@ public void setNameQualifier(String nameQualifier) {
      * </ul>
      * <p>
      * The combination of <code>NameQualifier</code> and <code>Subject</code>
-     * can be used to uniquely identify a federated user.
+     * can be used to uniquely identify a user.
      * </p>
      * <p>
      * The following pseudocode shows how the hash value is calculated:
@@ -854,8 +852,7 @@ public void setNameQualifier(String nameQualifier) {
      *            </ul>
      *            <p>
      *            The combination of <code>NameQualifier</code> and
-     *            <code>Subject</code> can be used to uniquely identify a
-     *            federated user.
+     *            <code>Subject</code> can be used to uniquely identify a user.
      *            </p>
      *            <p>
      *            The following pseudocode shows how the hash value is

aws-android-sdk-core/src/main/java/com/amazonaws/services/securitytoken/model/AssumeRoleRequest.java

@@ -41,12 +41,8 @@
  * </p>
  * <p>
  * To learn more about Amazon Cognito, see <a href=
- * "https://docs.aws.amazon.com/mobile/sdkforandroid/developerguide/cognito-auth.html#d0e840"
- * >Amazon Cognito Overview</a> in <i>Amazon Web Services SDK for Android
- * Developer Guide</i> and <a href=
- * "https://docs.aws.amazon.com/mobile/sdkforios/developerguide/cognito-auth.html#d0e664"
- * >Amazon Cognito Overview</a> in the <i>Amazon Web Services SDK for iOS
- * Developer Guide</i>.
+ * "https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-identity.html"
+ * >Amazon Cognito identity pools</a> in <i>Amazon Cognito Developer Guide</i>.
  * </p>
  * </note>
  * <p>

aws-android-sdk-core/src/main/java/com/amazonaws/services/securitytoken/model/AssumeRoleWithSAMLResult.java

@@ -27,11 +27,10 @@
  * <note>
  * <p>
  * No permissions are required to perform this operation. If an administrator
- * adds a policy to your IAM user or role that explicitly denies access to the
+ * attaches a policy to your identity that explicitly denies access to the
  * <code>sts:GetCallerIdentity</code> action, you can still perform this
  * operation. Permissions are not required because the same information is
- * returned when an IAM user or role is denied access. To view an example
- * response, see <a href=
+ * returned when access is denied. To view an example response, see <a href=
  * "https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_general.html#troubleshoot_general_access-denied-delete-mfa"
  * >I Am Not Authorized to Perform: iam:DeleteVirtualMFADevice</a> in the <i>IAM
  * User Guide</i>.

aws-android-sdk-core/src/main/java/com/amazonaws/services/securitytoken/model/AssumeRoleWithWebIdentityRequest.java

@@ -22,12 +22,14 @@
 /**
  * <p>
  * Returns a set of temporary security credentials (consisting of an access key
- * ID, a secret access key, and a security token) for a federated user. A
- * typical use is in a proxy application that gets temporary security
- * credentials on behalf of distributed applications inside a corporate network.
+ * ID, a secret access key, and a security token) for a user. A typical use is
+ * in a proxy application that gets temporary security credentials on behalf of
+ * distributed applications inside a corporate network.
+ * </p>
+ * <p>
  * You must call the <code>GetFederationToken</code> operation using the
  * long-term security credentials of an IAM user. As a result, this call is
- * appropriate in contexts where those credentials can be safely stored, usually
+ * appropriate in contexts where those credentials can be safeguarded, usually
  * in a server-based application. For a comparison of
  * <code>GetFederationToken</code> with the other API operations that produce
  * temporary credentials, see <a href=
@@ -37,6 +39,15 @@
  * >Comparing the Amazon Web Services STS API operations</a> in the <i>IAM User
  * Guide</i>.
  * </p>
+ * <p>
+ * Although it is possible to call <code>GetFederationToken</code> using the
+ * security credentials of an Amazon Web Services account root user rather than
+ * an IAM user that you create for the purpose of a proxy application, we do not
+ * recommend it. For more information, see <a href=
+ * "https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#lock-away-credentials"
+ * >Safeguard your root user credentials and don't use them for everyday
+ * tasks</a> in the <i>IAM User Guide</i>.
+ * </p>
  * <note>
  * <p>
  * You can create a mobile-based or browser-based app that can authenticate
@@ -50,24 +61,14 @@
  * </p>
  * </note>
  * <p>
- * You can also call <code>GetFederationToken</code> using the security
- * credentials of an Amazon Web Services account root user, but we do not
- * recommend it. Instead, we recommend that you create an IAM user for the
- * purpose of the proxy application. Then attach a policy to the IAM user that
- * limits federated users to only the actions and resources that they need to
- * access. For more information, see <a
- * href="https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html"
- * >IAM Best Practices</a> in the <i>IAM User Guide</i>.
- * </p>
- * <p>
  * <b>Session duration</b>
  * </p>
  * <p>
  * The temporary credentials are valid for the specified duration, from 900
  * seconds (15 minutes) up to a maximum of 129,600 seconds (36 hours). The
  * default session duration is 43,200 seconds (12 hours). Temporary credentials
- * obtained by using the Amazon Web Services account root user credentials have
- * a maximum duration of 3,600 seconds (1 hour).
+ * obtained by using the root user credentials have a maximum duration of 3,600
+ * seconds (1 hour).
  * </p>
  * <p>
  * <b>Permissions</b>
@@ -305,10 +306,10 @@ public class GetFederationTokenRequest extends AmazonWebServiceRequest implement
      * The duration, in seconds, that the session should last. Acceptable
      * durations for federation sessions range from 900 seconds (15 minutes) to
      * 129,600 seconds (36 hours), with 43,200 seconds (12 hours) as the
-     * default. Sessions obtained using Amazon Web Services account root user
-     * credentials are restricted to a maximum of 3,600 seconds (one hour). If
-     * the specified duration is longer than one hour, the session obtained by
-     * using root user credentials defaults to one hour.
+     * default. Sessions obtained using root user credentials are restricted to
+     * a maximum of 3,600 seconds (one hour). If the specified duration is
+     * longer than one hour, the session obtained by using root user credentials
+     * defaults to one hour.
      * </p>
      * <p>
      * <b>Constraints:</b><br/>
@@ -1351,10 +1352,10 @@ public GetFederationTokenRequest withPolicyArns(
      * The duration, in seconds, that the session should last. Acceptable
      * durations for federation sessions range from 900 seconds (15 minutes) to
      * 129,600 seconds (36 hours), with 43,200 seconds (12 hours) as the
-     * default. Sessions obtained using Amazon Web Services account root user
-     * credentials are restricted to a maximum of 3,600 seconds (one hour). If
-     * the specified duration is longer than one hour, the session obtained by
-     * using root user credentials defaults to one hour.
+     * default. Sessions obtained using root user credentials are restricted to
+     * a maximum of 3,600 seconds (one hour). If the specified duration is
+     * longer than one hour, the session obtained by using root user credentials
+     * defaults to one hour.
      * </p>
      * <p>
      * <b>Constraints:</b><br/>
@@ -1364,11 +1365,11 @@ public GetFederationTokenRequest withPolicyArns(
      *         The duration, in seconds, that the session should last.
      *         Acceptable durations for federation sessions range from 900
      *         seconds (15 minutes) to 129,600 seconds (36 hours), with 43,200
-     *         seconds (12 hours) as the default. Sessions obtained using Amazon
-     *         Web Services account root user credentials are restricted to a
-     *         maximum of 3,600 seconds (one hour). If the specified duration is
-     *         longer than one hour, the session obtained by using root user
-     *         credentials defaults to one hour.
+     *         seconds (12 hours) as the default. Sessions obtained using root
+     *         user credentials are restricted to a maximum of 3,600 seconds
+     *         (one hour). If the specified duration is longer than one hour,
+     *         the session obtained by using root user credentials defaults to
+     *         one hour.
      *         </p>
      */
     public Integer getDurationSeconds() {
@@ -1380,10 +1381,10 @@ public Integer getDurationSeconds() {
      * The duration, in seconds, that the session should last. Acceptable
      * durations for federation sessions range from 900 seconds (15 minutes) to
      * 129,600 seconds (36 hours), with 43,200 seconds (12 hours) as the
-     * default. Sessions obtained using Amazon Web Services account root user
-     * credentials are restricted to a maximum of 3,600 seconds (one hour). If
-     * the specified duration is longer than one hour, the session obtained by
-     * using root user credentials defaults to one hour.
+     * default. Sessions obtained using root user credentials are restricted to
+     * a maximum of 3,600 seconds (one hour). If the specified duration is
+     * longer than one hour, the session obtained by using root user credentials
+     * defaults to one hour.
      * </p>
      * <p>
      * <b>Constraints:</b><br/>
@@ -1394,10 +1395,10 @@ public Integer getDurationSeconds() {
      *            Acceptable durations for federation sessions range from 900
      *            seconds (15 minutes) to 129,600 seconds (36 hours), with
      *            43,200 seconds (12 hours) as the default. Sessions obtained
-     *            using Amazon Web Services account root user credentials are
-     *            restricted to a maximum of 3,600 seconds (one hour). If the
-     *            specified duration is longer than one hour, the session
-     *            obtained by using root user credentials defaults to one hour.
+     *            using root user credentials are restricted to a maximum of
+     *            3,600 seconds (one hour). If the specified duration is longer
+     *            than one hour, the session obtained by using root user
+     *            credentials defaults to one hour.
      *            </p>
      */
     public void setDurationSeconds(Integer durationSeconds) {
@@ -1409,10 +1410,10 @@ public void setDurationSeconds(Integer durationSeconds) {
      * The duration, in seconds, that the session should last. Acceptable
      * durations for federation sessions range from 900 seconds (15 minutes) to
      * 129,600 seconds (36 hours), with 43,200 seconds (12 hours) as the
-     * default. Sessions obtained using Amazon Web Services account root user
-     * credentials are restricted to a maximum of 3,600 seconds (one hour). If
-     * the specified duration is longer than one hour, the session obtained by
-     * using root user credentials defaults to one hour.
+     * default. Sessions obtained using root user credentials are restricted to
+     * a maximum of 3,600 seconds (one hour). If the specified duration is
+     * longer than one hour, the session obtained by using root user credentials
+     * defaults to one hour.
      * </p>
      * <p>
      * Returns a reference to this object so that method calls can be chained
@@ -1426,10 +1427,10 @@ public void setDurationSeconds(Integer durationSeconds) {
      *            Acceptable durations for federation sessions range from 900
      *            seconds (15 minutes) to 129,600 seconds (36 hours), with
      *            43,200 seconds (12 hours) as the default. Sessions obtained
-     *            using Amazon Web Services account root user credentials are
-     *            restricted to a maximum of 3,600 seconds (one hour). If the
-     *            specified duration is longer than one hour, the session
-     *            obtained by using root user credentials defaults to one hour.
+     *            using root user credentials are restricted to a maximum of
+     *            3,600 seconds (one hour). If the specified duration is longer
+     *            than one hour, the session obtained by using root user
+     *            credentials defaults to one hour.
      *            </p>
      * @return A reference to this updated object so that method calls can be
      *         chained together.