@aws-sdk/client-dynamodb 3.1101.0 → 3.1103.0

package/dist-types/models/models_0.d.ts

@@ -1,4 +1,4 @@
-import type { ApproximateCreationDateTimePrecision, AttributeAction, BackupStatus, BackupType, BackupTypeFilter, BatchStatementErrorCodeEnum, BillingMode, ComparisonOperator, ConditionalOperator, ContinuousBackupsStatus, ContributorInsightsAction, ContributorInsightsMode, ContributorInsightsStatus, DestinationStatus, ExportFormat, ExportStatus, ExportType, ExportViewType, GlobalTableSettingsReplicationMode, GlobalTableStatus, ImportStatus, IndexStatus, InputCompressionType, InputFormat, KeyType, MultiRegionConsistency, PointInTimeRecoveryStatus, ProjectionType, ReplicaStatus, ReturnConsumedCapacity, ReturnItemCollectionMetrics, ReturnValue, ReturnValuesOnConditionCheckFailure, S3SseAlgorithm, ScalarAttributeType, Select, SSEStatus, SSEType, StreamViewType, TableClass, TableStatus, TimeToLiveStatus, WitnessStatus } from "./enums";
+import type { ApproximateCreationDateTimePrecision, AttributeAction, BackupStatus, BackupType, BackupTypeFilter, BatchStatementErrorCodeEnum, BillingMode, ComparisonOperator, ConditionalOperator, ContinuousBackupsStatus, ContributorInsightsAction, ContributorInsightsMode, ContributorInsightsStatus, DestinationStatus, ExportFormat, ExportStatus, ExportType, ExportViewType, GlobalTableSettingsReplicationMode, GlobalTableStatus, ImportStatus, IndexStatus, InputCompressionType, InputFormat, KeyType, MultiRegionConsistency, PointInTimeRecoveryStatus, ProjectionType, ReplicaStatus, ReturnConsumedCapacity, ReturnItemCollectionMetrics, ReturnValue, ReturnValuesOnConditionCheckFailure, S3SseAlgorithm, ScalarAttributeType, SearchSchemaElementType, Select, SSEStatus, SSEType, StreamViewType, TableClass, TableStatus, TimeToLiveStatus, VectorDistanceFunction, WitnessStatus } from "./enums";
 /**
  * <p>Contains details of a table archival operation.</p>
  * @public
@@ -728,6 +728,86 @@ export interface TimeToLiveDescription {
      */
     AttributeName?: string | undefined;
 }
+/**
+ * <p>An element in the search schema of a vector index.</p>
+ * @public
+ */
+export interface SearchSchemaElement {
+    /**
+     * <p>The name of the attribute.</p>
+     * @public
+     */
+    AttributeName: string | undefined;
+    /**
+     * <p>The role of the attribute in the search schema. Valid values:</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <code>HASH</code> - A partition key that partitions the vector index for
+     *                     independent scaling. When specified, you must provide this attribute's value
+     *                     in the <code>SearchConditionExpression</code>.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>INLINE_FILTER</code> - An attribute projected into the vector index
+     *                     for filtering at the storage layer during search. Inline filters are
+     *                     optional in the <code>SearchConditionExpression</code>.</p>
+     *             </li>
+     *          </ul>
+     * @public
+     */
+    SearchSchemaElementType: SearchSchemaElementType | undefined;
+}
+/**
+ * <p>The definition of a vector attribute for a vector index.</p>
+ * @public
+ */
+export interface VectorAttributeDefinition {
+    /**
+     * <p>The name of the vector attribute.</p>
+     * @public
+     */
+    AttributeName: string | undefined;
+}
+/**
+ * <p>Contains the configuration of a vector index as it existed at the time a backup
+ *             was created.</p>
+ * @public
+ */
+export interface VectorIndexInfo {
+    /**
+     * <p>The name of the vector index.</p>
+     * @public
+     */
+    IndexName?: string | undefined;
+    /**
+     * <p>The vector attribute configuration for the index.</p>
+     * @public
+     */
+    VectorAttribute?: VectorAttributeDefinition | undefined;
+    /**
+     * <p>The search schema that defines partition key and inline filter attributes for
+     *             the vector index.</p>
+     * @public
+     */
+    SearchSchema?: SearchSchemaElement[] | undefined;
+    /**
+     * <p>Specifies attributes that are copied (projected) from the table into the vector
+     *             index.</p>
+     * @public
+     */
+    Projection?: Projection | undefined;
+    /**
+     * <p>The number of dimensions in each vector.</p>
+     * @public
+     */
+    Dimensions?: number | undefined;
+    /**
+     * <p>The distance function used to calculate similarity between vectors.</p>
+     * @public
+     */
+    DistanceFunction?: VectorDistanceFunction | undefined;
+}
 /**
  * <p>Contains the details of the features enabled on the table when the backup was created.
  *             For example, LSIs, GSIs, streams, TTL. </p>
@@ -764,6 +844,13 @@ export interface SourceTableFeatureDetails {
      * @public
      */
     SSEDescription?: SSEDescription | undefined;
