Oracle Events API

The events API from Oracle — 3 operation(s) for events.

Operations 6

GET /rules Lists rules for this compartment. #
POST /rules Creates a new rule #
DELETE /rules/{ruleId} Deletes a rule #
GET /rules/{ruleId} Retrieves a rule #
PUT /rules/{ruleId} Updates a rule #
POST /rules/{ruleId}/actions/changeCompartment Moves a rule into a different compartment. When provided, If-Match is checked against ETag values of the resource. #

Documentation

📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/access-governance-cp/20220518/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/adm/20220421/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/advisor/20200606/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/ai-data-platform/20240831/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/analytics/20190331/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/announcements/0.0.1/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/api-gateway/20190501/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/apm-config/20210201/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/apm-control-plane/20200630/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/apm-synthetic-monitoring/20200630/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/apm-trace-explorer/20200630/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/audit/20190901/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/autoscaling/20181001/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/bastion/20210331/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/batch/20251031/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/bigdata/20190531/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/blockchain/20191010/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/budgets/20190111/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/certificates/20210224/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/certificatesmgmt/20210224/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/cloud-guard/20200131/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/clusterplacementgroups/20230801/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/compute-cloud-at-customer/20221208/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/container-instances/20210415/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/container-registry/20180419/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/containerengine/20180222/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/cost-anomaly/20190111/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/dashboard/20210731/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/data-catalog/20190325/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/data-flow/20200129/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/data-integration/20200430/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/data-safe/20181201/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/data-science/20190101/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/database-management/20201101/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/database-migration/20230518/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/database-multicloud-integrations/20240501/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/database/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/database-tools/20201005/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/database-tools-runtime/20230222/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/datacc/20251101/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/datalabeling-dp/20211001/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/datalabeling/20211001/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/delegate-access-control/20230801/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/devops/20210630/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/digital-assistant/20190506/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/disaster-recovery/20220125/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/dms/20211101/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/dns/20180115/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/document-understanding/20221109/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/edsfu/20220528/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/emaildelivery/20170907/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/emaildeliverysubmission/20220926/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/events/20181201/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/filestorage/20171215/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/fleet-management/20250228/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/functions/20181201/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/functionsdocgenpbf/1.0/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/fusion-applications/20211201/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/generative-ai-agents-client/20240531/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/generative-ai-agents/20240531/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/generative-ai-inference/20231130/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/generative-ai-nl2sql/20260325/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/generative-ai/20231130/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/generic/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/globally-distributed-database/20250101/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/goldengate/20200407/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/healthchecks/20180501/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/iaas/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/identity-domains/v1/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/identity-dp/v1/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/identity/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/incidentmanagement/20181231/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/instanceagent/20180530/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/integration/20190131/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/iot/20250531/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/itas/v1/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/jms-java-download/20230601/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/jms/20210610/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/jms-utils/20250521/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/kafka/20240901/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/key/release/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/language/20221001/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/licensemanager/20220430/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/limits-increase/20251101/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/limits/20181025/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/loadbalancer/20170115/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/logan-api-spec/20200601/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/logging-dataplane/20200831/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/logging-management/20200531/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/logging-search/20190909/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/lustre/20250228/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/managed-access/20220126/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/management-agent/20200202/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/managementdashboard/20200901/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/marketplace/20181001/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/mngdmac/20250320/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/monitoring/20180401/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/multicloud-omhub-cp/20180828/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/mysql/20190415/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/NetMonitor/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/network-firewall/20211001/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/network-firewall/20230501/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/networkloadbalancer/20200501/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/nosql-database/20190828/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/notification/20181201/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/objectstorage/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/OCB/20220509/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/occ/20230515/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/occds/20240430/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/occm/20231107/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/ocicache/20220315/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/ocm/20220919/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/opa/20210621/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/opensearch/20180828/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/operations-insights/20200630/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/operatoraccesscontrol/20200630/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/oracle-api-access-control/20241130/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/organizations/20230401/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/organizations/20200801/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/osmh/20220901/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/postgresql/20220915/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/psasvc/20240301/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/publisher/20241201/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/queue/20210201/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/recovery-service/20210216/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/registry/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/resource-analytics/20241031/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/resource-discovery-monitoring-control-api/20210330/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/resource-scheduler/20240430/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/resourcemanager/20180917/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/rover/20201210/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/s3objectstorage/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/scanning/20210215/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/search/20180409/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/secretmgmt/20180608/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/secretretrieval/20190301/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/secure-desktops/20220618/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/security-attribute/20240815/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/self/20260129/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/service-catalog/20210527/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/serviceconnectors/20200909/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/smp/20210914/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/speech/20220101/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/stack-monitoring/20210330/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/streaming/20180418/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/threat-intel/20220901/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/usage/20200107/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/usage-proxy/20190111/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/vision/20220125/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/visual-builder/20210601/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/visual-builder-studio/20180828/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/vmware/20200501/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/vmware/20230701/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/waa/20211230/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/waas/20181116/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/waf/20210930/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/wlms/20241101/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/workrequests/20160918/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/zero-trust-packet-routing/20240301/
📖
APIReference
https://docs.oracle.com/en-us/iaas/api/#/en/zero-trust-packet-routing-tools/20240301/

