list_templates `async` ¶

list_templates(
    *,
    config_overrides: Optional[AsyncNetworkSecurityManagerClientConfig] = None,
    max_results: Optional[MaxResults] = None,
    next_token: Optional[NextToken] = None,
    status: Optional[EntityStatusFilter] = None,
) -> ListTemplatesOutput

Lists the templates in the account. You can filter the results by status and page through them using maxResults and nextToken.

Parameters:

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

The maximum number of results to return in a single call. Valid range: 1-100. To retrieve the remaining results, use the returned nextToken value in a subsequent call.
next_token (Optional[NextToken], default: None ) –

The token for the next page of results. To retrieve the next page, call the operation again and provide this value. When there are no more results, this value is null.
status (Optional[EntityStatusFilter], default: None ) –

Filters the results by status, either ACTIVE or DRAFT.

Raises:

AccessDeniedException –

You do not have sufficient permissions to perform this action.
InternalServerException –

The request processing failed because of an internal error in the service. This is a retryable error.
ThrottlingException –

The request was denied because of request throttling. Reduce your request rate and try again.
ValidationException –

The request failed validation. For details, see the reason and fieldList members of the response.
UnknownServiceError –

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

Examples:

List templates Lists the published templates in the account, one page at a time.

>>> await client.list_templates(max_results=10, status='ACTIVE')

Source code in docs_src/capo_network_security_manager/_services/async_network_security_manager.py

async def list_templates(
    self,
    *,
    config_overrides: Optional[AsyncNetworkSecurityManagerClientConfig] = None,
    max_results: Optional[
        "capo_network_security_manager.types.max_results.MaxResults"
    ] = None,
    next_token: Optional[
        "capo_network_security_manager.types.next_token.NextToken"
    ] = None,
    status: Optional[
        "capo_network_security_manager.types.entity_status_filter.EntityStatusFilter"
    ] = None,
) -> (
    "capo_network_security_manager.types.list_templates_output.ListTemplatesOutput"
):
    """<p>Lists the templates in the account. You can filter the results by status and page through them using <code>maxResults</code> and <code>nextToken</code>.</p>

    Args:
        max_results: <p>The maximum number of results to return in a single call. Valid range: 1-100. To retrieve the remaining results, use the returned <code>nextToken</code> value in a subsequent call.</p>
        next_token: <p>The token for the next page of results. To retrieve the next page, call the operation again and provide this value. When there are no more results, this value is null.</p>
        status: <p>Filters the results by status, either <code>ACTIVE</code> or <code>DRAFT</code>.</p>

    Raises:
        capo_network_security_manager.errors.access_denied_exception.AccessDeniedException: <p>You do not have sufficient permissions to perform this action.</p>
        capo_network_security_manager.errors.internal_server_exception.InternalServerException: <p>The request processing failed because of an internal error in the service. This is a retryable error.</p>
        capo_network_security_manager.errors.throttling_exception.ThrottlingException: <p>The request was denied because of request throttling. Reduce your request rate and try again.</p>
        capo_network_security_manager.errors.validation_exception.ValidationException: <p>The request failed validation. For details, see the <code>reason</code> and <code>fieldList</code> members of the response.</p>
        capo_network_security_manager.errors.UnknownServiceError: The service returned an error code this client does not model.

    Examples:
        List templates
        Lists the published templates in the account, one page at a time.

        >>> await client.list_templates(max_results=10, status='ACTIVE')
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_network_security_manager.types.list_templates_input.ListTemplatesInput]",
    ) -> AsyncOperationResponse[
        "capo_network_security_manager.types.list_templates_output.ListTemplatesOutput"
    ]:
        import capo_network_security_manager._operations.piccolo_customer_api_service.list_templates

        (
            output,
            http_response,
        ) = await capo_network_security_manager._operations.piccolo_customer_api_service.list_templates.async_list_templates(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("ListTemplates")
    )
    input_: capo_network_security_manager.types.list_templates_input.ListTemplatesInput = {}
    if max_results is not None:
        input_["max_results"] = max_results
    if next_token is not None:
        input_["next_token"] = next_token
    if status is not None:
        input_["status"] = status

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

list_templates async ¶

list_templates `async` ¶