+    /**
+     * <p>The vector index properties for the table at the time the backup was created,
+     *             including the index name, vector attribute, dimensions, distance function, search
+     *             schema, and projection.</p>
+     * @public
+     */
+    VectorIndexes?: VectorIndexInfo[] | undefined;
 }
 /**
  * <p>Contains the description of the backup created for the table.</p>
@@ -885,6 +972,26 @@ export interface Capacity {
      */
     CapacityUnits?: number | undefined;
 }
+/**
+ * <p>The consumed capacity for vector index operations, including vector search request bytes
+ *             and vector write request bytes.</p>
+ * @public
+ */
+export interface VectorCapacity {
+    /**
+     * <p>The number of vector search request bytes consumed by a
+     *             <code>SearchVectors</code> operation.</p>
+     * @public
+     */
+    VectorSearchRequestBytes?: number | undefined;
+    /**
+     * <p>The number of vector write request bytes consumed when writing to a vector index.
+     *             Reported for write operations that modify attributes indexed by a vector
+     *             index.</p>
+     * @public
+     */
+    VectorWriteRequestBytes?: number | undefined;
+}
 /**
  * <p>The capacity units consumed by an operation. The data returned includes the total
  *             provisioned throughput consumed, along with statistics for the table and any indexes
@@ -932,6 +1039,13 @@ export interface ConsumedCapacity {
      * @public
      */
     GlobalSecondaryIndexes?: Record<string, Capacity> | undefined;
+    /**
+     * <p>The amount of throughput consumed on each vector index affected by the operation.
+     *             Each entry contains <code>VectorWriteRequestBytes</code> (for write operations) or
+     *             <code>VectorSearchRequestBytes</code> (for search operations).</p>
+     * @public
+     */
+    VectorIndexes?: Record<string, VectorCapacity> | undefined;
 }
 /**
  * <p>Represents the specific reason why a DynamoDB request was throttled and the
@@ -1841,6 +1955,47 @@ export interface Tag {
      */
     Value: string | undefined;
 }
+/**
+ * <p>Contains the configuration settings for a vector index, including the index name,
+ *             vector attribute, dimensions, distance function, search schema, and
+ *             projection.</p>
+ * @public
+ */
+export interface VectorIndex {
+    /**
+     * <p>The name of the vector index.</p>
+     * @public
+     */
+    IndexName: string | undefined;
+    /**
+     * <p>The vector attribute configuration for the index.</p>
+     * @public
+     */
+    VectorAttribute: VectorAttributeDefinition | undefined;
+    /**
+     * <p>The search schema that defines partition key and inline filter attributes for
+     *             the vector index.</p>
+     * @public
+     */
+    SearchSchema?: SearchSchemaElement[] | undefined;
+    /**
+     * <p>Specifies attributes that are copied (projected) from the table into the vector
+     *             index.</p>
+     * @public
+     */
+    Projection: Projection | undefined;
+    /**
+     * <p>The number of dimensions in each vector.</p>
+     * @public
+     */
+    Dimensions: number | undefined;
+    /**
+     * <p>The distance function used to calculate similarity between vectors. Valid values:
+     *             <code>COSINE</code>, <code>EUCLIDEAN</code>, <code>DOT_PRODUCT</code>.</p>
+     * @public
+     */
+    DistanceFunction: VectorDistanceFunction | undefined;
+}
 /**
  * <p>Represents the input of a <code>CreateTable</code> operation.</p>
  * @public
@@ -2178,6 +2333,50 @@ export interface CreateTableInput {
      * @public
      */
     GlobalTableSettingsReplicationMode?: GlobalTableSettingsReplicationMode | undefined;
