Oracle

Oracle Announcement Subscription API

The announcementSubscription API from Oracle — 5 operation(s) for announcementsubscription.

Documentation GitHub OpenAPI

Operations 9

GET /announcementSubscriptions Gets a list of announcement subscriptions. #

POST /announcementSubscriptions Creates a new announcement subscription. #

DELETE /announcementSubscriptions/{announcementSubscriptionId} Deletes a provisioned announcement subscription. #

GET /announcementSubscriptions/{announcementSubscriptionId} Gets an announcement subscription. #

PUT /announcementSubscriptions/{announcementSubscriptionId} Updates an announcement subscription. #

POST /announcementSubscriptions/{announcementSubscriptionId}/actions/changeCompartment Moves an announcement subscription to a different compartment. #

POST /announcementSubscriptions/{announcementSubscriptionId}/filterGroups Creates a new filter group in an announcement subscription. #

DELETE /announcementSubscriptions/{announcementSubscriptionId}/filterGroups/{filterGroupName} Deletes a filter group in an announcement subscription. #

PUT /announcementSubscriptions/{announcementSubscriptionId}/filterGroups/{filterGroupName} Updates a filter group in an announcement subscription. #

Documentation

https://docs.oracle.com/en-us/iaas/api/#/en/access-governance-cp/20220518/

https://docs.oracle.com/en-us/iaas/api/#/en/adm/20220421/

https://docs.oracle.com/en-us/iaas/api/#/en/advisor/20200606/

https://docs.oracle.com/en-us/iaas/api/#/en/ai-data-platform/20240831/

https://docs.oracle.com/en-us/iaas/api/#/en/analytics/20190331/

https://docs.oracle.com/en-us/iaas/api/#/en/announcements/0.0.1/

https://docs.oracle.com/en-us/iaas/api/#/en/api-gateway/20190501/

https://docs.oracle.com/en-us/iaas/api/#/en/apm-config/20210201/

https://docs.oracle.com/en-us/iaas/api/#/en/apm-control-plane/20200630/

https://docs.oracle.com/en-us/iaas/api/#/en/apm-synthetic-monitoring/20200630/

https://docs.oracle.com/en-us/iaas/api/#/en/apm-trace-explorer/20200630/

https://docs.oracle.com/en-us/iaas/api/#/en/audit/20190901/

https://docs.oracle.com/en-us/iaas/api/#/en/autoscaling/20181001/

https://docs.oracle.com/en-us/iaas/api/#/en/bastion/20210331/

https://docs.oracle.com/en-us/iaas/api/#/en/batch/20251031/

https://docs.oracle.com/en-us/iaas/api/#/en/bigdata/20190531/

https://docs.oracle.com/en-us/iaas/api/#/en/blockchain/20191010/

https://docs.oracle.com/en-us/iaas/api/#/en/budgets/20190111/

https://docs.oracle.com/en-us/iaas/api/#/en/certificates/20210224/

https://docs.oracle.com/en-us/iaas/api/#/en/certificatesmgmt/20210224/

https://docs.oracle.com/en-us/iaas/api/#/en/cloud-guard/20200131/

https://docs.oracle.com/en-us/iaas/api/#/en/clusterplacementgroups/20230801/

https://docs.oracle.com/en-us/iaas/api/#/en/compute-cloud-at-customer/20221208/

https://docs.oracle.com/en-us/iaas/api/#/en/container-instances/20210415/

https://docs.oracle.com/en-us/iaas/api/#/en/container-registry/20180419/

https://docs.oracle.com/en-us/iaas/api/#/en/containerengine/20180222/

https://docs.oracle.com/en-us/iaas/api/#/en/cost-anomaly/20190111/

https://docs.oracle.com/en-us/iaas/api/#/en/dashboard/20210731/

https://docs.oracle.com/en-us/iaas/api/#/en/data-catalog/20190325/

https://docs.oracle.com/en-us/iaas/api/#/en/data-flow/20200129/

https://docs.oracle.com/en-us/iaas/api/#/en/data-integration/20200430/

https://docs.oracle.com/en-us/iaas/api/#/en/data-safe/20181201/

https://docs.oracle.com/en-us/iaas/api/#/en/data-science/20190101/

https://docs.oracle.com/en-us/iaas/api/#/en/database-management/20201101/

https://docs.oracle.com/en-us/iaas/api/#/en/database-migration/20230518/

https://docs.oracle.com/en-us/iaas/api/#/en/database-multicloud-integrations/20240501/

https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/

https://docs.oracle.com/en-us/iaas/api/#/en/database-tools/20201005/

