S3 Tables

5 resource kinds. Generated from the operator's CRD schemas.

API Group: aws.konfig.io/v1alpha1

S3TablesNamespace # CLOUD CONTROL · AWS::S3Tables::Namespace

S3TablesNamespace manages AWS::S3Tables::Namespace through the AWS Cloud Control API.

kubectl get s3tablesnamespaces · example on GitHub

Example

# S3TablesNamespace — S3 Tables
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/s3tables.html#s3tablesnamespace
apiVersion: aws.konfig.io/v1alpha1
kind: S3TablesNamespace
metadata:
  name: example-s3tablesnamespace
  namespace: default
spec:
  namespace: example
  providerRef:
    name: example-s3tablesnamespace
    region: us-east-1
  tableBucketARN: arn:aws:iam::123456789012:role/example-role

Spec

FieldTypeRequiredDescription
namespacestringyesCreate-only in AWS: changing it requires replacing the resource.
providerRefobject—ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
providerRef.namestringyesName of a cluster-scoped AWSProvider.
providerRef.regionstring—Region overrides the provider's region for this resource only.
tableBucketARNstringyesCreate-only in AWS: changing it requires replacing the resource.

Status

FieldTypeRequiredDescription
attemptinteger—Attempt counts failed create/delete requests; it salts the Cloud Control idempotency token so a retry is not served the cached failure.
awsProviderobject—AWSProvider confirms the account and region this resource was reconciled against.
awsProvider.accountIdstring—AccountID the resource lives in.
awsProvider.namestring—Name of the AWSProvider used; empty when the operator's own credentials were used.
awsProvider.regionstring—Region the resource lives in (empty for global services).
conditionsarray<object>—Conditions describe the current state of the resource.
conditions[].lastTransitionTimestringyeslastTransitionTime is the last time the condition transitioned from one status to another.
conditions[].messagestringyesmessage is a human readable message indicating details about the transition.
conditions[].observedGenerationinteger—observedGeneration represents the .metadata.generation that the condition was set based upon.
conditions[].reasonstringyesreason contains a programmatic identifier indicating the reason for the condition's last transition.
conditions[].statusenumyesstatus of the condition, one of True, False, Unknown. Allowed: True, False, Unknown
conditions[].typestringyestype of condition in CamelCase or in foo.example.com/CamelCase.
identifierstring—Identifier is the Cloud Control primary identifier of the resource.
lastSyncTimestring—
observedGenerationinteger—
operationstring—Operation is the in-flight operation (CREATE, UPDATE, DELETE).
operationStatusstring—OperationStatus is the last reported operation status.
requestTokenstring—RequestToken tracks an in-flight asynchronous operation.

S3TablesTable # CLOUD CONTROL · AWS::S3Tables::Table

S3TablesTable manages AWS::S3Tables::Table through the AWS Cloud Control API.

kubectl get s3tablestables · example on GitHub

Example

# S3TablesTable — S3 Tables
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/s3tables.html#s3tablestable
apiVersion: aws.konfig.io/v1alpha1
kind: S3TablesTable
metadata:
  name: example-s3tablestable
  namespace: default
spec:
  compaction:
    status: enabled
    targetFileSizeMB: 64
  icebergMetadata:
    icebergPartitionSpec:
      fields:
      - fieldId: 1
        name: example-s3tablestable
        sourceId: 1
        transform: example
      specId: 1
    icebergSchema:
      schemaFieldList:
      - id: 1
        name: example-s3tablestable
        required: false
        type: example
    icebergSchemaV2:
      identifierFieldIds:
      - 1
      schemaId: 1
      schemaV2FieldList:
      - doc: example
        id: 1
        name: example-s3tablestable
        required: false
      schemaV2FieldType: struct
    icebergSortOrder:
      fields:
      - direction: asc
        nullOrder: nulls-first
        sourceId: 1
        transform: example
      orderId: 1
    tableProperties:
      key: value
  namespace: example
  openTableFormat: ICEBERG
  providerRef:
    name: example-s3tablestable
    region: us-east-1
  snapshotManagement:
    maxSnapshotAgeHours: 1
    minSnapshotsToKeep: 1
    status: enabled
  storageClassConfiguration:
    storageClass: STANDARD
  tableBucketARN: arn:aws:iam::123456789012:role/example-role
  tableName: example-s3tablestable
  tags:
  - key: example
    value: example
  withoutMetadata: 'Yes'

