diff --git a/README.md b/README.md index f14810dbe94ad64e0424fd62b55408746b909f9f..8c010bbef656cfe488c08419253b3c51d5a15059 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,13 @@ -# OpenAPI Specification Files for 3GPP 5G Core Network (Release 18) +# {-DRAFT-} OpenAPI Specification Files for 3GPP 5G Core Network (Release 18) © 2024, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. -API version: **June 2024** +API version: **August 2024** Release status: **{- Frozen -}** Other releases: [Rel-19 (Open)](https://forge.3gpp.org/rep/all/5G_APIs/tree/REL-19), [Rel-17 (Frozen)](https://forge.3gpp.org/rep/all/5G_APIs/tree/REL-17), [Rel-16 (Frozen)](https://forge.3gpp.org/rep/all/5G_APIs/tree/REL-16), [Rel-15 (Frozen)](https://forge.3gpp.org/rep/all/5G_APIs/tree/REL-15) OpenAPI validation status: -[![pipeline status](https://forge.3gpp.org/rep/all/5G_APIs/badges/REL-18/pipeline.svg)](https://forge.3gpp.org/rep/all/5G_APIs/commits/REL-18) +[![pipeline status](https://forge.3gpp.org/rep/all/5G_APIs/badges/Rel18-draft-TSG105/pipeline.svg)](https://forge.3gpp.org/rep/all/5G_APIs/commits/Rel18-draft-TSG105) #### Tools * API Parser/Linter to parse OpenAPI files with APIDevTools Swagger Parser/Validator and run a number of lint rules to improve API quality @@ -1083,6 +1083,11 @@ These APIs are not part of the 5G Core Network; these APIs are exposed by the 4G ([Editor](https://forge.3gpp.org/swagger/tools/loader.html?yaml=TS26510_Maf_SessionHandling_ConsumptionReporting.yaml)) ([UI](https://forge.3gpp.org/swagger/tools/loader.html?action=ui&yaml=TS26510_Maf_SessionHandling_ConsumptionReporting.yaml)) +## Media AF ancillary network media session handling services +* Asynchronous notifications (MQTT notification channel) +([Editor](https://forge.3gpp.org/swagger/tools/loader.html?yaml=TS26510_Notifications.yaml)) +([UI](https://forge.3gpp.org/swagger/tools/loader.html?action=ui&yaml=TS26510_Notifications.yaml)) + # Real-Time media Communication (RTC) TS 26.113 diff --git a/TS26510_Maf_SessionHandling_ServiceAccessInformation.yaml b/TS26510_Maf_SessionHandling_ServiceAccessInformation.yaml index 265617f74e533c7215746ecedb7d822d3d10cb52..33345878e2477069e15add1f5650237a2ea2c3b0 100644 --- a/TS26510_Maf_SessionHandling_ServiceAccessInformation.yaml +++ b/TS26510_Maf_SessionHandling_ServiceAccessInformation.yaml @@ -331,30 +331,3 @@ components: type: string minLength: 1 minItems: 1 - - NotificationMessage: - description: 'A message sent by the Media AF on an MQTT notification channel.' - type: object - properties: - type: - $ref: '#/components/schemas/NotificationMessageType' - serviceAccessInformation: - $ref: '#/components/schemas/ServiceAccessInformationResource' - dynamicPolicy: - $ref: 'TS26510_Maf_SessionHandling_DynamicPolicy.yaml#/components/schemas/DynamicPolicy' - networkAssistanceSession: - $ref: 'TS26510_Maf_SessionHandling_NetworkAssistance.yaml#/components/schemas/NetworkAssistanceSession' - - NotificationMessageType: - description: 'Enumeration of notification message types.' - anyOf: - - type: string - enum: - - NOTIFICATION_SERVICE_ACCESS_INFORMATION - - NOTIFICATION_DYNAMIC_POLICY_INSTANCE - - NOTIFICATION_NETWORK_ASSISTANCE_SESSION - - type: string - description: > - This string provides forward-compatibility with future - extensions to the enumeration but is not used to encode - content defined in the present version of this API. diff --git a/TS26510_Notifications.yaml b/TS26510_Notifications.yaml new file mode 100755 index 0000000000000000000000000000000000000000..1d482622e9615132c5369961131b510b2751e2fa --- /dev/null +++ b/TS26510_Notifications.yaml @@ -0,0 +1,58 @@ +openapi: 3.0.0 +info: + title: 'Media Delivery: Notifications' + version: 1.0.0 + description: | + Media Delivery: Notifications + © 2024, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + All rights reserved. + +tags: + - name: 'Media Delivery: Notifications' + description: 'Media Delivery: Asynchronous MQTT notifications sent by the Media AF at reference points M3 and M5' + +externalDocs: + description: 'TS 26.510 V18.1.0; Media Delivery; Interactions and APIs for media session handling' + url: 'https://www.3gpp.org/ftp/Specs/archive/26_series/26.510/' + +paths: {} + +components: + schemas: + NotificationMessage: + description: 'A message sent by the Media AF on an MQTT notification channel.' + type: object + required: + - type + oneOf: + - required: [serviceAccessInformation] + - required: [dynamicPolicy] + - required: [networkAssistanceSession] + properties: + type: + $ref: '#/components/schemas/NotificationMessageType' + entityTag: + type: string + minLength: 1 + lastModified: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' + serviceAccessInformation: + $ref: 'TS26510_Maf_SessionHandling_ServiceAccessInformation.yaml#/components/schemas/ServiceAccessInformationResource' + dynamicPolicy: + $ref: 'TS26510_Maf_SessionHandling_DynamicPolicy.yaml#/components/schemas/DynamicPolicy' + networkAssistanceSession: + $ref: 'TS26510_Maf_SessionHandling_NetworkAssistance.yaml#/components/schemas/NetworkAssistanceSession' + + NotificationMessageType: + description: 'Enumeration of notification message types.' + anyOf: + - type: string + enum: + - NOTIFICATION_SERVICE_ACCESS_INFORMATION + - NOTIFICATION_DYNAMIC_POLICY_INSTANCE + - NOTIFICATION_NETWORK_ASSISTANCE_SESSION + - type: string + description: > + This string provides forward-compatibility with future + extensions to the enumeration but is not used to encode + content defined in the present version of this API.