IBM COS SDK for JavaScript V2 - v1.0.0
    Preparing search index...

    This operation is not supported for directory buckets.

    Returns torrent files from a bucket. BitTorrent can save you bandwidth when you're distributing large files.

    You can get torrent only for objects that are less than 5 GB in size, and that are not encrypted using server-side encryption with a customer-provided encryption key.

    To use GET, you must have READ access to the object.

    This functionality is not supported for Amazon S3 on Outposts.

    The following action is related to GetObjectTorrent:

    You must URL encode any signed header values that contain spaces. For example, if your header value is my file.txt, containing two spaces after my, you must URL encode this value to my%20%20file.txt.

    Use a bare-bones client and the command you need to make an API call.

    import { S3Client, GetObjectTorrentCommand } from "ibm-cos-sdk-v2"; // ES Modules import
    // const { S3Client, GetObjectTorrentCommand } = require("ibm-cos-sdk-v2"); // CommonJS import
    // import type { S3ClientConfig } from "ibm-cos-sdk-v2";
    const config = {}; // type is S3ClientConfig
    const client = new S3Client(config);
    const input = { // GetObjectTorrentRequest
    Bucket: "STRING_VALUE", // required
    Key: "STRING_VALUE", // required
    RequestPayer: "requester",
    ExpectedBucketOwner: "STRING_VALUE",
    };
    const command = new GetObjectTorrentCommand(input);
    const response = await client.send(command);
    // consume or destroy the stream to free the socket.
    const bytes = await response.Body.transformToByteArray();
    // const str = await response.Body.transformToString();
    // response.Body.destroy(); // only applicable to Node.js Readable streams.

    // { // GetObjectTorrentOutput
    // Body: "<SdkStream>", // see \@smithy/types -> StreamingBlobPayloadOutputTypes
    // RequestCharged: "requester",
    // };

    GetObjectTorrentCommandInput

    S3ServiceException

    Base exception class for all service exceptions from S3 service.

    // The following example retrieves torrent files of an object.
    const input = {
    Bucket: "examplebucket",
    Key: "HappyFace.jpg"
    };
    const command = new GetObjectTorrentCommand(input);
    const response = await client.send(command);
    // consume or destroy the stream to free the socket.
    const bytes = await response.Body.transformToByteArray();
    // const str = await response.Body.transformToString();
    // response.Body.destroy(); // only applicable to Node.js Readable streams.

    /* response is
    { /* empty */ }
    */

    Hierarchy

    Index

    Constructors

    Constructors

    • Returns GetObjectTorrentCommand

    • Parameters

      Returns GetObjectTorrentCommand