Class PutBucketOwnershipControlsCommandProtected

Creates or modifies OwnershipControls for an Amazon S3 bucket. To use this operation, you must have the s3:PutBucketOwnershipControls permission. For more information about Amazon S3 permissions, see Specifying permissions in a policy.

For information about Amazon S3 Object Ownership, see Using object ownership.

The following operations are related to PutBucketOwnershipControls:

• GetBucketOwnershipControls

• DeleteBucketOwnershipControls

Example

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

import { S3Client, PutBucketOwnershipControlsCommand } from "@aws-sdk/client-s3"; // ES Modules import
// const { S3Client, PutBucketOwnershipControlsCommand } = require("@aws-sdk/client-s3"); // CommonJS import
const client = new S3Client(config);
const input = { // PutBucketOwnershipControlsRequest
  Bucket: "STRING_VALUE", // required
  ContentMD5: "STRING_VALUE",
  ExpectedBucketOwner: "STRING_VALUE",
  OwnershipControls: { // OwnershipControls
    Rules: [ // OwnershipControlsRules // required
      { // OwnershipControlsRule
        ObjectOwnership: "BucketOwnerPreferred" || "ObjectWriter" || "BucketOwnerEnforced", // required
      },
    ],
  },
};
const command = new PutBucketOwnershipControlsCommand(input);
const response = await client.send(command);
// {};

Param

PutBucketOwnershipControlsCommandInput

Returns

PutBucketOwnershipControlsCommandOutput

See

• PutBucketOwnershipControlsCommandInput for command's input shape.
• PutBucketOwnershipControlsCommandOutput for command's response shape.
• config for S3Client's config shape.

Throws

S3ServiceException

Base exception class for all service exceptions from S3 service.