1<?xml version="1.0" encoding="UTF-8"?>
2<!---->
3<!--################################################################################       -->
4<!--# Redfish Schema:  LicenseService v1.1.1                                               -->
5<!--#                                                                                      -->
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-2023 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/RedfishExtensions_v1.xml">
21    <edmx:Include Namespace="RedfishExtensions.v1_0_0" Alias="Redfish"/>
22  </edmx:Reference>
23  <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/Resource_v1.xml">
24    <edmx:Include Namespace="Resource"/>
25    <edmx:Include Namespace="Resource.v1_0_0"/>
26  </edmx:Reference>
27  <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/LicenseCollection_v1.xml">
28    <edmx:Include Namespace="LicenseCollection"/>
29  </edmx:Reference>
30  <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/Manager_v1.xml">
31    <edmx:Include Namespace="Manager"/>
32  </edmx:Reference>
33
34  <edmx:DataServices>
35
36    <Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" Namespace="LicenseService">
37      <Annotation Term="Redfish.OwningEntity" String="DMTF"/>
38
39      <EntityType Name="LicenseService" BaseType="Resource.v1_0_0.Resource" Abstract="true">
40        <Annotation Term="OData.Description" String="The LicenseService schema describes the license service and the properties for the service itself with a link to the collection of licenses.  The license service also provides methods for installing licenses in a Redfish service."/>
41        <Annotation Term="OData.LongDescription" String="This resource shall represent a license service and the properties that affect the service itself for a Redfish implementation."/>
42        <Annotation Term="Capabilities.InsertRestrictions">
43          <Record>
44            <PropertyValue Property="Insertable" Bool="false"/>
45          </Record>
46        </Annotation>
47        <Annotation Term="Capabilities.UpdateRestrictions">
48          <Record>
49            <PropertyValue Property="Updatable" Bool="true"/>
50          </Record>
51        </Annotation>
52        <Annotation Term="Capabilities.DeleteRestrictions">
53          <Record>
54            <PropertyValue Property="Deletable" Bool="false"/>
55          </Record>
56        </Annotation>
57        <Annotation Term="Redfish.Uris">
58          <Collection>
59            <String>/redfish/v1/LicenseService</String>
60          </Collection>
61        </Annotation>
62      </EntityType>
63
64      <Action Name="Install" IsBound="true">
65        <Annotation Term="OData.Description" String="This action installs one or more licenses from a remote file."/>
66        <Annotation Term="OData.LongDescription" String="This action shall install one or more licenses from a remote file.  The service may update an existing License resource.  The `Location` header in the response shall contain the URI of the new or updated License resource."/>
67        <Parameter Name="LicenseService" Type="LicenseService.v1_0_0.Actions"/>
68        <Parameter Name="LicenseFileURI" Type="Edm.String" Nullable="false">
69          <Annotation Term="OData.Description" String="The URI of the license file to install."/>
70          <Annotation Term="OData.LongDescription" String="This parameter shall contain an RFC3986-defined URI that links to a file that the license service retrieves to install the license in that file.  This URI should contain a scheme that describes the transfer protocol.  If the TransferProtocol parameter is absent or not supported, and a transfer protocol is not specified by a scheme contained within this URI, the service shall use HTTP to get the file."/>
71          <Annotation Term="OData.IsURL"/>
72        </Parameter>
73        <Parameter Name="TransferProtocol" Type="LicenseService.v1_0_0.TransferProtocolType">
74          <Annotation Term="OData.Description" String="The network protocol that the license service uses to retrieve the license file located at the URI provided in LicenseFileURI.  This parameter is ignored if the URI provided in LicenseFileURI contains a scheme."/>
75          <Annotation Term="OData.LongDescription" String="This parameter shall contain the network protocol that the license service shall use to retrieve the license file located at the LicenseFileURI.  Services should ignore this parameter if the URI provided in LicenseFileURI contains a scheme.  If this parameter is not provided or supported, and if a transfer protocol is not specified by a scheme contained within this URI, the service shall use HTTP to retrieve the file."/>
76        </Parameter>
77        <Parameter Name="Username" Type="Edm.String">
78          <Annotation Term="OData.Description" String="The user name to access the URI specified by the LicenseFileURI parameter."/>
79          <Annotation Term="OData.LongDescription" String="This parameter shall represent the user name to access the URI specified by the LicenseFileURI parameter."/>
80        </Parameter>
81        <Parameter Name="Password" Type="Edm.String">
82          <Annotation Term="OData.Description" String="The password to access the URI specified by the LicenseFileURI parameter."/>
83          <Annotation Term="OData.LongDescription" String="This parameter shall represent the password to access the URI specified by the LicenseFileURI parameter."/>
84        </Parameter>
85        <Parameter Name="AuthorizedDevices" Type="Collection(Resource.Item)">
86          <Annotation Term="OData.Description" String="An array of links to the devices to be authorized by the license."/>
87          <Annotation Term="OData.LongDescription" String="This parameter shall contain an array of links to the devices to be authorized by the license.  Clients can provide this parameter when installing a license to apply the license to specific devices.  If not provided when installing a license, the service may determine the devices to which the license applies.  This parameter shall not be present if the AuthorizationScope property contains the value `Service`."/>
88          <Annotation Term="Redfish.Revisions">
89            <Collection>
90              <Record>
91                <PropertyValue Property="Kind" EnumMember="Redfish.RevisionKind/Added"/>
92                <PropertyValue Property="Version" String="v1_1_0"/>
93              </Record>
94            </Collection>
95          </Annotation>
96        </Parameter>
97        <Parameter Name="TargetServices" Type="Collection(Manager.Manager)">
98          <Annotation Term="OData.Description" String="An array of links to the managers where the license will be installed."/>
99          <Annotation Term="OData.LongDescription" String="This property shall contain an array of links to resources of type Manager that represent the services where the license will be installed, such as remote Redfish services.  This parameter shall only be present in aggregators when the AuthorizationScope property contains `Service` or `Capacity`."/>
100          <Annotation Term="Redfish.Revisions">
101            <Collection>
102              <Record>
103                <PropertyValue Property="Kind" EnumMember="Redfish.RevisionKind/Added"/>
104                <PropertyValue Property="Version" String="v1_1_0"/>
105              </Record>
106            </Collection>
107          </Annotation>
108        </Parameter>
109      </Action>
110    </Schema>
111
112    <Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" Namespace="LicenseService.v1_0_0">
113      <Annotation Term="Redfish.OwningEntity" String="DMTF"/>
114      <Annotation Term="Redfish.Release" String="2021.3"/>
115
116      <EntityType Name="LicenseService" BaseType="LicenseService.LicenseService">
117        <Property Name="ServiceEnabled" Type="Edm.Boolean">
118          <Annotation Term="OData.Permissions" EnumMember="OData.Permission/ReadWrite"/>
119          <Annotation Term="OData.Description" String="An indication of whether this service is enabled."/>
120          <Annotation Term="OData.LongDescription" String="This property shall indicate whether this service is enabled."/>
121        </Property>
122        <Property Name="LicenseExpirationWarningDays" Type="Edm.Int64">
123          <Annotation Term="OData.Permissions" EnumMember="OData.Permission/ReadWrite"/>
124          <Annotation Term="OData.Description" String="The number of days prior to a license expiration that a warning message is sent.  A value of zero indicates no warning message is sent."/>
125          <Annotation Term="OData.LongDescription" String="This property shall contain the number of days prior to a license expiration that the service shall send the `DaysBeforeExpiration` message from the License Message Registry at least once.  A value of zero shall indicate that no warning messages are sent prior to license expiration."/>
126        </Property>
127        <Property Name="Actions" Type="LicenseService.v1_0_0.Actions" Nullable="false">
128          <Annotation Term="OData.Description" String="The available actions for this resource."/>
129          <Annotation Term="OData.LongDescription" String="This property shall contain the available actions for this resource."/>
130        </Property>
131        <NavigationProperty Name="Licenses" Type="LicenseCollection.LicenseCollection">
132          <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
133          <Annotation Term="OData.Description" String="The link to the collection of licenses."/>
134          <Annotation Term="OData.LongDescription" String="This property shall contain a link to a resource collection of type LicenseCollection.  When installing a license with a POST operation to this collection, the service may update an existing License resource instead of creating a new resource.  In these cases, the service shall respond with the HTTP `200 OK` status code or HTTP `204 No Content` status code and the `Location` header in the response shall contain the URI of the updated License resource."/>
135          <Annotation Term="OData.AutoExpandReferences"/>
136        </NavigationProperty>
137      </EntityType>
138
139      <ComplexType Name="Actions">
140        <Annotation Term="OData.AdditionalProperties" Bool="false"/>
141        <Annotation Term="OData.Description" String="The available actions for this resource."/>
142        <Annotation Term="OData.LongDescription" String="This type shall contain the available actions for this resource."/>
143        <Property Name="Oem" Type="LicenseService.v1_0_0.OemActions" Nullable="false">
144          <Annotation Term="OData.Description" String="The available OEM-specific actions for this resource."/>
145          <Annotation Term="OData.LongDescription" String="This property shall contain the available OEM-specific actions for this resource."/>
146        </Property>
147      </ComplexType>
148
149      <ComplexType Name="OemActions">
150        <Annotation Term="OData.AdditionalProperties" Bool="true"/>
151        <Annotation Term="OData.Description" String="The available OEM-specific actions for this resource."/>
152        <Annotation Term="OData.LongDescription" String="This type shall contain the available OEM-specific actions for this resource."/>
153      </ComplexType>
154
155      <EnumType Name="TransferProtocolType">
156        <Member Name="CIFS">
157          <Annotation Term="OData.Description" String="Common Internet File System (CIFS)."/>
158        </Member>
159        <Member Name="FTP">
160          <Annotation Term="OData.Description" String="File Transfer Protocol (FTP)."/>
161        </Member>
162        <Member Name="SFTP">
163          <Annotation Term="OData.Description" String="Secure File Transfer Protocol (SFTP)."/>
164        </Member>
165        <Member Name="HTTP">
166          <Annotation Term="OData.Description" String="Hypertext Transfer Protocol (HTTP)."/>
167        </Member>
168        <Member Name="HTTPS">
169          <Annotation Term="OData.Description" String="Hypertext Transfer Protocol Secure (HTTPS)."/>
170        </Member>
171        <Member Name="SCP">
172          <Annotation Term="OData.Description" String="Secure Copy Protocol (SCP)."/>
173        </Member>
174        <Member Name="TFTP">
175          <Annotation Term="OData.Description" String="Trivial File Transfer Protocol (TFTP)."/>
176        </Member>
177        <Member Name="OEM">
178          <Annotation Term="OData.Description" String="A manufacturer-defined protocol."/>
179        </Member>
180        <Member Name="NFS">
181          <Annotation Term="OData.Description" String="Network File System (NFS)."/>
182        </Member>
183      </EnumType>
184    </Schema>
185
186    <Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" Namespace="LicenseService.v1_0_1">
187      <Annotation Term="Redfish.OwningEntity" String="DMTF"/>
188      <Annotation Term="OData.Description" String="This version was created to correct various typographical errors."/>
189      <EntityType Name="LicenseService" BaseType="LicenseService.v1_0_0.LicenseService"/>
190    </Schema>
191
192    <Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" Namespace="LicenseService.v1_1_0">
193      <Annotation Term="Redfish.OwningEntity" String="DMTF"/>
194      <Annotation Term="Redfish.Release" String="2022.3"/>
195      <Annotation Term="OData.Description" String="This version was created to add the AuthorizedDevices and TargetServices parameters to the Install action."/>
196
197      <EntityType Name="LicenseService" BaseType="LicenseService.v1_0_0.LicenseService"/>
198    </Schema>
199
200    <Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" Namespace="LicenseService.v1_1_1">
201      <Annotation Term="Redfish.OwningEntity" String="DMTF"/>
202      <Annotation Term="OData.Description" String="This version was created to correct various typographical errors."/>
203      <EntityType Name="LicenseService" BaseType="LicenseService.v1_1_0.LicenseService"/>
204    </Schema>
205
206  </edmx:DataServices>
207</edmx:Edmx>
208