+    /**
+     * <p>One or more vector indexes to be created on the table. Each vector index enables
+     *             similarity search on a vector attribute. Each element in the list consists of:</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <code>IndexName</code> - The name of the vector index. Must be unique
+     *                     within the table.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>VectorAttribute</code> - The attribute that contains vector
+     *                     embeddings. If multiple vector indexes reference the same attribute, they
+     *                     must all use the same number of dimensions.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>Dimensions</code> - The number of dimensions in each vector.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>DistanceFunction</code> - The distance function used to calculate
+     *                     similarity. Valid values: <code>COSINE</code>, <code>EUCLIDEAN</code>,
+     *                     <code>DOT_PRODUCT</code>.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>Projection</code> - Specifies attributes that are copied (projected)
+     *                     from the table into the vector index. The total number of projected
+     *                     non-key attributes is shared across the vector attribute (counts as 1)
+     *                     and <code>INLINE_FILTER</code> search schema elements (each counts as 1).
+     *                     <code>HASH</code> search schema elements do not count toward this
+     *                     limit.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>SearchSchema</code> - (Optional) Defines the partition key
+     *                     (<code>HASH</code>) and inline filter (<code>INLINE_FILTER</code>) attributes
+     *                     for the vector index.</p>
+     *             </li>
+     *          </ul>
+     * @public
+     */
+    VectorIndexes?: VectorIndex[] | undefined;
 }
 /**
  * <p>Represents the provisioned throughput settings for the table, consisting of read and
@@ -2209,12 +2408,18 @@ export interface ProvisionedThroughputDescription {
      *             effort than strongly consistent reads, so a setting of 50 <code>ReadCapacityUnits</code>
      *             per second provides 100 eventually consistent <code>ReadCapacityUnits</code> per
      *             second.</p>
+     *          <p>For a table or global secondary index that uses on-demand capacity mode
+     *                 (<code>PAY_PER_REQUEST</code>), this value is <code>0</code>, because on-demand mode
+     *             does not use provisioned throughput.</p>
      * @public
      */
     ReadCapacityUnits?: number | undefined;
     /**
      * <p>The maximum number of writes consumed per second before DynamoDB returns a
      *                 <code>ThrottlingException</code>.</p>
+     *          <p>For a table or global secondary index that uses on-demand capacity mode
+     *                 (<code>PAY_PER_REQUEST</code>), this value is <code>0</code>, because on-demand mode
+     *             does not use provisioned throughput.</p>
      * @public
      */
     WriteCapacityUnits?: number | undefined;
@@ -2450,6 +2655,90 @@ export interface RestoreSummary {
      */
     RestoreInProgress: boolean | undefined;
 }
