com.amazonaws.services.s3.model

## クラス BucketNotificationConfiguration

- java.lang.Object
- - com.amazonaws.services.s3.model.BucketNotificationConfiguration

-     public class BucketNotificationConfiguration
      extends java.lang.Object

  Represents a bucket's notification configuration. The notification configuration is used to control reception of notifications for specific events for Amazon S3 buckets.

  Using SNS as the delivery service, the notification configuration of an Amazon S3 bucket provides near real-time notifications of events the user is interested in. Notification is turned on by enabling configuration on a bucket, specifying the events and the SNS topic. This configuration can only be turned on by the bucket owner.

  If a notification configuration already exists for the specified bucket, the new notification configuration will replace the existing notification configuration. To remove a notification configuration, pass an an empty configuration directly to `AmazonS3.setBucketNotificationConfiguration(String,BucketNotificationConfiguration)`.

  Note: Currently buckets may only have a single event and topic configuration.

  関連項目:
    `AmazonS3.getBucketNotificationConfiguration(String)`, `AmazonS3.setBucketNotificationConfiguration(String, BucketNotificationConfiguration)`

- - ### ネストされたクラスの概要

    ネストされたクラス
    修飾子とタイプ | クラスと説明
    --- | ---
    `static class` | `BucketNotificationConfiguration.TopicConfiguration` Represents the SNS topic to publish event notification to.

  - ### コンストラクタの概要

    コンストラクタ
    コンストラクタと説明
    `BucketNotificationConfiguration()` Creates a new bucket notification configuration.
    `BucketNotificationConfiguration(java.util.Collection<BucketNotificationConfiguration.TopicConfiguration> topicConfigurations)` Creates a new bucket notification configuration containing the specified `TopicConfigurations`.

  - ### メソッドの概要

    メソッド
    修飾子とタイプ | メソッドと説明
    --- | ---
    `java.util.List<BucketNotificationConfiguration.TopicConfiguration>` | `getTopicConfigurations()` Gets the list of `BucketNotificationConfiguration.TopicConfiguration` objects contained in this object.
    `void` | `setTopicConfigurations(java.util.Collection<BucketNotificationConfiguration.TopicConfiguration> topicConfigurations)` Sets the `BucketNotificationConfiguration.TopicConfiguration`.
    `java.lang.String` | `toString()`
    `BucketNotificationConfiguration` | `withTopicConfigurations(BucketNotificationConfiguration.TopicConfiguration... topicConfigurations)` Sets the `BucketNotificationConfiguration.TopicConfiguration` `TopicConfigurations` and returns this object, enabling additional method calls to be chained together.

    - ### クラスから継承されたメソッド java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

- - ### コンストラクタの詳細

    - #### BucketNotificationConfiguration

          public BucketNotificationConfiguration()

      Creates a new bucket notification configuration. By default, the newly created configuration is empty.

      Passing the new configuration directly to `AmazonS3.setBucketNotificationConfiguration(String,BucketNotificationConfiguration)` will remove any existing bucket notification configuration.

      関連項目:
        `BucketNotificationConfiguration(Collection)`

    - #### BucketNotificationConfiguration

          public BucketNotificationConfiguration(java.util.Collection<BucketNotificationConfiguration.TopicConfiguration> topicConfigurations)

      Creates a new bucket notification configuration containing the specified `TopicConfigurations`.

      Passing the new configuration directly to `AmazonS3.setBucketNotificationConfiguration(String,BucketNotificationConfiguration)` will set the bucket's notification configuration and overwrite any existing configuration.

      関連項目:
        `BucketNotificationConfiguration()`

  - ### メソッドの詳細

    - #### withTopicConfigurations

          public BucketNotificationConfiguration withTopicConfigurations(BucketNotificationConfiguration.TopicConfiguration... topicConfigurations)

      Sets the `BucketNotificationConfiguration.TopicConfiguration` `TopicConfigurations` and returns this object, enabling additional method calls to be chained together.

      Calling this method will overwrite any previously set `TopicConfigurations` for this object.

      パラメータ:
        `topicConfigurations` - A set of topic configurations.
      戻り値:
        The updated `BucketNotificationConfiguration` object, enabling additional method calls to be chained together.
      関連項目:
        `setTopicConfigurations(Collection)`

    - #### setTopicConfigurations

          public void setTopicConfigurations(java.util.Collection<BucketNotificationConfiguration.TopicConfiguration> topicConfigurations)

      Sets the `BucketNotificationConfiguration.TopicConfiguration`.

      Calling this method will overwrite any previously set `TopicConfigurations` for this object.

      パラメータ:
        `topicConfigurations` - A collection of topic configurations.
      関連項目:
        `BucketNotificationConfiguration#withTopicConfigurations(TopicConfiguration)`

    - #### getTopicConfigurations

          public java.util.List<BucketNotificationConfiguration.TopicConfiguration> getTopicConfigurations()

      Gets the list of `BucketNotificationConfiguration.TopicConfiguration` objects contained in this object. This method may return an empty list if no `TopicConfiguration` objects are present.

      戻り値:
        The list of `TopicConfiguration` objects contained in this object. May return an empty list.

    - #### toString

          public java.lang.String toString()

      オーバーライド:
        `toString` クラス内 `java.lang.Object`