Creates a user import job¶
Description¶
Creates a user import job. You can import users into user pools from a comma-separated values (CSV) file without adding Amazon Cognito MAU costs to your Amazon Web Services bill.
Amazon Cognito evaluates Identity and Access Management (IAM) policies in requests for this API operation. For this operation, you must use IAM credentials to authorize requests, and you must grant yourself the corresponding IAM permission in a policy.
Learn more
- Signing Amazon Web Services API Requests
- Using the Amazon Cognito user pools API and user pool endpoints
Usage¶
cognitoidentityprovider_create_user_import_job(JobName, UserPoolId,
CloudWatchLogsRoleArn, PasswordHashingAlgorithm)
Arguments¶
-
JobName[required] A friendly name for the user import job.
-
UserPoolId[required] The ID of the user pool that you want to import users into.
-
CloudWatchLogsRoleArn[required] You must specify an IAM role that has permission to log import-job results to Amazon CloudWatch Logs. This parameter is the ARN of that role.
-
PasswordHashingAlgorithmThe password hashing algorithm used to generate the hashes in the CSV file for this import job.
Valid values:
BCRYPT|SCRYPT|ARGON2ID|PBKDF2_SHA256
Value¶
A list with the following syntax:
list(
UserImportJob = list(
JobName = "string",
JobId = "string",
UserPoolId = "string",
PreSignedUrl = "string",
CreationDate = as.POSIXct(
"2015-01-01"
),
StartDate = as.POSIXct(
"2015-01-01"
),
CompletionDate = as.POSIXct(
"2015-01-01"
),
Status = "Created"|"Pending"|"InProgress"|"Stopping"|"Expired"|"Stopped"|"Failed"|"Succeeded",
CloudWatchLogsRoleArn = "string",
ImportedUsers = 123,
SkippedUsers = 123,
FailedUsers = 123,
CompletionMessage = "string",
PasswordHashingAlgorithm = "BCRYPT"|"SCRYPT"|"ARGON2ID"|"PBKDF2_SHA256"
)
)