+/**
+ * <p>Contains the current state and configuration of a vector index, including its
+ *             status, size, item count, and the settings specified when the index was
+ *             created.</p>
+ * @public
+ */
+export interface VectorIndexDescription {
+    /**
+     * <p>The name of the vector index.</p>
+     * @public
+     */
+    IndexName?: string | undefined;
+    /**
+     * <p>The search schema that defines partition key and inline filter attributes for
+     *             the vector index.</p>
+     * @public
+     */
+    SearchSchema?: SearchSchemaElement[] | undefined;
+    /**
+     * <p>Specifies attributes that are copied (projected) from the table into the vector
+     *             index.</p>
+     * @public
+     */
+    Projection?: Projection | undefined;
+    /**
+     * <p>The vector attribute configuration for the index.</p>
+     * @public
+     */
+    VectorAttribute?: VectorAttributeDefinition | undefined;
+    /**
+     * <p>The number of dimensions in each vector.</p>
+     * @public
+     */
+    Dimensions?: number | undefined;
+    /**
+     * <p>The distance function used to calculate similarity between vectors.</p>
+     * @public
+     */
+    DistanceFunction?: VectorDistanceFunction | undefined;
+    /**
+     * <p>The current state of the vector index:</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <code>CREATING</code> - The index is being created.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>ACTIVE</code> - The index is ready for use.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>DELETING</code> - The index is being deleted.</p>
+     *             </li>
+     *          </ul>
+     * @public
+     */
+    IndexStatus?: IndexStatus | undefined;
+    /**
+     * <p>Specifies whether the index is currently backfilling. During backfill,
+     *             <code>SearchVectors</code> operations might return incomplete results.</p>
+     * @public
+     */
+    Backfilling?: boolean | undefined;
+    /**
+     * <p>The total size of the vector index, in bytes. Amazon DynamoDB updates this value
+     *             approximately every six hours. Recent changes might not be reflected in this
+     *             value.</p>
+     * @public
+     */
+    IndexSizeBytes?: number | undefined;
+    /**
+     * <p>The number of items indexed in the vector index. Amazon DynamoDB updates this
+     *             value approximately every six hours. Recent changes might not be reflected in
+     *             this value.</p>
+     * @public
+     */
+    ItemCount?: number | undefined;
+    /**
+     * <p>The Amazon Resource Name (ARN) that uniquely identifies the vector index.</p>
+     * @public
+     */
+    IndexArn?: string | undefined;
+}
 /**
  * <p>Represents the properties of a table.</p>
  * @public
@@ -2588,7 +2877,8 @@ export interface TableDescription {
      */
     TableArn?: string | undefined;
     /**
-     * <p>Unique identifier for the table for which the backup was created. </p>
+     * <p>A unique identifier for the table, in UUID format, generated by DynamoDB when the
+     *             table is created.</p>
      * @public
      */
     TableId?: string | undefined;
@@ -2925,6 +3215,72 @@ export interface TableDescription {
      * @public
      */
     MultiRegionConsistency?: MultiRegionConsistency | undefined;
+    /**
+     * <p>The vector indexes, if any, on the table. Each element is composed of:</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <code>IndexName</code> - The name of the vector index.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>IndexStatus</code> - The current status of the vector index:
+     *                     <code>CREATING</code>, <code>ACTIVE</code>, or
+     *                     <code>DELETING</code>.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>Backfilling</code> - Specifies whether the index is currently
+     *                     backfilling. During backfill, <code>SearchVectors</code> operations might
+     *                     return incomplete results.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>VectorAttribute</code> - The attribute that contains vector
+     *                     embeddings.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>Dimensions</code> - The number of dimensions in each
+     *                     vector.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>DistanceFunction</code> - The distance function used to calculate
+     *                     similarity (<code>COSINE</code>, <code>EUCLIDEAN</code>, or
+     *                     <code>DOT_PRODUCT</code>).</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>SearchSchema</code> - The partition key and inline filter
+     *                     attributes for the vector index.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>Projection</code> - Specifies attributes that are copied
+     *                     (projected) from the table into the vector index.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>IndexArn</code> - The Amazon Resource Name (ARN) that uniquely
+     *                     identifies the index.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>IndexSizeBytes</code> - The total size of the vector index, in
+     *                     bytes. Amazon DynamoDB updates this value approximately every six hours.
+     *                     Recent changes might not be reflected in this value.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>ItemCount</code> - The number of items indexed in the vector
+     *                     index. Amazon DynamoDB updates this value approximately every six hours.
+     *                     Recent changes might not be reflected in this value.</p>
+     *             </li>
+     *          </ul>
+     * @public
+     */
+    VectorIndexes?: VectorIndexDescription[] | undefined;
 }
 /**
  * <p>Represents the output of a <code>CreateTable</code> operation.</p>
@@ -2937,6 +3293,47 @@ export interface CreateTableOutput {
      */
     TableDescription?: TableDescription | undefined;
 }
