Oracle Cloud Infrastructure Documentation

Managing Topics and Subscriptions

This section describes how to manage (Notifications service) A communication channel for sending messages to the subscriptions in the topic. and their (Notifications service) An endpoint for a topic; typically a URL or email address. Published messages are sent to each subscription for a topic..


Avoid entering confidential information when assigning descriptions, tags, or friendly names to your cloud resources through the Oracle Cloud Infrastructure Console, API, or CLI.

A topic is a communication channel for sending (Notifications and Monitoring services) An alert published to all subscriptions in the specified topic. Each message is delivered at least once per subscription. to its subscriptions. A topic can have zero, one, or multiple subscriptions that are notified whenever a message is published to a topic.


IAM policies: To use Notifications, you must be given the required type of access in a An IAM document that specifies who has what type of access to your resources. It is used in different ways: to mean an individual statement written in the policy language; to mean a collection of statements in a single, named "policy" document (which has an Oracle Cloud ID (OCID) assigned to it); and to mean the overall body of policies your organization uses to control access to resources. written by an administrator, whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you get a response that you don’t have permission or are unauthorized, check with your administrator. You may not have the required type of access in the current A collection of related resources that can be accessed only by certain groups that have been given permission by an administrator in your organization.. For more information on user authorizations, see Notifications Overview.

Creating Automation with Events

You can create automation based on state changes for your Oracle Cloud Infrastructure resources by using event types, rules, and actions. For more information, see Overview of Events.

Using the Console

To create a topic
To delete a topic
To update the description for a topic
To move a topic to a different compartment
To create a subscription
To confirm a subscription
To resend a subscription confirmation
To update the retry duration for a subscription
To move a subscription to a different compartment
To delete a subscription (unsubscribe)

Managing Tags for a Topic or Subscription

You can apply tags to your resources, such as topics and subscriptions, to help you organize them according to your business needs. You can apply tags at the time you create a topic or subscription, or you can update the topic or subscription later with the tags you want. For general information about applying tags, see Resource Tags.

To manage tags for a topic
To manage tags for a subscription

Using the API

For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.

Use these API operations to manage topics:

Use these API operations to manage subscriptions: