create_contact_list `async` ¶

create_contact_list(
    contact_list_name: ContactListName,
    *,
    config_overrides: Optional[AsyncSESv2ClientConfig] = None,
    topics: Optional[Topics] = None,
    description: Optional[Description] = None,
    tags: Optional[TagList] = None,
) -> CreateContactListResponse

Creates a contact list.

Parameters:

contact_list_name (ContactListName) –

The name of the contact list.
topics (Optional[Topics], default: None ) –

An interest group, theme, or label within a list. A contact list can have multiple topics.
description (Optional[Description], default: None ) –

A description of what the contact list is about.
tags (Optional[TagList], default: None ) –

The tags associated with a contact list.

Raises:

AlreadyExistsException –

The resource specified in your request already exists.
BadRequestException –

The input you provided is invalid.
LimitExceededException –

There are too many instances of the specified resource type.
TooManyRequestsException –

Too many requests have been made to the operation.
UnknownServiceError –

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

Source code in docs_src/capo_sesv2/_services/async_se_sv2.py

async def create_contact_list(
    self,
    contact_list_name: "capo_sesv2.types.contact_list_name.ContactListName",
    *,
    config_overrides: Optional[AsyncSESv2ClientConfig] = None,
    topics: Optional["capo_sesv2.types.topics.Topics"] = None,
    description: Optional["capo_sesv2.types.description.Description"] = None,
    tags: Optional["capo_sesv2.types.tag_list.TagList"] = None,
) -> "capo_sesv2.types.create_contact_list_response.CreateContactListResponse":
    """<p>Creates a contact list.</p>

    Args:
        contact_list_name: <p>The name of the contact list.</p>
        topics: <p>An interest group, theme, or label within a list. A contact list can have multiple topics.</p>
        description: <p>A description of what the contact list is about.</p>
        tags: <p>The tags associated with a contact list.</p>

    Raises:
        capo_sesv2.errors.already_exists_exception.AlreadyExistsException: <p>The resource specified in your request already exists.</p>
        capo_sesv2.errors.bad_request_exception.BadRequestException: <p>The input you provided is invalid.</p>
        capo_sesv2.errors.limit_exceeded_exception.LimitExceededException: <p>There are too many instances of the specified resource type.</p>
        capo_sesv2.errors.too_many_requests_exception.TooManyRequestsException: <p>Too many requests have been made to the operation.</p>
        capo_sesv2.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_sesv2.types.create_contact_list_request.CreateContactListRequest]",
    ) -> AsyncOperationResponse[
        "capo_sesv2.types.create_contact_list_response.CreateContactListResponse"
    ]:
        import capo_sesv2._operations.simple_email_service_v2.create_contact_list

        (
            output,
            http_response,
        ) = await capo_sesv2._operations.simple_email_service_v2.create_contact_list.async_create_contact_list(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("CreateContactList")
    )
    input_: capo_sesv2.types.create_contact_list_request.CreateContactListRequest = {
        "contact_list_name": contact_list_name
    }
    if topics is not None:
        input_["topics"] = topics
    if description is not None:
        input_["description"] = description
    if tags is not None:
        input_["tags"] = tags

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

create_contact_list async ¶

create_contact_list `async` ¶