Specifications

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-events-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.

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

OpenAPI Specification

oracle-events-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: "API for the Events Service. Use this API to manage rules and actions that create automation \nin your tenancy. For more information, see [Overview of Events](/iaas/Content/Events/Concepts/eventsoverview.htm).\n"
  title: Events API
  version: '20181201'
  x-provenance:
    method: harvested
    first_party: true
    publisher: Oracle
    source: https://docs.oracle.com/en-us/iaas/api/specs/589e549735dd190d78e8fb6ff9891048de06687f3bb47308774991e267d754a9.yaml
    harvested: '2026-08-04'
    note: Published by Oracle as the contract for the Events 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/589e549735dd190d78e8fb6ff9891048de06687f3bb47308774991e267d754a9.yaml
    what: the harvested document for Events API
servers:
- url: https://events.$region.oraclecloud.com/20181201
tags:
- name: events
paths:
  /rules:
    get:
      description: 'Lists rules for this compartment.

        '
      operationId: ListRules
      parameters:
      - $ref: '#/components/parameters/CompartmentIdQueryParam'
      - $ref: '#/components/parameters/PaginationLimitQueryParam'
      - $ref: '#/components/parameters/PaginationTokenQueryParam'
      - $ref: '#/components/parameters/ListRulesFilterByLifecycleStateQueryParam'
      - description: 'A filter to return only rules with descriptions that match the displayName string

          in this parameter.


          Example: `"This rule sends a notification upon completion of DbaaS backup."`

          '
        in: query
        name: displayName
        required: false
        schema:
          type: string
          maxLength: 1024
          minLength: 1
      - description: 'Specifies the attribute with which to sort the rules.


          Default: `timeCreated`


          * **TIME_CREATED:** Sorts by timeCreated.

          * **DISPLAY_NAME:** Sorts by displayName.

          * **ID:** Sorts by id.

          '
        in: query
        name: sortBy
        required: false
        schema:
          type: string
          enum:
          - TIME_CREATED
          - ID
          - DISPLAY_NAME
      - $ref: '#/components/parameters/SortOrderQueryParam'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      responses:
        200:
          description: Succesfully retrieved summary of rules.
          headers:
            opc-next-page:
              description: 'For list pagination. When this header appears in the response, additional pages of

                results remain. For important details about how pagination works, see

                [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine).

                '
              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:
                items:
                  $ref: '#/components/schemas/RuleSummary'
                type: array
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        403:
          $ref: '#/components/responses/403'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Lists rules for this compartment.
      tags:
      - events
      x-example: 'GET /20181201/rules?compartmentId=<var>&lt;compartment_OCID&gt;</var>

        Host: events.us-phoenix-1.oraclecloud.com

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

        '
    post:
      description: 'Creates a new rule.

        '
      operationId: CreateRule
      parameters:
      - $ref: '#/components/parameters/RetryTokenHeader'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      responses:
        200:
          description: Succesfully created rule.
          headers:
            etag:
              description: 'For optimistic concurrency control. Add this value to the `if-match` parameter

                in a PUT or DELETE operation. The resource will be updated only if the value you

                provide matches the `etag` on the resource.

                '
              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/Rule'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        403:
          $ref: '#/components/responses/403'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Creates a new rule
      tags:
      - events
      x-example: "POST /20181201/rules\nHost: events.us-phoenix-1.oraclecloud.com\n<var>&lt;authorization and other headers&gt;</var>\n\n{\n  \"displayName\": \"This rule sends a notification upon completion of DbaaS backup\",\n  \"condition\": \"{\n    \\\"eventType\\\": \\\"com.oraclecloud.databaseservice.autonomous.database.backup.end\\\"\n    }\",\n  \"compartmentId\": \"ocid.compartment.oc1..<var>&lt;unique_ID&gt;</var>\",\n  \"isEnabled\": true,\n  \"freeformTags\": {\n    \"Department\": \"Finance\"\n    },\n  \"definedTags\": {\n    Operations\": {\n      \"CostCenter\": \"42\"\n    },\n  \"actions\": {\n    \"actions\": [\n      {\n        \"actionType\": \"ONS\",\n        \"id\": \"ocid.action.oc1..<var>&lt;unique_ID&gt;</var>\",\n        \"lifecycleMessage\":null,\n        \"lifecycleState\": \"CREATING\"\n      }\n    ]\n  }\n}\n"
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateRuleDetails'
        description: Specification of the rule to create
        required: true
  /rules/{ruleId}:
    delete:
      description: Deletes a rule.
      operationId: DeleteRule
      parameters:
      - $ref: '#/components/parameters/RuleIdPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      responses:
        204:
          description: Rule deleted successfully.
          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'
        403:
          $ref: '#/components/responses/403'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Deletes a rule
      tags:
      - events
      x-example: 'DELETE /20181201/rules/<var>&lt;rule_OCID&gt;</var>

        Host: events.us-phoenix-1.oraclecloud.com

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

        '
      x-related-resource: '#/definitions/Rule'
    get:
      description: Retrieves a rule.
      operationId: GetRule
      parameters:
      - $ref: '#/components/parameters/RuleIdPathParam'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      responses:
        200:
          description: Succesfully retrieved rule.
          headers:
            etag:
              description: 'For optimistic concurrency control. Add this value to the `if-match` parameter

                in a PUT or DELETE operation. The resource will be updated only if the value you

                provide matches the `etag` on the resource.

                '
              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/Rule'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        403:
          $ref: '#/components/responses/403'
        404:
          $ref: '#/components/responses/404'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Retrieves a rule
      tags:
      - events
      x-example: 'GET /20181201/rules/<var>&lt;rule_OCID&gt;</var>

        Host: events.us-phoenix-1.oraclecloud.com

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

        '
    put:
      description: 'Updates a rule.

        '
      operationId: UpdateRule
      parameters:
      - $ref: '#/components/parameters/RuleIdPathParam'
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      responses:
        200:
          description: 'Succesfully updated rule.

            '
          headers:
            etag:
              description: 'For optimistic concurrency control. Add this value to the `if-match` parameter

                in a PUT or DELETE operation. The resource will be updated only if the value you

                provide matches the `etag` on the resource.

                '
              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/Rule'
        400:
          $ref: '#/components/responses/400'
        401:
          $ref: '#/components/responses/401'
        403:
          $ref: '#/components/responses/403'
        404:
          $ref: '#/components/responses/404'
        412:
          $ref: '#/components/responses/412'
        429:
          $ref: '#/components/responses/429'
        500:
          $ref: '#/components/responses/500'
        default:
          $ref: '#/components/responses/DefaultError'
      summary: Updates a rule
      tags:
      - events
      x-example: "PUT /20181201/rules/<var>&lt;rule_OCID&gt;</var>\nHost: events.us-phoenix-1.oraclecloud.com\n<var>&lt;authorization and other headers&gt;</var>\n\n{\n  \"displayName\": \"This rule sends a notification upon completion of DbaaS backup\",\n  \"condition\": \"{\n    \\\"eventType\\\": \\\"com.oraclecloud.databaseservice.autonomous.database.backup.end\\\"\n    }\",\n  \"isEnabled\": true,\n  \"freeformTags\": {\n    \"Department\": \"Finance\"\n    },\n  \"definedTags\": {\n    Operations\": {\n      \"CostCenter\": \"42\"\n    },\n  \"actions\": {\n    \"actions\": [\n      {\n        \"actionType\": \"ONS\",\n        \"id\": \"ocid.action.oc1..<var>&lt;unique_ID&gt;</var>\",\n        \"lifecycleMessage\":null,\n        \"lifecycleState\": \"CREATING\"\n      }\n    ]\n  }\n}\n"
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateRuleDetails'
        description: The new rule spec to apply
        required: true
  /rules/{ruleId}/actions/changeCompartment:
    post:
      description: "Moves a rule into a different compartment within the same tenancy. For information about moving \nresources between compartments, see [Moving Resources to a Different Compartment](/iaas/Content/Identity/Tasks/managingcompartments.htm#moveRes).\n"
      operationId: ChangeRuleCompartment
      parameters:
      - $ref: '#/components/parameters/IfMatchHeader'
      - $ref: '#/components/parameters/OpcRequestIdHeaderParam'
      - $ref: '#/components/parameters/RetryTokenHeader'
      - $ref: '#/components/parameters/RuleIdPathParam'
      responses:
        204:
          description: Response returned for a successful change compartment request.
          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
        401:
          $ref: '#/components/responses/401'
        404:
          $ref: '#/components/responses/404'
        409:
          $ref: '#/components/responses/409'
        500:
          $ref: '#/components/responses/500'
      summary: Moves a rule into a different compartment. When provided, If-Match is checked against ETag values of the resource.
      tags:
      - events
      x-related-resource: '#/definitions/Rule'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChangeRuleCompartmentDetails'
        required: true