+/**
+ * <p>A new vector index to be added to a table.</p>
+ * @public
+ */
+export interface CreateVectorIndexAction {
+    /**
+     * <p>The name of the vector index. Must be unique within the table.</p>
+     * @public
+     */
+    IndexName: string | undefined;
+    /**
+     * <p>The attribute that contains vector embeddings. If multiple vector indexes
+     *             reference the same attribute, they must all use the same number of
+     *             dimensions.</p>
+     * @public
+     */
+    VectorAttribute: VectorAttributeDefinition | undefined;
+    /**
+     * <p>The partition key and inline filter attribute definitions for the vector
+     *             index.</p>
+     * @public
+     */
+    SearchSchema?: SearchSchemaElement[] | undefined;
+    /**
+     * <p>Specifies attributes that are copied (projected) from the table into the vector
+     *             index.</p>
+     * @public
+     */
+    Projection: Projection | undefined;
+    /**
+     * <p>The number of dimensions in each vector.</p>
+     * @public
+     */
+    Dimensions: number | undefined;
+    /**
+     * <p>The distance function used to calculate similarity. Valid values:
+     *             <code>COSINE</code>, <code>EUCLIDEAN</code>, <code>DOT_PRODUCT</code>.</p>
+     * @public
+     */
+    DistanceFunction: VectorDistanceFunction | undefined;
+}
 /**
  * <p> Processing options for the CSV file being imported. </p>
  * @public
@@ -3080,6 +3477,17 @@ export interface DeleteTableOutput {
      */
     TableDescription?: TableDescription | undefined;
 }
+/**
+ * <p>A vector index to be removed from a table.</p>
+ * @public
+ */
+export interface DeleteVectorIndexAction {
+    /**
+     * <p>The name of the vector index to delete.</p>
+     * @public
+     */
+    IndexName: string | undefined;
+}
 /**
  * @public
  */
@@ -3282,6 +3690,14 @@ export interface IncrementalExportSpecification {
      * <p>The view type that was chosen for the export. Valid values are
      *                 <code>NEW_AND_OLD_IMAGES</code> and <code>NEW_IMAGES</code>. The default value is
      *                 <code>NEW_AND_OLD_IMAGES</code>.</p>
+     *          <p>
+     *             <code>NEW_AND_OLD_IMAGES</code> exports both the new and old images of each changed
+     *             item, while <code>NEW_IMAGES</code> exports only the new (latest) image. The view type
+     *             you choose determines the structure of each item in the output for
+     *                 <code>insert</code>, <code>update</code>, and <code>delete</code> operations. For
+     *             details and examples of how each view type shapes the export output, see <a href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/S3DataExport.Output.html">DynamoDB table
+     *                 export output format</a> in the <i>Amazon DynamoDB Developer
+     *                 Guide</i>.</p>
      * @public
      */
     ExportViewType?: ExportViewType | undefined;
@@ -3705,6 +4121,12 @@ export interface TableCreationParameters {
      * @public
      */
     GlobalSecondaryIndexes?: GlobalSecondaryIndex[] | undefined;
+    /**
+     * <p>The vector indexes of the table to be created as part of the import
+     *             operation.</p>
+     * @public
+     */
+    VectorIndexes?: VectorIndex[] | undefined;
 }
 /**
  * <p> Represents the properties of the table being imported into.
@@ -4681,8 +5103,7 @@ export interface ImportSummary {
      */
     StartTime?: Date | undefined;
     /**
-     * <p> The time at which this import task ended. (Does this include the successful complete
-     *             creation of the table it was imported to?) </p>
+     * <p> The time at which this import task ended. </p>
      * @public
      */
     EndTime?: Date | undefined;
@@ -4894,6 +5315,14 @@ export interface RestoreTableFromBackupInput {
      * @public
      */
     SSESpecificationOverride?: SSESpecification | undefined;
+    /**
+     * <p>The vector indexes for the restored table. If not specified, all vector indexes
+     *             from the backup are restored. The indexes provided must match existing vector
+     *             indexes from the backup. You can choose to exclude some or all of the vector
+     *             indexes at the time of restore.</p>
+     * @public
+     */
+    VectorIndexOverride?: VectorIndex[] | undefined;
 }
 /**
  * @public
@@ -4945,6 +5374,11 @@ export interface RestoreTableToPointInTimeInput {
      * <p>List of global secondary indexes for the restored table. The indexes provided should
      *             match existing secondary indexes. You can choose to exclude some or all of the indexes
      *             at the time of restore.</p>
+     *          <p>The <code>WarmThroughput</code> setting is not supported on global secondary indexes
+     *             when you use <code>RestoreTableToPointInTime</code>. Although <code>WarmThroughput</code>
+     *             appears in the shared index definition, including it in a
+     *             <code>GlobalSecondaryIndexOverride</code> entry causes the request to fail with a
+     *             validation error.</p>
      * @public
      */
     GlobalSecondaryIndexOverride?: GlobalSecondaryIndex[] | undefined;
@@ -4972,6 +5406,14 @@ export interface RestoreTableToPointInTimeInput {
      * @public
      */
     SSESpecificationOverride?: SSESpecification | undefined;
+    /**
+     * <p>The vector indexes for the restored table. If not specified, all vector indexes
+     *             from the source table are restored. The indexes provided must match existing
+     *             vector indexes from the source table. You can choose to exclude some or all of
+     *             the vector indexes at the time of restore.</p>
+     * @public
+     */
+    VectorIndexOverride?: VectorIndex[] | undefined;
 }
 /**
  * @public
@@ -5589,6 +6031,22 @@ export interface ReplicationGroupUpdate {
      */
     Delete?: DeleteReplicationGroupMemberAction | undefined;
 }
