Class PutPublicAccessBlockCommandProtected

Creates or modifies the PublicAccessBlock configuration for an Amazon S3 bucket. To use this operation, you must have the s3:PutBucketPublicAccessBlock permission. For more information about Amazon S3 permissions, see Specifying Permissions in a Policy.

When Amazon S3 evaluates the PublicAccessBlock configuration for a bucket or an object, it checks the PublicAccessBlock configuration for both the bucket (or the bucket that contains the object) and the bucket owner's account. If the PublicAccessBlock configurations are different between the bucket and the account, Amazon S3 uses the most restrictive combination of the bucket-level and account-level settings.

For more information about when Amazon S3 considers a bucket or an object public, see The Meaning of "Public".

Related Resources

• GetPublicAccessBlock

• DeletePublicAccessBlock

• GetBucketPolicyStatus

• Using Amazon S3 Block Public Access

Example

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

import { S3Client, PutPublicAccessBlockCommand } from "@aws-sdk/client-s3"; // ES Modules import
// const { S3Client, PutPublicAccessBlockCommand } = require("@aws-sdk/client-s3"); // CommonJS import
const client = new S3Client(config);
const input = {
  Bucket: "STRING_VALUE", // required
  ContentMD5: "STRING_VALUE",
  ChecksumAlgorithm: "CRC32" || "CRC32C" || "SHA1" || "SHA256",
  PublicAccessBlockConfiguration: {
    BlockPublicAcls: true || false,
    IgnorePublicAcls: true || false,
    BlockPublicPolicy: true || false,
    RestrictPublicBuckets: true || false,
  },
  ExpectedBucketOwner: "STRING_VALUE",
};
const command = new PutPublicAccessBlockCommand(input);
const response = await client.send(command);

Param

PutPublicAccessBlockCommandInput

Returns

PutPublicAccessBlockCommandOutput

See

• PutPublicAccessBlockCommandInput for command's input shape.
• PutPublicAccessBlockCommandOutput for command's response shape.
• config for S3Client's config shape.