cloudflare
Version:
The official TypeScript library for the Cloudflare API
48 lines • 2.56 kB
JavaScript
// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
import { APIResource } from "../../../resource.mjs";
import * as Core from "../../../core.mjs";
export class Values extends APIResource {
/**
* Write a value identified by a key. Use URL-encoding to use special characters
* (for example, `:`, `!`, `%`) in the key name. Body should be the value to be
* stored. If JSON metadata to be associated with the key/value pair is needed, use
* `multipart/form-data` content type for your PUT request (see dropdown below in
* `REQUEST BODY SCHEMA`). Existing values, expirations, and metadata will be
* overwritten. If neither `expiration` nor `expiration_ttl` is specified, the
* key-value pair will never expire. If both are set, `expiration_ttl` is used and
* `expiration` is ignored.
*/
update(namespaceId, keyName, params, options) {
const { account_id, expiration, expiration_ttl, ...body } = params;
return this._client.put(`/accounts/${account_id}/storage/kv/namespaces/${namespaceId}/values/${keyName}`, Core.maybeMultipartFormRequestOptions({
query: { expiration, expiration_ttl },
body,
...options,
headers: { 'Content-Type': '*/*', ...options?.headers },
}))._thenUnwrap((obj) => obj.result);
}
/**
* Remove a KV pair from the namespace. Use URL-encoding to use special characters
* (for example, `:`, `!`, `%`) in the key name.
*/
delete(namespaceId, keyName, params, options) {
const { account_id } = params;
return this._client.delete(`/accounts/${account_id}/storage/kv/namespaces/${namespaceId}/values/${keyName}`, options)._thenUnwrap((obj) => obj.result);
}
/**
* Returns the value associated with the given key in the given namespace. Use
* URL-encoding to use special characters (for example, `:`, `!`, `%`) in the key
* name. If the KV-pair is set to expire at some point, the expiration time as
* measured in seconds since the UNIX epoch will be returned in the `expiration`
* response header.
*/
get(namespaceId, keyName, params, options) {
const { account_id } = params;
return this._client.get(`/accounts/${account_id}/storage/kv/namespaces/${namespaceId}/values/${keyName}`, {
...options,
headers: { Accept: 'application/octet-stream', ...options?.headers },
__binaryResponse: true,
});
}
}
//# sourceMappingURL=values.mjs.map