[chore] Move Dynamodb attributes to the registry (#850)

2024-04-03 11:20:42 +02:00 · 2024-04-03 11:20:42 +02:00 · 8dc38ecc97
parent d8b6c93ff6
commit 8dc38ecc97
8 changed files with 428 additions and 306 deletions
--- a/.github/ISSUE_TEMPLATE/bug_report.yaml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yaml
@ -20,6 +20,7 @@ body:
        # DO NOT manually edit it.
        # Start semconv area list
        - area:android
+        - area:aws
        - area:browser
        - area:client
        - area:cloud
--- a/.github/ISSUE_TEMPLATE/change_proposal.yaml
+++ b/.github/ISSUE_TEMPLATE/change_proposal.yaml
@ -13,6 +13,7 @@ body:
        # DO NOT manually edit it.
        # Start semconv area list
        - area:android
+        - area:aws
        - area:browser
        - area:client
        - area:cloud
--- a/.github/ISSUE_TEMPLATE/new-conventions.yaml
+++ b/.github/ISSUE_TEMPLATE/new-conventions.yaml
@ -22,6 +22,7 @@ body:
        # DO NOT manually edit it.
        # Start semconv area list
        - area:android
+        - area:aws
        - area:browser
        - area:client
        - area:cloud
--- a/docs/attributes-registry/README.md
+++ b/docs/attributes-registry/README.md
@ -28,6 +28,7 @@ All registered attributes are listed by namespace in this registry.
 Currently, the following namespaces exist:

 * [Android](android.md)
+* [AWS](aws.md)
 * [Browser](browser.md)
 * [Client](client.md)
 * [Cloud](cloud.md)
--- a/docs/attributes-registry/aws.md
+++ b/docs/attributes-registry/aws.md
@ -0,0 +1,35 @@
+# AWS
+
+<!-- toc -->
+
+- [AWS DynamoDB Attributes](#aws-dynamodb-attributes)
+
+<!-- tocstop -->
+
+## AWS DynamoDB Attributes
+<!-- semconv registry.aws.dynamodb(omit_requirement_level) -->
+| Attribute  | Type | Description  | Examples  | Stability |
+|---|---|---|---|---|
+| `aws.dynamodb.attribute_definitions` | string[] | The JSON-serialized value of each item in the `AttributeDefinitions` request field. | `[{ "AttributeName": "string", "AttributeType": "string" }]` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.attributes_to_get` | string[] | The value of the `AttributesToGet` request parameter. | `[lives, id]` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.consistent_read` | boolean | The value of the `ConsistentRead` request parameter. |  | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.count` | int | The value of the `Count` response parameter. | `10` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.exclusive_start_table` | string | The value of the `ExclusiveStartTableName` request parameter. | `Users`; `CatsTable` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.global_secondary_index_updates` | string[] | The JSON-serialized value of each item in the `GlobalSecondaryIndexUpdates` request field. | `[{ "Create": { "IndexName": "string", "KeySchema": [ { "AttributeName": "string", "KeyType": "string" } ], "Projection": { "NonKeyAttributes": [ "string" ], "ProjectionType": "string" }, "ProvisionedThroughput": { "ReadCapacityUnits": number, "WriteCapacityUnits": number } }]` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.global_secondary_indexes` | string[] | The JSON-serialized value of each item of the `GlobalSecondaryIndexes` request field | `[{ "IndexName": "string", "KeySchema": [ { "AttributeName": "string", "KeyType": "string" } ], "Projection": { "NonKeyAttributes": [ "string" ], "ProjectionType": "string" }, "ProvisionedThroughput": { "ReadCapacityUnits": number, "WriteCapacityUnits": number } }]` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.index_name` | string | The value of the `IndexName` request parameter. | `name_to_group` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.limit` | int | The value of the `Limit` request parameter. | `10` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.local_secondary_indexes` | string[] | The JSON-serialized value of each item of the `LocalSecondaryIndexes` request field. | `[{ "IndexArn": "string", "IndexName": "string", "IndexSizeBytes": number, "ItemCount": number, "KeySchema": [ { "AttributeName": "string", "KeyType": "string" } ], "Projection": { "NonKeyAttributes": [ "string" ], "ProjectionType": "string" } }]` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.projection` | string | The value of the `ProjectionExpression` request parameter. | `Title`; `Title, Price, Color`; `Title, Description, RelatedItems, ProductReviews` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.provisioned_read_capacity` | double | The value of the `ProvisionedThroughput.ReadCapacityUnits` request parameter. | `1.0`; `2.0` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.provisioned_write_capacity` | double | The value of the `ProvisionedThroughput.WriteCapacityUnits` request parameter. | `1.0`; `2.0` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.scan_forward` | boolean | The value of the `ScanIndexForward` request parameter. |  | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.scanned_count` | int | The value of the `ScannedCount` response parameter. | `50` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.segment` | int | The value of the `Segment` request parameter. | `10` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.select` | string | The value of the `Select` request parameter. | `ALL_ATTRIBUTES`; `COUNT` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.table_count` | int | The number of items in the `TableNames` response parameter. | `20` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.table_names` | string[] | The keys in the `RequestItems` object field. | `[Users, Cats]` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| `aws.dynamodb.total_segments` | int | The value of the `TotalSegments` request parameter. | `100` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+<!-- endsemconv -->
--- a/docs/database/dynamodb.md
+++ b/docs/database/dynamodb.md
@ -27,8 +27,8 @@ These attributes are filled in for all DynamoDB request types.
 <!-- semconv dynamodb.batchgetitem -->
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.table_names` | string[] | The keys in the `RequestItems` object field. | `[Users, Cats]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.consumed_capacity`](../attributes-registry/aws.md) | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.table_names`](../attributes-registry/aws.md) | string[] | The keys in the `RequestItems` object field. | `[Users, Cats]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 <!-- endsemconv -->

 ## DynamoDB.BatchWriteItem
@ -36,9 +36,9 @@ These attributes are filled in for all DynamoDB request types.
 <!-- semconv dynamodb.batchwriteitem -->
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.table_names` | string[] | The keys in the `RequestItems` object field. | `[Users, Cats]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.consumed_capacity`](../attributes-registry/aws.md) | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.item_collection_metrics`](../attributes-registry/aws.md) | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.table_names`](../attributes-registry/aws.md) | string[] | The keys in the `RequestItems` object field. | `[Users, Cats]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 <!-- endsemconv -->

 ## DynamoDB.CreateTable
@ -46,13 +46,13 @@ These attributes are filled in for all DynamoDB request types.
 <!-- semconv dynamodb.createtable -->
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.global_secondary_indexes` | string[] | The JSON-serialized value of each item of the `GlobalSecondaryIndexes` request field | `[{ "IndexName": "string", "KeySchema": [ { "AttributeName": "string", "KeyType": "string" } ], "Projection": { "NonKeyAttributes": [ "string" ], "ProjectionType": "string" }, "ProvisionedThroughput": { "ReadCapacityUnits": number, "WriteCapacityUnits": number } }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.local_secondary_indexes` | string[] | The JSON-serialized value of each item of the `LocalSecondaryIndexes` request field. | `[{ "IndexArn": "string", "IndexName": "string", "IndexSizeBytes": number, "ItemCount": number, "KeySchema": [ { "AttributeName": "string", "KeyType": "string" } ], "Projection": { "NonKeyAttributes": [ "string" ], "ProjectionType": "string" } }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.provisioned_read_capacity` | double | The value of the `ProvisionedThroughput.ReadCapacityUnits` request parameter. | `1.0`; `2.0` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.provisioned_write_capacity` | double | The value of the `ProvisionedThroughput.WriteCapacityUnits` request parameter. | `1.0`; `2.0` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.consumed_capacity`](../attributes-registry/aws.md) | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.global_secondary_indexes`](../attributes-registry/aws.md) | string[] | The JSON-serialized value of each item of the `GlobalSecondaryIndexes` request field | `[{ "IndexName": "string", "KeySchema": [ { "AttributeName": "string", "KeyType": "string" } ], "Projection": { "NonKeyAttributes": [ "string" ], "ProjectionType": "string" }, "ProvisionedThroughput": { "ReadCapacityUnits": number, "WriteCapacityUnits": number } }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.item_collection_metrics`](../attributes-registry/aws.md) | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.local_secondary_indexes`](../attributes-registry/aws.md) | string[] | The JSON-serialized value of each item of the `LocalSecondaryIndexes` request field. | `[{ "IndexArn": "string", "IndexName": "string", "IndexSizeBytes": number, "ItemCount": number, "KeySchema": [ { "AttributeName": "string", "KeyType": "string" } ], "Projection": { "NonKeyAttributes": [ "string" ], "ProjectionType": "string" } }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.provisioned_read_capacity`](../attributes-registry/aws.md) | double | The value of the `ProvisionedThroughput.ReadCapacityUnits` request parameter. | `1.0`; `2.0` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.provisioned_write_capacity`](../attributes-registry/aws.md) | double | The value of the `ProvisionedThroughput.WriteCapacityUnits` request parameter. | `1.0`; `2.0` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.table_names`](../attributes-registry/aws.md) | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 <!-- endsemconv -->

 ## DynamoDB.DeleteItem
