AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Verifies an endpoint owner's intent to receive messages by validating the token sent to the endpoint by an earlier Subscribe action. If the token is valid, the action creates a new subscription and returns its Amazon Resource Name (ARN). This call requires an AWS signature only when the AuthenticateOnUnsubscribe flag is set to "true".

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to ConfirmSubscriptionAsync.

Namespace: Amazon.SimpleNotificationService
Assembly: AWSSDK.SimpleNotificationService.dll
Version: 3.x.y.z

Syntax

C#
public virtual ConfirmSubscriptionResponse ConfirmSubscription(
         String topicArn,
         String token,
         String authenticateOnUnsubscribe
)

Parameters

topicArn
Type: System.String

The ARN of the topic for which you wish to confirm a subscription.

token
Type: System.String

Short-lived token sent to an endpoint during the Subscribe action.

authenticateOnUnsubscribe
Type: System.String

Disallows unauthenticated unsubscribes of the subscription. If the value of this parameter is true and the request has an Amazon Web Services signature, then only the topic owner and the subscription owner can unsubscribe the endpoint. The unsubscribe action requires Amazon Web Services authentication.

Return Value


The response from the ConfirmSubscription service method, as returned by SimpleNotificationService.

Exceptions

ExceptionCondition
AuthorizationErrorException Indicates that the user has been denied access to the requested resource.
FilterPolicyLimitExceededException Indicates that the number of filter polices in your Amazon Web Services account exceeds the limit. To add more filter polices, submit an Amazon SNS Limit Increase case in the Amazon Web Services Support Center.
InternalErrorException Indicates an internal service error.
InvalidParameterException Indicates that a request parameter does not comply with the associated constraints.
NotFoundException Indicates that the requested resource does not exist.
ReplayLimitExceededException Indicates that the request parameter has exceeded the maximum number of concurrent message replays.
SubscriptionLimitExceededException Indicates that the customer already owns the maximum allowed number of subscriptions.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

See Also