summaryrefslogtreecommitdiff
path: root/doc/source/specification/reportersteps.rst
blob: e9e80b193092412b9dbdc606d4226f2b6e18b4fe (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
..
      Copyright 2014 IBM Corp.

      Licensed under the Apache License, Version 2.0 (the "License"); you may
      not use this file except in compliance with the License. You may obtain
      a copy of the License at

          http://www.apache.org/licenses/LICENSE-2.0

      Unless required by applicable law or agreed to in writing, software
      distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
      WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
      License for the specific language governing permissions and limitations
      under the License.

.. _reportersteps:

==============
 Reportersteps
==============

This type represents a step in the REPORTERCHAIN that captures information
about any notable REPORTER (in addition to the OBSERVER) that modified or
relayed the CADF Event Record and any details regarding any modification it
performed on the CADF Event Record it is contained within.

The Reporterstep data type should capture information about the resources that
have had a role in modifying, or relaying the CADF Event Record during its
lifecycle after having been created by the OBSERVER.

============ ================= ========= ==========================================================================================================================
Property     Type              Required  Description
============ ================= ========= ==========================================================================================================================
role         xs:string         Yes       The role the REPORTER performed on the CADF Event Record (e.g., an "observer", "modifier" or "relay" role)
reporter     cadf:Resource     Dependent This property defines the resource that acted as a REPORTER on a CADF Event Record. Required if not reporterId
reporterId   cadf:Identifier   Dependent This property identifies a resource that acted as a REPORTER on a CADF Event Record by reference. Required if not reporter
reporterTime cadf:Timestamp    No        The time a REPORTER adds its Reporterstep entry into the REPORTERCHAIN
attachments  cadf:Attachment[] No        An optional array of additional data containing information about the reporter or any action it performed
============ ================= ========= ==========================================================================================================================

Serialisation
=============

.. code-block:: javascript

    {
        "typeURI": "http://schemas.dmtf.org/cloud/audit/1.0/event",
        ...,
        "reporterchain": [
            {
                "role": "modifier",
                "reporterTime": "2012-03-22T13:00:00-04:00",
                "reporter": {
                    "id": "myscheme://mydomain/resource/monitor/id/0002"
                }
            },
            ...
        ]
    }