Creating an Announcement Subscription

• Console
• CLI
• API

• 1. On the Subscriptions list page, select Create announcement subscription. If you need help finding the list page, see Viewing a List of All Announcement Subscriptions.
  2. Select Name, and then enter a name for the subscription. Avoid entering confidential information.
  3. (Optional) Select Description, and then enter a description. Avoid entering confidential information.
  4. Select Compartment, and then select the compartment where you want to create the subscription.
  5. Under Subscription type, do one of the following:
     • If you want the service to publish all announcements to the Notifications topic that you configure for this subscription, select All announcements. Then, skip to step 12 to configure the Notifications topic.
     • If you want the service to publish only the announcements that meet the filter criteria that you specify, select Selected announcements only. Then, continue to the next step to configure a filter group and its filters.
  6. If you selected Selected announcements only in the previous step, configure a filter group with the filters that you want to apply to announcements for this subscription. Under Filter group, select Filter group name, and then enter a name for the filter. Avoid entering confidential information.
     Note
     
     Include only alphanumeric, hyphen, underscore, or whitespace characters in the filter group name.
  7. Under Filters, select Type, and then use the following table to configure a Value for what announcements you want to receive:
     Note
     
     You can't have more than one of any particular filter type within a filter group.

     Option	Description
     Announcement type	Specify an announcement type to include in the filter. Every announcement is assigned to a category that helps you understand the relative severity of the information in the announcement. For more information, see Types of Announcements.
     Compartment	Specify a compartment to include in the filter. Not all announcements impact a specific compartment, but this filter lets you include announcements that do. Note: If you specify the root compartment, then subscribers receive all announcements for the tenancy. However, if you want all announcements, then we recommend you create a subscription for all announcements instead of creating a subscription for selected announcements only.
     Platform	Specify whether you want to see announcements that impact the Oracle Cloud Infrastructure (IaaS) platform or announcements that impact Software as a Service (SaaS) applications.
     Region	Specify a region to include in the filter.
     Resource OCID	Specify up to 5 resources that you want to include in the filter by doing the following: Select Browse, select the checkbox next to the resource that you want to include, and then select Add to filter. (If needed, to list resources in a different compartment, select Compartment and select a compartment.) Note: You can't combine this filter with any other type of filter in a particular filter group.
     Service	Select the name of the service that you want to include. To narrow the list, you can type or otherwise enter the service name. Not all announcements impact a particular service, but this filter lets you include announcements that do. If a filter specifies more than one service, then the Announcements service notifies subscribers of announcements impacting any of the specified services. Note: When you create a subscription based on a service, you get all the announcements for that service. You don't need to separately create a subscription for each region where you use the service.

  8. (Optional) To add another filter to the filter group, select + Another filter, and then repeat the previous step. (You can't do this if the filter you created in the previous step specified resource OCIDs. You can't combine that type of filter with any other filter in a particular filter group.)
  9. You can create more than one filter group to combine different filters to meet specific criteria. To add another filter group, select + Another filter group, and then repeat steps 8 and 9. (You can't do this if any filters you create specify the service Oracle Fusion Applications. You can't have that filter and have more than one filter group.)
  10. Under Display preferences, select Time zone, and then select the time zone that you prefer for announcement time stamps.
  11. 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.
      Note
      
      You can't change filter groups when a language display preference is part of a subscription. If you need changes to the filter groups later, you must create a new subscription at that time.
  12. 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 currently 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.)
        Subscription protocol	Select the protocol used by subscription endpoints. The information you must provide about the subscription endpoint depends on the protocol. If you select Email, then select Email address and enter a valid email address. For more information, see Creating an Email Subscription. If you select 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 select HTTPS custom URL, then select URL and enter a valid HTTPS URL. For more information, see Creating an HTTPS (Custom URL) Subscription. If you select PagerDuty, select URL and enter a valid PagerDuty URL. For more information, see Creating a PagerDuty Subscription. If you select Slack, select URL and enter the URL of a valid Slack channel. For more information, see Creating a Slack Subscription. If you select SMS, specify a Country and Phone Number. For more information, see Creating an SMS Subscription. Optionally, to add another subscription protocol to this topic, select + Another subscription.

  13. When you're ready, select Create.
• Use the oci announce announcement-subscription create command and required parameters to create a subscription for announcements:

  Command

  CopyTry It

  oci announce announcement-subscription create --compartment-id <compartment_OCID> --display-name <announcement_subscription_name> --ons-topic-id <Notifications_topic_OCID>

  For example:

  oci announce announcement-subscription create --compartment-id ocid1.compartment.<realm>..<unique_ID> --display-name newannouncementsubscription --ons-topic-id ocid1.onstopic.<realm>.<region>.<unique_ID>

  Note
  
  You can't create a subscription with multiple filter groups when any filter group specifies Oracle Fusion Applications as the service.

  For more information about filter group options, see FilterGroupDetails. For more information about Notifications topic options, see CreateSubscriptionDetails.

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

• Run the CreateAnnouncementSubscription operation to create a subscription for announcements.