types-boto3-full 1.39.3__py3-none-any.whl → 1.39.5__py3-none-any.whl

types_boto3_s3/client.py

@@ -43,6 +43,7 @@ from .type_defs import (
     CopyObjectOutputTypeDef,
     CopyObjectRequestTypeDef,
     CopySourceTypeDef,
+    CreateBucketMetadataConfigurationRequestTypeDef,
     CreateBucketMetadataTableConfigurationRequestTypeDef,
     CreateBucketOutputTypeDef,
     CreateBucketRequestTypeDef,
@@ -56,6 +57,7 @@ from .type_defs import (
     DeleteBucketIntelligentTieringConfigurationRequestTypeDef,
     DeleteBucketInventoryConfigurationRequestTypeDef,
     DeleteBucketLifecycleRequestTypeDef,
+    DeleteBucketMetadataConfigurationRequestTypeDef,
     DeleteBucketMetadataTableConfigurationRequestTypeDef,
     DeleteBucketMetricsConfigurationRequestTypeDef,
     DeleteBucketOwnershipControlsRequestTypeDef,
@@ -95,6 +97,8 @@ from .type_defs import (
     GetBucketLocationRequestTypeDef,
     GetBucketLoggingOutputTypeDef,
     GetBucketLoggingRequestTypeDef,
+    GetBucketMetadataConfigurationOutputTypeDef,
+    GetBucketMetadataConfigurationRequestTypeDef,
     GetBucketMetadataTableConfigurationOutputTypeDef,
     GetBucketMetadataTableConfigurationRequestTypeDef,
     GetBucketMetricsConfigurationOutputTypeDef,
@@ -202,6 +206,8 @@ from .type_defs import (
     RestoreObjectRequestTypeDef,
     SelectObjectContentOutputTypeDef,
     SelectObjectContentRequestTypeDef,
+    UpdateBucketMetadataInventoryTableConfigurationRequestTypeDef,
+    UpdateBucketMetadataJournalTableConfigurationRequestTypeDef,
     UploadPartCopyOutputTypeDef,
     UploadPartCopyRequestTypeDef,
     UploadPartOutputTypeDef,
@@ -323,11 +329,23 @@ class S3Client(BaseClient):
         [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#create_bucket)
         """
 
+    def create_bucket_metadata_configuration(
+        self, **kwargs: Unpack[CreateBucketMetadataConfigurationRequestTypeDef]
+    ) -> EmptyResponseMetadataTypeDef:
+        """
+        Creates an S3 Metadata V2 metadata configuration for a general purpose bucket.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/client/create_bucket_metadata_configuration.html)
+        [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#create_bucket_metadata_configuration)
+        """
+
     def create_bucket_metadata_table_configuration(
         self, **kwargs: Unpack[CreateBucketMetadataTableConfigurationRequestTypeDef]
     ) -> EmptyResponseMetadataTypeDef:
         """
-        Creates a metadata table configuration for a general purpose bucket.
+        We recommend that you create your S3 Metadata configurations by using the V2 <a
+        href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html">CreateBucketMetadataConfiguration</a>
+        API operation.
 
         [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/client/create_bucket_metadata_table_configuration.html)
         [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#create_bucket_metadata_table_configuration)
@@ -427,11 +445,23 @@ class S3Client(BaseClient):
         [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#delete_bucket_lifecycle)
         """
 
+    def delete_bucket_metadata_configuration(
+        self, **kwargs: Unpack[DeleteBucketMetadataConfigurationRequestTypeDef]
+    ) -> EmptyResponseMetadataTypeDef:
+        """
+        Deletes an S3 Metadata configuration from a general purpose bucket.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/client/delete_bucket_metadata_configuration.html)
+        [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#delete_bucket_metadata_configuration)
+        """
+
     def delete_bucket_metadata_table_configuration(
         self, **kwargs: Unpack[DeleteBucketMetadataTableConfigurationRequestTypeDef]
     ) -> EmptyResponseMetadataTypeDef:
         """
-        Deletes a metadata table configuration from a general purpose bucket.
+        We recommend that you delete your S3 Metadata configurations by using the V2 <a
+        href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetadataTableConfiguration.html">DeleteBucketMetadataTableConfiguration</a>
+        API operation.
 
         [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/client/delete_bucket_metadata_table_configuration.html)
         [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#delete_bucket_metadata_table_configuration)
@@ -651,11 +681,24 @@ class S3Client(BaseClient):
         [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#get_bucket_logging)
         """
 
+    def get_bucket_metadata_configuration(
+        self, **kwargs: Unpack[GetBucketMetadataConfigurationRequestTypeDef]
+    ) -> GetBucketMetadataConfigurationOutputTypeDef:
+        """
+        Retrieves the S3 Metadata configuration for a general purpose bucket.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/client/get_bucket_metadata_configuration.html)
+        [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#get_bucket_metadata_configuration)
+        """
+
     def get_bucket_metadata_table_configuration(
         self, **kwargs: Unpack[GetBucketMetadataTableConfigurationRequestTypeDef]
     ) -> GetBucketMetadataTableConfigurationOutputTypeDef:
         """
-        Retrieves the metadata table configuration for a general purpose bucket.
+        We recommend that you retrieve your S3 Metadata configurations by using the V2
+        <a
+        href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataTableConfiguration.html">GetBucketMetadataTableConfiguration</a>
+        API operation.
 
         [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/client/get_bucket_metadata_table_configuration.html)
         [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#get_bucket_metadata_table_configuration)
@@ -1290,6 +1333,28 @@ class S3Client(BaseClient):
         [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#select_object_content)
         """
 
+    def update_bucket_metadata_inventory_table_configuration(
+        self, **kwargs: Unpack[UpdateBucketMetadataInventoryTableConfigurationRequestTypeDef]
+    ) -> EmptyResponseMetadataTypeDef:
+        """
+        Enables or disables a live inventory table for an S3 Metadata configuration on
+        a general purpose bucket.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/client/update_bucket_metadata_inventory_table_configuration.html)
+        [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#update_bucket_metadata_inventory_table_configuration)
+        """
+
+    def update_bucket_metadata_journal_table_configuration(
+        self, **kwargs: Unpack[UpdateBucketMetadataJournalTableConfigurationRequestTypeDef]
+    ) -> EmptyResponseMetadataTypeDef:
+        """
+        Enables or disables journal table record expiration for an S3 Metadata
+        configuration on a general purpose bucket.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/client/update_bucket_metadata_journal_table_configuration.html)
+        [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#update_bucket_metadata_journal_table_configuration)
+        """
+
     def upload_part(self, **kwargs: Unpack[UploadPartRequestTypeDef]) -> UploadPartOutputTypeDef:
         """
         Uploads a part in a multipart upload.

types_boto3_s3/client.pyi

@@ -43,6 +43,7 @@ from .type_defs import (
     CopyObjectOutputTypeDef,
     CopyObjectRequestTypeDef,
     CopySourceTypeDef,
+    CreateBucketMetadataConfigurationRequestTypeDef,
     CreateBucketMetadataTableConfigurationRequestTypeDef,
     CreateBucketOutputTypeDef,
     CreateBucketRequestTypeDef,
@@ -56,6 +57,7 @@ from .type_defs import (
     DeleteBucketIntelligentTieringConfigurationRequestTypeDef,
     DeleteBucketInventoryConfigurationRequestTypeDef,
     DeleteBucketLifecycleRequestTypeDef,
+    DeleteBucketMetadataConfigurationRequestTypeDef,
     DeleteBucketMetadataTableConfigurationRequestTypeDef,
     DeleteBucketMetricsConfigurationRequestTypeDef,
     DeleteBucketOwnershipControlsRequestTypeDef,
@@ -95,6 +97,8 @@ from .type_defs import (
     GetBucketLocationRequestTypeDef,
     GetBucketLoggingOutputTypeDef,
     GetBucketLoggingRequestTypeDef,
+    GetBucketMetadataConfigurationOutputTypeDef,
+    GetBucketMetadataConfigurationRequestTypeDef,
     GetBucketMetadataTableConfigurationOutputTypeDef,
     GetBucketMetadataTableConfigurationRequestTypeDef,
     GetBucketMetricsConfigurationOutputTypeDef,
@@ -202,6 +206,8 @@ from .type_defs import (
     RestoreObjectRequestTypeDef,
     SelectObjectContentOutputTypeDef,
     SelectObjectContentRequestTypeDef,
+    UpdateBucketMetadataInventoryTableConfigurationRequestTypeDef,
+    UpdateBucketMetadataJournalTableConfigurationRequestTypeDef,
     UploadPartCopyOutputTypeDef,
     UploadPartCopyRequestTypeDef,
     UploadPartOutputTypeDef,
@@ -320,11 +326,23 @@ class S3Client(BaseClient):
         [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#create_bucket)
         """
 
+    def create_bucket_metadata_configuration(
+        self, **kwargs: Unpack[CreateBucketMetadataConfigurationRequestTypeDef]
+    ) -> EmptyResponseMetadataTypeDef:
+        """
+        Creates an S3 Metadata V2 metadata configuration for a general purpose bucket.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/client/create_bucket_metadata_configuration.html)
+        [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#create_bucket_metadata_configuration)
+        """
+
     def create_bucket_metadata_table_configuration(
         self, **kwargs: Unpack[CreateBucketMetadataTableConfigurationRequestTypeDef]
     ) -> EmptyResponseMetadataTypeDef:
         """
-        Creates a metadata table configuration for a general purpose bucket.
+        We recommend that you create your S3 Metadata configurations by using the V2 <a
+        href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html">CreateBucketMetadataConfiguration</a>
+        API operation.
 
         [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/client/create_bucket_metadata_table_configuration.html)
         [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#create_bucket_metadata_table_configuration)
@@ -424,11 +442,23 @@ class S3Client(BaseClient):
         [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#delete_bucket_lifecycle)
         """
 
+    def delete_bucket_metadata_configuration(
+        self, **kwargs: Unpack[DeleteBucketMetadataConfigurationRequestTypeDef]
+    ) -> EmptyResponseMetadataTypeDef:
+        """
+        Deletes an S3 Metadata configuration from a general purpose bucket.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/client/delete_bucket_metadata_configuration.html)
+        [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#delete_bucket_metadata_configuration)
+        """
+
     def delete_bucket_metadata_table_configuration(
         self, **kwargs: Unpack[DeleteBucketMetadataTableConfigurationRequestTypeDef]
     ) -> EmptyResponseMetadataTypeDef:
         """
-        Deletes a metadata table configuration from a general purpose bucket.
+        We recommend that you delete your S3 Metadata configurations by using the V2 <a
+        href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetadataTableConfiguration.html">DeleteBucketMetadataTableConfiguration</a>
+        API operation.
 
         [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/client/delete_bucket_metadata_table_configuration.html)
         [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#delete_bucket_metadata_table_configuration)
@@ -648,11 +678,24 @@ class S3Client(BaseClient):
         [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#get_bucket_logging)
         """
 
+    def get_bucket_metadata_configuration(
+        self, **kwargs: Unpack[GetBucketMetadataConfigurationRequestTypeDef]
+    ) -> GetBucketMetadataConfigurationOutputTypeDef:
+        """
+        Retrieves the S3 Metadata configuration for a general purpose bucket.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/client/get_bucket_metadata_configuration.html)
+        [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#get_bucket_metadata_configuration)
+        """
+
     def get_bucket_metadata_table_configuration(
         self, **kwargs: Unpack[GetBucketMetadataTableConfigurationRequestTypeDef]
     ) -> GetBucketMetadataTableConfigurationOutputTypeDef:
         """
-        Retrieves the metadata table configuration for a general purpose bucket.
+        We recommend that you retrieve your S3 Metadata configurations by using the V2
+        <a
+        href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataTableConfiguration.html">GetBucketMetadataTableConfiguration</a>
+        API operation.
 
         [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/client/get_bucket_metadata_table_configuration.html)
         [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#get_bucket_metadata_table_configuration)
@@ -1287,6 +1330,28 @@ class S3Client(BaseClient):
         [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#select_object_content)
         """
 
+    def update_bucket_metadata_inventory_table_configuration(
+        self, **kwargs: Unpack[UpdateBucketMetadataInventoryTableConfigurationRequestTypeDef]
+    ) -> EmptyResponseMetadataTypeDef:
+        """
+        Enables or disables a live inventory table for an S3 Metadata configuration on
+        a general purpose bucket.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/client/update_bucket_metadata_inventory_table_configuration.html)
+        [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#update_bucket_metadata_inventory_table_configuration)
+        """
+
+    def update_bucket_metadata_journal_table_configuration(
+        self, **kwargs: Unpack[UpdateBucketMetadataJournalTableConfigurationRequestTypeDef]
+    ) -> EmptyResponseMetadataTypeDef:
+        """
+        Enables or disables journal table record expiration for an S3 Metadata
+        configuration on a general purpose bucket.
+
+        [Show boto3 documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/client/update_bucket_metadata_journal_table_configuration.html)
+        [Show types-boto3-full documentation](https://youtype.github.io/types_boto3_docs/types_boto3_s3/client/#update_bucket_metadata_journal_table_configuration)
+        """
+
     def upload_part(self, **kwargs: Unpack[UploadPartRequestTypeDef]) -> UploadPartOutputTypeDef:
         """
         Uploads a part in a multipart upload.

types_boto3_s3/literals.py

@@ -42,12 +42,14 @@ __all__ = (
     "EncodingTypeType",
     "EventType",
     "ExistingObjectReplicationStatusType",
+    "ExpirationStateType",
     "ExpirationStatusType",
     "ExpressionTypeType",
     "FileHeaderInfoType",
     "FilterRuleNameType",
     "IntelligentTieringAccessTierType",
     "IntelligentTieringStatusType",
+    "InventoryConfigurationStateType",
     "InventoryFormatType",
     "InventoryFrequencyType",
     "InventoryIncludedObjectVersionsType",
@@ -94,12 +96,14 @@ __all__ = (
     "ResourceServiceName",
     "RestoreRequestTypeType",
     "S3ServiceName",
+    "S3TablesBucketTypeType",
     "ServerSideEncryptionType",
     "ServiceName",
     "SessionModeType",
     "SseKmsEncryptedObjectsStatusType",
     "StorageClassAnalysisSchemaVersionType",
     "StorageClassType",
+    "TableSseAlgorithmType",
     "TaggingDirectiveType",
     "TierType",
     "TransitionDefaultMinimumObjectSizeType",
@@ -190,12 +194,14 @@ EventType = Literal[
     "s3:Replication:OperationReplicatedAfterThreshold",
 ]
 ExistingObjectReplicationStatusType = Literal["Disabled", "Enabled"]
+ExpirationStateType = Literal["DISABLED", "ENABLED"]
 ExpirationStatusType = Literal["Disabled", "Enabled"]
 ExpressionTypeType = Literal["SQL"]
 FileHeaderInfoType = Literal["IGNORE", "NONE", "USE"]
 FilterRuleNameType = Literal["prefix", "suffix"]
 IntelligentTieringAccessTierType = Literal["ARCHIVE_ACCESS", "DEEP_ARCHIVE_ACCESS"]
 IntelligentTieringStatusType = Literal["Disabled", "Enabled"]
+InventoryConfigurationStateType = Literal["DISABLED", "ENABLED"]
 InventoryFormatType = Literal["CSV", "ORC", "Parquet"]
 InventoryFrequencyType = Literal["Daily", "Weekly"]
 InventoryIncludedObjectVersionsType = Literal["All", "Current"]
@@ -275,6 +281,7 @@ ReplicationTimeStatusType = Literal["Disabled", "Enabled"]
 RequestChargedType = Literal["requester"]
 RequestPayerType = Literal["requester"]
 RestoreRequestTypeType = Literal["SELECT"]
+S3TablesBucketTypeType = Literal["aws", "customer"]
 ServerSideEncryptionType = Literal["AES256", "aws:fsx", "aws:kms", "aws:kms:dsse"]
 SessionModeType = Literal["ReadOnly", "ReadWrite"]
 SseKmsEncryptedObjectsStatusType = Literal["Disabled", "Enabled"]
@@ -293,6 +300,7 @@ StorageClassType = Literal[
     "STANDARD",
     "STANDARD_IA",
 ]
+TableSseAlgorithmType = Literal["AES256", "aws:kms"]
 TaggingDirectiveType = Literal["COPY", "REPLACE"]
 TierType = Literal["Bulk", "Expedited", "Standard"]
 TransitionDefaultMinimumObjectSizeType = Literal[
@@ -639,6 +647,7 @@ ServiceName = Literal[
     "s3control",
     "s3outposts",
     "s3tables",
+    "s3vectors",
     "sagemaker",
     "sagemaker-a2i-runtime",
     "sagemaker-edge",

types_boto3_s3/literals.pyi

@@ -41,12 +41,14 @@ __all__ = (
     "EncodingTypeType",
     "EventType",
     "ExistingObjectReplicationStatusType",
+    "ExpirationStateType",
     "ExpirationStatusType",
     "ExpressionTypeType",
     "FileHeaderInfoType",
     "FilterRuleNameType",
     "IntelligentTieringAccessTierType",
     "IntelligentTieringStatusType",
+    "InventoryConfigurationStateType",
     "InventoryFormatType",
     "InventoryFrequencyType",
     "InventoryIncludedObjectVersionsType",
@@ -93,12 +95,14 @@ __all__ = (
     "ResourceServiceName",
     "RestoreRequestTypeType",
     "S3ServiceName",
+    "S3TablesBucketTypeType",
     "ServerSideEncryptionType",
     "ServiceName",
     "SessionModeType",
     "SseKmsEncryptedObjectsStatusType",
     "StorageClassAnalysisSchemaVersionType",
     "StorageClassType",
+    "TableSseAlgorithmType",
     "TaggingDirectiveType",
     "TierType",
     "TransitionDefaultMinimumObjectSizeType",
@@ -188,12 +192,14 @@ EventType = Literal[
     "s3:Replication:OperationReplicatedAfterThreshold",
 ]
 ExistingObjectReplicationStatusType = Literal["Disabled", "Enabled"]
+ExpirationStateType = Literal["DISABLED", "ENABLED"]
 ExpirationStatusType = Literal["Disabled", "Enabled"]
 ExpressionTypeType = Literal["SQL"]
 FileHeaderInfoType = Literal["IGNORE", "NONE", "USE"]
 FilterRuleNameType = Literal["prefix", "suffix"]
 IntelligentTieringAccessTierType = Literal["ARCHIVE_ACCESS", "DEEP_ARCHIVE_ACCESS"]
 IntelligentTieringStatusType = Literal["Disabled", "Enabled"]
+InventoryConfigurationStateType = Literal["DISABLED", "ENABLED"]
 InventoryFormatType = Literal["CSV", "ORC", "Parquet"]
 InventoryFrequencyType = Literal["Daily", "Weekly"]
 InventoryIncludedObjectVersionsType = Literal["All", "Current"]
@@ -273,6 +279,7 @@ ReplicationTimeStatusType = Literal["Disabled", "Enabled"]
 RequestChargedType = Literal["requester"]
 RequestPayerType = Literal["requester"]
 RestoreRequestTypeType = Literal["SELECT"]
+S3TablesBucketTypeType = Literal["aws", "customer"]
 ServerSideEncryptionType = Literal["AES256", "aws:fsx", "aws:kms", "aws:kms:dsse"]
 SessionModeType = Literal["ReadOnly", "ReadWrite"]
 SseKmsEncryptedObjectsStatusType = Literal["Disabled", "Enabled"]
@@ -291,6 +298,7 @@ StorageClassType = Literal[
     "STANDARD",
     "STANDARD_IA",
 ]
+TableSseAlgorithmType = Literal["AES256", "aws:kms"]
 TaggingDirectiveType = Literal["COPY", "REPLACE"]
 TierType = Literal["Bulk", "Expedited", "Standard"]
 TransitionDefaultMinimumObjectSizeType = Literal[
@@ -637,6 +645,7 @@ ServiceName = Literal[
     "s3control",
     "s3outposts",
     "s3tables",
+    "s3vectors",
     "sagemaker",
     "sagemaker-a2i-runtime",
     "sagemaker-edge",