GetBucketNotificationConfigurationCommand

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

GetBucketNotificationConfigurationCommandInput

[GetBucketNotificationConfigurationCommandInput](@aws-sdk/client-s3!GetBucketNotificationConfigurationCommandInput:Interface)

<note> This operation is not supported for directory buckets. </note> Returns the notification configuration of a bucket. If notifications are not enabled on the bucket, the action returns an empty <code>NotificationConfiguration</code> element. By default, you must be the bucket owner to read the notification configuration of a bucket. However, the bucket owner can use a bucket policy to grant permission to other users to read this configuration with the <code>s3:GetBucketNotification</code> permission. When you use this API operation with an access point, provide the alias of the access point in place of the bucket name. When you use this API operation with an Object Lambda access point, provide the alias of the Object Lambda access point in place of the bucket name. If the Object Lambda access point alias in a request is not valid, the error code <code>InvalidAccessPointAliasError</code> is returned. For more information about <code>InvalidAccessPointAliasError</code>, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList">List of Error Codes</a>. For more information about setting and reading the notification configuration on a bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html">Setting Up Notification of Bucket Events</a>. For more information about bucket policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies</a>. The following action is related to <code>GetBucketNotification</code>: <ul> <li> <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotification.html">PutBucketNotification</a> </li> </ul>

Bucket

The name of the bucket for which to get the notification configuration. When you use this API operation with an access point, provide the alias of the access point in place of the bucket name. When you use this API operation with an Object Lambda access point, provide the alias of the Object Lambda access point in place of the bucket name. If the Object Lambda access point alias in a request is not valid, the error code <code>InvalidAccessPointAliasError</code> is returned. For more information about <code>InvalidAccessPointAliasError</code>, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList">List of Error Codes</a>. Note: To supply the Multi-region Access Point (MRAP) to Bucket, you need to install the "aws-sdk/signature-v4-crt" package to your project dependencies. For more information, please go to https://github.com/aws/aws-sdk-js-v3#known-issues

ExpectedBucketOwner

The account ID of the expected bucket owner. If the account ID that you provide does not match the actual owner of the bucket, the request fails with the HTTP status code <code>403 Forbidden</code> (access denied).

The input for [GetBucketNotificationConfigurationCommand](@aws-sdk/client-s3!GetBucketNotificationConfigurationCommand:Class).

$metadata

EventBridgeConfiguration

Enables delivery of events to Amazon EventBridge.

LambdaFunctionConfigurations

Describes the Lambda functions to invoke and the events for which to invoke them.

QueueConfigurations

The Amazon Simple Queue Service queues to publish messages to and the events for which to publish messages.

TopicConfigurations

The topic to which notifications are sent and the events for which notifications are generated.

GetBucketNotificationConfigurationCommandOutput

The output of [GetBucketNotificationConfigurationCommand](@aws-sdk/client-s3!GetBucketNotificationConfigurationCommand:Class).

$fault

$response

$retryable

(constructor)

options

Constructs a new instance of the <code>ServiceException</code> class

[Symbol.hasInstance]

instance

Custom instanceof check to support the operator for ServiceException base class

isInstance

value

Checks if a value is an instance of ServiceException (duck typed)

S3ServiceException

Base exception class for all service exceptions from S3 service.