AWS cli documentation change

Service: cli · 2026-05-19 · Documentation low

File: cli/latest/reference/quicksight/create-data-set.md

Summary

Added documentation for SemanticMetadata structure including column-level metadata (ColumnNames, ColumnProperties) and dataset-level metadata (Description, CustomInstructions). Updated AWS CLI version reference from 2.34.48 to 2.34.49.

Security assessment

The changes introduce new semantic metadata fields for data preparation and consumption guidance, but contain no references to security vulnerabilities, access controls, encryption, or authentication. The additions focus on data categorization (geographical roles) and usage instructions without security context.

Diff

diff --git a/cli/latest/reference/quicksight/create-data-set.md b/cli/latest/reference/quicksight/create-data-set.md
index 7c8f72a40..8c2c23c18 100644
--- a//cli/latest/reference/quicksight/create-data-set.md
+++ b//cli/latest/reference/quicksight/create-data-set.md
@@ -15 +15 @@
-  * [AWS CLI 2.34.48 Command Reference](../../index.html) »
+  * [AWS CLI 2.34.49 Command Reference](../../index.html) »
@@ -5134,0 +5135,179 @@ JSON Syntax:
+>>> 
+>>> SemanticMetadata -> (structure)
+>>>
+>>>> The column-level semantic metadata for this semantic table.
+>>>> 
+>>>> ColumnMetadata -> (list)
+>>>>
+>>>>> A list of column semantic metadata entries.
+>>>>> 
+>>>>> Constraints:
+>>>>> 
+>>>>>   * min: `1`
+>>>>>   * max: `2000`
+>>>>> 
+
+>>>>> 
+>>>>> (structure)
+>>>>>
+>>>>>> Semantic metadata shared across one or more columns.
+>>>>>> 
+>>>>>> ColumnNames -> (list)
+>>>>>>
+>>>>>>> The names of the columns this metadata applies to.
+>>>>>>> 
+>>>>>>> Constraints:
+>>>>>>> 
+>>>>>>>   * min: `1`
+>>>>>>>   * max: `2000`
+>>>>>>> 
+
+>>>>>>> 
+>>>>>>> (string)
+>>>>>>>
+>>>>>>>> Constraints:
+>>>>>>>> 
+>>>>>>>>   * min: `1`
+>>>>>>>>   * max: `128`
+>>>>>>>> 
+
+>>>>>> 
+>>>>>> ColumnProperties -> (list) [required]
+>>>>>>
+>>>>>>> The semantic properties for the specified columns.
+>>>>>>> 
+>>>>>>> Constraints:
+>>>>>>> 
+>>>>>>>   * min: `1`
+>>>>>>>   * max: `3`
+>>>>>>> 
+
+>>>>>>> 
+>>>>>>> (structure)
+>>>>>>>
+>>>>>>>> A semantic property for a column.
+>>>>>>>> 
+>>>>>>>> Description -> (structure)
+>>>>>>>>
+>>>>>>>>> A description of the column.
+>>>>>>>>> 
+>>>>>>>>> Text -> (string)
+>>>>>>>>>
+>>>>>>>>>> The text of a description for a column.
+>>>>>>>>>> 
+>>>>>>>>>> Constraints:
+>>>>>>>>>> 
+>>>>>>>>>>   * min: `0`
+>>>>>>>>>>   * max: `500`
+>>>>>>>>>> 
+
+>>>>>>>> 
+>>>>>>>> AdditionalNotes -> (structure)
+>>>>>>>>
+>>>>>>>>> Additional notes for the column.
+>>>>>>>>> 
+>>>>>>>>> Text -> (string)
+>>>>>>>>>
+>>>>>>>>>> The additional notes text.
+>>>>>>>>>> 
+>>>>>>>>>> Constraints:
+>>>>>>>>>> 
+>>>>>>>>>>   * min: `0`
+>>>>>>>>>>   * max: `2000`
+>>>>>>>>>> 
+
+>>>>>>>> 
+>>>>>>>> SemanticType -> (structure)
+>>>>>>>>
+>>>>>>>>> The semantic type of the column.
+>>>>>>>>> 
+>>>>>>>>> GeographicalRole -> (string)
+>>>>>>>>>
+>>>>>>>>>> The geographical role of the column in the new data preparation experience.
+>>>>>>>>>> 
+>>>>>>>>>> Possible values:
+>>>>>>>>>> 
+>>>>>>>>>>   * `COUNTRY`
+>>>>>>>>>>   * `STATE`
+>>>>>>>>>>   * `COUNTY`
+>>>>>>>>>>   * `CITY`
+>>>>>>>>>>   * `POSTCODE`
+>>>>>>>>>>   * `LONGITUDE`
+>>>>>>>>>>   * `LATITUDE`
+>>>>>>>>>> 
+
+> 
+> SemanticMetadata -> (list)
+>
+>> The dataset-level semantic metadata, including a description and custom instructions.
+>> 
+>> Constraints:
+>> 
+>>   * min: `1`
+>>   * max: `1`
+>> 
+
+>> 
+>> (structure)
+>>
+>>> Semantic metadata for a dataset, including a description and custom instructions.
+>>> 
+>>> Description -> (structure)
+>>>
+>>>> A description of the dataset.
+>>>> 
+>>>> Text -> (string) [required]
+>>>>
+>>>>> The descriptive text for the dataset.
+>>>>> 
+>>>>> Constraints:
+>>>>> 
+>>>>>   * min: `1`
+>>>>>   * max: `500`
+>>>>> 
+
+>>> 
+>>> CustomInstructions -> (list)
+>>>
+>>>> A list of custom instructions that guide how the dataset should be consumed.
+>>>> 
+>>>> Constraints:
+>>>> 
+>>>>   * min: `1`
+>>>>   * max: `2`
+>>>> 
+
+>>>> 
+>>>> (structure)
+>>>>
+>>>>> A custom instruction that provides guidance on how the dataset should be consumed.
+>>>>> 
+>>>>> InlineCustomInstruction -> (structure)
+>>>>>
+>>>>>> An inline custom instruction containing text and optional uploaded document metadata.
+>>>>>> 
+>>>>>> InstructionText -> (string) [required]
+>>>>>>
+>>>>>>> The instruction text content.
+>>>>>>> 
+>>>>>>> Constraints:
+>>>>>>> 
+>>>>>>>   * min: `0`
+>>>>>>>   * max: `50000`
+>>>>>>> 
+
+>>>>>> 
+>>>>>> UploadedDocumentMetadata -> (structure)
+>>>>>>
+>>>>>>> Metadata about an uploaded document associated with this instruction.
+>>>>>>> 
+>>>>>>> Name -> (string)
+>>>>>>>
+>>>>>>>> The name of the uploaded document.
+>>>>>>>> 
+>>>>>>>> Constraints:
+>>>>>>>> 
+>>>>>>>>   * min: `1`
+>>>>>>>>   * max: `127`
+>>>>>>>> 
+
@@ -5166,0 +5346,15 @@ JSON Syntax:
+            },
+            "SemanticMetadata": {
+              "ColumnMetadata": [
+                {
+                  "ColumnNames": ["string", ...],
+                  "ColumnProperties": [
+                    {
+                      "Description": {
+                        "Text": "string"
+                      },
+                      "AdditionalNotes": {
+                        "Text": "string"