3 title: TS 28.532 File data reporting Service
6 OAS 3.0.1 specification of the File data reporting Management Service © 2020,
7 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All
10 description: 3GPP TS 28.532 V16.5.0; Generic management services
11 url: 'http://www.3gpp.org/ftp/Specs/archive/28_series/28.532/'
13 - url: '{MnSRoot}/FileDataReportingMnS/{MnSversion}'
16 description: See subclause 4.4 of TS 32.158
17 default: http://example.com/3GPPManagement
19 description: Indicates the current version of the specification
24 summary: Read resources of information of available files
25 description: With HTTP GET, resources of information of available files are read. The resources to be read are identified with the path component (base resource) and the query component (fileaType, beginTime and endTime) of the URI. The fields query component allows to select the resource properties to be returned.
29 description: This parameter identifies the type of management data that the file contains to select the resources from the collection resources identified with the path component of the URI.
32 $ref: '#/components/schemas/fileType-Type'
35 description: This parameter identifies the time stamp no later than which the file became available to select the resources from the collection resources identified with the path component of the URI.
38 $ref: '#/components/schemas/dateTime-Type'
41 description: This parameter identifies the time stamp no earlier than which the file became available to select the resources from the collection resources identified with the path component of the URI.
44 $ref: '#/components/schemas/dateTime-Type'
47 description: 'Success case ("200 OK"). The resources identified in the request for retrieval are returned in the response message body. In case the fields query parameter is used, the selected resources are returned.'
51 $ref: '#/components/schemas/fileInfoRetrieval-ResponseType'
53 description: Error case.
57 $ref: '#/components/schemas/error-ResponseType'
60 summary: Create a subscription
61 description: To create a subscription the representation of the subscription is POSTed on the /subscriptions collection resource.
67 $ref: '#/components/schemas/subscription-RequestType'
70 description: Success case ("201 Created"). The representation of the newly created subscription resource shall be returned.
74 $ref: '#/components/schemas/subscription-ResponseType'
76 description: Error case.
80 $ref: '#/components/schemas/error-ResponseType'
83 '{request.body#/consumerReference}':
90 $ref: '#/components/schemas/notifyFileReady-NotifType'
93 description: Success case ("204 No Content"). The notification is successfully delivered. The response message body is absent.
95 description: Error case.
99 $ref: '#/components/schemas/error-ResponseType'
100 notifyFilePreparationError:
101 '{request.body#/consumerReference}':
108 $ref: '#/components/schemas/notifyFilePreparationError-NotifType'
111 description: Success case ("204 No Content"). The notification is successfully delivered. The response message body is absent.
113 description: Error case.
117 $ref: '#/components/schemas/error-ResponseType'
119 summary: Delete all subscriptions made with a specific consumerReferenceId
120 description: The subscriptions are deleted by deleting the corresponding subscription resources. The resources to be deleted are identified with the path component of the URI pointing to the /subscription collection resource and filtering on the consumerReferenceId provided in the query part.
122 - name: consumerReferenceId
124 description: Identifies the subscriptions to be deleted.
127 $ref: '#/components/schemas/consumerReferenceId-QueryType'
130 description: Success case ("204 No Content"). The subscription resources have been deleted. The response message body is absent.
132 description: Error case.
136 $ref: '#/components/schemas/error-ResponseType'
137 '/subscriptions/{subscriptionId}':
139 summary: Delete a single subscription
140 description: The subscription is deleted by deleting the corresponding subscription resource. The resource to be deleted is identified with the path component of the URI.
142 - name: subscriptionId
144 description: Identifies the subscription to be deleted.
147 $ref: '#/components/schemas/subscriptionId-PathType'
150 description: Success case ("204 No Content"). The subscription resource has been deleted. The response message body is absent.
152 description: Error case.
156 $ref: '#/components/schemas/error-ResponseType'
171 fileInfoRetrieval-ResponseType:
177 $ref: '#/components/schemas/fileInfo-Type'
182 $ref: '#/components/schemas/uri-Type'
184 $ref: '#/components/schemas/long-Type'
186 $ref: '#/components/schemas/dateTime-Type'
188 $ref: '#/components/schemas/dateTime-Type'
194 $ref: '#/components/schemas/fileType-Type'
211 description: Header used in notifications as notification header
215 $ref: '#/components/schemas/uri-Type'
217 $ref: '#/components/schemas/notificationId-Type'
219 $ref: '#/components/schemas/notificationType-Type'
221 $ref: '#/components/schemas/dateTime-Type'
222 subscriptionId-PathType:
227 $ref: '#/components/schemas/long-Type'
228 notificationType-Type:
232 - notifyFilePreparationError
233 subscription-ResourceType:
237 $ref: '#/components/schemas/uri-Type'
239 $ref: '#/components/schemas/long-Type'
241 $ref: '#/components/schemas/filter-Type'
242 subscription-RequestType:
246 $ref: '#/components/schemas/subscription-ResourceType'
247 subscription-ResponseType:
251 $ref: '#/components/schemas/subscription-ResourceType'
252 consumerReferenceId-QueryType:
253 $ref: '#/components/schemas/uri-Type'
254 notifyFileReady-NotifType:
258 $ref: '#/components/schemas/header-Type'
265 $ref: '#/components/schemas/fileInfo-Type'
267 $ref: '#/components/schemas/additionalText-Type'
268 notifyFilePreparationError-NotifType:
272 $ref: '#/components/schemas/header-Type'
279 $ref: '#/components/schemas/fileInfo-Type'
281 $ref: '#/components/schemas/reason-Type'
283 $ref: '#/components/schemas/additionalText-Type'