Jump to Content

Class GetBucketCorsCommandProtected

Returns the Cross-Origin Resource Sharing (CORS) configuration information set for the bucket.

To use this operation, you must have permission to perform the s3:GetBucketCORS action. By default, the bucket owner has this permission and can grant it to others.

For more information about CORS, see Enabling Cross-Origin Resource Sharing.

The following operations are related to GetBucketCors:

Example

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

import { S3Client, GetBucketCorsCommand } from "@aws-sdk/client-s3"; // ES Modules import
// const { S3Client, GetBucketCorsCommand } = require("@aws-sdk/client-s3"); // CommonJS import
const client = new S3Client(config);
const command = new GetBucketCorsCommand(input);
const response = await client.send(command);

See

Example

To get cors configuration set on a bucket

// The following example returns cross-origin resource sharing (CORS) configuration set on a bucket.
const input = {
"Bucket": "examplebucket"
};
const command = new GetBucketCorsCommand(input);
const response = await client.send(command);
/* response ==
{
"CORSRules": [
{
"AllowedHeaders": [
"Authorization"
],
"AllowedMethods": [
"GET"
],
"AllowedOrigins": [
"*"
],
"MaxAgeSeconds": 3000
}
]
}
*/
// example id: to-get-cors-configuration-set-on-a-bucket-1481596855475

Hierarchy

Constructors

Properties

middlewareStack: MiddlewareStack<GetBucketCorsCommandInput, GetBucketCorsCommandOutput>

Methods