@backblaze-labs/b2-sdk - v0.1.0
    Preparing search index...

    Interface FileVersion

    Complete metadata for a single file version in B2. Returned by b2_get_file_info, b2_list_file_names, b2_list_file_versions, b2_upload_file, b2_copy_file, and other file-related endpoints.

    interface FileVersion {
        accountId: AccountId;
        action: FileAction;
        bucketId: BucketId;
        contentLength: number;
        contentMd5: string | null;
        contentSha1: string | null;
        contentType: string;
        fileId: FileId;
        fileInfo: Record<string, string>;
        fileName: string;
        fileRetention: {
            isClientAuthorizedToRead: boolean;
            value: FileRetentionValue | null;
        };
        legalHold: {
            isClientAuthorizedToRead: boolean;
            value: LegalHoldValue
            | null;
        };
        replicationStatus: "pending"
        | "completed"
        | "failed"
        | "replica"
        | null;
        serverSideEncryption: EncryptionSetting;
        uploadTimestamp: number;
    }
    Index

    Properties

    accountId: AccountId

    Account that owns this file.

    action: FileAction

    Action that created this file version.

    bucketId: BucketId

    Bucket containing this file.

    contentLength: number

    Size of the file content in bytes.

    contentMd5: string | null

    MD5 checksum of the content, or null if not available.

    contentSha1: string | null

    SHA-1 checksum of the content, or null if not available (e.g., large files).

    contentType: string

    MIME type of the file content.

    fileId: FileId

    Unique identifier for this file version.

    fileInfo: Record<string, string>

    User-defined key-value metadata stored with the file.

    fileName: string

    Full path and name of the file within the bucket.

    fileRetention: {
        isClientAuthorizedToRead: boolean;
        value: FileRetentionValue | null;
    }

    Object Lock retention settings for this file version.

    Type Declaration

    • ReadonlyisClientAuthorizedToRead: boolean

      Whether the caller is authorized to read retention settings.

    • Readonlyvalue: FileRetentionValue | null

      Retention settings, or null if the caller lacks read authorization.

    legalHold: { isClientAuthorizedToRead: boolean; value: LegalHoldValue | null }

    Legal hold status for this file version.

    Type Declaration

    • ReadonlyisClientAuthorizedToRead: boolean

      Whether the caller is authorized to read legal hold status.

    • Readonlyvalue: LegalHoldValue | null

      Legal hold value, or null if the caller lacks read authorization.

    replicationStatus: "pending" | "completed" | "failed" | "replica" | null

    Replication status, or null if replication is not configured.

    serverSideEncryption: EncryptionSetting

    Server-side encryption settings applied to this file version.

    uploadTimestamp: number

    UTC timestamp (milliseconds) when this version was uploaded.