@ -60,9 +60,9 @@ These attributes are filled in for all DynamoDB request types.
 <!-- semconv dynamodb.deleteitem -->
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.consumed_capacity`](../attributes-registry/aws.md) | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.item_collection_metrics`](../attributes-registry/aws.md) | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.table_names`](../attributes-registry/aws.md) | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 <!-- endsemconv -->

 ## DynamoDB.DeleteTable
@ -70,7 +70,7 @@ These attributes are filled in for all DynamoDB request types.
 <!-- semconv dynamodb.deletetable -->
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.table_names`](../attributes-registry/aws.md) | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 <!-- endsemconv -->

 ## DynamoDB.DescribeTable
@ -78,7 +78,7 @@ These attributes are filled in for all DynamoDB request types.
 <!-- semconv dynamodb.describetable -->
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.table_names`](../attributes-registry/aws.md) | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 <!-- endsemconv -->

 ## DynamoDB.GetItem
@ -86,10 +86,10 @@ These attributes are filled in for all DynamoDB request types.
 <!-- semconv dynamodb.getitem -->
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| `aws.dynamodb.consistent_read` | boolean | The value of the `ConsistentRead` request parameter. |  | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.projection` | string | The value of the `ProjectionExpression` request parameter. | `Title`; `Title, Price, Color`; `Title, Description, RelatedItems, ProductReviews` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.consistent_read`](../attributes-registry/aws.md) | boolean | The value of the `ConsistentRead` request parameter. |  | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.consumed_capacity`](../attributes-registry/aws.md) | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.projection`](../attributes-registry/aws.md) | string | The value of the `ProjectionExpression` request parameter. | `Title`; `Title, Price, Color`; `Title, Description, RelatedItems, ProductReviews` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.table_names`](../attributes-registry/aws.md) | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 <!-- endsemconv -->

 ## DynamoDB.ListTables
