Rel-18 Sept'23

TS24558_Eecs_ServiceProvisioning.yaml

@@ -2,14 +2,14 @@ openapi: 3.0.0
 
 info:
   title: Eecs_ServiceProvisioning
-  version: "1.1.0-alpha.2"
+  version: "1.1.0-alpha.3"
   description: |
     API for ECS Service Provisioning.  
     © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).  
     All rights reserved.
 
 externalDocs:
-  description: 3GPP TS 24.558 V18.1.0 Enabling Edge Applications; Protocol specification.
+  description: 3GPP TS 24.558 V18.2.0 Enabling Edge Applications; Protocol specification.
   url: https://www.3gpp.org/ftp/Specs/archive/24_series/24.558/
 
 security:
@@ -415,6 +415,11 @@ components:
             type: string
           minItems: 1
           description: Indicates to the ECS which EES providers are preferred by the EEC.
+        eecTriggerRequest:
+          type: boolean
+          description: >
+            Indicates to the ECS, whether the application triggering is required by the EEC.
+            Default value false indicates the application triggering is not required.
         suppFeat:
           $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
       required:

TS24558_Eees_EASDiscovery.yaml

@@ -6,11 +6,11 @@ info:
     API for EAS Discovery.  
     © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).  
     All rights reserved.
-  version: "1.1.0-alpha.2"
+  version: "1.1.0-alpha.3"
 
 externalDocs:
   description: >
-    3GPP TS 24.558 V18.1.0 Enabling Edge Applications; Protocol specification.
+    3GPP TS 24.558 V18.2.0 Enabling Edge Applications; Protocol specification.
   url: https://www.3gpp.org/ftp/Specs/archive/24_series/24.558/
 
 security:
@@ -367,6 +367,8 @@ components:
             the current request. The default value false indicates the EAS instantiation triggering
             should not be performed. The true value indicate the EAS instantiation triggering should
             be performed.
+        predictExpTime:
+          $ref: 'TS29122_CommonData.yaml#/components/schemas/DateTime'
       required:
         - requestorId
 
@@ -387,6 +389,15 @@ components:
           description: >
             Contains the EAS instantiation information for each discovered EAS returned within
             the discoveredEas attribute.
+        edgeLoadAnalytics:
+          type: object
+          additionalProperties:
+            $ref: '#/components/schemas/EdgeLoadAnalytic'
+          minProperties: 1
+          description: >
+            Contains the statistical analytics data and predictive analytics data for each
+            discovered application server. The key of the map shall be the EAS ID to which
+            the provided analytics data within the map value relates.
       required:
         - discoveredEas
 
@@ -432,9 +443,15 @@ components:
             the current request. The default value false indicates the EAS instantiation triggering
             should not be performed. The true value indicate the EAS instantiation triggering should
             be performed.
+        eecTriggerRequest:
+          type: boolean
+          description: >
+            Indicates to the EES whether the application triggering is required by the EEC.
+            Default value false indicates the application triggering is not required.
       required:
         - eecId
         - easEventType
+
     EasDiscoveryNotification:
       description: Notification of EAS discovery information.
       type: object
@@ -460,6 +477,15 @@ components:
           description: >
             Contains the EAS instantiation information for each discovered EAS returned within
             the "discoveredEas" attribute.
+        edgeLoadAnalytics:
+          type: object
+          additionalProperties:
+            $ref: '#/components/schemas/EdgeLoadAnalytic'
+          minProperties: 1
+          description: >
+            Contains the statistical analytics data and predictive analytics data for each
+            discovered application server. The key of the map shall be the EAS ID to which
+            the provided analytics data within the map value relates.
       required:
         - subId
         - eventType
@@ -489,6 +515,16 @@ components:
         easId:
           type: string
           description: EAS application identifier.
+        appGrpId:
+          type: string
+          description: >
+            Application group identifier, identifying a group of UEs using the same
+            application service.
+        easSyncInd:
+          type: boolean
+          description: >
+            Indicates whether the synchronization between the EASs is required. The
+            default value false indicates the EAS synchronization is not required.
         easProvId:
           type: string
           description: EAS provider identifier.
