{ "smithy": "2.0", "shapes": { "com.amazonaws.s3tables#AccessDeniedException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.s3tables#ErrorMessage" } }, "traits": { "smithy.api#documentation": "
The action cannot be performed because you do not have the required permission.
", "smithy.api#error": "client", "smithy.api#httpError": 403 } }, "com.amazonaws.s3tables#AccountId": { "type": "string", "traits": { "smithy.api#length": { "min": 12, "max": 12 }, "smithy.api#pattern": "^[0-9].*$" } }, "com.amazonaws.s3tables#BadRequestException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.s3tables#ErrorMessage" } }, "traits": { "smithy.api#documentation": "The request is invalid or malformed.
", "smithy.api#error": "client", "smithy.api#httpError": 400 } }, "com.amazonaws.s3tables#ChecksumCRC64NVME": { "type": "string", "traits": { "smithy.api#length": { "min": 12, "max": 12 }, "smithy.api#pattern": "^[A-Za-z0-9+/]{11}=$" } }, "com.amazonaws.s3tables#CompleteTableMigration": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#CompleteTableMigrationRequest" }, "output": { "target": "smithy.api#Unit" }, "errors": [ { "target": "com.amazonaws.s3tables#AccessDeniedException" }, { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Completes the migration of a table. The table's most recent migration must be in the succeeded, failed or cancelled state. After you complete the migration, you can't sync the table again, and you can write to and maintain the table as you do any other table: compaction starts, and unreferenced file removal follows the table bucket's configuration. You can't undo this operation. Calling it again for the same table returns a ConflictException.
You must have the s3tables:CompleteTableMigration permission to use this operation.
The Amazon Resource Name (ARN) of the migrated table to complete the migration of.
", "smithy.api#httpQuery": "tableARN", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#CompressionCodec": { "type": "enum", "members": { "ZSTD": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "zstd" } }, "SNAPPY": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "snappy" } }, "GZIP": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "gzip" } }, "UNCOMPRESSED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "uncompressed" } } } }, "com.amazonaws.s3tables#ConflictException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.s3tables#ErrorMessage" } }, "traits": { "smithy.api#documentation": "The request failed because there is a conflict with a previous write. You can retry the request.
", "smithy.api#error": "client", "smithy.api#httpError": 409 } }, "com.amazonaws.s3tables#CreateNamespace": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#CreateNamespaceRequest" }, "output": { "target": "com.amazonaws.s3tables#CreateNamespaceResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Creates a namespace. A namespace is a logical grouping of tables within your table bucket, which you can use to organize tables. For more information, see Create a namespace in the Amazon Simple Storage Service User Guide.
You must have the s3tables:CreateNamespace permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket to create the namespace in.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceList", "traits": { "smithy.api#documentation": "A name for the namespace.
", "smithy.api#length": { "min": 1, "max": 1 }, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#CreateNamespaceResponse": { "type": "structure", "members": { "tableBucketARN": { "target": "com.amazonaws.s3tables#TableBucketARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table bucket the namespace was created in.
", "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceList", "traits": { "smithy.api#documentation": "The name of the namespace.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#CreateTable": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#CreateTableRequest" }, "output": { "target": "com.amazonaws.s3tables#CreateTableResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Creates a new table associated with the given namespace in a table bucket. For more information, see Creating an Amazon S3 table in the Amazon Simple Storage Service User Guide.
You must have the s3tables:CreateTable permission to use this operation.
If you use this operation with the optional metadata request parameter you must have the s3tables:PutTableData permission.
If you use this operation with the optional encryptionConfiguration request parameter you must have the s3tables:PutTableEncryption permission.
If you use this operation with the storageClassConfiguration request parameter, you must have the s3tables:PutTableStorageClass permission.
To create a table with tags, you must have the s3tables:TagResource permission in addition to s3tables:CreateTable permission.
Additionally, If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see Permissions requirements for S3 Tables SSE-KMS encryption.
Creates a table bucket. For more information, see Creating a table bucket in the Amazon Simple Storage Service User Guide.
You must have the s3tables:CreateTableBucket permission to use this operation.
If you use this operation with the optional encryptionConfiguration parameter you must have the s3tables:PutTableBucketEncryption permission.
If you use this operation with the storageClassConfiguration request parameter, you must have the s3tables:PutTableBucketStorageClass permission.
To create a table bucket with tags, you must have the s3tables:TagResource permission in addition to s3tables:CreateTableBucket permission.
The name for the table bucket.
", "smithy.api#required": {} } }, "encryptionConfiguration": { "target": "com.amazonaws.s3tables#EncryptionConfiguration", "traits": { "smithy.api#documentation": "The encryption configuration to use for the table bucket. This configuration specifies the default encryption settings that will be applied to all tables created in this bucket unless overridden at the table level. The configuration includes the encryption algorithm and, if using SSE-KMS, the KMS key to use.
" } }, "storageClassConfiguration": { "target": "com.amazonaws.s3tables#StorageClassConfiguration", "traits": { "smithy.api#documentation": "The default storage class configuration for the table bucket. This configuration will be applied to all new tables created in this bucket unless overridden at the table level. If not specified, the service default storage class will be used.
" } }, "tags": { "target": "com.amazonaws.s3tables#Tags", "traits": { "smithy.api#documentation": "A map of user-defined tags that you would like to apply to the table bucket that you are creating. A tag is a key-value pair that you apply to your resources. Tags can help you organize and control access to resources. For more information, see Tagging for cost allocation or attribute-based access control (ABAC).
You must have the s3tables:TagResource permission in addition to s3tables:CreateTableBucket permisson to create a table bucket with tags.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#CreateTableRequest": { "type": "structure", "members": { "tableBucketARN": { "target": "com.amazonaws.s3tables#TableBucketARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table bucket to create the table in.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The namespace to associated with the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name for the table.
", "smithy.api#required": {} } }, "format": { "target": "com.amazonaws.s3tables#OpenTableFormat", "traits": { "smithy.api#documentation": "The format for the table.
", "smithy.api#required": {} } }, "metadata": { "target": "com.amazonaws.s3tables#TableMetadata", "traits": { "smithy.api#documentation": "The metadata for the table.
" } }, "encryptionConfiguration": { "target": "com.amazonaws.s3tables#EncryptionConfiguration", "traits": { "smithy.api#documentation": "The encryption configuration to use for the table. This configuration specifies the encryption algorithm and, if using SSE-KMS, the KMS key to use for encrypting the table.
If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see Permissions requirements for S3 Tables SSE-KMS encryption.
The storage class configuration for the table. If not specified, the table inherits the storage class configuration from its table bucket. Specify this parameter to override the bucket's default storage class for this table.
" } }, "tags": { "target": "com.amazonaws.s3tables#Tags", "traits": { "smithy.api#documentation": "A map of user-defined tags that you would like to apply to the table that you are creating. A tag is a key-value pair that you apply to your resources. Tags can help you organize, track costs for, and control access to resources. For more information, see Tagging for cost allocation or attribute-based access control (ABAC).
You must have the s3tables:TagResource permission in addition to s3tables:CreateTable permission to create a table with tags.
The Amazon Resource Name (ARN) of the table.
", "smithy.api#required": {} } }, "versionToken": { "target": "com.amazonaws.s3tables#VersionToken", "traits": { "smithy.api#documentation": "The version token of the table.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#DataFileFormat": { "type": "enum", "members": { "PARQUET": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "parquet" } } } }, "com.amazonaws.s3tables#DataMigrationOverview": { "type": "structure", "members": { "maintenanceSettings": { "target": "com.amazonaws.s3tables#MaintenanceSettings", "traits": { "smithy.api#documentation": "The maintenance settings for the destination table. The migration applies them when it creates the table: snapshot management starts then, and compaction starts after you complete the migration. If you don't specify a setting, the migration uses its default: a target file size of 512 MB, the binpack compaction strategy, at least 3 snapshots, and a maximum snapshot age of 120 hours. Unreferenced file removal follows the table bucket's configuration after you complete the migration.
", "smithy.api#required": {} } }, "migrationPolicies": { "target": "com.amazonaws.s3tables#MigrationPolicies", "traits": { "smithy.api#documentation": "The policies for source data that doesn't fit the destination schema.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The maintenance settings and migration policies for the destination table.
" } }, "com.amazonaws.s3tables#DataMigrationSettings": { "type": "structure", "members": { "maintenanceSettings": { "target": "com.amazonaws.s3tables#MaintenanceSettings", "traits": { "smithy.api#documentation": "The maintenance settings for the destination table. The migration applies them when it creates the table: snapshot management starts then, and compaction starts after you complete the migration. If you don't specify a setting, the migration uses its default: a target file size of 512 MB, the binpack compaction strategy, at least 3 snapshots, and a maximum snapshot age of 120 hours. Unreferenced file removal follows the table bucket's configuration after you complete the migration.
" } }, "migrationPolicies": { "target": "com.amazonaws.s3tables#MigrationPolicies", "traits": { "smithy.api#documentation": "The policies for source data that doesn't fit the destination schema.
" } } }, "traits": { "smithy.api#documentation": "The maintenance settings and migration policies for the destination table.
" } }, "com.amazonaws.s3tables#DeleteNamespace": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#DeleteNamespaceRequest" }, "output": { "target": "smithy.api#Unit" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Deletes a namespace. For more information, see Delete a namespace in the Amazon Simple Storage Service User Guide.
You must have the s3tables:DeleteNamespace permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket associated with the namespace.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The name of the namespace.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#DeleteTable": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#DeleteTableRequest" }, "output": { "target": "smithy.api#Unit" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Deletes a table. For more information, see Deleting an Amazon S3 table in the Amazon Simple Storage Service User Guide.
You must have the s3tables:DeleteTable permission to use this operation.
Deletes a table bucket. For more information, see Deleting a table bucket in the Amazon Simple Storage Service User Guide.
You must have the s3tables:DeleteTableBucket permission to use this operation.
Deletes the encryption configuration for a table bucket.
You must have the s3tables:DeleteTableBucketEncryption permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#DeleteTableBucketMetricsConfiguration": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#DeleteTableBucketMetricsConfigurationRequest" }, "output": { "target": "smithy.api#Unit" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Deletes the metrics configuration for a table bucket.
You must have the s3tables:DeleteTableBucketMetricsConfiguration permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#DeleteTableBucketPolicy": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#DeleteTableBucketPolicyRequest" }, "output": { "target": "smithy.api#Unit" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Deletes a table bucket policy. For more information, see Deleting a table bucket policy in the Amazon Simple Storage Service User Guide.
You must have the s3tables:DeleteTableBucketPolicy permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#DeleteTableBucketReplication": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#DeleteTableBucketReplicationRequest" }, "output": { "target": "smithy.api#Unit" }, "errors": [ { "target": "com.amazonaws.s3tables#AccessDeniedException" }, { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Deletes the replication configuration for a table bucket. After deletion, new table updates will no longer be replicated to destination buckets, though existing replicated tables will remain in destination buckets.
You must have the s3tables:DeleteTableBucketReplication permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpQuery": "tableBucketARN", "smithy.api#required": {} } }, "versionToken": { "target": "com.amazonaws.s3tables#VersionToken", "traits": { "smithy.api#documentation": "A version token from a previous GetTableBucketReplication call. Use this token to ensure you're deleting the expected version of the configuration.
", "smithy.api#httpQuery": "versionToken" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#DeleteTableBucketRequest": { "type": "structure", "members": { "tableBucketARN": { "target": "com.amazonaws.s3tables#TableBucketARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#DeleteTablePolicy": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#DeleteTablePolicyRequest" }, "output": { "target": "smithy.api#Unit" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Deletes a table policy. For more information, see Deleting a table policy in the Amazon Simple Storage Service User Guide.
You must have the s3tables:DeleteTablePolicy permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket that contains the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The namespace associated with the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The table name.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#DeleteTableReplication": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#DeleteTableReplicationRequest" }, "output": { "target": "smithy.api#Unit" }, "errors": [ { "target": "com.amazonaws.s3tables#AccessDeniedException" }, { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Deletes the replication configuration for a specific table. After deletion, new updates to this table will no longer be replicated to destination tables, though existing replicated copies will remain in destination buckets.
You must have the s3tables:DeleteTableReplication permission to use this operation.
The Amazon Resource Name (ARN) of the table.
", "smithy.api#httpQuery": "tableArn", "smithy.api#required": {} } }, "versionToken": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "A version token from a previous GetTableReplication call. Use this token to ensure you're deleting the expected version of the configuration.
", "smithy.api#httpQuery": "versionToken", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#DeleteTableRequest": { "type": "structure", "members": { "tableBucketARN": { "target": "com.amazonaws.s3tables#TableBucketARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table bucket that contains the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The namespace associated with the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name of the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "versionToken": { "target": "com.amazonaws.s3tables#VersionToken", "traits": { "smithy.api#documentation": "The version token of the table.
", "smithy.api#httpQuery": "versionToken" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#DestinationTable": { "type": "structure", "members": { "tableBucketARN": { "target": "com.amazonaws.s3tables#TableBucketARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table bucket to create the table in.
", "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The namespace to create the table in.
", "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name of the table to create.
", "smithy.api#required": {} } }, "encryptionConfiguration": { "target": "com.amazonaws.s3tables#EncryptionConfiguration", "traits": { "smithy.api#documentation": "The encryption configuration for the table. If you don't specify one, the table uses the default encryption configuration of its table bucket. If you specify an encryption configuration, the migration role must have the s3tables:PutTableEncryption permission. If you choose SSE-KMS, the migration role must have the kms:DescribeKey, kms:GenerateDataKey and kms:Decrypt permissions on the KMS key, and the S3 Tables maintenance principal must have access to it. For more information, see Permissions requirements for S3 Tables SSE-KMS encryption.
The storage class configuration for the table. If you don't specify one, the table inherits the storage class configuration of its table bucket. If you specify a storage class configuration, the migration role must have the s3tables:PutTableStorageClass permission.
The tags to add to the table. A tag is a key-value pair that you apply to your resources. For more information, see Tagging for cost allocation or attribute-based access control (ABAC). If you specify tags, the migration role must have the s3tables:TagResource permission.
The properties of the destination table, such as its Iceberg format version and the format of its data files.
" } }, "schema": { "target": "com.amazonaws.s3tables#IcebergSchemaV2", "traits": { "smithy.api#documentation": "The schema of the table to create. If you don't specify a schema, the migration infers it from the source table, with every column optional. A schema that you specify must include every partition column of the source table. It can leave out other columns only if unmatchedSourceFieldsPolicy is drop. A struct column must have the same fields as the source column. Column default values aren't supported. If you mark a column as required, every source object must have a value for it: an object with a null value in a required column fails to migrate. The destination table is partitioned in the same way as the source table. To specify fields in icebergSortOrder, you must specify a schema.
The sort order of the rows within each data file that the migration writes. A sort order can have up to five fields, each naming a column of the schema that you specify by its field ID, so to use a sort order you must specify a schema. StartTableMigration rejects a field that names no column of the schema, or whose transform doesn't fit the column's type.
The table that a migration creates in a table bucket and migrates the source into.
" } }, "com.amazonaws.s3tables#DisassociateTableReplication": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#DisassociateTableReplicationRequest" }, "output": { "target": "com.amazonaws.s3tables#DisassociateTableReplicationResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#AccessDeniedException" }, { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Disassociates a replica table from replication, making it a standalone writable table. Any in-progress replication to the table stops, and in-flight commits fail without being committed to the table. Disassociating a table from replication is permanent and can't be reversed.
You can only disassociate a replica table. If you call this operation on a table that isn't a replica table, including a table that you have already disassociated, the request fails.
After you disassociate a table from replication, you can write to the table as you do any other table. GetTable no longer returns managedByService and managedTableInformation for the table, and ListTables no longer returns managedByService for it. On the source table, GetTableReplicationStatus reports a failure for this destination the next time replication to it is attempted.
Disassociating a table from replication doesn't change its maintenance configuration. Review the maintenance settings of the table, such as compaction, after you disassociate it.
You must have the s3tables:DisassociateTableReplication permission to use this operation.
The Amazon Resource Name (ARN) of the replica table to disassociate from replication.
", "smithy.api#httpQuery": "tableArn", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#DisassociateTableReplicationResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#EncryptionConfiguration": { "type": "structure", "members": { "sseAlgorithm": { "target": "com.amazonaws.s3tables#SSEAlgorithm", "traits": { "smithy.api#documentation": "The server-side encryption algorithm to use. Valid values are AES256 for S3-managed encryption keys, or aws:kms for Amazon Web Services KMS-managed encryption keys. If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see Permissions requirements for S3 Tables SSE-KMS encryption.
The Amazon Resource Name (ARN) of the KMS key to use for encryption. This field is required only when sseAlgorithm is set to aws:kms.
Configuration specifying how data should be encrypted. This structure defines the encryption algorithm and optional KMS key to be used for server-side encryption.
" } }, "com.amazonaws.s3tables#ErrorMessage": { "type": "string" }, "com.amazonaws.s3tables#FindingCategory": { "type": "enum", "members": { "ACCESS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "access" } }, "METADATA": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "metadata" } }, "DATA": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "data" } }, "INTERNAL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "internal" } } }, "traits": { "smithy.api#documentation": "The category of a compatibility report finding, by what you change to fix it. Valid values:
access - A permission or a request setting. You don't need to change the source.
metadata - The Amazon Web Services Glue table definition, or properties of a source object, such as its size, storage class, encryption or Parquet types.
data - The contents of a source object, such as a partition value that can't be read, an object overwritten after an earlier migration, or a corrupt file.
internal - An internal error in S3 Tables. Retry the migration, and contact Amazon Web Services Support if the error persists.
The caller isn't authorized to make the request.
", "smithy.api#error": "client", "smithy.api#httpError": 403 } }, "com.amazonaws.s3tables#GetNamespace": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#GetNamespaceRequest" }, "output": { "target": "com.amazonaws.s3tables#GetNamespaceResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#AccessDeniedException" }, { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Gets details about a namespace. For more information, see Table namespaces in the Amazon Simple Storage Service User Guide.
You must have the s3tables:GetNamespace permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The name of the namespace.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetNamespaceResponse": { "type": "structure", "members": { "namespace": { "target": "com.amazonaws.s3tables#NamespaceList", "traits": { "smithy.api#documentation": "The name of the namespace.
", "smithy.api#required": {} } }, "createdAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The date and time the namespace was created at.
", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "createdBy": { "target": "com.amazonaws.s3tables#AccountId", "traits": { "smithy.api#documentation": "The ID of the account that created the namespace.
", "smithy.api#required": {} } }, "ownerAccountId": { "target": "com.amazonaws.s3tables#AccountId", "traits": { "smithy.api#documentation": "The ID of the account that owns the namespcace.
", "smithy.api#required": {} } }, "namespaceId": { "target": "com.amazonaws.s3tables#NamespaceId", "traits": { "smithy.api#documentation": "The unique identifier of the namespace.
" } }, "tableBucketId": { "target": "com.amazonaws.s3tables#TableBucketId", "traits": { "smithy.api#documentation": "The unique identifier of the table bucket containing this namespace.
" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GetTable": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#GetTableRequest" }, "output": { "target": "com.amazonaws.s3tables#GetTableResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#AccessDeniedException" }, { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Gets details about a table. For more information, see S3 Tables in the Amazon Simple Storage Service User Guide.
You must have the s3tables:GetTable permission to use this operation.
Gets details on a table bucket. For more information, see Viewing details about an Amazon S3 table bucket in the Amazon Simple Storage Service User Guide.
You must have the s3tables:GetTableBucket permission to use this operation.
Gets the encryption configuration for a table bucket.
You must have the s3tables:GetTableBucketEncryption permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableBucketEncryptionResponse": { "type": "structure", "members": { "encryptionConfiguration": { "target": "com.amazonaws.s3tables#EncryptionConfiguration", "traits": { "smithy.api#documentation": "The encryption configuration for the table bucket.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GetTableBucketLogging": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#GetTableBucketLoggingRequest" }, "output": { "target": "com.amazonaws.s3tables#GetTableBucketLoggingResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Gets the server access logging configuration for a table bucket. For more information, see Server access logging for table buckets in the Amazon Simple Storage Service User Guide.
You must have the s3tables:GetTableBucketLogging permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableBucketLoggingResponse": { "type": "structure", "members": { "tableBucketLoggingStatus": { "target": "com.amazonaws.s3tables#TableBucketLoggingStatus", "traits": { "smithy.api#documentation": "The logging status of the table bucket. If logging is disabled, loggingEnabled is absent.
Gets details about a maintenance configuration for a given table bucket. For more information, see Amazon S3 table bucket maintenance in the Amazon Simple Storage Service User Guide.
You must have the s3tables:GetTableBucketMaintenanceConfiguration permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket associated with the maintenance configuration.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableBucketMaintenanceConfigurationResponse": { "type": "structure", "members": { "tableBucketARN": { "target": "com.amazonaws.s3tables#TableBucketARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table bucket associated with the maintenance configuration.
", "smithy.api#required": {} } }, "configuration": { "target": "com.amazonaws.s3tables#TableBucketMaintenanceConfiguration", "traits": { "smithy.api#documentation": "Details about the maintenance configuration for the table bucket.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GetTableBucketMetricsConfiguration": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#GetTableBucketMetricsConfigurationRequest" }, "output": { "target": "com.amazonaws.s3tables#GetTableBucketMetricsConfigurationResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Gets the metrics configuration for a table bucket.
You must have the s3tables:GetTableBucketMetricsConfiguration permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableBucketMetricsConfigurationResponse": { "type": "structure", "members": { "tableBucketARN": { "target": "com.amazonaws.s3tables#TableBucketARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#required": {} } }, "id": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The unique identifier of the metrics configuration.
" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GetTableBucketPolicy": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#GetTableBucketPolicyRequest" }, "output": { "target": "com.amazonaws.s3tables#GetTableBucketPolicyResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Gets details about a table bucket policy. For more information, see Viewing a table bucket policy in the Amazon Simple Storage Service User Guide.
You must have the s3tables:GetTableBucketPolicy permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableBucketPolicyResponse": { "type": "structure", "members": { "resourcePolicy": { "target": "com.amazonaws.s3tables#ResourcePolicy", "traits": { "smithy.api#documentation": "The JSON that defines the policy.
Retrieves the replication configuration for a table bucket.This operation returns the IAM role, versionToken, and replication rules that define how tables in this bucket are replicated to other buckets.
You must have the s3tables:GetTableBucketReplication permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpQuery": "tableBucketARN", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableBucketReplicationResponse": { "type": "structure", "members": { "versionToken": { "target": "com.amazonaws.s3tables#VersionToken", "traits": { "smithy.api#documentation": "A version token that represents the current state of the replication configuration. Use this token when updating the configuration to ensure consistency.
", "smithy.api#required": {} } }, "configuration": { "target": "com.amazonaws.s3tables#TableBucketReplicationConfiguration", "traits": { "smithy.api#documentation": "The replication configuration for the table bucket, including the IAM role and replication rules.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GetTableBucketRequest": { "type": "structure", "members": { "tableBucketARN": { "target": "com.amazonaws.s3tables#TableBucketARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableBucketResponse": { "type": "structure", "members": { "arn": { "target": "com.amazonaws.s3tables#TableBucketARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.s3tables#TableBucketName", "traits": { "smithy.api#documentation": "The name of the table bucket
", "smithy.api#required": {} } }, "ownerAccountId": { "target": "com.amazonaws.s3tables#AccountId", "traits": { "smithy.api#documentation": "The ID of the account that owns the table bucket.
", "smithy.api#required": {} } }, "createdAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The date and time the table bucket was created.
", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "tableBucketId": { "target": "com.amazonaws.s3tables#TableBucketId", "traits": { "smithy.api#documentation": "The unique identifier of the table bucket.
" } }, "type": { "target": "com.amazonaws.s3tables#TableBucketType", "traits": { "smithy.api#documentation": "The type of the table bucket.
" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GetTableBucketStorageClass": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#GetTableBucketStorageClassRequest" }, "output": { "target": "com.amazonaws.s3tables#GetTableBucketStorageClassResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#AccessDeniedException" }, { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Retrieves the storage class configuration for a specific table. This allows you to view the storage class settings that apply to an individual table, which may differ from the table bucket's default configuration.
You must have the s3tables:GetTableBucketStorageClass permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableBucketStorageClassResponse": { "type": "structure", "members": { "storageClassConfiguration": { "target": "com.amazonaws.s3tables#StorageClassConfiguration", "traits": { "smithy.api#documentation": "The storage class configuration for the table bucket.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GetTableEncryption": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#GetTableEncryptionRequest" }, "output": { "target": "com.amazonaws.s3tables#GetTableEncryptionResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#AccessDeniedException" }, { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Gets the encryption configuration for a table.
You must have the s3tables:GetTableEncryption permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket containing the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The namespace associated with the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name of the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableEncryptionResponse": { "type": "structure", "members": { "encryptionConfiguration": { "target": "com.amazonaws.s3tables#EncryptionConfiguration", "traits": { "smithy.api#documentation": "The encryption configuration for the table.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GetTableMaintenanceConfiguration": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#GetTableMaintenanceConfigurationRequest" }, "output": { "target": "com.amazonaws.s3tables#GetTableMaintenanceConfigurationResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Gets details about the maintenance configuration of a table. For more information, see S3 Tables maintenance in the Amazon Simple Storage Service User Guide.
You must have the s3tables:GetTableMaintenanceConfiguration permission to use this operation.
You must have the s3tables:GetTableData permission to use set the compaction strategy to sort or zorder.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The namespace associated with the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name of the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableMaintenanceConfigurationResponse": { "type": "structure", "members": { "tableARN": { "target": "com.amazonaws.s3tables#TableARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table.
", "smithy.api#required": {} } }, "configuration": { "target": "com.amazonaws.s3tables#TableMaintenanceConfiguration", "traits": { "smithy.api#documentation": "Details about the maintenance configuration for the table bucket.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GetTableMaintenanceJobStatus": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#GetTableMaintenanceJobStatusRequest" }, "output": { "target": "com.amazonaws.s3tables#GetTableMaintenanceJobStatusResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Gets the status of a maintenance job for a table. For more information, see S3 Tables maintenance in the Amazon Simple Storage Service User Guide.
You must have the s3tables:GetTableMaintenanceJobStatus permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The name of the namespace the table is associated with.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name of the table containing the maintenance job status you want to check.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableMaintenanceJobStatusResponse": { "type": "structure", "members": { "tableARN": { "target": "com.amazonaws.s3tables#TableARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table.
", "smithy.api#required": {} } }, "status": { "target": "com.amazonaws.s3tables#TableMaintenanceJobStatus", "traits": { "smithy.api#documentation": "The status of the maintenance job.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GetTableMetadataLocation": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#GetTableMetadataLocationRequest" }, "output": { "target": "com.amazonaws.s3tables#GetTableMetadataLocationResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Gets the location of the table metadata.
You must have the s3tables:GetTableMetadataLocation permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The namespace of the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name of the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableMetadataLocationResponse": { "type": "structure", "members": { "versionToken": { "target": "com.amazonaws.s3tables#VersionToken", "traits": { "smithy.api#documentation": "The version token.
", "smithy.api#required": {} } }, "metadataLocation": { "target": "com.amazonaws.s3tables#MetadataLocation", "traits": { "smithy.api#documentation": "The metadata location.
" } }, "warehouseLocation": { "target": "com.amazonaws.s3tables#WarehouseLocation", "traits": { "smithy.api#documentation": "The warehouse location.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GetTableMigration": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#GetTableMigrationRequest" }, "output": { "target": "com.amazonaws.s3tables#GetTableMigrationResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#AccessDeniedException" }, { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Gets the details of a migration, including its state, the reason it failed, its statistics and the location of its reports. Identify the migration by its migrationId, or specify the tableARN of a destination table to get that table's most recent migration.
You must have the s3tables:GetTableMigration permission to use this operation.
The ID of the migration to get. Specify either migrationId or tableARN, not both.
The Amazon Resource Name (ARN) of the destination table. Gets the table's most recent migration. Specify either tableARN or migrationId, not both.
The ID of the migration.
", "smithy.api#required": {} } }, "tableBucketARN": { "target": "com.amazonaws.s3tables#TableBucketARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table bucket that contains the destination table.
", "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The namespace of the destination table.
", "smithy.api#required": {} } }, "tableARN": { "target": "com.amazonaws.s3tables#TableARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the destination table, once the migration creates it.
" } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name of the destination table.
", "smithy.api#required": {} } }, "type": { "target": "com.amazonaws.s3tables#MigrationType", "traits": { "smithy.api#documentation": "The type of the migration. Valid values:
start - A migration that StartTableMigration started.
sync - A migration that SyncTableMigration started.
The state of the migration. Valid values:
new - S3 Tables accepted the request.
planning - The migration is checking the source table, its objects and the destination for compatibility, and writing the compatibility reports.
pendingReview - Planning finished, and the migration waits for you to continue or cancel it with UpdateTableMigration.
queued - The migration is waiting to start migrating data.
migrating - The migration is running the plan from the planning state: it copies data and commits it to the destination table. A migration reaches this state only if hasValidPlan is true.
succeeded - Every planned object migrated.
failed - The migration failed. Check failureReason for the cause.
cancelling - You cancelled the migration, and it is finishing the work in progress.
cancelled - The migration is cancelled.
A migration ends in the succeeded, failed or cancelled state. You can cancel it until it ends.
The Amazon Resource Name (ARN) of the IAM role that the migration uses.
", "smithy.api#required": {} } }, "reviewMigrationPlan": { "target": "smithy.api#Boolean", "traits": { "smithy.api#documentation": "A Boolean value that specifies whether the migration waits in the pendingReview state, so that you can review the compatibility reports before it migrates any data.
A Boolean value that specifies whether planning produced a plan that the migration can run. If planning hasn't finished, this value isn't returned.
" } }, "createdAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The date and time that the migration was created.
", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "stateUpdatedAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The date and time that the migration's state last changed.
", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "failureReason": { "target": "com.amazonaws.s3tables#MigrationFailureReason", "traits": { "smithy.api#documentation": "The reason that the migration failed. The code names the cause, such as a migration role that S3 Tables can't assume or an Amazon Web Services Glue table that doesn't exist, or the report that lists the findings. This value is returned only when the migration is in the failed state.
Statistics about the source and the partitions in the migration. This value is returned after planning finishes.
" } }, "migrationStats": { "target": "com.amazonaws.s3tables#MigrationStats", "traits": { "smithy.api#documentation": "The number of objects that migrated, failed or are pending. These counts are set when planning finishes and updated when the migration ends.
" } }, "sourceType": { "target": "com.amazonaws.s3tables#MigrationSourceType", "traits": { "smithy.api#documentation": "The type of the migration's source.
", "smithy.api#required": {} } }, "source": { "target": "com.amazonaws.s3tables#SourceConfiguration", "traits": { "smithy.api#documentation": "The source table of the migration.
", "smithy.api#required": {} } }, "dataMigration": { "target": "com.amazonaws.s3tables#DataMigrationOverview", "traits": { "smithy.api#documentation": "The maintenance settings and migration policies for the destination table.
", "smithy.api#required": {} } }, "migrationOutput": { "target": "com.amazonaws.s3tables#MigrationOutputOverview", "traits": { "smithy.api#documentation": "The bucket and prefixes for the migration's reports, and the location of each report once it is written.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GetTablePolicy": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#GetTablePolicyRequest" }, "output": { "target": "com.amazonaws.s3tables#GetTablePolicyResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Gets details about a table policy. For more information, see Viewing a table policy in the Amazon Simple Storage Service User Guide.
You must have the s3tables:GetTablePolicy permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket that contains the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The namespace associated with the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name of the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTablePolicyResponse": { "type": "structure", "members": { "resourcePolicy": { "target": "com.amazonaws.s3tables#ResourcePolicy", "traits": { "smithy.api#documentation": "The JSON that defines the policy.
Retrieves the expiration configuration settings for records in a table, and the status of the configuration. If the status of the configuration is enabled, records expire and are automatically removed from the table after the specified number of days.
You must have the s3tables:GetTableRecordExpirationConfiguration permission to use this operation.
The Amazon Resource Name (ARN) of the table.
", "smithy.api#httpQuery": "tableArn", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableRecordExpirationConfigurationResponse": { "type": "structure", "members": { "configuration": { "target": "com.amazonaws.s3tables#TableRecordExpirationConfigurationValue", "traits": { "smithy.api#documentation": "The record expiration configuration for the table, including the status and retention settings.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GetTableRecordExpirationJobStatus": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#GetTableRecordExpirationJobStatusRequest" }, "output": { "target": "com.amazonaws.s3tables#GetTableRecordExpirationJobStatusResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#MethodNotAllowedException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Retrieves the status, metrics, and details of the latest record expiration job for a table. This includes when the job ran, and whether it succeeded or failed. If the job ran successfully, this also includes statistics about the records that were removed.
You must have the s3tables:GetTableRecordExpirationJobStatus permission to use this operation.
The Amazon Resource Name (ARN) of the table.
", "smithy.api#httpQuery": "tableArn", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableRecordExpirationJobStatusResponse": { "type": "structure", "members": { "status": { "target": "com.amazonaws.s3tables#TableRecordExpirationJobStatus", "traits": { "smithy.api#documentation": "The current status of the most recent expiration job.
", "smithy.api#required": {} } }, "lastRunTimestamp": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The timestamp when the expiration job was last executed.
", "smithy.api#timestampFormat": "date-time" } }, "failureMessage": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "If the job failed, this field contains an error message describing the failure reason.
" } }, "metrics": { "target": "com.amazonaws.s3tables#TableRecordExpirationJobMetrics", "traits": { "smithy.api#documentation": "Metrics about the most recent expiration job execution, including the number of records and files deleted.
" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GetTableReplication": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#GetTableReplicationRequest" }, "output": { "target": "com.amazonaws.s3tables#GetTableReplicationResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#AccessDeniedException" }, { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Retrieves the replication configuration for a specific table.
You must have the s3tables:GetTableReplication permission to use this operation.
The Amazon Resource Name (ARN) of the table.
", "smithy.api#httpQuery": "tableArn", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableReplicationResponse": { "type": "structure", "members": { "versionToken": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "A version token that represents the current state of the table's replication configuration. Use this token when updating the configuration to ensure consistency.
", "smithy.api#required": {} } }, "configuration": { "target": "com.amazonaws.s3tables#TableReplicationConfiguration", "traits": { "smithy.api#documentation": "The replication configuration for the table, including the IAM role and replication rules.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GetTableReplicationStatus": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#GetTableReplicationStatusRequest" }, "output": { "target": "com.amazonaws.s3tables#GetTableReplicationStatusResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Retrieves the replication status for a table, including the status of replication to each destination. This operation provides visibility into replication health and progress.
You must have the s3tables:GetTableReplicationStatus permission to use this operation.
The Amazon Resource Name (ARN) of the table.
", "smithy.api#httpQuery": "tableArn", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableReplicationStatusResponse": { "type": "structure", "members": { "sourceTableArn": { "target": "com.amazonaws.s3tables#TableARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the source table being replicated.
", "smithy.api#required": {} } }, "destinations": { "target": "com.amazonaws.s3tables#ReplicationDestinationStatuses", "traits": { "smithy.api#documentation": "An array of status information for each replication destination, including the current state, last successful update, and any error messages.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GetTableRequest": { "type": "structure", "members": { "tableBucketARN": { "target": "com.amazonaws.s3tables#TableBucketARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table bucket associated with the table.
", "smithy.api#httpQuery": "tableBucketARN" } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The name of the namespace the table is associated with.
", "smithy.api#httpQuery": "namespace" } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name of the table.
", "smithy.api#httpQuery": "name" } }, "tableArn": { "target": "com.amazonaws.s3tables#TableARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table.
", "smithy.api#httpQuery": "tableArn" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableResponse": { "type": "structure", "members": { "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name of the table.
", "smithy.api#required": {} } }, "type": { "target": "com.amazonaws.s3tables#TableType", "traits": { "smithy.api#documentation": "The type of the table.
", "smithy.api#required": {} } }, "tableARN": { "target": "com.amazonaws.s3tables#TableARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table.
", "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceList", "traits": { "smithy.api#documentation": "The namespace associated with the table.
", "smithy.api#required": {} } }, "namespaceId": { "target": "com.amazonaws.s3tables#NamespaceId", "traits": { "smithy.api#default": null, "smithy.api#documentation": "The unique identifier of the namespace containing this table.
" } }, "versionToken": { "target": "com.amazonaws.s3tables#VersionToken", "traits": { "smithy.api#documentation": "The version token of the table.
", "smithy.api#required": {} } }, "metadataLocation": { "target": "com.amazonaws.s3tables#MetadataLocation", "traits": { "smithy.api#documentation": "The metadata location of the table.
" } }, "warehouseLocation": { "target": "com.amazonaws.s3tables#WarehouseLocation", "traits": { "smithy.api#documentation": "The warehouse location of the table.
", "smithy.api#required": {} } }, "createdAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The date and time the table bucket was created at.
", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "createdBy": { "target": "com.amazonaws.s3tables#AccountId", "traits": { "smithy.api#documentation": "The ID of the account that created the table.
", "smithy.api#required": {} } }, "managedByService": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The service that manages the table.
" } }, "modifiedAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The date and time the table was last modified on.
", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "modifiedBy": { "target": "com.amazonaws.s3tables#AccountId", "traits": { "smithy.api#documentation": "The ID of the account that last modified the table.
", "smithy.api#required": {} } }, "ownerAccountId": { "target": "com.amazonaws.s3tables#AccountId", "traits": { "smithy.api#documentation": "The ID of the account that owns the table.
", "smithy.api#required": {} } }, "format": { "target": "com.amazonaws.s3tables#OpenTableFormat", "traits": { "smithy.api#documentation": "The format of the table.
", "smithy.api#required": {} } }, "tableBucketId": { "target": "com.amazonaws.s3tables#TableBucketId", "traits": { "smithy.api#documentation": "The unique identifier of the table bucket containing this table.
" } }, "managedTableInformation": { "target": "com.amazonaws.s3tables#ManagedTableInformation", "traits": { "smithy.api#documentation": "If this table is managed by S3 Tables, contains additional information such as replication details.
" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GetTableStorageClass": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#GetTableStorageClassRequest" }, "output": { "target": "com.amazonaws.s3tables#GetTableStorageClassResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#AccessDeniedException" }, { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Retrieves the storage class configuration for a specific table. This allows you to view the storage class settings that apply to an individual table, which may differ from the table bucket's default configuration.
You must have the s3tables:GetTableStorageClass permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket that contains the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The namespace associated with the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name of the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#GetTableStorageClassResponse": { "type": "structure", "members": { "storageClassConfiguration": { "target": "com.amazonaws.s3tables#StorageClassConfiguration", "traits": { "smithy.api#documentation": "The storage class configuration for the table.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#GlueTableSource": { "type": "structure", "members": { "catalogId": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The ID of the Data Catalog that contains the table. It must be your account ID.
", "smithy.api#length": { "min": 1, "max": 255 }, "smithy.api#required": {} } }, "databaseName": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The name of the database that contains the table.
", "smithy.api#length": { "min": 1, "max": 255 }, "smithy.api#required": {} } }, "tableName": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The name of the table.
", "smithy.api#length": { "min": 1, "max": 255 }, "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "An Amazon Web Services Glue Data Catalog table to migrate. The table must be an external Apache Hive table whose data is stored as Parquet in a general purpose bucket in the same account and Region as the table bucket. Views, transactional (ACID) tables, tables in an open table format such as Apache Iceberg, and tables registered with Amazon Web Services Lake Formation can't be migrated. If the table can't be migrated, the migration fails, and the table compatibility report lists the reason.
" } }, "com.amazonaws.s3tables#IAMRole": { "type": "string", "traits": { "smithy.api#length": { "min": 20, "max": 2048 }, "smithy.api#pattern": "^arn:.+:iam::[0-9]{12}:role/.+$" } }, "com.amazonaws.s3tables#IcebergCompactionSettings": { "type": "structure", "members": { "targetFileSizeMB": { "target": "com.amazonaws.s3tables#PositiveInteger", "traits": { "smithy.api#documentation": "The target file size for the table in MB.
" } }, "strategy": { "target": "com.amazonaws.s3tables#IcebergCompactionStrategy", "traits": { "smithy.api#documentation": "The compaction strategy to use for the table. This determines how files are selected and combined during compaction operations.
" } } }, "traits": { "smithy.api#documentation": "Contains details about the compaction settings for an Iceberg table.
" } }, "com.amazonaws.s3tables#IcebergCompactionStrategy": { "type": "enum", "members": { "AUTO": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "auto" } }, "BINPACK": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "binpack" } }, "SORT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "sort" } }, "ZORDER": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "z-order" } } } }, "com.amazonaws.s3tables#IcebergMetadata": { "type": "structure", "members": { "schema": { "target": "com.amazonaws.s3tables#IcebergSchema", "traits": { "smithy.api#documentation": "The schema for an Iceberg table. Use this property to define table schemas with primitive types only. For schemas that include nested or complex types such as struct, list, or map, use schemaV2 instead.
The schema for an Iceberg table using the V2 format. Use this property to define table schemas that include nested or complex data types such as struct, list, or map, in addition to primitive types. For schemas with only primitive types, you can use either schema or schemaV2.
The partition specification for the Iceberg table. Partitioning organizes data into separate files based on the values of one or more fields, which can improve query performance by reducing the amount of data scanned. Each partition field applies a transform (such as identity, year, month, or bucket) to a single field.
" } }, "writeOrder": { "target": "com.amazonaws.s3tables#IcebergSortOrder", "traits": { "smithy.api#documentation": "The sort order for the Iceberg table. Sort order defines how data is sorted within data files, which can improve query performance by enabling more efficient data skipping and filtering.
" } }, "properties": { "target": "com.amazonaws.s3tables#TableProperties", "traits": { "smithy.api#documentation": "A map of custom configuration properties for the Iceberg table.
" } } }, "traits": { "smithy.api#documentation": "Contains details about the metadata for an Iceberg table.
" } }, "com.amazonaws.s3tables#IcebergNullOrder": { "type": "enum", "members": { "NULLS_FIRST": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "nulls-first" } }, "NULLS_LAST": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "nulls-last" } } } }, "com.amazonaws.s3tables#IcebergPartitionField": { "type": "structure", "members": { "sourceId": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "The ID of the source schema field to partition by. This must reference a valid field ID from the table schema.
", "smithy.api#jsonName": "source-id", "smithy.api#required": {} } }, "transform": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The partition transform to apply to the source field. Supported transforms include identity, year, month, day, hour, bucket, and truncate. For more information, see the Apache Iceberg partition transforms documentation.
The name for this partition field. This name is used in the partitioned file paths.
", "smithy.api#required": {} } }, "fieldId": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "An optional unique identifier for this partition field. If not specified, S3 Tables automatically assigns a field ID.
", "smithy.api#jsonName": "field-id" } } }, "traits": { "smithy.api#documentation": "Defines a single partition field in an Iceberg partition specification.
" } }, "com.amazonaws.s3tables#IcebergPartitionFieldList": { "type": "list", "member": { "target": "com.amazonaws.s3tables#IcebergPartitionField" } }, "com.amazonaws.s3tables#IcebergPartitionSpec": { "type": "structure", "members": { "fields": { "target": "com.amazonaws.s3tables#IcebergPartitionFieldList", "traits": { "smithy.api#documentation": "The list of partition fields that define how the table data is partitioned. Each field specifies a source field and a transform to apply. This field is required if partitionSpec is provided.
The unique identifier for this partition specification. If not specified, defaults to 0.
Defines how data in an Iceberg table is partitioned. Partitioning helps optimize query performance by organizing data into separate files based on field values. Each partition field specifies a transform to apply to a source field.
" } }, "com.amazonaws.s3tables#IcebergSchema": { "type": "structure", "members": { "fields": { "target": "com.amazonaws.s3tables#SchemaFieldList", "traits": { "smithy.api#documentation": "The schema fields for the table
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Contains details about the schema for an Iceberg table.
" } }, "com.amazonaws.s3tables#IcebergSchemaV2": { "type": "structure", "members": { "type": { "target": "com.amazonaws.s3tables#SchemaV2FieldType", "traits": { "smithy.api#documentation": "The type of the top-level schema, which is always a struct type as defined in the Apache Iceberg specification. This value must be struct.
The schema fields for the table. Each field defines a column in the table, including its name, type, and whether it is required.
", "smithy.api#required": {} } }, "schemaId": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "An optional unique identifier for the schema. Schema IDs are used by Apache Iceberg to track schema evolution.
", "smithy.api#jsonName": "schema-id" } }, "identifierFieldIds": { "target": "com.amazonaws.s3tables#IntegerList", "traits": { "smithy.api#documentation": "A list of field IDs that are used as the identifier fields for the table. Identifier fields uniquely identify a row in the table.
", "smithy.api#jsonName": "identifier-field-ids" } } }, "traits": { "smithy.api#documentation": "Contains details about the schema for an Iceberg table using the V2 format. This schema format supports nested and complex data types such as struct, list, and map, in addition to primitive types.
The minimum number of snapshots to keep.
" } }, "maxSnapshotAgeHours": { "target": "com.amazonaws.s3tables#PositiveInteger", "traits": { "smithy.api#documentation": "The maximum age of a snapshot before it can be expired.
" } } }, "traits": { "smithy.api#documentation": "Contains details about the snapshot management settings for an Iceberg table. The oldest snapshot expires when its age exceeds the maxSnapshotAgeHours and the total number of snapshots exceeds the value for the minimum number of snapshots to keep minSnapshotsToKeep.
The ID of the source schema field to sort by. This must reference a valid field ID from the table schema.
", "smithy.api#jsonName": "source-id", "smithy.api#required": {} } }, "transform": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The transform to apply to the source field before sorting. Use identity to sort by the field value directly, or specify other transforms as needed.
The sort direction. Valid values are asc for ascending order or desc for descending order.
Specifies how null values are ordered. Valid values are nulls-first to place nulls before non-null values, or nulls-last to place nulls after non-null values.
Defines a single sort field in an Iceberg sort order specification.
" } }, "com.amazonaws.s3tables#IcebergSortFieldList": { "type": "list", "member": { "target": "com.amazonaws.s3tables#IcebergSortField" } }, "com.amazonaws.s3tables#IcebergSortOrder": { "type": "structure", "members": { "orderId": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "The unique identifier for this sort order. If not specified, defaults to 1. The order ID is used by Apache Iceberg to track sort order evolution.
The list of sort fields that define how data is sorted within files. Each field specifies a source field, sort direction, and null ordering. This field is required if writeOrder is provided.
Defines the sort order for data within an Iceberg table. Sorting data can improve query performance by enabling more efficient data skipping.
" } }, "com.amazonaws.s3tables#IcebergUnreferencedFileRemovalSettings": { "type": "structure", "members": { "unreferencedDays": { "target": "com.amazonaws.s3tables#PositiveInteger", "traits": { "smithy.api#documentation": "The number of days an object has to be unreferenced before it is marked as non-current.
" } }, "nonCurrentDays": { "target": "com.amazonaws.s3tables#PositiveInteger", "traits": { "smithy.api#documentation": "The number of days an object has to be non-current before it is deleted.
" } } }, "traits": { "smithy.api#documentation": "Contains details about the unreferenced file removal settings for an Iceberg table bucket.
" } }, "com.amazonaws.s3tables#IncompatibleValuesPolicy": { "type": "enum", "members": { "FAIL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "fail" } }, "SET_NULL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "setNull" } } } }, "com.amazonaws.s3tables#IntegerList": { "type": "list", "member": { "target": "smithy.api#Integer" } }, "com.amazonaws.s3tables#InternalServerErrorException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.s3tables#ErrorMessage" } }, "traits": { "smithy.api#documentation": "The request failed due to an internal server error.
", "smithy.api#error": "server", "smithy.api#httpError": 500 } }, "com.amazonaws.s3tables#JobStatus": { "type": "enum", "members": { "NOT_YET_RUN": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "Not_Yet_Run" } }, "SUCCESSFUL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "Successful" } }, "FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "Failed" } }, "DISABLED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "Disabled" } } } }, "com.amazonaws.s3tables#LastSuccessfulReplicatedUpdate": { "type": "structure", "members": { "metadataLocation": { "target": "com.amazonaws.s3tables#MetadataLocation", "traits": { "smithy.api#documentation": "The S3 location of the metadata that was successfully replicated.
", "smithy.api#required": {} } }, "timestamp": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The timestamp when the replication update completed successfully.
", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } } }, "traits": { "smithy.api#documentation": "Contains information about the most recent successful replication update to a destination.
" } }, "com.amazonaws.s3tables#ListNamespaces": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#ListNamespacesRequest" }, "output": { "target": "com.amazonaws.s3tables#ListNamespacesResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#AccessDeniedException" }, { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Lists the namespaces within a table bucket. For more information, see Table namespaces in the Amazon Simple Storage Service User Guide.
You must have the s3tables:ListNamespaces permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "prefix": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The prefix of the namespaces.
", "smithy.api#httpQuery": "prefix", "smithy.api#length": { "min": 1, "max": 255 } } }, "continuationToken": { "target": "com.amazonaws.s3tables#NextToken", "traits": { "smithy.api#documentation": " ContinuationToken indicates to Amazon S3 that the list is being continued on this bucket with a token. ContinuationToken is obfuscated and is not a real key. You can use this ContinuationToken for pagination of the list results.
The maximum number of namespaces to return in the list.
", "smithy.api#httpQuery": "maxNamespaces" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#ListNamespacesResponse": { "type": "structure", "members": { "namespaces": { "target": "com.amazonaws.s3tables#NamespaceSummaryList", "traits": { "smithy.api#documentation": "A list of namespaces.
", "smithy.api#required": {} } }, "continuationToken": { "target": "com.amazonaws.s3tables#NextToken", "traits": { "smithy.api#documentation": "The ContinuationToken for pagination of the list results.
Lists table buckets for your account. For more information, see S3 Table buckets in the Amazon Simple Storage Service User Guide.
You must have the s3tables:ListTableBuckets permission to use this operation.
The prefix of the table buckets.
", "smithy.api#httpQuery": "prefix", "smithy.api#length": { "min": 1, "max": 63 } } }, "continuationToken": { "target": "com.amazonaws.s3tables#NextToken", "traits": { "smithy.api#documentation": " ContinuationToken indicates to Amazon S3 that the list is being continued on this bucket with a token. ContinuationToken is obfuscated and is not a real key. You can use this ContinuationToken for pagination of the list results.
The maximum number of table buckets to return in the list.
", "smithy.api#httpQuery": "maxBuckets" } }, "type": { "target": "com.amazonaws.s3tables#TableBucketType", "traits": { "smithy.api#documentation": "The type of table buckets to filter by in the list.
", "smithy.api#httpQuery": "type" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#ListTableBucketsResponse": { "type": "structure", "members": { "tableBuckets": { "target": "com.amazonaws.s3tables#TableBucketSummaryList", "traits": { "smithy.api#documentation": "A list of table buckets.
", "smithy.api#required": {} } }, "continuationToken": { "target": "com.amazonaws.s3tables#NextToken", "traits": { "smithy.api#documentation": "You can use this ContinuationToken for pagination of the list results.
Lists the migrations whose destination is in a table bucket, a namespace or a table. Specify a tableBucketARN to list the migrations into a table bucket, and add a namespace, or a namespace and a name, to narrow the list. Or specify a tableARN to list the migrations into a table.
Migrations are listed newest first. Results are paginated: use maxResults to set the page size, and pass the nextToken from a response to retrieve the next page of results. A page can contain fewer migrations than maxResults, or none, and still return a nextToken. Continue until a response has no nextToken.
You must have the s3tables:ListTableMigrations permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket to list migrations for.
", "smithy.api#httpQuery": "tableBucketARN" } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The namespace to list migrations for. Requires tableBucketARN.
The name of the table to list migrations for. Requires tableBucketARN and namespace.
The Amazon Resource Name (ARN) of the table to list migrations for. The list includes the migrations into this table. To also list migrations into an earlier table of the same name, specify tableBucketARN, namespace and name instead. Specify either tableARN or tableBucketARN, not both.
The state to filter the list by. For the valid values, see the state member of GetTableMigration.
The hasValidPlan value to filter the list by. Migrations that are still planning aren't listed, whichever value you specify.
The maximum number of migrations to return, from 1 to 1,000. If you don't specify a value, the default is 100.
", "smithy.api#httpQuery": "maxResults" } }, "nextToken": { "target": "com.amazonaws.s3tables#NextToken", "traits": { "smithy.api#documentation": "The nextToken from a previous response, to get the next page of results.
The migrations, newest first.
", "smithy.api#required": {} } }, "nextToken": { "target": "com.amazonaws.s3tables#NextToken", "traits": { "smithy.api#documentation": "A token to pass as nextToken to get the next page of results. If there are no more results, this value isn't returned.
List tables in the given table bucket. For more information, see S3 Tables in the Amazon Simple Storage Service User Guide.
You must have the s3tables:ListTables permission to use this operation.
The Amazon resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The namespace of the tables.
", "smithy.api#httpQuery": "namespace" } }, "prefix": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The prefix of the tables.
", "smithy.api#httpQuery": "prefix", "smithy.api#length": { "min": 1, "max": 255 } } }, "continuationToken": { "target": "com.amazonaws.s3tables#NextToken", "traits": { "smithy.api#documentation": " ContinuationToken indicates to Amazon S3 that the list is being continued on this bucket with a token. ContinuationToken is obfuscated and is not a real key. You can use this ContinuationToken for pagination of the list results.
The maximum number of tables to return.
", "smithy.api#httpQuery": "maxTables" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#ListTablesResponse": { "type": "structure", "members": { "tables": { "target": "com.amazonaws.s3tables#TableSummaryList", "traits": { "smithy.api#documentation": "A list of tables.
", "smithy.api#required": {} } }, "continuationToken": { "target": "com.amazonaws.s3tables#NextToken", "traits": { "smithy.api#documentation": "You can use this ContinuationToken for pagination of the list results.
Lists all of the tags applied to a specified Amazon S3 Tables resource. Each tag is a label consisting of a key and value pair. Tags can help you organize, track costs for, and control access to resources.
For a list of S3 resources that support tagging, see Managing tags for Amazon S3 resources.
For tables and table buckets, you must have the s3tables:ListTagsForResource permission to use this operation.
The Amazon Resource Name (ARN) of the Amazon S3 Tables resource that you want to list tags for. The tagged resource can be a table bucket or a table. For a list of all S3 resources that support tagging, see Managing tags for Amazon S3 resources.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#ListTagsForResourceResponse": { "type": "structure", "members": { "tags": { "target": "com.amazonaws.s3tables#Tags", "traits": { "smithy.api#documentation": "The user-defined tags that are applied to the resource. For more information, see Tagging for cost allocation or attribute-based access control (ABAC).
" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#LoggingEnabled": { "type": "structure", "members": { "targetBucket": { "target": "com.amazonaws.s3tables#LoggingTargetBucket", "traits": { "smithy.api#documentation": "The name of the general purpose bucket that logs are delivered to. The bucket must be in the same Amazon Web Services Region and owned by the same Amazon Web Services account as the table bucket. The bucket can't use SSE-KMS or DSSE-KMS default encryption, can't have S3 Object Lock enabled, and can't have Requester Pays enabled. You can deliver logs from multiple table buckets to the same target bucket. In this case, choose a different targetPrefix for each table bucket so that you can tell their log objects apart.
The prefix for the keys of the log objects that are delivered to the target bucket.
", "smithy.api#required": {} } }, "targetObjectKeyFormat": { "target": "com.amazonaws.s3tables#TargetObjectKeyFormat", "traits": { "smithy.api#documentation": "The key format of the log objects. Log object keys are always partitioned by date.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Describes where logs are stored and the prefix that Amazon S3 assigns to all log object keys for a table bucket.
" } }, "com.amazonaws.s3tables#LoggingTargetBucket": { "type": "string", "traits": { "smithy.api#length": { "min": 3, "max": 63 } } }, "com.amazonaws.s3tables#LoggingTargetPrefix": { "type": "string", "traits": { "smithy.api#length": { "max": 1024 } } }, "com.amazonaws.s3tables#MaintenanceSettings": { "type": "structure", "members": { "icebergCompaction": { "target": "com.amazonaws.s3tables#MigrationCompactionSettings", "traits": { "smithy.api#documentation": "The compaction settings.
" } }, "icebergSnapshotManagement": { "target": "com.amazonaws.s3tables#MigrationSnapshotManagementSettings", "traits": { "smithy.api#documentation": "The snapshot management settings.
" } } }, "traits": { "smithy.api#documentation": "The maintenance settings for the destination table. The migration applies them when it creates the table: snapshot management starts then, and compaction starts after you complete the migration. If you don't specify a setting, the migration uses its default: a target file size of 512 MB, the binpack compaction strategy, at least 3 snapshots, and a maximum snapshot age of 120 hours. Unreferenced file removal follows the table bucket's configuration after you complete the migration.
" } }, "com.amazonaws.s3tables#MaintenanceStatus": { "type": "enum", "members": { "ENABLED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "enabled" } }, "DISABLED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "disabled" } } } }, "com.amazonaws.s3tables#ManagedTableInformation": { "type": "structure", "members": { "replicationInformation": { "target": "com.amazonaws.s3tables#ReplicationInformation", "traits": { "smithy.api#documentation": "If this table is a replica, contains information about the source table from which it is replicated.
" } } }, "traits": { "smithy.api#documentation": "Contains information about tables that are managed by S3 Tables, including replication information for replica tables.
" } }, "com.amazonaws.s3tables#MetadataLocation": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 2048 } } }, "com.amazonaws.s3tables#MethodNotAllowedException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.s3tables#ErrorMessage" } }, "traits": { "smithy.api#documentation": "The requested operation is not allowed on this resource. This may occur when attempting to modify a resource that is managed by a service or has restrictions that prevent the operation.
", "smithy.api#error": "client", "smithy.api#httpError": 405 } }, "com.amazonaws.s3tables#MigrationCompactionSettings": { "type": "structure", "members": { "targetFileSizeMB": { "target": "com.amazonaws.s3tables#MigrationTargetFileSizeMB", "traits": { "smithy.api#default": 512, "smithy.api#documentation": "The target size, from 64 to 512 MB, of the data files that the migration writes, and of the files that compaction writes after you complete the migration. The default is 512.
" } }, "strategy": { "target": "com.amazonaws.s3tables#IcebergCompactionStrategy", "traits": { "smithy.api#default": "binpack", "smithy.api#documentation": "The compaction strategy. The only valid value is binpack, which is the default.
The compaction settings that a migration applies to the destination table.
" } }, "com.amazonaws.s3tables#MigrationFailureCode": { "type": "enum", "members": { "ROLE_PERMISSIONS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "rolePermissions" } }, "SOURCE_PERMISSIONS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "sourcePermissions" } }, "DESTINATION_PERMISSIONS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "destinationPermissions" } }, "RESOURCE_NOT_FOUND": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "resourceNotFound" } }, "SOURCE_NOT_SUPPORTED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "sourceNotSupported" } }, "OBJECT_MIGRATION_REPORT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "objectMigrationReport" } }, "OBJECT_COMPATIBILITY_REPORT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "objectCompatibilityReport" } }, "TABLE_COMPATIBILITY_REPORT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "tableCompatibilityReport" } }, "INTERNAL_ERROR": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "internalError" } }, "REPORT_BUCKET_NOT_SUPPORTED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "reportBucketNotSupported" } } }, "traits": { "smithy.api#documentation": "The reason a migration failed. Each code names the cause, or the report that lists the findings.
" } }, "com.amazonaws.s3tables#MigrationFailureDetail": { "type": "string", "traits": { "smithy.api#documentation": "The resource that the failure applies to, such as the role ARN, the Amazon Web Services Glue table (database.table) or a bucket. For sourceNotSupported, the reason that the source isn't supported.
The failure code. It names the cause or the report that lists the findings. Valid values:
rolePermissions - S3 Tables couldn't assume the migration role, or the role doesn't have a permission that the migration needs. detail is the role ARN.
sourcePermissions - The migration role couldn't read the Amazon Web Services Glue table or the source objects. detail names the table (database.table) or the source bucket.
destinationPermissions - The migration role couldn't write to the table bucket or the report bucket. detail names the bucket.
resourceNotFound - A resource that you specified doesn't exist, such as the Amazon Web Services Glue table or the source bucket. detail names it.
sourceNotSupported - The source table can't be migrated, for example because it is empty, has too many objects, or has columns or partitions that can't be migrated. The table compatibility report lists the findings.
tableCompatibilityReport - The migration couldn't create the destination table, for example because a table with that name already exists or the KMS key can't be used. For a sync, the destination table changed after the previous migration. The table compatibility report lists the finding.
objectCompatibilityReport - Some source objects can't be migrated, for example because they are archived, or because they were overwritten after an earlier migration migrated them. The object compatibility report lists them.
objectMigrationReport - Some source objects failed to migrate. The object migration report lists them and the cause for each.
reportBucketNotSupported - The report bucket can't receive the migration's reports, for example because it is in a different Region than the table bucket.
internalError - S3 Tables encountered an internal error. Retry the migration, and contact Amazon Web Services Support if the error persists.
The resource that the failure applies to, such as the role ARN, the Amazon Web Services Glue table (database.table) or a bucket. For sourceNotSupported, the reason that the source isn't supported, such as EMPTY_TABLE. This value isn't returned for the report codes or for internalError.
The reason that a migration failed: a code and, when there is one, the resource or reason it applies to. This value is returned only when the migration is in the failed state.
The general purpose bucket that the migration writes every report to.
", "smithy.api#required": {} } }, "prefixes": { "target": "com.amazonaws.s3tables#MigrationReportPrefixes", "traits": { "smithy.api#documentation": "The key prefix for each report.
" } } }, "traits": { "smithy.api#documentation": "The bucket and prefixes that a migration writes its reports to. Every report goes to one bucket, each under its own prefix.
" } }, "com.amazonaws.s3tables#MigrationOutputOverview": { "type": "structure", "members": { "bucket": { "target": "com.amazonaws.s3tables#S3BucketARN", "traits": { "smithy.api#documentation": "The general purpose bucket that the migration writes every report to.
", "smithy.api#required": {} } }, "tableCompatibilityReport": { "target": "com.amazonaws.s3tables#ReportOverview", "traits": { "smithy.api#documentation": "The table compatibility report: the sample object that the schema is inferred from, the table-level findings, and one row for each destination column with its type change and how the migration policies apply to it. The migration writes it when planning finishes, before any data migrates. If planning fails, the report might not be written.
", "smithy.api#required": {} } }, "objectCompatibilityReport": { "target": "com.amazonaws.s3tables#ReportOverview", "traits": { "smithy.api#documentation": "The object compatibility report: one row for each source object under the source table's location, with whether the migration includes the object and its most severe finding. The migration writes it when planning finishes. If planning fails, the report might not be written.
", "smithy.api#required": {} } }, "objectMigrationReport": { "target": "com.amazonaws.s3tables#ReportOverview", "traits": { "smithy.api#documentation": "The object migration report: one row for each source object that the migration tried to migrate, with whether it migrated, how it was transformed, and why it failed. The migration writes it once, when the migration ends. It isn't written if planning fails or if a sync has nothing to migrate.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Where a migration writes its reports, and the location of each report once it is written.
" } }, "com.amazonaws.s3tables#MigrationPolicies": { "type": "structure", "members": { "unmatchedSourceFieldsPolicy": { "target": "com.amazonaws.s3tables#UnmatchedSourceFieldsPolicy", "traits": { "smithy.api#default": "fail", "smithy.api#documentation": "The migration policy for a source field that has no matching column in the destination schema. Valid values:
fail - Fails the migration. This is the default.
drop - Leaves source columns that the destination schema doesn't have out of the destination table, and doesn't migrate source objects outside the Amazon Web Services Glue table's partition locations.
A destination schema that leaves out a partition column or a field of a struct column fails the migration under either value.
" } }, "incompatibleValuesPolicy": { "target": "com.amazonaws.s3tables#IncompatibleValuesPolicy", "traits": { "smithy.api#default": "fail", "smithy.api#documentation": "The migration policy for a source value that the destination column's type can't hold. Valid values:
fail - Fails the migration. This is the default.
setNull - Writes null for a value that the destination column's type can't hold. If a column's type in a source object is incompatible with the destination column's type, the column is null for that whole object.
A required column, or a type that migration doesn't support, fails the migration under either value.
" } } }, "traits": { "smithy.api#documentation": "The policies for source data that doesn't fit the destination schema.
" } }, "com.amazonaws.s3tables#MigrationReportPrefix": { "type": "string", "traits": { "smithy.api#length": { "max": 512 } } }, "com.amazonaws.s3tables#MigrationReportPrefixes": { "type": "structure", "members": { "tableCompatibilityReport": { "target": "com.amazonaws.s3tables#MigrationReportPrefix", "traits": { "smithy.api#documentation": "The key prefix for the table compatibility report, up to 512 bytes. If not specified, the report's keys start at the root of the bucket.
" } }, "objectCompatibilityReport": { "target": "com.amazonaws.s3tables#MigrationReportPrefix", "traits": { "smithy.api#documentation": "The key prefix for the object compatibility report, up to 512 bytes. If not specified, the report's keys start at the root of the bucket.
" } }, "objectMigrationReport": { "target": "com.amazonaws.s3tables#MigrationReportPrefix", "traits": { "smithy.api#documentation": "The key prefix for the object migration report, up to 512 bytes. If not specified, the report's keys start at the root of the bucket.
" } } }, "traits": { "smithy.api#documentation": "The key prefix for each report. If you don't specify a prefix for a report, its keys start at the root of the bucket.
" } }, "com.amazonaws.s3tables#MigrationRequestedState": { "type": "enum", "members": { "QUEUED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "queued" } }, "CANCELLED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "cancelled" } } } }, "com.amazonaws.s3tables#MigrationSnapshotManagementSettings": { "type": "structure", "members": { "minSnapshotsToKeep": { "target": "com.amazonaws.s3tables#MigrationMinSnapshotsToKeep", "traits": { "smithy.api#default": 3, "smithy.api#documentation": "The minimum number of snapshots to keep. The value must be 3 or more. The default is 3.
" } }, "maxSnapshotAgeHours": { "target": "com.amazonaws.s3tables#PositiveInteger", "traits": { "smithy.api#default": 120, "smithy.api#documentation": "The maximum age, in hours, of a snapshot before it can be expired. The default is 120.
" } } }, "traits": { "smithy.api#documentation": "The snapshot management settings that a migration applies to the destination table.
" } }, "com.amazonaws.s3tables#MigrationSourceType": { "type": "enum", "members": { "GLUE_TABLE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "glueTable" } } }, "traits": { "smithy.api#documentation": "The type of source that a migration reads from. It names the member that is set in SourceConfiguration.
The number of source objects whose data the migration wrote to the destination table. Migrated data can be queried after the migration commits it. If the migration fails or is cancelled, some migrated objects might not be committed.
" } }, "objectsFailedMigration": { "target": "smithy.api#Long", "traits": { "smithy.api#documentation": "The number of source objects that didn't migrate, because they failed or because another object, such as an object in the same partition, failed. The object migration report lists the cause for each object.
" } }, "objectsPendingMigration": { "target": "smithy.api#Long", "traits": { "smithy.api#documentation": "The number of source objects that haven't migrated or failed yet. When a migration fails or is cancelled, these are the objects that it didn't migrate.
" } } }, "traits": { "smithy.api#documentation": "The number of source objects that migrated, failed or are pending. For a sync, the counts cover every object of the table after the sync, including objects that earlier migrations migrated. The counts are set when planning finishes and updated when the migration ends.
" } }, "com.amazonaws.s3tables#MigrationSummary": { "type": "structure", "members": { "migrationId": { "target": "com.amazonaws.s3tables#MigrationId", "traits": { "smithy.api#documentation": "The ID of the migration.
", "smithy.api#required": {} } }, "tableBucketARN": { "target": "com.amazonaws.s3tables#TableBucketARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table bucket that contains the destination table.
", "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The namespace of the destination table.
", "smithy.api#required": {} } }, "tableARN": { "target": "com.amazonaws.s3tables#TableARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the destination table, once the migration creates it.
" } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name of the destination table.
", "smithy.api#required": {} } }, "type": { "target": "com.amazonaws.s3tables#MigrationType", "traits": { "smithy.api#documentation": "The type of the migration. Valid values:
start - A migration that StartTableMigration started.
sync - A migration that SyncTableMigration started.
The state of the migration. Valid values:
new - S3 Tables accepted the request.
planning - The migration is checking the source table, its objects and the destination for compatibility, and writing the compatibility reports.
pendingReview - Planning finished, and the migration waits for you to continue or cancel it with UpdateTableMigration.
queued - The migration is waiting to start migrating data.
migrating - The migration is running the plan from the planning state: it copies data and commits it to the destination table. A migration reaches this state only if hasValidPlan is true.
succeeded - Every planned object migrated.
failed - The migration failed. Check failureReason for the cause.
cancelling - You cancelled the migration, and it is finishing the work in progress.
cancelled - The migration is cancelled.
A Boolean value that specifies whether planning produced a plan that the migration can run. If planning hasn't finished, this value isn't returned.
" } }, "createdAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The date and time that the migration was created.
", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "stateUpdatedAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The date and time that the migration's state last changed.
", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } } }, "traits": { "smithy.api#documentation": "A summary of a migration.
" } }, "com.amazonaws.s3tables#MigrationSummaryList": { "type": "list", "member": { "target": "com.amazonaws.s3tables#MigrationSummary" } }, "com.amazonaws.s3tables#MigrationTableProperties": { "type": "structure", "members": { "writeFormat": { "target": "com.amazonaws.s3tables#DataFileFormat", "traits": { "smithy.api#default": "parquet", "smithy.api#documentation": "The file format of the data files. The only supported format is parquet, the default.
The Iceberg format version of the destination table. Valid values are 2 and 3. The default is 2.
The compression codec of the data files. The default is zstd.
Specifies whether the data files use dictionary encoding. The default is true.
The properties of the data files that a migration writes. The migration also sets the compression codec and dictionary encoding as the destination table's write properties, so they remain the table's defaults after you complete the migration.
" } }, "com.amazonaws.s3tables#MigrationTargetFileSizeMB": { "type": "integer", "traits": { "smithy.api#range": { "min": 64, "max": 512 } } }, "com.amazonaws.s3tables#MigrationType": { "type": "enum", "members": { "START": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "start" } }, "SYNC": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "sync" } } } }, "com.amazonaws.s3tables#NamespaceId": { "type": "string" }, "com.amazonaws.s3tables#NamespaceList": { "type": "list", "member": { "target": "com.amazonaws.s3tables#NamespaceName" } }, "com.amazonaws.s3tables#NamespaceName": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 255 }, "smithy.api#pattern": "^[0-9a-z_]*$" } }, "com.amazonaws.s3tables#NamespaceResource": { "type": "resource", "operations": [ { "target": "com.amazonaws.s3tables#CreateNamespace" }, { "target": "com.amazonaws.s3tables#DeleteNamespace" }, { "target": "com.amazonaws.s3tables#GetNamespace" }, { "target": "com.amazonaws.s3tables#ListNamespaces" } ] }, "com.amazonaws.s3tables#NamespaceSummary": { "type": "structure", "members": { "namespace": { "target": "com.amazonaws.s3tables#NamespaceList", "traits": { "smithy.api#documentation": "The name of the namespace.
", "smithy.api#required": {} } }, "createdAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The date and time the namespace was created at.
", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "createdBy": { "target": "com.amazonaws.s3tables#AccountId", "traits": { "smithy.api#documentation": "The ID of the account that created the namespace.
", "smithy.api#required": {} } }, "ownerAccountId": { "target": "com.amazonaws.s3tables#AccountId", "traits": { "smithy.api#documentation": "The ID of the account that owns the namespace.
", "smithy.api#required": {} } }, "namespaceId": { "target": "com.amazonaws.s3tables#NamespaceId", "traits": { "smithy.api#documentation": "The system-assigned unique identifier for the namespace.
" } }, "tableBucketId": { "target": "com.amazonaws.s3tables#TableBucketId", "traits": { "smithy.api#documentation": "The system-assigned unique identifier for the table bucket that contains this namespace.
" } } }, "traits": { "smithy.api#documentation": "Contains details about a namespace.
" } }, "com.amazonaws.s3tables#NamespaceSummaryList": { "type": "list", "member": { "target": "com.amazonaws.s3tables#NamespaceSummary" } }, "com.amazonaws.s3tables#NextToken": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 2048 } } }, "com.amazonaws.s3tables#NotFoundException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.s3tables#ErrorMessage" } }, "traits": { "smithy.api#documentation": "The request was rejected because the specified resource could not be found.
", "smithy.api#error": "client", "smithy.api#httpError": 404 } }, "com.amazonaws.s3tables#OpenTableFormat": { "type": "enum", "members": { "ICEBERG": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "ICEBERG" } } } }, "com.amazonaws.s3tables#PartitionDateSource": { "type": "enum", "members": { "EVENT_TIME": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "EventTime" } }, "DELIVERY_TIME": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "DeliveryTime" } } } }, "com.amazonaws.s3tables#PartitionedPrefix": { "type": "structure", "members": { "partitionDateSource": { "target": "com.amazonaws.s3tables#PartitionDateSource", "traits": { "smithy.api#documentation": "The date to use for the log object key partitions. Valid values are EventTime, the time that the requests in the log were made, and DeliveryTime, the time that the log was delivered.
Amazon S3 keys for log objects are partitioned in the following format: [targetPrefix][SourceAccountId]/[SourceRegion]/[SourceTableBucket]/[YYYY]/[MM]/[DD]/[YYYY]-[MM]-[DD]-[hh]-[mm]-[ss]-[UniqueString]
The number of source objects that the migration found under the source table's location, whether or not it migrates them. The object compatibility report has one row for each.
" } }, "objectsPlanned": { "target": "smithy.api#Long", "traits": { "smithy.api#documentation": "The number of source objects in the migration. For a start, these are the data files in the Amazon Web Services Glue table's partitions, or under the table's location if the table isn't partitioned. For a sync, these are all the data files of the table after the sync, including files that earlier migrations migrated.
" } }, "partitionCount": { "target": "smithy.api#Long", "traits": { "smithy.api#documentation": "The number of partitions in the destination table after this migration, or 0 if the source table isn't partitioned. This value is returned when planning produces a valid plan.
" } } }, "traits": { "smithy.api#documentation": "Statistics about the source and the partitions in a migration.
" } }, "com.amazonaws.s3tables#PositiveInteger": { "type": "integer", "traits": { "smithy.api#range": { "min": 1, "max": 2147483647 } } }, "com.amazonaws.s3tables#PutTableBucketEncryption": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#PutTableBucketEncryptionRequest" }, "output": { "target": "smithy.api#Unit" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Sets the encryption configuration for a table bucket.
You must have the s3tables:PutTableBucketEncryption permission to use this operation.
If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see Permissions requirements for S3 Tables SSE-KMS encryption in the Amazon Simple Storage Service User Guide.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "encryptionConfiguration": { "target": "com.amazonaws.s3tables#EncryptionConfiguration", "traits": { "smithy.api#documentation": "The encryption configuration to apply to the table bucket.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#PutTableBucketLogging": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#PutTableBucketLoggingRequest" }, "output": { "target": "smithy.api#Unit" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Sets, updates, or removes the server access logging configuration for a table bucket. When logging is enabled, Amazon S3 delivers a record of the requests made to the table bucket and its tables to the target general purpose bucket that you specify. To disable logging, call this operation with an empty tableBucketLoggingStatus. For more information, see Server access logging for table buckets in the Amazon Simple Storage Service User Guide.
You must have the s3tables:PutTableBucketLogging permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "tableBucketLoggingStatus": { "target": "com.amazonaws.s3tables#TableBucketLoggingStatus", "traits": { "smithy.api#documentation": "The logging status to apply to the table bucket. To disable logging, specify an empty tableBucketLoggingStatus.
Creates a new maintenance configuration or replaces an existing maintenance configuration for a table bucket. For more information, see Amazon S3 table bucket maintenance in the Amazon Simple Storage Service User Guide.
You must have the s3tables:PutTableBucketMaintenanceConfiguration permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket associated with the maintenance configuration.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "type": { "target": "com.amazonaws.s3tables#TableBucketMaintenanceType", "traits": { "smithy.api#documentation": "The type of the maintenance configuration.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "value": { "target": "com.amazonaws.s3tables#TableBucketMaintenanceConfigurationValue", "traits": { "smithy.api#documentation": "Defines the values of the maintenance configuration for the table bucket.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#PutTableBucketMetricsConfiguration": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#PutTableBucketMetricsConfigurationRequest" }, "output": { "target": "smithy.api#Unit" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Sets the metrics configuration for a table bucket.
You must have the s3tables:PutTableBucketMetricsConfiguration permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#PutTableBucketPolicy": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#PutTableBucketPolicyRequest" }, "output": { "target": "smithy.api#Unit" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Creates a new table bucket policy or replaces an existing table bucket policy for a table bucket. For more information, see Adding a table bucket policy in the Amazon Simple Storage Service User Guide.
You must have the s3tables:PutTableBucketPolicy permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "resourcePolicy": { "target": "com.amazonaws.s3tables#ResourcePolicy", "traits": { "smithy.api#documentation": "The JSON that defines the policy.
Creates or updates the replication configuration for a table bucket. This operation defines how tables in the source bucket are replicated to destination buckets. Replication helps ensure data availability and disaster recovery across regions or accounts.
You must have the s3tables:PutTableBucketReplication permission to use this operation. The IAM role specified in the configuration must have permissions to read from the source bucket and write permissions to all destination buckets.
You must also have the following permissions:
s3tables:GetTable permission on the source table.
s3tables:ListTables permission on the bucket containing the table.
s3tables:CreateTable permission for the destination.
s3tables:CreateNamespace permission for the destination.
s3tables:GetTableMaintenanceConfig permission for the source bucket.
s3tables:PutTableMaintenanceConfig permission for the destination bucket.
You must have iam:PassRole permission with condition allowing roles to be passed to replication.s3tables.amazonaws.com.
The Amazon Resource Name (ARN) of the source table bucket.
", "smithy.api#httpQuery": "tableBucketARN", "smithy.api#required": {} } }, "versionToken": { "target": "com.amazonaws.s3tables#VersionToken", "traits": { "smithy.api#documentation": "A version token from a previous GetTableBucketReplication call. Use this token to ensure you're updating the expected version of the configuration.
", "smithy.api#httpQuery": "versionToken" } }, "configuration": { "target": "com.amazonaws.s3tables#TableBucketReplicationConfiguration", "traits": { "smithy.api#documentation": "The replication configuration to apply, including the IAM role and replication rules.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#PutTableBucketReplicationResponse": { "type": "structure", "members": { "versionToken": { "target": "com.amazonaws.s3tables#VersionToken", "traits": { "smithy.api#documentation": "A new version token representing the updated replication configuration.
", "smithy.api#required": {} } }, "status": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The status of the replication configuration operation.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#PutTableBucketStorageClass": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#PutTableBucketStorageClassRequest" }, "output": { "target": "smithy.api#Unit" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Sets or updates the storage class configuration for a table bucket. This configuration serves as the default storage class for all new tables created in the bucket, allowing you to optimize storage costs at the bucket level.
You must have the s3tables:PutTableBucketStorageClass permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "storageClassConfiguration": { "target": "com.amazonaws.s3tables#StorageClassConfiguration", "traits": { "smithy.api#documentation": "The storage class configuration to apply to the table bucket. This configuration will serve as the default for new tables created in this bucket.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#PutTableMaintenanceConfiguration": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#PutTableMaintenanceConfigurationRequest" }, "output": { "target": "smithy.api#Unit" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Creates a new maintenance configuration or replaces an existing maintenance configuration for a table. For more information, see S3 Tables maintenance in the Amazon Simple Storage Service User Guide.
You must have the s3tables:PutTableMaintenanceConfiguration permission to use this operation.
The Amazon Resource Name (ARN) of the table associated with the maintenance configuration.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The namespace of the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name of the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "type": { "target": "com.amazonaws.s3tables#TableMaintenanceType", "traits": { "smithy.api#documentation": "The type of the maintenance configuration.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "value": { "target": "com.amazonaws.s3tables#TableMaintenanceConfigurationValue", "traits": { "smithy.api#documentation": "Defines the values of the maintenance configuration for the table.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#PutTablePolicy": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#PutTablePolicyRequest" }, "output": { "target": "smithy.api#Unit" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Creates a new table policy or replaces an existing table policy for a table. For more information, see Adding a table policy in the Amazon Simple Storage Service User Guide.
You must have the s3tables:PutTablePolicy permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket that contains the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The namespace associated with the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name of the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "resourcePolicy": { "target": "com.amazonaws.s3tables#ResourcePolicy", "traits": { "smithy.api#documentation": "The JSON that defines the policy.
Creates or updates the expiration configuration settings for records in a table, including the status of the configuration. If you enable record expiration for a table, records expire and are automatically removed from the table after the number of days that you specify.
You must have the s3tables:PutTableRecordExpirationConfiguration permission to use this operation.
The Amazon Resource Name (ARN) of the table.
", "smithy.api#httpQuery": "tableArn", "smithy.api#required": {} } }, "value": { "target": "com.amazonaws.s3tables#TableRecordExpirationConfigurationValue", "traits": { "smithy.api#documentation": "The record expiration configuration to apply to the table, including the status (enabled or disabled) and retention period in days.
Creates or updates the replication configuration for a specific table. This operation allows you to define table-level replication independently of bucket-level replication, providing granular control over which tables are replicated and where.
You must have the s3tables:PutTableReplication permission to use this operation. The IAM role specified in the configuration must have permissions to read from the source table and write to all destination tables.
You must also have the following permissions:
s3tables:GetTable permission on the source table being replicated.
s3tables:CreateTable permission for the destination.
s3tables:CreateNamespace permission for the destination.
s3tables:GetTableMaintenanceConfig permission for the source table.
s3tables:PutTableMaintenanceConfig permission for the destination table.
You must have iam:PassRole permission with condition allowing roles to be passed to replication.s3tables.amazonaws.com.
The Amazon Resource Name (ARN) of the source table.
", "smithy.api#httpQuery": "tableArn", "smithy.api#required": {} } }, "versionToken": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "A version token from a previous GetTableReplication call. Use this token to ensure you're updating the expected version of the configuration.
", "smithy.api#httpQuery": "versionToken" } }, "configuration": { "target": "com.amazonaws.s3tables#TableReplicationConfiguration", "traits": { "smithy.api#documentation": "The replication configuration to apply to the table, including the IAM role and replication rules.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#PutTableReplicationResponse": { "type": "structure", "members": { "versionToken": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "A new version token representing the updated replication configuration.
", "smithy.api#required": {} } }, "status": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The status of the replication configuration operation.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#RenameTable": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#RenameTableRequest" }, "output": { "target": "smithy.api#Unit" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Renames a table or a namespace. For more information, see S3 Tables in the Amazon Simple Storage Service User Guide.
You must have the s3tables:RenameTable permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The namespace associated with the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The current name of the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "newNamespaceName": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The new name for the namespace.
" } }, "newName": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The new name for the table.
" } }, "versionToken": { "target": "com.amazonaws.s3tables#VersionToken", "traits": { "smithy.api#documentation": "The version token of the table.
" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#ReplicationDestination": { "type": "structure", "members": { "destinationTableBucketARN": { "target": "com.amazonaws.s3tables#TableBucketARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the destination table bucket where tables will be replicated.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Specifies a destination table bucket for replication.
" } }, "com.amazonaws.s3tables#ReplicationDestinationStatusModel": { "type": "structure", "members": { "replicationStatus": { "target": "com.amazonaws.s3tables#ReplicationStatus", "traits": { "smithy.api#documentation": "The current status of replication to this destination.
", "smithy.api#required": {} } }, "destinationTableBucketArn": { "target": "com.amazonaws.s3tables#TableBucketARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the destination table bucket.
", "smithy.api#required": {} } }, "destinationTableArn": { "target": "com.amazonaws.s3tables#TableARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the destination table.
" } }, "lastSuccessfulReplicatedUpdate": { "target": "com.amazonaws.s3tables#LastSuccessfulReplicatedUpdate", "traits": { "smithy.api#documentation": "Information about the most recent successful replication update to this destination.
" } }, "failureMessage": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "If replication has failed, this field contains an error message describing the failure reason.
" } } }, "traits": { "smithy.api#documentation": "Contains status information for a replication destination, including the current replication state, last successful update, and any error messages.
" } }, "com.amazonaws.s3tables#ReplicationDestinationStatuses": { "type": "list", "member": { "target": "com.amazonaws.s3tables#ReplicationDestinationStatusModel" }, "traits": { "smithy.api#length": { "min": 1, "max": 5 } } }, "com.amazonaws.s3tables#ReplicationDestinations": { "type": "list", "member": { "target": "com.amazonaws.s3tables#ReplicationDestination" }, "traits": { "smithy.api#length": { "min": 1, "max": 5 } } }, "com.amazonaws.s3tables#ReplicationInformation": { "type": "structure", "members": { "sourceTableARN": { "target": "com.amazonaws.s3tables#TableARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the source table from which this table is replicated.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Contains information about the source of a replicated table.
" } }, "com.amazonaws.s3tables#ReplicationStatus": { "type": "enum", "members": { "PENDING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "pending" } }, "COMPLETED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "completed" } }, "FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "failed" } } } }, "com.amazonaws.s3tables#ReportObjectKey": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 1024 } } }, "com.amazonaws.s3tables#ReportOverview": { "type": "structure", "members": { "prefix": { "target": "com.amazonaws.s3tables#MigrationReportPrefix", "traits": { "smithy.api#documentation": "The key prefix that the report is written under.
" } }, "key": { "target": "com.amazonaws.s3tables#ReportObjectKey", "traits": { "smithy.api#documentation": "The key of the report object in the bucket. For the object compatibility and object migration reports, this is the report's manifest; for the table compatibility report, it is the report itself. This value is returned after the migration writes the report. A migration doesn't always write every report. For example, a migration that fails during planning doesn't write the object migration report.
" } }, "checksumCRC64NVME": { "target": "com.amazonaws.s3tables#ChecksumCRC64NVME", "traits": { "smithy.api#documentation": "The Base64-encoded CRC64NVME checksum of the object that key names. For a report that has a manifest, the manifest lists the checksum of each report file. This value is returned after the migration writes the report.
For the compatibility reports, the number of blocking findings in each category. The object compatibility report counts each blocked object once, under its most severe finding. Categories with no blocking findings are left out.
" } } }, "traits": { "smithy.api#documentation": "A report of a migration: the prefix it is written under and, once it is written, its key, its checksum and, for the compatibility reports, the number of blocking findings in each category.
" } }, "com.amazonaws.s3tables#ResourceArn": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 2048 }, "smithy.api#pattern": "^arn:aws[-a-z0-9]*:[a-z0-9]+:[-a-z0-9]*:[0-9]{12}:bucket/.+$" } }, "com.amazonaws.s3tables#ResourcePolicy": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 20480 } } }, "com.amazonaws.s3tables#RoleArn": { "type": "string", "traits": { "smithy.api#length": { "min": 20, "max": 2048 }, "smithy.api#pattern": "^arn:aws[-a-z0-9]*:iam::[0-9]{12}:role/.+$" } }, "com.amazonaws.s3tables#S3BucketARN": { "type": "string", "traits": { "smithy.api#length": { "min": 12, "max": 1024 }, "smithy.api#pattern": "^arn:aws[-a-z0-9]*:s3[a-z]*:[-a-z0-9]*:([0-9]{12})?:.+$" } }, "com.amazonaws.s3tables#S3TableBuckets": { "type": "service", "version": "2018-05-10", "operations": [ { "target": "com.amazonaws.s3tables#ListTagsForResource" }, { "target": "com.amazonaws.s3tables#TagResource" }, { "target": "com.amazonaws.s3tables#UntagResource" } ], "resources": [ { "target": "com.amazonaws.s3tables#NamespaceResource" }, { "target": "com.amazonaws.s3tables#TableBucketEncryptionResource" }, { "target": "com.amazonaws.s3tables#TableBucketLoggingResource" }, { "target": "com.amazonaws.s3tables#TableBucketPolicyResource" }, { "target": "com.amazonaws.s3tables#TableBucketReplicationResource" }, { "target": "com.amazonaws.s3tables#TableBucketResource" }, { "target": "com.amazonaws.s3tables#TableEncryptionResource" }, { "target": "com.amazonaws.s3tables#TablePolicyResource" }, { "target": "com.amazonaws.s3tables#TableReplicationResource" }, { "target": "com.amazonaws.s3tables#TableResource" } ], "traits": { "aws.api#service": { "sdkId": "S3Tables", "arnNamespace": "s3tables", "cloudTrailEventSource": "s3tables.amazonaws.com" }, "aws.auth#sigv4": { "name": "s3tables" }, "aws.protocols#restJson1": {}, "smithy.api#cors": {}, "smithy.api#documentation": "An Amazon S3 table represents a structured dataset consisting of tabular data in Apache Parquet format and related metadata. This data is stored inside an S3 table as a subresource. All tables in a table bucket are stored in the Apache Iceberg table format. Through integration with the Amazon Web Services Glue Data Catalog you can interact with your tables using Amazon Web Services analytics services, such as Amazon Athena and Amazon Redshift. Amazon S3 manages maintenance of your tables through automatic file compaction and snapshot management. For more information, see Amazon S3 table buckets.
", "smithy.api#title": "Amazon S3 Tables", "smithy.rules#endpointBdd": { "version": "1.1", "parameters": { "Region": { "builtIn": "AWS::Region", "required": false, "documentation": "The AWS region used to dispatch the request.", "type": "string" }, "UseDualStack": { "builtIn": "AWS::UseDualStack", "required": true, "default": false, "documentation": "When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.", "type": "boolean" }, "UseFIPS": { "builtIn": "AWS::UseFIPS", "required": true, "default": false, "documentation": "When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.", "type": "boolean" }, "Endpoint": { "builtIn": "SDK::Endpoint", "required": false, "documentation": "Override the endpoint used to send this request", "type": "string" } }, "conditions": [ { "fn": "isSet", "argv": [ { "ref": "Endpoint" } ] }, { "fn": "isSet", "argv": [ { "ref": "Region" } ] }, { "fn": "aws.partition", "argv": [ { "ref": "Region" } ], "assign": "PartitionResult" }, { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] }, { "fn": "booleanEquals", "argv": [ { "ref": "UseDualStack" }, true ] }, { "fn": "booleanEquals", "argv": [ { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsDualStack" ] }, true ] }, { "fn": "booleanEquals", "argv": [ { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsFIPS" ] }, true ] } ], "results": [ { "conditions": [], "error": "Invalid Configuration: FIPS and custom endpoint are not supported", "type": "error" }, { "conditions": [], "error": "Invalid Configuration: Dualstack and custom endpoint are not supported", "type": "error" }, { "conditions": [], "endpoint": { "url": { "ref": "Endpoint" }, "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "endpoint": { "url": "https://s3tables-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "error": "FIPS and DualStack are enabled, but this partition does not support one or both", "type": "error" }, { "conditions": [], "endpoint": { "url": "https://s3tables-fips.{Region}.{PartitionResult#dnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "error": "FIPS is enabled but this partition does not support FIPS", "type": "error" }, { "conditions": [], "endpoint": { "url": "https://s3tables.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "error": "DualStack is enabled but this partition does not support DualStack", "type": "error" }, { "conditions": [], "endpoint": { "url": "https://s3tables.{Region}.{PartitionResult#dnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "error": "Invalid Configuration: Missing Region", "type": "error" } ], "root": 2, "nodeCount": 13, "nodes": "/////wAAAAH/////AAAAAAAAAAwAAAADAAAAAQAAAAQF9eELAAAAAgAAAAUF9eELAAAAAwAAAAgAAAAGAAAABAAAAAcF9eEKAAAABQX14QgF9eEJAAAABAAAAAoAAAAJAAAABgX14QYF9eEHAAAABQAAAAsF9eEFAAAABgX14QQF9eEFAAAAAwX14QEAAAANAAAABAX14QIF9eED" }, "smithy.rules#endpointRuleSet": { "version": "1.0", "parameters": { "Region": { "builtIn": "AWS::Region", "required": false, "documentation": "The AWS region used to dispatch the request.", "type": "string" }, "UseDualStack": { "builtIn": "AWS::UseDualStack", "required": true, "default": false, "documentation": "When true, use the dual-stack endpoint. If the configured endpoint does not support dual-stack, dispatching the request MAY return an error.", "type": "boolean" }, "UseFIPS": { "builtIn": "AWS::UseFIPS", "required": true, "default": false, "documentation": "When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.", "type": "boolean" }, "Endpoint": { "builtIn": "SDK::Endpoint", "required": false, "documentation": "Override the endpoint used to send this request", "type": "string" } }, "rules": [ { "conditions": [ { "fn": "isSet", "argv": [ { "ref": "Endpoint" } ] } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] } ], "error": "Invalid Configuration: FIPS and custom endpoint are not supported", "type": "error" }, { "conditions": [], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseDualStack" }, true ] } ], "error": "Invalid Configuration: Dualstack and custom endpoint are not supported", "type": "error" }, { "conditions": [], "endpoint": { "url": { "ref": "Endpoint" }, "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" } ], "type": "tree" }, { "conditions": [], "rules": [ { "conditions": [ { "fn": "isSet", "argv": [ { "ref": "Region" } ] } ], "rules": [ { "conditions": [ { "fn": "aws.partition", "argv": [ { "ref": "Region" } ], "assign": "PartitionResult" } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] }, { "fn": "booleanEquals", "argv": [ { "ref": "UseDualStack" }, true ] } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ true, { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsFIPS" ] } ] }, { "fn": "booleanEquals", "argv": [ true, { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsDualStack" ] } ] } ], "rules": [ { "conditions": [], "rules": [ { "conditions": [], "endpoint": { "url": "https://s3tables-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" } ], "type": "tree" }, { "conditions": [], "error": "FIPS and DualStack are enabled, but this partition does not support one or both", "type": "error" } ], "type": "tree" }, { "conditions": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsFIPS" ] }, true ] } ], "rules": [ { "conditions": [], "rules": [ { "conditions": [], "endpoint": { "url": "https://s3tables-fips.{Region}.{PartitionResult#dnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" } ], "type": "tree" }, { "conditions": [], "error": "FIPS is enabled but this partition does not support FIPS", "type": "error" } ], "type": "tree" }, { "conditions": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseDualStack" }, true ] } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ true, { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsDualStack" ] } ] } ], "rules": [ { "conditions": [], "rules": [ { "conditions": [], "endpoint": { "url": "https://s3tables.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" } ], "type": "tree" }, { "conditions": [], "error": "DualStack is enabled but this partition does not support DualStack", "type": "error" } ], "type": "tree" }, { "conditions": [], "rules": [ { "conditions": [], "endpoint": { "url": "https://s3tables.{Region}.{PartitionResult#dnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" } ], "type": "tree" } ], "type": "tree" }, { "conditions": [], "error": "Invalid Configuration: Missing Region", "type": "error" } ], "type": "tree" } ] }, "smithy.rules#endpointTests": { "testCases": [ { "documentation": "For region us-east-1 with FIPS enabled and DualStack enabled", "expect": { "endpoint": { "url": "https://s3tables-fips.us-east-1.api.aws" } }, "params": { "Region": "us-east-1", "UseFIPS": true, "UseDualStack": true } }, { "documentation": "For region us-east-1 with FIPS enabled and DualStack disabled", "expect": { "endpoint": { "url": "https://s3tables-fips.us-east-1.amazonaws.com" } }, "params": { "Region": "us-east-1", "UseFIPS": true, "UseDualStack": false } }, { "documentation": "For region us-east-1 with FIPS disabled and DualStack enabled", "expect": { "endpoint": { "url": "https://s3tables.us-east-1.api.aws" } }, "params": { "Region": "us-east-1", "UseFIPS": false, "UseDualStack": true } }, { "documentation": "For region us-east-1 with FIPS disabled and DualStack disabled", "expect": { "endpoint": { "url": "https://s3tables.us-east-1.amazonaws.com" } }, "params": { "Region": "us-east-1", "UseFIPS": false, "UseDualStack": false } }, { "documentation": "For region cn-north-1 with FIPS enabled and DualStack enabled", "expect": { "endpoint": { "url": "https://s3tables-fips.cn-north-1.api.amazonwebservices.com.cn" } }, "params": { "Region": "cn-north-1", "UseFIPS": true, "UseDualStack": true } }, { "documentation": "For region cn-north-1 with FIPS enabled and DualStack disabled", "expect": { "endpoint": { "url": "https://s3tables-fips.cn-north-1.amazonaws.com.cn" } }, "params": { "Region": "cn-north-1", "UseFIPS": true, "UseDualStack": false } }, { "documentation": "For region cn-north-1 with FIPS disabled and DualStack enabled", "expect": { "endpoint": { "url": "https://s3tables.cn-north-1.api.amazonwebservices.com.cn" } }, "params": { "Region": "cn-north-1", "UseFIPS": false, "UseDualStack": true } }, { "documentation": "For region cn-north-1 with FIPS disabled and DualStack disabled", "expect": { "endpoint": { "url": "https://s3tables.cn-north-1.amazonaws.com.cn" } }, "params": { "Region": "cn-north-1", "UseFIPS": false, "UseDualStack": false } }, { "documentation": "For region us-gov-east-1 with FIPS enabled and DualStack enabled", "expect": { "endpoint": { "url": "https://s3tables-fips.us-gov-east-1.api.aws" } }, "params": { "Region": "us-gov-east-1", "UseFIPS": true, "UseDualStack": true } }, { "documentation": "For region us-gov-east-1 with FIPS enabled and DualStack disabled", "expect": { "endpoint": { "url": "https://s3tables-fips.us-gov-east-1.amazonaws.com" } }, "params": { "Region": "us-gov-east-1", "UseFIPS": true, "UseDualStack": false } }, { "documentation": "For region us-gov-east-1 with FIPS disabled and DualStack enabled", "expect": { "endpoint": { "url": "https://s3tables.us-gov-east-1.api.aws" } }, "params": { "Region": "us-gov-east-1", "UseFIPS": false, "UseDualStack": true } }, { "documentation": "For region us-gov-east-1 with FIPS disabled and DualStack disabled", "expect": { "endpoint": { "url": "https://s3tables.us-gov-east-1.amazonaws.com" } }, "params": { "Region": "us-gov-east-1", "UseFIPS": false, "UseDualStack": false } }, { "documentation": "For region us-iso-east-1 with FIPS enabled and DualStack disabled", "expect": { "endpoint": { "url": "https://s3tables-fips.us-iso-east-1.c2s.ic.gov" } }, "params": { "Region": "us-iso-east-1", "UseFIPS": true, "UseDualStack": false } }, { "documentation": "For region us-iso-east-1 with FIPS disabled and DualStack disabled", "expect": { "endpoint": { "url": "https://s3tables.us-iso-east-1.c2s.ic.gov" } }, "params": { "Region": "us-iso-east-1", "UseFIPS": false, "UseDualStack": false } }, { "documentation": "For region us-isob-east-1 with FIPS enabled and DualStack disabled", "expect": { "endpoint": { "url": "https://s3tables-fips.us-isob-east-1.sc2s.sgov.gov" } }, "params": { "Region": "us-isob-east-1", "UseFIPS": true, "UseDualStack": false } }, { "documentation": "For region us-isob-east-1 with FIPS disabled and DualStack disabled", "expect": { "endpoint": { "url": "https://s3tables.us-isob-east-1.sc2s.sgov.gov" } }, "params": { "Region": "us-isob-east-1", "UseFIPS": false, "UseDualStack": false } }, { "documentation": "For custom endpoint with region set and fips disabled and dualstack disabled", "expect": { "endpoint": { "url": "https://example.com" } }, "params": { "Region": "us-east-1", "UseFIPS": false, "UseDualStack": false, "Endpoint": "https://example.com" } }, { "documentation": "For custom endpoint with region not set and fips disabled and dualstack disabled", "expect": { "endpoint": { "url": "https://example.com" } }, "params": { "UseFIPS": false, "UseDualStack": false, "Endpoint": "https://example.com" } }, { "documentation": "For custom endpoint with fips enabled and dualstack disabled", "expect": { "error": "Invalid Configuration: FIPS and custom endpoint are not supported" }, "params": { "Region": "us-east-1", "UseFIPS": true, "UseDualStack": false, "Endpoint": "https://example.com" } }, { "documentation": "For custom endpoint with fips disabled and dualstack enabled", "expect": { "error": "Invalid Configuration: Dualstack and custom endpoint are not supported" }, "params": { "Region": "us-east-1", "UseFIPS": false, "UseDualStack": true, "Endpoint": "https://example.com" } }, { "documentation": "Missing region", "expect": { "error": "Invalid Configuration: Missing Region" } } ], "version": "1.0" } } }, "com.amazonaws.s3tables#SSEAlgorithm": { "type": "enum", "members": { "AES256": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "AES256" } }, "AWS_KMS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "aws:kms" } } } }, "com.amazonaws.s3tables#SchemaField": { "type": "structure", "members": { "id": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "An optional unique identifier for the schema field. Field IDs are used by Apache Iceberg to track schema evolution and maintain compatibility across schema changes. If not specified, S3 Tables automatically assigns field IDs.
" } }, "name": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The name of the field.
", "smithy.api#required": {} } }, "type": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The field type. S3 Tables supports all Apache Iceberg primitive types. For more information, see the Apache Iceberg documentation.
", "smithy.api#required": {} } }, "required": { "target": "smithy.api#Boolean", "traits": { "smithy.api#default": false, "smithy.api#documentation": "A Boolean value that specifies whether values are required for each row in this field. By default, this is false and null values are allowed in the field. If this is true the field does not allow null values.
Contains details about a schema field.
" } }, "com.amazonaws.s3tables#SchemaFieldList": { "type": "list", "member": { "target": "com.amazonaws.s3tables#SchemaField" } }, "com.amazonaws.s3tables#SchemaV2Field": { "type": "structure", "members": { "id": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "The unique identifier for the schema field. Field IDs are used by Apache Iceberg to track schema evolution and maintain compatibility across schema changes.
", "smithy.api#required": {} } }, "name": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The name of the field.
", "smithy.api#required": {} } }, "type": { "target": "smithy.api#Document", "traits": { "smithy.api#documentation": "The data type of the field. This can be a primitive type string such as boolean, int, long, float, double, string, binary, date, timestamp, or timestamptz, or a complex type represented as a JSON object for nested types such as struct, list, or map. For more information, see the Apache Iceberg schemas and data types documentation.
A Boolean value that specifies whether values are required for each row in this field. If this is true, the field does not allow null values.
An optional description of the field.
" } } }, "traits": { "smithy.api#documentation": "Contains details about a schema field in the V2 format. This field format supports nested and complex data types such as struct, list, and map, in addition to primitive types.
An Amazon Web Services Glue Data Catalog table to migrate. The table must be an external Apache Hive table whose data is stored as Parquet in a general purpose bucket in the same account and Region as the table bucket. Views, transactional (ACID) tables, tables in an open table format such as Apache Iceberg, and tables registered with Amazon Web Services Lake Formation can't be migrated. If the table can't be migrated, the migration fails, and the table compatibility report lists the reason.
" } } }, "traits": { "smithy.api#documentation": "The source to migrate from. Set exactly one member, and set sourceType to match it.
Starts migrating an Amazon Web Services Glue Data Catalog table into a new table in a table bucket. The migration runs asynchronously: this operation returns the migration ID and its initial state, and you track progress with GetTableMigration.
The namespace must already exist, and a table with the specified name must not. The migration creates the table during planning and commits data to it as it runs. Until you call CompleteTableMigration, you can read the table but you can't write to it. If the migration fails or is cancelled, the table and the data already committed to it remain.
The migration first checks the source and the destination, and writes the table compatibility and object compatibility reports to the bucket that you specify in migrationOutput. If you set reviewMigrationPlan to true, the migration waits in the pendingReview state so that you can review the reports, and continues only when you call UpdateTableMigration with requestedState set to queued. If you don't continue or cancel the migration within 30 days, the migration fails. Otherwise it continues to migrate the data, and writes the object migration report when the migration ends. If planning fails, the migration writes no object migration report.
You must have the s3tables:StartTableMigration permission to use this operation.
You must have the iam:PassRole permission on the role that you specify in roleARN, with a condition that allows passing it to migration.s3tables.amazonaws.com. The associated resource is the table bucket.
If destinationTable specifies SSE-KMS encryption, you must have the kms:DescribeKey and kms:GenerateDataKey permissions on the KMS key. You must also grant the S3 Tables maintenance principal access to the key. For more information, see Permissions requirements for S3 Tables SSE-KMS encryption.
The Amazon Resource Name (ARN) of the IAM role that the migration uses to read the source table and its data and to write the destination table and the reports. The role must be in your account, and its trust policy must allow migration.s3tables.amazonaws.com to assume it. You can limit the trust policy to the destination table bucket with the aws:SourceArn and aws:SourceAccount condition keys.
The table to create and migrate the source into.
", "smithy.api#required": {} } }, "sourceType": { "target": "com.amazonaws.s3tables#MigrationSourceType", "traits": { "smithy.api#documentation": "The type of the source. It must match the member that you set in source.
The source table to migrate.
", "smithy.api#required": {} } }, "dataMigration": { "target": "com.amazonaws.s3tables#DataMigrationSettings", "traits": { "smithy.api#documentation": "The maintenance settings and migration policies for the destination table.
" } }, "reviewMigrationPlan": { "target": "smithy.api#Boolean", "traits": { "smithy.api#default": false, "smithy.api#documentation": "Specifies whether the migration waits in the pendingReview state, so that you can review the compatibility reports before it migrates any data. If true, the migration continues when you call UpdateTableMigration with requestedState set to queued. If you don't continue or cancel the migration within 30 days, the migration fails. The default is false.
The bucket and prefixes that the migration writes its reports to. The bucket must be a general purpose bucket in your account and in the same Region as the table bucket, and the migration role must be able to write objects to it. Otherwise, the migration fails when it writes its first report.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#StartTableMigrationResponse": { "type": "structure", "members": { "migrationId": { "target": "com.amazonaws.s3tables#MigrationId", "traits": { "smithy.api#documentation": "The ID of the migration.
", "smithy.api#required": {} } }, "state": { "target": "com.amazonaws.s3tables#MigrationState", "traits": { "smithy.api#documentation": "The state of the migration when the request is accepted, such as planning.
The storage class for the table or table bucket. Valid values include storage classes optimized for different access patterns and cost profiles.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The configuration details for the storage class of tables or table buckets. This allows you to optimize storage costs by selecting the appropriate storage class based on your access patterns and performance requirements.
" } }, "com.amazonaws.s3tables#SyncTableMigration": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#SyncTableMigrationRequest" }, "output": { "target": "com.amazonaws.s3tables#SyncTableMigrationResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#AccessDeniedException" }, { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Migrates the changes in the source table since the previous start or sync, such as added and deleted source objects, into the destination table. The sync runs asynchronously: this operation returns the migration ID of the sync and its initial state, and you track progress with GetTableMigration.
A sync uses the source, destination and data migration settings of the table's migration, and plans the work and writes its reports in the same way as StartTableMigration. You can sync after a start or sync that succeeded, failed or was cancelled, if an earlier start or sync of the table has a valid plan (hasValidPlan). You can't sync a table while a start or sync is in progress for it, and you can sync a table until you call CompleteTableMigration for it. If a source object that an earlier migration migrated has since been overwritten, the sync fails.
You must have the s3tables:SyncTableMigration permission to use this operation.
You must have the iam:PassRole permission on the role that you specify in roleARN, with a condition that allows passing it to migration.s3tables.amazonaws.com. The associated resource is the table.
The Amazon Resource Name (ARN) of the IAM role that the sync uses to read the source table and its data and to write the destination table and the reports. The role must be in your account, and its trust policy must allow migration.s3tables.amazonaws.com to assume it. You can limit the trust policy to the destination table bucket with the aws:SourceArn and aws:SourceAccount condition keys.
The Amazon Resource Name (ARN) of the destination table to sync. The table must have a migration, and you must not have called CompleteTableMigration for it.
Specifies whether the sync waits in the pendingReview state, so that you can review the compatibility reports before it migrates any data. If true, the migration continues when you call UpdateTableMigration with requestedState set to queued. If you don't continue or cancel the migration within 30 days, the migration fails. The default is false.
The bucket and prefixes that the sync writes its reports to. The bucket must be a general purpose bucket in your account and in the same Region as the table bucket, and the migration role must be able to write objects to it. Otherwise, the migration fails when it writes its first report.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#SyncTableMigrationResponse": { "type": "structure", "members": { "migrationId": { "target": "com.amazonaws.s3tables#MigrationId", "traits": { "smithy.api#documentation": "The migration ID of the sync.
", "smithy.api#required": {} } }, "state": { "target": "com.amazonaws.s3tables#MigrationState", "traits": { "smithy.api#documentation": "The state of the migration when the request is accepted, such as planning.
Where logs for the table bucket are delivered and how the log objects are named. Must be populated to enable logging.
" } } }, "traits": { "smithy.api#documentation": "The server access logging status of a table bucket. To enable logging, specify loggingEnabled. To disable logging, specify an empty TableBucketLoggingStatus.
The status of the maintenance configuration.
" } }, "settings": { "target": "com.amazonaws.s3tables#TableBucketMaintenanceSettings", "traits": { "smithy.api#documentation": "Contains details about the settings of the maintenance configuration.
" } } }, "traits": { "smithy.api#documentation": "Details about the values that define the maintenance configuration for a table bucket.
" } }, "com.amazonaws.s3tables#TableBucketMaintenanceSettings": { "type": "union", "members": { "icebergUnreferencedFileRemoval": { "target": "com.amazonaws.s3tables#IcebergUnreferencedFileRemovalSettings", "traits": { "smithy.api#documentation": "The unreferenced file removal settings for the table bucket.
" } } }, "traits": { "smithy.api#documentation": "Contains details about the maintenance settings for the table bucket.
" } }, "com.amazonaws.s3tables#TableBucketMaintenanceType": { "type": "enum", "members": { "ICEBERG_UNREFERENCED_FILE_REMOVAL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "icebergUnreferencedFileRemoval" } } } }, "com.amazonaws.s3tables#TableBucketName": { "type": "string", "traits": { "smithy.api#length": { "min": 3, "max": 63 }, "smithy.api#pattern": "^[0-9a-z-]*$" } }, "com.amazonaws.s3tables#TableBucketPolicyResource": { "type": "resource", "operations": [ { "target": "com.amazonaws.s3tables#DeleteTableBucketPolicy" }, { "target": "com.amazonaws.s3tables#GetTableBucketPolicy" }, { "target": "com.amazonaws.s3tables#PutTableBucketPolicy" } ] }, "com.amazonaws.s3tables#TableBucketReplicationConfiguration": { "type": "structure", "members": { "role": { "target": "com.amazonaws.s3tables#IAMRole", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the IAM role that S3 Tables assumes to replicate tables on your behalf.
", "smithy.api#required": {} } }, "rules": { "target": "com.amazonaws.s3tables#TableBucketReplicationRules", "traits": { "smithy.api#documentation": "An array of replication rules that define which tables to replicate and where to replicate them.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The replication configuration for a table bucket. This configuration defines how tables in the source bucket are replicated to destination table buckets, including the IAM role used for replication.
" } }, "com.amazonaws.s3tables#TableBucketReplicationResource": { "type": "resource", "operations": [ { "target": "com.amazonaws.s3tables#DeleteTableBucketReplication" }, { "target": "com.amazonaws.s3tables#GetTableBucketReplication" }, { "target": "com.amazonaws.s3tables#PutTableBucketReplication" } ], "traits": { "aws.api#arn": { "absolute": true, "template": "com.amazonaws.s3tables#TableBucketARN" } } }, "com.amazonaws.s3tables#TableBucketReplicationRule": { "type": "structure", "members": { "destinations": { "target": "com.amazonaws.s3tables#ReplicationDestinations", "traits": { "smithy.api#documentation": "An array of destination table buckets where tables should be replicated.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Defines a rule for replicating tables from a source table bucket to one or more destination table buckets.
" } }, "com.amazonaws.s3tables#TableBucketReplicationRules": { "type": "list", "member": { "target": "com.amazonaws.s3tables#TableBucketReplicationRule" }, "traits": { "smithy.api#length": { "min": 1, "max": 1 } } }, "com.amazonaws.s3tables#TableBucketResource": { "type": "resource", "operations": [ { "target": "com.amazonaws.s3tables#CreateTableBucket" }, { "target": "com.amazonaws.s3tables#DeleteTableBucket" }, { "target": "com.amazonaws.s3tables#DeleteTableBucketMetricsConfiguration" }, { "target": "com.amazonaws.s3tables#GetTableBucket" }, { "target": "com.amazonaws.s3tables#GetTableBucketMaintenanceConfiguration" }, { "target": "com.amazonaws.s3tables#GetTableBucketMetricsConfiguration" }, { "target": "com.amazonaws.s3tables#GetTableBucketStorageClass" }, { "target": "com.amazonaws.s3tables#ListTableBuckets" }, { "target": "com.amazonaws.s3tables#PutTableBucketMaintenanceConfiguration" }, { "target": "com.amazonaws.s3tables#PutTableBucketMetricsConfiguration" }, { "target": "com.amazonaws.s3tables#PutTableBucketStorageClass" } ], "traits": { "aws.api#arn": { "absolute": true, "template": "com.amazonaws.s3tables#TableBucketARN" } } }, "com.amazonaws.s3tables#TableBucketSummary": { "type": "structure", "members": { "arn": { "target": "com.amazonaws.s3tables#TableBucketARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.s3tables#TableBucketName", "traits": { "smithy.api#documentation": "The name of the table bucket.
", "smithy.api#required": {} } }, "ownerAccountId": { "target": "com.amazonaws.s3tables#AccountId", "traits": { "smithy.api#documentation": "The ID of the account that owns the table bucket.
", "smithy.api#required": {} } }, "createdAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The date and time the table bucket was created at.
", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "tableBucketId": { "target": "com.amazonaws.s3tables#TableBucketId", "traits": { "smithy.api#documentation": "The system-assigned unique identifier for the table bucket.
" } }, "type": { "target": "com.amazonaws.s3tables#TableBucketType", "traits": { "smithy.api#documentation": "The type of the table bucket.
" } } }, "traits": { "smithy.api#documentation": "Contains details about a table bucket.
" } }, "com.amazonaws.s3tables#TableBucketSummaryList": { "type": "list", "member": { "target": "com.amazonaws.s3tables#TableBucketSummary" } }, "com.amazonaws.s3tables#TableBucketType": { "type": "enum", "members": { "CUSTOMER": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "customer" } }, "AWS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "aws" } } } }, "com.amazonaws.s3tables#TableEncryptionResource": { "type": "resource", "operations": [ { "target": "com.amazonaws.s3tables#GetTableEncryption" } ], "traits": { "aws.api#arn": { "absolute": true, "template": "com.amazonaws.s3tables#TableARN" } } }, "com.amazonaws.s3tables#TableMaintenanceConfiguration": { "type": "map", "key": { "target": "com.amazonaws.s3tables#TableMaintenanceType" }, "value": { "target": "com.amazonaws.s3tables#TableMaintenanceConfigurationValue" } }, "com.amazonaws.s3tables#TableMaintenanceConfigurationValue": { "type": "structure", "members": { "status": { "target": "com.amazonaws.s3tables#MaintenanceStatus", "traits": { "smithy.api#documentation": "The status of the maintenance configuration.
" } }, "settings": { "target": "com.amazonaws.s3tables#TableMaintenanceSettings", "traits": { "smithy.api#documentation": "Contains details about the settings for the maintenance configuration.
" } } }, "traits": { "smithy.api#documentation": "The values that define a maintenance configuration for a table.
" } }, "com.amazonaws.s3tables#TableMaintenanceJobStatus": { "type": "map", "key": { "target": "com.amazonaws.s3tables#TableMaintenanceJobType" }, "value": { "target": "com.amazonaws.s3tables#TableMaintenanceJobStatusValue" } }, "com.amazonaws.s3tables#TableMaintenanceJobStatusValue": { "type": "structure", "members": { "status": { "target": "com.amazonaws.s3tables#JobStatus", "traits": { "smithy.api#documentation": "The status of the job.
", "smithy.api#required": {} } }, "lastRunTimestamp": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The date and time that the maintenance job was last run.
", "smithy.api#timestampFormat": "date-time" } }, "failureMessage": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The failure message of a failed job.
" } } }, "traits": { "smithy.api#documentation": "Details about the status of a maintenance job.
" } }, "com.amazonaws.s3tables#TableMaintenanceJobType": { "type": "enum", "members": { "ICEBERG_COMPACTION": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "icebergCompaction" } }, "ICEBERG_SNAPSHOT_MANAGEMENT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "icebergSnapshotManagement" } }, "ICEBERG_UNREFERENCED_FILE_REMOVAL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "icebergUnreferencedFileRemoval" } } } }, "com.amazonaws.s3tables#TableMaintenanceSettings": { "type": "union", "members": { "icebergCompaction": { "target": "com.amazonaws.s3tables#IcebergCompactionSettings", "traits": { "smithy.api#documentation": "Contains details about the Iceberg compaction settings for the table.
" } }, "icebergSnapshotManagement": { "target": "com.amazonaws.s3tables#IcebergSnapshotManagementSettings", "traits": { "smithy.api#documentation": "Contains details about the Iceberg snapshot management settings for the table.
" } } }, "traits": { "smithy.api#documentation": "Contains details about maintenance settings for the table.
" } }, "com.amazonaws.s3tables#TableMaintenanceType": { "type": "enum", "members": { "ICEBERG_COMPACTION": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "icebergCompaction" } }, "ICEBERG_SNAPSHOT_MANAGEMENT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "icebergSnapshotManagement" } } } }, "com.amazonaws.s3tables#TableMetadata": { "type": "union", "members": { "iceberg": { "target": "com.amazonaws.s3tables#IcebergMetadata", "traits": { "smithy.api#documentation": "Contains details about the metadata of an Iceberg table.
" } } }, "traits": { "smithy.api#documentation": "Contains details about the table metadata.
" } }, "com.amazonaws.s3tables#TableName": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 255 }, "smithy.api#pattern": "^[0-9a-z_]*$" } }, "com.amazonaws.s3tables#TablePolicyResource": { "type": "resource", "operations": [ { "target": "com.amazonaws.s3tables#DeleteTablePolicy" }, { "target": "com.amazonaws.s3tables#GetTablePolicy" }, { "target": "com.amazonaws.s3tables#PutTablePolicy" } ] }, "com.amazonaws.s3tables#TableProperties": { "type": "map", "key": { "target": "smithy.api#String" }, "value": { "target": "smithy.api#String" } }, "com.amazonaws.s3tables#TableRecordExpirationConfigurationValue": { "type": "structure", "members": { "status": { "target": "com.amazonaws.s3tables#TableRecordExpirationStatus", "traits": { "smithy.api#documentation": "The status of the expiration settings for records in the table.
" } }, "settings": { "target": "com.amazonaws.s3tables#TableRecordExpirationSettings", "traits": { "smithy.api#documentation": "The expiration settings for records in the table.
" } } }, "traits": { "smithy.api#documentation": "The expiration configuration settings for records in a table, and the status of the configuration. If the status of the configuration is enabled, records expire and are automatically removed after the number of days specified in the record expiration settings for the table.
" } }, "com.amazonaws.s3tables#TableRecordExpirationJobMetrics": { "type": "structure", "members": { "deletedDataFiles": { "target": "smithy.api#Long", "traits": { "smithy.api#documentation": "The total number of data files that were removed when the job ran.
" } }, "deletedRecords": { "target": "smithy.api#Long", "traits": { "smithy.api#documentation": "The total number of records that were removed when the job ran.
" } }, "removedFilesSize": { "target": "smithy.api#Long", "traits": { "smithy.api#documentation": "The total size (in bytes) of the data files that were removed when the job ran.
" } } }, "traits": { "smithy.api#documentation": "Provides metrics for the record expiration job that most recently ran for a table. The metrics provide insight into the amount of data that was removed when the job ran.
" } }, "com.amazonaws.s3tables#TableRecordExpirationJobStatus": { "type": "enum", "members": { "NOT_YET_RUN": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "NotYetRun" } }, "SUCCESSFUL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "Successful" } }, "FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "Failed" } }, "DISABLED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "Disabled" } } } }, "com.amazonaws.s3tables#TableRecordExpirationSettings": { "type": "structure", "members": { "days": { "target": "com.amazonaws.s3tables#PositiveInteger", "traits": { "smithy.api#documentation": "If you enable record expiration for a table, you can specify the number of days to retain your table records. For example, to retain your table records for one year, set this value to 365.
The record expiration setting that specifies when records expire and are automatically removed from a table.
" } }, "com.amazonaws.s3tables#TableRecordExpirationStatus": { "type": "enum", "members": { "ENABLED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "enabled" } }, "DISABLED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "disabled" } } } }, "com.amazonaws.s3tables#TableReplicationConfiguration": { "type": "structure", "members": { "role": { "target": "com.amazonaws.s3tables#IAMRole", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the IAM role that S3 Tables assumes to replicate the table on your behalf.
", "smithy.api#required": {} } }, "rules": { "target": "com.amazonaws.s3tables#TableReplicationRules", "traits": { "smithy.api#documentation": "An array of replication rules that define where this table should be replicated.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The replication configuration for an individual table. This configuration defines how the table is replicated to destination tables.
" } }, "com.amazonaws.s3tables#TableReplicationResource": { "type": "resource", "operations": [ { "target": "com.amazonaws.s3tables#DeleteTableReplication" }, { "target": "com.amazonaws.s3tables#DisassociateTableReplication" }, { "target": "com.amazonaws.s3tables#GetTableReplication" }, { "target": "com.amazonaws.s3tables#GetTableReplicationStatus" }, { "target": "com.amazonaws.s3tables#PutTableReplication" } ], "traits": { "aws.api#arn": { "absolute": true, "template": "com.amazonaws.s3tables#TableARN" } } }, "com.amazonaws.s3tables#TableReplicationRule": { "type": "structure", "members": { "destinations": { "target": "com.amazonaws.s3tables#ReplicationDestinations", "traits": { "smithy.api#documentation": "An array of destination table buckets where this table should be replicated.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Defines a rule for replicating a table to one or more destination tables.
" } }, "com.amazonaws.s3tables#TableReplicationRules": { "type": "list", "member": { "target": "com.amazonaws.s3tables#TableReplicationRule" }, "traits": { "smithy.api#length": { "min": 1, "max": 1 } } }, "com.amazonaws.s3tables#TableResource": { "type": "resource", "operations": [ { "target": "com.amazonaws.s3tables#CompleteTableMigration" }, { "target": "com.amazonaws.s3tables#CreateTable" }, { "target": "com.amazonaws.s3tables#DeleteTable" }, { "target": "com.amazonaws.s3tables#GetTable" }, { "target": "com.amazonaws.s3tables#GetTableMaintenanceConfiguration" }, { "target": "com.amazonaws.s3tables#GetTableMaintenanceJobStatus" }, { "target": "com.amazonaws.s3tables#GetTableMetadataLocation" }, { "target": "com.amazonaws.s3tables#GetTableMigration" }, { "target": "com.amazonaws.s3tables#GetTableRecordExpirationConfiguration" }, { "target": "com.amazonaws.s3tables#GetTableRecordExpirationJobStatus" }, { "target": "com.amazonaws.s3tables#GetTableStorageClass" }, { "target": "com.amazonaws.s3tables#ListTableMigrations" }, { "target": "com.amazonaws.s3tables#ListTables" }, { "target": "com.amazonaws.s3tables#PutTableMaintenanceConfiguration" }, { "target": "com.amazonaws.s3tables#PutTableRecordExpirationConfiguration" }, { "target": "com.amazonaws.s3tables#RenameTable" }, { "target": "com.amazonaws.s3tables#StartTableMigration" }, { "target": "com.amazonaws.s3tables#SyncTableMigration" }, { "target": "com.amazonaws.s3tables#UpdateTableMetadataLocation" }, { "target": "com.amazonaws.s3tables#UpdateTableMigration" } ], "traits": { "aws.api#arn": { "absolute": true, "template": "com.amazonaws.s3tables#TableARN" } } }, "com.amazonaws.s3tables#TableSummary": { "type": "structure", "members": { "namespace": { "target": "com.amazonaws.s3tables#NamespaceList", "traits": { "smithy.api#documentation": "The name of the namespace.
", "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name of the table.
", "smithy.api#required": {} } }, "type": { "target": "com.amazonaws.s3tables#TableType", "traits": { "smithy.api#documentation": "The type of the table.
", "smithy.api#required": {} } }, "tableARN": { "target": "com.amazonaws.s3tables#TableARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table.
", "smithy.api#required": {} } }, "createdAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The date and time the table was created at.
", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "modifiedAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The date and time the table was last modified at.
", "smithy.api#required": {}, "smithy.api#timestampFormat": "date-time" } }, "managedByService": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "The Amazon Web Services service managing this table, if applicable. For example, a replicated table is managed by the S3 Tables replication service.
" } }, "namespaceId": { "target": "com.amazonaws.s3tables#NamespaceId", "traits": { "smithy.api#documentation": "The unique identifier for the namespace that contains this table.
" } }, "tableBucketId": { "target": "com.amazonaws.s3tables#TableBucketId", "traits": { "smithy.api#documentation": "The unique identifier for the table bucket that contains this table.
" } } }, "traits": { "smithy.api#documentation": "Contains details about a table.
" } }, "com.amazonaws.s3tables#TableSummaryList": { "type": "list", "member": { "target": "com.amazonaws.s3tables#TableSummary" } }, "com.amazonaws.s3tables#TableType": { "type": "enum", "members": { "CUSTOMER": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "customer" } }, "AWS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "aws" } } } }, "com.amazonaws.s3tables#TagKey": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 128 } } }, "com.amazonaws.s3tables#TagKeyList": { "type": "list", "member": { "target": "com.amazonaws.s3tables#TagKey" } }, "com.amazonaws.s3tables#TagResource": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#TagResourceRequest" }, "output": { "target": "com.amazonaws.s3tables#TagResourceResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Applies one or more user-defined tags to an Amazon S3 Tables resource or updates existing tags. Each tag is a label consisting of a key and value pair. Tags can help you organize, track costs for, and control access to your resources. You can add up to 50 tags for each S3 resource.
For a list of S3 resources that support tagging, see Managing tags for Amazon S3 resources.
For tables and table buckets, you must have the s3tables:TagResource permission to use this operation.
The Amazon Resource Name (ARN) of the Amazon S3 Tables resource that you're applying tags to. The tagged resource can be a table bucket or a table. For a list of all S3 resources that support tagging, see Managing tags for Amazon S3 resources.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "tags": { "target": "com.amazonaws.s3tables#Tags", "traits": { "smithy.api#documentation": "The user-defined tag that you want to add to the specified S3 Tables resource. For more information, see Tagging for cost allocation or attribute-based access control (ABAC).
", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#TagResourceResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#TagValue": { "type": "string", "traits": { "smithy.api#length": { "min": 0, "max": 256 } } }, "com.amazonaws.s3tables#Tags": { "type": "map", "key": { "target": "com.amazonaws.s3tables#TagKey" }, "value": { "target": "com.amazonaws.s3tables#TagValue" } }, "com.amazonaws.s3tables#TargetObjectKeyFormat": { "type": "structure", "members": { "partitionedPrefix": { "target": "com.amazonaws.s3tables#PartitionedPrefix", "traits": { "smithy.api#documentation": "Partitions log object keys by date.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The key format of the log objects. Only partitionedPrefix is supported.
The limit on the number of requests per second was exceeded.
", "smithy.api#error": "client", "smithy.api#httpError": 429 } }, "com.amazonaws.s3tables#UnmatchedSourceFieldsPolicy": { "type": "enum", "members": { "FAIL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "fail" } }, "DROP": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "drop" } } } }, "com.amazonaws.s3tables#UntagResource": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#UntagResourceRequest" }, "output": { "target": "com.amazonaws.s3tables#UntagResourceResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Removes the specified user-defined tags from an Amazon S3 Tables resource. You can pass one or more tag keys.
For a list of S3 resources that support tagging, see Managing tags for Amazon S3 resources.
For tables and table buckets, you must have the s3tables:UntagResource permission to use this operation.
The Amazon Resource Name (ARN) of the Amazon S3 Tables resource that you're removing tags from. The tagged resource can be a table bucket or a table. For a list of all S3 resources that support tagging, see Managing tags for Amazon S3 resources.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "tagKeys": { "target": "com.amazonaws.s3tables#TagKeyList", "traits": { "smithy.api#documentation": "The array of tag keys that you're removing from the S3 Tables resource. For more information, see Tagging for cost allocation or attribute-based access control (ABAC).
", "smithy.api#httpQuery": "tagKeys", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#UntagResourceResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#UpdateTableMetadataLocation": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#UpdateTableMetadataLocationRequest" }, "output": { "target": "com.amazonaws.s3tables#UpdateTableMetadataLocationResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Updates the metadata location for a table. The metadata location of a table must be an S3 URI that begins with the table's warehouse location. The metadata location for an Apache Iceberg table must end with .metadata.json, or if the metadata file is Gzip-compressed, .metadata.json.gz.
You must have the s3tables:UpdateTableMetadataLocation permission to use this operation.
The Amazon Resource Name (ARN) of the table bucket.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceName", "traits": { "smithy.api#documentation": "The namespace of the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name of the table.
", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "versionToken": { "target": "com.amazonaws.s3tables#VersionToken", "traits": { "smithy.api#documentation": "The version token of the table.
", "smithy.api#required": {} } }, "metadataLocation": { "target": "com.amazonaws.s3tables#MetadataLocation", "traits": { "smithy.api#documentation": "The new metadata location for the table.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.s3tables#UpdateTableMetadataLocationResponse": { "type": "structure", "members": { "name": { "target": "com.amazonaws.s3tables#TableName", "traits": { "smithy.api#documentation": "The name of the table.
", "smithy.api#required": {} } }, "tableARN": { "target": "com.amazonaws.s3tables#TableARN", "traits": { "smithy.api#documentation": "The Amazon Resource Name (ARN) of the table.
", "smithy.api#required": {} } }, "namespace": { "target": "com.amazonaws.s3tables#NamespaceList", "traits": { "smithy.api#documentation": "The namespace the table is associated with.
", "smithy.api#required": {} } }, "versionToken": { "target": "com.amazonaws.s3tables#VersionToken", "traits": { "smithy.api#documentation": "The version token of the table.
", "smithy.api#required": {} } }, "metadataLocation": { "target": "com.amazonaws.s3tables#MetadataLocation", "traits": { "smithy.api#documentation": "The metadata location of the table.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#UpdateTableMigration": { "type": "operation", "input": { "target": "com.amazonaws.s3tables#UpdateTableMigrationRequest" }, "output": { "target": "com.amazonaws.s3tables#UpdateTableMigrationResponse" }, "errors": [ { "target": "com.amazonaws.s3tables#AccessDeniedException" }, { "target": "com.amazonaws.s3tables#BadRequestException" }, { "target": "com.amazonaws.s3tables#ConflictException" }, { "target": "com.amazonaws.s3tables#ForbiddenException" }, { "target": "com.amazonaws.s3tables#InternalServerErrorException" }, { "target": "com.amazonaws.s3tables#NotFoundException" }, { "target": "com.amazonaws.s3tables#TooManyRequestsException" } ], "traits": { "smithy.api#documentation": "Requests a state change for a migration. Identify the migration by its migrationId or by the tableARN of its destination table.
Set requestedState to queued to continue a migration in the pendingReview state; the migration moves to queued or migrating. Set it to cancelled to cancel a migration in the new, planning, pendingReview, queued or migrating state; the migration moves to cancelling, finishes the work in progress, and then ends in the cancelled state, or in the failed state if any objects failed to migrate. Data that the migration already committed stays in the destination table.
You must have the s3tables:UpdateTableMigration permission to use this operation.
The Amazon Resource Name (ARN) of the destination table. Updates the table's most recent migration. Until the migration creates the destination table, specify migrationId. Specify either tableARN or migrationId, not both.
The ID of the migration to update. Specify either migrationId or tableARN, not both.
The state to move the migration to: queued to continue a migration in the pendingReview state, or cancelled to cancel a migration in the new, planning, pendingReview, queued or migrating state.
A description of the update, up to 1,024 characters, with no control characters. GetTableMigration doesn't return it.
The ID of the migration.
", "smithy.api#required": {} } }, "state": { "target": "com.amazonaws.s3tables#MigrationState", "traits": { "smithy.api#documentation": "The state of the migration after the update, such as queued, migrating or cancelling.
The Amazon Resource Name (ARN) of the destination table.
" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.s3tables#VersionToken": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 2048 } } }, "com.amazonaws.s3tables#WarehouseLocation": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 2048 } } } } }