Oracle Cloud Infrastructure Documentation

Filtering Announcements

Filter announcements to view only announcements that fit specific criteria. You can filter on criteria such as the announcement type, start or end date, impacted service, resolution status, and impacted platform.

Note

Announcements have a retention period of 90 days. You can't view announcements sent more than 90 days in the past.
    1. Open the Announcements list page. If you need help finding the list page, see Viewing a List of All Announcements. By default, the list displays a list of all announcements for the selected compartment.
    2. To view announcements filtered by announcement type, perform one of the following actions, depending on what's available. For more information about announcement types, see Types of Announcements.
      • In the search box, select the Action type filter, select one or more of the announcement types you want to list, and then select Apply filter.
      • Select one or more of the following tabs:
        • Required actions
        • Recommended actions
        • Planned maintenance
        • Other. This tab shows all announcements of a different type from the three preceding announcement types.
    3. (Optional) To filter the list of announcements further, either in the search box or under Filters, do one or more of the following, depending on what's available:
      • Select Announcement, and then enter a full or partial announcement title.
      • Select Read status, and then select one or more statuses.
      • Select Reference ticket number, and then enter a reference ticket number.
      • Select Service, and then select one or more services.
      • Select Action type, and then select one or more announcement types.
      • Select Platform type, and then select one or more platform types.
      • Select Event time, and then enter a start date, start time, end date, and end time. Or, you can select one of the preset time ranges, up to the last year.
      • Select Publish time, and then enter a start date, start time, end date, and end time. Or, you can select one of the preset time ranges, up to the last year.
    4. Select Apply filter.
    5. (Optional) To clear filters, perform one of the following actions, depending on what's available:
      • To clear an individual filter, select the X next to the filter name.
      • To clear all filters on the list of announcements, select Reset.

  • Use the oci announce announcements list command and required parameters to filter a list of announcements. When using the command line, you can filter a list of announcements by announcement type, environment name, lifecycle state, platform type, service, and time (earliest start time and latest start time).

    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..<unique_ID> --announcement-type ACTION_REQUIRED
    To filter a list of announcements by environment name: 
    oci announce announcements list --compartment-id <compartment_OCID> --environment-name <environment_name>
    For example: 
    oci announce announcements list --compartment-id ocid1.tenancy.oc1..<unique_ID> --environment-name testenv
    To filter a list of announcements by lifecycle state: 
    oci announce announcements list --compartment-id <compartment_OCID> --lifecycle-state <lifecycle_state>
    For example: 
    oci announce announcements list --compartment-id ocid1.tenancy.oc1..<unique_ID> --lifecycle-state ACTIVE
    To filter a list of announcements by platform type: 
    oci announce announcements list --compartment-id <compartment_OCID> --platform-type <platform_type>
    For example: 
    oci announce announcements list --compartment-id ocid1.tenancy.oc1..<unique_ID> --platform-type IAAS
    To filter a list of announcements by service: 
    oci announce announcements list --compartment-id <compartment_OCID> --service <service_name>
    For example: 
    oci announce announcements list --compartment-id ocid1.tenancy.oc1..<unique_ID> --service "Oracle Cloud Infrastructure Networking""
    Note

    If you include more than one service, then the filter effectively screens for announcements that impact all specified services.
    To filter a list of announcements by time: 
    oci announce announcements list --compartment-id <compartment_OCID> --time-one-earliest-time <earliest_start_time> --time-one-latest-time <latest_start_time>
    For example: 
    oci announce announcements list --compartment-id ocid1.tenancy.oc1..<unique_ID> --time-one-earliest-time "2022-01-01T20:08:00+00:00" --time-one-latest-time "2022-02-25T20:08:00+00:00"

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

  • Run the ListAnnouncements operation to filter a list of announcements.