@ -97,9 +97,9 @@ These attributes are filled in for all DynamoDB request types.
 <!-- semconv dynamodb.listtables -->
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| `aws.dynamodb.exclusive_start_table` | string | The value of the `ExclusiveStartTableName` request parameter. | `Users`; `CatsTable` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.limit` | int | The value of the `Limit` request parameter. | `10` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.table_count` | int | The number of items in the `TableNames` response parameter. | `20` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.exclusive_start_table`](../attributes-registry/aws.md) | string | The value of the `ExclusiveStartTableName` request parameter. | `Users`; `CatsTable` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.limit`](../attributes-registry/aws.md) | int | The value of the `Limit` request parameter. | `10` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.table_count`](../attributes-registry/aws.md) | int | The number of items in the `TableNames` response parameter. | `20` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 <!-- endsemconv -->

 ## DynamoDB.PutItem
@ -107,9 +107,9 @@ These attributes are filled in for all DynamoDB request types.
 <!-- semconv dynamodb.putitem -->
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.table_names` | string[] | The keys in the `RequestItems` object field. | `[Users, Cats]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.consumed_capacity`](../attributes-registry/aws.md) | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.item_collection_metrics`](../attributes-registry/aws.md) | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.table_names`](../attributes-registry/aws.md) | string[] | The keys in the `RequestItems` object field. | `[Users, Cats]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 <!-- endsemconv -->

 ## DynamoDB.Query
@ -117,15 +117,15 @@ These attributes are filled in for all DynamoDB request types.
 <!-- semconv dynamodb.query -->
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| `aws.dynamodb.attributes_to_get` | string[] | The value of the `AttributesToGet` request parameter. | `[lives, id]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.consistent_read` | boolean | The value of the `ConsistentRead` request parameter. |  | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.index_name` | string | The value of the `IndexName` request parameter. | `name_to_group` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.limit` | int | The value of the `Limit` request parameter. | `10` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.projection` | string | The value of the `ProjectionExpression` request parameter. | `Title`; `Title, Price, Color`; `Title, Description, RelatedItems, ProductReviews` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.scan_forward` | boolean | The value of the `ScanIndexForward` request parameter. |  | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.select` | string | The value of the `Select` request parameter. | `ALL_ATTRIBUTES`; `COUNT` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.attributes_to_get`](../attributes-registry/aws.md) | string[] | The value of the `AttributesToGet` request parameter. | `[lives, id]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.consistent_read`](../attributes-registry/aws.md) | boolean | The value of the `ConsistentRead` request parameter. |  | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.consumed_capacity`](../attributes-registry/aws.md) | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.index_name`](../attributes-registry/aws.md) | string | The value of the `IndexName` request parameter. | `name_to_group` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.limit`](../attributes-registry/aws.md) | int | The value of the `Limit` request parameter. | `10` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.projection`](../attributes-registry/aws.md) | string | The value of the `ProjectionExpression` request parameter. | `Title`; `Title, Price, Color`; `Title, Description, RelatedItems, ProductReviews` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.scan_forward`](../attributes-registry/aws.md) | boolean | The value of the `ScanIndexForward` request parameter. |  | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.select`](../attributes-registry/aws.md) | string | The value of the `Select` request parameter. | `ALL_ATTRIBUTES`; `COUNT` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.table_names`](../attributes-registry/aws.md) | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 <!-- endsemconv -->

 ## DynamoDB.Scan
