From 78d8ac7e740df24116d46fabd5449ae55f44b54d Mon Sep 17 00:00:00 2001 From: Richard Bradbury Date: Mon, 29 Jul 2024 16:21:35 +0100 Subject: [PATCH] TS 26.510 Rel-18 CR0001 [S4-241390] Cache control metadata in MQTT notification message. --- README.md | 11 +++- ...sionHandling_ServiceAccessInformation.yaml | 27 --------- TS26510_Notifications.yaml | 58 +++++++++++++++++++ 3 files changed, 66 insertions(+), 30 deletions(-) create mode 100755 TS26510_Notifications.yaml diff --git a/README.md b/README.md index f14810d..8c010bb 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 265617f..3334587 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 0000000..1d48262 --- /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. -- GitLab