ListSpeakerEnrollmentJobsCommand

Suggest an Edit

Lists all the speaker enrollment jobs in the domain with the specified JobStatus. If JobStatus is not provided, this lists all jobs with all possible speaker enrollment job statuses.

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { VoiceIDClient, ListSpeakerEnrollmentJobsCommand } from "@aws-sdk/client-voice-id"; // ES Modules import
// const { VoiceIDClient, ListSpeakerEnrollmentJobsCommand } = require("@aws-sdk/client-voice-id"); // CommonJS import
const client = new VoiceIDClient(config);
const input = { // ListSpeakerEnrollmentJobsRequest
  DomainId: "STRING_VALUE", // required
  JobStatus: "STRING_VALUE",
  MaxResults: Number("int"),
  NextToken: "STRING_VALUE",
};
const command = new ListSpeakerEnrollmentJobsCommand(input);
const response = await client.send(command);
// { // ListSpeakerEnrollmentJobsResponse
//   JobSummaries: [ // SpeakerEnrollmentJobSummaries
//     { // SpeakerEnrollmentJobSummary
//       JobName: "STRING_VALUE",
//       JobId: "STRING_VALUE",
//       JobStatus: "STRING_VALUE",
//       DomainId: "STRING_VALUE",
//       CreatedAt: new Date("TIMESTAMP"),
//       EndedAt: new Date("TIMESTAMP"),
//       FailureDetails: { // FailureDetails
//         StatusCode: Number("int"),
//         Message: "STRING_VALUE",
//       },
//       JobProgress: { // JobProgress
//         PercentComplete: Number("int"),
//       },
//     },
//   ],
//   NextToken: "STRING_VALUE",
// };

ListSpeakerEnrollmentJobsCommand Input

See ListSpeakerEnrollmentJobsCommandInput for more details

Parameter
Type
Description
DomainId
Required
string | undefined

The identifier of the domain that contains the speaker enrollment jobs.

JobStatus
SpeakerEnrollmentJobStatus | undefined

Provides the status of your speaker enrollment Job.

MaxResults
number | undefined

The maximum number of results that are returned per call. You can use NextToken to obtain more pages of results. The default is 100; the maximum allowed page size is also 100.

NextToken
string | undefined

If NextToken is returned, there are more results available. The value of NextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours.

ListSpeakerEnrollmentJobsCommand Output

See ListSpeakerEnrollmentJobsCommandOutput for details

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
JobSummaries
SpeakerEnrollmentJobSummary[] | undefined

A list containing details about each specified speaker enrollment job.

NextToken
string | undefined

If NextToken is returned, there are more results available. The value of NextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours.

Throws

Name
Fault
Details
AccessDeniedException
client

You do not have sufficient permissions to perform this action. Check the error message and try again.

InternalServerException
server

The request failed due to an unknown error on the server side.

ResourceNotFoundException
client

The specified resource cannot be found. Check the ResourceType and error message for more details.

ThrottlingException
client

The request was denied due to request throttling. Please slow down your request rate. Refer to Amazon Connect Voice ID Service API throttling quotas   and try your request again.

ValidationException
client

The request failed one or more validations; check the error message for more details.

VoiceIDServiceException
Base exception class for all service exceptions from VoiceID service.