@ -133,18 +133,18 @@ These attributes are filled in for all DynamoDB request types.
 <!-- semconv dynamodb.scan -->
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| `aws.dynamodb.attributes_to_get` | string[] | The value of the `AttributesToGet` request parameter. | `[lives, id]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.consistent_read` | boolean | The value of the `ConsistentRead` request parameter. |  | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.count` | int | The value of the `Count` response parameter. | `10` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.index_name` | string | The value of the `IndexName` request parameter. | `name_to_group` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.limit` | int | The value of the `Limit` request parameter. | `10` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.projection` | string | The value of the `ProjectionExpression` request parameter. | `Title`; `Title, Price, Color`; `Title, Description, RelatedItems, ProductReviews` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.scanned_count` | int | The value of the `ScannedCount` response parameter. | `50` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.segment` | int | The value of the `Segment` request parameter. | `10` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.select` | string | The value of the `Select` request parameter. | `ALL_ATTRIBUTES`; `COUNT` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.total_segments` | int | The value of the `TotalSegments` request parameter. | `100` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.attributes_to_get`](../attributes-registry/aws.md) | string[] | The value of the `AttributesToGet` request parameter. | `[lives, id]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.consistent_read`](../attributes-registry/aws.md) | boolean | The value of the `ConsistentRead` request parameter. |  | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.consumed_capacity`](../attributes-registry/aws.md) | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.count`](../attributes-registry/aws.md) | int | The value of the `Count` response parameter. | `10` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.index_name`](../attributes-registry/aws.md) | string | The value of the `IndexName` request parameter. | `name_to_group` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.limit`](../attributes-registry/aws.md) | int | The value of the `Limit` request parameter. | `10` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.projection`](../attributes-registry/aws.md) | string | The value of the `ProjectionExpression` request parameter. | `Title`; `Title, Price, Color`; `Title, Description, RelatedItems, ProductReviews` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.scanned_count`](../attributes-registry/aws.md) | int | The value of the `ScannedCount` response parameter. | `50` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.segment`](../attributes-registry/aws.md) | int | The value of the `Segment` request parameter. | `10` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.select`](../attributes-registry/aws.md) | string | The value of the `Select` request parameter. | `ALL_ATTRIBUTES`; `COUNT` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.table_names`](../attributes-registry/aws.md) | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.total_segments`](../attributes-registry/aws.md) | int | The value of the `TotalSegments` request parameter. | `100` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 <!-- endsemconv -->

 ## DynamoDB.UpdateItem
@ -152,9 +152,9 @@ These attributes are filled in for all DynamoDB request types.
 <!-- semconv dynamodb.updateitem -->
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.consumed_capacity`](../attributes-registry/aws.md) | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.item_collection_metrics`](../attributes-registry/aws.md) | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.table_names`](../attributes-registry/aws.md) | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 <!-- endsemconv -->

 ## DynamoDB.UpdateTable
