EumsSmsConfigurationType
The configuration that Amazon Cognito uses to send SMS messages through AWS End User
Messaging SMS. Provide this structure in the EumsSms member of
SmsConfigurationType to use AWS End User Messaging SMS instead of
Amazon SNS.
Contents
- CallerArn
-
The ARN of the IAM role that Amazon Cognito assumes to send SMS messages through AWS End User Messaging SMS. The role must grant permission to call the
sms-voice:SendTextMessageoperation.Type: String
Length Constraints: Minimum length of 20. Maximum length of 2048.
Pattern:
arn:[\w+=/,.@-]+:[\w+=/,.@-]+:([\w+=/,.@-]*)?:[0-9]+:[\w+=/,.@-]+(:[\w+=/,.@-]+)?(:[\w+=/,.@-]+)?Required: Yes
- ConfigurationSetName
-
The name of the AWS End User Messaging SMS configuration set that Amazon Cognito applies to messages, for logging and event destinations. If you omit this member, Amazon Cognito sends messages without applying a configuration set.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 131072.
Required: No
- ExternalId
-
The external ID that Amazon Cognito includes when it assumes the
CallerArnrole. Use this value as a condition in the role trust policy to prevent the confused deputy problem.Type: String
Length Constraints: Minimum length of 0. Maximum length of 131072.
Required: No
- InEntityId
-
The principal entity ID required by India's Distributed Ledger Technology (DLT) regulations for SMS messages.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 131072.
Required: No
- InTemplateId
-
The registered template ID for the message template required by India's DLT regulations for SMS messages.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 131072.
Required: No
- OriginationIdentity
-
The origination identity that AWS End User Messaging SMS uses to send messages to your users. This value can be one of the following:
-
A phone number – A long code, toll-free number, or short code that is assigned to your account.
-
A sender ID – An alphabetic name that identifies the message sender in supported countries.
-
A phone pool – A group of phone numbers that AWS End User Messaging SMS selects from when it sends messages.
You can provide an E.164 phone number or the ARN of the phone number, sender ID, or phone pool. AWS End User Messaging SMS evaluates IAM authorization with the value that you provide. If the permissions policy of your
CallerArnrole scopes thesms-voice:SendTextMessageresource to a specific ARN, provide that same ARN. If the formats do not match, requests fail with anInvalidSmsRoleAccessPolicyException.Depending on the destination country, you must provide an origination identity. For country-specific requirements, see Supported countries and regions for SMS messaging in the AWS End User Messaging SMS User Guide.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 131072.
Required: No
-
- Region
-
The AWS Region of the AWS End User Messaging SMS resources that Amazon Cognito uses to send messages. AWS End User Messaging SMS must be available in your user pool's Region.
If you omit this parameter, Amazon Cognito uses the same Region as your user pool. You can also set this parameter to your user pool's Region explicitly. Amazon Cognito rejects any other value with an
InvalidParameterException.Type: String
Length Constraints: Minimum length of 5. Maximum length of 32.
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: