@aws-sdk/client-cognito-identity-provider 3.48.0 → 3.52.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/CHANGELOG.md +35 -0
  2. package/README.md +3 -7
  3. package/dist-types/CognitoIdentityProvider.d.ts +367 -457
  4. package/dist-types/CognitoIdentityProviderClient.d.ts +3 -7
  5. package/dist-types/commands/AdminConfirmSignUpCommand.d.ts +1 -2
  6. package/dist-types/commands/AdminCreateUserCommand.d.ts +20 -23
  7. package/dist-types/commands/AdminDeleteUserAttributesCommand.d.ts +1 -2
  8. package/dist-types/commands/AdminDisableProviderForUserCommand.d.ts +14 -28
  9. package/dist-types/commands/AdminGetUserCommand.d.ts +1 -2
  10. package/dist-types/commands/AdminInitiateAuthCommand.d.ts +14 -14
  11. package/dist-types/commands/AdminLinkProviderForUserCommand.d.ts +12 -19
  12. package/dist-types/commands/AdminListUserAuthEventsCommand.d.ts +1 -2
  13. package/dist-types/commands/AdminResetUserPasswordCommand.d.ts +20 -24
  14. package/dist-types/commands/AdminRespondToAuthChallengeCommand.d.ts +14 -14
  15. package/dist-types/commands/AdminSetUserMFAPreferenceCommand.d.ts +3 -5
  16. package/dist-types/commands/AdminSetUserPasswordCommand.d.ts +5 -10
  17. package/dist-types/commands/AdminSetUserSettingsCommand.d.ts +3 -3
  18. package/dist-types/commands/AdminUpdateAuthEventFeedbackCommand.d.ts +2 -3
  19. package/dist-types/commands/AdminUpdateUserAttributesCommand.d.ts +17 -20
  20. package/dist-types/commands/AdminUserGlobalSignOutCommand.d.ts +2 -3
  21. package/dist-types/commands/AssociateSoftwareTokenCommand.d.ts +6 -10
  22. package/dist-types/commands/ConfirmDeviceCommand.d.ts +1 -2
  23. package/dist-types/commands/ConfirmSignUpCommand.d.ts +1 -2
  24. package/dist-types/commands/CreateResourceServerCommand.d.ts +1 -1
  25. package/dist-types/commands/CreateUserPoolClientCommand.d.ts +2 -2
  26. package/dist-types/commands/CreateUserPoolCommand.d.ts +16 -16
  27. package/dist-types/commands/DescribeUserPoolClientCommand.d.ts +1 -2
  28. package/dist-types/commands/ForgotPasswordCommand.d.ts +23 -22
  29. package/dist-types/commands/GetCSVHeaderCommand.d.ts +1 -2
  30. package/dist-types/commands/GetUICustomizationCommand.d.ts +2 -4
  31. package/dist-types/commands/GetUserAttributeVerificationCodeCommand.d.ts +15 -14
  32. package/dist-types/commands/GlobalSignOutCommand.d.ts +2 -3
  33. package/dist-types/commands/InitiateAuthCommand.d.ts +14 -14
  34. package/dist-types/commands/ListTagsForResourceCommand.d.ts +1 -2
  35. package/dist-types/commands/ListUserPoolsCommand.d.ts +1 -1
  36. package/dist-types/commands/ResendConfirmationCodeCommand.d.ts +16 -16
  37. package/dist-types/commands/RespondToAuthChallengeCommand.d.ts +14 -14
  38. package/dist-types/commands/RevokeTokenCommand.d.ts +1 -2
  39. package/dist-types/commands/SetRiskConfigurationCommand.d.ts +2 -5
  40. package/dist-types/commands/SetUICustomizationCommand.d.ts +7 -12
  41. package/dist-types/commands/SetUserMFAPreferenceCommand.d.ts +6 -9
  42. package/dist-types/commands/SetUserPoolMfaConfigCommand.d.ts +17 -17
  43. package/dist-types/commands/SetUserSettingsCommand.d.ts +2 -3
  44. package/dist-types/commands/SignUpCommand.d.ts +16 -16
  45. package/dist-types/commands/TagResourceCommand.d.ts +7 -14
  46. package/dist-types/commands/UntagResourceCommand.d.ts +1 -2
  47. package/dist-types/commands/UpdateAuthEventFeedbackCommand.d.ts +2 -3
  48. package/dist-types/commands/UpdateResourceServerCommand.d.ts +3 -4
  49. package/dist-types/commands/UpdateUserAttributesCommand.d.ts +15 -14
  50. package/dist-types/commands/UpdateUserPoolClientCommand.d.ts +7 -8
  51. package/dist-types/commands/UpdateUserPoolCommand.d.ts +18 -17
  52. package/dist-types/commands/UpdateUserPoolDomainCommand.d.ts +11 -20
  53. package/dist-types/commands/VerifySoftwareTokenCommand.d.ts +2 -3
  54. package/dist-types/models/models_0.d.ts +1409 -2027
  55. package/dist-types/models/models_1.d.ts +125 -192
  56. package/package.json +40 -34