https://docs.oracle.com/en-us/iaas/api/#/en/database-tools-runtime/20230222/

https://docs.oracle.com/en-us/iaas/api/#/en/datacc/20251101/

https://docs.oracle.com/en-us/iaas/api/#/en/datalabeling-dp/20211001/

https://docs.oracle.com/en-us/iaas/api/#/en/datalabeling/20211001/

https://docs.oracle.com/en-us/iaas/api/#/en/delegate-access-control/20230801/

https://docs.oracle.com/en-us/iaas/api/#/en/devops/20210630/

https://docs.oracle.com/en-us/iaas/api/#/en/digital-assistant/20190506/

https://docs.oracle.com/en-us/iaas/api/#/en/disaster-recovery/20220125/

https://docs.oracle.com/en-us/iaas/api/#/en/dms/20211101/

https://docs.oracle.com/en-us/iaas/api/#/en/dns/20180115/

https://docs.oracle.com/en-us/iaas/api/#/en/document-understanding/20221109/

https://docs.oracle.com/en-us/iaas/api/#/en/edsfu/20220528/

https://docs.oracle.com/en-us/iaas/api/#/en/emaildelivery/20170907/

https://docs.oracle.com/en-us/iaas/api/#/en/emaildeliverysubmission/20220926/

https://docs.oracle.com/en-us/iaas/api/#/en/events/20181201/

https://docs.oracle.com/en-us/iaas/api/#/en/filestorage/20171215/

https://docs.oracle.com/en-us/iaas/api/#/en/fleet-management/20250228/

https://docs.oracle.com/en-us/iaas/api/#/en/functions/20181201/

https://docs.oracle.com/en-us/iaas/api/#/en/functionsdocgenpbf/1.0/

https://docs.oracle.com/en-us/iaas/api/#/en/fusion-applications/20211201/

https://docs.oracle.com/en-us/iaas/api/#/en/generative-ai-agents-client/20240531/

https://docs.oracle.com/en-us/iaas/api/#/en/generative-ai-agents/20240531/

https://docs.oracle.com/en-us/iaas/api/#/en/generative-ai-inference/20231130/

https://docs.oracle.com/en-us/iaas/api/#/en/generative-ai-nl2sql/20260325/

https://docs.oracle.com/en-us/iaas/api/#/en/generative-ai/20231130/

https://docs.oracle.com/en-us/iaas/api/#/en/generic/20160918/

https://docs.oracle.com/en-us/iaas/api/#/en/globally-distributed-database/20250101/

https://docs.oracle.com/en-us/iaas/api/#/en/goldengate/20200407/

https://docs.oracle.com/en-us/iaas/api/#/en/healthchecks/20180501/

https://docs.oracle.com/en-us/iaas/api/#/en/iaas/20160918/

https://docs.oracle.com/en-us/iaas/api/#/en/identity-domains/v1/

https://docs.oracle.com/en-us/iaas/api/#/en/identity-dp/v1/

https://docs.oracle.com/en-us/iaas/api/#/en/identity/20160918/

https://docs.oracle.com/en-us/iaas/api/#/en/incidentmanagement/20181231/

https://docs.oracle.com/en-us/iaas/api/#/en/instanceagent/20180530/

https://docs.oracle.com/en-us/iaas/api/#/en/integration/20190131/

https://docs.oracle.com/en-us/iaas/api/#/en/iot/20250531/

https://docs.oracle.com/en-us/iaas/api/#/en/itas/v1/

https://docs.oracle.com/en-us/iaas/api/#/en/jms-java-download/20230601/

https://docs.oracle.com/en-us/iaas/api/#/en/jms/20210610/

https://docs.oracle.com/en-us/iaas/api/#/en/jms-utils/20250521/

https://docs.oracle.com/en-us/iaas/api/#/en/kafka/20240901/

https://docs.oracle.com/en-us/iaas/api/#/en/key/release/

https://docs.oracle.com/en-us/iaas/api/#/en/language/20221001/

https://docs.oracle.com/en-us/iaas/api/#/en/licensemanager/20220430/

https://docs.oracle.com/en-us/iaas/api/#/en/limits-increase/20251101/

https://docs.oracle.com/en-us/iaas/api/#/en/limits/20181025/

https://docs.oracle.com/en-us/iaas/api/#/en/loadbalancer/20170115/

https://docs.oracle.com/en-us/iaas/api/#/en/logan-api-spec/20200601/

https://docs.oracle.com/en-us/iaas/api/#/en/logging-dataplane/20200831/

https://docs.oracle.com/en-us/iaas/api/#/en/logging-management/20200531/

