mypy-boto3-timestream-write 1.19.9__py3-none-any.whl → 1.41.0__py3-none-any.whl

mypy_boto3_timestream_write/client.pyi

@@ -1,225 +1,304 @@
 """
-Type annotations for timestream-write service client.
+Type annotations for timestream-write service Client.
 
-[Open documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html)
+[Documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/)
+
+Copyright 2025 Vlad Emelianov
 
 Usage::
 
     ```python
-    import boto3
-    from mypy_boto3_timestream_write import TimestreamWriteClient
+    from boto3.session import Session
+    from mypy_boto3_timestream_write.client import TimestreamWriteClient
 
-    client: TimestreamWriteClient = boto3.client("timestream-write")
+    session = Session()
+    client: TimestreamWriteClient = session.client("timestream-write")
     ```
 """
-from typing import Any, Dict, Mapping, Sequence, Type
+
+from __future__ import annotations
+
+import sys
+from collections.abc import Mapping
+from typing import Any
 
 from botocore.client import BaseClient, ClientMeta
+from botocore.errorfactory import BaseClientExceptions
+from botocore.exceptions import ClientError as BotocoreClientError
 
 from .type_defs import (
+    CreateBatchLoadTaskRequestTypeDef,
+    CreateBatchLoadTaskResponseTypeDef,
+    CreateDatabaseRequestTypeDef,
     CreateDatabaseResponseTypeDef,
+    CreateTableRequestTypeDef,
     CreateTableResponseTypeDef,
+    DeleteDatabaseRequestTypeDef,
+    DeleteTableRequestTypeDef,
+    DescribeBatchLoadTaskRequestTypeDef,
+    DescribeBatchLoadTaskResponseTypeDef,
+    DescribeDatabaseRequestTypeDef,
     DescribeDatabaseResponseTypeDef,
     DescribeEndpointsResponseTypeDef,
+    DescribeTableRequestTypeDef,
     DescribeTableResponseTypeDef,
+    EmptyResponseMetadataTypeDef,
+    ListBatchLoadTasksRequestTypeDef,
+    ListBatchLoadTasksResponseTypeDef,
+    ListDatabasesRequestTypeDef,
     ListDatabasesResponseTypeDef,
+    ListTablesRequestTypeDef,
     ListTablesResponseTypeDef,
+    ListTagsForResourceRequestTypeDef,
     ListTagsForResourceResponseTypeDef,
-    RecordTypeDef,
-    RetentionPropertiesTypeDef,
-    TagTypeDef,
+    ResumeBatchLoadTaskRequestTypeDef,
+    TagResourceRequestTypeDef,
+    UntagResourceRequestTypeDef,
+    UpdateDatabaseRequestTypeDef,
     UpdateDatabaseResponseTypeDef,
+    UpdateTableRequestTypeDef,
     UpdateTableResponseTypeDef,
+    WriteRecordsRequestTypeDef,
+    WriteRecordsResponseTypeDef,
 )
 
+if sys.version_info >= (3, 12):
+    from typing import Unpack
+else:
+    from typing_extensions import Unpack
+
 __all__ = ("TimestreamWriteClient",)
 
-class BotocoreClientError(BaseException):
-    MSG_TEMPLATE: str
-    def __init__(self, error_response: Mapping[str, Any], operation_name: str) -> None:
-        self.response: Dict[str, Any]
-        self.operation_name: str
-
-class Exceptions:
-    AccessDeniedException: Type[BotocoreClientError]
-    ClientError: Type[BotocoreClientError]
-    ConflictException: Type[BotocoreClientError]
-    InternalServerException: Type[BotocoreClientError]
-    InvalidEndpointException: Type[BotocoreClientError]
-    RejectedRecordsException: Type[BotocoreClientError]
-    ResourceNotFoundException: Type[BotocoreClientError]
-    ServiceQuotaExceededException: Type[BotocoreClientError]
-    ThrottlingException: Type[BotocoreClientError]
-    ValidationException: Type[BotocoreClientError]
+class Exceptions(BaseClientExceptions):
+    AccessDeniedException: type[BotocoreClientError]
+    ClientError: type[BotocoreClientError]
+    ConflictException: type[BotocoreClientError]
+    InternalServerException: type[BotocoreClientError]
+    InvalidEndpointException: type[BotocoreClientError]
+    RejectedRecordsException: type[BotocoreClientError]
+    ResourceNotFoundException: type[BotocoreClientError]
+    ServiceQuotaExceededException: type[BotocoreClientError]
+    ThrottlingException: type[BotocoreClientError]
+    ValidationException: type[BotocoreClientError]
 
 class TimestreamWriteClient(BaseClient):
     """
-    [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client)
-    [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html)
+    [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client)
+    [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/)
     """
 
     meta: ClientMeta
