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

    Class PutBucketRequestPaymentCommand

    This operation is not supported for directory buckets.

    Sets the request payment configuration for a bucket. By default, the bucket owner pays for downloads from the bucket. This configuration parameter enables the bucket owner (only) to specify that the person requesting the download will be charged for the download. For more information, see Requester Pays Buckets.

    The following operations are related to PutBucketRequestPayment:

    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, PutBucketRequestPaymentCommand } from "ibm-cos-sdk-v2"; // ES Modules import
    // const { S3Client, PutBucketRequestPaymentCommand } = 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 = { // PutBucketRequestPaymentRequest
    Bucket: "STRING_VALUE", // required
    ContentMD5: "STRING_VALUE",
    ChecksumAlgorithm: "CRC32" || "CRC32C" || "SHA1" || "SHA256" || "CRC64NVME",
    RequestPaymentConfiguration: { // RequestPaymentConfiguration
    Payer: "Requester" || "BucketOwner", // required
    },
    ExpectedBucketOwner: "STRING_VALUE",
    };
    const command = new PutBucketRequestPaymentCommand(input);
    const response = await client.send(command);
    // {};

    PutBucketRequestPaymentCommandInput

    S3ServiceException

    Base exception class for all service exceptions from S3 service.

    // The following example sets request payment configuration on a bucket so that person requesting the download is charged.
    const input = {
    Bucket: "examplebucket",
    RequestPaymentConfiguration: {
    Payer: "Requester"
    }
    };
    const command = new PutBucketRequestPaymentCommand(input);
    const response = await client.send(command);
    /* response is
    { /* metadata only */ }
    */

    Hierarchy

    Index

    Constructors

    Constructors

    • Returns PutBucketRequestPaymentCommand

    • Parameters

      Returns PutBucketRequestPaymentCommand