@ -162,12 +162,12 @@ These attributes are filled in for all DynamoDB request types.
 <!-- semconv dynamodb.updatetable -->
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| `aws.dynamodb.attribute_definitions` | string[] | The JSON-serialized value of each item in the `AttributeDefinitions` request field. | `[{ "AttributeName": "string", "AttributeType": "string" }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.global_secondary_index_updates` | string[] | The JSON-serialized value of each item in the `GlobalSecondaryIndexUpdates` request field. | `[{ "Create": { "IndexName": "string", "KeySchema": [ { "AttributeName": "string", "KeyType": "string" } ], "Projection": { "NonKeyAttributes": [ "string" ], "ProjectionType": "string" }, "ProvisionedThroughput": { "ReadCapacityUnits": number, "WriteCapacityUnits": number } }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.provisioned_read_capacity` | double | The value of the `ProvisionedThroughput.ReadCapacityUnits` request parameter. | `1.0`; `2.0` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.provisioned_write_capacity` | double | The value of the `ProvisionedThroughput.WriteCapacityUnits` request parameter. | `1.0`; `2.0` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.attribute_definitions`](../attributes-registry/aws.md) | string[] | The JSON-serialized value of each item in the `AttributeDefinitions` request field. | `[{ "AttributeName": "string", "AttributeType": "string" }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.consumed_capacity`](../attributes-registry/aws.md) | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.global_secondary_index_updates`](../attributes-registry/aws.md) | string[] | The JSON-serialized value of each item in the `GlobalSecondaryIndexUpdates` request field. | `[{ "Create": { "IndexName": "string", "KeySchema": [ { "AttributeName": "string", "KeyType": "string" } ], "Projection": { "NonKeyAttributes": [ "string" ], "ProjectionType": "string" }, "ProvisionedThroughput": { "ReadCapacityUnits": number, "WriteCapacityUnits": number } }]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.provisioned_read_capacity`](../attributes-registry/aws.md) | double | The value of the `ProvisionedThroughput.ReadCapacityUnits` request parameter. | `1.0`; `2.0` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.provisioned_write_capacity`](../attributes-registry/aws.md) | double | The value of the `ProvisionedThroughput.WriteCapacityUnits` request parameter. | `1.0`; `2.0` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`aws.dynamodb.table_names`](../attributes-registry/aws.md) | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 <!-- endsemconv -->

 [DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
--- a/model/registry/aws.yaml
+++ b/model/registry/aws.yaml
@ -0,0 +1,242 @@
+groups:
+  - id: registry.aws.dynamodb
+    prefix: aws.dynamodb
+    type: attribute_group
+    brief: >
+            This document defines attributes for AWS DynamoDB.
+    attributes:
+      - id: table_names
+        type: string[]
+        stability: experimental
+        brief: The keys in the `RequestItems` object field.
+        examples:
+          - Users
+          - Cats
+      - id: consumed_capacity
+        type: string[]
+        stability: experimental
+        brief: "The JSON-serialized value of each item in the `ConsumedCapacity` response field."
+        examples:
+          - '{
+              "CapacityUnits": number,
+              "GlobalSecondaryIndexes": {
+                 "string" : {
+                    "CapacityUnits": number,
+                    "ReadCapacityUnits": number,
+                    "WriteCapacityUnits": number
+                 }
+              },
+              "LocalSecondaryIndexes": {
+                 "string" : {
+                    "CapacityUnits": number,
+                    "ReadCapacityUnits": number,
+                    "WriteCapacityUnits": number
+                 }
+              },
+              "ReadCapacityUnits": number,
+              "Table": {
+                 "CapacityUnits": number,
+                 "ReadCapacityUnits": number,
+                 "WriteCapacityUnits": number
+              },
+              "TableName": "string",
+              "WriteCapacityUnits": number
+            }'
+      - id: item_collection_metrics
+        type: string
+        stability: experimental
+        brief: "The JSON-serialized value of the `ItemCollectionMetrics` response field."
+        examples:
+          - '{
+              "string" : [
+                 {
+                    "ItemCollectionKey": {
+                       "string" : {
+                          "B": blob,
+                          "BOOL": boolean,
+                          "BS": [ blob ],
+                          "L": [
+                             "AttributeValue"
+                          ],
+                          "M": {
+                             "string" : "AttributeValue"
+                          },
+                          "N": "string",
+                          "NS": [ "string" ],
+                          "NULL": boolean,
+                          "S": "string",
+                          "SS": [ "string" ]
+                       }
+                    },
+                    "SizeEstimateRangeGB": [ number ]
+                 }
+              ]
+             }'
+      - id: provisioned_read_capacity
+        type: double
+        stability: experimental
+        brief: "The value of the `ProvisionedThroughput.ReadCapacityUnits` request parameter."
+        examples:
+          - 1.0
+          - 2.0
+      - id: provisioned_write_capacity
+        type: double
+        stability: experimental
+        brief: "The value of the `ProvisionedThroughput.WriteCapacityUnits` request parameter."
+        examples:
+          - 1.0
+          - 2.0
+      - id: consistent_read
+        type: boolean
+        stability: experimental
+        brief: "The value of the `ConsistentRead` request parameter."
+      - id: projection
+        type: string
+        stability: experimental
+        brief: "The value of the `ProjectionExpression` request parameter."
+        examples:
+          - Title
+          - Title, Price, Color
+          - Title, Description, RelatedItems, ProductReviews
+      - id: limit
+        type: int
+        stability: experimental
+        brief: "The value of the `Limit` request parameter."
+        examples:
+          - 10
+      - id: attributes_to_get
+        type: string[]
+        stability: experimental
+        brief: "The value of the `AttributesToGet` request parameter."
+        examples:
+          - lives
+          - id
+      - id: index_name
+        type: string
+        stability: experimental
+        brief: "The value of the `IndexName` request parameter."
+        examples:
+          - name_to_group
+      - id: select
+        type: string
+        stability: experimental
+        brief: "The value of the `Select` request parameter."
+        examples:
+          - ALL_ATTRIBUTES
+          - COUNT
+      - id: global_secondary_indexes
+        type: string[]
+        stability: experimental
+        brief: "The JSON-serialized value of each item of the `GlobalSecondaryIndexes` request field"
+        examples:
+          - '{
+              "IndexName": "string",
+              "KeySchema": [
+                {
+                  "AttributeName": "string",
+                  "KeyType": "string"
+                }
+              ],
+              "Projection": {
+                "NonKeyAttributes": [ "string" ],
+                "ProjectionType": "string"
+              },
+              "ProvisionedThroughput": {
+                "ReadCapacityUnits": number,
+                "WriteCapacityUnits": number
+              }
+            }'
+      - id: local_secondary_indexes
+        type: string[]
+        stability: experimental
+        brief: "The JSON-serialized value of each item of the `LocalSecondaryIndexes` request field."
+        examples:
+          - '{
+              "IndexArn": "string",
+              "IndexName": "string",
+              "IndexSizeBytes": number,
+              "ItemCount": number,
+              "KeySchema": [
+                {
+                  "AttributeName": "string",
+                  "KeyType": "string"
+                }
+              ],
+              "Projection": {
+                "NonKeyAttributes": [ "string" ],
+                "ProjectionType": "string"
+              }
+            }'
+      - id: exclusive_start_table
+        type: string
+        stability: experimental
+        brief: "The value of the `ExclusiveStartTableName` request parameter."
+        examples:
+          - Users
+          - CatsTable
+      - id: table_count
+        type: int
+        stability: experimental
+        brief: "The number of items in the `TableNames` response parameter."
+        examples:
+          - 20
+      - id: scan_forward
+        type: boolean
+        stability: experimental
+        brief: "The value of the `ScanIndexForward` request parameter."
+      - id: segment
+        type: int
+        stability: experimental
+        brief: "The value of the `Segment` request parameter."
+        examples:
+          - 10
+      - id: total_segments
+        type: int
+        stability: experimental
+        brief: "The value of the `TotalSegments` request parameter."
+        examples:
+          - 100
+      - id: count
+        type: int
+        stability: experimental
+        brief: "The value of the `Count` response parameter."
+        examples:
+          - 10
+      - id: scanned_count
+        type: int
+        stability: experimental
+        brief: "The value of the `ScannedCount` response parameter."
+        examples:
+          - 50
+      - id: attribute_definitions
+        type: string[]
+        stability: experimental
+        brief: "The JSON-serialized value of each item in the `AttributeDefinitions` request field."
+        examples:
+          - '{
+              "AttributeName": "string",
+              "AttributeType": "string"
+             }'
+      - id: global_secondary_index_updates
+        type: string[]
+        stability: experimental
+        brief: "The JSON-serialized value of each item in the `GlobalSecondaryIndexUpdates` request field."
+        examples:
+          - '{
+              "Create": {
+                "IndexName": "string",
+                "KeySchema": [
+                  {
+                    "AttributeName": "string",
+                    "KeyType": "string"
+                  }
+                ],
+                "Projection": {
+                  "NonKeyAttributes": [ "string" ],
+                  "ProjectionType": "string"
+                },
+                "ProvisionedThroughput": {
+                  "ReadCapacityUnits": number,
+                  "WriteCapacityUnits": number
+                }
+              }'
--- a/model/trace/instrumentation/aws-sdk.yml
+++ b/model/trace/instrumentation/aws-sdk.yml
@ -46,7 +46,6 @@ groups:

  - id: dynamodb.shared
    extends: aws
