Create Subscription
POST {{baseUrl}}/subscriptions
Creates a subscription for the specified topic and sends a subscription confirmation URL to the endpoint. The subscription remains in Pending
status until it has been confirmed.
For information about confirming subscriptions, see
To confirm a subscription.
The topic endpoint is required for this operation.
To get the topic endpoint, use GetTopic
and review the apiEndpoint
value in the response (NotificationTopic).
Transactions Per Minute (TPM) per-tenancy limit for this operation: 60.
Request Body
{"compartmentId"=>"{{compartment_ocid}}", "endpoint"=>"abc@oracle.com", "protocol"=>"EMAIL", "topicId"=>"ocid1.onstopic.oc1....", "metadata"=>"ut"}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
opc-retry-token | string | A 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-id | string | The unique Oracle-assigned identifier for the request. If you need to contact Oracle about a | |
particular request, please provide the request ID. | |||
Content-Type | string | ||
Date | string | (Required) Current Date | |
Authorization | string | (Required) Signature Authentication on Authorization header | |
x-content-sha256 | string | (Required) Content sha256 for POST, PUT and PATCH operations |
RESPONSES
status: OK
{"compartmentId":"eu Duis ut laborum","endpoint":"el","id":"in amet","lifecycleState":"PENDING","protocol":"EMAIL","topicId":"reprehenderit deserunt","createdTime":-83512598,"deliverPolicy":"nulla proident laboris consequat"}