@@ -530,6 +566,7 @@ components:
           $ref: 'TS29122_CommonData.yaml#/components/schemas/DateTime'
       required:
         - eas
+
     EasDynamicInfoFilter:
       description: Represents EAS dynamic information changes filter.
       type: object
@@ -542,6 +579,7 @@ components:
           description: List of EAS dynamic information required by the EEC per EAS.
       required:
         - dynInfoFilter
+
     EasDynamicInfoFilterData:
       description: Represents an EAS dynamic information.
       type: object
@@ -561,6 +599,8 @@ components:
         easPt:
           type: boolean
           description: Notify if EAS endpoint changed.
+        easEndPoint:
+          $ref: 'TS29558_Eees_EASRegistration.yaml#/components/schemas/EndPoint'
         easFeature:
           type: boolean
           description: Notify if EAS feature changed.
@@ -641,3 +681,43 @@ components:
         - required: [eesId]
         - required: [easId]
         - required: [eecId]
+
+    EdgeLoadAnalytic:
+      description: >
+        Contains the statistical analytics data and predictive analytics data for each
+        discovered application server.
+      type: object
+      properties:
+        easId:
+          type: string
+          description: The application identifier of the EAS, e.g. FQDN, URI.
+        predictData:
+          $ref: '#/components/schemas/PredictiveData'
+        statisticData:
+          $ref: '#/components/schemas/StatisticalData'
+      required:
+        - easId
+
+    PredictiveData:
+      description: >
+        Contains the predictive analytics data for each discovered EAS service status
+         (e.g. EAS schedule, EAS status) change.
+      type: object
+      properties:
+        scheds:
+          type: array
+          items:
+            $ref: 'TS29122_CpProvisioning.yaml#/components/schemas/ScheduledCommunicationTime'
+          minItems: 1
+        status:
+          type: string
+          description: Indicates the EAS status (e.g. Enabled, Disabled etc.).
+
+    StatisticalData:
+      description: >
+        Contains the statistical analytics data (e.g. number of times the client received
+        expected performance from the EAS).
+      type: object
+      properties:
+        numRecPerf:
+          $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger'

TS24558_Eees_EECRegistration.yaml

@@ -2,15 +2,15 @@ openapi: 3.0.0
 
 info:
   title: Eees_EECRegistration
-  version: "1.1.0-alpha.2"
+  version: "1.1.0-alpha.3"
   description: |
     API for EEC registration.  
     © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).  
     All rights reserved.
 
 externalDocs:
   description: >
-    3GPP TS 24.558 V18.1.0 Enabling Edge Applications; Protocol specification.
+    3GPP TS 24.558 V18.2.0 Enabling Edge Applications; Protocol specification.
   url: 'https://www.3gpp.org/ftp/Specs/archive/24_series/24.558/'
 
 security:
@@ -269,6 +269,8 @@ components:
             Set to true to indicate that UE Mobility support is required.
             Set to false to indicate that UE mobility support is not required.
             The default value when omitted is false.
+        ueType:
+          $ref: '#/components/schemas/DeviceType'
         unfulfillAcProfs:
           type: array
           items:
@@ -374,6 +376,8 @@ components:
         ueMobilityReq:
           type: boolean
           description: Indicates whether UE requires mobility support or not.
+        ueType:
+          $ref: '#/components/schemas/DeviceType'
 
     UnfulfilledAcProfile:
       description: Describes AC Profile ID and reason sent by EES in EEC Register response.
@@ -401,3 +405,20 @@ components:
         Possible values are:
         - EAS_NOT_AVAILABLE: EAS is not available.
         - REQ_UNFULFILLED: Requirements cannot be fulfilled.
+
+    DeviceType:
+      anyOf:
+      - type: string
+        enum:
+          - CONSTRAINED_UE
+          - NORMAL_UE
+      - type: string
+        description: >
+          This string provides forward-compatibility with future
+          extensions to the enumeration and is not used to encode
+          content defined in the present version of this API.
+      description: >
+        Represents the UE type.
+        Possible values are:
+        - CONSTRAINED_UE: Indicates UE is constrained with resources like power, processor etc.
+        - NORMAL_UE: Indicates UE is not constrained with resources.