https://docs.oracle.com/en-us/iaas/api/#/en/logging-search/20190909/

https://docs.oracle.com/en-us/iaas/api/#/en/lustre/20250228/

https://docs.oracle.com/en-us/iaas/api/#/en/managed-access/20220126/

https://docs.oracle.com/en-us/iaas/api/#/en/management-agent/20200202/

https://docs.oracle.com/en-us/iaas/api/#/en/managementdashboard/20200901/

https://docs.oracle.com/en-us/iaas/api/#/en/marketplace/20181001/

https://docs.oracle.com/en-us/iaas/api/#/en/mngdmac/20250320/

https://docs.oracle.com/en-us/iaas/api/#/en/monitoring/20180401/

https://docs.oracle.com/en-us/iaas/api/#/en/multicloud-omhub-cp/20180828/

https://docs.oracle.com/en-us/iaas/api/#/en/mysql/20190415/

https://docs.oracle.com/en-us/iaas/api/#/en/NetMonitor/20160918/

https://docs.oracle.com/en-us/iaas/api/#/en/network-firewall/20211001/

https://docs.oracle.com/en-us/iaas/api/#/en/network-firewall/20230501/

https://docs.oracle.com/en-us/iaas/api/#/en/networkloadbalancer/20200501/

https://docs.oracle.com/en-us/iaas/api/#/en/nosql-database/20190828/

https://docs.oracle.com/en-us/iaas/api/#/en/notification/20181201/

https://docs.oracle.com/en-us/iaas/api/#/en/objectstorage/20160918/

https://docs.oracle.com/en-us/iaas/api/#/en/OCB/20220509/

https://docs.oracle.com/en-us/iaas/api/#/en/occ/20230515/

https://docs.oracle.com/en-us/iaas/api/#/en/occds/20240430/

https://docs.oracle.com/en-us/iaas/api/#/en/occm/20231107/

https://docs.oracle.com/en-us/iaas/api/#/en/ocicache/20220315/

https://docs.oracle.com/en-us/iaas/api/#/en/ocm/20220919/

https://docs.oracle.com/en-us/iaas/api/#/en/opa/20210621/

https://docs.oracle.com/en-us/iaas/api/#/en/opensearch/20180828/

https://docs.oracle.com/en-us/iaas/api/#/en/operations-insights/20200630/

https://docs.oracle.com/en-us/iaas/api/#/en/operatoraccesscontrol/20200630/

https://docs.oracle.com/en-us/iaas/api/#/en/oracle-api-access-control/20241130/

https://docs.oracle.com/en-us/iaas/api/#/en/organizations/20230401/

https://docs.oracle.com/en-us/iaas/api/#/en/organizations/20200801/

https://docs.oracle.com/en-us/iaas/api/#/en/osmh/20220901/

https://docs.oracle.com/en-us/iaas/api/#/en/postgresql/20220915/

https://docs.oracle.com/en-us/iaas/api/#/en/psasvc/20240301/

https://docs.oracle.com/en-us/iaas/api/#/en/publisher/20241201/

https://docs.oracle.com/en-us/iaas/api/#/en/queue/20210201/

https://docs.oracle.com/en-us/iaas/api/#/en/recovery-service/20210216/

https://docs.oracle.com/en-us/iaas/api/#/en/registry/20160918/

https://docs.oracle.com/en-us/iaas/api/#/en/resource-analytics/20241031/

https://docs.oracle.com/en-us/iaas/api/#/en/resource-discovery-monitoring-control-api/20210330/

https://docs.oracle.com/en-us/iaas/api/#/en/resource-scheduler/20240430/

https://docs.oracle.com/en-us/iaas/api/#/en/resourcemanager/20180917/

https://docs.oracle.com/en-us/iaas/api/#/en/rover/20201210/

https://docs.oracle.com/en-us/iaas/api/#/en/s3objectstorage/20160918/

https://docs.oracle.com/en-us/iaas/api/#/en/scanning/20210215/

https://docs.oracle.com/en-us/iaas/api/#/en/search/20180409/

https://docs.oracle.com/en-us/iaas/api/#/en/secretmgmt/20180608/

https://docs.oracle.com/en-us/iaas/api/#/en/secretretrieval/20190301/

https://docs.oracle.com/en-us/iaas/api/#/en/secure-desktops/20220618/

https://docs.oracle.com/en-us/iaas/api/#/en/security-attribute/20240815/

https://docs.oracle.com/en-us/iaas/api/#/en/self/20260129/

https://docs.oracle.com/en-us/iaas/api/#/en/service-catalog/20210527/

