listMedicalTranscriptionJobs method

Future<ListMedicalTranscriptionJobsResponse> listMedicalTranscriptionJobs({
  1. String? jobNameContains,
  2. int? maxResults,
  3. String? nextToken,
  4. TranscriptionJobStatus? status,
})

Provides a list of medical transcription jobs that match the specified criteria. If no criteria are specified, all medical transcription jobs are returned.

To get detailed information about a specific medical transcription job, use the operation.

May throw BadRequestException. May throw InternalFailureException. May throw LimitExceededException.

Parameter jobNameContains : Returns only the medical transcription jobs that contain the specified string. The search is not case sensitive.

Parameter maxResults : The maximum number of medical transcription jobs to return in each page of results. If there are fewer results than the value that you specify, only the actual results are returned. If you do not specify a value, a default of 5 is used.

Parameter nextToken : If your ListMedicalTranscriptionJobs request returns more results than can be displayed, NextToken is displayed in the response with an associated string. To get the next page of results, copy this string and repeat your request, including NextToken with the value of the copied string. Repeat as needed to view all your results.

Parameter status : Returns only medical transcription jobs with the specified status. Jobs are ordered by creation date, with the newest job first. If you do not include Status, all medical transcription jobs are returned.

Implementation

Future<ListMedicalTranscriptionJobsResponse> listMedicalTranscriptionJobs({
  String? jobNameContains,
  int? maxResults,
  String? nextToken,
  TranscriptionJobStatus? status,
}) async {
  _s.validateNumRange(
    'maxResults',
    maxResults,
    1,
    100,
  );
  final headers = <String, String>{
    'Content-Type': 'application/x-amz-json-1.1',
    'X-Amz-Target': 'Transcribe.ListMedicalTranscriptionJobs'
  };
  final jsonResponse = await _protocol.send(
    method: 'POST',
    requestUri: '/',
    exceptionFnMap: _exceptionFns,
    // TODO queryParams
    headers: headers,
    payload: {
      if (jobNameContains != null) 'JobNameContains': jobNameContains,
      if (maxResults != null) 'MaxResults': maxResults,
      if (nextToken != null) 'NextToken': nextToken,
      if (status != null) 'Status': status.value,
    },
  );

  return ListMedicalTranscriptionJobsResponse.fromJson(jsonResponse.body);
}