Console Announcements

This topic describes the announcements that Oracle Cloud Infrastructure displays in the Console. Console announcements appear at the top of the page to communicate timely, important information about service status. You can also view a list of past and ongoing announcements.

Note

  • Announcements are not available in Government Cloud realms.
  • If you use Oracle Platform Cloud Services or Oracle Cloud Applications and you have announcements about those service entitlements, the Console displays a banner with a link that you can use to access those announcements. For more information about these announcements, including how to set notification preferences, see Monitoring Notifications.

Types of Announcements

Announcements belong to different categories. An announcement's prefix helps you understand, at a glance, the type and relative severity of the information and whether there's anything you can or must do. Announcement types currently include the following, in order of most important to least:

  • Required action. You must take specific action within your environment.
  • Emergency change. There is a time period during which an unplanned, but urgent, change associated with your environment will take place.
  • Recommended action. You have specific action to take within your environment, but the action is not required.
  • Planned change. There is a time period during which a planned change associated with your environment will take place.
  • Planned change extended. The scheduled change period has extended beyond what was previously communicated.
  • Planned change rescheduled. The planned change to your environment has been postponed to a later time or date.
  • Production event. An impactful change to your environment either recently occurred or is actively occurring.
  • Planned change completed. The planned change to your environment has been completed and regular operations have resumed.
  • Information. There is information that you might find useful, but is not urgent and does not require action on your part.

For announcements that require action and affect Oracle Cloud Infrastructure Compute instances, you will get 30 days of advance notice. If you need to delay the actions described in the announcement, contact support to request one of the alternate dates listed in the announcement. Critical vulnerabilities might not be eligible for delay.

Required IAM Policy

Each service in Oracle Cloud Infrastructure integrates with IAM for authentication and authorization, for all interfaces (the Console, SDK or CLI, and REST API).

To use Oracle Cloud Infrastructure, you must be granted security access in a policy  by an administrator. This access is required whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you get a message that you don’t have permission or are unauthorized, verify with your administrator what type of access you have and which compartment  you should work in.

Depending on whether you have access, you might not see any announcements. With access to announcements, you can either see only the summary version of any given announcement or you can also view announcement details.

For administrators: for typical policies that give users access to announcements, see Restrict user access to view only summary announcements and Let users view details of announcements. For more information, see Details for the Announcements Service.

If you're new to policies, see Getting Started with Policies and Common Policies.

Email Delivery

As part of your service agreement, Oracle Cloud Infrastructure also contacts you with service status announcements through email. These emails help alert you to upcoming changes that will impact your tenancy, such as those involving data centers or instances you use, or about required action on your part. Whenever possible, we try to provide advance notice of impactful events. Oracle sends these announcements to the default tenancy administrator email address on record. You can opt out of emails with operational information that is not urgent and does not require administrator action. (In the Console, these announcements are marked with the type, "Information." For more information about announcement types, see Types of Announcements.) If you want to change the default tenancy administrator email address on record, contact Oracle Support. For more information, see Contacting Support.

To manage email preferences for announcements
  1. Click the Announcements icon (Announcements menu icon).
  2. Click Manage Email Preferences.
  3. Do one of the following:
    • If you want Oracle to email a copy of all announcements, click Opt in.
    • If you want Oracle to withhold email copies of informational announcements that don't require action on your part, click Opt out.

Viewing Announcements

This section describes how to view announcements. The Console displays announcements as banners that span the width of the top of your browser window. As long as an announcement remains in effect and you have the access to view announcements, the banner announcement displays each time you sign in to the Console until you mark it as read. You can also view all past announcements. The Announcements icon displays a green dot if you have any unread announcements.

To dismiss a banner announcement
  • To close a banner announcement until the next time you sign in to the Console, click the X at the far right edge of the banner. If you want to stop seeing an announcement as a banner altogether, you must mark it as read. For more information, see To mark an announcement as read.
To view the details of an announcement
  1. Do one of the following:
    • If you are viewing a banner, click the Show details link near the far right edge of the banner.
    • If you are viewing a list of announcements, under the Summary column, click the announcement summary.
  2. On the Announcement Details page, you can view the following information:
    • Description. This describes the issue or event in greater detail than the summary text of the announcement.
    • OCID. This is the announcement's unique, Oracle-assigned identifier.
    • Reference Ticket Number. You can use this number to refer to the issue when talking to Support.
    • Type. This is one of several predefined categories that helps to set expectations about the nature and severity of the issue described.
    • Affected Service. This indicates the Oracle Cloud Infrastructure services affected by the issue or event.
    • Region. This tells you what Oracle Cloud Infrastructure regions are impacted.
    • Start Time. This is when the issue or event was first detected.
    • End Time. This is when the issue or event was resolved.
    • Required After. This is the date after which you must address any required actions described in the announcement.
    • Created. This is when the announcement was created.
    • Updated. This is when the announcement was updated.
    • Additional Information. This includes information such as workarounds or background material.
    • Impacted Resources. This shows the resources that were affected in some way by the event that prompted the announcement.
  3. Optionally, if you want to refer to the list of impacted resources later, click Download Impacted Resources List.
