blob: 11a039e1c9633b9def99d48e302589cef6d2c846 [file] [log] [blame]
Ed Tanous530520e2019-01-02 13:41:37 -08001<?xml version="1.0" encoding="UTF-8"?>
2<!---->
3<!--################################################################################ -->
Marri Devender Raod45d2d02019-01-21 10:11:34 -06004<!--# Redfish Schema: TelemetryService v1.1.0-->
Ed Tanous530520e2019-01-02 13:41:37 -08005<!--# -->
6<!--# For a detailed change log, see the README file contained in the DSP8010 bundle, -->
7<!--# available at http://www.dmtf.org/standards/redfish -->
8<!--# Copyright 2014-2018 DMTF. -->
9<!--# For the full DMTF copyright policy, see http://www.dmtf.org/about/policies/copyright -->
10<!--################################################################################ -->
11<!---->
12<edmx:Edmx xmlns:edmx="http://docs.oasis-open.org/odata/ns/edmx" Version="4.0">
13
14 <edmx:Reference Uri="http://docs.oasis-open.org/odata/odata/v4.0/errata03/csd01/complete/vocabularies/Org.OData.Core.V1.xml">
15 <edmx:Include Namespace="Org.OData.Core.V1" Alias="OData"/>
16 </edmx:Reference>
17 <edmx:Reference Uri="http://docs.oasis-open.org/odata/odata/v4.0/errata03/csd01/complete/vocabularies/Org.OData.Capabilities.V1.xml">
18 <edmx:Include Namespace="Org.OData.Capabilities.V1" Alias="Capabilities"/>
19 </edmx:Reference>
20 <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/Resource_v1.xml">
21 <edmx:Include Namespace="Resource"/>
22 <edmx:Include Namespace="Resource.v1_0_0"/>
23 </edmx:Reference>
24 <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/RedfishExtensions_v1.xml">
25 <edmx:Include Namespace="RedfishExtensions.v1_0_0" Alias="Redfish"/>
26 </edmx:Reference>
27 <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/MetricDefinitionCollection_v1.xml">
28 <edmx:Include Namespace="MetricDefinitionCollection"/>
29 </edmx:Reference>
30 <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/MetricReportDefinitionCollection_v1.xml">
31 <edmx:Include Namespace="MetricReportDefinitionCollection"/>
32 </edmx:Reference>
33 <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/MetricReportCollection_v1.xml">
34 <edmx:Include Namespace="MetricReportCollection"/>
35 </edmx:Reference>
36 <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/TriggersCollection_v1.xml">
37 <edmx:Include Namespace="TriggersCollection"/>
38 </edmx:Reference>
39 <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/LogService_v1.xml">
40 <edmx:Include Namespace="LogService"/>
41 </edmx:Reference>
Marri Devender Raod45d2d02019-01-21 10:11:34 -060042 <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/MetricDefinition_v1.xml">
43 <edmx:Include Namespace="MetricDefinition"/>
44 </edmx:Reference>
Ed Tanous530520e2019-01-02 13:41:37 -080045
46 <edmx:DataServices>
47
48 <Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" Namespace="TelemetryService">
49 <Annotation Term="Redfish.OwningEntity" String="DMTF"/>
50
51 <EntityType Name="TelemetryService" BaseType="Resource.v1_0_0.Resource" Abstract="true">
52 <Annotation Term="OData.Description" String="This is the schema definition for the Metrics Service."/>
53 <Annotation Term="OData.LongDescription" String="This resource shall be used to represent a Metrics Service for a Redfish implementation."/>
54 <Annotation Term="Capabilities.InsertRestrictions">
55 <Record>
56 <PropertyValue Property="Insertable" Bool="false"/>
57 </Record>
58 </Annotation>
59 <Annotation Term="Capabilities.UpdateRestrictions">
60 <Record>
61 <PropertyValue Property="Updatable" Bool="true"/>
62 <Annotation Term="OData.Description" String="The Metrics Service can be updated to change properties such as ServiceEnabled."/>
63 </Record>
64 </Annotation>
65 <Annotation Term="Capabilities.DeleteRestrictions">
66 <Record>
67 <PropertyValue Property="Deletable" Bool="false"/>
68 </Record>
69 </Annotation>
70 <Annotation Term="Redfish.Uris">
71 <Collection>
72 <String>/redfish/v1/TelemetryService</String>
73 </Collection>
74 </Annotation>
75 </EntityType>
76
77 <Action Name="SubmitTestMetricReport" IsBound="true">
78 <Annotation Term="OData.Description" String="This action is used to generate a metric report."/>
79 <Annotation Term="OData.LongDescription" String="This action shall cause the event service to immediately generate the metric report, as an Alert Event. This message should then be sent to any appropriate ListenerDestination targets."/>
80 <Parameter Name="TelemetryService" Type="TelemetryService.v1_0_0.Actions"/>
81 <Parameter Name="MetricReportName" Type="Edm.String" Nullable="false">
82 <Annotation Term="OData.Description" String="The Name property of the metric report in generated metric report."/>
83 <Annotation Term="OData.LongDescription" String="This parameter shall be the value of the Name property in the generated metric report."/>
84 </Parameter>
Marri Devender Raod45d2d02019-01-21 10:11:34 -060085 <Parameter Name="MetricReportValues" Type="Edm.String">
Ed Tanous530520e2019-01-02 13:41:37 -080086 <Annotation Term="OData.Description" String="The content of MetricReportValues array in generated metric report."/>
87 <Annotation Term="OData.LongDescription" String="This parameter shall contain the contents of the MetricReportValues array property in the generated metric report."/>
Marri Devender Raod45d2d02019-01-21 10:11:34 -060088 <Annotation Term="Redfish.Revisions">
89 <Collection>
90 <Record>
91 <PropertyValue Property="Kind" EnumMember="Redfish.RevisionKind/Deprecated"/>
92 <PropertyValue Property="Version" String="v1_1_0"/>
93 <PropertyValue Property="Description" String="This property has been Deprecated in favor of using the property 'GeneratedMetricReportValues'."/>
94 </Record>
95 </Collection>
96 </Annotation>
97 </Parameter>
98 <Parameter Name="GeneratedMetricReportValues" Type="Collection(TelemetryService.v1_1_0.MetricValue)" Nullable="false">
99 <Annotation Term="OData.Description" String="The content of the MetricReportValues in the generated metric report."/>
100 <Annotation Term="OData.LongDescription" String="This parameter shall contain the contents of the MetricReportValues array property in the generated metric report."/>
101 <Annotation Term="Redfish.Revisions">
102 <Collection>
103 <Record>
104 <PropertyValue Property="Kind" EnumMember="Redfish.RevisionKind/Added"/>
105 <PropertyValue Property="Version" String="v1_1_0"/>
106 <PropertyValue Property="Description" String="This property has been Deprecated in favor of using the property 'GeneratedMetricReportValues'."/>
107 </Record>
108 </Collection>
109 </Annotation>
Ed Tanous530520e2019-01-02 13:41:37 -0800110 </Parameter>
111 </Action>
112 </Schema>
113
114 <Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" Namespace="TelemetryService.v1_0_0">
115 <Annotation Term="Redfish.OwningEntity" String="DMTF"/>
Marri Devender Raod45d2d02019-01-21 10:11:34 -0600116 <Annotation Term="Redfish.Release" String="2018.2"/>
Ed Tanous530520e2019-01-02 13:41:37 -0800117
118 <EntityType Name="TelemetryService" BaseType="TelemetryService.TelemetryService">
119 <Annotation Term="OData.Description" String="This is the schema definition for the Metrics Service. It represents the properties for the service itself and has links to collections of metric definitions and metric report definitions."/>
120 <Annotation Term="OData.LongDescription" String="This resource shall be used to represent an Metrics Service for a Redfish implementation. It represents the properties that affect the service itself."/>
121 <Property Name="Status" Type="Resource.Status" Nullable="false">
122 <Annotation Term="OData.Description" String="This property describes the status and health of the resource and its children."/>
123 <Annotation Term="OData.LongDescription" String="This property shall contain any status or health properties of the resource."/>
124 </Property>
125 <Property Name="MaxReports" Type="Edm.Int64">
126 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
127 <Annotation Term="OData.Description" String="The maximum number of metric reports supported by this service."/>
128 <Annotation Term="OData.LongDescription" String="The value shall be the maximum number of metric reports supported by this service."/>
129 </Property>
130 <Property Name="MinCollectionInterval" Type="Edm.Duration">
131 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
132 <Annotation Term="OData.Description" String="The minimum time interval between collections supported by this service."/>
133 <Annotation Term="OData.LongDescription" String="The value shall be the minimum time interval between collections supported by this service. The value shall conform to the Duration format."/>
134 </Property>
135 <Property Name="SupportedCollectionFunctions" Type="Collection(TelemetryService.v1_0_0.CollectionFunction)">
136 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/ReadWrite"/>
137 <Annotation Term="OData.Description" String="The functions that can be performed over each metric."/>
138 <Annotation Term="OData.LongDescription" String="The value shall define the function to apply over the collection duration."/>
139 </Property>
140
141 <NavigationProperty Name="MetricDefinitions" Type="MetricDefinitionCollection.MetricDefinitionCollection" ContainsTarget="true" Nullable="false">
142 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
143 <Annotation Term="OData.Description" String="A link to the collection of Metric Definitions."/>
144 <Annotation Term="OData.LongDescription" String="The entries of shall be resources of type MetricDefinitionCollection."/>
145 <Annotation Term="OData.AutoExpandReferences"/>
146 </NavigationProperty>
147 <NavigationProperty Name="MetricReportDefinitions" Type="MetricReportDefinitionCollection.MetricReportDefinitionCollection" ContainsTarget="true" Nullable="false">
148 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
149 <Annotation Term="OData.Description" String="A link to the collection of Metric Report Definitions."/>
150 <Annotation Term="OData.LongDescription" String="The value shall be a link to a resource of type MetricReportDefinitionCollection."/>
151 <Annotation Term="OData.AutoExpandReferences"/>
152 </NavigationProperty>
153 <NavigationProperty Name="MetricReports" Type="MetricReportCollection.MetricReportCollection" ContainsTarget="true" Nullable="false">
154 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
155 <Annotation Term="OData.Description" String="A link to the collection of Metric Reports."/>
156 <Annotation Term="OData.LongDescription" String="The value shall be a link to a resource of type MetricReportCollection."/>
157 <Annotation Term="OData.AutoExpandReferences"/>
158 </NavigationProperty>
159 <NavigationProperty Name="Triggers" Type="TriggersCollection.TriggersCollection" ContainsTarget="true" Nullable="false">
160 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
161 <Annotation Term="OData.Description" String="A link to the collection of Triggers, which apply to metrics."/>
162 <Annotation Term="OData.LongDescription" String="The value shall be a link to a resource of type TriggersCollection."/>
163 <Annotation Term="OData.AutoExpandReferences"/>
164 </NavigationProperty>
165 <NavigationProperty Name="LogService" Type="LogService.LogService" ContainsTarget="true" Nullable="false">
166 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
167 <Annotation Term="OData.Description" String="This is a reference to a Log Service used by the Telemetry Service."/>
168 <Annotation Term="OData.LongDescription" String="The value of this property shall contain a reference to a LogService for the use by this Telemetry Service."/>
169 <Annotation Term="OData.AutoExpandReferences"/>
170 </NavigationProperty>
171 <Property Name="Actions" Type="TelemetryService.v1_0_0.Actions" Nullable="false">
172 <Annotation Term="OData.Description" String="The available actions for this resource."/>
173 <Annotation Term="OData.LongDescription" String="The Actions property shall contain the available actions for this resource."/>
174 </Property>
175 </EntityType>
176
177 <EnumType Name="CollectionFunction">
178 <Annotation Term="OData.Description" String="An operation to perform over the sample."/>
179 <Annotation Term="OData.LongDescription" String="If present, the metric value shall be computed according to this function."/>
180 <Member Name="Average">
181 <Annotation Term="OData.Description" String="An averaging function."/>
182 </Member>
183 <Member Name="Maximum">
184 <Annotation Term="OData.Description" String="A maximum function."/>
185 </Member>
186 <Member Name="Minimum">
187 <Annotation Term="OData.Description" String="A minimum function."/>
188 </Member>
189 <Member Name="Summation">
190 <Annotation Term="OData.Description" String="A summation function."/>
191 </Member>
192 </EnumType>
193
194 <ComplexType Name="Actions">
195 <Annotation Term="OData.AdditionalProperties" Bool="false"/>
196 <Annotation Term="OData.Description" String="The available actions for this resource."/>
197 <Annotation Term="OData.LongDescription" String="This type shall contain the available actions for this resource."/>
198 <Property Name="Oem" Type="TelemetryService.v1_0_0.OemActions" Nullable="false">
199 <Annotation Term="OData.Description" String="This property contains the available OEM specific actions for this resource."/>
200 <Annotation Term="OData.LongDescription" String="This property shall contain any additional OEM actions for this resource."/>
201 </Property>
202 </ComplexType>
203
204 <ComplexType Name="OemActions">
205 <Annotation Term="OData.AdditionalProperties" Bool="true"/>
206 <Annotation Term="OData.Description" String="The available OEM specific actions for this resource."/>
207 <Annotation Term="OData.LongDescription" String="This type shall contain any additional OEM actions for this resource."/>
208 </ComplexType>
209 </Schema>
210
Marri Devender Raod45d2d02019-01-21 10:11:34 -0600211 <Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" Namespace="TelemetryService.v1_1_0">
212 <Annotation Term="OData.Description" String="This version was created to add the GeneratedMetricReportValues property to the SubmittestMetricReport action."/>
213 <Annotation Term="Redfish.OwningEntity" String="DMTF"/>
214 <Annotation Term="Redfish.Release" String="2018.3"/>
215 <EntityType Name="TelemetryService" BaseType="TelemetryService.v1_0_0.TelemetryService"/>
216
217 <ComplexType Name="MetricValue">
218 <Annotation Term="OData.AdditionalProperties" Bool="false"/>
219 <Annotation Term="OData.Description" String="A metric value."/>
220 <Annotation Term="OData.LongDescription" String="A metric value in the context of a Metric."/>
221 <Property Name="MetricId" Type="Edm.String">
222 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
223 <Annotation Term="OData.Description" String="The metric definitions identifier for this metric."/>
224 <Annotation Term="OData.LongDescription" String="The value shall be the same as the Id property of the source metric within the associated MetricDefinition."/>
225 </Property>
226 <Property Name="MetricValue" Type="Edm.String">
227 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
228 <Annotation Term="OData.Description" String="The value identifies this resource."/>
229 <Annotation Term="OData.LongDescription" String="The value of the metric represented as a string."/>
230 </Property>
231 <Property Name="Timestamp" Type="Edm.DateTimeOffset">
232 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
233 <Annotation Term="OData.Description" String="The time when the value of the metric is obtained. A management application may establish a time series of metric data by retrieving the instances of metric value and sorting them according to their Timestamp."/>
234 <Annotation Term="OData.LongDescription" String="The value shall time when the metric value was obtained. Note that this may be different from the time when this instance is created."/>
235 </Property>
236 <Property Name="MetricProperty" Type="Edm.String">
237 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
238 <Annotation Term="OData.Description" String="The URI for the property from which this metric is derived."/>
239 <Annotation Term="OData.LongDescription" String="The value shall be URI to the a property following the JSON fragment notation, as defined by RFC6901, to identify an individual property in a Redfish resource."/>
240 <Annotation Term="OData.IsURL"/>
241 </Property>
242 <NavigationProperty Name="MetricDefinition" Type="MetricDefinition.MetricDefinition" Nullable="false">
243 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
244 <Annotation Term="OData.Description" String="A link to the Metric Definition."/>
245 <Annotation Term="OData.LongDescription" String="The value shall be reference to the Metric Definition resource that describes what this Metric Report is capturing."/>
246 <Annotation Term="OData.AutoExpandReferences"/>
247 </NavigationProperty>
248 </ComplexType>
249 </Schema>
250
Ed Tanous530520e2019-01-02 13:41:37 -0800251 </edmx:DataServices>
252</edmx:Edmx>