CreateFilterGroupDetails

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/oracle/main/json-schema/oracle-create-filter-group-details-schema.json",
  "title": "CreateFilterGroupDetails",
  "description": "The details for creating a new filter group for an announcement subscription.",
  "x-generated": "2026-10-03",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/oracle-announcementsubscription-api-openapi.yml#/components/schemas/CreateFilterGroupDetails",
  "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": "#/$defs/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",
  "$defs": {
    "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"
    }
  }
}