https://docs.oracle.com/en-us/iaas/api/#/en/serviceconnectors/20200909/

https://docs.oracle.com/en-us/iaas/api/#/en/smp/20210914/

https://docs.oracle.com/en-us/iaas/api/#/en/speech/20220101/

https://docs.oracle.com/en-us/iaas/api/#/en/stack-monitoring/20210330/

https://docs.oracle.com/en-us/iaas/api/#/en/streaming/20180418/

https://docs.oracle.com/en-us/iaas/api/#/en/threat-intel/20220901/

https://docs.oracle.com/en-us/iaas/api/#/en/usage/20200107/

https://docs.oracle.com/en-us/iaas/api/#/en/usage-proxy/20190111/

https://docs.oracle.com/en-us/iaas/api/#/en/vision/20220125/

https://docs.oracle.com/en-us/iaas/api/#/en/visual-builder/20210601/

https://docs.oracle.com/en-us/iaas/api/#/en/visual-builder-studio/20180828/

https://docs.oracle.com/en-us/iaas/api/#/en/vmware/20200501/

https://docs.oracle.com/en-us/iaas/api/#/en/vmware/20230701/

https://docs.oracle.com/en-us/iaas/api/#/en/waa/20211230/

https://docs.oracle.com/en-us/iaas/api/#/en/waas/20181116/

https://docs.oracle.com/en-us/iaas/api/#/en/waf/20210930/

https://docs.oracle.com/en-us/iaas/api/#/en/wlms/20241101/

https://docs.oracle.com/en-us/iaas/api/#/en/workrequests/20160918/

https://docs.oracle.com/en-us/iaas/api/#/en/zero-trust-packet-routing/20240301/

https://docs.oracle.com/en-us/iaas/api/#/en/zero-trust-packet-routing-tools/20240301/

Specifications

https://raw.githubusercontent.com/api-evangelist/oracle/refs/heads/main/openapi/oracle-announcementsubscription-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/oracle-announcementsubscription-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  description: Manage Oracle Cloud Infrastructure console announcements.
  title: Announcements Service Announcement Subscription API
  version: 0.0.1
  x-provenance:
    method: harvested
    first_party: true
    publisher: Oracle
    source: https://docs.oracle.com/en-us/iaas/api/specs/ad81e510c25e589a2fdfbfe0fb957253a658175b2922b7951ddb17b4910c849b.yaml
    harvested: '2026-08-04'
    note: Published by Oracle as the contract for the Announcements Service API OCI service and stored verbatim; API Evangelist added only this provenance block.
  x-evidence:
  - url: https://docs.oracle.com/en-us/iaas/api/specs/index.json
    what: Oracle's own index of every OCI service specification
  - url: https://docs.oracle.com/en-us/iaas/api/specs/ad81e510c25e589a2fdfbfe0fb957253a658175b2922b7951ddb17b4910c849b.yaml
    what: the harvested document for Announcements Service API