-    prefix: aws.dynamodb
    type: span
    brief: "Attributes that exist for multiple DynamoDB request types."
    attributes:
@ -55,223 +54,96 @@ groups:
        examples:
          - GetItem
          - PutItem
-      - id: table_names
-        type: string[]
-        stability: experimental
-        brief: The keys in the `RequestItems` object field.
-        examples:
-          - Users
-          - Cats
-      - id: consumed_capacity
-        type: string[]
-        stability: experimental
-        brief: "The JSON-serialized value of each item in the `ConsumedCapacity` response field."
-        examples:
-          - '{
-              "CapacityUnits": number,
-              "GlobalSecondaryIndexes": {
-                 "string" : {
-                    "CapacityUnits": number,
-                    "ReadCapacityUnits": number,
-                    "WriteCapacityUnits": number
-                 }
-              },
-              "LocalSecondaryIndexes": {
-                 "string" : {
-                    "CapacityUnits": number,
-                    "ReadCapacityUnits": number,
-                    "WriteCapacityUnits": number
-                 }
-              },
-              "ReadCapacityUnits": number,
-              "Table": {
-                 "CapacityUnits": number,
-                 "ReadCapacityUnits": number,
-                 "WriteCapacityUnits": number
-              },
-              "TableName": "string",
-              "WriteCapacityUnits": number
-            }'
-      - id: item_collection_metrics
-        type: string
-        stability: experimental
-        brief: "The JSON-serialized value of the `ItemCollectionMetrics` response field."
-        examples:
-          - '{
-              "string" : [
-                 {
-                    "ItemCollectionKey": {
-                       "string" : {
-                          "B": blob,
-                          "BOOL": boolean,
-                          "BS": [ blob ],
-                          "L": [
-                             "AttributeValue"
-                          ],
-                          "M": {
-                             "string" : "AttributeValue"
-                          },
-                          "N": "string",
-                          "NS": [ "string" ],
-                          "NULL": boolean,
-                          "S": "string",
-                          "SS": [ "string" ]
-                       }
-                    },
-                    "SizeEstimateRangeGB": [ number ]
-                 }
-              ]
-             }'
-      - id: provisioned_read_capacity
-        type: double
-        stability: experimental
-        brief: "The value of the `ProvisionedThroughput.ReadCapacityUnits` request parameter."
-        examples:
-          - 1.0
-          - 2.0
-      - id: provisioned_write_capacity
-        type: double
-        stability: experimental
-        brief: "The value of the `ProvisionedThroughput.WriteCapacityUnits` request parameter."
-        examples:
-          - 1.0
-          - 2.0
-      - id: consistent_read
-        type: boolean
-        stability: experimental
-        brief: "The value of the `ConsistentRead` request parameter."
-      - id: projection
-        type: string
-        stability: experimental
-        brief: "The value of the `ProjectionExpression` request parameter."
-        examples:
-          - Title
-          - Title, Price, Color
-          - Title, Description, RelatedItems, ProductReviews
-      - id: limit
-        type: int
-        stability: experimental
-        brief: "The value of the `Limit` request parameter."
-        examples:
-          - 10
-      - id: attributes_to_get
-        type: string[]
-        stability: experimental
-        brief: "The value of the `AttributesToGet` request parameter."
-        examples:
-          - lives
-          - id
-      - id: index_name
-        type: string
-        stability: experimental
-        brief: "The value of the `IndexName` request parameter."
-        examples:
-          - name_to_group
-      - id: select
-        type: string
-        stability: experimental
-        brief: "The value of the `Select` request parameter."
-        examples:
-          - ALL_ATTRIBUTES
-          - COUNT
+      - ref: aws.dynamodb.table_names
+        requirement_level: recommended
+      - ref: aws.dynamodb.consumed_capacity
+        requirement_level: recommended
+      - ref: aws.dynamodb.item_collection_metrics
+        requirement_level: recommended
+      - ref: aws.dynamodb.provisioned_read_capacity
+        requirement_level: recommended
+      - ref: aws.dynamodb.provisioned_write_capacity
+        requirement_level: recommended
+      - ref: aws.dynamodb.consistent_read
+        requirement_level: recommended
+      - ref: aws.dynamodb.projection
+        requirement_level: recommended
+      - ref: aws.dynamodb.limit
+        requirement_level: recommended
+      - ref: aws.dynamodb.attributes_to_get
+        requirement_level: recommended
+      - ref: aws.dynamodb.index_name
+        requirement_level: recommended
+      - ref: aws.dynamodb.select
+        requirement_level: recommended

  - id: dynamodb.batchgetitem
    brief: DynamoDB.BatchGetItem
    extends: aws
-    prefix: aws.dynamodb
    type: span
    attributes:
      - ref: aws.dynamodb.table_names
+        requirement_level: recommended
      - ref: aws.dynamodb.consumed_capacity