TS26512_CommonData.yaml

@@ -1,7 +1,7 @@
 openapi: 3.0.0
 info:
   title: 5GMS Common Data Types
-  version: 2.0.1
+  version: 2.0.2
   description: |
     5GMS Common Data Types
     © 2023, 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.4.0; 5G Media Streaming (5GMS); Protocols'
+  description: 'TS 26.512 V17.6.0; 5G Media Streaming (5GMS); Protocols'
   url: 'https://www.3gpp.org/ftp/Specs/archive/26_series/26.512/'
 paths: {}
 components:
@@ -40,7 +40,7 @@ components:
       type: string
       format: uri
       description: 'Absolute Uniform Resource Locator, conforming with the "absolute-URI" production specified in IETF RFC 3986, section 4.3 in which the scheme part is "http" or "https". Note that the "query" suffix is permitted by this production but the "fragment" suffix is not.'
- 
+
     #####################################
     # Clause 6.4.3: Structured data types
     #####################################
@@ -149,13 +149,53 @@ components:
     OperationSuccessResponse:
       type: object
       required:
-      - success
+        - success
       properties:
         success:
           type: boolean
         reason:
           type: string
 
+    EndpointAddress:
+      type: object
+      required:
+        - portNumber
+      properties:
+        hostname:
+          type: string
+        ipv4Addr:
+          $ref: 'TS29571_CommonData.yaml#/components/schemas/Ipv4Addr'
+        ipv6Addr:
+          $ref: 'TS29571_CommonData.yaml#/components/schemas/Ipv6Addr'
+        portNumber:
+          $ref: 'TS29571_CommonData.yaml#/components/schemas/Uint16'
+
+    EdgeProcessingEligibilityCriteria:
+      type: object
+      required:
+        - serviceDataFlowDescriptions
+        - ueLocations
+        - timeWindows
+        - appRequest
+      properties:
+        serviceDataFlowDescriptions:
+          type: array
+          items:
+            $ref: '#/components/schemas/ServiceDataFlowDescription'
+        ueLocations:
+          type: array
+          items:
+            $ref: 'TS29122_CommonData.yaml#/components/schemas/LocationArea5G'
+        timeWindows:
+          type: array
+          items:
+            $ref: 'TS29122_CommonData.yaml#/components/schemas/TimeWindow'
+        appRequest:
+          type: boolean
+
+    #####################################
+    # Clause 6.4.4: Enumerated data types
+    #####################################
     CellIdentifierType:
       anyOf:
         - type: string
@@ -186,18 +226,6 @@ components:
             extensions to the enumeration but is not used to encode
             content defined in the present version of this API.
 
-    EndpointAddress:
-      type: object
-      required:
-        - portNumber
-      properties:
-        ipv4Addr:
-          $ref: 'TS29571_CommonData.yaml#/components/schemas/Ipv4Addr'
-        ipv6Addr:
-          $ref: 'TS29571_CommonData.yaml#/components/schemas/Ipv6Addr'
-        portNumber:
-          $ref: 'TS29571_CommonData.yaml#/components/schemas/Uint16'
-
     CacheStatus:
       anyOf:
         - type: string
@@ -208,29 +236,6 @@ components:
             extensions to the enumeration but is not used to encode
             content defined in the present version of this API.
 
-    EdgeProcessingEligibilityCriteria:
-      type: object
-      required:
-        - serviceDataFlowDescriptions
-        - ueLocations
-        - timeWindows
-        - appRequest
-      properties:
-        serviceDataFlowDescriptions:
-          type: array
-          items:
-            $ref: '#/components/schemas/ServiceDataFlowDescription'
-        ueLocations:
-          type: array
-          items:
-            $ref: 'TS29122_CommonData.yaml#/components/schemas/LocationArea5G'
-        timeWindows:
-          type: array
-          items:
-            $ref: 'TS29122_CommonData.yaml#/components/schemas/TimeWindow'
-        appRequest:
-          type: boolean
-
     EASRelocationTolerance:
       anyOf:
         - type: string