Oracle Cloud Infrastructure Documentation

Managing Topics and Subscriptions

This section describes how to manage A communication channel for sending messages to the subscriptions in the topic. (Notifications service.) and their An endpoint for a topic. Published messages are sent to each subscription for a topic. Supported subscription protocols include Email and HTTPS (PagerDuty). (Notifications service.).

Warning

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 An alert published to all subscriptions in the specified topic. Each message is delivered at least once per subscription. (Notifications and Monitoring services.) to its subscriptions. A topic can have zero, one, or multiple subscriptions that are notified whenever a message is published to a topic.

Prerequisites

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.

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 (HTTPS (PagerDuty) protocol only)
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: