Rel-17 Sept'22

Author: jdegre

TS24558_Eecs_ServiceProvisioning.yaml

@@ -1,14 +1,14 @@
 openapi: 3.0.0
 info:
   title: Eecs_ServiceProvisioning
-  version: "1.0.0"
+  version: "1.0.1"
   description: |
     API for ECS Service Provisioning.
     © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
     All rights reserved.
 
 externalDocs:
-  description: 3GPP TS 24.558 V17.0.0 Enabling Edge Applications; Protocol specification.
+  description: 3GPP TS 24.558 V17.1.0 Enabling Edge Applications; Protocol specification.
   url: https://www.3gpp.org/ftp/Specs/archive/24_series/24.558/
 
 security:
@@ -460,7 +460,7 @@ components:
           type: array
           items:
             type: string
-          description: Identities of the Edge Application Servers registered with the EES.
+          description: Application identities of the Edge Application Servers registered with the EES.
         ecspInfo:
           type: string
           description: Represents an ECSP Information.

TS24558_Eees_ACREvents.yaml

@@ -1,14 +1,14 @@
 openapi: 3.0.0
 info:
   title: Eees_ACREvents
-  version: "1.0.0"
+  version: "1.0.1"
   description: |
     API for ACR events subscription and notification.
     © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
     All rights reserved.
 externalDocs:
   description: >
-    3GPP TS 24.558 V17.0.0 Enabling Edge Applications; Protocol specification.
+    3GPP TS 24.558 V17.1.0 Enabling Edge Applications; Protocol specification.
   url: 'https://www.3gpp.org/ftp/Specs/archive/24_series/24.558/'
 
 security:
@@ -286,7 +286,12 @@ components:
           items:
             type: string
           minItems: 1
-          description: The list of identifier of the EASs.
+          description: The list of application identifiers of the EASs.
+        acIds:
+          type: array
+          items:
+            type: string
+          description: List of AC identities
         eventIds:
           $ref: '#/components/schemas/ACREventIDs'
         notificationDestination:
@@ -316,14 +321,16 @@ components:
             Information notification is delivered.
         easId:
           type: string
-          description: Identifier of the EAS.
+          description: Application identifier of the EAS.
+        acId:
+          type: string
+          description: Identity of the AC.
         eventId:
           $ref: '#/components/schemas/ACREventIDs'
         trgtInfo:
           $ref: '#/components/schemas/TargetInfo'
-        acrRes:
-          type: boolean
-          description: Indicates whether the ACR is successful or failure.
+        acrStatus:
+          $ref: '#/components/schemas/ACRCompleteEventInfo'
         failReason :
           type: string
           description: Indicates the cause information for the failure.
@@ -353,7 +360,7 @@ components:
           items:
             type: string
           minItems: 1
-          description: The list of identifier of the EASs.
+          description: The list of application identifiers of the EASs.
         eventIds:
           $ref: '#/components/schemas/ACREventIDs'
         notificationDestination:
@@ -379,3 +386,15 @@ components:
       properties:
         implReg:
           $ref: 'TS29558_Eees_EECContextRelocation.yaml#/components/schemas/ImplicitRegDetails'
+    ACRCompleteEventInfo:
+      description: Indicates the completed ACR result and target EAS endpoint info.
+      type: object
+      properties:
+        acrRes:
+          type: boolean
+          description: Indicates whether the ACR is successful or failure.
+        tEasEndpoint:
+          $ref: 'TS29558_Eees_EASRegistration.yaml#/components/schemas/EndPoint'
+      required:
+        - acrRes
+        - tEasEndpoint

TS24558_Eees_EASDiscovery.yaml

@@ -5,10 +5,10 @@ info:
     API for EAS Discovery.
     © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
     All rights reserved.
-  version: "1.0.0"
+  version: "1.0.1"
 externalDocs:
   description: >
-    3GPP TS 24.558 V17.0.0 Enabling Edge Applications; Protocol specification.
+    3GPP TS 24.558 V17.1.0 Enabling Edge Applications; Protocol specification.
   url: https://www.3gpp.org/ftp/Specs/archive/24_series/24.558/
 
 security:
@@ -422,7 +422,7 @@ components:
       properties:
         easId:
           type: string
-          description: EAS identifier.
+          description: EAS application identifier.
         easProvId:
           type: string
           description: EAS provider identifier.