+        requirement_level: recommended

  - id: dynamodb.batchwriteitem
    brief: DynamoDB.BatchWriteItem
    extends: aws
-    prefix: aws.dynamodb
    type: span
    attributes:
      - ref: aws.dynamodb.table_names
+        requirement_level: recommended
      - ref: aws.dynamodb.consumed_capacity
+        requirement_level: recommended
      - ref: aws.dynamodb.item_collection_metrics
+        requirement_level: recommended

  - id: dynamodb.createtable
    brief: DynamoDB.CreateTable
    extends: aws
-    prefix: aws.dynamodb
    type: span
    attributes:
-      - id: global_secondary_indexes
-        type: string[]
-        stability: experimental
-        brief: "The JSON-serialized value of each item of the `GlobalSecondaryIndexes` request field"
-        examples:
-          - '{
-              "IndexName": "string",
-              "KeySchema": [
-                {
-                  "AttributeName": "string",
-                  "KeyType": "string"
-                }
-              ],
-              "Projection": {
-                "NonKeyAttributes": [ "string" ],
-                "ProjectionType": "string"
-              },
-              "ProvisionedThroughput": {
-                "ReadCapacityUnits": number,
-                "WriteCapacityUnits": number
-              }
-            }'
-      - id: local_secondary_indexes
-        type: string[]
-        stability: experimental
-        brief: "The JSON-serialized value of each item of the `LocalSecondaryIndexes` request field."
-        examples:
-          - '{
-              "IndexArn": "string",
-              "IndexName": "string",
-              "IndexSizeBytes": number,
-              "ItemCount": number,
-              "KeySchema": [
-                {
-                  "AttributeName": "string",
-                  "KeyType": "string"
-                }
-              ],
-              "Projection": {
-                "NonKeyAttributes": [ "string" ],
-                "ProjectionType": "string"
-              }
-            }'
+      - ref: aws.dynamodb.global_secondary_indexes
+        requirement_level: recommended
+      - ref: aws.dynamodb.local_secondary_indexes
+        requirement_level: recommended
      - ref: aws.dynamodb.table_names
+        requirement_level: recommended
        brief: "A single-element array with the value of the TableName request parameter."
        examples:
          - Users
      - ref: aws.dynamodb.consumed_capacity
+        requirement_level: recommended
      - ref: aws.dynamodb.item_collection_metrics
+        requirement_level: recommended
      - ref: aws.dynamodb.provisioned_read_capacity
+        requirement_level: recommended
      - ref: aws.dynamodb.provisioned_write_capacity
+        requirement_level: recommended

  - id: dynamodb.deleteitem
    brief: DynamoDB.DeleteItem
    extends: aws
-    prefix: aws.dynamodb
    type: span
    attributes:
      - ref: aws.dynamodb.table_names
+        requirement_level: recommended
        brief: "A single-element array with the value of the TableName request parameter."
        examples:
          - Users
      - ref: aws.dynamodb.consumed_capacity
+        requirement_level: recommended
      - ref: aws.dynamodb.item_collection_metrics
+        requirement_level: recommended

  - id: dynamodb.deletetable
    brief: DynamoDB.DeleteTable
    extends: aws
-    prefix: aws.dynamodb
    type: span
    attributes:
      - ref: aws.dynamodb.table_names
+        requirement_level: recommended
        brief: "A single-element array with the value of the TableName request parameter."
        examples:
          - Users
@ -279,10 +151,10 @@ groups:
  - id: dynamodb.describetable
    brief: DynamoDB.DescribeTable
    extends: aws
-    prefix: aws.dynamodb
    type: span
    attributes:
      - ref: aws.dynamodb.table_names
+        requirement_level: recommended
        brief: "A single-element array with the value of the TableName request parameter."
        examples:
          - Users
@ -290,170 +162,139 @@ groups:
  - id: dynamodb.getitem
    brief: DynamoDB.GetItem
    extends: aws
-    prefix: aws.dynamodb
    type: span
    attributes:
      - ref: aws.dynamodb.table_names
+        requirement_level: recommended
        brief: "A single-element array with the value of the TableName request parameter."
        examples:
          - Users
      - ref: aws.dynamodb.consumed_capacity
+        requirement_level: recommended
      - ref: aws.dynamodb.consistent_read
+        requirement_level: recommended
      - ref: aws.dynamodb.projection
+        requirement_level: recommended

  - id: dynamodb.listtables
    brief: DynamoDB.ListTables
    extends: aws
-    prefix: aws.dynamodb
    type: span
    attributes:
-      - id: exclusive_start_table
-        type: string
-        stability: experimental
-        brief: "The value of the `ExclusiveStartTableName` request parameter."
-        examples:
-          - Users
-          - CatsTable
-      - id: table_count
-        type: int
-        stability: experimental
-        brief: "The number of items in the `TableNames` response parameter."
-        examples:
-          - 20
+      - ref: aws.dynamodb.exclusive_start_table
+        requirement_level: recommended
+      - ref: aws.dynamodb.table_count
+        requirement_level: recommended
      - ref: aws.dynamodb.limit
+        requirement_level: recommended

  - id: dynamodb.putitem
    brief: DynamoDB.PutItem
    extends: aws
-    prefix: aws.dynamodb
    type: span
    attributes:
      - ref: aws.dynamodb.table_names
