openapi: 3.0.0 info: version: '2014-06-30' x-release: v4 title: 'Amazon Cognito Identity #X Amz Target=AWSCognitoIdentityProviderService.AddCustomAttributes #X Amz Target=AWSCognitoIdentityProviderService.AddCustomAttributes #X Amz Target=AWSCognitoIdentityProviderService.ListUserImportJobs API' description: Amazon Cognito Federated Identities

Amazon Cognito Federated Identities is a web service that delivers scoped temporary credentials to mobile devices and other untrusted environments. It uniquely identifies a device and supplies the user with a consistent identity over the lifetime of an application.

Using Amazon Cognito Federated Identities, you can enable authentication with one or more third-party identity providers (Facebook, Google, or Login with Amazon) or an Amazon Cognito user pool, and you can also choose to support unauthenticated access from your app. Cognito delivers a unique identifier for each user and acts as an OpenID token provider trusted by AWS Security Token Service (STS) to access temporary, limited-privilege AWS credentials.

For a description of the authentication flow from the Amazon Cognito Developer Guide see Authentication Flow.

For more information see Amazon Cognito Federated Identities.

x-logo: url: https://twitter.com/awscloud/profile_image?size=original backgroundColor: '#FFFFFF' termsOfService: https://aws.amazon.com/service-terms/ contact: name: Mike Ralphson email: mike.ralphson@gmail.com url: https://github.com/mermade/aws2openapi x-twitter: PermittedSoc license: name: Apache 2.0 License url: http://www.apache.org/licenses/ x-providerName: amazonaws.com x-serviceName: cognito-identity x-origin: - contentType: application/json url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/cognito-identity-2014-06-30.normal.json converter: url: https://github.com/mermade/aws2openapi version: 1.0.0 x-apisguru-driver: external x-apiClientRegistration: url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct x-apisguru-categories: - cloud x-preferred: true servers: - url: http://cognito-identity.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The Amazon Cognito Identity multi-region endpoint - url: https://cognito-identity.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The Amazon Cognito Identity multi-region endpoint - url: http://cognito-identity.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The Amazon Cognito Identity endpoint for China (Beijing) and China (Ningxia) - url: https://cognito-identity.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The Amazon Cognito Identity endpoint for China (Beijing) and China (Ningxia) security: - hmac: [] tags: - name: '#X Amz Target=AWSCognitoIdentityProviderService.ListUserImportJobs' paths: /#X-Amz-Target=AWSCognitoIdentityProviderService.ListUserImportJobs: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: ListUserImportJobs description:

Lists user import jobs for a user pool.

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

responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ListUserImportJobsResponse' examples: ListUserImportJobs200Example: summary: Default ListUserImportJobs 200 response x-microcks-default: true value: UserImportJobs: example PaginationToken: example '480': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' examples: ListUserImportJobs480Example: summary: Default ListUserImportJobs 480 response x-microcks-default: true value: example '481': description: InvalidParameterException content: application/json: schema: $ref: '#/components/schemas/InvalidParameterException' examples: ListUserImportJobs481Example: summary: Default ListUserImportJobs 481 response x-microcks-default: true value: example '482': description: TooManyRequestsException content: application/json: schema: $ref: '#/components/schemas/TooManyRequestsException' examples: ListUserImportJobs482Example: summary: Default ListUserImportJobs 482 response x-microcks-default: true value: example '483': description: NotAuthorizedException content: application/json: schema: $ref: '#/components/schemas/NotAuthorizedException' examples: ListUserImportJobs483Example: summary: Default ListUserImportJobs 483 response x-microcks-default: true value: example '484': description: InternalErrorException content: application/json: schema: $ref: '#/components/schemas/InternalErrorException' examples: ListUserImportJobs484Example: summary: Default ListUserImportJobs 484 response x-microcks-default: true value: example requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ListUserImportJobsRequest' parameters: - name: X-Amz-Target in: header required: true schema: type: string enum: - AWSCognitoIdentityProviderService.ListUserImportJobs summary: Amazon Cognito List User Import Jobs x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - '#X Amz Target=AWSCognitoIdentityProviderService.ListUserImportJobs' components: schemas: UserImportJobType: type: object properties: JobName: allOf: - $ref: '#/components/schemas/UserImportJobNameType' - description: The job name for the user import job. JobId: allOf: - $ref: '#/components/schemas/UserImportJobIdType' - description: The job ID for the user import job. UserPoolId: allOf: - $ref: '#/components/schemas/UserPoolIdType' - description: The user pool ID for the user pool that the users are being imported into. PreSignedUrl: allOf: - $ref: '#/components/schemas/PreSignedUrlType' - description: The pre-signed URL to be used to upload the .csv file. CreationDate: allOf: - $ref: '#/components/schemas/DateType' - description: The date and time, in ISO 8601 format, when the item was created. StartDate: allOf: - $ref: '#/components/schemas/DateType' - description: The date when the user import job was started. CompletionDate: allOf: - $ref: '#/components/schemas/DateType' - description: The date when the user import job was completed. Status: allOf: - $ref: '#/components/schemas/UserImportJobStatusType' - description:

