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.

Creates a topic to which notifications can be published. Users can create at most 100,000 standard topics (at most 1,000 FIFO topics). For more information, see Creating an Amazon SNS topic in the Amazon SNS Developer Guide. This action is idempotent, so if the requester already owns a topic with the specified name, that topic's ARN is returned without creating a new topic.

Note:

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

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

Syntax

C#
public virtual CreateTopicResponse CreateTopic(
         CreateTopicRequest request
)

Parameters

request
Type: Amazon.SimpleNotificationService.Model.CreateTopicRequest

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

Return Value


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

Exceptions

ExceptionCondition
AuthorizationErrorException Indicates that the user has been denied access to the requested resource.
ConcurrentAccessException Can't perform multiple operations on a tag simultaneously. Perform the operations sequentially.
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.
StaleTagException A tag has been added to a resource with the same ARN as a deleted resource. Wait a short while and then retry the operation.
TagLimitExceededException Can't add more than 50 tags to a topic.
TagPolicyException The request doesn't comply with the IAM tag policy. Correct your request and then retry it.
TopicLimitExceededException Indicates that the customer already owns the maximum allowed number of topics.

Version Information

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

See Also