Block List Event

Properties

• id (integer): Unique event identifier.

• timestamp (string, format: date-time)

  Examples:

  "2018-11-13T20:20:39+00:00"

• user (['string', 'null'], format: uri-reference): Optional resource of user who triggered the event.

  Examples:

  "/users/123"

• event_type (string): Must be one of: ["block-list"].

• event (string): Must be one of: ["create", "update", "delete"].

• parent_zone (string, format: uri-reference)

  Examples:

  "/zones/123"

• revision_resource (string, format: uri-reference): Zone configuration revision where these changes were made.

  Examples:

  "/zones/123/revisions/7"

• global: Set if this is the default zone Global list.

• changes (object)

  • created (array): List entries added.
    • Items: Refer to entry.
  • deleted (array): List entries removed.
    • Items: Refer to entry.
  • updated (object)
    • new: Refer to entry.
    • old: Refer to entry.

Definitions

• entry (object): List entry. Exactly one of prefix/asn/cc will be included.
  • One of
    • : prefix.
    • : asn.
    • : cc.
  • resource (string, format: uri-reference, required)
  • prefix (string)
  • asn (integer): Autonomous System Number.
  • cc (string): ISO-3166 Alpha-2 country identifier.
  • excepted: Set if this is a block list exception entry.
  • expiry_time (string, format: date-time): Set if this entry has an expiry time.
  • description (string)

Examples

{
    "id": 1,
    "timestamp": "2018-11-13T20:20:39+00:00",
    "user": "/users/100",
    "event_type": "block-list",
    "event": "create",
    "parent_zone": "/zones/1012",
    "revision_resource": "/zones/1012/revisions/1",
    "changes": {
        "created": [
            {
                "resource": "/block_lists/1",
                "prefix": "192.0.2.0/31",
                "excepted": true,
                "description": " some prefix"
            },
            {
                "resource": "/block_lists/20",
                "asn": 65536,
                "expiry_time": "2024-03-26T20:22:02Z",
                "description": "some ASN"
            },
            {
                "resource": "/block_lists/21",
                "cc": "XX",
                "expiry_time": "2024-03-26T20:22:02Z",
                "description": "some Country"
            }
        ]
    }
}