Spec

FieldTypeRequiredDescription
compactionobject—S3TablesTableCompaction is a nested property type of AWS::S3Tables::Table.
compaction.statusenum—Indicates whether the Compaction maintenance action is enabled. Allowed: enabled, disabled
compaction.targetFileSizeMBinteger—The target file size for the table in MB.
icebergMetadataobject—Create-only in AWS: changing it requires replacing the resource.
icebergMetadata.icebergPartitionSpecobject—S3TablesTableIcebergPartitionSpec is a nested property type of AWS::S3Tables::Table.
icebergMetadata.icebergPartitionSpec.fieldsarray<object>yesList of partition fields
icebergMetadata.icebergPartitionSpec.fields[].fieldIdinteger—The partition field ID (auto-assigned starting from 1000 if not specified)
icebergMetadata.icebergPartitionSpec.fields[].namestringyesThe name of the partition field
icebergMetadata.icebergPartitionSpec.fields[].sourceIdintegeryesThe source column ID to partition on
icebergMetadata.icebergPartitionSpec.fields[].transformstringyesThe partition transform function (identity, bucket[N], truncate[N], year, month, day, hour)
icebergMetadata.icebergPartitionSpec.specIdinteger—The partition spec ID (defaults to 0 if not specified)
icebergMetadata.icebergSchemaobject—Schema definition for flat tables with primitive types only.
icebergMetadata.icebergSchema.schemaFieldListarray<object>yes
icebergMetadata.icebergSchema.schemaFieldList[].idinteger—The unique identifier for the field
icebergMetadata.icebergSchema.schemaFieldList[].namestringyesThe name of the field
icebergMetadata.icebergSchema.schemaFieldList[].requiredboolean—A Boolean value that specifies whether values are required for each row in this field
icebergMetadata.icebergSchema.schemaFieldList[].typestringyesThe field type
icebergMetadata.icebergSchemaV2object—Schema definition that supports Apache Iceberg nested types (struct, list, map) and primitive types.
icebergMetadata.icebergSchemaV2.identifierFieldIdsarray<integer>—A list of field IDs that are used as the identifier fields for the table.
icebergMetadata.icebergSchemaV2.schemaIdinteger—An optional unique identifier for the schema
icebergMetadata.icebergSchemaV2.schemaV2FieldListarray<object>yesThe schema fields for the table
icebergMetadata.icebergSchemaV2.schemaV2FieldList[].docstring—Optional documentation for the field
icebergMetadata.icebergSchemaV2.schemaV2FieldList[].idintegeryesThe unique identifier for the field
icebergMetadata.icebergSchemaV2.schemaV2FieldList[].namestringyesThe name of the field
icebergMetadata.icebergSchemaV2.schemaV2FieldList[].requiredbooleanyesA Boolean value that specifies whether values are required for each row in this field
icebergMetadata.icebergSchemaV2.schemaV2FieldList[].typeobjectyesThe field type.
icebergMetadata.icebergSchemaV2.schemaV2FieldTypeenumyesThe type of the top-level schema, which is always 'struct' Allowed: struct
icebergMetadata.icebergSortOrderobject—S3TablesTableIcebergSortOrder is a nested property type of AWS::S3Tables::Table.
icebergMetadata.icebergSortOrder.fieldsarray<object>yesList of sort fields
icebergMetadata.icebergSortOrder.fields[].directionenumyesSort direction (asc or desc) Allowed: asc, desc
icebergMetadata.icebergSortOrder.fields[].nullOrderenumyesNull value ordering (nulls-first or nulls-last) Allowed: nulls-first, nulls-last
icebergMetadata.icebergSortOrder.fields[].sourceIdintegeryesThe source column ID to sort on
icebergMetadata.icebergSortOrder.fields[].transformstringyesThe sort transform function
icebergMetadata.icebergSortOrder.orderIdinteger—The sort order ID (defaults to 1 if not specified, 0 is reserved for unsorted)
icebergMetadata.tablePropertiesmap<string>—
namespacestringyes
openTableFormatenumyesCreate-only in AWS: changing it requires replacing the resource. Allowed: ICEBERG
providerRefobject—ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
providerRef.namestringyesName of a cluster-scoped AWSProvider.
providerRef.regionstring—Region overrides the provider's region for this resource only.
snapshotManagementobject—S3TablesTableSnapshotManagement is a nested property type of AWS::S3Tables::Table.
snapshotManagement.maxSnapshotAgeHoursinteger—The maximum age of a snapshot before it can be expired.
snapshotManagement.minSnapshotsToKeepinteger—The minimum number of snapshots to keep.
snapshotManagement.statusenum—Indicates whether the SnapshotManagement maintenance action is enabled. Allowed: enabled, disabled
storageClassConfigurationobject—Create-only in AWS: changing it requires replacing the resource.
storageClassConfiguration.storageClassenum—The storage class for the table Allowed: STANDARD, INTELLIGENT_TIERING
tableBucketARNstringyesCreate-only in AWS: changing it requires replacing the resource.
tableNamestringyes
tagsarray<object>—User tags (key-value pairs) to associate with the table.
tags[].keystringyes
tags[].valuestringyes
withoutMetadataenum—Create-only in AWS: changing it requires replacing the resource. Allowed: Yes