servers:
- url: http://127.0.0.1/20180904
- url: https://127.0.0.1/20180904
tags:
- name: announcementSubscription
paths:
  /announcementSubscriptions:
    get:
      description: 'Gets a list of all announcement subscriptions in the specified compartment.


        This call is subject to an Announcements limit that applies to the total number of requests across all read or write operations. Announcements might throttle this call to reject an otherwise valid request when the total rate of operations exceeds 20 requests per second for a given user. The service might also throttle this call to reject an otherwise valid request when the total rate of operations exceeds 100 requests per second for a given tenancy.

        '
      operationId: ListAnnouncementSubscriptions
      parameters:
      - $ref: '#/components/parameters/CompartmentIdQueryParam'
      - $ref: '#/components/parameters/LifecycleStateQueryParam'
      - $ref: '#/components/parameters/DisplayNameQueryParam'
      - $ref: '#/components/parameters/AnnouncementSubscriptionIdentifierQueryParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/SortOrderQueryParam'
      - $ref: '#/components/parameters/SortByQueryParam'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        200:
          description: The list of announcement subscription summary objects for the specified compartment.
          headers:
            opc-next-page:
              description: 'For pagination of a list of items. When paging through a list, if this header appears in the response,

                then a partial list might have been returned. Include this value as the `page` parameter for the

                subsequent GET request to get the next batch of items.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnnouncementSubscriptionCollection'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default'
      summary: Gets a list of announcement subscriptions.
      tags:
      - announcementSubscription
      x-example: 'GET /20180904/announcementSubscriptions?compartmentId=<var>&lt;compartmentId&gt;</var>

        Host: announcements.us-ashburn-1.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
      x-related-resource: '#/definitions/AnnouncementSubscriptionCollection'
    post:
      description: 'Creates a new announcement subscription.


        This call is subject to an Announcements limit that applies to the total number of requests across all read or write operations. Announcements might throttle this call to reject an otherwise valid request when the total rate of operations exceeds 20 requests per second for a given user. The service might also throttle this call to reject an otherwise valid request when the total rate of operations exceeds 100 requests per second for a given tenancy.

        '
      operationId: CreateAnnouncementSubscription
      parameters:
      - $ref: '#/components/parameters/RetryTokenHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        200:
          description: The announcement subscription has been created.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnnouncementSubscription'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default'
      summary: Creates a new announcement subscription.
      tags:
      - announcementSubscription
      x-example: "POST /20180904/announcementSubscriptions\nHost: announcements.us-ashburn-1.oraclecloud.com\n<var>&lt;authorization and other headers&gt;</var>\n{\n  \"compartmentId\": \"ocid1.tenancy.oc1..exampleauingds4uwkcvbxv4ijs7zxuqnoewldef4fauxs7vaax2fab4gcsq\",\n  \"definedTags\": {},\n  \"description\": \"announcements for Brazil region required and recommended actions\",\n  \"displayName\": \"subscription-brazilactions\",\n  \"filterGroups\": {\n    \"filterbybrazilactions\": {\n      \"filters\": [\n        {\n          \"type\": \"REGION\",\n          \"value\": \"Brazil East (Sao Paulo)\"\n        },\n        {\n          \"type\": \"REGION\",\n          \"value\": \"Brazil Southeast (Vinhedo)\"\n        },\n        {\n          \"type\": \"ANNOUNCEMENT_TYPE\",\n          \"value\": \"ACTION_RECOMMENDED\"\n        },\n        {\n          \"type\": \"ANNOUNCEMENT_TYPE\",\n          \"value\": \"ACTION_REQUIRED\"\n        }\n      ]\n    }\n  }\n  \"freeformTags\": {},\n  \"onsTopicId\": \"ocid1.onstopic.oc1.phx.examplea4s4glpxfc22s7tmcvbitc7yiyjpft2faux3yb2oya2hihkyzieia\"\n}\n"
      x-related-resource: '#/definitions/AnnouncementSubscription'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateAnnouncementSubscriptionDetails'
        description: Details of the new announcement subscription.
        required: true
  /announcementSubscriptions/{announcementSubscriptionId}:
    delete:
      description: 'Deletes the specified announcement subscription.


        This call is subject to an Announcements limit that applies to the total number of requests across all read or write operations. Announcements might throttle this call to reject an otherwise valid request when the total rate of operations exceeds 20 requests per second for a given user. The service might also throttle this call to reject an otherwise valid request when the total rate of operations exceeds 100 requests per second for a given tenancy.

        '
      operationId: DeleteAnnouncementSubscription
      parameters:
      - $ref: '#/components/parameters/AnnouncementSubscriptionIdentifierPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        204:
          description: The announcement subscription has been deleted.
          headers:
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default'
      summary: Deletes a provisioned announcement subscription.
      tags:
      - announcementSubscription
      x-example: 'DELETE /20180904/announcementSubscriptions/<var>&lt;subscriptionId&gt;</var>

        Host: announcements.us-ashburn-1.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
      x-related-resource: '#/definitions/AnnouncementSubscription'
    get:
      description: 'Gets the specified announcement subscription.


        This call is subject to an Announcements limit that applies to the total number of requests across all read or write operations. Announcements might throttle this call to reject an otherwise valid request when the total rate of operations exceeds 20 requests per second for a given user. The service might also throttle this call to reject an otherwise valid request when the total rate of operations exceeds 100 requests per second for a given tenancy.

        '
      operationId: GetAnnouncementSubscription
      parameters:
      - $ref: '#/components/parameters/AnnouncementSubscriptionIdentifierPathParam'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        200:
          description: The announcement subscription with the given identifier.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnnouncementSubscription'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default'
      summary: Gets an announcement subscription.
      tags:
      - announcementSubscription
      x-example: 'GET /20180904/announcementSubscriptions/<var>&lt;subscriptionId&gt;</var>

        Host: announcements.us-ashburn-1.oraclecloud.com

        <var>&lt;authorization and other headers&gt;</var>

        '
    put:
      description: 'Updates the specified announcement subscription.


        This call is subject to an Announcements limit that applies to the total number of requests across all read or write operations. Announcements might throttle this call to reject an otherwise valid request when the total rate of operations exceeds 20 requests per second for a given user. The service might also throttle this call to reject an otherwise valid request when the total rate of operations exceeds 100 requests per second for a given tenancy.

        '
      operationId: UpdateAnnouncementSubscription
      parameters:
      - $ref: '#/components/parameters/AnnouncementSubscriptionIdentifierPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        200:
          description: The announcement subscription has been updated.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnnouncementSubscription'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default'
      summary: Updates an announcement subscription.
      tags:
      - announcementSubscription
      x-example: "POST /20180904/announcementSubscriptions\nHost: announcements.us-ashburn-1.oraclecloud.com\n<var>&lt;authorization and other headers&gt;</var>\n{\n  \"definedTags\": {},\n  \"description\": \"announcements for Brazil region (required and recommended actions)\",\n  \"displayName\": \"subscription-brazilactions\",\n  \"freeformTags\": {},\n  \"onsTopicId\": \"ocid1.onstopic.oc1.phx.examplea4s4glpxfc22s7tmcvbitc7yiyjpft2faux3yb2oya2hihkyzieia\",\n  \"preferredTimeZone\": \"America/Los_Angeles\"\n}\n"
      x-related-resource: '#/definitions/AnnouncementSubscription'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAnnouncementSubscriptionDetails'
        description: The subscription information to update.
        required: true
  /announcementSubscriptions/{announcementSubscriptionId}/actions/changeCompartment:
    post:
      description: 'Moves the specified announcement subscription from one compartment to another compartment. When provided, If-Match is checked against ETag values of the resource.


        This call is subject to an Announcements limit that applies to the total number of requests across all read or write operations. Announcements might throttle this call to reject an otherwise valid request when the total rate of operations exceeds 20 requests per second for a given user. The service might also throttle this call to reject an otherwise valid request when the total rate of operations exceeds 100 requests per second for a given tenancy.

        '
      operationId: ChangeAnnouncementSubscriptionCompartment
      parameters:
      - $ref: '#/components/parameters/AnnouncementSubscriptionIdentifierPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      responses:
        204:
          description: The announcement subscription has been moved to a different compartment.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
      summary: Moves an announcement subscription to a different compartment.
      tags:
      - announcementSubscription
      x-example: "POST /20180904/announcementSubscriptions/<var>&lt;subscriptionId&gt;</var>/actions/changeCompartme\nHost: announcements.us-ashburn-1.oraclecloud.com\n<var>&lt;authorization and other headers&gt;</var>\n{\n  \"compartmentId\": \"ocid1.compartment.oc1..exampleaoeapbnmopz4mi63cvbywa5h5vsr52ewvxwl6fauxcakeprhzmw2q\"\n}\n"
      x-related-resource: '#/definitions/AnnouncementSubscription'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChangeAnnouncementSubscriptionCompartmentDetails'
        description: The compartment information to update.
        required: true
  /announcementSubscriptions/{announcementSubscriptionId}/filterGroups:
    post:
      description: 'Creates a new filter group in the specified announcement subscription.


        This call is subject to an Announcements limit that applies to the total number of requests across all read or write operations. Announcements might throttle this call to reject an otherwise valid request when the total rate of operations exceeds 20 requests per second for a given user. The service might also throttle this call to reject an otherwise valid request when the total rate of operations exceeds 100 requests per second for a given tenancy.

        '
      operationId: CreateFilterGroup
      parameters:
      - $ref: '#/components/parameters/AnnouncementSubscriptionIdentifierPathParam'
      - $ref: '#/components/parameters/RetryTokenHeader'
      - $ref: '#/components/parameters/RequestIdHeader'
      - $ref: '#/components/parameters/IfMatchHeader'
      responses:
        200:
          description: The filter group has been created.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilterGroup'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        412:
          $ref: '#/components/responses/409'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default'
      summary: Creates a new filter group in an announcement subscription.
      tags:
      - announcementSubscription
      x-example: "POST /20180904/announcementSubscriptions/<var>&lt;subscriptionId&gt;</var>/filterGroups\nHost: announcements.us-ashburn-1.oraclecloud.com\n<var>&lt;authorization and other headers&gt;</var>\n{\n  \"name\": \"filterbycomputerequiredactions\",\n  \"filters\": [\n    {\n      \"type\": \"ANNOUNCEMENT_TYPE\",\n      \"value\": \"ACTION_REQUIRED\"\n    },\n    {\n      \"type\": \"SERVICE\",\n      \"value\": \"Oracle Cloud Infrastructure Compute\"\n    }\n  ]\n}\n"
      x-related-resource: '#/definitions/AnnouncementSubscription'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateFilterGroupDetails'
        description: Details of the new filter group.
        required: true
  /announcementSubscriptions/{announcementSubscriptionId}/filterGroups/{filterGroupName}:
    delete:
      description: 'Deletes a filter group in the specified announcement subscription.


        This call is subject to an Announcements limit that applies to the total number of requests across all read or write operations. Announcements might throttle this call to reject an otherwise valid request when the total rate of operations exceeds 20 requests per second for a given user. The service might also throttle this call to reject an otherwise valid request when the total rate of operations exceeds 100 requests per second for a given tenancy.

        '
      operationId: DeleteFilterGroup
      parameters:
      - $ref: '#/components/parameters/AnnouncementSubscriptionIdentifierPathParam'
      - $ref: '#/components/parameters/FilterGroupNamePathParam'
      - $ref: '#/components/parameters/RequestIdHeader'
      - $ref: '#/components/parameters/IfMatchHeader'
      responses:
        204:
          description: The filter group has been deleted.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default'
      summary: Deletes a filter group in an announcement subscription.
      tags:
      - announcementSubscription
      x-related-resource: '#/definitions/AnnouncementSubscription'
    put:
      description: 'Updates a filter group in the specified announcement subscription.


        This call is subject to an Announcements limit that applies to the total number of requests across all read or write operations. Announcements might throttle this call to reject an otherwise valid request when the total rate of operations exceeds 20 requests per second for a given user. The service might also throttle this call to reject an otherwise valid request when the total rate of operations exceeds 100 requests per second for a given tenancy.

        '
      operationId: UpdateFilterGroup
      parameters:
      - $ref: '#/components/parameters/AnnouncementSubscriptionIdentifierPathParam'
      - $ref: '#/components/parameters/FilterGroupNamePathParam'
      - $ref: '#/components/parameters/RequestIdHeader'
      - $ref: '#/components/parameters/IfMatchHeader'
      responses:
        200:
          description: The filter group has been updated.
          headers:
            etag:
              description: 'For optimistic concurrency control. See `if-match`.

                '
              schema:
                type: string
            opc-request-id:
              description: 'Unique Oracle-assigned identifier for the request. If you need to contact

                Oracle about a particular request, please provide the request ID.

                '
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilterGroup'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/default'
      summary: Updates a filter group in an announcement subscription.
      tags:
      - announcementSubscription
      x-example: "POST /20180904/announcementSubscriptions/<var>&lt;subscriptionId&gt;</var>/filterGroups/<var>&lt;filtergroupname&gt;</var>\nHost: announcements.us-ashburn-1.oraclecloud.com\n<var>&lt;authorization and other headers&gt;</var>\n{\n  \"name\": \"filterbyiaasus\",\n  \"filters\": [\n    {\n      \"type\": \"REGION\",\n      \"value\": \"US East (Ashburn)\"\n    },\n    {\n      \"type\": \"REGION\",\n      \"value\": \"US West (Phoenix)\"\n    },\n    {\n      \"type\": \"REGION\",\n      \"value\": \"US West (San Jose)\"\n    },\n    {\n      \"type\": \"PLATFORM_TYPE\",\n      \"value\": \"IAAS\"\n  ]\n}\n"
      x-related-resource: '#/definitions/AnnouncementSubscription'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateFilterGroupDetails'
        description: The filter group information to update.
        required: true