components:
  schemas:
    ActionDetails:
      description: 'Object used to create an action.

        '
      discriminator:
        propertyName: actionType
      properties:
        actionType:
          description: 'The action to perform if the condition in the rule matches an event.


            * **ONS:** Send to an Oracle Notification Service topic.

            * **OSS:** Send to a stream from Oracle Streaming Service.

            * **FAAS:** Send to an Oracle Functions Service endpoint.

            '
          enum:
          - ONS
          - OSS
          - FAAS
          type: string
        description:
          description: 'A string that describes the details of the action. It does not have to be unique, and you can change it. Avoid entering

            confidential information.

            '
          maxLength: 1024
          minLength: 0
          type: string
        isEnabled:
          default: true
          description: 'Whether or not this action is currently enabled.


            Example: `true`

            '
          type: boolean
      required:
      - actionType
      - isEnabled
      type: object
      x-example: "{\n  \"actionType\": \"ONS\",\n  \"isEnabled\": true,\n  \"description\": \"Notification action\"      \n}\n"
    ActionList:
      description: 'A list of Action objects associated with a rule.

        '
      properties:
        actions:
          description: 'A list of one or more Action objects.

            '
          items:
            $ref: '#/components/schemas/Action'
          maxItems: 10
          minItems: 1
          type: array
      required:
      - actions
      type: object
      x-example: "{\n  \"actions\": { }\n}\n"
    RuleSummary:
      description: 'The summary details of rules for Events. For more information, see

        [Managing Rules for Events](/iaas/Content/Events/Task/managingrules.htm).

        '
      properties:
        compartmentId:
          description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the compartment to which this rule belongs.

            '
          maxLength: 1024
          minLength: 1
          type: string
        condition:
          description: "A filter that specifies the event that will trigger actions associated with this rule. A few \nimportant things to remember about filters:\n\n* Fields not mentioned in the condition are ignored. You can create a valid filter that matches\nall events with two curly brackets: `{}` \n\n  For more examples, see \n[Matching Events with Filters](/iaas/Content/Events/Concepts/filterevents.htm).       \n* For a condition with fields to match an event, the event must contain all the field names \nlisted in the condition. Field names must appear in the condition with the same nesting \nstructure used in the event. \n\n  For a list of reference events, see \n[Services that Produce Events](/iaas/Content/Events/Reference/eventsproducers.htm).       \n* Rules apply to events in the compartment in which you create them and any child compartments. \nThis means that a condition specified by a rule only matches events emitted from resources in \nthe compartment or any of its child compartments. \n* Wildcard matching is supported with the asterisk (*) character. \n\n  For examples of wildcard matching, see \n[Matching Events with Filters](/iaas/Content/Events/Concepts/filterevents.htm)\n\nExample: `\\\"eventType\\\": \\\"com.oraclecloud.databaseservice.autonomous.database.backup.end\\\"`\n"
          type: string
        definedTags:
          additionalProperties:
            additionalProperties:
              description: 'The value of the tag. Only the String type is supported.

                '
              type: object
            description: 'Key-value pair representing a defined tag key and value, scoped to a namespace.


              Example: `{"CostCenter": "42"}''

              '
            type: object
          description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm).


            Example: `{"Operations": {"CostCenter": "42"}}`

            '
          type: object
        description:
          description: 'A string that describes the details of the rule. It does not have to be unique, and you can change it. Avoid entering

            confidential information.

            '
          maxLength: 1024
          minLength: 0
          type: string
        displayName:
          description: 'A string that describes the rule. It does not have to be unique, and you can change it. Avoid entering

            confidential information.


            Example: `"This rule sends a notification upon completion of DbaaS backup."`

            '
          maxLength: 255
          minLength: 1
          type: string
        freeformTags:
          additionalProperties:
            type: string
          description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. Exists for cross-compatibility only.

            For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm).


            Example: `{"Department": "Finance"}`

            '
          type: object
        id:
          description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of this rule.

            '
          maxLength: 1024
          minLength: 1
          type: string
        isEnabled:
          default: true
          description: 'Whether or not this rule is currently enabled.


            Example: `true`

            '
          type: boolean
        lifecycleState:
          type: string
          x-obmcs-enumref: '#/definitions/Rule/lifecycleState'
        timeCreated:
          description: 'The time this rule was created, expressed in [RFC 3339](https://tools.ietf.org/html/rfc3339)

            timestamp format.


            Example: `2018-09-12T22:47:12.613Z`

            '
          format: date-time
          type: string
      required:
      - id
      - displayName
      - lifecycleState
      - condition
      - compartmentId
      - isEnabled
      - timeCreated
      type: object
      x-example: "{\n  \"displayName\": \"This rule sends a notification upon completion of DbaaS backup\",\n  \"lifecycleState\": \"CREATING\",\n  \"condition\": \"{\n      \\\"eventType\\\": \\\"com.oraclecloud.databaseservice.autonomous.database.backup.end\\\"\n      }\",\n  \"compartmentId\": \"ocid.compartment.oc1..<var>&lt;unique_ID&gt;</var>\",\n  \"isEnabled\": true,\n  \"id\": \"ocid.rule.oc1..<var>&lt;unique_ID&gt;</var>\",\n  \"timeCreated\": \"2018-09-12T22:47:12.613Z\",\n  \"freeformTags\": {\n    \"Department\": \"Finance\"\n    },\n  \"definedTags\": {\n    \"Operations\": {\n      \"CostCenter\": \"42\"\n    },\n}\n"
    CreateRuleDetails:
      description: Object used to create an events1.0 rule and events2.0 system rule.
      properties:
        actions:
          $ref: '#/components/schemas/ActionDetailsList'
        compartmentId:
          description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the compartment to which this rule belongs.

            '
          maxLength: 1024
          minLength: 1
          type: string
        condition:
          description: "A filter that specifies the event that will trigger actions associated with this rule. A few \nimportant things to remember about filters:\n\n* Fields not mentioned in the condition are ignored. You can create a valid filter that matches\nall events with two curly brackets: `{}` \n\n  For more examples, see \n[Matching Events with Filters](/iaas/Content/Events/Concepts/filterevents.htm).       \n* For a condition with fields to match an event, the event must contain all the field names \nlisted in the condition. Field names must appear in the condition with the same nesting \nstructure used in the event. \n\n  For a list of reference events, see \n[Services that Produce Events](/iaas/Content/Events/Reference/eventsproducers.htm).       \n* Rules apply to events in the compartment in which you create them and any child compartments. \nThis means that a condition specified by a rule only matches events emitted from resources in \nthe compartment or any of its child compartments. \n* Wildcard matching is supported with the asterisk (*) character. \n\n  For examples of wildcard matching, see \n[Matching Events with Filters](/iaas/Content/Events/Concepts/filterevents.htm)\n\nExample: `\\\"eventType\\\": \\\"com.oraclecloud.databaseservice.autonomous.database.backup.end\\\"`\n"
          type: string
        definedTags:
          additionalProperties:
            additionalProperties:
              description: 'The value of the tag. Only the String type is supported.

                '
              type: object
            description: 'Key-value pair representing a defined tag key and value, scoped to a namespace.


              Example: `{"CostCenter": "42"}''

              '
            type: object
          description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm).


            Example: `{"Operations": {"CostCenter": "42"}}`

            '
          type: object
        description:
          description: 'A string that describes the details of the rule. It does not have to be unique, and you can change it. Avoid entering

            confidential information.

            '
          maxLength: 1024
          minLength: 0
          type: string
        displayName:
          description: 'A string that describes the rule. It does not have to be unique, and you can change it. Avoid entering

            confidential information.

            '
          maxLength: 255
          minLength: 1
          type: string
        freeformTags:
          additionalProperties:
            type: string
          description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. Exists for cross-compatibility only.

            For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm).


            Example: `{"Department": "Finance"}`

            '
          type: object
        isEnabled:
          default: true
          description: 'Whether or not this rule is currently enabled.


            Example: `true`

            '
          type: boolean
      required:
      - displayName
      - isEnabled
      - condition
      - actions
      - compartmentId
      type: object
      x-example: "{\n  \"displayName\": \"This rule sends a notification upon completion of DbaaS backup\",\n  \"condition\": \"{\n    \\\"eventType\\\": \\\"com.oraclecloud.databaseservice.autonomous.database.backup.end\\\"\n    }\",\n  \"compartmentId\": \"ocid.compartment.oc1..<var>&lt;unique_ID&gt;</var>\",\n  \"isEnabled\": true,\n  \"freeformTags\": {\n    \"Department\": \"Finance\"\n    },\n  \"definedTags\": {\n    \"Operations\": {\n      \"CostCenter\": \"42\"\n    },\n  \"actions\": {\n    \"actions\": [\n      {\n        \"actionType\": \"ONS\",\n        \"id\": \"ocid.action.oc1..<var>&lt;unique_ID&gt;</var>\",\n        \"lifecycleMessage\":null,\n        \"lifecycleState\": \"CREATING\"\n      }\n    ]\n  }\n}\n"
    UpdateRuleDetails:
      description: The rule attributes that you can update.
      properties:
        actions:
          $ref: '#/components/schemas/ActionDetailsList'
        condition:
          description: "A filter that specifies the event that will trigger actions associated with this rule. A few \nimportant things to remember about filters:\n\n* Fields not mentioned in the condition are ignored. You can create a valid filter that matches\nall events with two curly brackets: `{}` \n\n  For more examples, see \n[Matching Events with Filters](/iaas/Content/Events/Concepts/filterevents.htm).       \n* For a condition with fields to match an event, the event must contain all the field names \nlisted in the condition. Field names must appear in the condition with the same nesting \nstructure used in the event. \n\n  For a list of reference events, see \n[Services that Produce Events](/iaas/Content/Events/Reference/eventsproducers.htm).       \n* Rules apply to events in the compartment in which you create them and any child compartments. \nThis means that a condition specified by a rule only matches events emitted from resources in \nthe compartment or any of its child compartments. \n* Wildcard matching is supported with the asterisk (*) character. \n\n  For examples of wildcard matching, see \n[Matching Events with Filters](/iaas/Content/Events/Concepts/filterevents.htm)\n\nExample: `\\\"eventType\\\": \\\"com.oraclecloud.databaseservice.autonomous.database.backup.end\\\"`\n"
          minLength: 1
          type: string
        definedTags:
          additionalProperties:
            additionalProperties:
              description: 'The value of the tag. Only the String type is supported.

                '
              type: object
            description: 'Key-value pair representing a defined tag key and value, scoped to a namespace.


              Example: `{"CostCenter": "42"}''

              '
            type: object
          description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm).


            Example: `{"Operations": {"CostCenter": "42"}}`

            '
          type: object
        description:
          description: 'A string that describes the details of the rule. It does not have to be unique, and you can change it. Avoid entering

            confidential information.

            '
          maxLength: 1024
          minLength: 0
          type: string
        displayName:
          description: 'A string that describes the rule. It does not have to be unique, and you can change it. Avoid entering

            confidential information.

            '
          maxLength: 255
          minLength: 1
          type: string
        freeformTags:
          additionalProperties:
            type: string
          description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. Exists for cross-compatibility only.

            For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm).


            Example: `{"Department": "Finance"}`

            '
          type: object
        isEnabled:
          description: 'Whether or not this rule is currently enabled.


            Example: `true`

            '
          type: boolean
      type: object
      x-example: "{\n  \"displayName\": \"This rule sends a notification upon completion of DbaaS backup\",\n  \"condition\": \"{\n      \\\"eventType\\\": \\\"com.oraclecloud.databaseservice.autonomous.database.backup.end\\\"\n      }\",\n  \"isEnabled\": true,\n  \"freeformTags\": {\n    \"Department\": \"Finance\"\n    },\n  \"definedTags\": {\n    \"Operations\": {\n      \"CostCenter\": \"42\"\n    },\n  \"actions\": {\n    \"actions\": [\n      {\n        \"actionType\": \"ONS\",\n        \"id\": \"ocid.action.oc1..<var>&lt;unique_ID&gt;</var>\",\n        \"lifecycleMessage\":null,\n        \"lifecycleState\": \"CREATING\"\n      }\n    ]\n  }\n}\n"
    ActionDetailsList:
      description: A list of ActionDetails objects to create for a rule.
      properties:
        actions:
          description: 'A list of one or more ActionDetails objects.

            '
          items:
            $ref: '#/components/schemas/ActionDetails'
          maxItems: 10
          minItems: 1
          type: array
      required:
      - actions
      type: object
      x-example: "{\n  \"actions\": [ ]\n}\n"
    Action:
      description: 'An object that represents an action to trigger for events that match a rule.

        '
      discriminator:
        propertyName: actionType
      properties:
        actionType:
          description: 'The action to perform if the condition in the rule matches an event.


            * **ONS:** Send to an Oracle Notification Service topic.

            * **OSS:** Send to a stream from Oracle Streaming Service.

            * **FAAS:** Send to an Oracle Functions Service endpoint.

            '
          enum:
          - ONS
          - OSS
          - FAAS
          type: string
        description:
          description: 'A string that describes the details of the action. It does not have to be unique, and you can change it. Avoid entering

            confidential information.

            '
          maxLength: 1024
          minLength: 0
          type: string
        id:
          description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the action.

            '
          maxLength: 1024
          minLength: 1
          type: string
        isEnabled:
          default: true
          description: 'Whether or not this action is currently enabled.


            Example: `true`

            '
          type: boolean
        lifecycleMessage:
          description: 'A message generated by the Events service about the current state of this action.

            '
          type: string
        lifecycleState:
          description: 'The current state of the rule.

            '
          enum:
          - CREATING
          - ACTIVE
          - INACTIVE
          - UPDATING
          - DELETING
          - DELETED
          - FAILED
          type: string
      required:
      - actionType
      - id
      - lifecycleState
      - lifecycleMessage
      type: object
      x-example: "{\n  \"actions\": [\n    {\n      \"actionType\": \"ONS\",\n      \"id\": \"ocid.action.oc1..<var>&lt;unique_ID&gt;</var>\",\n      \"lifecycleMessage\":null,\n      \"lifecycleState\": \"CREATING\"\n    }\n  ]\n}    \n"
    Error:
      description: Error details.
      properties:
        code:
          description: 'A short error code that defines the error, meant for programmatic parsing. See

            [API Errors](/iaas/Content/API/References/apierrors.htm).

            '
          type: string
        message:
          description: 'A human-readable error string.

   

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