+
     @property
     def exceptions(self) -> Exceptions:
         """
         TimestreamWriteClient exceptions.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#exceptions)
         """
+
     def can_paginate(self, operation_name: str) -> bool:
         """
-        Check if an operation can be paginated.
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/can_paginate.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#can_paginate)
+        """
+
+    def generate_presigned_url(
+        self,
+        ClientMethod: str,
+        Params: Mapping[str, Any] = ...,
+        ExpiresIn: int = 3600,
+        HttpMethod: str = ...,
+    ) -> str:
+        """
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/generate_presigned_url.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#generate_presigned_url)
+        """
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client.can_paginate)
-        [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html#can_paginate)
+    def create_batch_load_task(
+        self, **kwargs: Unpack[CreateBatchLoadTaskRequestTypeDef]
+    ) -> CreateBatchLoadTaskResponseTypeDef:
         """
+        Creates a new Timestream batch load task.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/create_batch_load_task.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#create_batch_load_task)
+        """
+
     def create_database(
-        self, *, DatabaseName: str, KmsKeyId: str = ..., Tags: Sequence["TagTypeDef"] = ...
+        self, **kwargs: Unpack[CreateDatabaseRequestTypeDef]
     ) -> CreateDatabaseResponseTypeDef:
         """
         Creates a new Timestream database.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client.create_database)
-        [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html#create_database)
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/create_database.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#create_database)
         """
+
     def create_table(
-        self,
-        *,
-        DatabaseName: str,
-        TableName: str,
-        RetentionProperties: "RetentionPropertiesTypeDef" = ...,
-        Tags: Sequence["TagTypeDef"] = ...
+        self, **kwargs: Unpack[CreateTableRequestTypeDef]
     ) -> CreateTableResponseTypeDef:
         """
-        The CreateTable operation adds a new table to an existing database in your
-        account.
+        Adds a new table to an existing database in your account.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client.create_table)
-        [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html#create_table)
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/create_table.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#create_table)
         """
-    def delete_database(self, *, DatabaseName: str) -> None:
+
+    def delete_database(
+        self, **kwargs: Unpack[DeleteDatabaseRequestTypeDef]
+    ) -> EmptyResponseMetadataTypeDef:
         """
         Deletes a given Timestream database.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client.delete_database)
-        [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html#delete_database)
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/delete_database.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#delete_database)
         """
-    def delete_table(self, *, DatabaseName: str, TableName: str) -> None:
+
+    def delete_table(
+        self, **kwargs: Unpack[DeleteTableRequestTypeDef]
+    ) -> EmptyResponseMetadataTypeDef:
         """
         Deletes a given Timestream table.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client.delete_table)
-        [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html#delete_table)
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/delete_table.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#delete_table)
         """
-    def describe_database(self, *, DatabaseName: str) -> DescribeDatabaseResponseTypeDef:
+
+    def describe_batch_load_task(
+        self, **kwargs: Unpack[DescribeBatchLoadTaskRequestTypeDef]
+    ) -> DescribeBatchLoadTaskResponseTypeDef:
+        """
+        Returns information about the batch load task, including configurations,
+        mappings, progress, and other details.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/describe_batch_load_task.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#describe_batch_load_task)
+        """
+
+    def describe_database(
+        self, **kwargs: Unpack[DescribeDatabaseRequestTypeDef]
+    ) -> DescribeDatabaseResponseTypeDef:
         """
         Returns information about the database, including the database name, time that
         the database was created, and the total number of tables found within the
         database.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client.describe_database)
-        [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html#describe_database)
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/describe_database.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#describe_database)
         """
+
     def describe_endpoints(self) -> DescribeEndpointsResponseTypeDef:
         """
-        DescribeEndpoints returns a list of available endpoints to make Timestream API
-        calls against.
+        Returns a list of available endpoints to make Timestream API calls against.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client.describe_endpoints)
-        [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html#describe_endpoints)
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/describe_endpoints.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#describe_endpoints)
         """
-    def describe_table(self, *, DatabaseName: str, TableName: str) -> DescribeTableResponseTypeDef:
+
+    def describe_table(
+        self, **kwargs: Unpack[DescribeTableRequestTypeDef]
+    ) -> DescribeTableResponseTypeDef:
         """
         Returns information about the table, including the table name, database name,
         retention duration of the memory store and the magnetic store.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client.describe_table)
-        [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html#describe_table)
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/describe_table.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#describe_table)
         """
-    def generate_presigned_url(
-        self,
-        ClientMethod: str,
-        Params: Mapping[str, Any] = ...,
-        ExpiresIn: int = 3600,
-        HttpMethod: str = ...,
-    ) -> str:
+
+    def list_batch_load_tasks(
+        self, **kwargs: Unpack[ListBatchLoadTasksRequestTypeDef]
+    ) -> ListBatchLoadTasksResponseTypeDef:
         """
-        Generate a presigned url given a client, its method, and arguments.
+        Provides a list of batch load tasks, along with the name, status, when the task
+        is resumable until, and other details.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client.generate_presigned_url)
-        [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html#generate_presigned_url)
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/list_batch_load_tasks.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#list_batch_load_tasks)
         """
+
     def list_databases(
-        self, *, NextToken: str = ..., MaxResults: int = ...
+        self, **kwargs: Unpack[ListDatabasesRequestTypeDef]
     ) -> ListDatabasesResponseTypeDef:
         """
         Returns a list of your Timestream databases.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client.list_databases)
-        [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html#list_databases)
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/list_databases.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#list_databases)
         """
-    def list_tables(
-        self, *, DatabaseName: str = ..., NextToken: str = ..., MaxResults: int = ...
-    ) -> ListTablesResponseTypeDef:
+
+    def list_tables(self, **kwargs: Unpack[ListTablesRequestTypeDef]) -> ListTablesResponseTypeDef:
         """
-        A list of tables, along with the name, status and retention properties of each
-        table.
+        Provides a list of tables, along with the name, status, and retention
+        properties of each table.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client.list_tables)
-        [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html#list_tables)
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/list_tables.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#list_tables)
         """
-    def list_tags_for_resource(self, *, ResourceARN: str) -> ListTagsForResourceResponseTypeDef:
+
+    def list_tags_for_resource(
+        self, **kwargs: Unpack[ListTagsForResourceRequestTypeDef]
+    ) -> ListTagsForResourceResponseTypeDef:
+        """
+        Lists all tags on a Timestream resource.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/list_tags_for_resource.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#list_tags_for_resource)
         """
-        List all tags on a Timestream resource.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client.list_tags_for_resource)
-        [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html#list_tags_for_resource)
+    def resume_batch_load_task(
+        self, **kwargs: Unpack[ResumeBatchLoadTaskRequestTypeDef]
+    ) -> dict[str, Any]:
         """
-    def tag_resource(self, *, ResourceARN: str, Tags: Sequence["TagTypeDef"]) -> Dict[str, Any]:
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/resume_batch_load_task.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#resume_batch_load_task)
         """
-        Associate a set of tags with a Timestream resource.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client.tag_resource)
-        [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html#tag_resource)
+    def tag_resource(self, **kwargs: Unpack[TagResourceRequestTypeDef]) -> dict[str, Any]:
         """
-    def untag_resource(self, *, ResourceARN: str, TagKeys: Sequence[str]) -> Dict[str, Any]:
+        Associates a set of tags with a Timestream resource.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/tag_resource.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#tag_resource)
+        """
+
+    def untag_resource(self, **kwargs: Unpack[UntagResourceRequestTypeDef]) -> dict[str, Any]:
         """
         Removes the association of tags from a Timestream resource.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client.untag_resource)
-        [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html#untag_resource)
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/untag_resource.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#untag_resource)
         """
-    def update_database(self, *, DatabaseName: str, KmsKeyId: str) -> UpdateDatabaseResponseTypeDef:
+
+    def update_database(
+        self, **kwargs: Unpack[UpdateDatabaseRequestTypeDef]
+    ) -> UpdateDatabaseResponseTypeDef:
         """
         Modifies the KMS key for an existing database.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client.update_database)
-        [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html#update_database)
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/update_database.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#update_database)
         """
+
     def update_table(
-        self,
-        *,
-        DatabaseName: str,
-        TableName: str,
-        RetentionProperties: "RetentionPropertiesTypeDef"
+        self, **kwargs: Unpack[UpdateTableRequestTypeDef]
     ) -> UpdateTableResponseTypeDef:
         """
         Modifies the retention duration of the memory store and magnetic store for your
         Timestream table.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client.update_table)
-        [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html#update_table)
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/update_table.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#update_table)
         """
+
     def write_records(
-        self,
-        *,
-        DatabaseName: str,
-        TableName: str,
-        Records: Sequence["RecordTypeDef"],
-        CommonAttributes: "RecordTypeDef" = ...
-    ) -> None:
-        """
-        The WriteRecords operation enables you to write your time series data into
-        Timestream.
-
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/1.19.9/reference/services/timestream-write.html#TimestreamWrite.Client.write_records)
-        [Show boto3-stubs documentation](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client.html#write_records)
+        self, **kwargs: Unpack[WriteRecordsRequestTypeDef]
+    ) -> WriteRecordsResponseTypeDef:
+        """
+        Enables you to write your time-series data into Timestream.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write/client/write_records.html)
+        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#write_records)
         """