Create Topic

POST {{baseUrl}}/topics

Creates a topic in the specified compartment. For general information about topics, see Managing Topics and Subscriptions.

For the purposes of access control, you must provide the OCID of the compartment where you want the topic to reside. For information about access control and compartments, see Overview of the IAM Service.

You must specify a display name for the topic.

All Oracle Cloud Infrastructure resources, including topics, get an Oracle-assigned, unique ID called an Oracle Cloud Identifier (OCID). When you create a resource, you can find its OCID in the response. You can also retrieve a resource's OCID by using a List API operation on that resource type, or by viewing the resource in the Console. For more information, see Resource Identifiers.

Transactions Per Minute (TPM) per-tenancy limit for this operation: 60.

Request Body

{"compartmentId"=>"{{compartment_ocid}}", "name"=>"reprehenderit consectetur deserunt", "description"=>"ex magna fugiat"}

HEADERS

KeyDatatypeRequiredDescription
opc-retry-tokenstringA token that uniquely identifies a request so it can be retried in case of a timeout or
server error without risk of executing that same action again. Retry tokens expire after 24
hours, but can be invalidated before that due to conflicting operations (for example, if a resource
has been deleted and purged from the system, then a retry of the original creation request
may be rejected).
opc-request-idstringThe unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
particular request, please provide the request ID.
Content-Typestring
Datestring(Required) Current Date
Authorizationstring(Required) Signature Authentication on Authorization header
x-content-sha256string(Required) Content sha256 for POST, PUT and PATCH operations

RESPONSES

status: OK

{"apiEndpoint":"officia adipisicing amet ipsum mollit","compartmentId":"dolor proident magna","lifecycleState":"CREATING","name":"aute pariatur laboris enim irure","timeCreated":"1978-07-03T18:48:56.452Z","topicId":"nisi ani","description":"voluptate laborum aliquip do","etag":"voluptate reprehenderit cupidatat eiusmod consequat","shortTopicId":"in qui"}