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:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginCreateTopic and EndCreateTopic.

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

Syntax

C#
public abstract Task<CreateTopicResponse> CreateTopicAsync(
         CreateTopicRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.SimpleNotificationService.Model.CreateTopicRequest

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

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

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 Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also