Skip to content

list_task_templates async

list_task_templates(
    instance_id: InstanceId,
    *,
    config_overrides: Optional[AsyncConnectClientConfig] = None,
    next_token: Optional[NextToken] = None,
    max_results: Optional[MaxResult100] = None,
    status: Optional[TaskTemplateStatus] = None,
    name: Optional[TaskTemplateName] = None,
) -> ListTaskTemplatesResponse

Lists task templates for the specified Connect Customer instance.

Parameters:

  • instance_id (InstanceId) –

    The identifier of the Connect Customer instance. You can find the instance ID in the Amazon Resource Name (ARN) of the instance.

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

    The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

    It is not expected that you set this because the value returned in the previous response is always null.

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

    The maximum number of results to return per page.

    It is not expected that you set this.

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

    Marks a template as ACTIVE or INACTIVE for a task to refer to it. Tasks can only be created from ACTIVE templates. If a template is marked as INACTIVE, then a task that refers to this template cannot be created.

  • name (Optional[TaskTemplateName], default: None ) –

    The name of the task template.

Raises:

Source code in docs_src/capo_connect/_services/async_connect.py
async def list_task_templates(
    self,
    instance_id: "capo_connect.types.instance_id.InstanceId",
    *,
    config_overrides: Optional[AsyncConnectClientConfig] = None,
    next_token: Optional["capo_connect.types.next_token.NextToken"] = None,
    max_results: Optional["capo_connect.types.max_result100.MaxResult100"] = None,
    status: Optional[
        "capo_connect.types.task_template_status.TaskTemplateStatus"
    ] = None,
    name: Optional["capo_connect.types.task_template_name.TaskTemplateName"] = None,
) -> "capo_connect.types.list_task_templates_response.ListTaskTemplatesResponse":
    """<p>Lists task templates for the specified Connect Customer instance.</p>

    Args:
        instance_id: <p>The identifier of the Connect Customer instance. You can <a href="https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html">find the instance ID</a> in the Amazon Resource Name (ARN) of the instance.</p>
        next_token: <p>The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.</p> <important> <p>It is not expected that you set this because the value returned in the previous response is always null.</p> </important>
        max_results: <p>The maximum number of results to return per page.</p> <important> <p>It is not expected that you set this.</p> </important>
        status: <p>Marks a template as <code>ACTIVE</code> or <code>INACTIVE</code> for a task to refer to it. Tasks can only be created from <code>ACTIVE</code> templates. If a template is marked as <code>INACTIVE</code>, then a task that refers to this template cannot be created.</p>
        name: <p>The name of the task template.</p>

    Raises:
        capo_connect.errors.internal_service_exception.InternalServiceException: <p>Request processing failed because of an error or failure with the service.</p>
        capo_connect.errors.invalid_parameter_exception.InvalidParameterException: <p>One or more of the specified parameters are not valid.</p>
        capo_connect.errors.invalid_request_exception.InvalidRequestException: <p>The request is not valid.</p>
        capo_connect.errors.resource_not_found_exception.ResourceNotFoundException: <p>The specified resource was not found.</p>
        capo_connect.errors.throttling_exception.ThrottlingException: <p>The throttling limit has been exceeded.</p>
        capo_connect.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_connect.types.list_task_templates_request.ListTaskTemplatesRequest]",
    ) -> AsyncOperationResponse[
        "capo_connect.types.list_task_templates_response.ListTaskTemplatesResponse"
    ]:
        import capo_connect._operations.amazon_connect_service.list_task_templates

        (
            output,
            http_response,
        ) = await capo_connect._operations.amazon_connect_service.list_task_templates.async_list_task_templates(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ListTaskTemplates")
    )
    input_: capo_connect.types.list_task_templates_request.ListTaskTemplatesRequest = {
        "instance_id": instance_id
    }
    if next_token is not None:
        input_["next_token"] = next_token
    if max_results is not None:
        input_["max_results"] = max_results
    if status is not None:
        input_["status"] = status
    if name is not None:
        input_["name"] = name

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