Kv

The Kv component lets you add a Cloudflare KV storage namespace to your app.

Minimal example

sst.config.ts

const storage = new sst.cloudflare.Kv("MyStorage");

Link to a worker

You can link KV to a worker.

sst.config.ts

new sst.cloudflare.Worker("MyWorker", {
  handler: "./index.ts",
  link: [storage],
  url: true
});

Once linked, you can use the SDK to interact with the bucket.

index.ts

import { Resource } from "sst";

await Resource.MyStorage.get("someKey");

---

Constructor

new Kv(name, args?, opts?)

Parameters

• name string

• args? KvArgs

• opts? ComponentResourceOptions

KvArgs

transform?

Type Object

• namespace?

Transform how this component creates its underlying resources.

transform.namespace?

Type WorkersKvNamespaceArgs | (args: WorkersKvNamespaceArgs, opts: ComponentResourceOptions, name: string) => void

Transform the R2 KV namespace resource.

Properties

id

Type Output<string>

The generated ID of the KV namespace.

nodes

Type Object

• namespace

The underlying resources this component creates.

nodes.namespace

Type WorkersKvNamespace

The Cloudflare KV namespace.

SDK

Use the SDK in your runtime to interact with your infrastructure.

---

Bindings

When you link a KV storage, the storage will be available to the worker and you can interact with it using its API methods.

index.ts

import { Resource } from "sst";

await Resource.MyStorage.get("someKey");