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.

Subscribes an endpoint to an Amazon SNS topic. If the endpoint type is HTTP/S or email, or if the endpoint and the topic are not in the same Amazon Web Services account, the endpoint owner must run the ConfirmSubscription action to confirm the subscription.

You call the ConfirmSubscription action with the token from the subscription response. Confirmation tokens are valid for two days.

This action is throttled at 100 transactions per second (TPS).

Note:

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

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

Syntax

C#
public virtual SubscribeResponse Subscribe(
         SubscribeRequest request
)

Parameters

request
Type: Amazon.SimpleNotificationService.Model.SubscribeRequest

Container for the necessary parameters to execute the Subscribe service method.

Return Value


The response from the Subscribe 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.
InvalidSecurityException The credential signature isn't valid. You must use an HTTPS endpoint and sign your request using Signature Version 4.
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