Skip to content

list_call_analytics_jobs async

list_call_analytics_jobs(
    *,
    config_overrides: Optional[AsyncTranscribeClientConfig] = None,
    status: Optional[CallAnalyticsJobStatus] = None,
    job_name_contains: Optional[CallAnalyticsJobName] = None,
    next_token: Optional[NextToken] = None,
    max_results: Optional[MaxResults] = None,
) -> ListCallAnalyticsJobsResponse

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

To get detailed information about a specific Call Analytics job, use the operation.

Parameters:

  • status (Optional[CallAnalyticsJobStatus], default: None ) –

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

  • job_name_contains (Optional[CallAnalyticsJobName], default: None ) –

    Returns only the Call Analytics jobs that contain the specified string. The search is not case sensitive.

  • next_token (Optional[NextToken], default: None ) –

    If your ListCallAnalyticsJobs 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.

  • max_results (Optional[MaxResults], default: None ) –

    The maximum number of Call Analytics 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.

Raises:

  • BadRequestException –

    Your request didn't pass one or more validation tests. This can occur when the entity you're trying to delete doesn't exist or if it's in a non-terminal state (such as IN PROGRESS). See the exception message field for more information.

  • InternalFailureException –

    There was an internal error. Check the error message, correct the issue, and try your request again.

  • LimitExceededException –

    You've either sent too many requests or your input file is too long. Wait before retrying your request, or use a smaller file and try your request again.

  • UnknownServiceError –

    The service returned an error code this client does not model.

Source code in docs_src/capo_transcribe/_services/async_transcribe.py
async def list_call_analytics_jobs(
    self,
    *,
    config_overrides: Optional[AsyncTranscribeClientConfig] = None,
    status: Optional[
        "capo_transcribe.types.call_analytics_job_status.CallAnalyticsJobStatus"
    ] = None,
    job_name_contains: Optional[
        "capo_transcribe.types.call_analytics_job_name.CallAnalyticsJobName"
    ] = None,
    next_token: Optional["capo_transcribe.types.next_token.NextToken"] = None,
    max_results: Optional["capo_transcribe.types.max_results.MaxResults"] = None,
) -> "capo_transcribe.types.list_call_analytics_jobs_response.ListCallAnalyticsJobsResponse":
    """<p>Provides a list of Call Analytics jobs that match the specified criteria. If no criteria are specified, all Call Analytics jobs are returned.</p> <p>To get detailed information about a specific Call Analytics job, use the operation.</p>

    Args:
        status: <p>Returns only Call Analytics jobs with the specified status. Jobs are ordered by creation date, with the newest job first. If you do not include <code>Status</code>, all Call Analytics jobs are returned.</p>
        job_name_contains: <p>Returns only the Call Analytics jobs that contain the specified string. The search is not case sensitive.</p>
        next_token: <p>If your <code>ListCallAnalyticsJobs</code> request returns more results than can be displayed, <code>NextToken</code> is displayed in the response with an associated string. To get the next page of results, copy this string and repeat your request, including <code>NextToken</code> with the value of the copied string. Repeat as needed to view all your results.</p>
        max_results: <p>The maximum number of Call Analytics 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.</p>

    Raises:
        capo_transcribe.errors.bad_request_exception.BadRequestException: <p>Your request didn't pass one or more validation tests. This can occur when the entity you're trying to delete doesn't exist or if it's in a non-terminal state (such as <code>IN PROGRESS</code>). See the exception message field for more information.</p>
        capo_transcribe.errors.internal_failure_exception.InternalFailureException: <p>There was an internal error. Check the error message, correct the issue, and try your request again.</p>
        capo_transcribe.errors.limit_exceeded_exception.LimitExceededException: <p>You've either sent too many requests or your input file is too long. Wait before retrying your request, or use a smaller file and try your request again.</p>
        capo_transcribe.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_transcribe.types.list_call_analytics_jobs_request.ListCallAnalyticsJobsRequest]",
    ) -> AsyncOperationResponse[
        "capo_transcribe.types.list_call_analytics_jobs_response.ListCallAnalyticsJobsResponse"
    ]:
        import capo_transcribe._operations.transcribe.list_call_analytics_jobs

        (
            output,
            http_response,
        ) = await capo_transcribe._operations.transcribe.list_call_analytics_jobs.async_list_call_analytics_jobs(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ListCallAnalyticsJobs")
    )
    input_: capo_transcribe.types.list_call_analytics_jobs_request.ListCallAnalyticsJobsRequest = {}
    if status is not None:
        input_["status"] = status
    if job_name_contains is not None:
        input_["job_name_contains"] = job_name_contains
    if next_token is not None:
        input_["next_token"] = next_token
    if max_results is not None:
        input_["max_results"] = max_results

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output