@pulumi/aws 7.35.0 → 7.36.0-alpha.1783668310

package/pinpoint/smsvoicev2Pool.js

@@ -0,0 +1,193 @@
+"use strict";
+// *** WARNING: this file was generated by pulumi-language-nodejs. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Smsvoicev2Pool = void 0;
+const pulumi = __importStar(require("@pulumi/pulumi"));
+const utilities = __importStar(require("../utilities"));
+/**
+ * Manages an AWS End User Messaging SMS Pool.
+ *
+ * ## Example Usage
+ *
+ * ### Basic Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const example = new aws.pinpoint.Smsvoicev2PhoneNumber("example", {
+ *     isoCountryCode: "US",
+ *     messageType: "TRANSACTIONAL",
+ *     numberType: "SIMULATOR",
+ *     numberCapabilities: ["SMS"],
+ * });
+ * const exampleSmsvoicev2Pool = new aws.pinpoint.Smsvoicev2Pool("example", {
+ *     isoCountryCode: "US",
+ *     messageType: "TRANSACTIONAL",
+ *     originationIdentities: [example.arn],
+ *     tags: {
+ *         Name: "example",
+ *     },
+ * });
+ * ```
+ *
+ * ### Two-Way Channel
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const example = new aws.sns.Topic("example", {name: "example-two-way-channel"});
+ * const exampleRole = new aws.iam.Role("example", {
+ *     name: "example-pool-two-way",
+ *     assumeRolePolicy: JSON.stringify({
+ *         Version: "2012-10-17",
+ *         Statement: [{
+ *             Effect: "Allow",
+ *             Principal: {
+ *                 Service: "sms-voice.amazonaws.com",
+ *             },
+ *             Action: "sts:AssumeRole",
+ *         }],
+ *     }),
+ * });
+ * const exampleSmsvoicev2PhoneNumber = new aws.pinpoint.Smsvoicev2PhoneNumber("example", {
+ *     isoCountryCode: "US",
+ *     messageType: "TRANSACTIONAL",
+ *     numberType: "SIMULATOR",
+ *     numberCapabilities: ["SMS"],
+ * });
+ * const exampleSmsvoicev2Pool = new aws.pinpoint.Smsvoicev2Pool("example", {
+ *     isoCountryCode: "US",
+ *     messageType: "TRANSACTIONAL",
+ *     originationIdentities: [exampleSmsvoicev2PhoneNumber.arn],
+ *     twoWayEnabled: true,
+ *     twoWayChannelArn: example.arn,
+ *     twoWayChannelRole: exampleRole.arn,
+ *     tags: {
+ *         Name: "example",
+ *     },
+ * });
+ * ```
+ *
+ * ## Import
+ *
+ * > **Note:** `isoCountryCode` is never returned by AWS, so importing a pool with `isoCountryCode` set plans a replacement until removed from config.
+ *
+ * ### Identity Schema
+ *
+ * #### Required
+ *
+ * * `id` - (String) ID of the Pool.
+ *
+ * #### Optional
+ *
+ * * `accountId` (String) AWS Account where this resource is managed.
+ * * `region` (String) Region where this resource is managed.
+ *
+ * Using `pulumi import`, import an AWS End User Messaging SMS Pool using the `id`. For example:
+ *
+ * ```sh
+ * $ pulumi import aws:pinpoint/smsvoicev2Pool:Smsvoicev2Pool example pool-abcdef0123456789abcdef0123456789
+ * ```
+ */
+class Smsvoicev2Pool extends pulumi.CustomResource {
+    /**
+     * Get an existing Smsvoicev2Pool resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name, id, state, opts) {
+        return new Smsvoicev2Pool(name, state, { ...opts, id: id });
+    }
+    /** @internal */
+    static __pulumiType = 'aws:pinpoint/smsvoicev2Pool:Smsvoicev2Pool';
+    /**
+     * Returns true if the given object is an instance of Smsvoicev2Pool.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj) {
+        if (obj === undefined || obj === null) {
+            return false;
+        }
+        return obj['__pulumiType'] === Smsvoicev2Pool.__pulumiType;
+    }
+    constructor(name, argsOrState, opts) {
+        let resourceInputs = {};
+        opts = opts || {};
+        if (opts.id) {
+            const state = argsOrState;
+            resourceInputs["arn"] = state?.arn;
+            resourceInputs["deletionProtectionEnabled"] = state?.deletionProtectionEnabled;
+            resourceInputs["isoCountryCode"] = state?.isoCountryCode;
+            resourceInputs["messageType"] = state?.messageType;
+            resourceInputs["optOutListName"] = state?.optOutListName;
+            resourceInputs["originationIdentities"] = state?.originationIdentities;
+            resourceInputs["region"] = state?.region;
+            resourceInputs["selfManagedOptOutsEnabled"] = state?.selfManagedOptOutsEnabled;
+            resourceInputs["sharedRoutesEnabled"] = state?.sharedRoutesEnabled;
+            resourceInputs["tags"] = state?.tags;
+            resourceInputs["tagsAll"] = state?.tagsAll;
+            resourceInputs["timeouts"] = state?.timeouts;
+            resourceInputs["twoWayChannelArn"] = state?.twoWayChannelArn;
+            resourceInputs["twoWayChannelRole"] = state?.twoWayChannelRole;
+            resourceInputs["twoWayEnabled"] = state?.twoWayEnabled;
+        }
+        else {
+            const args = argsOrState;
+            if (args?.messageType === undefined && !opts.urn) {
+                throw new Error("Missing required property 'messageType'");
+            }
+            if (args?.originationIdentities === undefined && !opts.urn) {
+                throw new Error("Missing required property 'originationIdentities'");
+            }
+            resourceInputs["deletionProtectionEnabled"] = args?.deletionProtectionEnabled;
+            resourceInputs["isoCountryCode"] = args?.isoCountryCode;
+            resourceInputs["messageType"] = args?.messageType;
+            resourceInputs["optOutListName"] = args?.optOutListName;
+            resourceInputs["originationIdentities"] = args?.originationIdentities;
+            resourceInputs["region"] = args?.region;
+            resourceInputs["selfManagedOptOutsEnabled"] = args?.selfManagedOptOutsEnabled;
+            resourceInputs["sharedRoutesEnabled"] = args?.sharedRoutesEnabled;
+            resourceInputs["tags"] = args?.tags;
+            resourceInputs["timeouts"] = args?.timeouts;
+            resourceInputs["twoWayChannelArn"] = args?.twoWayChannelArn;
+            resourceInputs["twoWayChannelRole"] = args?.twoWayChannelRole;
+            resourceInputs["twoWayEnabled"] = args?.twoWayEnabled;
+            resourceInputs["arn"] = undefined /*out*/;
+            resourceInputs["tagsAll"] = undefined /*out*/;
+        }
+        opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts);
+        super(Smsvoicev2Pool.__pulumiType, name, resourceInputs, opts);
+    }
+}
+exports.Smsvoicev2Pool = Smsvoicev2Pool;
+//# sourceMappingURL=smsvoicev2Pool.js.map