Status

FieldTypeRequiredDescription
attemptinteger—Attempt counts failed create/delete requests; it salts the Cloud Control idempotency token so a retry is not served the cached failure.
awsProviderobject—AWSProvider confirms the account and region this resource was reconciled against.
awsProvider.accountIdstring—AccountID the resource lives in.
awsProvider.namestring—Name of the AWSProvider used; empty when the operator's own credentials were used.
awsProvider.regionstring—Region the resource lives in (empty for global services).
conditionsarray<object>—Conditions describe the current state of the resource.
conditions[].lastTransitionTimestringyeslastTransitionTime is the last time the condition transitioned from one status to another.
conditions[].messagestringyesmessage is a human readable message indicating details about the transition.
conditions[].observedGenerationinteger—observedGeneration represents the .metadata.generation that the condition was set based upon.
conditions[].reasonstringyesreason contains a programmatic identifier indicating the reason for the condition's last transition.
conditions[].statusenumyesstatus of the condition, one of True, False, Unknown. Allowed: True, False, Unknown
conditions[].typestringyestype of condition in CamelCase or in foo.example.com/CamelCase.
identifierstring—Identifier is the Cloud Control primary identifier of the resource.
lastSyncTimestring—
observedGenerationinteger—
operationstring—Operation is the in-flight operation (CREATE, UPDATE, DELETE).
operationStatusstring—OperationStatus is the last reported operation status.
requestTokenstring—RequestToken tracks an in-flight asynchronous operation.
tableARNstring—Read-only: reported by AWS after creation.
versionTokenstring—Read-only: reported by AWS after creation.
warehouseLocationstring—Read-only: reported by AWS after creation.

S3TablesTableBucket # CLOUD CONTROL · AWS::S3Tables::TableBucket

S3TablesTableBucket manages AWS::S3Tables::TableBucket through the AWS Cloud Control API.

kubectl get s3tablestablebuckets · example on GitHub

Example

# S3TablesTableBucket — S3 Tables
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/s3tables.html#s3tablestablebucket
apiVersion: aws.konfig.io/v1alpha1
kind: S3TablesTableBucket
metadata:
  name: example-s3tablestablebucket
  namespace: default
spec:
  encryptionConfiguration:
    kmsKeyArn: arn:aws:iam::123456789012:role/example-role
    sseAlgorithm: example
  metricsConfiguration:
    status: Enabled
  providerRef:
    name: example-s3tablestablebucket
    region: us-east-1
  replicationConfiguration:
    role: example
    rules:
    - destinations:
      - destinationTableBucketARN: arn:aws:iam::123456789012:role/example-role
  storageClassConfiguration:
    storageClass: STANDARD
  tableBucketName: example-s3tablestablebucket
  tags:
  - key: example
    value: example
  unreferencedFileRemoval:
    noncurrentDays: 1
    status: Enabled
    unreferencedDays: 1

Spec

FieldTypeRequiredDescription
encryptionConfigurationobject—S3TablesTableBucketEncryptionConfiguration is a nested property type of AWS::S3Tables::TableBucket.
encryptionConfiguration.kmsKeyArnstring—ARN of the KMS key to use for encryption
encryptionConfiguration.sseAlgorithmstring—Server-side encryption algorithm
metricsConfigurationobject—S3TablesTableBucketMetricsConfiguration is a nested property type of AWS::S3Tables::TableBucket.
metricsConfiguration.statusenum—Indicates whether Metrics are enabled. Allowed: Enabled, Disabled
providerRefobject—ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
providerRef.namestringyesName of a cluster-scoped AWSProvider.
providerRef.regionstring—Region overrides the provider's region for this resource only.
replicationConfigurationobject—S3TablesTableBucketReplicationConfiguration is a nested property type of AWS::S3Tables::TableBucket.
replicationConfiguration.rolestringyesThe ARN of the IAM role to use for replication
replicationConfiguration.rulesarray<object>yesList of replication rules
replicationConfiguration.rules[].destinationsarray<object>yesList of replication destinations
replicationConfiguration.rules[].destinations[].destinationTableBucketARNstringyesThe ARN of the destination table bucket
storageClassConfigurationobject—S3TablesTableBucketStorageClassConfiguration is a nested property type of AWS::S3Tables::TableBucket.
storageClassConfiguration.storageClassenum—The storage class for the table bucket Allowed: STANDARD, INTELLIGENT_TIERING
tableBucketNamestringyesCreate-only in AWS: changing it requires replacing the resource.
tagsarray<object>—User tags (key-value pairs) to associate with the table bucket.
tags[].keystringyes
tags[].valuestringyes
unreferencedFileRemovalobject—S3TablesTableBucketUnreferencedFileRemoval is a nested property type of AWS::S3Tables::TableBucket.
unreferencedFileRemoval.noncurrentDaysinteger—S3 permanently deletes noncurrent objects after the number of days specified by the NoncurrentDays property.
unreferencedFileRemoval.statusenum—Indicates whether the Unreferenced File Removal maintenance action is enabled. Allowed: Enabled, Disabled
unreferencedFileRemoval.unreferencedDaysinteger—For any object not referenced by your table and older than the UnreferencedDays property, S3 creates a delete marker and marks the object version as noncurrent.

Status

FieldTypeRequiredDescription
attemptinteger—Attempt counts failed create/delete requests; it salts the Cloud Control idempotency token so a retry is not served the cached failure.
awsProviderobject—AWSProvider confirms the account and region this resource was reconciled against.
awsProvider.accountIdstring—AccountID the resource lives in.
awsProvider.namestring—Name of the AWSProvider used; empty when the operator's own credentials were used.
awsProvider.regionstring—Region the resource lives in (empty for global services).
conditionsarray<object>—Conditions describe the current state of the resource.
conditions[].lastTransitionTimestringyeslastTransitionTime is the last time the condition transitioned from one status to another.
conditions[].messagestringyesmessage is a human readable message indicating details about the transition.
conditions[].observedGenerationinteger—observedGeneration represents the .metadata.generation that the condition was set based upon.
conditions[].reasonstringyesreason contains a programmatic identifier indicating the reason for the condition's last transition.
conditions[].statusenumyesstatus of the condition, one of True, False, Unknown. Allowed: True, False, Unknown
conditions[].typestringyestype of condition in CamelCase or in foo.example.com/CamelCase.
identifierstring—Identifier is the Cloud Control primary identifier of the resource.
lastSyncTimestring—
observedGenerationinteger—
operationstring—Operation is the in-flight operation (CREATE, UPDATE, DELETE).
operationStatusstring—OperationStatus is the last reported operation status.
requestTokenstring—RequestToken tracks an in-flight asynchronous operation.
tableBucketARNstring—Read-only: reported by AWS after creation.

S3TablesTableBucketPolicy # CLOUD CONTROL · AWS::S3Tables::TableBucketPolicy

S3TablesTableBucketPolicy manages AWS::S3Tables::TableBucketPolicy through the AWS Cloud Control API.

kubectl get s3tablestablebucketpolicies · example on GitHub

Example

# S3TablesTableBucketPolicy — S3 Tables
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/s3tables.html#s3tablestablebucketpolicy
apiVersion: aws.konfig.io/v1alpha1
kind: S3TablesTableBucketPolicy
metadata:
  name: example-s3tablestablebucketpolicy
  namespace: default
spec:
  providerRef:
    name: example-s3tablestablebucketpolicy
    region: us-east-1
  tableBucketARN: arn:aws:iam::123456789012:role/example-role

Spec

FieldTypeRequiredDescription
providerRefobject—ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
providerRef.namestringyesName of a cluster-scoped AWSProvider.
providerRef.regionstring—Region overrides the provider's region for this resource only.
resourcePolicyobjectyes
tableBucketARNstringyesCreate-only in AWS: changing it requires replacing the resource.

Status

FieldTypeRequiredDescription
attemptinteger—Attempt counts failed create/delete requests; it salts the Cloud Control idempotency token so a retry is not served the cached failure.
awsProviderobject—AWSProvider confirms the account and region this resource was reconciled against.
awsProvider.accountIdstring—AccountID the resource lives in.
awsProvider.namestring—Name of the AWSProvider used; empty when the operator's own credentials were used.
awsProvider.regionstring—Region the resource lives in (empty for global services).
conditionsarray<object>—Conditions describe the current state of the resource.
conditions[].lastTransitionTimestringyeslastTransitionTime is the last time the condition transitioned from one status to another.
conditions[].messagestringyesmessage is a human readable message indicating details about the transition.
conditions[].observedGenerationinteger—observedGeneration represents the .metadata.generation that the condition was set based upon.
conditions[].reasonstringyesreason contains a programmatic identifier indicating the reason for the condition's last transition.
conditions[].statusenumyesstatus of the condition, one of True, False, Unknown. Allowed: True, False, Unknown
conditions[].typestringyestype of condition in CamelCase or in foo.example.com/CamelCase.
identifierstring—Identifier is the Cloud Control primary identifier of the resource.
lastSyncTimestring—
observedGenerationinteger—
operationstring—Operation is the in-flight operation (CREATE, UPDATE, DELETE).
operationStatusstring—OperationStatus is the last reported operation status.
requestTokenstring—RequestToken tracks an in-flight asynchronous operation.

S3TablesTablePolicy # CLOUD CONTROL · AWS::S3Tables::TablePolicy

S3TablesTablePolicy manages AWS::S3Tables::TablePolicy through the AWS Cloud Control API.

kubectl get s3tablestablepolicies · example on GitHub

Example

# S3TablesTablePolicy — S3 Tables
# Full-options example generated from the CRD schema. Optional fields are
# included with sample values; delete what you don't need. Field reference:
# https://konfig-konector.io/docs/s3tables.html#s3tablestablepolicy
apiVersion: aws.konfig.io/v1alpha1
kind: S3TablesTablePolicy
metadata:
  name: example-s3tablestablepolicy
  namespace: default
spec:
  providerRef:
    name: example-s3tablestablepolicy
    region: us-east-1
  tableARN: arn:aws:iam::123456789012:role/example-role

Spec

FieldTypeRequiredDescription
providerRefobject—ProviderRef selects the AWSProvider (account/region) this resource is reconciled against.
providerRef.namestringyesName of a cluster-scoped AWSProvider.
providerRef.regionstring—Region overrides the provider's region for this resource only.
resourcePolicyobjectyes
tableARNstringyesCreate-only in AWS: changing it requires replacing the resource.

Status

FieldTypeRequiredDescription
attemptinteger—Attempt counts failed create/delete requests; it salts the Cloud Control idempotency token so a retry is not served the cached failure.
awsProviderobject—AWSProvider confirms the account and region this resource was reconciled against.
awsProvider.accountIdstring—AccountID the resource lives in.
awsProvider.namestring—Name of the AWSProvider used; empty when the operator's own credentials were used.
awsProvider.regionstring—Region the resource lives in (empty for global services).
conditionsarray<object>—Conditions describe the current state of the resource.
conditions[].lastTransitionTimestringyeslastTransitionTime is the last time the condition transitioned from one status to another.
conditions[].messagestringyesmessage is a human readable message indicating details about the transition.
conditions[].observedGenerationinteger—observedGeneration represents the .metadata.generation that the condition was set based upon.
conditions[].reasonstringyesreason contains a programmatic identifier indicating the reason for the condition's last transition.
conditions[].statusenumyesstatus of the condition, one of True, False, Unknown. Allowed: True, False, Unknown
conditions[].typestringyestype of condition in CamelCase or in foo.example.com/CamelCase.
identifierstring—Identifier is the Cloud Control primary identifier of the resource.
lastSyncTimestring—
namespacestring—Read-only: reported by AWS after creation.
observedGenerationinteger—
operationstring—Operation is the in-flight operation (CREATE, UPDATE, DELETE).
operationStatusstring—OperationStatus is the last reported operation status.
requestTokenstring—RequestToken tracks an in-flight asynchronous operation.
tableBucketARNstring—Read-only: reported by AWS after creation.
tableNamestring—Read-only: reported by AWS after creation.