Creating an Email Subscription
Create an email subscription in Notifications to receive notifications by email. An email subscription can reference any email address, including an alias for a distribution list.
These steps show how to open the Create Subscription panel from the details page for the topic that you want to add the subscription to. You can also open this panel from the Subscriptions list page, specifying the topic in the panel: Select Create Subscription, and then select a Subscription Topic. - On the Topics list page, select the topic that you want to work with. If you need help finding the list page or the topic, see Listing Topics.
- On the topic's details page, select Create Subscription.
- In the Create Subscription panel, for Protocol, select Email.
- Enter an email address.
- Select Create.
Notifications creates the email subscription and sends a confirmation URL to the email address. The subscription is pending until confirmation is received.
Use the oci ons subscription create command and required parameters to create an email subscription:
oci ons subscription create --protocol "EMAIL" --subscription-endpoint <email_address> [...]
For a complete list of parameters and values for CLI commands, see the Command Line Reference for Notifications.
Run the CreateSubscription operation to create an email subscription.
Example:
POST /20181201/subscriptions Host: notification.us-phoenix-1.oraclecloud.com <authorization and other headers> { "topicId": "<topic_OCID>", "compartmentId": "<compartment_OCID>", "protocol": "EMAIL", "endpoint": "john.smith@example.com" }
What's Next
To activate the new subscription, navigate to the confirmation URL that was sent to the email address.
Although a new subscription must be in the same compartment as its parent topic, you can move it to another compartment after creation. See Moving a Subscription.