VectorBucket

Source: src/AWS/S3Vectors/VectorBucket.ts

An Amazon S3 Vectors bucket — durable storage for vector embeddings, queryable by similarity. Create one or more Indexes inside it to store and query vectors.

S3 Vectors is in preview; availability varies by region.

Creating a Vector Bucket

Basic Vector Bucket

import * as S3Vectors from "alchemy/AWS/S3Vectors";

const bucket = yield* S3Vectors.VectorBucket("Embeddings", {});

Vector Bucket with KMS Encryption

const bucket = yield* S3Vectors.VectorBucket("Embeddings", {
  encryption: { sseType: "aws:kms", kmsKeyArn: key.keyArn },
});

Bucket Policy

const bucket = yield* S3Vectors.VectorBucket("Embeddings", {
  vectorBucketName: "shared-embeddings",
  policy: [
    {
      Effect: "Allow",
      Principal: { AWS: "arn:aws:iam::123456789012:root" },
      Action: ["s3vectors:GetVectors", "s3vectors:QueryVectors"],
      Resource:
        "arn:aws:s3vectors:us-east-1:999999999999:bucket/shared-embeddings/index/*",
    },
  ],
});