Oracle Cloud Infrastructure Documentation

Updating an Announcement Subscription

You can update an active subscription by changing its name, description, or Notifications topic.

    1. On the Subscriptions list page, find the subscription you want to update, and then select the subscription name. If you need help finding the list page, see Viewing a List of All Announcement Subscriptions.
    2. Select Edit.
    3. (Optional) Select Name, and then update the subscription name. Avoid entering confidential information.
    4. (Optional) Select Description, and then update the description. Avoid entering confidential information.
    5. (Optional) Under Display preferences, select Time zone, and then select the time zone that you prefer for announcement time stamps.
    6. (Optional) Select Language, and then select the language that you prefer for displaying announcements delivered by email. By default, the language is set to whatever you configured in the Console language selector.
    7. (Optional) Under Notifications topic, do one of the following:
      • To use an existing Notifications topic, select Use existing topic, and then select a topic from the selected compartment. (If needed, to list resources in a different compartment, select Compartment and select a compartment.)
      • To create a new Notifications topic, select Create new topic, and then provide the following:
        Option Description
        Compartment Select the compartment where you want to create the topic.
        Name Enter a name for the topic. (Avoid entering confidential information.)
        Description Enter a description for the topic. (Avoid entering confidential information.)
    8. Under Subscription, select Subscription protocol, and then select the protocol used by subscription endpoints. The information you must provide about the subscription endpoint depends on the protocol.
    9. Do one of the following:
      • If you selected Email, then select Email address and enter a valid email address. For more information, see Creating an Email Subscription.
      • If you selected Function, then specify the Oracle Cloud Infrastructure Functions application and function by selecting an Oracle Functions application and then Function. (If needed, select Function compartment to list resources in a different compartment.) For more information, see Creating a Function Subscription.
      • If you selected HTTPS custom URL, then select URL and enter a valid HTTPS URL. For more information, see Creating an HTTPS (Custom URL) Subscription.
      • If you selected PagerDuty, select URL and enter a valid PagerDuty URL. For more information, see Creating a PagerDuty Subscription.
      • If you selected Slack, select URL and enter the URL of a valid Slack channel. For more information, see Creating a Slack Subscription.
      • If you selected SMS, specify a Country and Phone Number. For more information, see Creating an SMS Subscription.
    10. (Optional) To add another subscription protocol to this topic, perform one of the following actions, depending on what's available:
      • Select Add subscription, and then repeat the previous step.
      • Select + Another subscription, and then repeat the previous step.
    11. When you're ready, select Save changes.
  • Use the oci announce announcement-subscription update command and required parameters to update an announcement subscription:
    oci announce announcement-subscription update --announcement-subscription-id <announcementsubscription_OCID>
    For example, to change a subscription name: 
    oci announce announcement-subscription update --announcement-subscription-id ocid1.announcementsubscription.<realm>.<region>.<unique_ID> --display-name newsubscriptionname
    Or, to change a subscription description: 
    oci announce announcement-subscription update --announcement-subscription-id ocid1.announcementsubscription.<realm>.<region>.<unique_ID> --description "new subscription description"
    Or, to change the subscription's preferred time zone by specifying the IANA Time Zone Database format:
    oci announce announcement-subscription update --preferred-time-zone "America/Los_Angeles"
    Or, to change the subscription's Notifications topic: 
    oci announce announcement-subscription update --announcement-subscription-id ocid1.announcementsubscription.<realm>.<region>.<unique_ID> --ons-topic-id ocid1.onstopic.<realm>.<region>.<unique_ID>

    For more information about Notifications topic options, see UpdateSubscriptionDetails.

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • Run the UpdateAnnouncementSubscription operation to update an announcement subscription.