AWS cli documentation change
Summary
Updated AWS CLI version reference from 2.35.3 to 2.35.5. Added extensive documentation for Iceberg table metadata including format version, schemas, partition specifications, sort orders, and field definitions. Clarified document type handling requirements.
Security assessment
The changes primarily document new Iceberg table metadata capabilities without mentioning security vulnerabilities, fixes, or security features. Added constraints on field patterns appear to be standard data validation, not security mitigations. No evidence of addressing specific security weaknesses.
Diff
diff --git a/cli/latest/reference/glue/get-tables.md b/cli/latest/reference/glue/get-tables.md index eb85edcaf..1d553bfc4 100644 --- a//cli/latest/reference/glue/get-tables.md +++ b//cli/latest/reference/glue/get-tables.md @@ -15 +15 @@ - * [AWS CLI 2.35.3 Command Reference](../../index.html) » + * [AWS CLI 2.35.5 Command Reference](../../index.html) » @@ -63,0 +64,2 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/glue-2 +`get-tables` uses document type values. Document types follow the JSON data model where valid values are: strings, numbers, booleans, null, arrays, and objects. For command input, options and nested parameters that are labeled with the type `document` must be provided as JSON. Shorthand syntax does not support document types. + @@ -78 +79,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/glue-2 - [--cli-input-json | --cli-input-yaml] @@ -81,0 +83 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/glue-2 + [--cli-input-json | --cli-input-yaml] @@ -227,0 +230,2 @@ JSON Syntax: +>> * `DEFAULT` +>> * `LATEST_ICEBERG_METADATA` @@ -237,2 +240,0 @@ Syntax: -`--cli-input-json` | `--cli-input-yaml` (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by `--generate-cli-skeleton`. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with `--cli-input-yaml`. - @@ -256,0 +259,2 @@ Syntax: +`--cli-input-json` | `--cli-input-yaml` (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by `--generate-cli-skeleton`. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with `--cli-input-yaml`. + @@ -1392,0 +1397,240 @@ TableList -> (list) +>> IcebergTableMetadata -> (structure) +>> +>>> The latest Apache Iceberg table metadata for the table, including format version, schemas, partition specifications, and sort orders. This field is populated for Iceberg tables and reflects the current state of the table’s Iceberg metadata. +>>> +>>> FormatVersion -> (string) +>>> +>>>> The Apache Iceberg table format version, such as `1` or `2` . Determines the set of features and on-disk layout supported by the table. +>>>> +>>>> Constraints: +>>>> +>>>> * min: `1` +>>>> * max: `255` +>>>> * pattern: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\t]*` +>>>> + +>>> +>>> TableUuid -> (string) +>>> +>>>> The unique identifier (UUID) for the Iceberg table, assigned when the table is created and used to track the table across metadata updates. +>>>> +>>>> Constraints: +>>>> +>>>> * max: `100` +>>>> * pattern: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\t]*` +>>>> + +>>> +>>> Location -> (string) +>>> +>>>> The base S3 location where the Iceberg table’s data and metadata files are stored. +>>>> +>>>> Constraints: +>>>> +>>>> * max: `2056` +>>>> * pattern: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*` +>>>> + +>>> +>>> Properties -> (map) +>>> +>>>> A map of key-value pairs that define table-level properties and configuration settings for the Iceberg table. +>>>> +>>>> key -> (string) +>>>> +>>>> value -> (string) +>>> +>>> Schemas -> (list) +>>> +>>>> The list of schemas that have been associated with the Iceberg table over its history, supporting schema evolution. +>>>> +>>>> (structure) +>>>> +>>>>> Defines the schema structure for an Iceberg table, including field definitions, data types, and schema metadata. +>>>>> +>>>>> SchemaId -> (integer) +>>>>> +>>>>>> The unique identifier for this schema version within the Iceberg table’s schema evolution history. +>>>>> +>>>>> IdentifierFieldIds -> (list) +>>>>> +>>>>>> The list of field identifiers that uniquely identify records in the table, used for row-level operations and deduplication. +>>>>>> +>>>>>> (integer) +>>>>> +>>>>> Type -> (string) +>>>>> +>>>>>> The root type of the schema structure, typically “struct” for Iceberg table schemas. +>>>>>> +>>>>>> Possible values: +>>>>>> +>>>>>> * `struct` +>>>>>> + +>>>>> +>>>>> Fields -> (list) [required] +>>>>> +>>>>>> The list of field definitions that make up the table schema, including field names, types, and metadata. +>>>>>> +>>>>>> (structure) +>>>>>> +>>>>>>> Defines a single field within an Iceberg table schema, including its identifier, name, data type, nullability, and documentation. +>>>>>>> +>>>>>>> Id -> (integer) [required] +>>>>>>> +>>>>>>>> The unique identifier assigned to this field within the Iceberg table schema, used for schema evolution and field tracking. +>>>>>>> +>>>>>>> Name -> (string) [required] +>>>>>>> +>>>>>>>> The name of the field as it appears in the table schema and query operations. +>>>>>>>> +>>>>>>>> Constraints: +>>>>>>>> +>>>>>>>> * min: `1` +>>>>>>>> * max: `1024` +>>>>>>>> * pattern: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\t]*` +>>>>>>>> + +>>>>>>> +>>>>>>> Type -> (document) [required] +>>>>>>> +>>>>>>>> The data type definition for this field, specifying the structure and format of the data it contains. +>>>>>>> +>>>>>>> Required -> (boolean) [required] +>>>>>>> +>>>>>>>> Indicates whether this field is required (non-nullable) or optional (nullable) in the table schema. +>>>>>>> +>>>>>>> Doc -> (string) +>>>>>>> +>>>>>>>> Optional documentation or description text that provides additional context about the purpose and usage of this field. +>>>>>>>> +>>>>>>>> Constraints: +>>>>>>>> +>>>>>>>> * min: `0` +>>>>>>>> * max: `255` +>>>>>>>> * pattern: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\t]*` +>>>>>>>> + +>>>>>>> +>>>>>>> InitialDefault -> (document) +>>>>>>> +>>>>>>>> Default value used to populate the field’s value for all records that were written before the field was added to the schema. This enables backward compatibility when adding new fields to existing Iceberg tables. +>>>>>>> +>>>>>>> WriteDefault -> (document) +>>>>>>> +>>>>>>>> Default value used to populate the field’s value for any records written after the field was added to the schema, if the writer does not supply the field’s value. This can be changed through schema evolution. +>>> +>>> CurrentSchemaId -> (integer) +>>> +>>>> The identifier of the schema that is currently active for the Iceberg table. Matches an entry in `Schemas` . +>>> +>>> LastColumnId -> (integer) +>>> +>>>> The highest column identifier that has been assigned in the Iceberg table’s schema, used to ensure unique IDs as new columns are added. +>>> +>>> PartitionSpecs -> (list) +>>> +>>>> The list of partition specifications that have been associated with the Iceberg table over its history, supporting partition evolution. +>>>> +>>>> (structure) +>>>> +>>>>> Defines the partitioning specification for an Iceberg table, determining how table data will be organized and partitioned for optimal query performance. +>>>>> +>>>>> Fields -> (list) [required] +>>>>> +>>>>>> The list of partition fields that define how the table data should be partitioned, including source fields and their transformations. +>>>>>> +>>>>>> (structure) +>>>>>> +>>>>>>> Defines a single partition field within an Iceberg partition specification, including the source field, transformation function, partition name, and unique identifier. +>>>>>>> +>>>>>>> SourceId -> (integer) [required] +>>>>>>> +>>>>>>>> The identifier of the source field from the table schema that this partition field is based on. +>>>>>>> +>>>>>>> Transform -> (string) [required] +>>>>>>> +>>>>>>>> The transformation function applied to the source field to create the partition, such as identity, bucket, truncate, year, month, day, or hour. +>>>>>>> +>>>>>>> Name -> (string) [required] +>>>>>>> +>>>>>>>> The name of the partition field as it will appear in the partitioned table structure. +>>>>>>>> +>>>>>>>> Constraints: +>>>>>>>> +>>>>>>>> * min: `1` +>>>>>>>> * max: `1024` +>>>>>>>> * pattern: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\t]*` +>>>>>>>> + +>>>>>>> +>>>>>>> FieldId -> (integer) +>>>>>>> +>>>>>>>> The unique identifier assigned to this partition field within the Iceberg table’s partition specification. +>>>>> +>>>>> SpecId -> (integer) +>>>>>