package/pinpoint/smsvoicev2Pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smsvoicev2Pool.js","sourceRoot":"","sources":["../../pinpoint/smsvoicev2Pool.ts"],"names":[],"mappings":"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"}

package/s3/bucketNotification.d.ts

@@ -4,7 +4,7 @@ import * as outputs from "../types/output";
 /**
  * Manages a S3 Bucket Notification Configuration. For additional information, see the [Configuring S3 Event Notifications section in the Amazon S3 Developer Guide](https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html).
  *
- * > **NOTE:** S3 Buckets only support a single notification configuration resource. Declaring multiple `aws.s3.BucketNotification` resources to the same S3 Bucket will cause a perpetual difference in configuration. This resource will overwrite any existing event notifications configured for the S3 bucket it's associated with. See the example "Trigger multiple Lambda functions" for an option of how to configure multiple triggers within this resource.
+ * > **NOTE:** The S3 [`PutBucketNotificationConfiguration`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotificationConfiguration.html) API is atomic — it replaces the bucket's entire notification configuration on every call. Only one `aws.s3.BucketNotification` resource can manage a bucket; declaring more than one causes a perpetual diff, and applying this resource will overwrite any notifications already on the bucket. To configure multiple destinations on the same bucket, declare them all as nested blocks within a single resource (see Trigger multiple Lambda functions below). To let independent teams or Terraform configurations subscribe to the same bucket without stepping on each other, prefer the Emit events to EventBridge pattern below. To bring existing notifications under management without losing them, see the `aws.s3.BucketNotification` data source.
  *
  * > This resource cannot be used with S3 directory buckets.
  *
@@ -254,17 +254,66 @@ import * as outputs from "../types/output";
  *
  * ### Emit events to EventBridge
  *
+ * For a bucket shared by multiple independent consumers — different teams, different Terraform configurations, different applications — EventBridge is the recommended pattern. Each consumer subscribes to the bucket through its own `aws.cloudwatch.EventRule`, so they cannot overwrite one another the way notification configurations would.
+ *
  * ```typescript
  * import * as pulumi from "@pulumi/pulumi";
  * import * as aws from "@pulumi/aws";
  *
- * const bucket = new aws.s3.Bucket("bucket", {bucket: "your-bucket-name"});
- * const bucketNotification = new aws.s3.BucketNotification("bucket_notification", {
- *     bucket: bucket.id,
+ * const shared = new aws.s3.Bucket("shared", {bucket: "shared-bucket"});
+ * const sharedBucketNotification = new aws.s3.BucketNotification("shared", {
+ *     bucket: shared.id,
  *     eventbridge: true,
  * });
+ * // Team A: process new uploads under uploads/
+ * const teamA = new aws.cloudwatch.EventRule("team_a", {
+ *     name: "team-a-uploads",
+ *     eventPattern: pulumi.jsonStringify({
+ *         source: ["aws.s3"],
+ *         "detail-type": ["Object Created"],
+ *         detail: {
+ *             bucket: {
+ *                 name: [shared.bucket],
+ *             },
+ *             object: {
+ *                 key: [{
+ *                     prefix: "uploads/",
+ *                 }],
+ *             },
+ *         },
+ *     }),
+ * });
+ * const teamAEventTarget = new aws.cloudwatch.EventTarget("team_a", {
+ *     rule: teamA.name,
+ *     arn: teamAProcessor.arn,
+ * });
+ * // Team B: archive deletions under archive/, declared in a separate
+ * // Terraform configuration that knows nothing about Team A.
+ * const teamB = new aws.cloudwatch.EventRule("team_b", {
+ *     name: "team-b-deletions",
+ *     eventPattern: pulumi.jsonStringify({
+ *         source: ["aws.s3"],
+ *         "detail-type": ["Object Deleted"],
+ *         detail: {
+ *             bucket: {
+ *                 name: [shared.bucket],
+ *             },
+ *             object: {
+ *                 key: [{
+ *                     prefix: "archive/",
+ *                 }],
+ *             },
+ *         },
+ *     }),
+ * });
+ * const teamBEventTarget = new aws.cloudwatch.EventTarget("team_b", {
+ *     rule: teamB.name,
+ *     arn: teamBArchive.arn,
+ * });
  * ```
  *
+ * For sharing a bucket between Terraform configurations when EventBridge is not an option, use the `aws.s3.BucketNotification` data source to read existing notifications and re-emit them in your own resource.
+ *
  * ## Import
  *
  * ### Identity Schema

package/s3/bucketNotification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bucketNotification.d.ts","sourceRoot":"","sources":["../../s3/bucketNotification.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bucketNotification.d.ts","sourceRoot":"","sources":["../../s3/bucketNotification.ts"],"names":[],"mappings":"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"}

package/s3/bucketNotification.js

@@ -31,7 +31,7 @@ const utilities = __importStar(require("../utilities"));
 /**
  * Manages a S3 Bucket Notification Configuration. For additional information, see the [Configuring S3 Event Notifications section in the Amazon S3 Developer Guide](https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html).
  *
- * > **NOTE:** S3 Buckets only support a single notification configuration resource. Declaring multiple `aws.s3.BucketNotification` resources to the same S3 Bucket will cause a perpetual difference in configuration. This resource will overwrite any existing event notifications configured for the S3 bucket it's associated with. See the example "Trigger multiple Lambda functions" for an option of how to configure multiple triggers within this resource.
+ * > **NOTE:** The S3 [`PutBucketNotificationConfiguration`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotificationConfiguration.html) API is atomic — it replaces the bucket's entire notification configuration on every call. Only one `aws.s3.BucketNotification` resource can manage a bucket; declaring more than one causes a perpetual diff, and applying this resource will overwrite any notifications already on the bucket. To configure multiple destinations on the same bucket, declare them all as nested blocks within a single resource (see Trigger multiple Lambda functions below). To let independent teams or Terraform configurations subscribe to the same bucket without stepping on each other, prefer the Emit events to EventBridge pattern below. To bring existing notifications under management without losing them, see the `aws.s3.BucketNotification` data source.
  *
  * > This resource cannot be used with S3 directory buckets.
  *
@@ -281,17 +281,66 @@ const utilities = __importStar(require("../utilities"));
  *
  * ### Emit events to EventBridge
  *
+ * For a bucket shared by multiple independent consumers — different teams, different Terraform configurations, different applications — EventBridge is the recommended pattern. Each consumer subscribes to the bucket through its own `aws.cloudwatch.EventRule`, so they cannot overwrite one another the way notification configurations would.
+ *
  * ```typescript
  * import * as pulumi from "@pulumi/pulumi";
  * import * as aws from "@pulumi/aws";
  *
- * const bucket = new aws.s3.Bucket("bucket", {bucket: "your-bucket-name"});
- * const bucketNotification = new aws.s3.BucketNotification("bucket_notification", {
- *     bucket: bucket.id,
+ * const shared = new aws.s3.Bucket("shared", {bucket: "shared-bucket"});
+ * const sharedBucketNotification = new aws.s3.BucketNotification("shared", {
+ *     bucket: shared.id,
  *     eventbridge: true,
  * });
+ * // Team A: process new uploads under uploads/
+ * const teamA = new aws.cloudwatch.EventRule("team_a", {
+ *     name: "team-a-uploads",
+ *     eventPattern: pulumi.jsonStringify({
+ *         source: ["aws.s3"],
+ *         "detail-type": ["Object Created"],
+ *         detail: {
+ *             bucket: {
+ *                 name: [shared.bucket],
+ *             },
+ *             object: {
+ *                 key: [{
+ *                     prefix: "uploads/",
+ *                 }],
+ *             },
+ *         },
+ *     }),
+ * });
+ * const teamAEventTarget = new aws.cloudwatch.EventTarget("team_a", {
+ *     rule: teamA.name,
+ *     arn: teamAProcessor.arn,
+ * });
+ * // Team B: archive deletions under archive/, declared in a separate
+ * // Terraform configuration that knows nothing about Team A.
+ * const teamB = new aws.cloudwatch.EventRule("team_b", {
+ *     name: "team-b-deletions",
+ *     eventPattern: pulumi.jsonStringify({
+ *         source: ["aws.s3"],
+ *         "detail-type": ["Object Deleted"],
+ *         detail: {
+ *             bucket: {
+ *                 name: [shared.bucket],
+ *             },
+ *             object: {
+ *                 key: [{
+ *                     prefix: "archive/",
+ *                 }],
+ *             },
+ *         },
+ *     }),
+ * });
+ * const teamBEventTarget = new aws.cloudwatch.EventTarget("team_b", {
+ *     rule: teamB.name,
+ *     arn: teamBArchive.arn,
+ * });
  * ```
  *
+ * For sharing a bucket between Terraform configurations when EventBridge is not an option, use the `aws.s3.BucketNotification` data source to read existing notifications and re-emit them in your own resource.
+ *
  * ## Import
  *
  * ### Identity Schema

package/s3/bucketNotification.js.map

@@ -1 +1 @@
-{"version":3,"file":"bucketNotification.js","sourceRoot":"","sources":["../../s3/bucketNotification.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,iFAAiF;;;;;;;;;;;;;;;;;;;;;;;;;;AAEjF,uDAAyC;AAIzC,wDAA0C;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0RG;AACH,MAAa,kBAAmB,SAAQ,MAAM,CAAC,cAAc;IACzD;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAA2B,EAAE,KAA+B,EAAE,IAAmC;QAC7H,OAAO,IAAI,kBAAkB,CAAC,IAAI,EAAO,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,gBAAgB;IACT,MAAM,CAAU,YAAY,GAAG,8CAA8C,CAAC;IAErF;;;OAGG;IACI,MAAM,CAAC,UAAU,CAAC,GAAQ;QAC7B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE;YACnC,OAAO,KAAK,CAAC;SAChB;QACD,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,kBAAkB,CAAC,YAAY,CAAC;IACnE,CAAC;IAqCD,YAAY,IAAY,EAAE,WAA8D,EAAE,IAAmC;QACzH,IAAI,cAAc,GAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,EAAE,EAAE;YACT,MAAM,KAAK,GAAG,WAAkD,CAAC;YACjE,cAAc,CAAC,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,CAAC;YACzC,cAAc,CAAC,aAAa,CAAC,GAAG,KAAK,EAAE,WAAW,CAAC;YACnD,cAAc,CAAC,iBAAiB,CAAC,GAAG,KAAK,EAAE,eAAe,CAAC;YAC3D,cAAc,CAAC,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,CAAC;YACzC,cAAc,CAAC,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,CAAC;YACzC,cAAc,CAAC,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,CAAC;SAC5C;aAAM;YACH,MAAM,IAAI,GAAG,WAAiD,CAAC;YAC/D,IAAI,IAAI,EAAE,MAAM,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACzC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;aACzD;YACD,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC;YACxC,cAAc,CAAC,aAAa,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC;YAClD,cAAc,CAAC,iBAAiB,CAAC,GAAG,IAAI,EAAE,eAAe,CAAC;YAC1D,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC;YACxC,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC;YACxC,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC;SAC3C;QACD,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,kBAAkB,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IACvE,CAAC;;AAxFL,gDAyFC"}
+{"version":3,"file":"bucketNotification.js","sourceRoot":"","sources":["../../s3/bucketNotification.ts"],"names":[],"mappings":"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"}

package/s3/getBucketNotification.d.ts

@@ -0,0 +1,268 @@
+import * as pulumi from "@pulumi/pulumi";
+import * as outputs from "../types/output";
+/**
+ * Provides details about the notification configuration of an S3 bucket.
+ *
+ * Useful when `aws.s3.BucketNotification` is the right resource but the bucket already has notifications you do not manage. Read the existing notifications with this data source and re-emit them — alongside your own — in a single `aws.s3.BucketNotification` resource. See issue #501 for the longer story. For sharing a bucket across many independent consumers, enabling EventBridge on the resource is usually a better fit.
+ *
+ * ## Example Usage
+ *
+ * ### Basic Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const example = aws.s3.getBucketNotification({
+ *     bucket: "example-bucket",
+ * });
+ * ```
+ *
+ * ### Conditionally Subscribe via EventBridge
+ *
+ * When the bucket forwards events to Amazon EventBridge, independent consumers can subscribe with their own `aws.cloudwatch.EventRule` resources. Use this data source to subscribe only when EventBridge is in fact enabled on the bucket.
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * export = async () => {
+ *     const shared = await aws.s3.getBucketNotification({
+ *         bucket: "shared-bucket",
+ *     });
+ *     const s3ObjectCreated: aws.cloudwatch.EventRule[] = [];
+ *     for (const range = {value: 0}; range.value < (shared.eventbridge ? 1 : 0); range.value++) {
+ *         s3ObjectCreated.push(new aws.cloudwatch.EventRule(`s3_object_created-${range.value}`, {
+ *             name: "shared-bucket-object-created",
+ *             description: "S3 object-created events from the shared bucket.",
+ *             eventPattern: JSON.stringify({
+ *                 source: ["aws.s3"],
+ *                 "detail-type": ["Object Created"],
+ *                 detail: {
+ *                     bucket: {
+ *                         name: [shared.bucket],
+ *                     },
+ *                 },
+ *             }),
+ *         }));
+ *     }
+ * }
+ * ```
+ *
+ * ### Read Existing Notifications and Re-emit Them
+ *
+ * The S3 [`PutBucketNotificationConfiguration`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotificationConfiguration.html) API replaces the entire notification configuration on every call, so a single `aws.s3.BucketNotification` resource owns the bucket. To preserve notifications already on the bucket — or to mirror one bucket's configuration onto another — read them with this data source and pass them through `dynamic` blocks. The data source's output shape matches the resource's input shape, so each block forwards directly.
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const existing = aws.s3.getBucketNotification({
+ *     bucket: exampleAwsS3Bucket.id,
+ * });
+ * const example = new aws.s3.BucketNotification("example", {
+ *     lambdaFunctions: .map(entry => ({
+ *         id: entry.value.id,
+ *         lambdaFunctionArn: entry.value.lambdaFunctionArn,
+ *         events: entry.value.events,
+ *         filterPrefix: entry.value.filterPrefix,
+ *         filterSuffix: entry.value.filterSuffix,
+ *     })),
+ *     queues: .map(entry2 => ({
+ *         id: entry2.value.id,
+ *         queueArn: entry2.value.queueArn,
+ *         events: entry2.value.events,
+ *         filterPrefix: entry2.value.filterPrefix,
+ *         filterSuffix: entry2.value.filterSuffix,
+ *     })),
+ *     topics: .map(entry3 => ({
+ *         id: entry3.value.id,
+ *         topicArn: entry3.value.topicArn,
+ *         events: entry3.value.events,
+ *         filterPrefix: entry3.value.filterPrefix,
+ *         filterSuffix: entry3.value.filterSuffix,
+ *     })),
+ *     bucket: exampleAwsS3Bucket.id,
+ *     eventbridge: existing.then(existing => existing.eventbridge),
+ * });
+ * ```
+ *
+ * To add a new rule alongside existing ones, exclude IDs your resource owns from the iteration to avoid duplicates, and declare those rules separately:
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const example = new aws.s3.BucketNotification("example", {
+ *     lambdaFunctions: [{
+ *         id: "my-team-rule",
+ *         lambdaFunctionArn: mine.arn,
+ *         events: ["s3:ObjectRemoved:*"],
+ *     }],
+ *     bucket: exampleAwsS3Bucket.id,
+ * });
+ * ```
+ *
+ * > **Note:** The S3 API has no per-rule mutation primitive and no compare-and-swap, so two `pulumi up` runs from different state files writing to the same bucket can still race. For independent consumers of one bucket, EventBridge is generally a better fit.
+ */
+export declare function getBucketNotification(args: GetBucketNotificationArgs, opts?: pulumi.InvokeOptions): Promise<GetBucketNotificationResult>;
+/**
+ * A collection of arguments for invoking getBucketNotification.
+ */
+export interface GetBucketNotificationArgs {
+    /**
+     * Name of the bucket.
+     */
+    bucket: string;
+    /**
+     * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.
+     */
+    region?: string;
+}
+/**
+ * A collection of values returned by getBucketNotification.
+ */
+export interface GetBucketNotificationResult {
+    readonly bucket: string;
+    /**
+     * Whether Amazon EventBridge notifications are enabled on this bucket.
+     */
+    readonly eventbridge: boolean;
+    /**
+     * The provider-assigned unique ID for this managed resource.
+     */
+    readonly id: string;
+    /**
+     * List of Lambda function notification configurations. See `lambdaFunction` below.
+     */
+    readonly lambdaFunctions: outputs.s3.GetBucketNotificationLambdaFunction[];
+    /**
+     * List of SQS queue notification configurations. See `queue` below.
+     */
+    readonly queues: outputs.s3.GetBucketNotificationQueue[];
+    readonly region: string;
+    /**
+     * List of SNS topic notification configurations. See `topic` below.
+     */
+    readonly topics: outputs.s3.GetBucketNotificationTopic[];
+}
+/**
+ * Provides details about the notification configuration of an S3 bucket.
+ *
+ * Useful when `aws.s3.BucketNotification` is the right resource but the bucket already has notifications you do not manage. Read the existing notifications with this data source and re-emit them — alongside your own — in a single `aws.s3.BucketNotification` resource. See issue #501 for the longer story. For sharing a bucket across many independent consumers, enabling EventBridge on the resource is usually a better fit.
+ *
+ * ## Example Usage
+ *
+ * ### Basic Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const example = aws.s3.getBucketNotification({
+ *     bucket: "example-bucket",
+ * });
+ * ```
+ *
+ * ### Conditionally Subscribe via EventBridge
+ *
+ * When the bucket forwards events to Amazon EventBridge, independent consumers can subscribe with their own `aws.cloudwatch.EventRule` resources. Use this data source to subscribe only when EventBridge is in fact enabled on the bucket.
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * export = async () => {
+ *     const shared = await aws.s3.getBucketNotification({
+ *         bucket: "shared-bucket",
+ *     });
+ *     const s3ObjectCreated: aws.cloudwatch.EventRule[] = [];
+ *     for (const range = {value: 0}; range.value < (shared.eventbridge ? 1 : 0); range.value++) {
+ *         s3ObjectCreated.push(new aws.cloudwatch.EventRule(`s3_object_created-${range.value}`, {
+ *             name: "shared-bucket-object-created",
+ *             description: "S3 object-created events from the shared bucket.",
+ *             eventPattern: JSON.stringify({
+ *                 source: ["aws.s3"],
+ *                 "detail-type": ["Object Created"],
+ *                 detail: {
+ *                     bucket: {
+ *                         name: [shared.bucket],
+ *                     },
+ *                 },
+ *             }),
+ *         }));
+ *     }
+ * }
+ * ```
+ *
+ * ### Read Existing Notifications and Re-emit Them
+ *
+ * The S3 [`PutBucketNotificationConfiguration`](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketNotificationConfiguration.html) API replaces the entire notification configuration on every call, so a single `aws.s3.BucketNotification` resource owns the bucket. To preserve notifications already on the bucket — or to mirror one bucket's configuration onto another — read them with this data source and pass them through `dynamic` blocks. The data source's output shape matches the resource's input shape, so each block forwards directly.
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const existing = aws.s3.getBucketNotification({
+ *     bucket: exampleAwsS3Bucket.id,
+ * });
+ * const example = new aws.s3.BucketNotification("example", {
+ *     lambdaFunctions: .map(entry => ({
+ *         id: entry.value.id,
+ *         lambdaFunctionArn: entry.value.lambdaFunctionArn,
+ *         events: entry.value.events,
+ *         filterPrefix: entry.value.filterPrefix,
+ *         filterSuffix: entry.value.filterSuffix,
+ *     })),
+ *     queues: .map(entry2 => ({
+ *         id: entry2.value.id,
+ *         queueArn: entry2.value.queueArn,
+ *         events: entry2.value.events,
+ *         filterPrefix: entry2.value.filterPrefix,
+ *         filterSuffix: entry2.value.filterSuffix,
+ *     })),
+ *     topics: .map(entry3 => ({
+ *         id: entry3.value.id,
+ *         topicArn: entry3.value.topicArn,
+ *         events: entry3.value.events,
+ *         filterPrefix: entry3.value.filterPrefix,
+ *         filterSuffix: entry3.value.filterSuffix,
+ *     })),
+ *     bucket: exampleAwsS3Bucket.id,
+ *     eventbridge: existing.then(existing => existing.eventbridge),
+ * });
+ * ```
+ *
+ * To add a new rule alongside existing ones, exclude IDs your resource owns from the iteration to avoid duplicates, and declare those rules separately:
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const example = new aws.s3.BucketNotification("example", {
+ *     lambdaFunctions: [{
+ *         id: "my-team-rule",
+ *         lambdaFunctionArn: mine.arn,
+ *         events: ["s3:ObjectRemoved:*"],
+ *     }],
+ *     bucket: exampleAwsS3Bucket.id,
+ * });
+ * ```
+ *
+ * > **Note:** The S3 API has no per-rule mutation primitive and no compare-and-swap, so two `pulumi up` runs from different state files writing to the same bucket can still race. For independent consumers of one bucket, EventBridge is generally a better fit.
+ */
+export declare function getBucketNotificationOutput(args: GetBucketNotificationOutputArgs, opts?: pulumi.InvokeOutputOptions): pulumi.Output<GetBucketNotificationResult>;
+/**
+ * A collection of arguments for invoking getBucketNotification.
+ */
+export interface GetBucketNotificationOutputArgs {
+    /**
+     * Name of the bucket.
+     */
+    bucket: pulumi.Input<string>;
+    /**
+     * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.
+     */
+    region?: pulumi.Input<string | undefined>;
+}
+//# sourceMappingURL=getBucketNotification.d.ts.map

package/s3/getBucketNotification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBucketNotification.d.ts","sourceRoot":"","sources":["../../s3/getBucketNotification.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AAEzC,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAI3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,yBAAyB,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,aAAa,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAMxI;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE,CAAC,mCAAmC,EAAE,CAAC;IAC3E;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,0BAA0B,EAAE,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,0BAA0B,EAAE,CAAC;CAC5D;AACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,+BAA+B,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAMhK;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC5C;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAC7C"}