@@ -1,8 +1,7 @@
1
1
  import { MetadataBearer as $MetadataBearer, SmithyException as __SmithyException } from "@aws-sdk/types";
2
2
  import { AccountRecoverySettingType, AdminCreateUserConfigType, AnalyticsConfigurationType, AttributeType, CodeDeliveryDetailsType, CustomDomainConfigType, DeviceConfigurationType, DeviceRememberedStatusType, EmailConfigurationType, ExplicitAuthFlowsType, FeedbackValueType, GroupType, IdentityProviderType, LambdaConfigType, OAuthFlowType, PreventUserExistenceErrorTypes, ResourceServerScopeType, ResourceServerType, SmsConfigurationType, TokenValidityUnitsType, UserImportJobType, UserPoolAddOnsType, UserPoolClientType, UserPoolMfaType, UserPoolPolicyType, VerificationMessageTemplateType, VerifiedAttributeType } from "./models_0";
3
3
  /**
4
- * <p>Represents the response from the server to the request to start the user import
5
- * job.</p>
4
+ * <p>Represents the response from the server to the request to start the user import job.</p>
6
5
  */
7
6
  export interface StartUserImportJobResponse {
8
7
  /**
@@ -21,7 +20,8 @@ export declare namespace StartUserImportJobResponse {
21
20
  */
22
21
  export interface StopUserImportJobRequest {
23
22
  /**
24
- * <p>The user pool ID for the user pool that the users are being imported into.</p>
23
+ * <p>The user pool ID for the user pool that the users are being imported
24
+ * into.</p>
25
25
  */
26
26
  UserPoolId: string | undefined;
27
27
  /**
@@ -36,8 +36,7 @@ export declare namespace StopUserImportJobRequest {
36
36
  const filterSensitiveLog: (obj: StopUserImportJobRequest) => any;
37
37
  }
38
38
  /**
39
- * <p>Represents the response from the server to the request to stop the user import
40
- * job.</p>
39
+ * <p>Represents the response from the server to the request to stop the user import job.</p>
41
40
  */
42
41
  export interface StopUserImportJobResponse {
43
42
  /**
@@ -185,14 +184,12 @@ export interface UpdateGroupRequest {
185
184
  */
186
185
  Description?: string;
187
186
  /**
188
- * <p>The new role ARN for the group. This is used for setting the
189
- * <code>cognito:roles</code> and <code>cognito:preferred_role</code> claims in the
190
- * token.</p>
187
+ * <p>The new role Amazon Resource Name (ARN) for the group. This is used for setting the <code>cognito:roles</code> and <code>cognito:preferred_role</code> claims in the token.</p>
191
188
  */
192
189
  RoleArn?: string;
193
190
  /**
194
- * <p>The new precedence value for the group. For more information about this parameter, see
195
- * <a href="https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_CreateGroup.html">CreateGroup</a>.</p>
191
+ * <p>The new precedence value for the group. For more information about this parameter,
192
+ * see <a href="https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_CreateGroup.html">CreateGroup</a>.</p>
196
193
  */
197
194
  Precedence?: number;
198
195
  }
@@ -224,8 +221,7 @@ export interface UpdateIdentityProviderRequest {
224
221
  */
225
222
  ProviderName: string | undefined;
226
223
  /**
227
- * <p>The identity provider details to be updated, such as <code>MetadataURL</code> and
228
- * <code>MetadataFile</code>.</p>
224
+ * <p>The identity provider details to be updated, such as <code>MetadataURL</code> and <code>MetadataFile</code>.</p>
229
225
  */
230
226
  ProviderDetails?: {
231
227
  [key: string]: string;
@@ -301,8 +297,7 @@ export declare namespace UpdateResourceServerResponse {
301
297
  export interface UpdateUserAttributesRequest {
302
298
  /**
303
299
  * <p>An array of name-value pairs representing user attributes.</p>
304
- * <p>For custom attributes, you must prepend the <code>custom:</code> prefix to the
305
- * attribute name.</p>
300
+ * <p>For custom attributes, you must prepend the <code>custom:</code> prefix to the attribute name.</p>
306
301
  */
307
302
  UserAttributes: AttributeType[] | undefined;
308
303
  /**
@@ -310,37 +305,31 @@ export interface UpdateUserAttributesRequest {
310
305
  */
311
306
  AccessToken: string | undefined;
312
307
  /**
313
- * <p>A map of custom key-value pairs that you can provide as input for any custom workflows
314
- * that this action triggers. </p>
315
- * <p>You create custom workflows by assigning Lambda functions to user pool triggers.
316
- * When you use the UpdateUserAttributes API action, Amazon Cognito invokes the function
317
- * that is assigned to the <i>custom message</i> trigger. When Amazon Cognito
318
- * invokes this function, it passes a JSON payload, which the function receives as input.
319
- * This payload contains a <code>clientMetadata</code> attribute, which provides the data
320
- * that you assigned to the ClientMetadata parameter in your UpdateUserAttributes request.
321
- * In your function code in Lambda, you can process the <code>clientMetadata</code>
308
+ * <p>A map of custom key-value pairs that you can provide as input for any custom workflows that this action initiates. </p>
309
+ * <p>You create custom workflows by assigning Lambda functions to user pool triggers. When you use the UpdateUserAttributes API action, Amazon Cognito invokes the
310
+ * function that is assigned to the <i>custom message</i> trigger. When Amazon Cognito invokes this function, it passes a
311
+ * JSON
312
+ * payload, which the function receives as input. This payload contains a <code>clientMetadata</code> attribute, which provides the data that you
313
+ * assigned to the ClientMetadata parameter in your UpdateUserAttributes request. In your function code in Lambda, you can process the <code>clientMetadata</code>
322
314
  * value to enhance your workflow for your specific needs.</p>
323
- * <p>For more information, see <a href="https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-identity-pools-working-with-aws-lambda-triggers.html">Customizing User Pool Workflows with Lambda Triggers</a> in the
324
- * <i>Amazon Cognito Developer Guide</i>.</p>
325
- * <note>
326
- * <p>Take the following limitations into consideration when you use the ClientMetadata
327
- * parameter:</p>
315
+ * <p>For more information, see <a href="https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-identity-pools-working-with-aws-lambda-triggers.html">Customizing User Pool
316
+ * Workflows with Lambda Triggers</a> in the <i>Amazon Cognito Developer Guide</i>.</p>
317
+ *
318
+ * <note>
319
+ * <p>When you use the ClientMetadata parameter, remember that Amazon Cognito won't do the following:</p>
328
320
  * <ul>
329
321
  * <li>
330
- * <p>Amazon Cognito does not store the ClientMetadata value. This data is
331
- * available only to Lambda triggers that are assigned to a user pool to
332
- * support custom workflows. If your user pool configuration does not include
333
- * triggers, the ClientMetadata parameter serves no purpose.</p>
334
- * </li>
322
+ * <p>Store the ClientMetadata value. This data is available only to Lambda triggers that are assigned to a user pool to support custom workflows. If your user pool
323
+ * configuration doesn't include triggers, the ClientMetadata parameter serves no purpose.</p>
324
+ * </li>
335
325
  * <li>
336
- * <p>Amazon Cognito does not validate the ClientMetadata value.</p>
337
- * </li>
326
+ * <p>Validate the ClientMetadata value.</p>
327
+ * </li>
338
328
  * <li>
339
- * <p>Amazon Cognito does not encrypt the the ClientMetadata value, so don't use
340
- * it to provide sensitive information.</p>
341
- * </li>
329
+ * <p>Encrypt the ClientMetadata value. Don't use Amazon Cognito to provide sensitive information.</p>
330
+ * </li>
342
331
  * </ul>
343
- * </note>
332
+ * </note>
344
333
  */
345
334
  ClientMetadata?: {
346
335
  [key: string]: string;
@@ -353,13 +342,11 @@ export declare namespace UpdateUserAttributesRequest {
353
342
  const filterSensitiveLog: (obj: UpdateUserAttributesRequest) => any;
354
343
  }
355
344
  /**
356
- * <p>Represents the response from the server for the request to update user
357
- * attributes.</p>
345
+ * <p>Represents the response from the server for the request to update user attributes.</p>
358
346
  */
359
347
  export interface UpdateUserAttributesResponse {
360
348
  /**
361
- * <p>The code delivery details list from the server for the request to update user
362
- * attributes.</p>
349
+ * <p>The code delivery details list from the server for the request to update user attributes.</p>
363
350
  */
364
351
  CodeDeliveryDetailsList?: CodeDeliveryDetailsType[];
365
352
  }
@@ -378,17 +365,15 @@ export interface UpdateUserPoolRequest {
378
365
  */
379
366
  UserPoolId: string | undefined;
380
367
  /**
381
- * <p>A container with the policies you wish to update in a user pool.</p>
368
+ * <p>A container with the policies you want to update in a user pool.</p>
382
369
  */
383
370
  Policies?: UserPoolPolicyType;
384
371
  /**
385
- * <p>The Lambda configuration information from the request to update the user
386
- * pool.</p>
372
+ * <p>The Lambda configuration information from the request to update the user pool.</p>
387
373
  */
388
374
  LambdaConfig?: LambdaConfigType;
389
375
  /**
390
- * <p>The attributes that are automatically verified when the Amazon Cognito service makes a
391
- * request to update user pools.</p>
376
+ * <p>The attributes that are automatically verified when Amazon Cognito requests to update user pools.</p>
392
377
  */
393
378
  AutoVerifiedAttributes?: (VerifiedAttributeType | string)[];
394
379
  /**
@@ -413,23 +398,21 @@ export interface UpdateUserPoolRequest {
413
398
  SmsAuthenticationMessage?: string;
414
399
  /**
415
400
  * <p>Can be one of the following values:</p>
416
- * <ul>
401
+ *
402
+ * <ul>
417
403
  * <li>
418
- * <p>
419
- * <code>OFF</code> - MFA tokens are not required and cannot be specified during
420
- * user registration.</p>
404
+ * <p>
405
+ * <code>OFF</code> - MFA tokens aren't required and can't be specified during user registration.</p>
421
406
  * </li>
422
407
  * <li>
423
- * <p>
424
- * <code>ON</code> - MFA tokens are required for all user registrations. You can
425
- * only specify ON when you are initially creating a user pool. You can use the
426
- * <a href="https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_SetUserPoolMfaConfig.html">SetUserPoolMfaConfig</a> API operation to turn MFA "ON" for existing
427
- * user pools. </p>
408
+ * <p>
409
+ * <code>ON</code> - MFA tokens are required for all user registrations. You can only specify ON when you're initially creating a user pool. You can
410
+ * use the <a href="https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_SetUserPoolMfaConfig.html">SetUserPoolMfaConfig</a> API operation
411
+ * to turn MFA "ON" for existing user pools. </p>
428
412
  * </li>
429
413
  * <li>
430
- * <p>
431
- * <code>OPTIONAL</code> - Users have the option when registering to create an MFA
432
- * token.</p>
414
+ * <p>
415
+ * <code>OPTIONAL</code> - Users have the option when registering to create an MFA token.</p>
433
416
  * </li>
434
417
  * </ul>
435
418
  */
@@ -447,9 +430,8 @@ export interface UpdateUserPoolRequest {
447
430
  */
448
431
  SmsConfiguration?: SmsConfigurationType;
449
432
  /**
450
- * <p>The tag keys and values to assign to the user pool. A tag is a label that you can use
451
- * to categorize and manage user pools in different ways, such as by purpose, owner,
452
- * environment, or other criteria.</p>
433
+ * <p>The tag keys and values to assign to the user pool. A tag is a label that you can use to categorize and manage user pools in different ways, such as by purpose, owner, environment,
434
+ * or other criteria.</p>
453
435
  */
454
436
  UserPoolTags?: {
455
437
  [key: string]: string;
@@ -459,17 +441,14 @@ export interface UpdateUserPoolRequest {
459
441
  */
460
442
  AdminCreateUserConfig?: AdminCreateUserConfigType;
461
443
  /**
462
- * <p>Used to enable advanced security risk detection. Set the key
463
- * <code>AdvancedSecurityMode</code> to the value "AUDIT".</p>
444
+ * <p>Enables advanced security risk detection. Set the key <code>AdvancedSecurityMode</code> to the value "AUDIT".</p>
464
445
  */
465
446
  UserPoolAddOns?: UserPoolAddOnsType;
466
447
  /**
467
- * <p>Use this setting to define which verified available method a user can use to recover
468
- * their password when they call <code>ForgotPassword</code>. It allows you to define a
469
- * preferred method when a user has more than one method available. With this setting, SMS
470
- * does not qualify for a valid password recovery mechanism if the user also has SMS MFA
471
- * enabled. In the absence of this setting, Cognito uses the legacy behavior to determine
472
- * the recovery method where SMS is preferred over email.</p>
448
+ * <p>The available verified method a user can use to recover their password when they call <code>ForgotPassword</code>. You can use this setting to define a
449
+ * preferred method when a user has more than one method available. With this setting, SMS doesn't qualify for a valid password recovery mechanism if the user
450
+ * also has SMS multi-factor authentication (MFA) activated. In the absence of this setting, Amazon Cognito uses the legacy behavior to determine the recovery method
451
+ * where SMS is preferred through email.</p>
473
452
  */
474
453
  AccountRecoverySetting?: AccountRecoverySettingType;
475
454
  }
@@ -480,8 +459,7 @@ export declare namespace UpdateUserPoolRequest {
480
459
  const filterSensitiveLog: (obj: UpdateUserPoolRequest) => any;
481
460
  }
482
461
  /**
483
- * <p>Represents the response from the server when you make a request to update the user
484
- * pool.</p>
462
+ * <p>Represents the response from the server when you make a request to update the user pool.</p>
485
463
  */
486
464
  export interface UpdateUserPoolResponse {
487
465
  }
@@ -496,8 +474,7 @@ export declare namespace UpdateUserPoolResponse {
496
474
  */
497
475
  export interface UpdateUserPoolClientRequest {
498
476
  /**
499
- * <p>The user pool ID for the user pool where you want to update the user pool
500
- * client.</p>
477
+ * <p>The user pool ID for the user pool where you want to update the user pool client.</p>
501
478
  */
502
479
  UserPoolId: string | undefined;
503
480
  /**
@@ -509,22 +486,19 @@ export interface UpdateUserPoolClientRequest {
509
486
  */
510
487
  ClientName?: string;
511
488
  /**
512
- * <p>The time limit, in days, after which the refresh token is no longer valid and cannot
513
- * be used.</p>
489
+ * <p>The time limit, in days, after which the refresh token is no longer valid and can't be used.</p>
514
490
  */
515
491
  RefreshTokenValidity?: number;
516
492
  /**
517
- * <p>The time limit, after which the access token is no longer valid and cannot be
518
- * used.</p>
493
+ * <p>The time limit after which the access token is no longer valid and can't be used.</p>
519
494
  */
520
495
  AccessTokenValidity?: number;
521
496
  /**
522
- * <p>The time limit, after which the ID token is no longer valid and cannot be used.</p>
497
+ * <p>The time limit after which the ID token is no longer valid and can't be used.</p>
523
498
  */
524
499
  IdTokenValidity?: number;
525
500
  /**
526
- * <p>The units in which the validity times are represented in. Default for RefreshToken is
527
- * days, and default for ID and access tokens are hours.</p>
501
+ * <p>The units in which the validity times are represented. Default for RefreshToken is days, and default for ID and access tokens is hours.</p>
528
502
  */
529
503
  TokenValidityUnits?: TokenValidityUnitsType;
530
504
  /**
@@ -536,67 +510,58 @@ export interface UpdateUserPoolClientRequest {
536
510
  */
537
511
  WriteAttributes?: string[];
538
512
  /**
539
- * <p>The authentication flows that are supported by the user pool clients. Flow names
540
- * without the <code>ALLOW_</code> prefix are deprecated in favor of new names with the
541
- * <code>ALLOW_</code> prefix. Note that values with <code>ALLOW_</code> prefix cannot
542
- * be used along with values without <code>ALLOW_</code> prefix.</p>
513
+ * <p>The authentication flows that are supported by the user pool clients. Flow names without the <code>ALLOW_</code> prefix are no longer supported in favor of new names with the
514
+ * <code>ALLOW_</code> prefix. Note that values with <code>ALLOW_</code> prefix must be used only along with values with the <code>ALLOW_</code> prefix.</p>
543
515
  * <p>Valid values include:</p>
544
- * <ul>
516
+ * <ul>
545
517
  * <li>
546
- * <p>
547
- * <code>ALLOW_ADMIN_USER_PASSWORD_AUTH</code>: Enable admin based user password
548
- * authentication flow <code>ADMIN_USER_PASSWORD_AUTH</code>. This setting replaces
549
- * the <code>ADMIN_NO_SRP_AUTH</code> setting. With this authentication flow,
550
- * Cognito receives the password in the request instead of using the SRP (Secure
551
- * Remote Password protocol) protocol to verify passwords.</p>
518
+ * <p>
519
+ * <code>ALLOW_ADMIN_USER_PASSWORD_AUTH</code>: Enable admin based user password authentication flow <code>ADMIN_USER_PASSWORD_AUTH</code>. This setting replaces the
520
+ * <code>ADMIN_NO_SRP_AUTH</code> setting. With this authentication flow, Amazon Cognito receives the password in the request instead of using the Secure Remote Password (SRP) protocol to
521
+ * verify passwords.</p>
552
522
  * </li>
553
523
  * <li>
554
- * <p>
555
- * <code>ALLOW_CUSTOM_AUTH</code>: Enable Lambda trigger based
556
- * authentication.</p>
524
+ * <p>
525
+ * <code>ALLOW_CUSTOM_AUTH</code>: Enable Lambda trigger based authentication.</p>
557
526
  * </li>
558
527
  * <li>
559
- * <p>
560
- * <code>ALLOW_USER_PASSWORD_AUTH</code>: Enable user password-based
561
- * authentication. In this flow, Cognito receives the password in the request
562
- * instead of using the SRP protocol to verify passwords.</p>
528
+ * <p>
529
+ * <code>ALLOW_USER_PASSWORD_AUTH</code>: Enable user password-based authentication. In this flow, Amazon Cognito receives the password in the request instead of using the SRP
530
+ * protocol to verify passwords.</p>
563
531
  * </li>
564
532
  * <li>
565
- * <p>
566
- * <code>ALLOW_USER_SRP_AUTH</code>: Enable SRP based authentication.</p>
533
+ * <p>
534
+ * <code>ALLOW_USER_SRP_AUTH</code>: Enable SRP-based authentication.</p>
567
535
  * </li>
568
536
  * <li>
569
- * <p>
570
- * <code>ALLOW_REFRESH_TOKEN_AUTH</code>: Enable authflow to refresh
571
- * tokens.</p>
537
+ * <p>
538
+ * <code>ALLOW_REFRESH_TOKEN_AUTH</code>: Enable authflow to refresh tokens.</p>
572
539
  * </li>
573
540
  * </ul>
574
541
  */
575
542
  ExplicitAuthFlows?: (ExplicitAuthFlowsType | string)[];
576
543
  /**
577
- * <p>A list of provider names for the identity providers that are supported on this
578
- * client.</p>
544
+ * <p>A list of provider names for the identity providers that are supported on this client.</p>
579
545
  */
580
546
  SupportedIdentityProviders?: string[];
581
547
  /**
582
548
  * <p>A list of allowed redirect (callback) URLs for the identity providers.</p>
583
549
  * <p>A redirect URI must:</p>
584
- * <ul>
550
+ * <ul>
585
551
  * <li>
586
- * <p>Be an absolute URI.</p>
552
+ * <p>Be an absolute URI.</p>
587
553
  * </li>
588
554
  * <li>
589
- * <p>Be registered with the authorization server.</p>
555
+ * <p>Be registered with the authorization server.</p>
590
556
  * </li>
591
557
  * <li>
592
- * <p>Not include a fragment component.</p>
558
+ * <p>Not include a
559
+ * fragment component.</p>
593
560
  * </li>
594
561
  * </ul>
595
- * <p>See <a href="https://tools.ietf.org/html/rfc6749#section-3.1.2">OAuth 2.0 -
596
- * Redirection Endpoint</a>.</p>
597
- * <p>Amazon Cognito requires HTTPS over HTTP except for http://localhost for testing
598
- * purposes only.</p>
599
- * <p>App callback URLs such as myapp://example are also supported.</p>
562
+ * <p>See <a href="https://tools.ietf.org/html/rfc6749#section-3.1.2">OAuth 2.0 - Redirection Endpoint</a>.</p>
563
+ * <p>Amazon Cognito requires HTTPS over HTTP except for http://localhost for testing purposes only.</p>
564
+ * <p>App callback URLs such as <code>myapp://example</code> are also supported.</p>
600
565
  */
601
566
  CallbackURLs?: string[];
602
567
  /**
@@ -606,92 +571,71 @@ export interface UpdateUserPoolClientRequest {
606
571
  /**
607
572
  * <p>The default redirect URI. Must be in the <code>CallbackURLs</code> list.</p>
608
573
  * <p>A redirect URI must:</p>
609
- * <ul>
574
+ * <ul>
610
575
  * <li>
611
- * <p>Be an absolute URI.</p>
576
+ * <p>Be an absolute URI.</p>
612
577
  * </li>
613
578
  * <li>
614
- * <p>Be registered with the authorization server.</p>
579
+ * <p>Be registered with the authorization server.</p>
615
580
  * </li>
616
581
  * <li>
617
- * <p>Not include a fragment component.</p>
582
+ * <p>Not include a
583
+ * fragment component.</p>
618
584
  * </li>
619
585
  * </ul>
620
- * <p>See <a href="https://tools.ietf.org/html/rfc6749#section-3.1.2">OAuth 2.0 -
621
- * Redirection Endpoint</a>.</p>
622
- * <p>Amazon Cognito requires HTTPS over HTTP except for http://localhost for testing
623
- * purposes only.</p>
624
- * <p>App callback URLs such as myapp://example are also supported.</p>
586
+ * <p>See <a href="https://tools.ietf.org/html/rfc6749#section-3.1.2">OAuth 2.0 - Redirection Endpoint</a>.</p>
587
+ * <p>Amazon Cognito requires HTTPS over HTTP except for <code>http://localhost</code> for testing purposes only.</p>
588
+ * <p>App callback URLs such as <code>myapp://example</code> are also supported.</p>
625
589
  */
626
590
  DefaultRedirectURI?: string;
627
591
  /**
628
592
  * <p>The allowed OAuth flows.</p>
629
- * <p>Set to <code>code</code> to initiate a code grant flow, which provides an
630
- * authorization code as the response. This code can be exchanged for access tokens with
631
- * the token endpoint.</p>
632
- * <p>Set to <code>implicit</code> to specify that the client should get the access token
633
- * (and, optionally, ID token, based on scopes) directly.</p>
634
- * <p>Set to <code>client_credentials</code> to specify that the client should get the
635
- * access token (and, optionally, ID token, based on scopes) from the token endpoint using
636
- * a combination of client and client_secret.</p>
593
+ * <p>Set to <code>code</code> to initiate a code grant flow, which provides an authorization code as the response. This code can be exchanged for access tokens with the token endpoint.</p>
594
+ * <p>Set to <code>implicit</code> to specify that the client should get the access token (and, optionally, ID token, based on scopes) directly.</p>
595
+ * <p>Set to <code>client_credentials</code> to specify that the client should get the access token (and, optionally, ID token, based on scopes) from the token endpoint using a combination
596
+ * of client and client_secret.</p>
637
597
  */
638
598
  AllowedOAuthFlows?: (OAuthFlowType | string)[];
639
599
  /**
640
600
  * <p>The allowed OAuth scopes. Possible values provided by OAuth are: <code>phone</code>,
641
- * <code>email</code>, <code>openid</code>, and <code>profile</code>. Possible values
642
- * provided by Amazon Web Services are: <code>aws.cognito.signin.user.admin</code>. Custom scopes created
601
+ * <code>email</code>, <code>openid</code>, and <code>profile</code>. Possible values provided by Amazon Web Services are: <code>aws.cognito.signin.user.admin</code>. Custom scopes created
643
602
  * in Resource Servers are also supported.</p>
644
603
  */
645
604
  AllowedOAuthScopes?: string[];
646
605
  /**
647
- * <p>Set to true if the client is allowed to follow the OAuth protocol when interacting
648
- * with Cognito user pools.</p>
606
+ * <p>Set to true if the client is allowed to follow the OAuth protocol when interacting with Amazon Cognito user pools.</p>
649
607
  */
650
608
  AllowedOAuthFlowsUserPoolClient?: boolean;
651
609
  /**
652
- * <p>The Amazon Pinpoint analytics configuration for collecting metrics for this user
653
- * pool.</p>
654
- * <note>
655
- * <p>In regions where Pinpoint is not available, Cognito User Pools only supports
656
- * sending events to Amazon Pinpoint projects in us-east-1. In regions where Pinpoint
657
- * is available, Cognito User Pools will support sending events to Amazon Pinpoint
658
- * projects within that same region. </p>
659
- * </note>
610
+ * <p>The Amazon Pinpoint analytics configuration for collecting metrics for this user pool.</p>
611
+ * <note>
612
+ * <p>In Amazon Web Services Regions where isn't available, User Pools only supports sending events to Amazon Pinpoint projects in us-east-1. In Regions where Pinpoint is available, User Pools will support
613
+ * sending events to Amazon Pinpoint projects within that same Region. </p>
614
+ * </note>
660
615
  */
661
616
  AnalyticsConfiguration?: AnalyticsConfigurationType;
662
617
  /**
663
- * <p>Use this setting to choose which errors and responses are returned by Cognito APIs
664
- * during authentication, account confirmation, and password recovery when the user does
665
- * not exist in the user pool. When set to <code>ENABLED</code> and the user does not
666
- * exist, authentication returns an error indicating either the username or password was
667
- * incorrect, and account confirmation and password recovery return a response indicating a
668
- * code was sent to a simulated destination. When set to <code>LEGACY</code>, those APIs
669
- * will return a <code>UserNotFoundException</code> exception if the user does not exist in
670
- * the user pool.</p>
618
+ * <p>Errors and responses that you want Amazon Cognito APIs to return during authentication, account confirmation, and password recovery when the user doesn't exist in the
619
+ * user pool. When set to <code>ENABLED</code> and the user doesn't exist, authentication returns an error indicating either the username or password was incorrect.
620
+ * Account confirmation and password recovery return a response indicating a code was sent to a simulated destination. When set to <code>LEGACY</code>, those APIs
621
+ * return a <code>UserNotFoundException</code> exception if the user doesn't exist in the user pool.</p>
671
622
  * <p>Valid values include:</p>
672
- * <ul>
623
+ * <ul>
673
624
  * <li>
674
- * <p>
625
+ * <p>
675
626
  * <code>ENABLED</code> - This prevents user existence-related errors.</p>
676
627
  * </li>
677
628
  * <li>
678
- * <p>
679
- * <code>LEGACY</code> - This represents the old behavior of Cognito where user
680
- * existence related errors are not prevented.</p>
629
+ * <p>
630
+ * <code>LEGACY</code> - This represents the early
631
+ * behavior of Amazon Cognito where user existence related errors aren't prevented.</p>
681
632
  * </li>
682
633
  * </ul>
683
- *
684
- *
685
- * <note>
686
- * <p>After February 15th 2020, the value of <code>PreventUserExistenceErrors</code>
687
- * will default to <code>ENABLED</code> for newly created user pool clients if no value
688
- * is provided.</p>
689
- * </note>
690
634
  */
691
635
  PreventUserExistenceErrors?: PreventUserExistenceErrorTypes | string;
692
636
  /**
693
- * <p>Enables or disables token revocation. For more information
694
- * about revoking tokens, see <a href="https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_RevokeToken.html">RevokeToken</a>.</p>
637
+ * <p>Activates or deactivates token revocation. For more information about revoking tokens,
638
+ * see <a href="https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_RevokeToken.html">RevokeToken</a>.</p>
695
639
  */
696
640
  EnableTokenRevocation?: boolean;
697
641
  }
@@ -702,13 +646,11 @@ export declare namespace UpdateUserPoolClientRequest {
702
646
  const filterSensitiveLog: (obj: UpdateUserPoolClientRequest) => any;
703
647
  }
704
648
  /**
705
- * <p>Represents the response from the server to the request to update the user pool
706
- * client.</p>
649
+ * <p>Represents the response from the server to the request to update the user pool client.</p>
707
650
  */
708
651
  export interface UpdateUserPoolClientResponse {
709
652
  /**
710
- * <p>The user pool client value from the response from the server when an update user pool
711
- * client request is made.</p>
653
+ * <p>The user pool client value from the response from the server when you request to update the user pool client.</p>
712
654
  */
713
655
  UserPoolClient?: UserPoolClientType;
714
656
  }
@@ -723,21 +665,16 @@ export declare namespace UpdateUserPoolClientResponse {
723
665
  */
724
666
  export interface UpdateUserPoolDomainRequest {
725
667
  /**
726
- * <p>The domain name for the custom domain that hosts the sign-up and sign-in pages for
727
- * your application. For example: <code>auth.example.com</code>. </p>
728
- * <p>This string can include only lowercase letters, numbers, and hyphens. Do not use a
729
- * hyphen for the first or last character. Use periods to separate subdomain names.</p>
668
+ * <p>The domain name for the custom domain that hosts the sign-up and sign-in pages for your application. One example might be <code>auth.example.com</code>. </p>
669
+ * <p>This string can include only lowercase letters, numbers, and hyphens. Don't use a hyphen for the first or last character. Use periods to separate subdomain names.</p>
730
670
  */
731
671
  Domain: string | undefined;
732
672
  /**
733
- * <p>The ID of the user pool that is associated with the custom domain that you are
734
- * updating the certificate for.</p>
673
+ * <p>The ID of the user pool that is associated with the custom domain whose certificate you're updating.</p>
735
674
  */
736
675
  UserPoolId: string | undefined;
737
676
  /**
738
- * <p>The configuration for a custom domain that hosts the sign-up and sign-in pages for
739
- * your application. Use this object to specify an SSL certificate that is managed by
740
- * ACM.</p>
677
+ * <p>The configuration for a custom domain that hosts the sign-up and sign-in pages for your application. Use this object to specify an SSL certificate that is managed by ACM.</p>
741
678
  */
742
679
  CustomDomainConfig: CustomDomainConfigType | undefined;
743
680
  }
@@ -752,8 +689,7 @@ export declare namespace UpdateUserPoolDomainRequest {
752
689
  */
753
690
  export interface UpdateUserPoolDomainResponse {
754
691
  /**
755
- * <p>The Amazon CloudFront endpoint that Amazon Cognito set up when you added the custom
756
- * domain to your user pool.</p>
692
+ * <p>The Amazon CloudFront endpoint that Amazon Cognito set up when you added the custom domain to your user pool.</p>
757
693
  */
758
694
  CloudFrontDomain?: string;
759
695
  }
@@ -764,8 +700,7 @@ export declare namespace UpdateUserPoolDomainResponse {
764
700
  const filterSensitiveLog: (obj: UpdateUserPoolDomainResponse) => any;
765
701
  }
766
702
  /**
767
- * <p>This exception is thrown when there is a code mismatch and the service fails to
768
- * configure the software token TOTP multi-factor authentication (MFA).</p>
703
+ * <p>This exception is thrown when there is a code mismatch and the service fails to configure the software token TOTP multi-factor authentication (MFA).</p>
769
704
  */
770
705
  export interface EnableSoftwareTokenMFAException extends __SmithyException, $MetadataBearer {
771
706
  name: "EnableSoftwareTokenMFAException";
@@ -778,12 +713,12 @@ export interface VerifySoftwareTokenRequest {
778
713
  */
779
714
  AccessToken?: string;
780
715
  /**
781
- * <p>The session which should be passed both ways in challenge-response calls to the
782
- * service.</p>
716
+ * <p>The session that should be passed both ways in challenge-response calls to the service.</p>
783
717
  */
784
718
  Session?: string;
785
719
  /**
786
- * <p>The one time password computed using the secret code returned by <a href="https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AssociateSoftwareToken.html">AssociateSoftwareToken"</a>.</p>
720
+ * <p>The one- time password computed using the secret code returned by
721
+ * <a href="https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_AssociateSoftwareToken.html">AssociateSoftwareToken</a>.</p>
787
722
  */
788
723
  UserCode: string | undefined;
789
724
  /**
@@ -807,8 +742,7 @@ export interface VerifySoftwareTokenResponse {
807
742
  */
808
743
  Status?: VerifySoftwareTokenResponseType | string;
809
744
  /**
810
- * <p>The session which should be passed both ways in challenge-response calls to the
811
- * service.</p>
745
+ * <p>The session that should be passed both ways in challenge-response calls to the service.</p>
812
746
  */
813
747
  Session?: string;
814
748
  }
@@ -823,7 +757,7 @@ export declare namespace VerifySoftwareTokenResponse {
823
757
  */
824
758
  export interface VerifyUserAttributeRequest {
825
759
  /**
826
- * <p>Represents the access token of the request to verify user attributes.</p>
760
+ * <p>The access token of the request to verify user attributes.</p>
827
761
  */
828
762
  AccessToken: string | undefined;
829
763
  /**
@@ -842,8 +776,7 @@ export declare namespace VerifyUserAttributeRequest {
842
776
  const filterSensitiveLog: (obj: VerifyUserAttributeRequest) => any;
843
777
  }
844
778
  /**
845
- * <p>A container representing the response from the server from the request to verify user
846
- * attributes.</p>
779
+ * <p>A container representing the response from the server from the request to verify user attributes.</p>
847
780
  */
848
781
  export interface VerifyUserAttributeResponse {
849
782
  }