cloudflare/resources/r2/temporary-credentials.d.ts

The official TypeScript library for the Cloudflare API

import { APIResource } from "../../resource.js";
import * as Core from "../../core.js";
export declare class TemporaryCredentials extends APIResource {
    /**
     * Creates temporary access credentials on a bucket that can be optionally scoped
     * to prefixes or objects.
     *
     * @example
     * ```ts
     * const temporaryCredential =
     *   await client.r2.temporaryCredentials.create({
     *     account_id: '023e105f4ecef8ad9ca31a8372d0c353',
     *     bucket: 'example-bucket',
     *     parentAccessKeyId: 'example-access-key-id',
     *     permission: 'object-read-write',
     *     ttlSeconds: 3600,
     *   });
     * ```
     */
    create(params: TemporaryCredentialCreateParams, options?: Core.RequestOptions): Core.APIPromise<TemporaryCredentialCreateResponse>;
}
export interface TemporaryCredential {
    /**
     * Name of the R2 bucket.
     */
    bucket: string;
    /**
     * The parent access key id to use for signing.
     */
    parentAccessKeyId: string;
    /**
     * Permissions allowed on the credentials.
     */
    permission: 'admin-read-write' | 'admin-read-only' | 'object-read-write' | 'object-read-only';
    /**
     * How long the credentials will live for in seconds.
     */
    ttlSeconds: number;
    /**
     * Optional object paths to scope the credentials to.
     */
    objects?: Array<string>;
    /**
     * Optional prefix paths to scope the credentials to.
     */
    prefixes?: Array<string>;
}
export interface TemporaryCredentialCreateResponse {
    /**
     * ID for new access key.
     */
    accessKeyId?: string;
    /**
     * Secret access key.
     */
    secretAccessKey?: string;
    /**
     * Security token.
     */
    sessionToken?: string;
}
export interface TemporaryCredentialCreateParams {
    /**
     * Path param: Account ID.
     */
    account_id: string;
    /**
     * Body param: Name of the R2 bucket.
     */
    bucket: string;
    /**
     * Body param: The parent access key id to use for signing.
     */
    parentAccessKeyId: string;
    /**
     * Body param: Permissions allowed on the credentials.
     */
    permission: 'admin-read-write' | 'admin-read-only' | 'object-read-write' | 'object-read-only';
    /**
     * Body param: How long the credentials will live for in seconds.
     */
    ttlSeconds: number;
    /**
     * Body param: Optional object paths to scope the credentials to.
     */
    objects?: Array<string>;
    /**
     * Body param: Optional prefix paths to scope the credentials to.
     */
    prefixes?: Array<string>;
}
export declare namespace TemporaryCredentials {
    export { type TemporaryCredential as TemporaryCredential, type TemporaryCredentialCreateResponse as TemporaryCredentialCreateResponse, type TemporaryCredentialCreateParams as TemporaryCredentialCreateParams, };
}
//# sourceMappingURL=temporary-credentials.d.ts.map