Lists categories across multiple datasets

cloudforce_one.threat_events.categories.list() -> CategoryListResponse

GET/accounts/{account_id}/cloudforce-one/events/categories

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

Accepted Permissions (at least one required)

Cloudforce One WriteCloudforce One Read

ParametersExpand Collapse

account_id: str

Account ID.

dataset_ids: Optional[SequenceNotStr[str]]

Array of dataset IDs to query categories from. If not provided, uses the default dataset.

ReturnsExpand Collapse

List[CategoryListResponseItem]

kill_chain: float

name: str

uuid: str

mitre_attack: Optional[List[str]]

mitre_capec: Optional[List[str]]

shortname: Optional[str]

Lists categories across multiple datasets

import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
categories = client.cloudforce_one.threat_events.categories.list(
    account_id="account_id",
)
print(categories)

[
  {
    "killChain": 0,
    "name": "name",
    "uuid": "12345678-1234-1234-1234-1234567890ab",
    "mitreAttack": [
      "T1234"
    ],
    "mitreCapec": [
      "123"
    ],
    "shortname": "shortname"
  }
]

Returns Examples

[
  {
    "killChain": 0,
    "name": "name",
    "uuid": "12345678-1234-1234-1234-1234567890ab",
    "mitreAttack": [
      "T1234"
    ],
    "mitreCapec": [
      "123"
    ],
    "shortname": "shortname"
  }
]