The status of the user import job. One of the following:

CloudWatchLogsRoleArn: allOf: - $ref: '#/components/schemas/ArnType' - description: The role Amazon Resource Name (ARN) for the Amazon CloudWatch Logging role for the user import job. For more information, see "Creating the CloudWatch Logs IAM Role" in the Amazon Cognito Developer Guide. ImportedUsers: allOf: - $ref: '#/components/schemas/LongType' - description: The number of users that were successfully imported. SkippedUsers: allOf: - $ref: '#/components/schemas/LongType' - description: The number of users that were skipped. FailedUsers: allOf: - $ref: '#/components/schemas/LongType' - description: The number of users that couldn't be imported. CompletionMessage: allOf: - $ref: '#/components/schemas/CompletionMessageType' - description: The message returned when the user import job is completed. description: The user import job type. PaginationKeyType: type: string pattern: '[\S]+' minLength: 1 ResourceNotFoundException: {} UserImportJobStatusType: type: string enum: - Created - Pending - InProgress - Stopping - Expired - Stopped - Failed - Succeeded DateType: type: string format: date-time InvalidParameterException: {} UserImportJobsListType: type: array items: $ref: '#/components/schemas/UserImportJobType' minItems: 1 maxItems: 50 ArnType: type: string pattern: arn:[\w+=/,.@-]+:[\w+=/,.@-]+:([\w+=/,.@-]*)?:[0-9]+:[\w+=/,.@-]+(:[\w+=/,.@-]+)?(:[\w+=/,.@-]+)? minLength: 20 maxLength: 2048 PreSignedUrlType: type: string minLength: 0 maxLength: 2048 LongType: type: integer CompletionMessageType: type: string pattern: '[\w]+' minLength: 1 maxLength: 128 UserPoolIdType: type: string pattern: '[\w-]+_[0-9a-zA-Z]+' minLength: 1 maxLength: 55 UserImportJobNameType: type: string pattern: '[\w\s+=,.@-]+' minLength: 1 maxLength: 128 PoolQueryLimitType: type: integer minimum: 1 maximum: 60 NotAuthorizedException: {} InternalErrorException: {} ListUserImportJobsRequest: type: object required: - UserPoolId - MaxResults title: ListUserImportJobsRequest properties: UserPoolId: allOf: - $ref: '#/components/schemas/UserPoolIdType' - description: The user pool ID for the user pool that the users are being imported into. MaxResults: allOf: - $ref: '#/components/schemas/PoolQueryLimitType' - description: The maximum number of import jobs you want the request to return. PaginationToken: allOf: - $ref: '#/components/schemas/PaginationKeyType' - description: An identifier that was returned from the previous call to ListUserImportJobs, which can be used to return the next set of import jobs in the list. description: Represents the request to list the user import jobs. TooManyRequestsException: {} UserImportJobIdType: type: string pattern: import-[0-9a-zA-Z-]+ minLength: 1 maxLength: 55 ListUserImportJobsResponse: type: object properties: UserImportJobs: allOf: - $ref: '#/components/schemas/UserImportJobsListType' - description: The user import jobs. PaginationToken: allOf: - $ref: '#/components/schemas/PaginationKeyType' - description: An identifier that can be used to return the next set of user import jobs in the list. description: Represents the response from the server to the request to list the user import jobs. parameters: X-Amz-Content-Sha256: name: X-Amz-Content-Sha256 in: header schema: type: string required: false X-Amz-Date: name: X-Amz-Date in: header schema: type: string required: false X-Amz-Security-Token: name: X-Amz-Security-Token in: header schema: type: string required: false X-Amz-SignedHeaders: name: X-Amz-SignedHeaders in: header schema: type: string required: false X-Amz-Algorithm: name: X-Amz-Algorithm in: header schema: type: string required: false X-Amz-Signature: name: X-Amz-Signature in: header schema: type: string required: false X-Amz-Credential: name: X-Amz-Credential in: header schema: type: string required: false securitySchemes: hmac: type: apiKey name: Authorization in: header description: Amazon Signature authorization v4 x-amazon-apigateway-authtype: awsSigv4 externalDocs: description: Amazon Web Services documentation url: https://docs.aws.amazon.com/cognito-identity/ x-hasEquivalentPaths: true