@@ -35,31 +35,84 @@ final class CreateTopicInput extends Input
3535 *
3636 * - `DeliveryPolicy` – The policy that defines how Amazon SNS retries failed deliveries to HTTP/S endpoints.
3737 * - `DisplayName` – The display name to use for a topic with SMS subscriptions.
38- * - `FifoTopic` – Set to true to create a FIFO topic.
3938 * - `Policy` – The policy that defines who can access your topic. By default, only the topic owner can publish or
4039 * subscribe to the topic.
41- * - `SignatureVersion` – The signature version corresponds to the hashing algorithm used while creating the signature
42- * of the notifications, subscription confirmations, or unsubscribe confirmation messages sent by Amazon SNS. By
43- * default, `SignatureVersion` is set to `1`.
4440 * - `TracingConfig` – Tracing mode of an Amazon SNS topic. By default `TracingConfig` is set to `PassThrough`, and
4541 * the topic passes through the tracing header it receives from an Amazon SNS publisher to its subscriptions. If set
4642 * to `Active`, Amazon SNS will vend X-Ray segment data to topic owner account if the sampled flag in the tracing
4743 * header is true. This is only supported on standard topics.
44+ * - HTTP
4845 *
49- * The following attribute applies only to server-side encryption [^1]:
46+ * - `HTTPSuccessFeedbackRoleArn` – Indicates successful message delivery status for an Amazon SNS topic that is
47+ * subscribed to an HTTP endpoint.
48+ * - `HTTPSuccessFeedbackSampleRate` – Indicates percentage of successful messages to sample for an Amazon SNS topic
49+ * that is subscribed to an HTTP endpoint.
50+ * - `HTTPFailureFeedbackRoleArn` – Indicates failed message delivery status for an Amazon SNS topic that is
51+ * subscribed to an HTTP endpoint.
52+ *
53+ * - Amazon Data Firehose
54+ *
55+ * - `FirehoseSuccessFeedbackRoleArn` – Indicates successful message delivery status for an Amazon SNS topic that is
56+ * subscribed to an Amazon Data Firehose endpoint.
57+ * - `FirehoseSuccessFeedbackSampleRate` – Indicates percentage of successful messages to sample for an Amazon SNS
58+ * topic that is subscribed to an Amazon Data Firehose endpoint.
59+ * - `FirehoseFailureFeedbackRoleArn` – Indicates failed message delivery status for an Amazon SNS topic that is
60+ * subscribed to an Amazon Data Firehose endpoint.
61+ *
62+ * - Lambda
63+ *
64+ * - `LambdaSuccessFeedbackRoleArn` – Indicates successful message delivery status for an Amazon SNS topic that is
65+ * subscribed to an Lambda endpoint.
66+ * - `LambdaSuccessFeedbackSampleRate` – Indicates percentage of successful messages to sample for an Amazon SNS
67+ * topic that is subscribed to an Lambda endpoint.
68+ * - `LambdaFailureFeedbackRoleArn` – Indicates failed message delivery status for an Amazon SNS topic that is
69+ * subscribed to an Lambda endpoint.
70+ *
71+ * - Platform application endpoint
72+ *
73+ * - `ApplicationSuccessFeedbackRoleArn` – Indicates successful message delivery status for an Amazon SNS topic that
74+ * is subscribed to a platform application endpoint.
75+ * - `ApplicationSuccessFeedbackSampleRate` – Indicates percentage of successful messages to sample for an Amazon
76+ * SNS topic that is subscribed to an platform application endpoint.
77+ * - `ApplicationFailureFeedbackRoleArn` – Indicates failed message delivery status for an Amazon SNS topic that is
78+ * subscribed to an platform application endpoint.
79+ *
80+ * > In addition to being able to configure topic attributes for message delivery status of notification messages sent
81+ * > to Amazon SNS application endpoints, you can also configure application attributes for the delivery status of
82+ * > push notification messages sent to push notification services.
83+ * >
84+ * > For example, For more information, see Using Amazon SNS Application Attributes for Message Delivery Status [^1].
85+ *
86+ * - Amazon SQS
87+ *
88+ * - `SQSSuccessFeedbackRoleArn` – Indicates successful message delivery status for an Amazon SNS topic that is
89+ * subscribed to an Amazon SQS endpoint.
90+ * - `SQSSuccessFeedbackSampleRate` – Indicates percentage of successful messages to sample for an Amazon SNS topic
91+ * that is subscribed to an Amazon SQS endpoint.
92+ * - `SQSFailureFeedbackRoleArn` – Indicates failed message delivery status for an Amazon SNS topic that is
93+ * subscribed to an Amazon SQS endpoint.
94+ *
95+ *
96+ * > The <ENDPOINT>SuccessFeedbackRoleArn and <ENDPOINT>FailureFeedbackRoleArn attributes are used to give
97+ * > Amazon SNS write access to use CloudWatch Logs on your behalf. The <ENDPOINT>SuccessFeedbackSampleRate
98+ * > attribute is for specifying the sample rate percentage (0-100) of successfully delivered messages. After you
99+ * > configure the <ENDPOINT>FailureFeedbackRoleArn attribute, then all failed message deliveries generate
100+ * > CloudWatch Logs.
101+ *
102+ * The following attribute applies only to server-side encryption [^2]:
50103 *
51104 * - `KmsMasterKeyId` – The ID of an Amazon Web Services managed customer master key (CMK) for Amazon SNS or a custom
52- * CMK. For more information, see Key Terms [^2 ]. For more examples, see KeyId [^3 ] in the *Key Management Service API
105+ * CMK. For more information, see Key Terms [^3 ]. For more examples, see KeyId [^4 ] in the *Key Management Service API
53106 * Reference*.
54107 *
55- * The following attributes apply only to FIFO topics [^4 ]:
108+ * The following attributes apply only to FIFO topics [^5 ]:
56109 *
57110 * - `ArchivePolicy` – The policy that sets the retention period for messages stored in the message archive of an
58111 * Amazon SNS FIFO topic.
59112 * - `ContentBasedDeduplication` – Enables content-based deduplication for FIFO topics.
60113 *
61114 * - By default, `ContentBasedDeduplication` is set to `false`. If you create a FIFO topic and this attribute is
62- * `false`, you must specify a value for the `MessageDeduplicationId` parameter for the Publish [^5 ] action.
115+ * `false`, you must specify a value for the `MessageDeduplicationId` parameter for the Publish [^6 ] action.
63116 * - When you set `ContentBasedDeduplication` to `true`, Amazon SNS uses a SHA-256 hash to generate the
64117 * `MessageDeduplicationId` using the body of the message (but not the attributes of the message).
65118 *
@@ -75,14 +128,15 @@ final class CreateTopicInput extends Input
75128 * comes first.
76129 * - `MessageGroup` – The scope of deduplication is within each individual message group, which enables higher
77130 * throughput per topic subject to regional quotas. For more information on quotas or to request an increase, see
78- * Amazon SNS service quotas [^6] in the Amazon Web Services General Reference.
79- *
80- * [^1]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
81- * [^2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
82- * [^3]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
83- * [^4]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
84- * [^5]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
85- * [^6]: https://docs.aws.amazon.com/general/latest/gr/sns.html
131+ * Amazon SNS service quotas [^7] in the Amazon Web Services General Reference.
132+ *
133+ * [^1]: https://docs.aws.amazon.com/sns/latest/dg/sns-msg-status.html
134+ * [^2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
135+ * [^3]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
136+ * [^4]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
137+ * [^5]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
138+ * [^6]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
139+ * [^7]: https://docs.aws.amazon.com/general/latest/gr/sns.html
86140 *
87141 * @var array<string, string>|null
88142 */
0 commit comments