+/**
+ * <p>A vector index to be added to or removed from a table.</p>
+ * @public
+ */
+export interface VectorIndexUpdate {
+    /**
+     * <p>The configuration for creating a new vector index on the table.</p>
+     * @public
+     */
+    Create?: CreateVectorIndexAction | undefined;
+    /**
+     * <p>The configuration for deleting an existing vector index from the table.</p>
+     * @public
+     */
+    Delete?: DeleteVectorIndexAction | undefined;
+}
 /**
  * <p>Represents the input of an <code>UpdateTable</code> operation.</p>
  * @public
@@ -5771,6 +6229,16 @@ export interface UpdateTableInput {
      * @public
      */
     GlobalTableSettingsReplicationMode?: GlobalTableSettingsReplicationMode | undefined;
+    /**
+     * <p>A list of vector indexes to be added to or removed from the table. You can add or
+     *             remove one vector index for each <code>UpdateTable</code> operation.</p>
+     *          <p>To add a vector index, specify <code>IndexName</code>,
+     *             <code>VectorAttribute</code>, <code>Dimensions</code>,
+     *             <code>DistanceFunction</code>, and <code>Projection</code>. To remove a vector
+     *             index, specify only the <code>IndexName</code>.</p>
+     * @public
+     */
+    VectorIndexUpdates?: VectorIndexUpdate[] | undefined;
 }
 /**
  * <p>Represents the output of an <code>UpdateTable</code> operation.</p>
@@ -6958,6 +7426,25 @@ export interface PutRequest {
      */
     Item: Record<string, AttributeValue> | undefined;
 }
+/**
+ * <p>A single result from a <code>SearchVectors</code> operation.</p>
+ * @public
+ */
+export interface SearchResultItem {
+    /**
+     * <p>A map of attribute names to <code>AttributeValue</code> objects, representing the
+     *             projected attributes of the item returned by the vector search.</p>
+     * @public
+     */
+    Item?: Record<string, AttributeValue> | undefined;
+    /**
+     * <p>The similarity score for this item relative to the search vector. The
+     *             interpretation depends on the distance function configured for the vector
+     *             index.</p>
+     * @public
+     */
+    Score?: number | undefined;
+}
 /**
  * <p>Represents a set of primary keys and, for each key, the attributes to retrieve from
  *             the table.</p>
@@ -7145,6 +7632,25 @@ export interface ExecuteTransactionOutput {
      */
     ConsumedCapacity?: ConsumedCapacity[] | undefined;
 }