components:
  schemas:
    UpdateFilterGroupDetails:
      description: The details for updating a filter group in an announcement subscription.
      properties:
        filters:
          description: A list of filters against which the Announcements service will match announcements. You cannot combine the RESOURCE_ID filter with any other type of filter within a given filter group. For filter types that support multiple values, specify the values individually.
          items:
            $ref: '#/components/schemas/Filter'
          minItems: 1
          type: array
      required:
      - filters
      type: object
      x-example: "{\n  \"name\": \"filterbyiaasus\",\n  \"filters\": [\n    {\n      \"type\": \"REGION\",\n      \"value\": \"US East (Ashburn)\"\n    },\n    {\n      \"type\": \"REGION\",\n      \"value\": \"US West (Phoenix)\"\n    },\n    {\n      \"type\": \"REGION\",\n      \"value\": \"US West (San Jose)\"\n    },\n    {\n      \"type\": \"PLATFORM_TYPE\",\n      \"value\": \"IAAS\"\n  ]\n}\n"
    Filter:
      description: Criteria that the Announcements service uses to match announcements so it can provide only desired announcements to subscribers.
      properties:
        type:
          description: The type of filter. You cannot combine the RESOURCE_ID filter with any other type of filter within a given filter group. For filter types that support multiple values, specify the values individually.
          enum:
          - COMPARTMENT_ID
          - PLATFORM_TYPE
          - REGION
          - SERVICE
          - RESOURCE_ID
          - ANNOUNCEMENT_TYPE
          type: string
        value:
          description: The value of the filter.
          type: string
      required:
      - type
      - value
      type: object
      x-example: "{\n  \"type\": \"ANNOUNCEMENT_TYPE\",\n  \"value\": \"ACTION_REQUIRED\"\n}\n"
    UpdateAnnouncementSubscriptionDetails:
      description: The details for updating an announcement subscription.
      properties:
        definedTags:
          additionalProperties:
            additionalProperties:
              description: 'The value of the tag. Only string, integer and boolean types are supported.

                '
              type: object
            description: 'Key-value pair representing predefined tags'' keys and values scoped to a namespace.

              Example: `{"bar-key": "value"}`

              '
            type: object
          description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace.

            Example: `{"foo-namespace": {"bar-key": "value"}}`

            '
          type: object
        description:
          description: A description of the announcement subscription. Avoid entering confidential information.
          maxLength: 400
          type: string
        displayName:
          description: A user-friendly name for the announcement subscription. Does not have to be unique, and it's changeable. Avoid entering confidential information.
          maxLength: 255
          minLength: 1
          type: string
        freeformTags:
          additionalProperties:
            type: string
          description: 'Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only.

            Example: `{"bar-key": "value"}`

            '
          type: object
        onsTopicId:
          description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the Notifications service topic that is the target for publishing announcements that match the configured announcement subscription. The caller of the operation needs the ONS_TOPIC_PUBLISH permission for the targeted Notifications service topic. For more information about Notifications permissions, see [Details for Notifications](/Content/Identity/policyreference/notificationpolicyreference.htm).

            '
          type: string
        preferredLanguage:
          default: en-US
          description: (For announcement subscriptions with SaaS configured as the platform type or Oracle Fusion Applications as the service, or both, only) The language in which the user prefers to receive emailed announcements. Specify the preference with a value that uses the x-obmcs-human-language format. For example fr-FR.
          example: fr-FR
          format: x-obmcs-human-language
          type: string
        preferredTimeZone:
          default: UTC
          description: The time zone in which the user prefers to receive announcements. Specify the preference with a value that uses the IANA Time Zone Database format (x-obmcs-time-zone). For example - America/Los_Angeles
          example: America/Los_Angeles
          format: x-obmcs-time-zone
          type: string
      type: object
      x-example: "{\n  \"definedTags\": {},\n  \"description\": \"announcements for Brazil region (required and recommended actions)\",\n  \"displayName\": \"subscription-brazilactions\",\n  \"freeformTags\": {},\n  \"onsTopicId\": \"ocid1.onstopic.oc1.phx.examplea4s4glpxfc22s7tmcvbitc7yiyjpft2faux3yb2oya2hihkyzieia\",\n  \"preferredTimeZone\": \"America/Los_Angeles\"\n}\n"
    CreateFilterGroupDetails:
      description: The details for creating a new filter group for an announcement subscription.
      properties:
        filters:
          description: A list of filters against which the Announcements service will match announcements. You cannot have more than one of any given filter type within a filter group.
          items:
            $ref: '#/components/schemas/Filter'
          minItems: 1
          type: array
        name:
          description: The name of the filter group. The name must be unique and it cannot be changed. Avoid entering confidential information.
          type: string
      required:
      - name
      - filters
      type: object
      x-example: "{\n  \"name\": \"filterbyregion-us\",\n  \"filters\": [\n    {\n      \"type\": \"REGION\",\n      \"value\": \"US East (Ashburn)\"\n    },\n    {\n      \"type\": \"REGION\",\n      \"value\": \"US West (Phoenix)\"\n    },\n    {\n      \"type\": \"REGION\",\n      \"value\": \"US West (San Jose)\"\n    }\n  ]\n}\n"
    CreateAnnouncementSubscriptionDetails:
      description: The details for creating a new announcement subscription.
      properties:
        compartmentId:
          description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment where you want to create the announcement subscription.

            '
          maxLength: 255
          minLength: 1
          type: string
        definedTags:
          additionalProperties:
            additionalProperties:
              description: 'The value of the tag. Only string, integer and boolean types are supported.

                '
              type: object
            description: 'Key-value pair representing predefined tags'' keys and values scoped to a namespace.

              Example: `{"bar-key": "value"}`

              '
    

# --- truncated at 32 KB (58 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle/refs/heads/main/openapi/oracle-announcementsubscription-api-openapi.yml