@@ -451,16 +451,12 @@ components:
       description: Represents an EAS discovery information.
       type: object
       properties:
-        eass:
-          type: array
-          items:
-            $ref: 'TS29558_Eees_EASRegistration.yaml#/components/schemas/EASProfile'
-          minItems: 1
-          description: Contains the list of EAS matching the discovery request filters
+        eas:
+          $ref: 'TS29558_Eees_EASRegistration.yaml#/components/schemas/EASProfile'
         lifeTime:
           $ref: 'TS29122_CommonData.yaml#/components/schemas/DateTime'
       required:
-        - eass
+        - eas
     EasDynamicInfoFilter:
       description: Represents EAS dynamic information changes filter.
       type: object

TS24558_Eees_EECRegistration.yaml

@@ -1,14 +1,14 @@
 openapi: 3.0.0
 info:
   title: Eees_EECRegistration
-  version: "1.0.0"
+  version: "1.0.1"
   description: |
     API for EEC registration.
     © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
     All rights reserved.
 externalDocs:
   description: >
-    3GPP TS 24.558 V17.0.0 Enabling Edge Applications; Protocol specification.
+    3GPP TS 24.558 V17.1.0 Enabling Edge Applications; Protocol specification.
   url: 'https://www.3gpp.org/ftp/Specs/archive/24_series/24.558/'
 
 security:
@@ -286,7 +286,7 @@ components:
       properties:  
         easId:
           type: string
-          description: Identifier of the EAS.          
+          description: Application identifier of the EAS.          
         expectedSvcKPIs:  
           $ref: '#/components/schemas/ACServiceKPIs'
         minimumReqSvcKPIs:  

TS26512_CommonData.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.0
 info:
   title: 5GMS Common Data Types
-  version: 1.1.0
+  version: 2.0.0
   description: |
     5GMS Common Data Types
     © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
@@ -10,7 +10,7 @@ tags:
   - name: 5GMS Common Data Types
     description: '5G Media Streaming: Common Data Types'
 externalDocs:
-  description: 'TS 26.512 V17.1.0; 5G Media Streaming (5GMS); Protocols'
+  description: 'TS 26.512 V17.2.0; 5G Media Streaming (5GMS); Protocols'
   url: 'https://www.3gpp.org/ftp/Specs/archive/26_series/26.512/'
 paths: {}
 components:

TS26512_M1_ConsumptionReportingProvisioning.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.0
 info:
   title: M1_ConsumptionReportingProvisioning
-  version: 1.1.0
+  version: 2.0.0
   description: |
     5GMS AF M1 Consumption Reporting Provisioning API
     © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
@@ -10,7 +10,7 @@ tags:
   - name: M1_ConsumptionReportingProvisioning
     description: '5G Media Streaming: Provisioning (M1) APIs: Consumption Reporting Provisioning'
 externalDocs:
-  description: 'TS 26.512 V17.1.0; 5G Media Streaming (5GMS); Protocols'
+  description: 'TS 26.512 V17.2.0; 5G Media Streaming (5GMS); Protocols'
   url: 'https://www.3gpp.org/ftp/Specs/archive/26_series/26.512/'
 servers:
   - url: '{apiRoot}/3gpp-m1/v2'
@@ -105,6 +105,7 @@ components:
   schemas:
     ConsumptionReportingConfiguration:
       type: object
+      description: "A representation of a Consumption Reporting Configuration resource."
       properties:
         reportingInterval:
           $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec'

TS26512_M1_ContentHostingProvisioning.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.0
 info:
   title: M1_ContentHostingProvisioning
-  version: 1.1.0
+  version: 2.0.0
   description: |
     5GMS AF M1 Content Hosting Provisioning API
     © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
@@ -10,7 +10,7 @@ tags:
   - name: M1_ContentHostingProvisioning
     description: '5G Media Streaming: Provisioning (M1) APIs: Content Hosting Provisioning'
 externalDocs:
-  description: 'TS 26.512 V17.1.0; 5G Media Streaming (5GMS); Protocols'
+  description: 'TS 26.512 V17.2.0; 5G Media Streaming (5GMS); Protocols'
   url: 'https://www.3gpp.org/ftp/Specs/archive/26_series/26.512/'
 servers:
   - url: '{apiRoot}/3gpp-m1/v2'
@@ -135,6 +135,7 @@ components:
   schemas:
     IngestConfiguration:
       type: object
