mypy-boto3-timestream-write 1.34.0__py3-none-any.whl → 1.35.93__py3-none-any.whl

mypy_boto3_timestream_write/client.pyi

@@ -1,7 +1,7 @@
 """
-Type annotations for timestream-write service client.
+Type annotations for timestream-write service Client.
 
-[Open documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/)
+[Documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/)
 
 Usage::
 
@@ -12,49 +12,69 @@ Usage::
     session = Session()
     client: TimestreamWriteClient = session.client("timestream-write")
     ```
+
+Copyright 2025 Vlad Emelianov
 """
 
-from typing import Any, Dict, Mapping, Sequence, Type
+from __future__ import annotations
+
+import sys
+from typing import Any
 
 from botocore.client import BaseClient, ClientMeta
+from botocore.errorfactory import BaseClientExceptions
+from botocore.exceptions import ClientError as BotocoreClientError
 
-from .literals import BatchLoadStatusType
 from .type_defs import (
+    CreateBatchLoadTaskRequestRequestTypeDef,
     CreateBatchLoadTaskResponseTypeDef,
+    CreateDatabaseRequestRequestTypeDef,
     CreateDatabaseResponseTypeDef,
+    CreateTableRequestRequestTypeDef,
     CreateTableResponseTypeDef,
-    DataModelConfigurationTypeDef,
-    DataSourceConfigurationTypeDef,
+    DeleteDatabaseRequestRequestTypeDef,
+    DeleteTableRequestRequestTypeDef,
+    DescribeBatchLoadTaskRequestRequestTypeDef,
     DescribeBatchLoadTaskResponseTypeDef,
+    DescribeDatabaseRequestRequestTypeDef,
     DescribeDatabaseResponseTypeDef,
     DescribeEndpointsResponseTypeDef,
+    DescribeTableRequestRequestTypeDef,
     DescribeTableResponseTypeDef,
     EmptyResponseMetadataTypeDef,
+    ListBatchLoadTasksRequestRequestTypeDef,
     ListBatchLoadTasksResponseTypeDef,
+    ListDatabasesRequestRequestTypeDef,
     ListDatabasesResponseTypeDef,
+    ListTablesRequestRequestTypeDef,
     ListTablesResponseTypeDef,
+    ListTagsForResourceRequestRequestTypeDef,
     ListTagsForResourceResponseTypeDef,
-    MagneticStoreWritePropertiesTypeDef,
-    RecordTypeDef,
-    ReportConfigurationTypeDef,
-    RetentionPropertiesTypeDef,
-    SchemaTypeDef,
-    TagTypeDef,
+    ResumeBatchLoadTaskRequestRequestTypeDef,
+    TagResourceRequestRequestTypeDef,
+    UntagResourceRequestRequestTypeDef,
+    UpdateDatabaseRequestRequestTypeDef,
     UpdateDatabaseResponseTypeDef,
+    UpdateTableRequestRequestTypeDef,
     UpdateTableResponseTypeDef,
+    WriteRecordsRequestRequestTypeDef,
     WriteRecordsResponseTypeDef,
 )
 
-__all__ = ("TimestreamWriteClient",)
-
-class BotocoreClientError(Exception):
-    MSG_TEMPLATE: str
+if sys.version_info >= (3, 9):
+    from builtins import dict as Dict
+    from builtins import type as Type
+    from collections.abc import Mapping
+else:
+    from typing import Dict, Mapping, Type
+if sys.version_info >= (3, 12):
+    from typing import Unpack
+else:
+    from typing_extensions import Unpack
 
-    def __init__(self, error_response: Mapping[str, Any], operation_name: str) -> None:
-        self.response: Dict[str, Any]
-        self.operation_name: str
+__all__ = ("TimestreamWriteClient",)
 
-class Exceptions:
+class Exceptions(BaseClientExceptions):
     AccessDeniedException: Type[BotocoreClientError]
     ClientError: Type[BotocoreClientError]
     ConflictException: Type[BotocoreClientError]
@@ -79,104 +99,98 @@ class TimestreamWriteClient(BaseClient):
         """
         TimestreamWriteClient exceptions.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.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.html#TimestreamWrite.Client.can_paginate)
+        [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 close(self) -> None:
+    def generate_presigned_url(
+        self,
+        ClientMethod: str,
+        Params: Mapping[str, Any] = ...,
+        ExpiresIn: int = 3600,
+        HttpMethod: str = ...,
+    ) -> str:
         """
-        Closes underlying endpoint connections.
-
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.close)
-        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#close)
+        [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)
         """
 
     def create_batch_load_task(
-        self,
-        *,
-        DataSourceConfiguration: DataSourceConfigurationTypeDef,
-        ReportConfiguration: ReportConfigurationTypeDef,
-        TargetDatabaseName: str,
-        TargetTableName: str,
-        ClientToken: str = ...,
-        DataModelConfiguration: DataModelConfigurationTypeDef = ...,
-        RecordVersion: int = ...
+        self, **kwargs: Unpack[CreateBatchLoadTaskRequestRequestTypeDef]
     ) -> CreateBatchLoadTaskResponseTypeDef:
         """
         Creates a new Timestream batch load task.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.create_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[CreateDatabaseRequestRequestTypeDef]
     ) -> CreateDatabaseResponseTypeDef:
         """
         Creates a new Timestream database.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.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] = ...,
-        MagneticStoreWriteProperties: MagneticStoreWritePropertiesTypeDef = ...,
-        Schema: SchemaTypeDef = ...
+        self, **kwargs: Unpack[CreateTableRequestRequestTypeDef]
     ) -> CreateTableResponseTypeDef:
         """
         Adds a new table to an existing database in your account.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.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) -> EmptyResponseMetadataTypeDef:
+    def delete_database(
+        self, **kwargs: Unpack[DeleteDatabaseRequestRequestTypeDef]
+    ) -> EmptyResponseMetadataTypeDef:
         """
         Deletes a given Timestream database.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.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) -> EmptyResponseMetadataTypeDef:
+    def delete_table(
+        self, **kwargs: Unpack[DeleteTableRequestRequestTypeDef]
+    ) -> EmptyResponseMetadataTypeDef:
         """
         Deletes a given Timestream table.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.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_batch_load_task(self, *, TaskId: str) -> DescribeBatchLoadTaskResponseTypeDef:
+    def describe_batch_load_task(
+        self, **kwargs: Unpack[DescribeBatchLoadTaskRequestRequestTypeDef]
+    ) -> DescribeBatchLoadTaskResponseTypeDef:
         """
         Returns information about the batch load task, including configurations,
-        mappings, progress, and other
-        details.
+        mappings, progress, and other details.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.describe_batch_load_task)
+        [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, *, DatabaseName: str) -> DescribeDatabaseResponseTypeDef:
+    def describe_database(
+        self, **kwargs: Unpack[DescribeDatabaseRequestRequestTypeDef]
+    ) -> 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/latest/reference/services/timestream-write.html#TimestreamWrite.Client.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)
         """
 
@@ -184,138 +198,116 @@ class TimestreamWriteClient(BaseClient):
         """
         Returns a list of available endpoints to make Timestream API calls against.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.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[DescribeTableRequestRequestTypeDef]
+    ) -> DescribeTableResponseTypeDef:
         """
         Returns information about the table, including the table name, database name,
-        retention duration of the memory store and the magnetic
-        store.
+        retention duration of the memory store and the magnetic store.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.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:
-        """
-        Generate a presigned url given a client, its method, and arguments.
-
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.generate_presigned_url)
-        [Show boto3-stubs documentation](https://youtype.github.io/boto3_stubs_docs/mypy_boto3_timestream_write/client/#generate_presigned_url)
-        """
-
     def list_batch_load_tasks(
-        self, *, NextToken: str = ..., MaxResults: int = ..., TaskStatus: BatchLoadStatusType = ...
+        self, **kwargs: Unpack[ListBatchLoadTasksRequestRequestTypeDef]
     ) -> ListBatchLoadTasksResponseTypeDef:
         """
         Provides a list of batch load tasks, along with the name, status, when the task
-        is resumable until, and other
-        details.
+        is resumable until, and other details.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.list_batch_load_tasks)
+        [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[ListDatabasesRequestRequestTypeDef]
     ) -> ListDatabasesResponseTypeDef:
         """
         Returns a list of your Timestream databases.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.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 = ...
+        self, **kwargs: Unpack[ListTablesRequestRequestTypeDef]
     ) -> ListTablesResponseTypeDef:
         """
         Provides a list of tables, along with the name, status, and retention
-        properties of each
-        table.
+        properties of each table.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.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[ListTagsForResourceRequestRequestTypeDef]
+    ) -> ListTagsForResourceResponseTypeDef:
         """
         Lists all tags on a Timestream resource.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.list_tags_for_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)
         """
 
-    def resume_batch_load_task(self, *, TaskId: str) -> Dict[str, Any]:
+    def resume_batch_load_task(
+        self, **kwargs: Unpack[ResumeBatchLoadTaskRequestRequestTypeDef]
+    ) -> Dict[str, Any]:
         """
-        See also: [AWS API
-        Documentation](https://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/ResumeBatchLoadTask).
-
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.resume_batch_load_task)
+        [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)
         """
 
-    def tag_resource(self, *, ResourceARN: str, Tags: Sequence[TagTypeDef]) -> Dict[str, Any]:
+    def tag_resource(self, **kwargs: Unpack[TagResourceRequestRequestTypeDef]) -> 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.html#TimestreamWrite.Client.tag_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, *, ResourceARN: str, TagKeys: Sequence[str]) -> Dict[str, Any]:
+    def untag_resource(
+        self, **kwargs: Unpack[UntagResourceRequestRequestTypeDef]
+    ) -> Dict[str, Any]:
         """
         Removes the association of tags from a Timestream resource.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.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[UpdateDatabaseRequestRequestTypeDef]
+    ) -> UpdateDatabaseResponseTypeDef:
         """
         Modifies the KMS key for an existing database.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.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 = ...,
-        MagneticStoreWriteProperties: MagneticStoreWritePropertiesTypeDef = ...,
-        Schema: SchemaTypeDef = ...
+        self, **kwargs: Unpack[UpdateTableRequestRequestTypeDef]
     ) -> UpdateTableResponseTypeDef:
         """
         Modifies the retention duration of the memory store and magnetic store for your
-        Timestream
-        table.
+        Timestream table.
 
-        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/timestream-write.html#TimestreamWrite.Client.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 = ...
+        self, **kwargs: Unpack[WriteRecordsRequestRequestTypeDef]
     ) -> 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.html#TimestreamWrite.Client.write_records)
+        [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)
         """