+/**
+ * @public
+ */
+export interface SearchVectorsOutput {
+    /**
+     * <p>The capacity units consumed by the <code>SearchVectors</code> operation. Contains
+     *             <code>VectorSearchRequestBytes</code>, which represents the vector search capacity
+     *             consumed.</p>
+     * @public
+     */
+    ConsumedCapacity?: VectorCapacity | undefined;
+    /**
+     * <p>A list of items returned by the vector similarity search, sorted by similarity
+     *             with the most similar item first. Each item contains the projected attributes and
+     *             a similarity score.</p>
+     * @public
+     */
+    SearchResults?: SearchResultItem[] | undefined;
+}
 /**
  * @public
  */
@@ -7616,6 +8122,9 @@ export interface TransactWriteItemsOutput {
      * <p>The capacity units consumed by the entire <code>TransactWriteItems</code> operation.
      *             The values of the list are ordered according to the ordering of the
      *                 <code>TransactItems</code> request parameter. </p>
+     *          <p>If the table has vector indexes, each element also includes a
+     *             <code>VectorIndexes</code> field with <code>VectorWriteRequestBytes</code> consumed
+     *             for each affected vector index.</p>
      * @public
      */
     ConsumedCapacity?: ConsumedCapacity[] | undefined;
@@ -7763,6 +8272,95 @@ export interface Put {
      */
     ReturnValuesOnConditionCheckFailure?: ReturnValuesOnConditionCheckFailure | undefined;
 }
+/**
+ * @public
+ */
+export interface SearchVectorsInput {
+    /**
+     * <p>The name or Amazon Resource Name (ARN) of the table containing the vector index.</p>
+     * @public
+     */
+    TableName: string | undefined;
+    /**
+     * <p>The name of the vector index to search. The index must be in the
+     *             <code>ACTIVE</code> state.</p>
+     * @public
+     */
+    IndexName: string | undefined;
+    /**
+     * <p>Determines the level of detail about either provisioned or on-demand throughput
+     *             consumption that is returned in the response:</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <code>INDEXES</code> - The response includes the aggregate
+     *                         <code>ConsumedCapacity</code> for the operation, together with
+     *                         <code>ConsumedCapacity</code> for each table and secondary index that was
+     *                     accessed.</p>
+     *                <p>Note that some operations, such as <code>GetItem</code> and
+     *                         <code>BatchGetItem</code>, do not access any indexes at all. In these cases,
+     *                     specifying <code>INDEXES</code> will only return <code>ConsumedCapacity</code>
+     *                     information for table(s).</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>TOTAL</code> - The response includes only the aggregate
+     *                         <code>ConsumedCapacity</code> for the operation.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>NONE</code> - No <code>ConsumedCapacity</code> details are included in the
+     *                     response.</p>
+     *             </li>
+     *          </ul>
+     * @public
+     */
+    ReturnConsumedCapacity?: ReturnConsumedCapacity | undefined;
+    /**
+     * <p>One or more substitution tokens for attribute names in an expression. Use the
+     *             <code>#</code> character in an expression to dereference an attribute name.</p>
+     * @public
+     */
+    ExpressionAttributeNames?: Record<string, string> | undefined;
+    /**
+     * <p>One or more values that can be substituted in an expression. Use the
+     *             <code>:</code> character in an expression to dereference an attribute value.</p>
+     * @public
+     */
+    ExpressionAttributeValues?: Record<string, AttributeValue> | undefined;
+    /**
+     * <p>A string that identifies one or more attributes to retrieve from the index.
+     *             Separate attribute names with commas. If not specified, the operation returns all
+     *             attributes projected into the vector index.</p>
+     *          <p>Only attributes projected into the vector index can be retrieved.</p>
+     * @public
+     */
+    ProjectionExpression?: string | undefined;
+    /**
+     * <p>The search vector to compare against the indexed vectors. Each element is a 32-bit
+     *             IEEE-754 floating point number, provided in DynamoDB list format.</p>
+     *          <p>The number of dimensions must match the number of dimensions configured for the
+     *             vector index.</p>
+     * @public
+     */
+    SearchVector: AttributeValue[] | undefined;
+    /**
+     * <p>A condition expression used to filter the vector search results. The expression can
+     *             reference attributes defined in the vector index search schema, including
+     *             <code>HASH</code> and <code>INLINE_FILTER</code> key elements.</p>
+     *          <p>Only the equality operator (<code>=</code>) is supported for <code>HASH</code>
+     *             attributes. Comparison and range operators are supported for
+     *             <code>INLINE_FILTER</code> attributes. Only top-level attributes from the search
+     *             schema can be referenced.</p>
+     * @public
+     */
+    SearchConditionExpression?: string | undefined;
+    /**
+     * <p>The number of most similar results to return.</p>
+     * @public
+     */
+    TopK: number | undefined;
+}
 /**
  * <p>Represents a request to perform an <code>UpdateItem</code> operation.</p>
  * @public
@@ -7852,6 +8450,9 @@ export interface DeleteItemOutput {
      *             only returned if the <code>ReturnConsumedCapacity</code> parameter was specified. For
      *             more information, see <a href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/provisioned-capacity-mode.html">Provisioned capacity mode</a> in the <i>Amazon DynamoDB Developer
      *                 Guide</i>.</p>
+     *          <p>If the table has vector indexes, the response includes a
+     *             <code>VectorIndexes</code> field with <code>VectorWriteRequestBytes</code> consumed
+     *             for each affected vector index.</p>
      * @public
      */
     ConsumedCapacity?: ConsumedCapacity | undefined;
@@ -7942,6 +8543,9 @@ export interface PutItemOutput {
      *             returned if the <code>ReturnConsumedCapacity</code> parameter was specified. For more
      *             information, see <a href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/read-write-operations.html#write-operation-consumption">Capacity unity consumption for write operations</a> in the <i>Amazon
      *                 DynamoDB Developer Guide</i>.</p>
+     *          <p>If the table has vector indexes, the response includes a
+     *             <code>VectorIndexes</code> field with <code>VectorWriteRequestBytes</code> consumed
+     *             for each affected vector index.</p>
      * @public
      */
     ConsumedCapacity?: ConsumedCapacity | undefined;
@@ -8104,6 +8708,9 @@ export interface UpdateItemOutput {
      *             only returned if the <code>ReturnConsumedCapacity</code> parameter was specified. For
      *             more information, see <a href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/read-write-operations.html#write-operation-consumption">Capacity unity consumption for write operations</a> in the <i>Amazon
      *                 DynamoDB Developer Guide</i>.</p>
+     *          <p>If the table has vector indexes, the response includes a
+     *             <code>VectorIndexes</code> field with <code>VectorWriteRequestBytes</code> consumed
+     *             for each affected vector index.</p>
      * @public
      */
     ConsumedCapacity?: ConsumedCapacity | undefined;
@@ -8870,6 +9477,23 @@ export interface PutItemInput {
      *          <p>If you specify any attributes that are part of an index key, then the data types for
      *             those attributes must match those of the schema in the table's attribute
      *             definition.</p>
+     *          <p>If the table has vector indexes, the following validations apply to write
+     *             operations. A violation of any of these constraints results in a
+     *             <code>ValidationException</code>:</p>
+     *          <ul>
+     *             <li>
+     *                <p>The vector attribute must be a list of numbers with dimensions matching the
+     *                     index configuration.</p>
+     *             </li>
+     *             <li>
+     *                <p>Vector values must fit in 32-bit IEEE-754 floating point format
+     *                     (f32).</p>
+     *             </li>
+     *             <li>
+     *                <p>Partition key and inline filter attributes defined in the search schema
+     *                     must have data types matching the index schema definition.</p>
+     *             </li>
+     *          </ul>
      *          <p>Empty String and Binary attribute values are allowed. Attribute values of type String
      *             and Binary must have a length greater than zero if the attribute is used as a key
      *             attribute for a table or index.</p>
@@ -9575,6 +10199,9 @@ export interface BatchWriteItemOutput {
      *                   <code>CapacityUnits</code> - The total number of capacity units consumed.</p>
      *             </li>
      *          </ul>
+     *          <p>If the table has vector indexes, each element also includes a
+     *             <code>VectorIndexes</code> field with <code>VectorWriteRequestBytes</code> consumed
+     *             for each affected vector index.</p>
      * @public
      */
     ConsumedCapacity?: ConsumedCapacity[] | undefined;