+      description: 'A configuration for content ingest.'
       properties:
         path:
           type: string
@@ -146,6 +147,7 @@ components:
           $ref: 'TS26512_CommonData.yaml#/components/schemas/Url'
     PathRewriteRule:
       type: object
+      description: 'A rule to manipulate URL paths.'
       required:
         - requestPattern
         - mappedPath
@@ -156,13 +158,15 @@ components:
           type: string
     CachingConfiguration:
       type: object
+      description: 'A content caching configuration.'
+      required:
+        - urlPatternFilter
       properties:
         urlPatternFilter:
           type: string
-        CachingDirectives:
+        cachingDirectives:
           type: object
           required:
-            - urlPatternFilter
             - noCache
           properties:
             statusCodeFilters:
@@ -176,6 +180,7 @@ components:
               format: int32
     DistributionConfiguration:
       type: object
+      description: 'A content distribution configuration.'
       required:
         - canonicalDomainName
         - domainNameAlias
@@ -194,7 +199,7 @@ components:
           type: array
           items:
             $ref: '#/components/schemas/CachingConfiguration'
-        GeoFencing:
+        geoFencing:
           type: object
           required:
             - locatorType
@@ -208,7 +213,7 @@ components:
                 type: string
                 description: 'Format of individual locators depends on the locatorType.'
               minItems: 1
-        UrlSignature:
+        urlSignature:
           type: object
           required:
             - urlPattern
@@ -246,6 +251,7 @@ components:
     # Schema for the resource itself
     ContentHostingConfiguration:
       type: object
+      description: "A representation of a Content Hosting Configuration resource."
       required:
         - name
         - ingestConfiguration
@@ -261,6 +267,7 @@ components:
             $ref: '#/components/schemas/DistributionConfiguration'
 
     DistributionNetworkType:
+      description: "Type of distribution network."
       anyOf:
         - type: string
           enum: [NETWORK_EMBMS]
@@ -271,6 +278,7 @@ components:
             content defined in the present version of this API.
 
     DistributionMode:
+      description: "Mode of content distribution."
       anyOf:
         - type: string
           enum: [MODE_EXCLUSIVE, MODE_HYBRID, MODE_DYNAMIC]

TS26512_M1_ContentPreparationTemplatesProvisioning.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.0
 info:
   title: M1_ContentPreparationTemplatesProvisioning
-  version: 1.0.0
+  version: 2.0.0
   description: |
     5GMS AF M1 Content Preparation Templates Provisioning API
     © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
@@ -10,7 +10,7 @@ tags:
   - name: M1_ContentPreparationTemplatesProvisioning
     description: '5G Media Streaming: Provisioning (M1) APIs: Content Preparation Templates Provisioning'
 externalDocs:
-  description: 'TS 26.512 V17.1.0; 5G Media Streaming (5GMS); Protocols'
+  description: 'TS 26.512 V17.2.0; 5G Media Streaming (5GMS); Protocols'
   url: 'https://www.3gpp.org/ftp/Specs/archive/26_series/26.512/'
 servers:
   - url: '{apiRoot}/3gpp-m1/v2'

TS26512_M1_ContentProtocolsDiscovery.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.0
 info:
   title: M1_ContentProtocolsDiscovery
-  version: 1.0.0
+  version: 2.0.0
   description: |
     5GMS AF M1 Content Protocols Discovery API
     © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
@@ -10,7 +10,7 @@ tags:
   - name: M1_ContentDiscovery
     description: '5G Media Streaming: Provisioning (M1) APIs: Content Protocols Discovery'
 externalDocs:
-  description: 'TS 26.512 V17.1.0; 5G Media Streaming (5GMS); Protocols'
+  description: 'TS 26.512 V17.2.0; 5G Media Streaming (5GMS); Protocols'
   url: 'https://www.3gpp.org/ftp/Specs/archive/26_series/26.512/'
 servers:
   - url: '{apiRoot}/3gpp-m1/v2'
@@ -41,6 +41,7 @@ components:
   schemas:
     ContentProtocolDescriptor:
       type: object
+      description: "A descriptor describing a content protocol."
       required:
         - termIdentifier
       properties:
@@ -50,6 +51,7 @@ components:
           $ref: 'TS26512_CommonData.yaml#/components/schemas/Url'
     ContentProtocols:
       type: object
+      description: "A representation of the Content Protocols resource."
       properties:
         downlinkIngestProtocols:
           type: array