+        requirement_level: recommended
      - ref: aws.dynamodb.consumed_capacity
+        requirement_level: recommended
      - ref: aws.dynamodb.item_collection_metrics
+        requirement_level: recommended

  - id: dynamodb.query
    brief: DynamoDB.Query
    extends: aws
-    prefix: aws.dynamodb
    type: span
    attributes:
-      - id: scan_forward
-        type: boolean
-        stability: experimental
-        brief: "The value of the `ScanIndexForward` request parameter."
+      - ref: aws.dynamodb.scan_forward
+        requirement_level: recommended
      - ref: aws.dynamodb.table_names
+        requirement_level: recommended
        brief: "A single-element array with the value of the TableName request parameter."
        examples:
          - Users
      - ref: aws.dynamodb.consumed_capacity
+        requirement_level: recommended
      - ref: aws.dynamodb.consistent_read
+        requirement_level: recommended
      - ref: aws.dynamodb.limit
+        requirement_level: recommended
      - ref: aws.dynamodb.projection
+        requirement_level: recommended
      - ref: aws.dynamodb.attributes_to_get
+        requirement_level: recommended
      - ref: aws.dynamodb.index_name
+        requirement_level: recommended
      - ref: aws.dynamodb.select
+        requirement_level: recommended

  - id: dynamodb.scan
    brief: DynamoDB.Scan
    extends: aws
-    prefix: aws.dynamodb
    type: span
    attributes:
-      - id: segment
-        type: int
-        stability: experimental
-        brief: "The value of the `Segment` request parameter."
-        examples:
-          - 10
-      - id: total_segments
-        type: int
-        stability: experimental
-        brief: "The value of the `TotalSegments` request parameter."
-        examples:
-          - 100
-      - id: count
-        type: int
-        stability: experimental
-        brief: "The value of the `Count` response parameter."
-        examples:
-          - 10
-      - id: scanned_count
-        type: int
-        stability: experimental
-        brief: "The value of the `ScannedCount` response parameter."
-        examples:
-          - 50
+      - ref: aws.dynamodb.segment
+        requirement_level: recommended
+      - ref: aws.dynamodb.total_segments
+        requirement_level: recommended
+      - ref: aws.dynamodb.count
+        requirement_level: recommended
+      - ref: aws.dynamodb.scanned_count
+        requirement_level: recommended
      - ref: aws.dynamodb.table_names
+        requirement_level: recommended
        brief: "A single-element array with the value of the TableName request parameter."
        examples:
          - Users
      - ref: aws.dynamodb.consumed_capacity
+        requirement_level: recommended
      - ref: aws.dynamodb.consistent_read
+        requirement_level: recommended
      - ref: aws.dynamodb.limit
+        requirement_level: recommended
      - ref: aws.dynamodb.projection
+        requirement_level: recommended
      - ref: aws.dynamodb.attributes_to_get
+        requirement_level: recommended
      - ref: aws.dynamodb.index_name
+        requirement_level: recommended
      - ref: aws.dynamodb.select
+        requirement_level: recommended

  - id: dynamodb.updateitem
    brief: DynamoDB.UpdateItem
    extends: aws
-    prefix: aws.dynamodb
    type: span
    attributes:
      - ref: aws.dynamodb.table_names
+        requirement_level: recommended
        brief: "A single-element array with the value of the TableName request parameter."
        examples:
          - Users
      - ref: aws.dynamodb.consumed_capacity
+        requirement_level: recommended
      - ref: aws.dynamodb.item_collection_metrics
+        requirement_level: recommended

  - id: dynamodb.updatetable
    brief: DynamoDB.UpdateTable
    extends: aws
-    prefix: aws.dynamodb
    type: span
    attributes:
-      - id: attribute_definitions
-        type: string[]
-        stability: experimental
-        brief: "The JSON-serialized value of each item in the `AttributeDefinitions` request field."
-        examples:
-          - '{
-              "AttributeName": "string",
-              "AttributeType": "string"
-             }'
-      - id: global_secondary_index_updates
-        type: string[]
-        stability: experimental
-        brief: "The JSON-serialized value of each item in the `GlobalSecondaryIndexUpdates` request field."
-        examples:
-          - '{
-              "Create": {
-                "IndexName": "string",
-                "KeySchema": [
-                  {
-                    "AttributeName": "string",
-                    "KeyType": "string"
-                  }
-                ],
-                "Projection": {
-                  "NonKeyAttributes": [ "string" ],
-                  "ProjectionType": "string"
-                },
-                "ProvisionedThroughput": {
-                  "ReadCapacityUnits": number,
-                  "WriteCapacityUnits": number
-                }
-              }'
+      - ref: aws.dynamodb.attribute_definitions
+        requirement_level: recommended
+      - ref: aws.dynamodb.global_secondary_index_updates
+        requirement_level: recommended
      - ref: aws.dynamodb.table_names
+        requirement_level: recommended
        brief: "A single-element array with the value of the TableName request parameter."
        examples:
          - Users
      - ref: aws.dynamodb.consumed_capacity
+        requirement_level: recommended
      - ref: aws.dynamodb.provisioned_read_capacity
+        requirement_level: recommended
      - ref: aws.dynamodb.provisioned_write_capacity
+        requirement_level: recommended

  - id: aws.s3
    extends: aws