To view a list of all announcements
  1. Click the Announcements icon (Announcements menu icon).
  2. The Announcements page displays all announcements. From this page, you can do the following:
    • Filter. You can filter announcements by type or by start or end date.
    • Sort. You can sort announcements by summary, type, event start time, or publish time (which indicates when the announcement was last updated).
    • Mark as read. You can mark announcements as read if you want stop seeing them as banners in the Console in subsequent sessions.
    • View announcement details. You can view the details of an announcement.
To filter a list of announcements
  1. Click the Announcements icon (Announcements menu icon).
  2. To filter the list, under Filters, do one of the following:
    • Click Type, and then click a type from the list.
    • Click Start Date, and then choose a date to see only events that started on that date.
    • Click End Date, and then choose a date to see only events that ended on that date.
  3. To clear a filter on a date, click the X next to the date.
To sort a list of announcements
  1. Click the Announcements icon (Announcements menu icon).
  2. By default, the list displays announcements according to the event start time, from most recent to least. To sort the list another way, do one of the following:
    • Click Summary. The list sorts alphabetically, according to the summary of the announcement.
    • Click Type. The list sorts according to the importance of the announcement.
    • Click Start Time. The list sorts according to the start time of the event described in the announcement. If you begin by viewing the default sort order, the sort order will change to show the oldest announcement at the beginning of the list.
    • Click Publish Time. The list sorts according to the time that an announcement was last updated. You might find it helpful to sort by this column if you want to track an ongoing issue or if an announcement requires action on your part.
  3. To sort the list again, repeat the previous step.
To mark an announcement as read
  1. Click the Announcements icon (Announcements menu icon).
  2. Find the announcement that you want to mark as read, click the Actions icon (three dots), and then click Mark As Read.

Using the Command Line Interface (CLI)

For information about using the CLI, see Command Line Interface (CLI). For a complete list of flags and options available for CLI commands, see the Command Line Reference.

To view the details of an announcement

Open a command prompt and run oci announce announcements get to view detailed information about an announcement:

oci announce announcements get --announcement-id <announcement_OCID>

For example:


oci announce announcements get --announcement-id ocid1.announcement.region1..examplear73oue4jdywjjvietoc6im3cvb6xae4falm3faux5us3iwra3t6q
To view a list of all announcements

Open a command prompt and run oci announce announcements list to view a list of all announcements:

oci announce announcements list --compartment-id <compartment_OCID>

For example:


oci announce announcements list --compartment-id ocid1.tenancy.oc1..exampleati4wjo6cvbxq4iusld5ltpneskcfy7lr4a6wfauxuwrwed5bsdea
To filter a list of announcements

Open a command prompt and run oci announce announcements list to filter a list of announcements.

To filter a list of announcements by announcement type:

oci announce announcements list --compartment-id <compartment_OCID> --announcement-type <announcement_type>

For example:


oci announce announcements list --compartment-id ocid1.tenancy.oc1..exampleati4wjo6cvbxq4iusld5ltpneskcfy7lr4a6wfauxuwrwed5bsdea --announcement-type ACTION_REQUIRED
To sort a list of announcements

Open a command prompt and run oci announce announcements list to sort a list of announcements.

To sort a list of announcements in ascending order of time created, from oldest to newest:

oci announce announcements list --compartment-id <compartment_OCID> --sort-order ASC

For example:


oci announce announcements list --compartment-id ocid1.tenancy.oc1..exampleati4wjo6cvbxq4iusld5ltpneskcfy7lr4a6wfauxuwrwed5bsdea --sort-order ASC
To mark an announcement as read

Open a command prompt and run oci announce user-status update to mark an announcement as read:

oci announce user-status update --announcement-id <announcement_OCID> --user-status-announcement-id <announcement_OCID> --user-id <user_OCID> --time-acknowledged <date_and_time>

For example:


oci announce user-status update --announcement-id ocid1.announcement.region1..examplear73oue4jdywjjvietoc6im3cvb6xae4falm3faux5us3iwra3t6q --user-status-announcement-id ocid1.announcement.region1..examplear73oue4jdywjjvietoc6im3cvb6xae4falm3faux5us3iwra3t6q --user-id ocid1.user.region1..exampleaorxz3psplonigcvbzy5oaiwiubh7k7ip6zgklfauxic67kksu4oq --time-acknowledged 2019-01-06T20:14:00+00:00