From ec4688a85512846774c5c1398bdcaed310561956 Mon Sep 17 00:00:00 2001 From: Jesus de Gregorio Date: Sat, 25 Nov 2023 12:24:55 +0100 Subject: [PATCH] Rel-18 Sept'23 --- TS24558_Eecs_ServiceProvisioning.yaml | 9 +- TS24558_Eees_EASDiscovery.yaml | 84 +- TS24558_Eees_EECRegistration.yaml | 25 +- TS26512_CommonData.yaml | 83 +- TS26512_M1_ContentHostingProvisioning.yaml | 6 +- TS26512_M1_EdgeResourcesProvisioning.yaml | 17 +- TS26512_M1_MetricsReportingProvisioning.yaml | 8 +- TS26512_M1_PolicyTemplatesProvisioning.yaml | 21 +- TS26512_M5_ConsumptionReporting.yaml | 12 +- TS26512_M5_DynamicPolicies.yaml | 6 +- TS26512_M5_NetworkAssistance.yaml | 22 +- TS26512_M5_ServiceAccessInformation.yaml | 17 +- TS26517_MBSUserServiceAnnouncement.yaml | 113 +- TS26532_Ndcaf_DataReporting.yaml | 6 +- TS28105_AiMlNrm.yaml | 82 +- TS28312_IntentExpectations.yaml | 443 ++++-- TS28312_IntentNrm.yaml | 244 +++- TS28532_FaultMnS.yaml | 8 +- TS28532_FileDataReportingMnS.yaml | 4 +- TS28532_ProvMnS.yaml | 6 +- TS28541_5GcNrm.yaml | 1297 ++++++++++++++--- TS28541_NrNrm.yaml | 169 ++- TS28541_SliceNrm.yaml | 87 +- TS28623_GenericNrm.yaml | 260 +++- TS29122_AsSessionWithQoS.yaml | 113 +- TS29122_CommonData.yaml | 10 +- TS29122_CpProvisioning.yaml | 20 +- TS29122_MonitoringEvent.yaml | 55 +- TS29222_CAPIF_Events_API.yaml | 133 +- TS29309_Nbsp_GBA.yaml | 24 +- TS29502_Nsmf_PDUSession.yaml | 99 +- TS29503_Nudm_EE.yaml | 80 +- TS29503_Nudm_PP.yaml | 86 +- TS29503_Nudm_SDM.yaml | 256 +++- TS29503_Nudm_UEAU.yaml | 10 +- TS29503_Nudm_UECM.yaml | 212 ++- TS29504_Nudr_DR.yaml | 6 +- TS29505_Subscription_Data.yaml | 125 +- TS29507_Npcf_AMPolicyControl.yaml | 165 ++- TS29508_Nsmf_EventExposure.yaml | 11 +- TS29509_Nausf_UEAuthentication.yaml | 14 +- TS29510_Nnrf_NFDiscovery.yaml | 144 +- TS29510_Nnrf_NFManagement.yaml | 303 +++- TS29512_Npcf_SMPolicyControl.yaml | 86 +- TS29514_Npcf_PolicyAuthorization.yaml | 115 +- TS29515_Ngmlc_Location.yaml | 60 +- TS29517_Naf_EventExposure.yaml | 6 +- TS29518_Namf_Communication.yaml | 68 +- TS29518_Namf_Location.yaml | 38 +- TS29519_Application_Data.yaml | 137 +- TS29519_Policy_Data.yaml | 123 +- TS29520_Nnwdaf_AnalyticsInfo.yaml | 76 +- TS29520_Nnwdaf_EventsSubscription.yaml | 510 +++++-- TS29520_Nnwdaf_MLModelProvision.yaml | 12 +- TS29520_Nnwdaf_MLModelTraining.yaml | 177 ++- TS29522_5GLANParameterProvision.yaml | 204 ++- TS29522_AKMA.yaml | 11 +- TS29522_AnalyticsExposure.yaml | 83 +- TS29522_DNAIMapping.yaml | 12 +- TS29522_GroupParametersProvisioning.yaml | 407 ++++++ TS29522_MBSGroupMsgDelivery.yaml | 89 +- TS29522_MBSUserDataIngestSession.yaml | 4 +- TS29522_MoLcsNotify.yaml | 11 +- TS29522_PDTQPolicyNegotiation.yaml | 10 +- TS29522_ServiceParameter.yaml | 73 +- TS29522_SliceParamProvision.yaml | 374 +++++ TS29522_TimeSyncExposure.yaml | 96 +- TS29522_TrafficInfluence.yaml | 44 +- TS29522_UEId.yaml | 8 +- TS29525_Npcf_UEPolicyControl.yaml | 145 +- TS29526_Nnssaaf_AIW.yaml | 8 +- TS29526_Nnssaaf_NSSAA.yaml | 8 +- TS29531_Nnssf_NSSAIAvailability.yaml | 62 +- TS29535_Naanf_AKMA.yaml | 6 +- TS29536_Nnsacf_NSAC.yaml | 128 +- TS29536_Nnsacf_SliceEventExposure.yaml | 4 +- TS29538_MSGS_MSGDelivery.yaml | 10 +- TS29543_Npcf_PDTQPolicyControl.yaml | 14 +- TS29548_SDD_DDContext.yaml | 163 +++ TS29548_SDD_Transmission.yaml | 184 +++ ...48_SDD_TransmissionQualityMeasurement.yaml | 200 ++- TS29549_SS_Events.yaml | 11 +- TS29549_SS_LocationAreaInfoRetrieval.yaml | 10 +- TS29549_SS_NetworkResourceAdaptation.yaml | 136 +- TS29558_Ecas_SelectedEES.yaml | 105 ++ TS29558_Eecs_EESRegistration.yaml | 19 +- TS29558_Eecs_TargetEESDiscovery.yaml | 49 +- TS29558_Eees_ACRManagementEvent.yaml | 44 +- TS29558_Eees_ACRParameterInformation.yaml | 6 +- TS29558_Eees_CommonEASAnnouncement.yaml | 101 ++ TS29558_Eees_EASRegistration.yaml | 107 +- TS29562_Nhss_imsUECM.yaml | 18 +- TS29563_Nhss_EE.yaml | 25 +- TS29564_Nupf_EventExposure.yaml | 55 +- TS29565_Ntsctsf_QoSandTSCAssistance.yaml | 46 +- TS29565_Ntsctsf_TimeSynchronization.yaml | 21 +- TS29571_CommonData.yaml | 510 ++++++- TS29572_Nlmf_Location.yaml | 343 ++++- TS29574_Ndccf_DataManagement.yaml | 10 +- TS29575_Nadrf_DataManagement.yaml | 23 +- TS29575_Nadrf_MLModelManagement.yaml | 259 ++++ TS29580_Nmbsf_MBSUserDataIngestSession.yaml | 29 +- TS29583_Ppinserver_ASRegistration.yaml | 322 ++++ TS29591_Nnef_DNAIMapping.yaml | 207 +++ TS29591_Nnef_ECSAddress.yaml | 17 +- TS29591_Nnef_TrafficInfluenceData.yaml | 11 +- TS29598_Nudsf_DataRepository.yaml | 58 +- TS32291_Nchf_ConvergedCharging.yaml | 48 +- 108 files changed, 9876 insertions(+), 1375 deletions(-) create mode 100644 TS29522_GroupParametersProvisioning.yaml create mode 100644 TS29522_SliceParamProvision.yaml create mode 100644 TS29548_SDD_DDContext.yaml create mode 100644 TS29548_SDD_Transmission.yaml create mode 100644 TS29558_Ecas_SelectedEES.yaml create mode 100644 TS29558_Eees_CommonEASAnnouncement.yaml create mode 100644 TS29575_Nadrf_MLModelManagement.yaml create mode 100644 TS29583_Ppinserver_ASRegistration.yaml create mode 100644 TS29591_Nnef_DNAIMapping.yaml diff --git a/TS24558_Eecs_ServiceProvisioning.yaml b/TS24558_Eecs_ServiceProvisioning.yaml index 3c3b51a6..fb5f0062 100644 --- a/TS24558_Eecs_ServiceProvisioning.yaml +++ b/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: diff --git a/TS24558_Eees_EASDiscovery.yaml b/TS24558_Eees_EASDiscovery.yaml index 5ec88ff5..439fbde5 100644 --- a/TS24558_Eees_EASDiscovery.yaml +++ b/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' diff --git a/TS24558_Eees_EECRegistration.yaml b/TS24558_Eees_EECRegistration.yaml index f9f7a9af..d6b4be52 100644 --- a/TS24558_Eees_EECRegistration.yaml +++ b/TS24558_Eees_EECRegistration.yaml @@ -2,7 +2,7 @@ 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). @@ -10,7 +10,7 @@ info: 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. diff --git a/TS26512_CommonData.yaml b/TS26512_CommonData.yaml index 7347e953..aba41310 100644 --- a/TS26512_CommonData.yaml +++ b/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 diff --git a/TS26512_M1_ContentHostingProvisioning.yaml b/TS26512_M1_ContentHostingProvisioning.yaml index ec778af5..84ef9676 100644 --- a/TS26512_M1_ContentHostingProvisioning.yaml +++ b/TS26512_M1_ContentHostingProvisioning.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: title: M1_ContentHostingProvisioning - version: 2.2.1 + version: 2.2.2 description: | 5GMS AF M1 Content Hosting Provisioning API © 2023, 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.5.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/' servers: - url: '{apiRoot}/3gpp-m1/v2' @@ -239,6 +239,8 @@ components: $ref: '#/components/schemas/M1MediaEntryPoint' contentPreparationTemplateId: $ref: 'TS26512_CommonData.yaml#/components/schemas/ResourceId' + edgeResourcesConfigurationId: + $ref: 'TS26512_CommonData.yaml#/components/schemas/ResourceId' canonicalDomainName: type: string domainNameAlias: diff --git a/TS26512_M1_EdgeResourcesProvisioning.yaml b/TS26512_M1_EdgeResourcesProvisioning.yaml index ce1bc05b..854bea11 100644 --- a/TS26512_M1_EdgeResourcesProvisioning.yaml +++ b/TS26512_M1_EdgeResourcesProvisioning.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: title: M1_EdgeResourcesProvisioning - version: 2.1.1 + version: 2.1.2 description: | 5GMS AF M1 Edge Resources Provisioning API © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ tags: - name: M1_EdgeResourcesProvisioning description: '5G Media Streaming: Provisioning (M1) APIs: Edge Resources Provisioning' 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/' servers: - url: '{apiRoot}/3gpp-m1/v2' @@ -152,23 +152,21 @@ components: EASRequirements: type: object description: 'Requirements of an EAS.' - required: - - easProviderIds - - easType - - easFeatures - - serviceAvailabilitySchedule - - serviceContinuityScenarios properties: easProviderIds: type: array items: type: string + minItems: 1 + easId: + type: string easType: type: string easFeatures: type: array items: type: string + minItems: 1 serviceKpi: $ref: 'TS29558_Eees_EASRegistration.yaml#/components/schemas/EASServiceKPI' serviceArea: @@ -177,14 +175,17 @@ components: type: array items: $ref: 'TS29122_CpProvisioning.yaml#/components/schemas/ScheduledCommunicationTime' + minItems: 1 serviceContinuityScenarios: type: array items: $ref: 'TS29558_Eecs_EESRegistration.yaml#/components/schemas/ACRScenario' + minItems: 1 serviceContinuitySupport: type: array items: $ref: 'TS29558_Eecs_EESRegistration.yaml#/components/schemas/ACRScenario' + minItems: 1 EdgeManagementMode: description: 'The management mode of an EAS.' diff --git a/TS26512_M1_MetricsReportingProvisioning.yaml b/TS26512_M1_MetricsReportingProvisioning.yaml index eab0c7b0..6d51ce24 100644 --- a/TS26512_M1_MetricsReportingProvisioning.yaml +++ b/TS26512_M1_MetricsReportingProvisioning.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: title: M1_MetricsReportingProvisioning - version: 2.0.1 + version: 2.1.0 description: | 5GMS AF M1 Metrics Reporting Provisioning API © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ tags: - name: M1_MetricsReportingProvisioning description: '5G Media Streaming: Provisioning (M1) APIs: Metrics Reporting Provisioning' 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/' servers: - url: '{apiRoot}/3gpp-m1/v2' @@ -122,7 +122,7 @@ components: description: "A representation of a Metrics Reporting Configuration resource." required: - metricsReportingConfigurationId - - scheme + - samplingPeriod properties: metricsReportingConfigurationId: $ref: 'TS26512_CommonData.yaml#/components/schemas/ResourceId' @@ -139,6 +139,8 @@ components: items: type: string minItems: 1 + samplingPeriod: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' metrics: type: array items: diff --git a/TS26512_M1_PolicyTemplatesProvisioning.yaml b/TS26512_M1_PolicyTemplatesProvisioning.yaml index e898d153..ee4053d1 100644 --- a/TS26512_M1_PolicyTemplatesProvisioning.yaml +++ b/TS26512_M1_PolicyTemplatesProvisioning.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: title: M1_PolicyTemplatesProvisioning - version: 2.1.0 + version: 2.2.0 description: | 5GMS AF M1 Policy Templates Provisioning API © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ tags: - name: M1_PolicyTemplatesProvisioning description: '5G Media Streaming: Provisioning (M1) APIs: Policy Templates Provisioning' externalDocs: - description: 'TS 26.512 V17.5.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/' servers: - url: '{apiRoot}/3gpp-m1/v2' @@ -126,8 +126,6 @@ components: - policyTemplateId - state - stateReason - - apiEndPoint - - apiType - externalReference - applicationSessionContext properties: @@ -144,17 +142,6 @@ components: content defined in the present version of this API. stateReason: $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails' - apiEndPoint: - type: string - apiType: - anyOf: - - type: string - enum: [N5, N33] - - 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. externalReference: type: string qoSSpecification: @@ -162,13 +149,9 @@ components: applicationSessionContext: type: object properties: - afAppId: - $ref: 'TS29514_Npcf_PolicyAuthorization.yaml#/components/schemas/AfAppId' sliceInfo: $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' dnn: $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' - aspId: - $ref: 'TS29514_Npcf_PolicyAuthorization.yaml#/components/schemas/AspId' chargingSpecification: $ref: 'TS26512_CommonData.yaml#/components/schemas/ChargingSpecification' diff --git a/TS26512_M5_ConsumptionReporting.yaml b/TS26512_M5_ConsumptionReporting.yaml index 65792b26..59204cc5 100644 --- a/TS26512_M5_ConsumptionReporting.yaml +++ b/TS26512_M5_ConsumptionReporting.yaml @@ -1,16 +1,16 @@ openapi: 3.0.0 info: title: M5_ConsumptionReporting - version: 2.0.0 + version: 2.1.0 description: | 5GMS AF M5 Consumption Reporting API - © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. tags: - name: M5_ConsumptionReporting description: '5G Media Streaming: Media Session Handling (M5) APIs: Consumption Reporting' externalDocs: - description: 'TS 26.512 V17.2.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/' servers: - url: '{apiRoot}/3gpp-m5/v2' @@ -19,13 +19,13 @@ servers: default: https://example.com description: See 3GPP TS 29.512 clause 6.1. paths: - /consumption-reporting/{aspId}: + /consumption-reporting/{provisioningSessionId}: parameters: - - name: aspId + - name: provisioningSessionId in: path required: true schema: - $ref: 'TS29514_Npcf_PolicyAuthorization.yaml#/components/schemas/AspId' + $ref: 'TS26512_CommonData.yaml#/components/schemas/ResourceId' description: 'See 3GPP TS 26.512 clause 11.3.2.' post: operationId: submitConsumptionReport diff --git a/TS26512_M5_DynamicPolicies.yaml b/TS26512_M5_DynamicPolicies.yaml index 068f5528..82b4be11 100644 --- a/TS26512_M5_DynamicPolicies.yaml +++ b/TS26512_M5_DynamicPolicies.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: title: M5_DynamicPolicies - version: 2.0.1 + version: 2.0.2 description: | 5GMS AF M5 Dynamic Policy API © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ tags: - name: M5_DynamicPolicies description: '5G Media Streaming: Media Session Handling (M5) APIs: Dynamic Policies' 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/' servers: - url: '{apiRoot}/3gpp-m5/v2' @@ -147,6 +147,8 @@ components: type: array items: $ref: 'TS26512_CommonData.yaml#/components/schemas/ServiceDataFlowDescription' + mediaType: + $ref: 'TS29514_Npcf_PolicyAuthorization.yaml#/components/schemas/MediaType' provisioningSessionId: $ref: 'TS26512_CommonData.yaml#/components/schemas/ResourceId' qosSpecification: diff --git a/TS26512_M5_NetworkAssistance.yaml b/TS26512_M5_NetworkAssistance.yaml index 8e119400..be08ec8a 100644 --- a/TS26512_M5_NetworkAssistance.yaml +++ b/TS26512_M5_NetworkAssistance.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: title: M5_NetworkAssistance - version: 2.0.1 + version: 2.1.0 description: | 5GMS AF M5 Network Assistance API © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,8 +10,8 @@ tags: - name: M5_NetworkAssistance description: '5G Media Streaming: Media Session Handling (M5) APIs: Network Assistance' externalDocs: - description: 3GPP TS 26.512 V17.4.0; 5G Media Streaming (5GMS); Protocols. - url: 'http://www.3gpp.org/ftp/Specs/archive/29_series/26.512/' + description: 'TS 26.512 V17.6.0; 5G Media Streaming (5GMS); Protocols' + url: 'https://www.3gpp.org/ftp/Specs/archive/26_series/26.512/' servers: - url: '{apiRoot}/3gpp-m5/v2' variables: @@ -23,6 +23,12 @@ paths: post: operationId: createNetworkAssistanceSession summary: 'Create a new Network Assistance Session.' + requestBody: + description: 'The initial parameters for the Network Assistance Session resource' + content: + application/json: + schema: + $ref: '#/components/schemas/NetworkAssistanceSession' responses: '201': description: 'Created Network Assistance Session' @@ -32,7 +38,7 @@ paths: $ref: '#/components/schemas/NetworkAssistanceSession' headers: Location: - description: 'The URL of the nely created Network Assistance Session resource' + description: 'The URL of the newly created Network Assistance Session resource' required: true schema: $ref: 'TS26512_CommonData.yaml#/components/schemas/AbsoluteUrl' @@ -178,14 +184,20 @@ components: type: object required: - naSessionId + - provisioningSessionId + - serviceDataFlowDescriptions properties: naSessionId: $ref: 'TS26512_CommonData.yaml#/components/schemas/ResourceId' - serviceDataFlowDescription: + provisioningSessionId: + $ref: 'TS26512_CommonData.yaml#/components/schemas/ResourceId' + serviceDataFlowDescriptions: type: array items: $ref: 'TS26512_CommonData.yaml#/components/schemas/ServiceDataFlowDescription' minItems: 1 + mediaType: + $ref: 'TS29514_Npcf_PolicyAuthorization.yaml#/components/schemas/MediaType' policyTemplateId: $ref: 'TS26512_CommonData.yaml#/components/schemas/ResourceId' requestedQoS: diff --git a/TS26512_M5_ServiceAccessInformation.yaml b/TS26512_M5_ServiceAccessInformation.yaml index e5aeb5cf..817e06de 100644 --- a/TS26512_M5_ServiceAccessInformation.yaml +++ b/TS26512_M5_ServiceAccessInformation.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: title: M5_ServiceAccessInformation - version: 2.2.1 + version: 2.3.0 description: | 5GMS AF M5 Service Access Information API © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ tags: - name: M5_ServiceAccessInformation description: '5G Media Streaming: Media Session Handling (M5) APIs: Service Access Information' externalDocs: - description: 'TS 26.512 V17.5.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/' servers: - url: '{apiRoot}/3gpp-m5/v2' @@ -135,6 +135,7 @@ components: - scheme - samplePercentage - urlFilters + - samplingPeriod - metrics properties: serverAddresses: @@ -145,13 +146,15 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' reportingInterval: $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' - samplePercentage: + samplePercentage: $ref: 'TS26512_CommonData.yaml#/components/schemas/Percentage' urlFilters: type: array items: type: string minItems: 0 + samplingPeriod: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' metrics: type: array items: @@ -189,18 +192,18 @@ components: EASDiscoveryTemplate: description: 'A template for discovering an EAS instance .' type: object - required: - - easType - - easProviderIds - - serviceFeatures properties: + easId: + type: string easType: type: string easProviderIds: type: array items: type: string + minItems: 1 serviceFeatures: type: array items: type: string + minItems: 1 diff --git a/TS26517_MBSUserServiceAnnouncement.yaml b/TS26517_MBSUserServiceAnnouncement.yaml index 7840c5d3..6ae4cde9 100644 --- a/TS26517_MBSUserServiceAnnouncement.yaml +++ b/TS26517_MBSUserServiceAnnouncement.yaml @@ -1,20 +1,84 @@ openapi: 3.0.0 info: - title: 'MBS User Service Announcement Element units’ definition' - version: 1.1.0 + title: 'MBS User Service Announcement' + version: 1.2.0 description: | MBS User Service Announcement Element units. - © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 26.517 V17.1.0; 5G System; 5G MBSF; Stage 3. + description: 3GPP TS 26.517 V17.4.0; 5G Multicast-Broadcast User Services; Protocols and Formats url: http://www.3gpp.org/ftp/Specs/archive/26_series/26.517/ -paths: {} +paths: + /user-service-descriptions: + get: + operationId: discoverUserServiceDescriptions + summary: 'Discover User Service Descriptions' + description: 'Discover User Service Descriptions that match the supplied query filter(s). At least one filter query parameter must be included in the request URL.' + parameters: + - in: query + name: service-class + schema: + type: string + required: true + description: 'Filter for User Service Descriptions tagged with the supplied service class term identifier expressed as a fully-qualified URI string from a controlled vocabulary' + responses: + '200': + # OK + description: "Success" + content: + application/json: + schema: + $ref: '#/components/schemas/UserServiceDescriptions' + '204': + # No Content (no matching User Service Descriptions) + description: "No Matches Found" + '500': + # Internal Server Error + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '503': + # Service Unavailable + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29571_CommonData.yaml#/components/responses/default' + + /user-service-descriptions/{externalServiceId}: + get: + operationId: retrieveUserServiceDescription + summary: 'Retrieve User Service Description' + description: 'Retrieve the User Service Description of a single service by supplying its external service identifier.' + parameters: + - name: externalServiceId + in: path + required: true + schema: + type: string + description: 'The external service identifier of a User Service provisioned in the MBSF.' + responses: + '200': + # OK + description: "Success" + content: + application/json: + schema: + $ref: '#/components/schemas/UserServiceDescription' + '404': + # Not Found + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '500': + # Internal Server Error + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '503': + # Service Unavailable + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29571_CommonData.yaml#/components/responses/default' + components: schemas: - BundleDescription: + UserServiceDescriptions: type: array items: $ref: '#/components/schemas/UserServiceDescription' @@ -42,15 +106,16 @@ components: availabilityInfo: $ref: '#/components/schemas/AvailabilityInformation' required: - - distributionMethod - serviceId DistributionSessionDescription: type: object properties: + distributionMethod: + $ref: '#/components/schemas/DistributionMethod' conformanceProfile: - type: string - sessionDescriptionURI: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' + sessionDescriptionLocator: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' objectRepairParameters: $ref: '#/components/schemas/AssociatedProcedureDescription' @@ -70,12 +135,23 @@ components: items: $ref: '#/components/schemas/ApplicationService' required: - - sessionDescriptionURI + - distributionMethod + - sessionDescriptionLocator + + DistributionMethod: + anyOf: + - type: string + enum: [OBJECT, PACKET] + - 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. AppServiceDescription: type: object properties: - mediaManifestDescriptionURI: + mediaEntryPointLocator: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' mimeType: type: string @@ -135,7 +211,7 @@ components: PostObjectRepair: type: object properties: - serviceURIs: + serviceLocators: type: array items: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' @@ -169,9 +245,9 @@ components: serviceClass: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' required: + - sessionSchedule - serviceId - serviceClass - - serviceSchedule SessionSchedule: type: array @@ -191,11 +267,12 @@ components: type: string index: type: integer - FDTInstanceURI: + fDTInstanceLocator: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' required: - start - stop + SessionScheduleOverride: type: array items: @@ -209,15 +286,15 @@ components: type: integer cancelled: type: boolean - sessionDescriptionURI: + sessionDescriptionLocator: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' - + ObjectSchedule: type: array items: type: object - properties: - objectURI: + properties: + objectLocator: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' sessionId: type: string diff --git a/TS26532_Ndcaf_DataReporting.yaml b/TS26532_Ndcaf_DataReporting.yaml index 36d1b427..18f641a9 100644 --- a/TS26532_Ndcaf_DataReporting.yaml +++ b/TS26532_Ndcaf_DataReporting.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: title: Ndcaf_DataReporting - version: 1.2.0 + version: 1.2.1 description: | Data Collection AF: Data Collection and Reporting Configuration API and Data Reporting API © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -12,7 +12,7 @@ tags: description: 'Data Collection and Reporting: Client Configuration and Data Reporting (R2/R3/R4) APIs' externalDocs: - description: 'TS 26.532 V17.2.0; Data Collection and Reporting; Protocols and Formats' + description: 'TS 26.532 V18.0.0; Data Collection and Reporting; Protocols and Formats' url: 'https://www.3gpp.org/ftp/Specs/archive/26_series/26.532/' servers: @@ -306,6 +306,8 @@ components: properties: externalApplicationId: $ref: 'TS29571_CommonData.yaml#/components/schemas/ApplicationId' + expedite: + type: boolean serviceExperienceRecords: type: array items: diff --git a/TS28105_AiMlNrm.yaml b/TS28105_AiMlNrm.yaml index 2ceebaf6..943f6aeb 100644 --- a/TS28105_AiMlNrm.yaml +++ b/TS28105_AiMlNrm.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: AI/ML NRM - version: 17.4.0 + version: 18.1.0 description: >- OAS 3.0.1 specification of the AI/ML NRM © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -15,27 +15,6 @@ components: #-------- Definition of types----------------------------------------------------- - MLEntityList: - type: array - items: - $ref: '#/components/schemas/MLEntity' - - MLEntity: - type: object - properties: - mLEntityId: - type: string - inferenceType: - type: string - mLEntityVersion: - type: string - expectedRunTimeContext: - $ref: '#/components/schemas/MLContext' - trainingContext: - $ref: '#/components/schemas/MLContext' - runTimeContext: - $ref: '#/components/schemas/MLContext' - MLContext: type: object properties: @@ -122,6 +101,8 @@ components: $ref: '#/components/schemas/ManagedElement-Multiple' MLTrainingFunction: $ref: '#/components/schemas/MLTrainingFunction-Multiple' + MLEntityRepository: + $ref: '#/components/schemas/MLEntityRepository-Multiple' ManagedElement-Single: allOf: @@ -135,6 +116,8 @@ components: properties: MLTrainingFunction: $ref: '#/components/schemas/MLTrainingFunction-Multiple' + MLEntityRepository: + $ref: '#/components/schemas/MLEntityRepository-Multiple' MLTrainingFunction-Single: allOf: @@ -146,8 +129,8 @@ components: - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-Attr' - type: object properties: - mLEntityList: - $ref: '#/components/schemas/MLEntityList' + mLEntityRepositoryRef: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnList' - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-ncO' - type: object properties: @@ -169,6 +152,8 @@ components: properties: mLEntityId: type: string + inferenceType: + type: string candidateTrainingDataSource: type: array items: @@ -188,6 +173,8 @@ components: type: boolean suspendRequest: type: boolean + mLEntityToTrainRef: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' MLTrainingProcess-Single: allOf: @@ -249,6 +236,42 @@ components: $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' lastTrainingRef: $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' + mLEnityGeneratedRef: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' + + MLEntity-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + type: object + properties: + mLEntityId: + type: string + inferenceType: + type: string + mLEntityVersion: + type: string + expectedRunTimeContext: + $ref: '#/components/schemas/MLContext' + trainingContext: + $ref: '#/components/schemas/MLContext' + runTimeContext: + $ref: '#/components/schemas/MLContext' + + MLEntityRepository-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + type: object + properties: + mLRepositoryId: + type: string + MLEntity: + $ref: '#/components/schemas/MLEntity-Multiple' #-------- Definition of JSON arrays for name-contained IOCs ---------------------- @@ -276,7 +299,14 @@ components: type: array items: $ref: '#/components/schemas/MLTrainingReport-Single' - + MLEntity-Multiple: + type: array + items: + $ref: '#/components/schemas/MLEntity-Single' + MLEntityRepository-Multiple: + type: array + items: + $ref: '#/components/schemas/MLEntityRepository-Single' #-------- Definitions in TS 28.104 for TS 28.532 --------------------------------- @@ -289,3 +319,5 @@ components: - $ref: '#/components/schemas/MLTrainingRequest-Single' - $ref: '#/components/schemas/MLTrainingProcess-Single' - $ref: '#/components/schemas/MLTrainingReport-Single' + - $ref: '#/components/schemas/MLEntity-Single' + - $ref: '#/components/schemas/MLEntityRepository-Single' diff --git a/TS28312_IntentExpectations.yaml b/TS28312_IntentExpectations.yaml index 971302e2..5423a87a 100644 --- a/TS28312_IntentExpectations.yaml +++ b/TS28312_IntentExpectations.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: Scenario specific Intent Expectations - version: 18.0.0 + version: 18.1.0 description: >- OAS 3.0.1 definition of scenario specific Intent Expectations © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -23,33 +23,72 @@ components: type: string expectationVerb: $ref: "TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb" - expectationObjects: - type: array - items: - $ref: "#/components/schemas/RadioNetworkExpectationObject" + expectationObject: + $ref: "#/components/schemas/RadioNetworkExpectationObject" expectationTargets: type: array items: type: object oneOf: - - $ref: "#/components/schemas/WeakRSRPRatioTarget" - - $ref: "#/components/schemas/LowSINRRatioTarget" - - $ref: "#/components/schemas/AveULRANUEThptTarget" - - $ref: "#/components/schemas/AveDLRANUEThptTarget" - - $ref: "#/components/schemas/LowULRANUEThptRatioTarget" - - $ref: "#/components/schemas/LowDLRANUEThptRatioTarget" + - $ref: '#/components/schemas/WeakRSRPRatioTarget' + - $ref: '#/components/schemas/LowSINRRatioTarget' + - $ref: '#/components/schemas/AveULRANUEThptTarget' + - $ref: '#/components/schemas/AveDLRANUEThptTarget' + - $ref: '#/components/schemas/LowULRANUEThptRatioTarget' + - $ref: '#/components/schemas/LowDLRANUEThptRatioTarget' + - $ref: '#/components/schemas/HighULPrbLoadRatioTarget' + - $ref: '#/components/schemas/HighDLPrbLoadRatioTarget' + - $ref: '#/components/schemas/AveULPrbLoadTarget' + - $ref: '#/components/schemas/AveDLPrbLoadTarget' + - $ref: "#/components/schemas/RANEnergyConsumptionTarget" + - $ref: "#/components/schemas/RANEnergyEfficiencyTarget" + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget' expectationContexts: type: array items: - $ref: "TS28312_IntentNrm.yaml#/components/schemas/ExpectationContext" - expectationfulfilmentInfo: - $ref: "TS28312_IntentNrm.yaml#/components/schemas/FulfilmentInfo" + $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationContext' required: - expectationId - ServiceSupportExpectation: + EdgeServiceSupportExpectation: description: >- This data type is the "IntentExpectation" data type with specialisations to represent MnS consumer's expectations for service deployment type: object + properties: + expectationId: + type: string + expectationVerb: + $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb' + expectationObject: + $ref: '#/components/schemas/ServiceSupportExpectationObject' + expectationTargets: + type: array + items: + type: object + oneOf: + - $ref: '#/components/schemas/DLThptPerUETarget' + - $ref: '#/components/schemas/ULThptPerUETarget' + - $ref: '#/components/schemas/DLLatencyTarget' + - $ref: '#/components/schemas/ULLatencyTarget' + - $ref: '#/components/schemas/MaxNumberofUEsTarget' + - $ref: '#/components/schemas/ActivityFactorTarget' + - $ref: '#/components/schemas/UESpeedTarget' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget' + expectationContexts: + type: array + items: + type: object + oneOf: + - $ref: '#/components/schemas/ServiceStartTimeContext' + - $ref: '#/components/schemas/ServiceEndTimeContext' + - $ref: '#/components/schemas/UEMobilityLevelContext' + - $ref: '#/components/schemas/ResourceSharingLevelContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationContext' + required: + - expectationId + 5GCNetworkExpectation: + description: >- + This data type is the "IntentExpectation" data type with specialisations to represent MnS consumer's expectations for 5GC network delivering + type: object properties: expectationId: type: string @@ -58,34 +97,23 @@ components: expectationObjects: type: array items: - $ref: "#/components/schemas/ServiceSupportExpectationObject" + $ref: "#/components/schemas/5GCNetworkExpectationObject" expectationTargets: type: array items: type: object oneOf: - - $ref: "#/components/schemas/DLThptPerUETarget" - - $ref: "#/components/schemas/ULThptPerUETarget" - - $ref: "#/components/schemas/DLLatencyTarget" - - $ref: "#/components/schemas/ULLatencyTarget" - - $ref: "#/components/schemas/MaxNumberofUEsTarget" - - $ref: "#/components/schemas/ActivityFactorTarget" - - $ref: "#/components/schemas/UESpeedTarget" + - $ref: "#/components/schemas/MaxNumberofPDUsessionsTarget" + - $ref: "#/components/schemas/MaxNumberofRegisteredsubscribersTarget" - $ref: "TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget" expectationContexts: type: array items: - type: object - oneOf: - - $ref: "#/components/schemas/ServiceStartTimeContext" - - $ref: "#/components/schemas/ServiceEndTimeContext" - - $ref: "#/components/schemas/UEMobilityLevelContext" - - $ref: "#/components/schemas/ResourceSharingLevelContext" - - $ref: "TS28312_IntentNrm.yaml#/components/schemas/ExpectationContext" + $ref: "TS28312_IntentNrm.yaml#/components/schemas/ExpectationContext" expectationfulfilmentInfo: - $ref: "TS28312_IntentNrm.yaml#/components/schemas/FulfilmentInfo" + $ref: "TS28312_IntentNrm.yaml#/components/schemas/FulfilmentInfo" required: - - expectationId + - expectationId #-------Definition of the IntentExpectation dataType ----------# #-------Definition of the scenario specific ExpectationObject dataType ----------# @@ -97,29 +125,50 @@ components: objectType: type: string enum: - - RAN_SubNetwork #value for Radio Network Expectation--# + - RAN_SubNetwork objectInstance: - $ref: "TS28623_ComDefs.yaml#/components/schemas/Dn" + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' objectContexts: type: array items: type: object oneOf: - - $ref: "#/components/schemas/CoverageAreaPolygonContext" - - $ref: "#/components/schemas/CoverageTACContext" - - $ref: "#/components/schemas/PLMNContext" - - $ref: "#/components/schemas/NRFqBandContext" - - $ref: "#/components/schemas/RATContext" - - $ref: "#/components/schemas/ObjectContext" + - $ref: '#/components/schemas/CoverageAreaPolygonContext' + - $ref: '#/components/schemas/CoverageTACContext' + - $ref: '#/components/schemas/PLMNContext' + - $ref: '#/components/schemas/NRFqBandContext' + - $ref: '#/components/schemas/RATContext' + - $ref: "#/components/schemas/UEGroupContext" + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ObjectContext' ServiceSupportExpectationObject: description: >- - This data type is the "ExpectationObject" data type with specialisations for ServiceSupportExpectation + This data type is the "ExpectationObject" data type with specialisations for EdgeServiceSupportExpectation type: object properties: objectType: type: string enum: - - Service_Support #value for Service Support Expectation--# + - EdgeService_Support #value for Edge Service Support Expectation--# + objectInstance: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' + objectContexts: + type: array + items: + type: object + oneOf: + - $ref: '#/components/schemas/EdgeIdenfiticationIdContext' + - $ref: '#/components/schemas/EdgeIdentificationLocContext' + - $ref: '#/components/schemas/CoverageAreaTAContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ObjectContext' + 5GCNetworkExpectationObject: + description: >- + This data type is the "ExpectationObject" data type with specialisations for 5GCNetworkExpectation + type: object + properties: + objectType: + type: string + enum: + - 5GC_SubNetwork #value for 5GC Network Expectation--# objectInstance: $ref: "TS28623_ComDefs.yaml#/components/schemas/Dn" objectContexts: @@ -127,10 +176,11 @@ components: items: type: object oneOf: - - $ref: "#/components/schemas/EdgeIdenfiticationIdContext" - - $ref: "#/components/schemas/EdgeIdenfiticationLocContext" - - $ref: "#/components/schemas/CoverageAreaTAContext" - - $ref: "#/components/schemas/ObjectContext" + - $ref: "#/components/schemas/NfTypeContext" + - $ref: "#/components/schemas/NfInstanceLocationContext" + - $ref: "#/components/schemas/PLMNContext" + - $ref: "#/components/schemas/TaiContext" + - $ref: "#/components/schemas/ObjectContext" #-------Definition of the ExpectationObject dataType ----------# @@ -153,9 +203,7 @@ components: minimum: 0 maximum: 100 targetContexts: - $ref: "#/components/schemas/WeakRSRPContext" - targetFulfilmentInfo: - $ref: "TS28312_IntentNrm.yaml#/components/schemas/FulfilmentInfo" + $ref: '#/components/schemas/WeakRSRPContext' WeakRSRPContext: description: >- This data type is the "TargetContext" data type with specialisations for WeakRSRPContext @@ -189,9 +237,7 @@ components: minimum: 0 maximum: 100 targetContexts: - $ref: "#/components/schemas/LowSINRContext" - targetFulfilmentInfo: - $ref: "TS28312_IntentNrm.yaml#/components/schemas/FulfilmentInfo" + $ref: '#/components/schemas/LowSINRContext' LowSINRContext: description: >- This data type is the "TargetContext" data type with specialisations for LowSINRContext @@ -222,8 +268,6 @@ components: - IS_GREATER_THAN targetValueRange: type: integer - targetFulfilmentInfo: - $ref: "TS28312_IntentNrm.yaml#/components/schemas/FulfilmentInfo" AveDLRANUEThptTarget: description: >- This data type is the "ExpectationTarget" data type with specialisations for AveDLRANUEThptTarget @@ -239,8 +283,6 @@ components: - IS_GREATER_THAN targetValueRange: type: integer - targetFulfilmentInfo: - $ref: "TS28312_IntentNrm.yaml#/components/schemas/FulfilmentInfo" LowULRANUEThptRatioTarget: description: >- This data type is the "ExpectationTarget" data type with specialisations for LowULRANUEThptRatioTarget @@ -259,9 +301,7 @@ components: minimum: 0 maximum: 100 targetContexts: - $ref: "#/components/schemas/LowULRANUEThptContext" - targetFulfilmentInfo: - $ref: "TS28312_IntentNrm.yaml#/components/schemas/FulfilmentInfo" + $ref: '#/components/schemas/LowULRANUEThptContext' LowULRANUEThptContext: description: >- This data type is the "TargetContext" data type with specialisations for LowULRANUEThptContext @@ -295,9 +335,7 @@ components: minimum: 0 maximum: 100 targetContexts: - $ref: "#/components/schemas/LowDLRANUEThptContext" - targetFulfilmentInfo: - $ref: "TS28312_IntentNrm.yaml#/components/schemas/FulfilmentInfo" + $ref: '#/components/schemas/LowDLRANUEThptContext' LowDLRANUEThptContext: description: >- This data type is the "TargetContext" data type with specialisations for LowDLRANUEThptContext @@ -313,6 +351,142 @@ components: - IS_LESS_THAN contextValueRange: type: number + HighULPrbLoadRatioTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for HighULPrbLoadRatioTarget + type: object + properties: + targetName: + type: string + enum: + - HighULPrbLoadRatio + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + minimum: 0 + maximum: 100 + targetContexts: + $ref: '#/components/schemas/HighULPrbLoadContext' + HighULPrbLoadContext: + description: >- + This data type is the "TargetContext" data type with specialisations for HighULPrbLoadContext + type: object + properties: + contextAttribute: + type: string + enum: + - HighULPrbLoadThreshold + contextCondition: + type: string + enum: + - IS_LESS_THAN + contextValueRange: + type: integer + minimum: 0 + maximum: 100 + HighDLPrbLoadRatioTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for HighDLPrbLoadRatioTarget + type: object + properties: + targetName: + type: string + enum: + - HighDLPrbLoadRatio + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + minimum: 0 + maximum: 100 + targetContexts: + $ref: '#/components/schemas/HighDLPrbLoadContext' + HighDLPrbLoadContext: + description: >- + This data type is the "TargetContext" data type with specialisations for HighDLPrbLoadContext + type: object + properties: + contextAttribute: + type: string + enum: + - HighDLPrbLoadThreshold + contextCondition: + type: string + enum: + - IS_LESS_THAN + contextValueRange: + type: integer + minimum: 0 + maximum: 100 + AveULPrbLoadTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for AveULPrbLoadTarget + type: object + properties: + targetName: + type: string + enum: + - AveULPrbLoad + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + minimum: 0 + maximum: 100 + AveDLPrbLoadTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for AveDLPrbLoadTarget + type: object + properties: + targetName: + type: string + enum: + - AveDLPrbLoad + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + minimum: 0 + maximum: 100 + RANEnergyConsumptionTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for RANEnergyConsumptionTarget + type: object + properties: + targetName: + type: string + enum: + - RANEnergyConsumption + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + RANEnergyEfficiencyTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for RANEnergyEfficiencyTarget + type: object + properties: + targetName: + type: string + enum: + - RANEnergyEfficiency + targetCondition: + type: string + enum: + - IS_GREATER_THAN + targetValueRange: + type: integer DLThptPerUETarget: description: >- This data type is the "ExpectationTarget" data type with specialisations for DLThptPerUETarget @@ -327,7 +501,7 @@ components: enum: - IS_GREATER_THAN targetValueRange: - $ref: "TS28541_SliceNrm.yaml#/components/schemas/XLThpt" + $ref: 'TS28541_SliceNrm.yaml#/components/schemas/XLThpt' ULThptPerUETarget: description: >- This data type is the "ExpectationTarget" data type with specialisations for ULThptPerUETarget @@ -342,7 +516,7 @@ components: enum: - IS_GREATER_THAN targetValueRange: - $ref: "TS28541_SliceNrm.yaml#/components/schemas/XLThpt" + $ref: 'TS28541_SliceNrm.yaml#/components/schemas/XLThpt' DLLatencyTarget: description: >- This data type is the "ExpectationTarget" data type with specialisations for DLLatencyTarget @@ -418,6 +592,37 @@ components: - IS_LESS_THAN targetValueRange: type: integer + MaxNumberofPDUsessionsTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for MaxNumberofPDUsessionsTarget + type: object + properties: + targetName: + type: string + enum: + - MaxNumberofPDUsessions + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + MaxNumberofRegisteredsubscribersTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for MaxNumberofRegisteredsubscribersTarget + type: object + properties: + targetName: + type: string + enum: + - MaxNumberofRegisteredsubscribers + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + #-------Definition of the concrete ExpectationTarget dataType----------# #-------Definition of the concrete ObjectTarget dataType----------------# @@ -429,7 +634,7 @@ components: contextAttribute: type: string contextCondition: - $ref: "TS28312_IntentNrm.yaml#/components/schemas/Condition" + $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Condition' contextValueRange: type: array items: @@ -450,7 +655,7 @@ components: contextValueRange: type: array items: - $ref: "#/components/schemas/CoverageArea" + $ref: '#/components/schemas/CoverageArea' CoverageArea: type: string CoverageTACContext: @@ -469,7 +674,7 @@ components: contextValueRange: type: array items: - $ref: "TS28541_NrNrm.yaml#/components/schemas/NrTac" + $ref: 'TS28541_NrNrm.yaml#/components/schemas/NrTac' PLMNContext: description: >- This data type is the "ObjectContext" data type with specialisations for PLMNContext @@ -486,7 +691,7 @@ components: contextValueRange: type: array items: - $ref: "TS28623_ComDefs.yaml#/components/schemas/PlmnId" + $ref: 'TS28623_ComDefs.yaml#/components/schemas/PlmnId' NRFqBandContext: description: >- This data type is the "ObjectContext" data type with specialisations for NRFqBandContext @@ -525,9 +730,33 @@ components: - UTRAN - EUTRAN - NR + UEGroupContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for UEGroup([5QI, SNSSAI]) + type: object + properties: + contextAttribute: + type: string + enum: + - UEGroup + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + items: + $ref: "#/components/schemas/UEGroup" + UEGroup: + type: object + properties: + fiveQI: + type: integer + sNssai: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/Snssai' EdgeIdenfiticationIdContext: description: >- - This data type is the "ObjectContext" data type with specialisations for EdgeIdenfiticationIdContext + This data type is the "ObjectContext" data type with specialisations for EdgeIdentificationIdContext type: object properties: contextAttribute: @@ -542,9 +771,9 @@ components: type: array items: type: string - EdgeIdenfiticationLocContext: + EdgeIdentificationLocContext: description: >- - This data type is the "ObjectContext" data type with specialisations for EdgeIdenfiticationLocContext + This data type is the "ObjectContext" data type with specialisations for EdgeIdentificationLocContext type: object properties: contextAttribute: @@ -575,12 +804,64 @@ components: contextValueRange: type: array items: - $ref: "#/components/schemas/CoverageAreaTAList" + $ref: '#/components/schemas/CoverageAreaTAList' CoverageAreaTAList: type: integer + NfTypeContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for NfTypeContext + type: object + properties: + contextAttribute: + type: string + enum: + - NfType + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + items: + $ref: "TS28623_GenericNrm.yaml#/components/schemas/NFType" + NfInstanceLocationContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for NfInstanceLocationContext + type: object + properties: + contextAttribute: + type: string + enum: + - NfInstanceLocation + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + items: + type: string + TaiContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for TaiContext + type: object + properties: + contextAttribute: + type: string + enum: + - Tai + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + items: + $ref: "TS28623_GenericNrm.yaml#/components/schemas/Tai" + #-------Definition of the scenario specific ObjectTarget dataType----------------# - #-------Definition of the concrete ExpectionContext dataType----------------# + #-------Definition of the concrete ExpectationContext dataType----------------# ServiceStartTimeContext: description: >- This data type is the "ExpectationContext" data type with specialisations for ServiceStartTimeContext @@ -595,7 +876,7 @@ components: enum: - IS_EQUAL_TO contextValueRange: - type: string + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' ServiceEndTimeContext: description: >- This data type is the "ExpectationContext" data type with specialisations for ServiceEndTimeContext @@ -610,7 +891,7 @@ components: enum: - IS_EQUAL_TO contextValueRange: - type: string + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' UEMobilityLevelContext: description: >- This data type is the "ExpectationContext" data type with specialisations for UEMobilityLevelContext @@ -623,11 +904,9 @@ components: contextCondition: type: string enum: - - IS_WITHIN_RANGE + - IS_EQUAL_TO contextValueRange: - type: array - items: - $ref: "TS28541_SliceNrm.yaml#/components/schemas/MobilityLevel" + $ref: "TS28541_SliceNrm.yaml#/components/schemas/MobilityLevel" ResourceSharingLevelContext: description: >- This data type is the "ExpectationContext" data type with specialisations for ResourceSharingLevelContext @@ -640,9 +919,7 @@ components: contextCondition: type: string enum: - - IS_WITHIN_RANGE + - IS_EQUAL_TO contextValueRange: - type: array - items: - $ref: "TS28541_SliceNrm.yaml#/components/schemas/SharingLevel" + $ref: "TS28541_SliceNrm.yaml#/components/schemas/SharingLevel" #-------Definition of the concrete ExpectionContext dataType----------------# diff --git a/TS28312_IntentNrm.yaml b/TS28312_IntentNrm.yaml index bd3c83c2..90016741 100644 --- a/TS28312_IntentNrm.yaml +++ b/TS28312_IntentNrm.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: Intent NRM - version: 18.0.0 + version: 18.1.0 description: >- OAS 3.0.1 definition of the Intent NRM © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -27,8 +27,8 @@ components: properties: SubNetwork: $ref: '#/components/schemas/SubNetwork-Multiple' - Intent: - $ref: '#/components/schemas/Intent-Multiple' + IntentHandlingFunction: + $ref: '#/components/schemas/IntentHandlingFunction-Multiple' Intent-Single: allOf: @@ -44,13 +44,56 @@ components: oneOf: - $ref: "#/components/schemas/IntentExpectation" - $ref: "TS28312_IntentExpectations.yaml#/components/schemas/RadioNetworkExpectation" - - $ref: "TS28312_IntentExpectations.yaml#/components/schemas/ServiceSupportExpectation" + - $ref: "TS28312_IntentExpectations.yaml#/components/schemas/EdgeServiceSupportExpectation" intentContexts: type: array items: - $ref: "#/components/schemas/IntentContext" - intentFulfilmentInfo: - $ref: "#/components/schemas/FulfilmentInfo" + $ref: '#/components/schemas/IntentContext' + intentAdminState: + type: string + enum: + - ACTIVATED + - DEACTIVATED + intentPriority: + type: integer + observationPeriod: + type: integer + intentReportReference: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' + IntentReport-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + intentFulfilmentReport: + type: array + items: + $ref: '#/components/schemas/IntentFulfilmentReport' + intentConflictReports: + type: array + items: + $ref: '#/components/schemas/IntentConflictReport' + intentFeasibilityCheckReport: + type: array + items: + $ref: '#/components/schemas/IntentFeasibilityCheckReport' + intentReference: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' + + IntentHandlingFunction-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + intentHandlingCapabilityList: + type: array + items: + $ref: '#/components/schemas/IntentHandlingCapability' + Intent: + $ref: '#/components/schemas/Intent-Multiple' + IntentReport: + $ref: '#/components/schemas/IntentReport-Multiple' + #-------Definition of generic IOCs ----------# #-------Definition of the generic IntentExpectation dataType ----------# @@ -63,20 +106,16 @@ components: type: string expectationVerb: $ref: "#/components/schemas/ExpectationVerb" - expectationObjects: - type: array - items: - $ref: "#/components/schemas/ExpectationObject" + expectationObject: + $ref: "#/components/schemas/ExpectationObject" expectationTargets: type: array items: - $ref: "#/components/schemas/ExpectationTarget" + $ref: '#/components/schemas/ExpectationTarget' expectationContexts: type: array items: - $ref: "#/components/schemas/ExpectationContext" - expectationfulfilmentInfo: - $ref: "#/components/schemas/FulfilmentInfo" + $ref: '#/components/schemas/ExpectationContext' required: - expectationId #-------Definition of the generic IntentExpectation dataType ----------# @@ -91,14 +130,13 @@ components: type: string enum: - RAN_SubNetwork #value for Radio Network Expectation--# - - Service_Support #value for Service Support Expectation--# - - TBD #-This will be added based on defined scenario specfic intent expectation-# + - Edge_Service_Support #value for Edge Service Support Expectation--# objectInstance: - $ref: "TS28623_ComDefs.yaml#/components/schemas/Dn" + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' objectContexts: type: array items: - $ref: "#/components/schemas/ObjectContext" + $ref: '#/components/schemas/ObjectContext' #-------Definition of the generic ExpectationObject dataType ----------# @@ -136,7 +174,7 @@ components: type: object properties: fulfilStatus: - $ref: "#/components/schemas/FulfilStatus" + $ref: '#/components/schemas/FulfilStatus' notFullfilledState: description: -> An attribute which is used when FulfilmentInfo is implemented for IntentFulfilmentInfo @@ -151,6 +189,17 @@ components: enum: - DELIVER - ENSURE + ValueRangeType: + oneOf: + - type: number + - type: string + - type: boolean + - type: integer + - $ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow' + - $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' + - $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoArea' + - $ref: 'TS28623_ComDefs.yaml#/components/schemas/PlmnId' + - $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoCoordinate' #-------Definition of the generic dataType --------------# #-------Definition of the generic IntentContext dataType --------------# @@ -162,11 +211,13 @@ components: contextAttribute: type: string contextCondition: - $ref: "#/components/schemas/Condition" + $ref: '#/components/schemas/Condition' contextValueRange: - type: array - items: - type: number + oneOf: + - type: array + items: + $ref: "#/components/schemas/ValueRangeType" + - $ref: "#/components/schemas/ValueRangeType" #-------Definition of the generic IntentContext dataType --------------# #-------Definition of the generic ExpectationTarget dataType----------# @@ -178,13 +229,17 @@ components: targetName: type: string targetCondition: - $ref: "#/components/schemas/Condition" + $ref: '#/components/schemas/Condition' targetValueRange: - type: number + oneOf: + - type: array + items: + $ref: "#/components/schemas/ValueRangeType" + - $ref: "#/components/schemas/ValueRangeType" targetContexts: type: array items: - $ref: "#/components/schemas/TargetContext" + $ref: '#/components/schemas/TargetContext' TargetContext: description: >- This data type is the "TargetContext" data type without specialisations @@ -193,9 +248,13 @@ components: contextAttribute: type: string contextCondition: - $ref: "#/components/schemas/Condition" + $ref: '#/components/schemas/Condition' contextValueRange: - type: number + oneOf: + - type: array + items: + $ref: "#/components/schemas/ValueRangeType" + - $ref: "#/components/schemas/ValueRangeType" #-------Definition of the generic ExpectationTarget dataType----------# #-------Definition of the generic ObjectContext dataType----------------# @@ -207,11 +266,13 @@ components: contextAttribute: type: string contextCondition: - $ref: "#/components/schemas/Condition" + $ref: '#/components/schemas/Condition' contextValueRange: - type: array - items: - type: number + oneOf: + - type: array + items: + $ref: "#/components/schemas/ValueRangeType" + - $ref: "#/components/schemas/ValueRangeType" #-------Definition of the generic ObjectContext dataType----------------# #-------Definition of the generic ExpectionContext dataType----------------# @@ -223,13 +284,108 @@ components: contextAttribute: type: string contextCondition: - $ref: "#/components/schemas/Condition" + $ref: '#/components/schemas/Condition' contextValueRange: + oneOf: + - type: array + items: + $ref: "#/components/schemas/ValueRangeType" + - $ref: "#/components/schemas/ValueRangeType" + #-------Definition of the concrete ExpectionContext dataType----------------# + #-------Definition of the generic IntentFulfilmentReport dataType----------------# + IntentFulfilmentReport: + description: >- + This data type is the "IntentFulfilmentReport" data type without specialisations + type: object + properties: + intentFulfilmentInfo: + $ref: '#/components/schemas/FulfilmentInfo' + expectationFulfilmentResult: + type: array + items: + $ref: '#/components/schemas/ExpectationFulfilmentResult' + #-------Definition of the concrete IntentFulfilmentReport dataType----------------# + + #-------Definition of the generic ExpectationFulfilmentResult dataType----------------# + ExpectationFulfilmentResult: + description: >- + This data type is the "ExpectationFulfilmentResult" data type without specialisations + type: object + properties: + expectaitonId: + type: string + expectationFulfilmentInfo: + $ref: '#/components/schemas/FulfilmentInfo' + targetFulfilmentResult: + type: array + items: + $ref: '#/components/schemas/TargetFulfilmentResult' + #-------Definition of the concrete ExpectationFulfilmentResult dataType----------------# + + #-------Definition of the generic TargetFulfilmentResult dataType----------------# + TargetFulfilmentResult: + description: >- + This data type is the "TargetFulfilmentResult" data type without specialisations + type: object + properties: + targetName: + type: string + targetFulfilmentInfo: + $ref: '#/components/schemas/FulfilmentInfo' + targetAchievedValue: + type: number + #-------Definition of the concrete TargetFulfilmentResult dataType----------------# + + #-------Definition of the generic IntentConflictReport dataType----------------# + IntentConflictReport: + description: >- + This data type is the "IntentConflictReport" data type without specialisations + type: object + properties: + conflictType: + type: string + enum: + - INTENT_CONFLICT + - EXPECTATION_CONFLICT + - TARGET_CONFLICT + conflictField: + type: string + #-------Definition of the concrete IntentConflictReport dataType----------------# + + #-------Definition of the generic IntentFeasibilityCheckReport dataType----------------# + IntentFeasibilityCheckReport: + description: >- + This data type is the "IntentFeasibilityCheckReport" data type without specialisations + type: object + properties: + feasibilityCheckResult: + type: string + enum: + - FEASIBLE + - INFEASIBLE + infeasibilityReason: + description: -> + An attribute which is used when feasibilityCheckResult is INFEASIBLE + type: string + #-------Definition of the concrete IntentFeasibilityCheckReport dataType----------------# + + #-------Definition of the generic IntentHandlingCapability dataType----------------# + IntentHandlingCapability: + type: object + properties: + intentHandlingCapabilityId: + type: string + supportedExpectationObjectType: + type: string + enum: + - RAN_SUBNETWORK + - EDGE_SERVICE_SUPPORT + supportedExpectationTargetType: type: array items: - type: number - #-------Definition of the concrete ExpectionContext dataType----------------# - + $ref: "#/components/schemas/ExpectationTarget" + #-------Definition of the concrete IntentHandlingCapability dataType----------------# + #------Definition of JSON arrays for name-contained IOCs ---------------# SubNetwork-Multiple: @@ -240,7 +396,19 @@ components: Intent-Multiple: type: array items: - $ref: '#/components/schemas/Intent-Single' + $ref: '#/components/schemas/Intent-Single' + + IntentReport-Multiple: + type: array + items: + $ref: '#/components/schemas/IntentReport-Single' + + IntentHandlingFunction-Multiple: + type: array + items: + $ref: '#/components/schemas/IntentHandlingFunction-Single' + + #------Definition of JSON arrays for name-contained IOCs ---------------# #----- Definitions in TS 28.312 for TS 28.532 --------------------------# diff --git a/TS28532_FaultMnS.yaml b/TS28532_FaultMnS.yaml index fdb9a540..2891cb22 100644 --- a/TS28532_FaultMnS.yaml +++ b/TS28532_FaultMnS.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: Fault Supervision MnS - version: 17.2.0 + version: 17.3.0 description: >- OAS 3.0.1 definition of the Fault Supervision MnS © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -135,7 +135,7 @@ paths: patch: summary: 'Clear, acknowledge or unacknowledge a single alarm' description: >- - Clears, acknowledges or uncknowldeges a single alarm by patching the alarm + Clears, acknowledges or unacknowldeges a single alarm by patching the alarm information. A conditional acknowledge request based on the perceived severity is not supported. parameters: @@ -792,6 +792,7 @@ components: required: - alarmId - alarmType + - probableCause properties: alarmId: $ref: '#/components/schemas/AlarmId' @@ -834,6 +835,7 @@ components: required: - alarmId - alarmType + - probableCause - serviceUser - serviceProvider - securityAlarmDetector @@ -961,7 +963,7 @@ components: MergePatchAcknowledgeAlarm: description: >- Patch document acknowledging or unacknowledging a single alarm. For - acknowleding an alarm the value of ackState is ACKNOWLEDGED, for unacknowleding + acknowledging an alarm the value of ackState is ACKNOWLEDGED, for unacknowledging an alarm the value of ackState is UNACKNOWLEDGED. type: object required: diff --git a/TS28532_FileDataReportingMnS.yaml b/TS28532_FileDataReportingMnS.yaml index 0690f006..27c5a23b 100644 --- a/TS28532_FileDataReportingMnS.yaml +++ b/TS28532_FileDataReportingMnS.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: File Data Reporting MnS - version: 17.1.0 + version: 17.3.0 description: >- OAS 3.0.1 definition of the File Data Reporting MnS © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -179,7 +179,7 @@ components: enum: - Performance - Trace - - Anatytics + - Analytics - Proprietary FileNotificationTypes: type: string diff --git a/TS28532_ProvMnS.yaml b/TS28532_ProvMnS.yaml index f2cacf0e..7b734bc7 100644 --- a/TS28532_ProvMnS.yaml +++ b/TS28532_ProvMnS.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: Provisioning MnS - version: 17.5.0 + version: 17.6.0 description: >- OAS 3.0.1 definition of the Provisioning MnS © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -52,7 +52,7 @@ paths: This status code shall be returned when the resource is replaced, and when the replaced resource representation is not identical to the resource representation in the request. - This status code may be retourned when the resource is updated and when the + This status code may be returned when the resource is updated and when the updated resource representation is identical to the resource representation in the request. The representation of the updated resource is returned in the response @@ -205,7 +205,7 @@ paths: description: >- This parameter specifies the attributes of the scoped resources that are returned. - required: true + required: false schema: type: array items: diff --git a/TS28541_5GcNrm.yaml b/TS28541_5GcNrm.yaml index 7eeb11a6..4cf5ec97 100644 --- a/TS28541_5GcNrm.yaml +++ b/TS28541_5GcNrm.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: 3GPP 5GC NRM - version: 18.4.0 + version: 18.5.0 description: >- OAS 3.0.1 specification of the 5GC NRM © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -112,7 +112,7 @@ components: $ref: 'TS28541_NrNrm.yaml#/components/schemas/Snssai' NFStatus: type: string - description: any of enumrated value + description: any of enumerated value enum: - REGISTERED - SUSPENDED @@ -126,7 +126,7 @@ components: TACList: type: array items: - $ref: 'TS28541_NrNrm.yaml#/components/schemas/NrTac' + $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Tac' WeightFactor: type: integer AusfInfo: @@ -152,7 +152,7 @@ components: minItems: 1 SupportedDataSet: type: string - description: any of enumrated value + description: any of enumerated value enum: - SUBSCRIPTION - POLICY @@ -190,7 +190,7 @@ components: type: string n1MessageClass: type: boolean - n2InfroamtionClass: + n2InformationClass: type: boolean versions: type: string @@ -273,7 +273,7 @@ components: type: string SEPPType: type: string - description: any of enumrated value + description: any of enumerated value enum: - CSEPP - PSEPP @@ -290,7 +290,7 @@ components: $ref: '#/components/schemas/SupportedFunc' CommModelType: type: string - description: any of enumrated value + description: any of enumerated value enum: - DIRECT_COMMUNICATION_WO_NRF - DIRECT_COMMUNICATION_WITH_NRF @@ -533,9 +533,9 @@ components: enum: - INACTIVE - ACTIVE - activeEacThreshhold: + activeEacThreshold: type: integer - deactiveEacThreshhold: + deactiveEacThreshold: type: integer numberofUEs: type: integer @@ -594,7 +594,7 @@ components: items: type: string - SNssaiSmfInfoItem: + SnssaiSmfInfoItem: type: object properties: sNSSAI: @@ -653,7 +653,7 @@ components: TaiList: type: array items: - $ref: 'TS28541_NrNrm.yaml#/components/schemas/Tai' + $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Tai' SupiRange: type: object properties: @@ -675,7 +675,7 @@ components: ProseCapability: type: object properties: - proseDirectDiscovey: + proseDirectDiscovery: type: boolean proseDirectCommunication: type: boolean @@ -1494,6 +1494,264 @@ components: secondaryChfInstance: $ref: 'TS29571_CommonData.yaml#/components/schemas/NfInstanceId' + AmfInfo: + description: Information of an AMF NF Instance + type: object + # required: + # - amfSetId + # - amfRegionId + # - guamiList + properties: + # amfSetId: + # $ref: 'TS29571_CommonData.yaml#/components/schemas/AmfSetId' + # amfRegionId: + # $ref: 'TS29571_CommonData.yaml#/components/schemas/AmfRegionId' + guamiList: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Guami' + minItems: 1 + taiList: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Tai' + minItems: 1 + taiRangeList: + type: array + items: + $ref: '#/components/schemas/TaiRange' + minItems: 1 + backupInfoAmfFailure: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Guami' + minItems: 1 + backupInfoAmfRemoval: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Guami' + minItems: 1 + # n2InterfaceAmfInfo: + # $ref: '#/components/schemas/N2InterfaceAmfInfo' + # amfOnboardingCapability: + # type: boolean + # default: false + # highLatencyCom: + # type: boolean + + SmfInfo: + description: Information of an SMF NF Instance + type: object + required: + - sNssaiSmfInfoList + properties: + sNssaiSmfInfoList: + type: array + items: + $ref: '#/components/schemas/SnssaiSmfInfoItem' + minItems: 1 + taiList: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Tai' + minItems: 1 + taiRangeList: + type: array + items: + $ref: '#/components/schemas/TaiRange' + minItems: 1 + pgwFqdn: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Fqdn' + pgwIpAddrList: + type: array + items: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/IpAddr' + minItems: 1 + accessType: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/AccessType' + minItems: 1 + priority: + type: integer + minimum: 0 + maximum: 65535 + vsmfSupportInd: + type: boolean + pgwFqdnList: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Fqdn' + minItems: 1 + # smfOnboardingCapability: + # type: boolean + # default: false + # deprecated: true + # ismfSupportInd: + # type: boolean + # smfUPRPCapability: + # type: boolean + # default: false + + UpfInfo: + description: Information of an UPF NF Instance + type: object + # required: + # - sNssaiUpfInfoList + properties: + # sNssaiUpfInfoList: + # type: array + # items: + # $ref: '#/components/schemas/SnssaiUpfInfoItem' + # minItems: 1 + smfServingArea: + type: array + items: + type: string + minItems: 1 + interfaceUpfInfoList: + type: array + items: + $ref: '#/components/schemas/InterfaceUpfInfoItem' + minItems: 1 + iwkEpsInd: + type: boolean + default: false + # sxaInd: + # type: boolean + pduSessionTypes: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/PduSessionType' + minItems: 1 + atsssCapability: + $ref: 'TS29571_CommonData.yaml#/components/schemas/AtsssCapability' + ueIpAddrInd: + type: boolean + default: false + taiList: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Tai' + minItems: 1 + taiRangeList: + type: array + items: + $ref: '#/components/schemas/TaiRange' + minItems: 1 + wAgfInfo: + # $ref: '#/components/schemas/WAgfInfo' + $ref: '#/components/schemas/IpInterface' + tngfInfo: + # $ref: '#/components/schemas/TngfInfo' + $ref: '#/components/schemas/IpInterface' + twifInfo: + # $ref: '#/components/schemas/TwifInfo' + $ref: '#/components/schemas/IpInterface' + priority: + type: integer + minimum: 0 + maximum: 65535 + redundantGtpu: + type: boolean + default: false + ipups: + type: boolean + default: false + dataForwarding: + type: boolean + default: false + supportedPfcpFeatures: + type: string + # upfEvents: + # type: array + # items: + # $ref: 'TS29564_Nupf_EventExposure.yaml#/components/schemas/EventType' + # minItems: 1 + + PcfInfo: + description: Information of a PCF NF Instance + type: object + properties: + groupId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/NfGroupId' + dnnList: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' + minItems: 1 + supiRanges: + type: array + items: + $ref: '#/components/schemas/SupiRange' + minItems: 1 + gpsiRanges: + type: array + items: + $ref: '#/components/schemas/IdentityRange' + minItems: 1 + rxDiamHost: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DiameterIdentity' + rxDiamRealm: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DiameterIdentity' + v2xSupportInd: + type: boolean + default: false + proseSupportInd: + type: boolean + default: false + proseCapability: + $ref: '#/components/schemas/ProseCapability' + v2xCapability: + $ref: '#/components/schemas/V2xCapability' + + NefInfo: + description: Information of an NEF NF Instance + type: object + properties: + nefId: + # $ref: '#/components/schemas/NefId' + type: string + pfdData: + $ref: '#/components/schemas/PfdData' + afEeData: + $ref: '#/components/schemas/AfEventExposureData' + gpsiRanges: + type: array + items: + $ref: '#/components/schemas/IdentityRange' + minItems: 1 + externalGroupIdentifiersRanges: + type: array + items: + $ref: '#/components/schemas/IdentityRange' + minItems: 1 + servedFqdnList: + type: array + items: + type: string + minItems: 1 + taiList: + $ref: '#/components/schemas/TaiList' + taiRangeList: + type: array + items: + $ref: '#/components/schemas/TaiRange' + minItems: 1 + dnaiList: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnai' + minItems: 1 + unTrustAfInfoList: + type: array + items: + $ref: '#/components/schemas/UnTrustAfInfo' + minItems: 1 + uasNfFunctionalityInd: + type: boolean + default: false + NrfInfo: description: Information of an NRF NF Instance, used in hierarchical NRF deployments type: object @@ -1506,6 +1764,18 @@ components: - $ref: '#/components/schemas/UdrInfo' - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' minProperties: 1 + servedUdrInfoList: + description: A map (list of key-value pairs) where nfInstanceId serves as key + type: object + additionalProperties: + description: A map (list of key-value pairs) where a valid JSON string serves as key + type: object + additionalProperties: + anyOf: + - $ref: '#/components/schemas/UdrInfo' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + minProperties: 1 + minProperties: 1 servedUdmInfo: description: A map (list of key-value pairs) where nfInstanceId serves as key type: object @@ -1514,6 +1784,18 @@ components: - $ref: '#/components/schemas/UdmInfo' - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' minProperties: 1 + servedUdmInfoList: + description: A map (list of key-value pairs) where nfInstanceId serves as key + type: object + additionalProperties: + description: A map (list of key-value pairs) where a valid JSON string serves as key + type: object + additionalProperties: + anyOf: + - $ref: '#/components/schemas/UdmInfo' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + minProperties: 1 + minProperties: 1 servedAusfInfo: description: A map (list of key-value pairs) where nfInstanceId serves as key type: object @@ -1522,6 +1804,146 @@ components: - $ref: '#/components/schemas/AusfInfo' - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' minProperties: 1 + servedAusfInfoList: + description: A map (list of key-value pairs) where nfInstanceId serves as key + type: object + additionalProperties: + description: A map (list of key-value pairs) where a valid JSON string serves as key + type: object + additionalProperties: + anyOf: + - $ref: '#/components/schemas/AusfInfo' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + minProperties: 1 + minProperties: 1 + servedAmfInfo: + description: A map (list of key-value pairs) where nfInstanceId serves as key + type: object + additionalProperties: + anyOf: + - $ref: '#/components/schemas/AmfInfo' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + minProperties: 1 + servedAmfInfoList: + description: A map (list of key-value pairs) where nfInstanceId serves as key + type: object + additionalProperties: + description: A map (list of key-value pairs) where a valid JSON string serves as key + type: object + additionalProperties: + anyOf: + - $ref: '#/components/schemas/AmfInfo' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + minProperties: 1 + minProperties: 1 + servedSmfInfo: + description: A map (list of key-value pairs) where nfInstanceId serves as key + type: object + additionalProperties: + anyOf: + - $ref: '#/components/schemas/SmfInfo' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + minProperties: 1 + servedSmfInfoList: + description: A map (list of key-value pairs) where nfInstanceId serves as key + type: object + additionalProperties: + description: A map (list of key-value pairs) where a valid JSON string serves as key + type: object + additionalProperties: + anyOf: + - $ref: '#/components/schemas/SmfInfo' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + minProperties: 1 + minProperties: 1 + servedUpfInfo: + description: A map (list of key-value pairs) where nfInstanceId serves as key + type: object + additionalProperties: + anyOf: + - $ref: '#/components/schemas/UpfInfo' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + minProperties: 1 + servedUpfInfoList: + description: A map (list of key-value pairs) where nfInstanceId serves as key + type: object + additionalProperties: + description: A map (list of key-value pairs) where a valid JSON string serves as key + type: object + additionalProperties: + anyOf: + - $ref: '#/components/schemas/UpfInfo' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + minProperties: 1 + minProperties: 1 + servedPcfInfo: + description: A map (list of key-value pairs) where nfInstanceId serves as key + type: object + additionalProperties: + anyOf: + - $ref: '#/components/schemas/PcfInfo' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + minProperties: 1 + servedPcfInfoList: + description: A map (list of key-value pairs) where nfInstanceId serves as key + type: object + additionalProperties: + description: A map (list of key-value pairs) where a valid JSON string serves as key + type: object + additionalProperties: + anyOf: + - $ref: '#/components/schemas/PcfInfo' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + minProperties: 1 + minProperties: 1 + # servedBsfInfo: + # description: A map (list of key-value pairs) where nfInstanceId serves as key + # type: object + # additionalProperties: + # anyOf: + # - $ref: '#/components/schemas/BsfInfo' + # - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + # minProperties: 1 + # servedBsfInfoList: + # description: A map (list of key-value pairs) where nfInstanceId serves as key + # type: object + # additionalProperties: + # description: A map (list of key-value pairs) where a valid JSON string serves as key + # type: object + # additionalProperties: + # anyOf: + # - $ref: '#/components/schemas/BsfInfo' + # - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + # minProperties: 1 + # minProperties: 1 + servedChfInfo: + description: A map (list of key-value pairs) where nfInstanceId serves as key + type: object + additionalProperties: + anyOf: + - $ref: '#/components/schemas/ChfInfo' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + minProperties: 1 + servedChfInfoList: + description: A map (list of key-value pairs) where nfInstanceId serves as key + type: object + additionalProperties: + description: A map (list of key-value pairs) where a valid JSON string serves as key + type: object + additionalProperties: + anyOf: + - $ref: '#/components/schemas/ChfInfo' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + minProperties: 1 + minProperties: 1 + servedNefInfo: + description: A map (list of key-value pairs) where nfInstanceId serves as key + type: object + additionalProperties: + anyOf: + - $ref: '#/components/schemas/NefInfo' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + minProperties: 1 servedNwdafInfo: description: A map (list of key-value pairs) where nfInstanceId serves as key type: object @@ -1530,6 +1952,36 @@ components: - $ref: '#/components/schemas/NwdafInfo' - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' minProperties: 1 + servedNwdafInfoList: + type: object + description: A map (list of key-value pairs) where NF Instance Id serves as key + additionalProperties: + type: object + description: A map (list of key-value pairs) where a valid JSON string serves as key + additionalProperties: + $ref: '#/components/schemas/NwdafInfo' + minProperties: 1 + minProperties: 1 + # servedPcscfInfoList: + # description: A map (list of key-value pairs) where nfInstanceId serves as key + # type: object + # additionalProperties: + # description: A map (list of key-value pairs) where a valid JSON string serves as key + # type: object + # additionalProperties: + # anyOf: + # - $ref: '#/components/schemas/PcscfInfo' + # - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + # minProperties: 1 + # minProperties: 1 + # servedGmlcInfo: + # description: A map (list of key-value pairs) where nfInstanceId serves as key + # type: object + # additionalProperties: + # anyOf: + # - $ref: '#/components/schemas/GmlcInfo' + # - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + # minProperties: 1 servedLmfInfo: description: A map (list of key-value pairs) where nfInstanceId serves as key type: object @@ -1538,6 +1990,24 @@ components: - $ref: '#/components/schemas/LmfInfo' - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' minProperties: 1 + # servedNfInfo: + # description: A map (list of key-value pairs) where nfInstanceId serves as key + # type: object + # additionalProperties: + # $ref: '#/components/schemas/NfInfo' + # minProperties: 1 + # servedHssInfoList: + # description: A map (list of key-value pairs) where nfInstanceId serves as key + # type: object + # additionalProperties: + # description: A map (list of key-value pairs) where a valid JSON string serves as key + # type: object + # additionalProperties: + # anyOf: + # - $ref: '#/components/schemas/HssInfo' + # - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + # minProperties: 1 + # minProperties: 1 servedUdsfInfo: description: A map (list of key-value pairs) where nfInstanceId serves as key type: object @@ -1546,6 +2016,34 @@ components: - $ref: '#/components/schemas/UdsfInfo' - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' minProperties: 1 + servedUdsfInfoList: + description: A map (list of key-value pairs) where nfInstanceId serves as key + type: object + additionalProperties: + description: A map (list of key-value pairs) where a valid JSON string serves as key + type: object + additionalProperties: + anyOf: + - $ref: '#/components/schemas/UdsfInfo' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + minProperties: 1 + minProperties: 1 + servedScpInfoList: + description: A map (list of key-value pairs) where nfInstanceId serves as key + type: object + additionalProperties: + anyOf: + - $ref: '#/components/schemas/ScpInfo' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + minProperties: 1 + servedSeppInfoList: + description: A map (list of key-value pairs) where nfInstanceId serves as key + type: object + additionalProperties: + anyOf: + - $ref: '#/components/schemas/SeppInfo' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/EmptyObject' + minProperties: 1 servedTrustAfInfo: type: object description: A map (list of key-value pairs) where NF Instance Id serves as key @@ -1558,6 +2056,150 @@ components: additionalProperties: $ref: '#/components/schemas/NssaafInfo' minProperties: 1 + NTNPLMNRestrictionsInfo: + description: restrictions per PLMN that relates to non-terrestrial network access + type: object + properties: + pLMNId: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/PlmnId' + blockedLocationInfoList: + type: array + items: + $ref: '#/components/schemas/BlockedLocationInfoList' + minItems: 1 + BlockedLocationInfoList: + description: location for which the PLMN access restrictions are to be applied in case of NTN + type: object + properties: + blockedLocation: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/PlmnId' + blockedDur: + $ref: '#/components/schemas/TimeDuration' + blockedSlice: + type: string + TimeDuration: + description: location for which the PLMN access restrictions are to be applied in case of NTN + type: object + properties: + blockedDurStartTime: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' + blockedDurEndTime: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' + + GmlcInfo: + description: Information of a GMLC NF Instance + type: object + properties: + servingClientTypes: + type: array + items: + $ref: '#/components/schemas/ExternalClientType' + gmlcNumbers: + type: array + items: + type: string + pattern: '^[0-9]{5,15}$' + + SnssaiTsctsfInfoItem: + description: Set of parameters supported by TSCTSF for a given S-NSSAI + type: object + required: + - sNssai + - dnnInfoList + properties: + sNssai: + $ref: 'TS29571_CommonData.yaml#/components/schemas/ExtSnssai' + dnnInfoList: + type: array + items: + $ref: '#/components/schemas/DnnTsctsfInfoItem' + minItems: 1 + DnnTsctsfInfoItem: + description: Parameters supported by an TSCTSF for a given DNN + type: object + required: + - dnn + properties: + dnn: + anyOf: + - $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' + - $ref: 'TS29571_CommonData.yaml#/components/schemas/WildcardDnn' + TsctsfInfo: + description: Information of a TSCTSF NF Instance + type: object + properties: + sNssaiInfoList: + description: A map (list of key-value pairs) where a valid JSON string serves as key + additionalProperties: + $ref: '#/components/schemas/SnssaiTsctsfInfoItem' + minProperties: 0 + externalGroupIdentifiersRanges: + type: array + items: + $ref: '#/components/schemas/IdentityRange' + supiRanges: + type: array + items: + $ref: '#/components/schemas/SupiRange' + gpsiRanges: + type: array + items: + $ref: '#/components/schemas/IdentityRange' + internalGroupIdentifiersRanges: + type: array + items: + $ref: '#/components/schemas/InternalGroupIdRange' + + BsfInfo: + description: Information of a BSF NF Instance + type: object + properties: + dnnList: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' + minItems: 0 + ipDomainList: + type: array + items: + type: string + minItems: 0 + ipv4AddressRanges: + type: array + items: + $ref: '#/components/schemas/Ipv4AddressRange' + minItems: 0 + ipv6PrefixRanges: + type: array + items: + $ref: '#/components/schemas/Ipv6PrefixRange' + minItems: 0 + rxDiamHost: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DiameterIdentity' + rxDiamRealm: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DiameterIdentity' + groupId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/NfGroupId' + supiRanges: + type: array + items: + $ref: '#/components/schemas/SupiRange' + minItems: 0 + gpsiRanges: + type: array + items: + $ref: '#/components/schemas/IdentityRange' + minItems: 0 + + AanfInfo: + description: Represents the information relative to an AAnF NF Instance. + type: object + properties: + routingIndicators: + type: array + items: + type: string + pattern: '^[0-9]{1,4}$' #-------- Definition of concrete IOCs -------------------------------------------- ProvMnS: @@ -1668,6 +2310,14 @@ components: $ref: '#/components/schemas/ChfFunction-Multiple' MFAFFunction: $ref: '#/components/schemas/MfafFunction-Multiple' + GMLCFunction: + $ref: '#/components/schemas/GmlcFunction-Multiple' + TSCTSFFunction: + $ref: '#/components/schemas/TsctsfFunction-Multiple' + AANFFunction: + $ref: '#/components/schemas/AanfFunction-Multiple' + BSFFunction: + $ref: '#/components/schemas/BsfFunction-Multiple' AmfFunction-Single: allOf: @@ -1687,34 +2337,20 @@ components: type: string interPlmnFQDN: type: string - taiList: - $ref: '#/components/schemas/TaiList' - taiRangeList: - type: array - items: - $ref: '#/components/schemas/TaiRange' weightFactor: $ref: '#/components/schemas/WeightFactor' cNSIIdList: $ref: '#/components/schemas/CNSIIdList' - gUAMIdList: - type: array - items: - $ref: '#/components/schemas/GUAMInfo' - backupInfoAmfFailure: - type: array - items: - $ref: '#/components/schemas/GUAMInfo' - backupInfoAmfRemoval: - type: array - items: - $ref: '#/components/schemas/GUAMInfo' amfSetRef: $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' managedNFProfile: $ref: '#/components/schemas/ManagedNFProfile' commModelList: $ref: '#/components/schemas/CommModelList' + nTNPLMNInfoList: + $ref: '#/components/schemas/NTNPLMNRestrictionsInfo' + amfInfo: + $ref: '#/components/schemas/AmfInfo' - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-ncO' - type: object properties: @@ -1740,14 +2376,16 @@ components: $ref: '#/components/schemas/EP_N26-Multiple' EP_NLS: $ref: '#/components/schemas/EP_NLS-Multiple' - EP_NLG: - $ref: '#/components/schemas/EP_NLG-Multiple' + EP_NL2: + $ref: '#/components/schemas/EP_NL2-Multiple' EP_N58: $ref: '#/components/schemas/EP_N58-Multiple' EP_N41: $ref: '#/components/schemas/EP_N41-Multiple' EP_N42: $ref: '#/components/schemas/EP_N42-Multiple' + EP_N89: + $ref: '#/components/schemas/EP_N89-Multiple' AmfSet-Single: allOf: - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' @@ -1806,43 +2444,18 @@ components: $ref: '#/components/schemas/TACList' sBIFqdn: type: string - sNssaiSmfInfoList: - type: array - items: - $ref: '#/components/schemas/SNssaiSmfInfoItem' - taiList: - $ref: '#/components/schemas/TaiList' - taiRangeList: - type: array - items: - $ref: '#/components/schemas/TaiRange' - pwgFqdn: - type: string - pgwAddrList: - type: array - items: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/IpAddr' - accessType: - $ref: 'TS29571_CommonData.yaml#/components/schemas/AccessType' - priority: - type: integer cNSIIdList: $ref: '#/components/schemas/CNSIIdList' - vsmfSupportInd: - type: boolean - pwgFqdnList: - type: array - items: - type: string managedNFProfile: $ref: '#/components/schemas/ManagedNFProfile' commModelList: $ref: '#/components/schemas/CommModelList' + SmfInfo: + $ref: '#/components/schemas/SmfInfo' configurable5QISetRef: $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' dynamic5QISetRef: $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' - - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-ncO' - type: object properties: @@ -1860,6 +2473,8 @@ components: $ref: '#/components/schemas/EP_S5C-Multiple' EP_N40: $ref: '#/components/schemas/EP_N40-Multiple' + EP_N88: + $ref: '#/components/schemas/EP_N88-Multiple' FiveQiDscpMappingSet: $ref: '#/components/schemas/FiveQiDscpMappingSet-Single' GtpUPathQoSMonitoringControl: @@ -1885,52 +2500,12 @@ components: $ref: '#/components/schemas/TACList' cNSIIdList: $ref: '#/components/schemas/CNSIIdList' - smfServingArea: - type: string - interfaceUpfInfoList: - type: array - items: - $ref: '#/components/schemas/InterfaceUpfInfoItem' - iwkEpsInd: - type: boolean - pduSessionTypes: - type: string - enum: - - IPV4 - - IPV6 - - IPV4V6 - - UNSTRUCTURED - - ETHERNET - atsssCapability: - $ref: '#/components/schemas/AtsssCapability' - ueIpAddrInd: - type: boolean - taiList: - $ref: '#/components/schemas/TaiList' - taiRangeList: - type: array - items: - $ref: '#/components/schemas/TaiRange' - wAgfInfo: - $ref: '#/components/schemas/IpInterface' - tngfInfo: - $ref: '#/components/schemas/IpInterface' - twifInfo: - $ref: '#/components/schemas/IpInterface' - priority: - type: integer - redundantGtpu: - type: boolean - ipups: - type: boolean - dataForwarding: - type: boolean - supportedPfcpFeatures: - type: string managedNFProfile: $ref: '#/components/schemas/ManagedNFProfile' supportedBMOList: $ref: '#/components/schemas/SupportedBMOList' + upfInfo: + $ref: '#/components/schemas/UpfInfo' - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-ncO' - type: object properties: @@ -1983,34 +2558,14 @@ components: $ref: '#/components/schemas/ManagedNFProfile' commModelList: $ref: '#/components/schemas/CommModelList' - groupId: - type: string - dnnList: - type: array - items: - type: string - supiRanges: - $ref: '#/components/schemas/SupiRangeList' - gpsiRanges: - $ref: '#/components/schemas/IdentityRangeList' - rxDiamHost: - type: string - rxDiamRealm: - type: string - v2xSupportInd: - type: boolean - proseSupportInd: - type: boolean - proseCapability: - $ref: '#/components/schemas/ProseCapability' - v2xCapability: - $ref: '#/components/schemas/V2xCapability' + supportedBMOList: + $ref: '#/components/schemas/SupportedBMOList' + PcfInfo: + $ref: '#/components/schemas/PcfInfo' configurable5QISetRef: $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' dynamic5QISetRef: $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' - supportedBMOList: - $ref: '#/components/schemas/SupportedBMOList' - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-ncO' - type: object properties: @@ -2026,6 +2581,8 @@ components: $ref: '#/components/schemas/EP_N28-Multiple' EP_Rx: $ref: '#/components/schemas/EP_Rx-Multiple' + EP_N84: + $ref: '#/components/schemas/EP_N84-Multiple' PredefinedPccRuleSet: $ref: '#/components/schemas/PredefinedPccRuleSet-Single' @@ -2056,6 +2613,8 @@ components: $ref: '#/components/schemas/EP_N12-Multiple' EP_N13: $ref: '#/components/schemas/EP_N13-Multiple' + EP_N61: + $ref: '#/components/schemas/EP_N61-Multiple' UdmFunction-Single: allOf: - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' @@ -2089,6 +2648,10 @@ components: $ref: '#/components/schemas/EP_N13-Multiple' EP_N59: $ref: '#/components/schemas/EP_N13-Multiple' + EP_NL6: + $ref: '#/components/schemas/EP_NL6-Multiple' + EP_N87: + $ref: '#/components/schemas/EP_N87-Multiple' UdrFunction-Single: allOf: - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' @@ -2152,6 +2715,8 @@ components: properties: EP_N27: $ref: '#/components/schemas/EP_N27-Multiple' + EP_N96: + $ref: '#/components/schemas/EP_N96-Multiple' NssfFunction-Single: allOf: - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' @@ -2307,7 +2872,17 @@ components: $ref: 'TS28623_ComDefs.yaml#/components/schemas/AdministrativeState' nwdafInfo: $ref: '#/components/schemas/NwdafInfo' - + nwdafLogicalFuncSupported: + type: string + enum: + - NWDAF_WITH_ANLF + - NWDAF_WITH_MTLF + - NWDAF_WITH_ANLF_MTLF + - type: object + properties: + EP_NL3: + $ref: '#/components/schemas/EP_NL3-Multiple' + ScpFunction-Single: allOf: - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' @@ -2345,53 +2920,22 @@ components: $ref: '#/components/schemas/CapabilityList' isCAPIFSup: type: boolean - taiList: - $ref: '#/components/schemas/TaiList' - taiRangeList: - type: array - items: - $ref: '#/components/schemas/TaiRange' - dnai: - type: string - nefId: - type: string - pfdData: - $ref: '#/components/schemas/PfdData' - afEeData: - $ref: '#/components/schemas/AfEventExposureData' - gpsiRanges: - type: array - items: - $ref: '#/components/schemas/IdentityRange' - minItems: 1 - externalGroupIdentifiersRanges: - type: array - items: - $ref: '#/components/schemas/IdentityRange' - minItems: 1 - servedFqdnList: - type: array - items: - type: string - minItems: 1 - dnaiList: - type: array - items: - $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnai' - minItems: 1 - unTrustAfInfoList: - type: array - items: - $ref: '#/components/schemas/UnTrustAfInfo' - minItems: 1 - uasNfFunctionalityInd: - type: boolean - default: false + nefInfo: + $ref: '#/components/schemas/NefInfo' - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-ncO' - type: object properties: EP_N33: $ref: '#/components/schemas/EP_N33-Multiple' + EP_NL5: + $ref: '#/components/schemas/EP_NL5-Multiple' + EP_N85: + $ref: '#/components/schemas/EP_N85-Multiple' + EP_N62: + $ref: '#/components/schemas/EP_N62-Multiple' + EP_N63: + $ref: '#/components/schemas/EP_N63-Multiple' + NsacfFunction-Single: allOf: - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' @@ -2914,7 +3458,49 @@ components: $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' remoteAddress: $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' - EP_S5C-Single: + EP_S5C-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/EP_RP-Attr' + - type: object + properties: + localAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' + remoteAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' + EP_S5U-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/EP_RP-Attr' + - type: object + properties: + localAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' + remoteAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' + EP_Rx-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/EP_RP-Attr' + - type: object + properties: + localAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' + remoteAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' + EP_MAP_SMSC-Single: allOf: - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' - type: object @@ -2928,7 +3514,7 @@ components: $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' remoteAddress: $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' - EP_S5U-Single: + EP_NLS-Single: allOf: - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' - type: object @@ -2942,7 +3528,7 @@ components: $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' remoteAddress: $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' - EP_Rx-Single: + EP_NL2-Single: allOf: - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' - type: object @@ -2956,7 +3542,7 @@ components: $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' remoteAddress: $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' - EP_MAP_SMSC-Single: + EP_NL3-Single: allOf: - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' - type: object @@ -2970,7 +3556,21 @@ components: $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' remoteAddress: $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' - EP_NLS-Single: + EP_NL5-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/EP_RP-Attr' + - type: object + properties: + localAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' + remoteAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' + EP_NL6-Single: allOf: - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' - type: object @@ -2984,7 +3584,7 @@ components: $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' remoteAddress: $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' - EP_NLG-Single: + EP_NL9-Single: allOf: - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' - type: object @@ -3260,6 +3860,12 @@ components: properties: EP_N5: $ref: '#/components/schemas/EP_N5-Multiple' + EP_N86: + $ref: '#/components/schemas/EP_N86-Multiple' + EP_N63: + $ref: '#/components/schemas/EP_N63-Multiple' + EP_N62: + $ref: '#/components/schemas/EP_N62-Multiple' NssaafFunction-Single: allOf: @@ -3447,6 +4053,257 @@ components: remoteAddress: $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' + AanfFunction-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-Attr' + - type: object + properties: + pLMNInfoList: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/PlmnInfoList' + sBIFqdn: + type: string + managedNFProfile: + $ref: '#/components/schemas/ManagedNFProfile' + commModelList: + $ref: '#/components/schemas/CommModelList' + aanfInfo: + $ref: '#/components/schemas/AanfInfo' + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-ncO' + - type: object + properties: + EP_N61: + $ref: '#/components/schemas/EP_N61-Multiple' + EP_N62: + $ref: '#/components/schemas/EP_N62-Multiple' + EP_N63: + $ref: '#/components/schemas/EP_N63-Multiple' + EP_N61-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/EP_RP-Attr' + - type: object + properties: + localAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' + remoteAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' + EP_N62-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/EP_RP-Attr' + - type: object + properties: + localAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' + remoteAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' + EP_N63-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/EP_RP-Attr' + - type: object + properties: + localAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' + remoteAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' + + + GmlcFunction-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-Attr' + - type: object + properties: + pLMNInfoList: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/PlmnInfoList' + sBIFqdn: + type: string + managedNFProfile: + $ref: '#/components/schemas/ManagedNFProfile' + commModelList: + $ref: '#/components/schemas/CommModelList' + gmlcInfo: + $ref: '#/components/schemas/GmlcInfo' + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-ncO' + - type: object + properties: + EP_NL2: + $ref: '#/components/schemas/EP_NL2-Multiple' + EP_NL3: + $ref: '#/components/schemas/EP_NL3-Multiple' + EP_NL5: + $ref: '#/components/schemas/EP_NL5-Multiple' + EP_NL6: + $ref: '#/components/schemas/EP_NL6-Multiple' + EP_NL9: + $ref: '#/components/schemas/EP_NL9-Multiple' + TsctsfFunction-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-Attr' + - type: object + properties: + pLMNInfoList: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/PlmnInfoList' + sBIFqdn: + type: string + managedNFProfile: + $ref: '#/components/schemas/ManagedNFProfile' + commModelList: + $ref: '#/components/schemas/CommModelList' + tsctsfInfo: + $ref: '#/components/schemas/TsctsfInfo' + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-ncO' + - type: object + properties: + EP_N84: + $ref: '#/components/schemas/EP_N84-Multiple' + EP_N85: + $ref: '#/components/schemas/EP_N85-Multiple' + EP_N86: + $ref: '#/components/schemas/EP_N86-Multiple' + EP_N87: + $ref: '#/components/schemas/EP_N87-Multiple' + EP_N89: + $ref: '#/components/schemas/EP_N89-Multiple' + EP_N96: + $ref: '#/components/schemas/EP_N96-Multiple' + + EP_N84-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/EP_RP-Attr' + - type: object + properties: + localAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' + remoteAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' + EP_N85-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/EP_RP-Attr' + - type: object + properties: + localAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' + remoteAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' + EP_N86-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/EP_RP-Attr' + - type: object + properties: + localAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' + remoteAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' + EP_N87-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/EP_RP-Attr' + - type: object + properties: + localAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' + remoteAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' + EP_N89-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/EP_RP-Attr' + - type: object + properties: + localAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' + remoteAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' + EP_N96-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/EP_RP-Attr' + - type: object + properties: + localAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/LocalAddress' + remoteAddress: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/RemoteAddress' + + BsfFunction-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-Attr' + - type: object + properties: + pLMNInfoList: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/PlmnInfoList' + sBIFqdn: + type: string + cNSIIdList: + $ref: '#/components/schemas/CNSIIdList' + managedNFProfile: + $ref: '#/components/schemas/ManagedNFProfile' + commModelList: + $ref: '#/components/schemas/CommModelList' + bsfInfo: + $ref: '#/components/schemas/BsfInfo' + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-ncO' + #-------- Definition of JSON arrays for name-contained IOCs ---------------------- SubNetwork-Multiple: @@ -3702,14 +4559,42 @@ components: type: array items: $ref: '#/components/schemas/EP_NLS-Single' - EP_NLG-Multiple: + EP_NL2-Multiple: + type: array + items: + $ref: '#/components/schemas/EP_NL2-Single' + EP_NL3-Multiple: + type: array + items: + $ref: '#/components/schemas/EP_NL3-Single' + EP_NL5-Multiple: + type: array + items: + $ref: '#/components/schemas/EP_NL5-Single' + EP_NL6-Multiple: + type: array + items: + $ref: '#/components/schemas/EP_NL6-Single' + EP_NL9-Multiple: type: array items: - $ref: '#/components/schemas/EP_NLG-Single' + $ref: '#/components/schemas/EP_NL9-Single' EP_N60-Multiple: type: array items: $ref: '#/components/schemas/EP_N60-Single' + EP_N61-Multiple: + type: array + items: + $ref: '#/components/schemas/EP_N61-Single' + EP_N62-Multiple: + type: array + items: + $ref: '#/components/schemas/EP_N62-Single' + EP_N63-Multiple: + type: array + items: + $ref: '#/components/schemas/EP_N63-Single' EP_Npc4-Multiple: type: array items: @@ -3726,10 +4611,34 @@ components: type: array items: $ref: '#/components/schemas/EP_Npc8-Single' + EP_N84-Multiple: + type: array + items: + $ref: '#/components/schemas/EP_N84-Single' + EP_N85-Multiple: + type: array + items: + $ref: '#/components/schemas/EP_N85-Single' + EP_N86-Multiple: + type: array + items: + $ref: '#/components/schemas/EP_N86-Single' + EP_N87-Multiple: + type: array + items: + $ref: '#/components/schemas/EP_N87-Single' EP_N88-Multiple: type: array items: $ref: '#/components/schemas/EP_N88-Single' + EP_N89-Multiple: + type: array + items: + $ref: '#/components/schemas/EP_N89-Single' + EP_N96-Multiple: + type: array + items: + $ref: '#/components/schemas/EP_N96-Single' Configurable5QISet-Multiple: type: array items: @@ -3770,6 +4679,22 @@ components: type: array items: $ref: '#/components/schemas/MfafFunction-Single' + GmlcFunction-Multiple: + type: array + items: + $ref: '#/components/schemas/GmlcFunction-Single' + TsctsfFunction-Multiple: + type: array + items: + $ref: '#/components/schemas/TsctsfFunction-Single' + AanfFunction-Multiple: + type: array + items: + $ref: '#/components/schemas/AanfFunction-Single' + BsfFunction-Multiple: + type: array + items: + $ref: '#/components/schemas/BsfFunction-Single' #------------ Definitions in TS 28.541 for TS 28.532 ----------------------------- @@ -3844,7 +4769,16 @@ components: - $ref: '#/components/schemas/EP_N58-Single' - $ref: '#/components/schemas/EP_N59-Single' - $ref: '#/components/schemas/EP_N60-Single' + - $ref: '#/components/schemas/EP_N61-Single' + - $ref: '#/components/schemas/EP_N62-Single' + - $ref: '#/components/schemas/EP_N63-Single' + - $ref: '#/components/schemas/EP_N84-Single' + - $ref: '#/components/schemas/EP_N85-Single' + - $ref: '#/components/schemas/EP_N86-Single' + - $ref: '#/components/schemas/EP_N87-Single' - $ref: '#/components/schemas/EP_N88-Single' + - $ref: '#/components/schemas/EP_N89-Single' + - $ref: '#/components/schemas/EP_N96-Single' - $ref: '#/components/schemas/EP_Npc4-Single' - $ref: '#/components/schemas/EP_Npc6-Single' @@ -3856,7 +4790,12 @@ components: - $ref: '#/components/schemas/EP_Rx-Single' - $ref: '#/components/schemas/EP_MAP_SMSC-Single' - $ref: '#/components/schemas/EP_NLS-Single' - - $ref: '#/components/schemas/EP_NLG-Single' + - $ref: '#/components/schemas/EP_NL2-Single' + - $ref: '#/components/schemas/EP_NL3-Single' + - $ref: '#/components/schemas/EP_NL5-Single' + - $ref: '#/components/schemas/EP_NL6-Single' + - $ref: '#/components/schemas/EP_NL9-Single' + - $ref: '#/components/schemas/Configurable5QISet-Single' - $ref: '#/components/schemas/FiveQiDscpMappingSet-Single' - $ref: '#/components/schemas/PredefinedPccRuleSet-Single' @@ -3868,3 +4807,7 @@ components: - $ref: '#/components/schemas/DccfFunction-Single' - $ref: '#/components/schemas/ChfFunction-Single' - $ref: '#/components/schemas/MfafFunction-Single' + - $ref: '#/components/schemas/GmlcFunction-Single' + - $ref: '#/components/schemas/TsctsfFunction-Single' + - $ref: '#/components/schemas/AanfFunction-Single' + - $ref: '#/components/schemas/BsfFunction-Single' diff --git a/TS28541_NrNrm.yaml b/TS28541_NrNrm.yaml index 9ba9997e..0a509974 100644 --- a/TS28541_NrNrm.yaml +++ b/TS28541_NrNrm.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: NR NRM - version: 18.4.0 + version: 18.5.0 description: >- OAS 3.0.1 specification of the NR NRM © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -97,30 +97,22 @@ components: type: integer maximum: 503 NrTac: - type: integer - maximum: 16777215 + $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Tac' NrTacList: type: array items: - $ref: '#/components/schemas/NrTac' - Tai: - type: object - properties: - plmnId: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/PlmnId' - nrTac: - $ref: '#/components/schemas/NrTac' + $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Tac' TaiList: type: array items: - $ref: '#/components/schemas/Tai' + $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Tai' BackhaulAddress: type: object properties: gnbId: $ref: '#/components/schemas/GnbId' tai: - $ref: "#/components/schemas/Tai" + $ref: "TS28623_GenericNrm.yaml#/components/schemas/Tai" MappingSetIDBackhaulAddress: type: object properties: @@ -182,7 +174,7 @@ components: timeDuration: type: integer - UeAccProbilityDist: + UeAccProbabilityDist: type: object properties: targetProbability: @@ -190,7 +182,7 @@ components: numberofpreamblessent: type: integer - UeAccDelayProbilityDist: + UeAccDelayProbabilityDist: type: object properties: targetProbability: @@ -599,6 +591,75 @@ components: type: integer minValue: type: integer + NTNTAClist: + type: array + items: + $ref: '#/components/schemas/NrTac' + Ephemeris: + type: object + oneOf: + - $ref: '#/components/schemas/PositionVelocity' + - $ref: '#/components/schemas/Orbital' + properties: + satelliteId: + type: integer + + PositionVelocity: + type: object + properties: + positionX: + type: integer + minimum: 0 + maximum: 604800 + positionY: + type: integer + minimum: 0 + maximum: 604800 + positionZ: + type: integer + minimum: 0 + maximum: 604800 + velocityVX: + type: integer + minimum: -131072 + maximum: 131071 + velocityVY: + type: integer + minimum: -131072 + maximum: 131071 + velocityVZ: + type: integer + minimum: -131072 + maximum: 131071 + + Orbital: + type: object + properties: + semiMajorAxis: + type: integer + minimum: 0 + maximum: 8589934591 + eccentricity: + type: integer + minimum: -524288 + maximum: 524287 + periapsis: + type: integer + minimum: 0 + maximum: 16777215 + longitude: + type: integer + minimum: 0 + maximum: 2097151 + inclination: + type: integer + minimum: -524288 + maximum: 524287 + meanAnomaly: + type: integer + minimum: 0 + maximum: 16777215 + #-------- Definition of abstract IOCs -------------------------------------------- RrmPolicy_-Attr: @@ -949,7 +1010,7 @@ components: nrPci: $ref: '#/components/schemas/NrPci' nrTac: - $ref: '#/components/schemas/NrTac' + $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Tac' arfcnDL: type: integer arfcnUL: @@ -1025,7 +1086,11 @@ components: - type: object properties: bWPlist: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnList' + type: array + items: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' + maxItems: 12 + NrOperatorCellDu-Single: allOf: @@ -1039,7 +1104,7 @@ components: plmnInfoList: $ref: '#/components/schemas/PlmnInfoList' nrTac: - $ref: '#/components/schemas/NrTac' + $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Tac' NRFrequency-Single: allOf: @@ -1190,10 +1255,19 @@ components: properties: rRMPolicyMaxRatio: type: integer + default: 100 + minimum: 0 + maximum: 100 rRMPolicyMinRatio: type: integer + default: 0 + minimum: 0 + maximum: 100 rRMPolicyDedicatedRatio: type: integer + default: 0 + minimum: 0 + maximum: 100 NRCellRelation-Single: allOf: @@ -1418,10 +1492,10 @@ components: properties: drachOptimizationControl: type: boolean - ueAccProbilityDist: - $ref: "#/components/schemas/UeAccProbilityDist" - ueAccDelayProbilityDist: - $ref: "#/components/schemas/UeAccDelayProbilityDist" + ueAccProbabilityDist: + $ref: "#/components/schemas/UeAccProbabilityDist" + ueAccDelayProbabilityDist: + $ref: "#/components/schemas/UeAccDelayProbabilityDist" - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ManagedFunction-ncO' DMROFunction-Single: @@ -1869,6 +1943,45 @@ components: allOf: - $ref: '#/components/schemas/CCOParameters-Attr' - type: object + + NTNFunction-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + type: object + properties: + nTNpLMNInfoList: + $ref: '#/components/schemas/PlmnInfoList' + nTNTAClist: + $ref: '#/components/schemas/NrTacList' + EphemerisInfoSet: + $ref: '#/components/schemas/EphemerisInfoSet-Multiple' + + EphemerisInfoSet-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + attributes: + allOf: + - type: object + properties: + EphemerisInfos: + $ref: '#/components/schemas/Ephemeris-Multiple' + + Ephemeris-Single: + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + oneOf: + - $ref: '#/components/schemas/PositionVelocity' + - $ref: '#/components/schemas/Orbital' + properties: + satelliteId: + type: integer + #-------- Definition of JSON arrays for name-contained IOCs ---------------------- @@ -2032,7 +2145,15 @@ components: type: array items: $ref: '#/components/schemas/EP_S1U-Single' + EphemerisInfoSet-Multiple: + type: array + items: + $ref: '#/components/schemas/EphemerisInfoSet-Single' + Ephemeris-Multiple: + type: array + items: + $ref: '#/components/schemas/Ephemeris-Single' #-------- Definitions in TS 28.541 for TS 28.532 --------------------------------- resources-nrNrm: @@ -2099,3 +2220,7 @@ components: - $ref: '#/components/schemas/CCOWeakCoverageParameters-Single' - $ref: '#/components/schemas/CCOPilotPollutionParameters-Single' - $ref: '#/components/schemas/CCOOvershootCoverageParameters-Single' + - $ref: '#/components/schemas/NTNFunction-Single' + - $ref: '#/components/schemas/EphemerisInfoSet-Single' + - $ref: '#/components/schemas/Ephemeris-Single' + diff --git a/TS28541_SliceNrm.yaml b/TS28541_SliceNrm.yaml index 2803d6d8..88eeb770 100644 --- a/TS28541_SliceNrm.yaml +++ b/TS28541_SliceNrm.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: Slice NRM - version: 18.4.0 + version: 18.5.0 description: >- OAS 3.0.1 specification of the Slice NRM @ 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -23,26 +23,26 @@ components: enum: - STATIONARY - NOMADIC - - RESTRICTED MOBILITY - - FULLY MOBILITY + - RESTRICTED_MOBILITY + - FULL_MOBILITY SynAvailability: type: string enum: - - NOT SUPPORTED - - BETWEEN BS AND UE - - BETWEEN BS AND UE & UE AND UE + - NOT_SUPPORTED + - BETWEEN_BS_AND_UE + - BETWEEN_BS_AND_UE_AND_UE_AND_UE PositioningAvailability: type: array items: type: string enum: - - CIDE-CID + - CIDE_CID - OTDOA - - RF FINGERPRINTING + - RF_FINGERPRINTING - AECID - - HYBRID POSITIONING - - NET-RTK - Predictionfrequency: + - HYBRID_POSITIONING + - NET_RTK + PredictionFrequency: type: string enum: - PERSEC @@ -52,22 +52,18 @@ components: type: string enum: - SHARED - - NON-SHARED + - NON_SHARED NetworkSliceSharingIndicator: type: string enum: - SHARED - - NON-SHARED + - NON_SHARED SliceSimultaneousUse: - type: string - enum: - - ZERO - - ONE - - TWO - - THREE - - FOUR + type: integer + minimum: 0 + maximum: 4 Category: type: string enum: @@ -98,7 +94,7 @@ components: Support: type: string enum: - - NOT SUPPORTED + - NOT_SUPPORTED - SUPPORTED DelayTolerance: type: object @@ -107,6 +103,13 @@ components: $ref: '#/components/schemas/ServAttrCom' support: $ref: '#/components/schemas/Support' + NonIPSupport: + type: object + properties: + servAttrCom: + $ref: '#/components/schemas/ServAttrCom' + support: + $ref: '#/components/schemas/Support' DeterministicComm: type: object properties: @@ -189,8 +192,8 @@ components: $ref: '#/components/schemas/ServAttrCom' availability: $ref: '#/components/schemas/PositioningAvailability' - predictionfrequency: - $ref: '#/components/schemas/Predictionfrequency' + predictionFrequency: + $ref: '#/components/schemas/PredictionFrequency' accuracy: $ref: '#/components/schemas/Float' PositioningRANSubnet: @@ -198,8 +201,8 @@ components: properties: availability: $ref: '#/components/schemas/PositioningAvailability' - predictionfrequency: - $ref: '#/components/schemas/Predictionfrequency' + predictionFrequency: + $ref: '#/components/schemas/PredictionFrequency' accuracy: $ref: '#/components/schemas/Float' UserMgmtOpen: @@ -322,7 +325,7 @@ components: maxNumberOfPDUSessions: type: integer coverageAreaTAList: - $ref: 'TS28541_NrNrm.yaml#/components/schemas/NrTacList' + $ref: 'TS28541_NrNrm.yaml#/components/schemas/TaiList' resourceSharingLevel: $ref: '#/components/schemas/SharingLevel' dLMaxPktSize: @@ -348,12 +351,15 @@ components: nssaaSupport: $ref: '#/components/schemas/NSSAASupport' n6Protection: - $ref: '#/components/schemas/N6Protection' + $ref: '#/components/schemas/N6Protection' + nonIPSupport: + $ref: '#/components/schemas/NonIPSupport' + RANSliceSubnetProfile: type: object properties: coverageAreaTAList: - $ref: 'TS28541_NrNrm.yaml#/components/schemas/NrTacList' + $ref: 'TS28541_NrNrm.yaml#/components/schemas/TaiList' dLLatency: type: number uLLatency: @@ -404,6 +410,8 @@ components: $ref: '#/components/schemas/DeterministicComm' uLDeterministicComm: $ref: '#/components/schemas/DeterministicComm' + nonIPSupport: + $ref: '#/components/schemas/NonIPSupport' TopSliceSubnetProfile: type: object properties: @@ -446,7 +454,7 @@ components: activityFactor: type: integer coverageAreaTAList: - $ref: 'TS28541_NrNrm.yaml#/components/schemas/NrTacList' + $ref: 'TS28541_NrNrm.yaml#/components/schemas/TaiList' resourceSharingLevel: $ref: '#/components/schemas/SharingLevel' uEMobilityLevel: @@ -465,6 +473,8 @@ components: $ref: '#/components/schemas/NSSAASupport' n6Protection: $ref: '#/components/schemas/N6Protection' + nonIPSupport: + $ref: '#/components/schemas/NonIPSupport' ServiceProfile: type: object @@ -522,7 +532,9 @@ components: v2XCommModels: $ref: '#/components/schemas/V2XCommModels' coverageArea: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoArea' + type: array + items: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoArea' termDensity: $ref: '#/components/schemas/TermDensity' activityFactor: @@ -547,6 +559,8 @@ components: $ref: '#/components/schemas/NSSAASupport' n6Protection: $ref: '#/components/schemas/N6Protection' + nonIPSupport: + $ref: '#/components/schemas/NonIPSupport' SliceProfile: type: object properties: @@ -574,7 +588,7 @@ components: enum: - VLAN - MPLS - - Segment + - SEGMENT logicalInterfaceId: type: string systemName: @@ -590,7 +604,8 @@ components: - EGP - EIGRP - BGP - - IS-IS + - IS_IS + - STATIC ConnectionPointInfo: type: object @@ -641,7 +656,7 @@ components: type: boolean RequestedReservationExpiration: description: >- - An attribute which specifes MnS consuner's requirements for the validity period of the resource reservation. + An attribute which specifies MnS consuner's requirements for the validity period of the resource reservation. type: string ResourceReservationStatus: description: >- @@ -653,7 +668,7 @@ components: - USED ReservationExpiration: description: >- - An attribute which specifes the actual validity period of the resource reservation.. + An attribute which specifies the actual validity period of the resource reservation.. type: string ReservationFailureReason: description: >- @@ -796,7 +811,7 @@ components: uLThptPerSliceSubnet: $ref: '#/components/schemas/XLThpt' coverageAreaTAList: - $ref: 'TS28541_NrNrm.yaml#/components/schemas/NrTacList' + $ref: 'TS28541_NrNrm.yaml#/components/schemas/TaiList' FeasibilityCheckAndReservationJob-Single: allOf: - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' @@ -815,6 +830,8 @@ components: $ref: '#/components/schemas/RecommendationRequest' requestedReservationExpiration: $ref: '#/components/schemas/RequestedReservationExpiration' + feasibilityTimeWindow: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow' processMonitor: $ref: 'TS28623_GenericNrm.yaml#/components/schemas/ProcessMonitor' feasibilityResult: diff --git a/TS28623_GenericNrm.yaml b/TS28623_GenericNrm.yaml index f6522edc..e0434044 100644 --- a/TS28623_GenericNrm.yaml +++ b/TS28623_GenericNrm.yaml @@ -1,7 +1,7 @@ openapi: 3.0.1 info: title: Generic NRM - version: 18.3.0 + version: 18.4.0 description: >- OAS 3.0.1 definition of the Generic NRM © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -1359,6 +1359,70 @@ components: - 32 - 64 - INFINITY + reportAmountM1LTE-Type: + description: See details in 3GPP TS 32.422 clause 5.10.x. + type: string + enum: + - 1 + - 2 + - 4 + - 8 + - 16 + - 32 + - 64 + - INFINITY + + reportAmountM4LTE-Type: + description: See details in 3GPP TS 32.422 clause 5.10.y. + type: string + enum: + - 1 + - 2 + - 4 + - 8 + - 16 + - 32 + - 64 + - INFINITY + + reportAmountM5LTE-Type: + description: See details in 3GPP TS 32.422 clause 5.10.z. + type: string + enum: + - 1 + - 2 + - 4 + - 8 + - 16 + - 32 + - 64 + - INFINITY + + reportAmountM6LTE-Type: + description: See details in 3GPP TS 32.422 clause 5.10.a. + type: string + enum: + - 1 + - 2 + - 4 + - 8 + - 16 + - 32 + - 64 + - INFINITY + + reportAmountM7LTE-Type: + description: See details in 3GPP TS 32.422 clause 5.10.b. + type: string + enum: + - 1 + - 2 + - 4 + - 8 + - 16 + - 32 + - 64 + - INFINITY reportingTrigger-Type: description: See details in 3GPP TS 32.422 clause 5.10.4. @@ -1488,6 +1552,118 @@ components: minItems: 0 maxItems: 255 + traceConfig-Type: + description: Trace configuration parameters for NR. See details in 3GPP TS 28.622 clause 4.3.30. + type: object + properties: + listOfInterfaces: + $ref: '#/components/schemas/listOfInterfaces-Type' + listOfNeTypes: + $ref: '#/components/schemas/listOfNeTypes-Type' + traceDepth: + $ref: '#/components/schemas/traceDepth-Type' + triggeringEvents: + $ref: '#/components/schemas/triggeringEvents-Type' + + immediateMDTConfig-Type: + description: Immediate MDT configuration parameters. See details in 3GPP TS 28.622 clause 4.3.30. + type: object + properties: + listOfMeasurements: + $ref: '#/components/schemas/listOfMeasurements-Type' + reportingTrigger: + $ref: '#/components/schemas/reportingTrigger-Type' + reportAmount: + $ref: '#/components/schemas/reportAmount-Type' + reportAmountM1LTE: + $ref: '#/components/schemas/reportAmountM1LTE-Type' + reportAmountM4LTE: + $ref: '#/components/schemas/reportAmountM4LTE-Type' + reportAmountM5LTE: + $ref: '#/components/schemas/reportAmountM5LTE-Type' + reportAmountM6LTE: + $ref: '#/components/schemas/reportAmountM6LTE-Type' + reportAmountM7LTE: + $ref: '#/components/schemas/reportAmountM7LTE-Type' + reportInterval: + $ref: '#/components/schemas/reportInterval-Type' + eventThreshold: + $ref: '#/components/schemas/eventThreshold-Type' + collectionPeriodRrmLte: + $ref: '#/components/schemas/collectionPeriodRrmLte-Type' + collectionPeriodM6Lte: + $ref: '#/components/schemas/collectionPeriodM6Lte-Type' + collectionPeriodM7Lte: + $ref: '#/components/schemas/collectionPeriodM7Lte-Type' + collectionPeriodRrmUmts: + $ref: '#/components/schemas/collectionPeriodRrmUmts-Type' + collectionPeriodRrmNr: + $ref: '#/components/schemas/collectionPeriodRrmNr-Type' + collectionPeriodM6Nr: + $ref: '#/components/schemas/collectionPeriodM6Nr-Type' + collectionPeriodM7Nr: + $ref: '#/components/schemas/collectionPeriodM7Nr-Type' + eventThresholdUphUmts: + $ref: '#/components/schemas/eventThresholdUphUmts-Type' + measurementPeriodUmts: + $ref: '#/components/schemas/measurementPeriodUmts-Type' + measurementPeriodLte: + $ref: '#/components/schemas/measurementPeriodLte-Type' + measurementQuantity: + $ref: '#/components/schemas/measurementQuantity-Type' + beamLevelMeasurement: + $ref: '#/components/schemas/beamLevelMeasurement-Type' + positioningMethod: + $ref: '#/components/schemas/positioningMethod-Type' + excessPacketDelayThresholds: + $ref: '#/components/schemas/excessPacketDelayThresholds-Type' + + loggedMDTConfig-Type: + description: Logged MDT configuration parameters. See details in 3GPP TS 28.622 clause 4.3.30. + type: object + properties: + traceCollectionEntityId: + $ref: '#/components/schemas/traceCollectionEntityId-Type' + loggingDuration: + $ref: '#/components/schemas/loggingDuration-Type' + loggingInterval: + $ref: '#/components/schemas/loggingInterval-Type' + eventThresholdL1: + $ref: '#/components/schemas/eventThresholdL1-Type' + hysteresisL1: + $ref: '#/components/schemas/hysteresisL1-Type' + timeToTriggerL1: + $ref: '#/components/schemas/timeToTriggerL1-Type' + mbsfnAreaList: + type: array + items: + $ref: '#/components/schemas/MbsfnArea' + reportType: + $ref: '#/components/schemas/reportType-Type' + plmnList: + $ref: '#/components/schemas/plmnList-Type' + eventListForEventTriggeredMeasurement: + $ref: '#/components/schemas/eventListForEventTriggeredMeasurement-Type' + areaConfigurationForNeighCell: + $ref: '#/components/schemas/AreaConfig' + + mdtConfig-Type: + description: MDT config parameters. See details in 3GPP TS 28.622 clause 4.3.30. + type: object + properties: + anonymizationOfMdtData: + $ref: '#/components/schemas/anonymizationOfMdtData-Type' + areaScope: + type: array + items: + $ref: '#/components/schemas/AreaScope' + sensorInformation: + $ref: '#/components/schemas/sensorInformation-Type' + immediateMDTConfig: + $ref: '#/components/schemas/immediateMDTConfig-Type' + loggedMDTConfig: + $ref: '#/components/schemas/loggedMDTConfig-Type' + #-------- end of Definition of types used in Trace control NRM fragment ---------- @@ -1671,18 +1847,12 @@ components: properties: jobType: $ref: '#/components/schemas/jobType-Type' - listOfInterfaces: - $ref: '#/components/schemas/listOfInterfaces-Type' - listOfNeTypes: - $ref: '#/components/schemas/listOfNeTypes-Type' plmnTarget: $ref: '#/components/schemas/plmnTarget-Type' traceReportingConsumerUri: $ref: 'TS28623_ComDefs.yaml#/components/schemas/Uri' traceCollectionEntityIpAddress: $ref: '#/components/schemas/IpAddr' - traceDepth: - $ref: '#/components/schemas/traceDepth-Type' traceReference: $ref: '#/components/schemas/traceReference-Type' jobId: @@ -1691,78 +1861,10 @@ components: $ref: '#/components/schemas/traceReportingFormat-Type' traceTarget: $ref: '#/components/schemas/traceTarget-Type' - triggeringEvents: - $ref: '#/components/schemas/triggeringEvents-Type' - anonymizationOfMdtData: - $ref: '#/components/schemas/anonymizationOfMdtData-Type' - areaConfigurationForNeighCell: - $ref: '#/components/schemas/AreaConfig' - areaScope: - type: array - items: - $ref: '#/components/schemas/AreaScope' - beamLevelMeasurement: - $ref: '#/components/schemas/beamLevelMeasurement-Type' - collectionPeriodRrmLte: - $ref: '#/components/schemas/collectionPeriodRrmLte-Type' - collectionPeriodM6Lte: - $ref: '#/components/schemas/collectionPeriodM6Lte-Type' - collectionPeriodM7Lte: - $ref: '#/components/schemas/collectionPeriodM7Lte-Type' - collectionPeriodRrmUmts: - $ref: '#/components/schemas/collectionPeriodRrmUmts-Type' - collectionPeriodRrmNr: - $ref: '#/components/schemas/collectionPeriodRrmNr-Type' - collectionPeriodM6Nr: - $ref: '#/components/schemas/collectionPeriodM6Nr-Type' - collectionPeriodM7Nr: - $ref: '#/components/schemas/collectionPeriodM7Nr-Type' - eventListForEventTriggeredMeasurement: - $ref: '#/components/schemas/eventListForEventTriggeredMeasurement-Type' - eventThreshold: - $ref: '#/components/schemas/eventThreshold-Type' - listOfMeasurements: - $ref: '#/components/schemas/listOfMeasurements-Type' - loggingDuration: - $ref: '#/components/schemas/loggingDuration-Type' - loggingInterval: - $ref: '#/components/schemas/loggingInterval-Type' - eventThresholdL1: - $ref: '#/components/schemas/eventThresholdL1-Type' - hysteresisL1: - $ref: '#/components/schemas/hysteresisL1-Type' - timeToTriggerL1: - $ref: '#/components/schemas/timeToTriggerL1-Type' - mbsfnAreaList: - type: array - items: - $ref: '#/components/schemas/MbsfnArea' - measurementPeriodLte: - $ref: '#/components/schemas/measurementPeriodLte-Type' - measurementPeriodUmts: - $ref: '#/components/schemas/measurementPeriodUmts-Type' - measurementQuantity: - $ref: '#/components/schemas/measurementQuantity-Type' - eventThresholdUphUmts: - $ref: '#/components/schemas/eventThresholdUphUmts-Type' - plmnList: - $ref: '#/components/schemas/plmnList-Type' - positioningMethod: - $ref: '#/components/schemas/positioningMethod-Type' - reportAmount: - $ref: '#/components/schemas/reportAmount-Type' - reportingTrigger: - $ref: '#/components/schemas/reportingTrigger-Type' - reportInterval: - $ref: '#/components/schemas/reportInterval-Type' - reportType: - $ref: '#/components/schemas/reportType-Type' - sensorInformation: - $ref: '#/components/schemas/sensorInformation-Type' - traceCollectionEntityId: - $ref: '#/components/schemas/traceCollectionEntityId-Type' - excessPacketDelayThresholds: - $ref: '#/components/schemas/excessPacketDelayThresholds-Type' + traceConfig: + $ref: '#/components/schemas/traceConfig-Type' + mdtConfig: + $ref: '#/components/schemas/mdtConfig-Type' ManagedFunction-ncO: type: object diff --git a/TS29122_AsSessionWithQoS.yaml b/TS29122_AsSessionWithQoS.yaml index bdf660d2..05f566f6 100644 --- a/TS29122_AsSessionWithQoS.yaml +++ b/TS29122_AsSessionWithQoS.yaml @@ -2,14 +2,14 @@ openapi: 3.0.0 info: title: 3gpp-as-session-with-qos - version: 1.3.0-alpha.2 + version: 1.3.0-alpha.3 description: | API for setting us an AS session with required QoS. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.122 V18.2.0 T8 reference point for Northbound APIs + description: 3GPP TS 29.122 V18.3.0 T8 reference point for Northbound APIs url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.122/' security: @@ -475,6 +475,10 @@ components: exterAppId: type: string description: Identifies the external Application Identifier. + extGroupId: + $ref: 'TS29122_CommonData.yaml#/components/schemas/ExternalGroupId' + gpsi: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Gpsi' flowInfo: type: array items: @@ -495,6 +499,13 @@ components: description: > Identifies the Ethernet flows which require QoS. Each Ethernet flow consists of a flow idenifer and the corresponding UL and/or DL flows. + listUeAddrs: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/IpAddr' + minItems: 1 + description: > + Identifies the list of UE address multiModalId: $ref: 'TS29514_Npcf_PolicyAuthorization.yaml#/components/schemas/MultiModalId' pduSetProtDesc: @@ -540,14 +551,12 @@ components: $ref: 'TS29122_CommonData.yaml#/components/schemas/SponsorInformation' qosMonInfo: $ref: '#/components/schemas/QosMonitoringInformation' - pdvReqMonParams: - type: array - items: - $ref: 'TS29512_Npcf_SMPolicyControl.yaml#/components/schemas/RequestedQosMonitoringParameter' - minItems: 1 - description: Contains the Packet Delay Variation to be monitored pdvMon: $ref: '#/components/schemas/QosMonitoringInformation' + qosDuration: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' + qosInactInt: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' directNotifInd: type: boolean description: > @@ -588,6 +597,16 @@ components: the service, when it is included and set to "true". The default value is "false" if omitted. periodInfo: $ref: 'TS29514_Npcf_PolicyAuthorization.yaml#/components/schemas/PeriodicityInfo' + rttMon: + $ref: '#/components/schemas/QosMonitoringInformation' + qosMonDatRate: + $ref: '#/components/schemas/QosMonitoringInformation' + avrgWndw: + $ref: 'TS29571_CommonData.yaml#/components/schemas/AverWindow' + servAuthInfo: + $ref: 'TS29514_Npcf_PolicyAuthorization.yaml#/components/schemas/ServAuthInfo' + qosMonConReq: + $ref: '#/components/schemas/QosMonitoringInformation' required: - notificationDestination @@ -618,6 +637,13 @@ components: description: > Identifies the Ethernet flows which require QoS. Each Ethernet flow consists of a flow idenifer and the corresponding UL and/or DL flows. + listUeAddrs: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/IpAddr' + minItems: 1 + description: > + Identifies the list of UE address. multiModalId: $ref: 'TS29514_Npcf_PolicyAuthorization.yaml#/components/schemas/MultiModalId' qosReference: @@ -651,12 +677,6 @@ components: $ref: 'TS29122_CommonData.yaml#/components/schemas/UsageThresholdRm' qosMonInfo: $ref: '#/components/schemas/QosMonitoringInformationRm' - pdvReqMonParams: - type: array - items: - $ref: 'TS29512_Npcf_SMPolicyControl.yaml#/components/schemas/RequestedQosMonitoringParameter' - minItems: 1 - description: Contains the Packet Delay Variation to be monitored pdvMon: $ref: '#/components/schemas/QosMonitoringInformationRm' directNotifInd: @@ -697,6 +717,18 @@ components: $ref: 'TS29514_Npcf_PolicyAuthorization.yaml#/components/schemas/ProtoDesc' periodInfo: $ref: 'TS29514_Npcf_PolicyAuthorization.yaml#/components/schemas/PeriodicityInfo' + qosDuration: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSecRm' + qosInactInt: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSecRm' + rttMon: + $ref: '#/components/schemas/QosMonitoringInformationRm' + qosMonDatRate: + $ref: '#/components/schemas/QosMonitoringInformationRm' + avrgWndw: + $ref: 'TS29571_CommonData.yaml#/components/schemas/AverWindowRm' + qosMonConReq: + $ref: '#/components/schemas/QosMonitoringInformationRm' QosMonitoringInformation: description: Represents QoS monitoring information. @@ -718,10 +750,18 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' repThreshRp: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + conThreshDl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + conThreshUl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' waitTime: $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' repPeriod: $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' + repThreshDatRateDl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + repThreshDatRateUl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' required: - reqQosMonParams - repFreqs @@ -748,10 +788,18 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/UintegerRm' repThreshRp: $ref: 'TS29571_CommonData.yaml#/components/schemas/UintegerRm' + conThreshDl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/UintegerRm' + conThreshUl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/UintegerRm' waitTime: $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSecRm' repPeriod: $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSecRm' + repThreshDatRateDl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRateRm' + repThreshDatRateUl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRateRm' QosMonitoringReport: description: Represents a QoS monitoring report. @@ -775,6 +823,20 @@ components: pdmf: type: boolean description: Represents the packet delay measurement failure indicator. + ulDataRate: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + dlDataRate: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + ulConInfo: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + dlConInfo: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + cimf: + type: boolean + description: > + Represents the congestion information measurement failure indicator. When set to "true", + it indicates that a congestion information failure has occurred. Default value is false + if omitted. UserPlaneNotificationData: description: Represents the parameters to be conveyed in a user plane event(s) notification. @@ -846,6 +908,25 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/RatType' batOffsetInfo: $ref: 'TS29514_Npcf_PolicyAuthorization.yaml#/components/schemas/BatOffsetInfo' + rttMonReports: + type: array + items: + $ref: '#/components/schemas/QosMonitoringReport' + minItems: 1 + description: Contains the round trip delay over two SDFs reporting information + qosMonDatRateReps: + type: array + items: + $ref: 'TS29514_Npcf_PolicyAuthorization.yaml#/components/schemas/QosMonitoringReport' + minItems: 1 + qosMonConInfoReps: + type: array + items: + $ref: '#/components/schemas/QosMonitoringReport' + minItems: 1 + description: > + Contains QoS Monitoring for congestion information. It shall be present when the + notified event is "QOS_MONITORING" and congestion measurements are available. required: - event @@ -1093,6 +1174,8 @@ components: - L4S_NOT_AVAILABLE - L4S_AVAILABLE - BAT_OFFSET_INFO + - RT_DELAY_TWO_QOS_FLOWS + - PACK_DELAY_VAR - type: string description: > This string provides forward-compatibility with future @@ -1116,3 +1199,5 @@ components: - L4S_NOT_AVAILABLE: The ECN marking for L4S of one or more SDFs is not available. - L4S_AVAILABLE: The ECN marking for L4S of one or more SDFs is available again. - BAT_OFFSET_INFO: Indicates the network provided BAT offset and the optionally adjusted periodicity. + - RT_DELAY_TWO_QOS_FLOWS: Indicates round-trip delay on UL and DL flows over two QoS flows. + - PACK_DELAY_VAR: Indicates Packet Delay Variation is enabled for the SDF. diff --git a/TS29122_CommonData.yaml b/TS29122_CommonData.yaml index ea4bff92..7b55331c 100644 --- a/TS29122_CommonData.yaml +++ b/TS29122_CommonData.yaml @@ -2,14 +2,14 @@ openapi: 3.0.0 info: title: TS 29.122 Common Data Types - version: 1.3.0-alpha.2 + version: 1.3.0-alpha.3 description: | Data types applicable to several APIs. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.122 V18.1.0 T8 reference point for Northbound APIs + description: 3GPP TS 29.122 V18.3.0 T8 reference point for Northbound APIs url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.122/' paths: {} @@ -328,12 +328,6 @@ components: BdtReferenceId: type: string description: string identifying a BDT Reference ID as defined in clause 5.3.3 of 3GPP TS 29.154. - BdtReferenceIdRm: - type: string - description: > - This data type is defined in the same way as the BdtReferenceId data type, but with the - nullable property set to true. - nullable: true Binary: type: string diff --git a/TS29122_CpProvisioning.yaml b/TS29122_CpProvisioning.yaml index 8391fb4b..01278ceb 100644 --- a/TS29122_CpProvisioning.yaml +++ b/TS29122_CpProvisioning.yaml @@ -2,14 +2,14 @@ openapi: 3.0.0 info: title: 3gpp-cp-parameter-provisioning - version: 1.3.0-alpha.2 + version: 1.3.0-alpha.3 description: | API for provisioning communication pattern parameters. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.122 V18.2.0 T8 reference point for Northbound APIs + description: 3GPP TS 29.122 V18.3.0 T8 reference point for Northbound APIs url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.122/' security: @@ -609,6 +609,12 @@ components: $ref: '#/components/schemas/AppExpUeBehaviour' minItems: 1 description: Contains the Application Specific Expected UE Behaviour parameters. + confidenceLevel: + type: string + pattern: '^[0]\.[0-9]{2}|[1.00]$' + accuracyLevel: + type: string + pattern: '^[0]\.[0-9]{2}|[1.00]$' required: - setId @@ -677,6 +683,12 @@ components: Represents a 3-tuple with protocol, server ip and server port for UL/DL application traffic. The content of the string has the same encoding as the IPFilterRule AVP value as defined in IETF RFC 6733. + confidenceLevel: + type: string + pattern: '^[0]\.[0-9]{2}|[1.00]$' + accuracyLevel: + type: string + pattern: '^[0]\.[0-9]{2}|[1.00]$' oneOf: - required: [appId] - required: [flowDescriptions] @@ -722,6 +734,8 @@ components: - MALFUNCTION - SET_ID_DUPLICATED - OTHER_REASON + - CONFIDENCE_LEVEL_NOT_SUFFICIENT + - ACCURACY_LEVEL_NOT_SUFFICIENT - type: string description: > This string provides forward-compatibility with future @@ -733,6 +747,8 @@ components: - MALFUNCTION: This value indicates that something functions wrongly in CP parameter provisioning or the CP parameter provisioning does not function at all. - SET_ID_DUPLICATED: The received CP set identifier(s) are already provisioned. - OTHER_REASON: Other reason unspecified. + - CONFIDENCE_LEVEL_NOT_SUFFICIENT: The received confidence level for the expected UE parameter is not sufficient. + - ACCURACY_LEVEL_NOT_SUFFICIENT: The received accuracy level for the expected UE parameter is not sufficient. BatteryIndication: anyOf: diff --git a/TS29122_MonitoringEvent.yaml b/TS29122_MonitoringEvent.yaml index a947eb29..8bed2d7b 100644 --- a/TS29122_MonitoringEvent.yaml +++ b/TS29122_MonitoringEvent.yaml @@ -2,14 +2,14 @@ openapi: 3.0.0 info: title: 3gpp-monitoring-event - version: 1.3.0-alpha.2 + version: 1.3.0-alpha.3 description: | API for Monitoring Event. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.122 V18.2.0 T8 reference point for Northbound APIs + description: 3GPP TS 29.122 V18.3.0 T8 reference point for Northbound APIs url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.122/' security: @@ -793,7 +793,8 @@ components: type: boolean description: > If "monitoringType" is "ROAMING_STATUS", this parameter shall be set to "true" - if the UE is on roaming status. Set to false or omitted otherwise. + if the new serving PLMN is different from the HPLMN. Set to false or + omitted otherwise. failureCause: $ref: '#/components/schemas/FailureCause' eventTime: @@ -937,6 +938,51 @@ components: $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/LdrType' achievedQos: $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/MinorLocationQoS' + relatedApplicationlayerId: + type: string + rangeDirection: + $ref: '#/components/schemas/RangeDirection' + twodrelativeLocation: + $ref: '#/components/schemas/TwodrelativeLocation' + threedrelativeLocation: + $ref: '#/components/schemas/ThreedrelativeLocation' + relativeVelocity: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/VelocityEstimate' + RangeDirection: + description: Represents a range and direction from a point A to a point B. + type: object + properties: + range: + type: number + azimuthDirection: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Angle' + elevationDirection: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Angle' + + + TwodrelativeLocation: + description: Represents a relative 2D location with uncertainty ellipse. + type: object + properties: + semiMinor: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Uncertainty' + semiMajor: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Uncertainty' + orientationAngle: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Angle' + + ThreedrelativeLocation: + description: Represents a relative 3D location with uncertainty ellipsoid. + type: object + properties: + semiMinor: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Uncertainty' + semiMajor: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Uncertainty' + verticalUncertainty: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Uncertainty' + orientationAngle: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Angle' FailureCause: description: Represents the reason of communication failure. @@ -1316,6 +1362,7 @@ components: - UNSUPPORTED_BY_UE - NOT_REGISTED_UE - UNSPECIFIED + - REQUESTED_AREA_NOT_ALLOWED - type: string description: > This string provides forward-compatibility with future extensions to the enumeration but @@ -1327,6 +1374,8 @@ components: - UNSUPPORTED_BY_UE: Positioning is not supported by UE. - NOT_REGISTED_UE: UE is not registered. - UNSPECIFIED: Unspecified. + - REQUESTED_AREA_NOT_ALLOWED: The location request is rejected because the location area + requested by the AF for area event reporting is not allowed. SubType: anyOf: diff --git a/TS29222_CAPIF_Events_API.yaml b/TS29222_CAPIF_Events_API.yaml index 02f3183e..b45675cb 100644 --- a/TS29222_CAPIF_Events_API.yaml +++ b/TS29222_CAPIF_Events_API.yaml @@ -6,10 +6,10 @@ info: API for event subscription management. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. - version: "1.3.0-alpha.2" + version: "1.3.0-alpha.3" externalDocs: - description: 3GPP TS 29.222 V18.1.0 Common API Framework for 3GPP Northbound APIs + description: 3GPP TS 29.222 V18.3.0 Common API Framework for 3GPP Northbound APIs url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.222/ servers: @@ -154,6 +154,112 @@ paths: default: $ref: 'TS29122_CommonData.yaml#/components/responses/default' + put: + description: Update of an existing individual CAPIF Event Subscription. + parameters: + - name: subscriberId + in: path + description: Identifier of the Subscriber + required: true + schema: + type: string + - name: subscriptionId + in: path + description: Identifier of the individual Subscriber + required: true + schema: + type: string + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/EventSubscription' + responses: + '200': + description: OK (Successful update of the subscription). + content: + application/json: + schema: + $ref: '#/components/schemas/EventSubscription' + '204': + description: No Content + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + + patch: + description: Modification of an existing individual CAPIF Event Subscription. + parameters: + - name: subscriberId + in: path + description: Identifier of the Subscriber + required: true + schema: + type: string + - name: subscriptionId + in: path + description: Identifier of the individual Subscriber + required: true + schema: + type: string + requestBody: + required: true + content: + application/merge-patch+json: + schema: + $ref: '#/components/schemas/EventSubscriptionPatch' + responses: + '200': + description: OK (Successful update of the subscription) + content: + application/json: + schema: + $ref: '#/components/schemas/EventSubscription' + '204': + description: No Content + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + components: schemas: EventSubscription: @@ -288,6 +394,29 @@ components: - apiId - routingRules + EventSubscriptionPatch: + type: object + description: > + Represents the parameters to request the updated of an individual CAPIF Event + Subscription resource. + properties: + events: + type: array + items: + $ref: '#/components/schemas/CAPIFEvent' + minItems: 1 + description: Subscribed events + eventFilters: + type: array + items: + $ref: '#/components/schemas/CAPIFEventFilter' + minItems: 1 + description: Subscribed event filters + eventReq: + $ref: 'TS29523_Npcf_EventExposure.yaml#/components/schemas/ReportingInformation' + notificationDestination: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Uri' + CAPIFEvent: anyOf: - type: string diff --git a/TS29309_Nbsp_GBA.yaml b/TS29309_Nbsp_GBA.yaml index dda351e1..c85bf8f0 100644 --- a/TS29309_Nbsp_GBA.yaml +++ b/TS29309_Nbsp_GBA.yaml @@ -1,16 +1,16 @@ openapi: 3.0.0 info: - version: '1.0.0' + version: '1.1.0-alpha.1' title: 'GBA BSF Nbsp_GBA Service' description: | GBA BSF Nbsp_GBA Service. - © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: description: > - 3GPP TS 29.309 V17.1.0; 5G System; Bootstrapping Server Function (GBA BSF) Services; Stage 3 + 3GPP TS 29.309 V18.0.0; 5G System; Bootstrapping Server Function (GBA BSF) Services; Stage 3 url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.309/' servers: @@ -32,6 +32,13 @@ paths: operationId: BootstrappingInfoRetrieval tags: - Bootstrapping Info Retrieval (Custom Operation) + security: + - {} + - oAuth2ClientCredentials: + - nbsp-gba + - oAuth2ClientCredentials: + - nbsp-gba + - nbsp-gba:bootstrapping-info-retrieval:invoke requestBody: content: application/json: @@ -80,6 +87,13 @@ paths: operationId: PushInfoRetrieval tags: - Push Info Retrieval (Custom Operation) + security: + - {} + - oAuth2ClientCredentials: + - nbsp-gba + - oAuth2ClientCredentials: + - nbsp-gba + - nbsp-gba:push-info-retrieval:invoke requestBody: content: application/json: @@ -132,6 +146,10 @@ components: tokenUrl: '{nrfApiRoot}/oauth2/token' scopes: nbsp-gba: Access to the Nbsp_GBA API + nbsp-gba:bootstrapping-info-retrieval:invoke: >- + Access to invoke the Bootstrapping Info Retrieval custom operation + nbsp-gba:push-info-retrieval:invoke: >- + Access to invoke the Push Info Retrieval custom operation schemas: diff --git a/TS29502_Nsmf_PDUSession.yaml b/TS29502_Nsmf_PDUSession.yaml index ff06af47..632425e2 100644 --- a/TS29502_Nsmf_PDUSession.yaml +++ b/TS29502_Nsmf_PDUSession.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: '1.3.0-alpha.4' + version: '1.3.0-alpha.5' title: 'Nsmf_PDUSession' description: | SMF PDU Session Service. @@ -9,7 +9,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.502 V18.3.0; 5G System; Session Management Services; Stage 3 + description: 3GPP TS 29.502 V18.4.0; 5G System; Session Management Services; Stage 3 url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.502/ servers: @@ -1978,6 +1978,8 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/PduSessionId' sNssai: $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + additionalSnssai: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' upCnxState: $ref: '#/components/schemas/UpCnxState' n2SmInfo: @@ -2498,8 +2500,8 @@ components: disasterRoamingInd: type: boolean default: false - hrsboReqInfo: - $ref: '#/components/schemas/HrsboReqInfo' + hrsboInfo: + $ref: '#/components/schemas/HrsboInfoFromVplmn' ecsAddrConfigInfos: type: array items: @@ -2543,6 +2545,8 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/PduSessionId' sNssai: $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + additionalSnssai: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' enablePauseCharging: type: boolean default: false @@ -2622,8 +2626,13 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/NfGroupId' pcfGroupId: $ref: 'TS29571_CommonData.yaml#/components/schemas/NfGroupId' - hrsboRspInfo: - $ref: '#/components/schemas/HrsboRspInfo' + hrsboInfo: + $ref: '#/components/schemas/HrsboInfoFromHplmn' + pendingUpdateInfoList: + type: array + items: + $ref: '#/components/schemas/PendingUpdateInfo' + minItems: 1 required: - pduSessionType - sscMode @@ -2810,8 +2819,8 @@ components: items: $ref: 'TS29503_Nudm_PP.yaml#/components/schemas/EcsAddrConfigInfo' minItems: 1 - hrsboReqInfo: - $ref: '#/components/schemas/HrsboReqInfo' + hrsboInfo: + $ref: '#/components/schemas/HrsboInfoFromVplmn' altSnssai: $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' required: @@ -2870,8 +2879,8 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' intraPlmnApiRoot: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' - hrsboRspInfo: - $ref: '#/components/schemas/HrsboRspInfo' + hrsboInfo: + $ref: '#/components/schemas/HrsboInfoFromHplmn' ReleaseData: description: Data within Release Request @@ -3010,8 +3019,18 @@ components: default: false n9InactivityTimer: $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' - hrsboRspInfo: - $ref: '#/components/schemas/HrsboRspInfo' + hrsboInfo: + $ref: '#/components/schemas/HrsboInfoFromHplmn' + altHplmnSnssai: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + pduSessionRetainInd: + type: boolean + enum: + - true + pendingUpdateInfoList: + type: array + items: + $ref: '#/components/schemas/PendingUpdateInfo' required: - requestIndication @@ -3278,6 +3297,9 @@ components: ranUnchangedInd: type: boolean default: false + hrsboSupportInd: + type: boolean + default: false SmContextRetrievedData: description: Data within Retrieve SM Context Response @@ -3660,8 +3682,15 @@ components: type: boolean hDnsAddr: $ref: '#/components/schemas/IpAddress' + hPlmnAddr: + $ref: '#/components/schemas/IpAddress' vplmnOffloadingInfo: $ref: 'TS29571_CommonData.yaml#/components/schemas/VplmnOffloadingInfo' + pendingUpdateInfoList: + type: array + items: + $ref: '#/components/schemas/PendingUpdateInfo' + minItems: 1 required: - pduSessionId - dnn @@ -3847,6 +3876,8 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' guaFbrUl: $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + 5qiPL: + $ref: 'TS29571_CommonData.yaml#/components/schemas/5QiPriorityLevel' DdnFailureSubs: description: DDN Failure Subscription @@ -4054,7 +4085,7 @@ components: psetrSupportInd: type: boolean - HrsboReqInfo: + HrsboInfoFromVplmn: description: HR-SBO Information in request message type: object properties: @@ -4064,8 +4095,14 @@ components: - true vEasdfAddr: $ref: '#/components/schemas/IpAddress' + localDnsAddr: + $ref: '#/components/schemas/IpAddress' + easRediscoveryInd: + type: boolean + enum: + - true - HrsboRspInfo: + HrsboInfoFromHplmn: description: HR-SBO Information in response message type: object properties: @@ -4077,6 +4114,11 @@ components: $ref: '#/components/schemas/IpAddress' vplmnOffloadingInfo: $ref: 'TS29571_CommonData.yaml#/components/schemas/VplmnOffloadingInfo' + internalGroupIds: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/GroupId' + minItems: 1 # # SIMPLE DATA TYPES @@ -4307,7 +4349,8 @@ components: - REL_DUE_TO_EXCEEDED_UE_SLICE_DATA_RATE - REL_DUE_TO_EXCEEDED_SLICE_DATA_RATE - REL_DUE_TO_CONTEXT_NOT_FOUND - + - REL_DUE_TO_MBSR_NOT_AUTHORIZED + - DEACT_DUE_TO_UE_OUT_OF_SLICE_SUPPORT_AREA - type: string description: > This string provides forward-compatibility with future @@ -4370,7 +4413,8 @@ components: - REL_DUE_TO_EXCEEDED_UE_SLICE_DATA_RATE - REL_DUE_TO_EXCEEDED_SLICE_DATA_RATE - REL_DUE_TO_CONTEXT_NOT_FOUND - + - REL_DUE_TO_MBSR_NOT_AUTHORIZED + - DEACT_DUE_TO_UE_OUT_OF_SLICE_SUPPORT_AREA ResourceStatus: anyOf: @@ -4711,6 +4755,29 @@ components: description: | Type of PDU Session information. Possible values are - AF_COORDINATION_INFO + + PendingUpdateInfo: + anyOf: + - type: string + enum: + - UE_LOCATION + - TIMEZONE + - ACCESS_TYPE + - RAT_TYPE + - AMF_ID + - 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. + description: | + Pending Update Information. Possible values are + - UE_LOCATION + - TIMEZONE + - ACCESS_TYPE + - RAT_TYPE + - AMF_ID + # # HTTP request bodies # diff --git a/TS29503_Nudm_EE.yaml b/TS29503_Nudm_EE.yaml index 1d92289d..f1de4b0f 100644 --- a/TS29503_Nudm_EE.yaml +++ b/TS29503_Nudm_EE.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: '1.3.0-alpha.3' + version: '1.3.0-alpha.4' title: 'Nudm_EE' description: | Nudm Event Exposure Service. @@ -9,7 +9,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.503 Unified Data Management Services, version 18.2.0 + description: 3GPP TS 29.503 Unified Data Management Services, version 18.3.0 url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.503/' servers: @@ -31,6 +31,13 @@ paths: operationId: CreateEeSubscription tags: - Create EE Subscription + security: + - {} + - oAuth2ClientCredentials: + - nudm-ee + - oAuth2ClientCredentials: + - nudm-ee + - nudm-ee:subscription:create parameters: - name: ueIdentity in: path @@ -65,7 +72,11 @@ paths: '403': $ref: 'TS29571_CommonData.yaml#/components/responses/403' '404': - $ref: 'TS29571_CommonData.yaml#/components/responses/404' + description: Not Found + content: + application/problem+json: + schema: + $ref: '#/components/schemas/EeSubscriptionError' '411': $ref: 'TS29571_CommonData.yaml#/components/responses/411' '413': @@ -211,6 +222,13 @@ paths: operationId: DeleteEeSubscription tags: - Delete EE Subscription + security: + - {} + - oAuth2ClientCredentials: + - nudm-ee + - oAuth2ClientCredentials: + - nudm-ee + - nudm-ee:subscription:modify parameters: - name: ueIdentity in: path @@ -251,6 +269,13 @@ paths: operationId: UpdateEeSubscription tags: - Update EE Subscription + security: + - {} + - oAuth2ClientCredentials: + - nudm-ee + - oAuth2ClientCredentials: + - nudm-ee + - nudm-ee:subscription:modify parameters: - name: ueIdentity in: path @@ -322,6 +347,8 @@ components: tokenUrl: '{nrfApiRoot}/oauth2/token' scopes: nudm-ee: Access to the nudm-ee API + nudm-ee:subscription:create: Access to create EE Subscriptions + nudm-ee:subscription:modify: Access to update EE Subscriptions schemas: @@ -344,14 +371,24 @@ components: minItems: 1 epcStatusInd: type: boolean + 5gOnlyInd: + type: boolean + enum: + - true failedMonitoringConfigs: - description: A map (list of key-value pairs where referenceId converted from integer to string serves as key; see clause 6.4.6.3.2) of FailedMonitoringConfiguration + description: > + A map (list of key-value pairs where referenceId converted from integer to string serves + as key; see clause 6.4.6.3.2) of FailedMonitoringConfiguration type: object additionalProperties: $ref: '#/components/schemas/FailedMonitoringConfiguration' minProperties: 1 failedMoniConfigsEPC: - description: A map (list of key-value pairs where referenceId converted from integer to string serves as key; see clause 6.4.6.3.2) of FailedMonitoringConfiguration, the key value "ALL" may be used to identify a map entry which contains the failed cause of the EE subscription was not successful in EPC domain. + description: > + A map (list of key-value pairs where referenceId converted from integer to string serves + as key; see clause 6.4.6.3.2) of FailedMonitoringConfiguration, the key value "ALL" may + be used to identify a map entry which contains the failed cause of the EE subscription + was not successful in EPC domain. type: object additionalProperties: $ref: '#/components/schemas/FailedMonitoringConfiguration' @@ -361,6 +398,11 @@ components: items: type: string minItems: 1 + currentStatusNotAvailableList: + type: array + items: + $ref: '#/components/schemas/EventType' + minItems: 1 FailedMonitoringConfiguration: @@ -770,11 +812,24 @@ components: - required: [addedUEs] - required: [removedUEs] + EeSubscriptionErrorAddInfo: + description: Additional Information for EE Subscription Error. + type: object + properties: + subType: + $ref: '#/components/schemas/SubscriptionType' + + EeSubscriptionError: + description: EE Subscription Error. + allOf: + - $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails' + - $ref: '#/components/schemas/EeSubscriptionErrorAddInfo' + # SIMPLE TYPES: ReferenceId: - type: integer + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uint64' MaxNumOfReports: type: integer @@ -948,3 +1003,16 @@ components: 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. + + SubscriptionType: + description: UE Subscription Type. + anyOf: + - type: string + enum: + - 5G + - 4G_5G + - 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/TS29503_Nudm_PP.yaml b/TS29503_Nudm_PP.yaml index e7cfd0f2..3f46d61f 100644 --- a/TS29503_Nudm_PP.yaml +++ b/TS29503_Nudm_PP.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: '1.3.0-alpha.2' + version: '1.3.0-alpha.3' title: 'Nudm_PP' description: | Nudm Parameter Provision Service. @@ -9,7 +9,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.503 Unified Data Management Services, version 18.2.0 + description: 3GPP TS 29.503 Unified Data Management Services, version 18.3.0 url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.503/' servers: @@ -650,6 +650,11 @@ components: $ref: '#/components/schemas/MbsAssistanceInfo' appSpecificExpectedUeBehaviour: $ref: '#/components/schemas/AppSpecificExpectedUeBehaviour' + sliceUsageControlInfos: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SliceUsageControlInfo' + minItems: 1 nullable: true MbsAssistanceInfo: @@ -694,7 +699,7 @@ components: afInstanceId: type: string referenceId: - $ref: '#/components/schemas/ReferenceId' + $ref: 'TS29503_Nudm_EE.yaml#/components/schemas/ReferenceId' validityTime: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' mtcProviderInformation: @@ -713,7 +718,7 @@ components: afInstanceId: type: string referenceId: - $ref: '#/components/schemas/ReferenceId' + $ref: 'TS29503_Nudm_EE.yaml#/components/schemas/ReferenceId' validityTime: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' mtcProviderInformation: @@ -731,13 +736,22 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Gpsi' minItems: 1 referenceId: - $ref: '#/components/schemas/ReferenceId' + $ref: 'TS29503_Nudm_EE.yaml#/components/schemas/ReferenceId' afInstanceId: type: string internalGroupIdentifier: $ref: 'TS29571_CommonData.yaml#/components/schemas/GroupId' mtcProviderInformation: $ref: 'TS29571_CommonData.yaml#/components/schemas/MtcProviderInformation' + membersData: + description: > + Contains the list of 5G VN Group members, each member is identified by GPSI. + A map (list of key-value pairs where Gpsi serves as key) of GpsiInfo. + The value in each entries of the map shall be an empty JSON object. + type: object + additionalProperties: + $ref: '#/components/schemas/GpsiInfo' + minProperties: 1 5GVnGroupData: type: object @@ -774,6 +788,9 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Fqdn' 5gVnGroupCommunicationInd: type: boolean + maxGroupDataRate: + $ref: '#/components/schemas/MaxGroupDataRate' + ExpectedUeBehaviour: type: object @@ -784,7 +801,7 @@ components: afInstanceId: type: string referenceId: - $ref: '#/components/schemas/ReferenceId' + $ref: 'TS29503_Nudm_EE.yaml#/components/schemas/ReferenceId' stationaryIndication: $ref: 'TS29571_CommonData.yaml#/components/schemas/StationaryIndicationRm' communicationDurationTime: @@ -801,7 +818,9 @@ components: $ref: '#/components/schemas/LocationArea' minItems: 1 nullable: true - description: Identifies the UE's expected geographical movement. The attribute is only applicable in 5G. + description: > + Identifies the UE's expected geographical movement. The attribute is only + applicable in 5G. trafficProfile: $ref: 'TS29571_CommonData.yaml#/components/schemas/TrafficProfileRm' batteryIndication: @@ -844,7 +863,9 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/DayOfWeek' NetworkAreaInfo: - description: Describes a network area information in which the NF service consumer requests the number of UEs. + description: > + Describes a network area information in which the NF service consumer requests + the number of UEs. type: object properties: ecgis: @@ -881,7 +902,7 @@ components: afInstanceId: type: string referenceId: - $ref: '#/components/schemas/ReferenceId' + $ref: 'TS29503_Nudm_EE.yaml#/components/schemas/ReferenceId' plmnEcInfos: type: array items: @@ -914,7 +935,7 @@ components: afInstanceId: type: string referenceId: - $ref: '#/components/schemas/ReferenceId' + $ref: 'TS29503_Nudm_EE.yaml#/components/schemas/ReferenceId' dnn: $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' singleNssai: @@ -937,7 +958,7 @@ components: afInstanceId: type: string referenceId: - $ref: '#/components/schemas/ReferenceId' + $ref: 'TS29503_Nudm_EE.yaml#/components/schemas/ReferenceId' validityTime: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' mtcProviderInformation: @@ -956,7 +977,7 @@ components: afInstanceId: type: string referenceId: - $ref: '#/components/schemas/ReferenceId' + $ref: 'TS29503_Nudm_EE.yaml#/components/schemas/ReferenceId' validityTime: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' mtcProviderInformation: @@ -969,7 +990,7 @@ components: afInstanceId: type: string referenceId: - $ref: '#/components/schemas/ReferenceId' + $ref: 'TS29503_Nudm_EE.yaml#/components/schemas/ReferenceId' lpi: $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/Lpi' mtcProviderInformation: @@ -977,7 +998,13 @@ components: evtRptExpectedArea: $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/GeographicArea' areaUsageInd: - $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/AreaUsageInd' + allOf: + - $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/AreaUsageInd' + default: POSITIVE_SENSE + upLocRepIndAf: + allOf: + - $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/UpLocRepIndAf' + default: USER_PLANE_REPORT_NOT_ALLOWED nullable: true PpDataEntry: @@ -986,7 +1013,7 @@ components: communicationCharacteristics: $ref: '#/components/schemas/CommunicationCharacteristicsAF' referenceId: - $ref: '#/components/schemas/ReferenceId' + $ref: 'TS29503_Nudm_EE.yaml#/components/schemas/ReferenceId' validityTime: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' mtcProviderInformation: @@ -1013,6 +1040,11 @@ components: minProperties: 1 ecRestriction: $ref: '#/components/schemas/EcRestriction' + sliceUsageControlInfos: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SliceUsageControlInfo' + minItems: 1 nullable: true CommunicationCharacteristicsAF: @@ -1102,7 +1134,7 @@ components: afInstanceId: type: string referenceId: - $ref: '#/components/schemas/ReferenceId' + $ref: 'TS29503_Nudm_EE.yaml#/components/schemas/ReferenceId' expectedUeBehaviourData: description: A map(list of key-value pairs) where a valid JSON pointer serves as key type: object @@ -1123,7 +1155,7 @@ components: afInstanceId: type: string referenceId: - $ref: '#/components/schemas/ReferenceId' + $ref: 'TS29503_Nudm_EE.yaml#/components/schemas/ReferenceId' appSpecificExpectedUeBehaviourData: description: A map(list of key-value pairs) where a valid JSON pointer serves as key type: object @@ -1132,11 +1164,27 @@ components: minProperties: 1 nullable: true + MaxGroupDataRate: + description: > + The limits of the total bit rate across all sessions of the 5G VN group + (uplink and downlink) + type: object + properties: + uplink: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + downlink: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + + GpsiInfo: + description: > + In this version of this specificiaiton, this data type does not contain any attributes, + it is used to convey an empty JSON objects as the value of the entries in the membersData map. + type: object + nullable: true + # SIMPLE TYPES: - ReferenceId: - type: integer PpDlPacketCount: type: integer diff --git a/TS29503_Nudm_SDM.yaml b/TS29503_Nudm_SDM.yaml index 0a26d191..4241b310 100644 --- a/TS29503_Nudm_SDM.yaml +++ b/TS29503_Nudm_SDM.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: '2.3.0-alpha.3' + version: '2.3.0-alpha.4' title: 'Nudm_SDM' description: | Nudm Subscriber Data Management Service. @@ -9,7 +9,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.503 Unified Data Management Services, version 18.2.0 + description: 3GPP TS 29.503 Unified Data Management Services, version 18.3.0 url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.503/' servers: @@ -2906,6 +2906,83 @@ paths: default: description: Unexpected error + /{supi}/a2x-data: + get: + summary: retrieve a UE's A2X Subscription Data + operationId: GetA2xData + tags: + - A2X Subscription Data Retrieval + security: + - {} + - oAuth2ClientCredentials: + - nudm-sdm + - oAuth2ClientCredentials: + - nudm-sdm + - nudm-sdm:a2x-data:read + parameters: + - name: supi + in: path + description: Identifier of the UE + required: true + schema: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Supi' + - name: supported-features + in: query + description: Supported Features + schema: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' + - name: If-None-Match + in: header + description: Validator for conditional requests, as described in RFC 7232, 3.2 + schema: + type: string + - name: If-Modified-Since + in: header + description: Validator for conditional requests, as described in RFC 7232, 3.3 + schema: + type: string + responses: + '200': + description: Expected response to a valid request + content: + application/json: + schema: + $ref: '#/components/schemas/A2xSubscriptionData' + headers: + Cache-Control: + description: Cache-Control containing max-age, as described in RFC 7234, 5.2 + schema: + type: string + ETag: + description: Entity Tag, containing a strong validator, as described in RFC 7232, 2.3 + schema: + type: string + Last-Modified: + description: Timestamp for last modification of the resource, as described in RFC 7232, 2.2 + schema: + type: string + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '406': + $ref: 'TS29571_CommonData.yaml#/components/responses/406' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + default: + description: Unexpected error + + components: securitySchemes: oAuth2ClientCredentials: @@ -2949,6 +3026,8 @@ components: nudm-sdm:group-identifiers:read: Access to read Group Identifiers nudm-sdm:multiple-identifiers:read: Access to read multiple Identifiers nudm-sdm:ranging-slpos-data:read: Access to read Ranging and Sidelink Positioning data + nudm-sdm:a2x-data:read: Access to read A2X data + schemas: @@ -2998,6 +3077,8 @@ components: $ref: '#/components/schemas/MbsSubscriptionData' ucData: $ref: '#/components/schemas/UcSubscriptionData' + a2xData: + $ref: '#/components/schemas/A2xSubscriptionData' UeContextInSmsfData: type: object @@ -3201,6 +3282,10 @@ components: items: $ref: '#/components/schemas/SharedData' minItems: 1 + qmcConfigInfo: + $ref: 'TS29571_CommonData.yaml#/components/schemas/QmcConfigInfo' + mbsrOperationAllowed: + $ref: '#/components/schemas/MbsrOperationAllowed' TimeSyncData: type: object @@ -3222,38 +3307,13 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Tai' minItems: 1 clockQualityDetailLevel: - $ref: '#/components/schemas/ClockQualityDetailLevel' + $ref: 'TS29571_CommonData.yaml#/components/schemas/ClockQualityDetailLevel' clockQualityAcceptanceCriteria: type: array items: - $ref: '#/components/schemas/ClockQualityAcceptanceCriterion' + $ref: 'TS29571_CommonData.yaml#/components/schemas/ClockQualityAcceptanceCriterion' minItems: 1 - ClockQualityAcceptanceCriterion: - description: Contains a Clock Quality Acceptance Criterion. - type: object - properties: - synchronizationState: - $ref: '#/components/schemas/SynchronizationState' - clockQuality: - $ref: '#/components/schemas/ClockQuality' - parentTimeSource: - $ref: '#/components/schemas/TimeSource' - - ClockQuality: - description: Contains Clock Quality. - type: object - properties: - traceabilityToGnss: - type: boolean - traceabilityToUtc: - type: boolean - frequencyStability: - $ref: 'TS29571_CommonData.yaml#/components/schemas/Uint16' - clockAccuracy: - type: string - pattern: '^[A-Fa-f0-9]{2}$' - PcfSelectionAssistanceInfo: type: object @@ -3548,6 +3608,8 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/NfInstanceId' registrationTime: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' + wildcardInd: + type: boolean SessionManagementSubscriptionData: type: object @@ -3616,8 +3678,18 @@ components: $ref: '#/components/schemas/3GppChargingCharacteristics' nsacMode: $ref: '#/components/schemas/NsacAdmissionMode' + sessInactTimer: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' + onDemand: + type: boolean + default: false supportedFeatures: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' + additionalSharedDnnConfigurationsIds: + type: array + items: + $ref: '#/components/schemas/SharedDataId' + minItems: 1 DnnConfiguration: type: object @@ -3966,6 +4038,8 @@ components: $ref: '#/components/schemas/SorTransparentContainer' sorCmci: $ref: '#/components/schemas/SorCmci' + sorSnpnSiLs: + $ref: '#/components/schemas/SorSnpnSiLs' storeSorCmciInMe: type: boolean usimSupportOfSorCmci: @@ -4130,6 +4204,11 @@ components: $ref: '#/components/schemas/NsacAdmissionMode' validTimePeriod: $ref: '#/components/schemas/ValidTimePeriod' + deregInactTimer: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' + onDemand: + type: boolean + default: false AppPortId: type: object @@ -4154,7 +4233,13 @@ components: evtRptExpectedArea: $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/GeographicArea' areaUsageInd: - $ref: '#/components/schemas/AreaUsageInd' + allOf: + - $ref: '#/components/schemas/AreaUsageInd' + default: POSITIVE_SENSE + upLocRepIndAf: + allOf: + - $ref: '#/components/schemas/UpLocRepIndAf' + default: USER_PLANE_REPORT_NOT_ALLOWED Lpi: type: object @@ -4310,6 +4395,9 @@ components: $ref: '#/components/schemas/PruInd' lpHapType: $ref: 'TS29518_Namf_Location.yaml#/components/schemas/LpHapType' + userPlanePosIndLmf: + type: boolean + default: false LcsBroadcastAssistanceTypesData: @@ -4717,6 +4805,48 @@ components: accuracyLevel: type: string + A2xSubscriptionData: + type: object + properties: + nrA2xServicesAuth: + $ref: 'TS29571_CommonData.yaml#/components/schemas/NrA2xAuth' + lteA2xServicesAuth: + $ref: 'TS29571_CommonData.yaml#/components/schemas/LteA2xAuth' + nrUePc5Ambr: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + ltePc5Ambr: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + + RangingSlPosQos: + type: object + properties: + hAccuracy: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Accuracy' + vAccuracy: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Accuracy' + relativeHAccuracy: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Accuracy' + relativeVAccuracy: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Accuracy' + distanceAccuracy: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Accuracy' + directionAccuracy: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Accuracy' + verticalRequested: + type: boolean + responseTime: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/ResponseTime' + lcsQosClass: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/LcsQosClass' + + MbsrOperationAllowed: + type: object + properties: + mbsrOperationAllowedInd: + type: boolean + mbsrValidTimePeriod: + $ref: '#/components/schemas/ValidTimePeriod' + # SIMPLE TYPES: @@ -4791,6 +4921,9 @@ components: SorCmci: $ref: 'TS29571_CommonData.yaml#/components/schemas/Bytes' + SorSnpnSiLs: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Bytes' + RangingSlPosSubscriptionData: description: Contains the Ranging/SL positioning Subscription Data. type: object @@ -4802,6 +4935,8 @@ components: items: $ref: '#/components/schemas/RangingSlPosPlmn' minItems: 1 + rangingSlPosQos: + $ref: '#/components/schemas/RangingSlPosQos' RangingSlPosPlmn: description: Contains the PLMN identities where the Ranging/SL Positioning services are authorised to use and the authorised Ranging/SL Positioning services on this given PLMNs. @@ -4841,6 +4976,7 @@ components: - PROSE - UC - MBS + - A2X - type: string description: > This string provides forward-compatibility with future @@ -5139,51 +5275,6 @@ components: extensions to the enumeration but is not used to encode content defined in the present version of this API. - ClockQualityDetailLevel: - description: Indicates the Clock Quality Detail Level. - anyOf: - - type: string - enum: - - CLOCK_QUALITY_METRICS - - ACCEPT_INDICATION - - 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. - - SynchronizationState: - description: Indicates the Synchronization State. - anyOf: - - type: string - enum: - - LOCKED - - HOLDOVER - - FREERUN - - 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. - - TimeSource: - description: Indicates the Time Source. - anyOf: - - type: string - enum: - - PTP - - GNSS - - ATOMIC_CLOCK - - TERRESTRIAL_RADIO - - SERIAL_TIME_CODE - - NTP - - HAND_SET - - OTHER - - 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. RangingSlPosAllowed: description: > @@ -5221,3 +5312,18 @@ components: 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. + + UpLocRepIndAf: + description: > + Indicates one of the mutually exclusive global settings for location reporting over user + plane connectivity to an LCS client or AF. + anyOf: + - type: string + enum: + - USER_PLANE_REPORT_ALLOWED + - USER_PLANE_REPORT_NOT_ALLOWED + - 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/TS29503_Nudm_UEAU.yaml b/TS29503_Nudm_UEAU.yaml index 31986c80..814439c5 100644 --- a/TS29503_Nudm_UEAU.yaml +++ b/TS29503_Nudm_UEAU.yaml @@ -1,6 +1,6 @@ openapi: 3.0.0 info: - version: '1.3.0-alpha.2' + version: '1.3.0-alpha.3' title: 'Nudm_UEAU' description: | UDM UE Authentication Service. @@ -8,7 +8,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.503 Unified Data Management Services, version 18.1.0 + description: 3GPP TS 29.503 Unified Data Management Services, version 18.3.0 url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.503/' servers: @@ -541,6 +541,9 @@ components: disasterRoamingInd: type: boolean default: false + aun3Ind: + type: boolean + default: false AuthenticationInfoResult: type: object @@ -569,6 +572,9 @@ components: items: $ref: 'TS29571_CommonData.yaml#/components/schemas/ServerAddressingInfo' minItems: 1 + mskInd: + type: boolean + default: false AuthenticationVector: oneOf: diff --git a/TS29503_Nudm_UECM.yaml b/TS29503_Nudm_UECM.yaml index b3da1bf2..892be97f 100644 --- a/TS29503_Nudm_UECM.yaml +++ b/TS29503_Nudm_UECM.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: '1.3.0-alpha.3' + version: '1.3.0-alpha.4' title: 'Nudm_UECM' description: | Nudm Context Management Service. @@ -9,7 +9,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.503 Unified Data Management Services, version 18.2.0 + description: 3GPP TS 29.503 Unified Data Management Services, version 18.3.0 url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.503/' servers: @@ -335,6 +335,46 @@ paths: $ref: 'TS29571_CommonData.yaml#/components/responses/503' default: description: Unexpected error + reauthNotification: + '{request.body#/reauthNotifyCallbackUri}': + post: + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/ReauthNotificationInfo' + responses: + '204': + description: Successful Notification response + '307': + $ref: 'TS29571_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29571_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29571_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29571_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29571_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + default: + description: Unexpected error patch: summary: Update a parameter in the AMF registration for 3GPP access @@ -817,6 +857,47 @@ paths: $ref: 'TS29571_CommonData.yaml#/components/responses/503' default: description: Unexpected error + reauthNotification: + '{request.body#/reauthNotifyCallbackUri}': + post: + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/ReauthNotificationInfo' + responses: + '204': + description: Successful Notification response + '307': + $ref: 'TS29571_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29571_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29571_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29571_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29571_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + default: + description: Unexpected error + patch: summary: update a parameter in the AMF registration for non-3GPP access operationId: UpdateNon3GppRegistration @@ -1185,6 +1266,52 @@ paths: $ref: 'TS29571_CommonData.yaml#/components/responses/503' default: description: Unexpected error + staleCheckNotification: + '{request.body#/staleCheckCallbackUri}': + post: + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/PduSessionIds' + responses: + '200': + description: Partial Success + content: + application/json: + schema: + $ref: '#/components/schemas/PduSessionIds' + '204': + description: Successful Notification response + '307': + $ref: 'TS29571_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29571_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29571_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29571_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29571_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + default: + description: Unexpected error delete: summary: delete an SMF registration operationId: SmfDeregistration @@ -2457,6 +2584,53 @@ paths: default: description: Unexpected error + /{ueId}/registrations/auth-trigger: + get: + summary: trigger the primary (re-)authentication + operationId: authTrigger + tags: + - Trigger the primary (re-)authentication + parameters: + - name: ueId + in: path + description: Identifier of the UE + required: true + schema: + $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId' + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/AuthTriggerInfo' + required: true + responses: + '204': + description: No content + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29571_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29571_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29571_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + default: + description: Unexpected error + components: securitySchemes: oAuth2ClientCredentials: @@ -2624,6 +2798,9 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/PlmnId' AmfNon3GppAccessRegistration: + description: > + Represents the complete set of information relevant to the AMF when the UE has registered + via non 3GPP access. type: object required: - amfInstanceId @@ -2778,6 +2955,21 @@ components: pduSessionReActivationRequired: type: boolean default: false + staleCheckCallbackUri: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' + udmStaleCheckCallbackUri: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' + wildcardInd: + type: boolean + + PduSessionIds: + type: object + properties: + pduSessionIdList: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/PduSessionId' + minItems: 1 SmsfRegistration: description: > @@ -3004,6 +3196,7 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Pei' RegistrationDatasetNames: + description: Represents the UECM registration dataset names. type: array items: $ref: '#/components/schemas/RegistrationDataSetName' @@ -3255,6 +3448,20 @@ components: enum: - true + ReauthNotificationInfo: + description: Contains the SUPI to identify the UE that is subject to reauthentication + type: object + required: + - supi + properties: + supi: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Supi' + + AuthTriggerInfo: + type: object + properties: + supi: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Supi' # SIMPLE TYPES: @@ -3310,7 +3517,6 @@ components: - REREGISTRATION_REQUIRED - SMF_CONTEXT_TRANSFERRED - DUPLICATE_PDU_SESSION - - 5G_SRVCC_TO_UTRAN_MOBILITY - PDU_SESSION_REACTIVATION_REQUIRED - DISASTER_CONDITION_TERMINATED - type: string diff --git a/TS29504_Nudr_DR.yaml b/TS29504_Nudr_DR.yaml index f85e18fa..bdd42756 100644 --- a/TS29504_Nudr_DR.yaml +++ b/TS29504_Nudr_DR.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: 2.3.0-alpha.3 + version: 2.3.0-alpha.4 title: 'Nudr_DataRepository API OpenAPI file' description: | Unified Data Repository Service. @@ -9,7 +9,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.504 V18.2.0; 5G System; Unified Data Repository Services; Stage 3 + description: 3GPP TS 29.504 V18.3.0; 5G System; Unified Data Repository Services; Stage 3 url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.504/' servers: @@ -175,6 +175,8 @@ paths: $ref: 'TS29505_Subscription_Data.yaml#/paths/~1subscription-data~1%7BueId%7D~1time-sync-data' /subscription-data/{ueId}/ranging-slpos-data: $ref: 'TS29505_Subscription_Data.yaml#/paths/~1subscription-data~1%7BueId%7D~1ranging-slpos-data' + /subscription-data/{ueId}/a2x-data: + $ref: 'TS29505_Subscription_Data.yaml#/paths/~1subscription-data~1%7BueId%7D~1a2x-data' /policy-data/ues/{ueId}: $ref: 'TS29519_Policy_Data.yaml#/paths/~1policy-data~1ues~1%7BueId%7D' /policy-data/ues/{ueId}/am-data: diff --git a/TS29505_Subscription_Data.yaml b/TS29505_Subscription_Data.yaml index 6fde5198..61877149 100644 --- a/TS29505_Subscription_Data.yaml +++ b/TS29505_Subscription_Data.yaml @@ -9,7 +9,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.505 V18.2.0; 5G System; Usage of the Unified Data Repository Service for subscription data; Stage 3 + description: 3GPP TS 29.505 V18.3.0; 5G System; Usage of the Unified Data Repository Service for subscription data; Stage 3 url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.505/' paths: @@ -2051,6 +2051,47 @@ paths: $ref: 'TS29571_CommonData.yaml#/components/responses/503' default: $ref: 'TS29571_CommonData.yaml#/components/responses/default' + callbacks: + staleCheckNotification: + '{request.body#/udmStaleCheckCallbackUri}': + post: + requestBody: + required: true + content: + application/json: + schema: + $ref: 'TS29503_Nudm_UECM.yaml#/components/schemas/SmfRegistrationInfo' + responses: + '204': + description: Successful Notification response + '307': + $ref: 'TS29571_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29571_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29571_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29571_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29571_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + default: + description: Unexpected error delete: summary: To remove an individual SMF context data of a UE the UDR @@ -10088,6 +10129,82 @@ paths: default: $ref: 'TS29571_CommonData.yaml#/components/responses/default' + /subscription-data/{ueId}/a2x-data: + get: + summary: Retrieves the subscribed A2X Data of a UE + operationId: QueryA2xData + tags: + - A2X Subscription Data + security: + - {} + - oAuth2ClientCredentials: + - nudr-dr + - oAuth2ClientCredentials: + - nudr-dr + - nudr-dr:subscription-data + parameters: + - name: ueId + in: path + description: UE id + required: true + schema: + $ref: 'TS29571_CommonData.yaml#/components/schemas/VarUeId' + - name: supported-features + in: query + description: Supported Features + schema: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' + - name: If-None-Match + in: header + description: Validator for conditional requests, as described in RFC 7232, 3.2 + schema: + type: string + - name: If-Modified-Since + in: header + description: Validator for conditional requests, as described in RFC 7232, 3.3 + schema: + type: string + responses: + '200': + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/A2xSubscriptionData' + headers: + Cache-Control: + description: Cache-Control containing max-age, as described in RFC 7234, 5.2 + schema: + type: string + ETag: + description: Entity Tag, containing a strong validator, as described in RFC 7232, 2.3 + schema: + type: string + Last-Modified: + description: Timestamp for last modification of the resource, as described in RFC 7232, 2.2 + schema: + type: string + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '406': + $ref: 'TS29571_CommonData.yaml#/components/responses/406' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29571_CommonData.yaml#/components/responses/default' + components: schemas: AuthenticationSubscription: @@ -10204,6 +10321,7 @@ components: - USER_CONSENT - MBS - PP_DATA + - A2X - type: string UeSubscribedDatasetNames: @@ -10266,6 +10384,8 @@ components: $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/MbsSubscriptionData' ppData: $ref: '#/components/schemas/PpData' + a2xData: + $ref: '#/components/schemas/A2xSubscriptionData' AccessAndMobilitySubscriptionData: $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/AccessAndMobilitySubscriptionData' @@ -10297,6 +10417,9 @@ components: $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/LcsMoData' LcsSubscriptionData: $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/LcsSubscriptionData' + A2xSubscriptionData: + $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/A2xSubscriptionData' + AuthorizationData: description: NIDD Authorization Information required: diff --git a/TS29507_Npcf_AMPolicyControl.yaml b/TS29507_Npcf_AMPolicyControl.yaml index bfab13bb..64f58d9a 100644 --- a/TS29507_Npcf_AMPolicyControl.yaml +++ b/TS29507_Npcf_AMPolicyControl.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: 1.3.0-alpha.3 + version: 1.3.0-alpha.4 title: Npcf_AMPolicyControl description: | Access and Mobility Policy Control Service. @@ -9,7 +9,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.507 V18.2.0; 5G System; Access and Mobility Policy Control Service. + description: 3GPP TS 29.507 V18.3.0; 5G System; Access and Mobility Policy Control Service. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.507/' servers: @@ -355,8 +355,6 @@ components: description: > Contains the presence reporting area(s) for which reporting was requested. The praId attribute within the PresenceInfo data type is the key of the map. - suppFeat: - $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' pcfUeInfo: $ref: 'TS29571_CommonData.yaml#/components/schemas/PcfUeCallbackInfo' matchPdus: @@ -366,6 +364,18 @@ components: nullable: true asTimeDisParam: $ref: '#/components/schemas/AsTimeDistributionParam' + sliceUsgCtrlInfoSets: + type: object + additionalProperties: + $ref: '#/components/schemas/SliceUsgCtrlInfo' + minProperties: 1 + description: > + Represents the network slice usage control information. + The key of the map is the on-demand S-NSSAI (within the "snssai" attribute of the + corresponding map value) to which the network slice usage control information is + related. + suppFeat: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' required: - suppFeat @@ -449,7 +459,7 @@ components: items: $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' minItems: 1 - partAllowedNssais: + partAllowedNssai: type: object additionalProperties: $ref: 'TS29571_CommonData.yaml#/components/schemas/PartiallyAllowedSnssai' @@ -457,6 +467,25 @@ components: description: > Represents the Partially Allowed NSSAI. The "snssai" attribute within the PartiallyAllowedSnssai data type shall be the key of the map. + snssaisPartRejected: + type: object + additionalProperties: + $ref: '#/components/schemas/SnssaiPartRejected' + minProperties: 1 + description: > + Represents the set of S-NSSAI(s) partially rejected in the RA. + The "snssai" attribute within the SnssaiPartRejected data type shall be the key of the + map. + rejectedSnssais: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + minItems: 1 + pendingNssai: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + minItems: 1 targetSnssais: description: array of target S-NSSAIs. type: array @@ -561,6 +590,33 @@ components: items: $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' minItems: 1 + partAllowedNssai: + type: object + additionalProperties: + $ref: 'TS29571_CommonData.yaml#/components/schemas/PartiallyAllowedSnssai' + minProperties: 1 + description: > + Represents the Partially Allowed NSSAI. The "snssai" attribute within the + PartiallyAllowedSnssai data type shall be the key of the map. + snssaisPartRejected: + type: object + additionalProperties: + $ref: '#/components/schemas/SnssaiPartRejected' + minProperties: 1 + description: > + Represents the set of S-NSSAI(s) partially rejected in the RA. + The "snssai" attribute within the SnssaiPartRejected data type shall be the key of the + map. + rejectedSnssais: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + minItems: 1 + pendingNssai: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + minItems: 1 targetSnssais: description: array of target S-NSSAIs. type: array @@ -591,7 +647,9 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' minItems: 1 unavailSnssais: - description: Represents the unavailable S-NSSAIs that require slice replacement. + description: > + Represents the unavailable S-NSSAI(s) from the UE's Allowed NSSAI and/or + Partially Allowed NSSAI that require network slice replacement. type: array items: $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' @@ -672,6 +730,19 @@ components: minProperties: 1 description: > Contains the network slice replacement information. + The key of the map is the concerned unavailable S-NSSAI (within the "snssai" attribute + of the corresponding map value) to which the network slice replacement information is + related. + sliceUsgCtrlInfoSets: + type: object + additionalProperties: + $ref: '#/components/schemas/SliceUsgCtrlInfo' + minProperties: 1 + description: > + Represents the updated network slice usage control information. + The key of the map is the on-demand S-NSSAI (within the "snssai" attribute of the + corresponding map value) to which the network slice usage control information is + related. suppFeat: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' required: @@ -764,6 +835,33 @@ components: type: array items: $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + partAllowedNssai: + type: object + additionalProperties: + $ref: 'TS29571_CommonData.yaml#/components/schemas/PartiallyAllowedSnssai' + minProperties: 1 + description: > + Represents the Partially Allowed NSSAI. The "snssai" attribute within the + PartiallyAllowedSnssai data type shall be the key of the map. + snssaisPartRejected: + type: object + additionalProperties: + $ref: '#/components/schemas/SnssaiPartRejected' + minProperties: 1 + description: > + Represents the set of S-NSSAI(s) partially rejected in the RA. + The "snssai" attribute within the SnssaiPartRejected data type shall be the key of the + map. + rejectedSnssais: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + minItems: 1 + pendingNssai: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + minItems: 1 AsTimeDistributionParam: description: Contains the 5G acess stratum time distribution parameters. @@ -774,9 +872,9 @@ components: uuErrorBudget: $ref: 'TS29571_CommonData.yaml#/components/schemas/UintegerRm' clkQltDetLvl: - $ref: 'TS29522_TimeSyncExposure.yaml#/components/schemas/ClkQltDetLvl' + $ref: 'TS29571_CommonData.yaml#/components/schemas/ClockQualityDetailLevel' clkQltAcptCri: - $ref: 'TS29522_TimeSyncExposure.yaml#/components/schemas/ClkQltAcptCri' + $ref: 'TS29571_CommonData.yaml#/components/schemas/ClockQualityAcceptanceCriterion' nullable: true UeSliceMbr: @@ -798,6 +896,39 @@ components: - servingSnssai nullable: true + SliceUsgCtrlInfo: + description: Represents network slice usage control information. + type: object + properties: + snssai: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + deregInactivTimer: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSecRm' + required: + - snssai + + SnssaiPartRejected: + description: Represents the list of the S-NSSAI(s) partially rejected in the RA. + type: object + properties: + snssai: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + allowedTaiList: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Tai' + minItems: 1 + rejectedTaiList: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Tai' + minItems: 1 + required: + - snssai + oneOf: + - required: [ allowedTaiList ] + - required: [ rejectedTaiList ] + RequestTrigger: anyOf: - type: string @@ -815,6 +946,10 @@ components: - TARGET_NSSAI - SLICE_REPLACE_MGMT - FEAT_RENEG + - PARTIALLY_ALLOWED_NSSAI_CH + - SNSSAIS_PARTIALLY_REJECTED_CH + - REJECTED_SNSSAIS_CH + - PENDING_NSSAI_CH - type: string description: > This string provides forward-compatibility with future @@ -849,10 +984,20 @@ components: have changed. - TARGET_NSSAI: Generation of Target NSSAI. The NF service consumer notifies that the Target NSSAI was generated. - - SLICE_REPLACE_MGMT: the AMF notifies that slice replacement is needed and it cannot - determine the Alternative S-NSSAI for an S-NSSAI. + - SLICE_REPLACE_MGMT: Indicates that slice replacement is needed for one or more S-NSSAI(s) + of the UE's Allowed NSSAI and/or Partially Allowed NSSAI and the AMF cannot determine the + Alternative S-NSSAI(s) for these S-NSSAI(s). - FEAT_RENEG: The NF service consumer notifies that the target AMF is requesting feature re-negotiation. + - PARTIALLY_ALLOWED_NSSAI_CH: Partially Allowed NSSAI change. The NF service consumer + notifies that the set of Partially Allowed S-NSSAI(s) of the UE has changed. + - SNSSAIS_PARTIALLY_REJECTED_CH: Change of the S-NSSAI(s) partially rejected in the RA. The + NF service consumer notifies that the set of S-NSSAI(s) partially rejected in the RA for + the UE has changed. + - REJECTED_SNSSAIS_CH: Change of the Rejected S-NSSAI(s) in the RA. The NF service consumer + notifies that the set of the Rejected S-NSSAI(s) in the RA for the UE has changed. + - PENDING_NSSAI_CH: Pending NSSAI change. The NF service consumer notifies that the set of + Pending S-NSSAI(s) of the UE has changed. PolicyAssociationReleaseCause: anyOf: diff --git a/TS29508_Nsmf_EventExposure.yaml b/TS29508_Nsmf_EventExposure.yaml index 5dd95c2d..80a08a16 100644 --- a/TS29508_Nsmf_EventExposure.yaml +++ b/TS29508_Nsmf_EventExposure.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: 1.3.0-alpha.3 + version: 1.3.0-alpha.4 title: Nsmf_EventExposure description: | Session Management Event Exposure Service. @@ -9,7 +9,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.508 V18.2.0; 5G System; Session Management Event Exposure Service. + description: 3GPP TS 29.508 V18.3.0; 5G System; Session Management Event Exposure Service. url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.508/ servers: @@ -640,6 +640,13 @@ components: items: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' minItems: 1 + ulConInfo: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + dlConInfo: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + cimf: + type: boolean + description: Represents the congestion information measurement failure indicator. timeWindow: $ref: 'TS29122_CommonData.yaml#/components/schemas/TimeWindow' smNasFromUe: diff --git a/TS29509_Nausf_UEAuthentication.yaml b/TS29509_Nausf_UEAuthentication.yaml index c565261f..9f25a827 100644 --- a/TS29509_Nausf_UEAuthentication.yaml +++ b/TS29509_Nausf_UEAuthentication.yaml @@ -1,6 +1,6 @@ openapi: 3.0.0 info: - version: 1.3.0-alpha.2 + version: 1.3.0-alpha.3 title: AUSF API description: | AUSF UE Authentication Service. @@ -8,7 +8,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.509 V18.1.0; 5G System; 3GPP TS Authentication Server services. + description: 3GPP TS 29.509 V18.2.0; 5G System; 3GPP TS Authentication Server services. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.509' servers: @@ -48,7 +48,7 @@ paths: $ref: '#/components/schemas/UEAuthenticationCtx' headers: Location: - description: 'Contains the URI of the newly created resource according to the structure: {apiRoot}/nausf-auth/v1/ue-authentications/{authCtxId}' + description: 'Contains the URI of the newly created resource according to the structure: {apiRoot}/nausf-auth//ue-authentications/{authCtxId}' required: true schema: type: string @@ -399,7 +399,7 @@ paths: $ref: '#/components/schemas/RgAuthCtx' headers: Location: - description: 'Contains the URI of the newly created resource according to the structure: {apiRoot}/nausf-auth/v1/rg-authentications/{authCtxId}' + description: 'Contains the URI of the newly created resource according to the structure: {apiRoot}/nausf-auth//rg-authentications/{authCtxId}' required: true schema: type: string @@ -473,7 +473,7 @@ paths: $ref: '#/components/schemas/ProSeAuthenticationCtx' headers: Location: - description: 'Contains the URI of the newly created resource according to the structure: {apiRoot}/nausf-auth/v1/prose-authentications/{authCtxId}' + description: 'Contains the URI of the newly created resource according to the structure: {apiRoot}/nausf-auth//prose-authentications/{authCtxId}' required: true schema: type: string @@ -677,6 +677,9 @@ components: onboardingInd: type: boolean default: false + aun3Ind: + type: boolean + default: false required: - supiOrSuci - servingNetworkName @@ -934,6 +937,7 @@ components: - eapPayload ProSeAuthData: + description: Represents ProSe authentication related information. oneOf: - $ref: '#/components/schemas/EapPayload' diff --git a/TS29510_Nnrf_NFDiscovery.yaml b/TS29510_Nnrf_NFDiscovery.yaml index 2a926bf7..22490d59 100644 --- a/TS29510_Nnrf_NFDiscovery.yaml +++ b/TS29510_Nnrf_NFDiscovery.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: '1.3.0-alpha.4' + version: '1.3.0-alpha.5' title: 'NRF NFDiscovery Service' description: | NRF NFDiscovery Service. @@ -9,7 +9,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.510 V18.3.0; 5G System; Network Function Repository Services; Stage 3 + description: 3GPP TS 29.510 V18.4.0; 5G System; Network Function Repository Services; Stage 3 url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.510/' servers: @@ -561,6 +561,13 @@ paths: application/json: schema: $ref: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/TwifInfo' + - name: upf-select-epdg-info + in: query + description: The ePDG information to find a preferred UPF + content: + application/json: + schema: + $ref: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/EpdgInfo' - name: target-nf-set-id in: query description: Target NF Set ID @@ -603,23 +610,23 @@ paths: explode: false - name: imsi in: query - description: IMSI of the requester UE to search for an appropriate NF (e.g. HSS) + description: IMSI of the requester UE to search for an appropriate NF (e.g. HSS, DCSF) schema: type: string pattern: '^[0-9]{5,15}$' - name: ims-private-identity in: query - description: IMPI of the requester UE to search for a target HSS + description: IMPI of the requester UE to search for a target HSS or DCSF schema: type: string - name: ims-public-identity in: query - description: IMS Public Identity of the requester UE to search for a target HSS + description: IMS Public Identity of the requester UE to search for a target HSS or DCSF schema: type: string - name: msisdn in: query - description: MSISDN of the requester UE to search for a target HSS + description: MSISDN of the requester UE to search for a target HSS or DCSF schema: type: string - name: preferred-api-versions @@ -870,6 +877,13 @@ paths: items: $ref: 'TS29571_CommonData.yaml#/components/schemas/Tai' minItems: 1 + - name: nf-tai-list-ind + in: query + description: the NF service consumer supports candidate nfs supporting a subset of TAIs + schema: + type: boolean + enum: + - true - name: preferences-precedence in: query description: > @@ -892,6 +906,20 @@ paths: description: UAS NF functionality is supported by NEF or not schema: type: boolean + - name: multi-mem-af-sess-qos-ind + in: query + description: Multi-member AF session with required QoS is supported by NEF or not + schema: + type: boolean + enum: + - true + - name: member-ue-sel-assist-ind + in: query + description: member UE selection assistance functionality is supported by NEF or not + schema: + type: boolean + enum: + - true - name: v2x-capability in: query description: indicates the V2X capability that the target PCF needs to support. @@ -1023,6 +1051,11 @@ paths: application/json: schema: $ref: 'TS29571_CommonData.yaml#/components/schemas/Tai' + - name: pru-support-ind + in: query + description: Indicating the support of PRU function + schema: + type: boolean - name: af-data in: query description: events supported by the trusted AFs being discovered @@ -1044,6 +1077,61 @@ paths: type: boolean enum: - true + - name: a2x-support-ind + in: query + description: PCF supports A2X + schema: + type: boolean + - name: a2x-capability + in: query + description: indicates the A2X capability that the target PCF needs to support. + content: + application/json: + schema: + $ref: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/A2xCapability' + - name: ml-model-storage-ind + in: query + description: Indicating the support for ML model storage capability. + schema: + type: boolean + enum: + - true + - name: data-subscription-relocation-support-ind + in: query + description: Indicating the support for relocation of data subscription. + schema: + type: boolean + enum: + - true + - name: ims-domain-name + in: query + description: Indicating the IMS domain name to search for a target DCSF. + schema: + type: string + - name: media-capability-list + in: query + description: Indicating the media capability list to search for a target MF, MRF or MRFP. + schema: + type: array + items: + $ref: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/MediaCapability' + minItems: 1 + style: form + explode: false + - name: roaming-exchange-ind + in: query + description: Indicating the support for roaming exchange. + schema: + type: boolean + enum: + - true + - name: rangingSlPos-support-ind + in: query + description: PCF or LMF supports ranging and sidelink positioning Capability + schema: + type: boolean + enum: + - true responses: '200': @@ -1536,6 +1624,8 @@ components: additionalProperties: $ref: '#/components/schemas/NfInstanceInfo' minProperties: 1 + searchResultInfo: + $ref: '#/components/schemas/SearchResultInfo' alteredPriorityInd: type: boolean noProfileMatchInfo: @@ -1644,6 +1734,12 @@ components: items: $ref: 'TS29571_CommonData.yaml#/components/schemas/ExtSnssai' minItems: 1 + allowedRuleSet: + description: A map (list of key-value pairs) where a valid JSON pointer Id serves as key + type: object + additionalProperties: + $ref: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/RuleSet' + minProperties: 1 capacity: type: integer minimum: 0 @@ -1967,13 +2063,23 @@ components: type: object additionalProperties: $ref: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/MrfpInfo' - dcmfInfoList: + mfInfoList: description: > A map (list of key-value pairs) where a (unique) valid JSON string - serves as key of DcmfInfo + serves as key of MfInfo + type: object + additionalProperties: + $ref: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/MfInfo' + adrfInfoList: type: object + description: > + A map (list of key-value pairs) where a (unique) valid JSON string + serves as key of AdrfInfo additionalProperties: - $ref: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/DcmfInfo' + $ref: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/AdrfInfo' + minProperties: 1 + selectionConditions: + $ref: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/SelectionConditions' NFService: description: > @@ -2011,6 +2117,8 @@ components: minItems: 1 apiPrefix: type: string + callbackUriPrefix: + type: string defaultNotificationSubscriptions: type: array items: @@ -2109,6 +2217,14 @@ components: allowedOperationsPerNfInstanceOverrides: type: boolean default: false + allowedScopesRuleSet: + description: A map (list of key-value pairs) where a valid JSON pointer Id serves as key + type: object + additionalProperties: + $ref: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/RuleSet' + minProperties: 1 + selectionConditions: + $ref: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/SelectionConditions' PreferredSearch: description: > @@ -2308,3 +2424,13 @@ components: minItems: 1 required: - afEvents + + SearchResultInfo: + description: Contains additional information to the search result + type: object + properties: + unsatisfiedTaiList: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Tai' + minItems: 1 diff --git a/TS29510_Nnrf_NFManagement.yaml b/TS29510_Nnrf_NFManagement.yaml index 493da260..64695d2d 100644 --- a/TS29510_Nnrf_NFManagement.yaml +++ b/TS29510_Nnrf_NFManagement.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: '1.3.0-alpha.4' + version: '1.3.0-alpha.5' title: 'NRF NFManagement Service' description: | NRF NFManagement Service. @@ -9,7 +9,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.510 V18.3.0; 5G System; Network Function Repository Services; Stage 3 + description: 3GPP TS 29.510 V18.4.0; 5G System; Network Function Repository Services; Stage 3 url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.510/' servers: @@ -288,6 +288,13 @@ paths: operationId: RegisterNFInstance tags: - NF Instance ID (Document) + security: + - {} + - oAuth2ClientCredentials: + - nnrf-nfm + - oAuth2ClientCredentials: + - nnrf-nfm + - nnrf-nfm:nf-instance:write parameters: - name: nfInstanceID in: path @@ -410,6 +417,13 @@ paths: operationId: UpdateNFInstance tags: - NF Instance ID (Document) + security: + - {} + - oAuth2ClientCredentials: + - nnrf-nfm + - oAuth2ClientCredentials: + - nnrf-nfm + - nnrf-nfm:nf-instance:write parameters: - name: nfInstanceID in: path @@ -523,6 +537,13 @@ paths: operationId: DeregisterNFInstance tags: - NF Instance ID (Document) + security: + - {} + - oAuth2ClientCredentials: + - nnrf-nfm + - oAuth2ClientCredentials: + - nnrf-nfm + - nnrf-nfm:nf-instance:write parameters: - name: nfInstanceID in: path @@ -936,6 +957,8 @@ components: Access to read the nf-instances resource, or an individual NF Instance ID resource nnrf-nfm:subscriptions:subs-complete-profile: > Access to subscribe to the complete profile of NF instances + nnrf-nfm:nf-instance:write: > + Access to write (create, update, delete) an individual NF Instance ID resource schemas: @@ -1031,6 +1054,12 @@ components: items: $ref: 'TS29571_CommonData.yaml#/components/schemas/ExtSnssai' minItems: 1 + allowedRuleSet: + description: A map (list of key-value pairs) where a valid JSON pointer Id serves as key + type: object + additionalProperties: + $ref: '#/components/schemas/RuleSet' + minProperties: 1 priority: type: integer minimum: 0 @@ -1368,14 +1397,25 @@ components: additionalProperties: $ref: '#/components/schemas/MrfpInfo' minProperties: 1 - dcmfInfoList: + mfInfoList: type: object description: > A map (list of key-value pairs) where a (unique) valid JSON string - serves as key of DcmfInfo + serves as key of MfInfo additionalProperties: - $ref: '#/components/schemas/DcmfInfo' + $ref: '#/components/schemas/MfInfo' minProperties: 1 + adrfInfoList: + type: object + description: > + A map (list of key-value pairs) where a (unique) valid JSON string + serves as key of AdrfInfo + additionalProperties: + $ref: '#/components/schemas/AdrfInfo' + minProperties: 1 + selectionConditions: + $ref: '#/components/schemas/SelectionConditions' + NFService: description: > @@ -1412,6 +1452,8 @@ components: minItems: 1 apiPrefix: type: string + callbackUriPrefix: + type: string defaultNotificationSubscriptions: type: array items: @@ -1463,6 +1505,12 @@ components: allowedOperationsPerNfInstanceOverrides: type: boolean default: false + allowedScopesRuleSet: + description: A map (list of key-value pairs) where a valid JSON pointer Id serves as key + type: object + additionalProperties: + $ref: '#/components/schemas/RuleSet' + minProperties: 1 priority: type: integer minimum: 0 @@ -1513,6 +1561,8 @@ components: type: boolean perPlmnOauth2ReqList: $ref: '#/components/schemas/PlmnOauth2' + selectionConditions: + $ref: '#/components/schemas/SelectionConditions' NFType: description: NF types known to NRF @@ -1578,7 +1628,7 @@ components: - DCSF - MRF - MRFP - - DCMF + - MF - type: string NefId: @@ -1995,6 +2045,7 @@ components: - P_BDT - P_PLMNUE - P_NSSCD + - P_PDTQ - type: string UdmInfo: @@ -2242,6 +2293,26 @@ components: $ref: '#/components/schemas/TngfInfo' twifInfo: $ref: '#/components/schemas/TwifInfo' + preferredEpdgInfoList: + type: array + items: + $ref: '#/components/schemas/EpdgInfo' + minItems: 1 + preferredWAgfInfoList: + type: array + items: + $ref: '#/components/schemas/WAgfInfo' + minItems: 1 + preferredTngfInfoList: + type: array + items: + $ref: '#/components/schemas/TngfInfo' + minItems: 1 + preferredTwifInfoList: + type: array + items: + $ref: '#/components/schemas/TwifInfo' + minItems: 1 priority: type: integer minimum: 0 @@ -2464,6 +2535,14 @@ components: $ref: '#/components/schemas/ProSeCapability' v2xCapability: $ref: '#/components/schemas/V2xCapability' + a2xSupportInd: + type: boolean + default: false + a2xCapability: + $ref: '#/components/schemas/A2xCapability' + rangingSlPosSupportInd: + type: boolean + default: false BsfInfo: description: Information of a BSF NF Instance @@ -2590,6 +2669,8 @@ components: additionalProperties: $ref: '#/components/schemas/DefSubServiceInfo' minProperties: 1 + callbackUriPrefix: + type: string NfSetCond: description: Subscription to a set of NFs based on their Set Id @@ -2739,6 +2820,7 @@ components: - DATA_RESTORATION_NOTIFICATION - TSCTS_NOTIFICATION - LCS_KEY_DELIVERY_NOTIFICATION + - UUAA_MM_AUTH_NOTIFICATION - type: string TransportProtocol: @@ -2834,8 +2916,6 @@ components: additionalProperties: allOf: - $ref: '#/components/schemas/NFService' - - not: - required: [ interPlmnFqdn ] - not: required: [ allowedPlmns ] - not: @@ -2866,6 +2946,7 @@ components: - REGISTERED - SUSPENDED - UNDISCOVERABLE + - CANARY_RELEASE - type: string NFServiceVersion: @@ -2942,6 +3023,8 @@ components: - 3gpp-mbs-session - 3gpp-authentication - 3gpp-asti + - 3gpp-pdtq-policy-negotiation + - 3gpp-musa - npcf-am-policy-control - npcf-smpolicycontrol - npcf-policyauthorization @@ -2949,6 +3032,7 @@ components: - npcf-eventexposure - npcf-ue-policy-control - npcf-am-policyauthorization + - npcf-pdtq-policy-control - nsmsf-sms - nnssf-nsselection - nnssf-nssaiavailability @@ -3041,6 +3125,7 @@ components: - REGISTERED - SUSPENDED - UNDISCOVERABLE + - CANARY_RELEASE - type: string TaiRange: @@ -3531,6 +3616,12 @@ components: uasNfFunctionalityInd: type: boolean default: false + multiMemAfSessQosInd: + type: boolean + default: false + memberUESelAssistInd: + type: boolean + default: false PfdData: description: List of Application IDs and/or AF IDs managed by a given NEF Instance @@ -3634,6 +3725,12 @@ components: minItems: 1 pruExistenceInfo: $ref: '#/components/schemas/PruExistenceInfo' + pruSupportInd: + type: boolean + default: false + rangingslposSupportInd: + type: boolean + default: false GmlcInfo: description: Information of a GMLC NF Instance @@ -4136,6 +4233,9 @@ components: analyticsAccuracyChecking: type: boolean default: false + roamingExchange: + type: boolean + default: false EasdfInfo: description: Information of an EASDF NF Instance @@ -4212,6 +4312,9 @@ components: items: $ref: '#/components/schemas/TaiRange' minItems: 1 + dataSubsRelocInd: + type: boolean + default: false ScpCapability: description: Indicates the capabilities supported by an SCP @@ -4847,6 +4950,7 @@ components: items: $ref: '#/components/schemas/VendorId' minItems: 1 + PruExistenceInfo: description: PRU Existence Information type: object @@ -4893,8 +4997,8 @@ components: $ref: '#/components/schemas/MediaCapability' minItems: 1 - DcmfInfo: - description: Information of a Dcmf NF Instance + MfInfo: + description: Information of a MF NF Instance type: object properties: mediaCapabilityList: @@ -4903,6 +5007,24 @@ components: $ref: '#/components/schemas/MediaCapability' minItems: 1 + EpdgInfo: + description: Information of the ePDG end-points + type: object + anyOf: + - required: [ ipv4EndpointAddresses ] + - required: [ ipv6EndpointAddresses ] + properties: + ipv4EndpointAddresses: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Ipv4Addr' + minItems: 1 + ipv6EndpointAddresses: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Ipv6Addr' + minItems: 1 + MediaCapability: description: IMS media capability offered by NF instance anyOf: @@ -4917,3 +5039,164 @@ components: 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. + + A2xCapability: + description: Indicate the supported A2X Capability by the PCF. + type: object + properties: + lteA2x: + type: boolean + default: false + nrA2x: + type: boolean + default: false + + RuleSet: + type: object + required: + - priority + - action + properties: + priority: + type: integer + minimum: 0 + maximum: 65535 + plmns: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/PlmnId' + minItems: 1 + snpns: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/PlmnIdNid' + minItems: 1 + nfTypes: + type: array + items: + $ref: '#/components/schemas/NFType' + minItems: 1 + nfDomains: + type: array + items: + type: string + minItems: 1 + nssais: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/ExtSnssai' + minItems: 1 + nfInstances: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/NfInstanceId' + scopes: + type: array + items: + type: string + minItems: 1 + action: + $ref: '#/components/schemas/RuleSetAction' + + RuleSetAction: + anyOf: + - type: string + enum: + - ALLOW + - DENY + - type: string + + AdrfInfo: + description: Information of an ADRF NF Instance + type: object + properties: + mlModelStorageCapability: + type: boolean + default: false + + SelectionConditions: + description: > + It contains the set of conditions that shall be evaluated to determine whether a consumer + shall select a given producer. The producer shall only be selected if the evaluation of + the conditions is . The set of conditions can be represented by a single + ConditionItem or by a ConditionGroup, where the latter contains a (recursive) list of + conditions joined by the "and" or "or" logical relationships. + oneOf: + - $ref: '#/components/schemas/ConditionItem' + - $ref: '#/components/schemas/ConditionGroup' + + ConditionGroup: + description: > + List (array) of conditions (joined by the "and" or "or" logical relationship), + under which an NF Instance with an NFStatus or NFServiceStatus value set to "CANARY_RELEASE" + shall be selected by an NF Service Consumer. + type: object + oneOf: + - required: [ and ] + - required: [ or ] + properties: + and: + type: array + items: + $ref: '#/components/schemas/SelectionConditions' + minItems: 1 + or: + type: array + items: + $ref: '#/components/schemas/SelectionConditions' + minItems: 1 + + ConditionItem: + description: > + A ConditionItem consists of a number of attributes representing individual conditions + (e.g. a SUPI range, or a TAI list). If several attributes/conditions are present, + the evaluation of the ConditionItem is if all attributes/conditions are evaluated + as (i.e., it follows the AND logical relationship). + type: object + properties: + consumerNfTypes: + type: array + items: + $ref: '#/components/schemas/NFType' + minItems: 1 + serviceFeature: + type: integer + minimum: 1 + vsServiceFeature: + type: integer + minimum: 1 + supiRangeList: + type: array + items: + $ref: '#/components/schemas/SupiRange' + minItems: 1 + gpsiRangeList: + type: array + items: + $ref: '#/components/schemas/IdentityRange' + minItems: 1 + impuRangeList: + type: array + items: + $ref: '#/components/schemas/IdentityRange' + minItems: 1 + impiRangeList: + type: array + items: + $ref: '#/components/schemas/IdentityRange' + minItems: 1 + peiList: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Pei' + minItems: 1 + taiRangeList: + type: array + items: + $ref: '#/components/schemas/TaiRange' + minItems: 1 + dnnList: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' + minItems: 1 diff --git a/TS29512_Npcf_SMPolicyControl.yaml b/TS29512_Npcf_SMPolicyControl.yaml index 59d833f3..81a0d5f4 100644 --- a/TS29512_Npcf_SMPolicyControl.yaml +++ b/TS29512_Npcf_SMPolicyControl.yaml @@ -2,14 +2,14 @@ openapi: 3.0.0 info: title: Npcf_SMPolicyControl API - version: 1.3.0-alpha.3 + version: 1.3.0-alpha.4 description: | Session Management Policy Control Service © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.512 V18.2.0; 5G System; Session Management Policy Control Service. + description: 3GPP TS 29.512 V18.3.0; 5G System; Session Management Policy Control Service. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.512/' security: @@ -491,13 +491,19 @@ components: items: $ref: '#/components/schemas/NwdafData' minItems: 1 - urspEnforceInfo: + urspEnfInfo: $ref: '#/components/schemas/UrspEnforcementInfo' + sscMode: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SscMode' + ueReqDnn: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' + redundantPduSessionInfo: + $ref: 'TS29502_Nsmf_PDUSession.yaml#/components/schemas/RedundantPduSessionInformation' hrsboInd: type: boolean description: > HR-SBO support indication. If present and set to "true", it indicates that the HR-SBO is - supported. Default value is "false" if omitted. + supported. If present and set to "false", it indicates that the HR-SBO is not supported. required: - supi - pduSessionId @@ -671,6 +677,8 @@ components: session is not a redundant PDU session. uePolCont: $ref: '#/components/schemas/UePolicyContainer' + sliceUsgCtrlInfo: + $ref: '#/components/schemas/SliceUsgCtrlInfo' SmPolicyNotification: description: Represents a notification on the update of the SM policies. @@ -1005,7 +1013,7 @@ components: traffCorreInd: type: boolean tfcCorreInfo: - $ref: 'TS29522_TrafficInfluence.yaml#/components/schemas/TrafficCorrelationInfo' + $ref: 'TS29519_Application_Data.yaml#/components/schemas/TrafficCorrelationInfo' simConnInd: type: boolean description: > @@ -1392,6 +1400,11 @@ components: items: $ref: '#/components/schemas/QosMonitoringReport' minItems: 1 + qosMonDatRateReps: + type: array + items: + $ref: '#/components/schemas/QosMonitoringReport' + minItems: 1 userLocationInfoTime: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' repPraInfos: @@ -1494,8 +1507,14 @@ components: informed that the AN-Gateway has been recovered. uePolCont: $ref: '#/components/schemas/UePolicyContainer' - urspEnforceInfo: + urspEnfInfo: $ref: '#/components/schemas/UrspEnforcementInfo' + sscMode: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SscMode' + ueReqDnn: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' + redundantPduSessionInfo: + $ref: 'TS29502_Nsmf_PDUSession.yaml#/components/schemas/RedundantPduSessionInformation' l4sReports: type: array items: @@ -1683,6 +1702,14 @@ components: $ref: '#/components/schemas/NetLocAccessSupport' satBackhaulCategory: $ref: 'TS29571_CommonData.yaml#/components/schemas/SatelliteBackhaulCategory' + urspEnfInfo: + $ref: '#/components/schemas/UrspEnforcementInfo' + sscMode: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SscMode' + ueReqDnn: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' + redundantPduSessionInfo: + $ref: 'TS29502_Nsmf_PDUSession.yaml#/components/schemas/RedundantPduSessionInformation' RuleReport: description: Reports the status of PCC. @@ -2033,6 +2060,12 @@ components: description: > Indicates the period of time in units of miliiseconds for round trip packet delay. nullable: true + conThreshDl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + nullable: true + conThreshUl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + nullable: true waitTime: $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSecRm' repPeriod: @@ -2047,6 +2080,12 @@ components: description: > Indicates that the direct event notification sent by UPF to the Local NEF or AF is requested if it is included and set to true. + avrgWndw: + $ref: 'TS29571_CommonData.yaml#/components/schemas/AverWindowRm' + repThreshDatRateUl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRateRm' + repThreshDatRateDl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRateRm' required: - qmId - reqQosMonParams @@ -2083,6 +2122,19 @@ components: pdmf: type: boolean description: Represents the packet delay measurement failure indicator. + ulDataRate: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + dlDataRate: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + ulCongInfo: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + dlCongInfo: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + cimf: + type: boolean + description: > + Congestion information measurement failure indicator. When set to true, it indicates + that a congestion information failure has occurred.Default value is false if omitted. required: - refPccRuleIds # @@ -2191,13 +2243,6 @@ components: minItems: 1 required: - nwdafInstanceId - UrspEnforcementInfo: - description: > - Contains the report of URSP rule enforcement information. - type: object - properties: - connCaps: - type: string CallInfo: description: Identifies the caller and callee information. @@ -2291,6 +2336,13 @@ components: minItems: 1 description: FQDN(s) allowed to be routed to the local part of DN in VPLMN. + SliceUsgCtrlInfo: + description: Represents network slice usage control information. + type: object + properties: + pduSessInactivTimer: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSecRm' + 5GSmCause: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' EpsRanNasRelCause: @@ -2308,6 +2360,8 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Bytes' UePolicyContainer: $ref: 'TS29571_CommonData.yaml#/components/schemas/Bytes' + UrspEnforcementInfo: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Bytes' FlowDirection: anyOf: @@ -2942,7 +2996,11 @@ components: - DOWNLINK - UPLINK - ROUND_TRIP - - CONGESTION_INFO + + - DOWNLINK_DATA_RATE + - UPLINK_DATA_RATE + - DOWNLINK_CONGESTION + - UPLINK_CONGESTION - type: string description: > This string provides forward-compatibility with future extensions to the enumeration diff --git a/TS29514_Npcf_PolicyAuthorization.yaml b/TS29514_Npcf_PolicyAuthorization.yaml index 3127c21d..e0fefdfe 100644 --- a/TS29514_Npcf_PolicyAuthorization.yaml +++ b/TS29514_Npcf_PolicyAuthorization.yaml @@ -2,14 +2,14 @@ openapi: 3.0.0 info: title: Npcf_PolicyAuthorization Service API - version: 1.3.0-alpha.3 + version: 1.3.0-alpha.4 description: | PCF Policy Authorization Service. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.514 V18.2.0; 5G System; Policy Authorization Service; Stage 3. + description: 3GPP TS 29.514 V18.3.0; 5G System; Policy Authorization Service; Stage 3. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.514/' servers: @@ -798,6 +798,8 @@ components: minProperties: 1 description: > Contains media component information. The key of the map is the medCompN attribute. + multiModalId: + $ref: '#/components/schemas/MultiModalId' ipDomain: type: string mpsAction: @@ -810,6 +812,10 @@ components: type: string preemptControlInfo: $ref: '#/components/schemas/PreemptionControlInformation' + qosDuration: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' + qosInactInt: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' resPrio: $ref: '#/components/schemas/ReservPriority' servInfStatus: @@ -851,8 +857,6 @@ components: type: string description: > Correlation identifier for TSC management information notifications. - multiModalId: - $ref: '#/components/schemas/MultiModalId' AppSessionContextRespData: description: > @@ -920,6 +924,10 @@ components: type: string preemptControlInfo: $ref: '#/components/schemas/PreemptionControlInformationRm' + qosDuration: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSecRm' + qosInactInt: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSecRm' resPrio: $ref: '#/components/schemas/ReservPriority' servInfStatus: @@ -966,6 +974,8 @@ components: minItems: 1 qosMon: $ref: '#/components/schemas/QosMonitoringInformation' + qosMonDatRate: + $ref: '#/components/schemas/QosMonitoringInformation' pdvReqMonParams: type: array items: @@ -973,6 +983,8 @@ components: minItems: 1 pdvMon: $ref: '#/components/schemas/QosMonitoringInformation' + congestMon: + $ref: '#/components/schemas/QosMonitoringInformation' reqAnis: type: array items: @@ -989,6 +1001,8 @@ components: minItems: 1 directNotifInd: type: boolean + avrgWndw: + $ref: 'TS29571_CommonData.yaml#/components/schemas/AverWindow' EventsSubscReqDataRm: description: > @@ -1011,6 +1025,8 @@ components: minItems: 1 qosMon: $ref: '#/components/schemas/QosMonitoringInformationRm' + qosMonDatRate: + $ref: '#/components/schemas/QosMonitoringInformationRm' pdvReqMonParams: type: array items: @@ -1018,6 +1034,8 @@ components: minItems: 1 pdvMon: $ref: '#/components/schemas/QosMonitoringInformationRm' + congestMon: + $ref: '#/components/schemas/QosMonitoringInformation' reqAnis: type: array items: @@ -1030,6 +1048,8 @@ components: directNotifInd: type: boolean nullable: true + avrgWndw: + $ref: 'TS29571_CommonData.yaml#/components/schemas/AverWindowRm' nullable: true MediaComponent: @@ -1447,11 +1467,21 @@ components: items: $ref: '#/components/schemas/QosMonitoringReport' minItems: 1 + qosMonDatRateReps: + type: array + items: + $ref: '#/components/schemas/QosMonitoringReport' + minItems: 1 pdvMonReports: type: array items: $ref: '#/components/schemas/PdvMonitoringReport' minItems: 1 + congestReports: + type: array + items: + $ref: '#/components/schemas/QosMonitoringReport' + minItems: 1 ranNasRelCauses: type: array items: @@ -1471,7 +1501,13 @@ components: usgRep: $ref: 'TS29122_CommonData.yaml#/components/schemas/AccumulatedUsage' urspEnfRep: - $ref: '#/components/schemas/UrspEnforcementReport' + $ref: 'TS29512_Npcf_SMPolicyControl.yaml#/components/schemas/UrspEnforcementInfo' + sscMode: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SscMode' + ueReqDnn: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' + redundantPduSessionInfo: + $ref: 'TS29502_Nsmf_PDUSession.yaml#/components/schemas/RedundantPduSessionInformation' tsnBridgeManCont: $ref: 'TS29512_Npcf_SMPolicyControl.yaml#/components/schemas/BridgeManagementContainer' tsnPortManContDstt: @@ -1581,18 +1617,18 @@ components: maxAllowedUpLat: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' tfcCorreInfo: - $ref: 'TS29522_TrafficInfluence.yaml#/components/schemas/TrafficCorrelationInfo' + $ref: 'TS29519_Application_Data.yaml#/components/schemas/TrafficCorrelationInfo' AfSfcRequirement: description: Describes AF requirements on steering traffic to N6-LAN. type: object properties: sfcIdDl: type: string - description: Reference to a pre-configured SFC policy for downlink traffic. + description: Reference to a pre-configured SFC for downlink traffic. nullable: true sfcIdUl: type: string - description: Reference to a pre-configured SFC policy for uplink traffic. + description: Reference to a pre-configured SFC for uplink traffic. nullable: true spVal: $ref: '#/components/schemas/SpatialValidityRm' @@ -1682,7 +1718,7 @@ components: maxAllowedUpLat: $ref: 'TS29571_CommonData.yaml#/components/schemas/UintegerRm' tfcCorreInfo: - $ref: 'TS29522_TrafficInfluence.yaml#/components/schemas/TrafficCorrelationInfo' + $ref: 'TS29519_Application_Data.yaml#/components/schemas/TrafficCorrelationInfo' nullable: true AnGwAddress: @@ -1872,6 +1908,14 @@ components: type: integer repThreshRp: type: integer + repThreshDatRateUl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + repThreshDatRateDl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + conThreshDl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + conThreshUl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' PduSessionTsnBridge: description: > @@ -1916,6 +1960,14 @@ components: type: integer repThreshRp: type: integer + repThreshDatRateUl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRateRm' + repThreshDatRateDl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRateRm' + conThreshDl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + conThreshUl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' nullable: true PcscfRestorationRequestData: @@ -1962,17 +2014,26 @@ components: items: type: integer minItems: 1 - congInfo: - type: array - items: - type: integer - minItems: 0 pdmf: type: boolean description: Represents the packet delay measurement failure indicator. + ulConInfo: + type: array + items: + type: integer + minItems: 1 + dlConInfo: + type: array + items: + type: integer + minItems: 1 cimf: type: boolean description: Represents the congestion information measurement failure indicator. + ulDataRate: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + dlDataRate: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' TsnQosContainer: description: Indicates TSC Traffic QoS. @@ -2168,31 +2229,25 @@ components: $ref: '#/components/schemas/PayloadType' nullable: true - UrspEnforcementReport: - description: > - Include the UE reporting Connection Capabilities from an associated URSP rule. - type: object - required: - - connCaps - - pduSessionId - properties: - connCaps: - type: string - pduSessionId: - $ref: 'TS29571_CommonData.yaml#/components/schemas/PduSessionId' - PdvMonitoringReport: description: Packet Delay Variation reporting information. type: object properties: - flow: - $ref: '#/components/schemas/Flows' + flows: + type: array + items: + $ref: '#/components/schemas/Flows' + minItems: 1 + description: Identification of the flows. ulPdv: type: integer + description: Uplink packet delay variation in units of milliseconds. dlPdv: type: integer + description: Downlink packet delay variation in units of milliseconds. rtPdv: type: integer + description: Round trip packet delay variation in units of milliseconds. PeriodicityInfo: description: > @@ -2384,6 +2439,7 @@ components: - TP_EXPIRED - TP_NOT_YET_OCURRED - ROUT_REQ_NOT_AUTHORIZED + - DIRECT_NOTIF_NOT_POSSIBLE - type: string description: > This string provides forward-compatibility with future extensions to the enumeration @@ -2432,6 +2488,7 @@ components: - URSP_ENF_INFO - PACK_DEL_VAR - L4S_SUPP + - RT_DELAY_TWO_QOS_FLOWS - type: string description: > This string provides forward-compatibility with future extensions to the enumeration diff --git a/TS29515_Ngmlc_Location.yaml b/TS29515_Ngmlc_Location.yaml index 10d97688..f152a1cf 100644 --- a/TS29515_Ngmlc_Location.yaml +++ b/TS29515_Ngmlc_Location.yaml @@ -1,6 +1,6 @@ openapi: 3.0.0 info: - version: '1.2.0-alpha.3' + version: '1.2.0-alpha.4' title: 'Ngmlc_Location' description: | GMLC Location Service. @@ -8,7 +8,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.515 V18.2.0; 5G System; Gateway Mobile Location Services; Stage 3 + description: 3GPP TS 29.515 V18.3.0; 5G System; Gateway Mobile Location Services; Stage 3 url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.515/' servers: @@ -459,7 +459,11 @@ components: evtRptExpectedArea: $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/GeographicArea' reportingInd: - $ref: '#/components/schemas/ReportingInd' + allOf: + - $ref: '#/components/schemas/ReportingInd' + default: POSITIVE_SENSE + integrityRequirements: + $ref: '#/components/schemas/IntegrityRequirements' @@ -512,6 +516,10 @@ components: default: false acceptedPeriodicEventInfo: $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/PeriodicEventInfo' + haGnssMetrics: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/HighAccuracyGnssMetrics' + losNlosMeasureInd: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/LosNlosMeasureInd' CancelLocData: description: Contains the input parameters in CancelLocation service operation @@ -630,6 +638,11 @@ components: $ref: '#/components/schemas/FailureCause' achievedQos: $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/MinorLocationQoS' + haGnssMetrics: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/HighAccuracyGnssMetrics' + losNlosMeasureInd: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/LosNlosMeasureInd' + UePrivacyRequirements: description: UE privacy requirements from (H)GMLC to the serving AMF or VGMLC(in the roaming case) for the target UE @@ -726,6 +739,27 @@ components: allOf: - $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/AreaEventInfo' - $ref: '#/components/schemas/AreaEventInfoAddition' + IntegrityRequirements: + description: integrity requirements. + type: object + properties: + timeToAlert: + $ref: '#/components/schemas/TimeToAlert' + targetIntegrityRisk: + $ref: '#/components/schemas/TargetIntegrityRisk' + alertLimit: + $ref: '#/components/schemas/AlertLimit' + + AlertLimit: + description: Alert Limit. + type: object + required: + - horizontalProtectionLevel + properties: + horizontalProtectionLevel: + $ref: '#/components/schemas/HorizontalProtectionLevel' + verticalProtectionLevel: + $ref: '#/components/schemas/VerticalProtectionLevel' # @@ -748,6 +782,26 @@ components: type: integer minimum: 0 maximum: 127 + TimeToAlert: + description: Contains the time-to-alert + type: integer + minimum: 1 + maximum: 300 + TargetIntegrityRisk: + description: Contains the target integrity risk + type: integer + minimum: 10 + maximum: 90 + HorizontalProtectionLevel: + description: Contains the Horizontal Protection Level + type: integer + minimum: 0 + maximum: 50000 + VerticalProtectionLevel: + description: Contains the Vertical Protection Level + type: integer + minimum: 0 + maximum: 50000 # # ENUMS # diff --git a/TS29517_Naf_EventExposure.yaml b/TS29517_Naf_EventExposure.yaml index 2eb958bc..f62a5144 100644 --- a/TS29517_Naf_EventExposure.yaml +++ b/TS29517_Naf_EventExposure.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: 1.3.0-alpha.3 + version: 1.3.0-alpha.4 title: Naf_EventExposure description: | AF Event Exposure Service. @@ -10,7 +10,7 @@ info: externalDocs: description: > - 3GPP TS 29.517 V18.2.0; 5G System; Application Function Event Exposure Service; Stage 3. + 3GPP TS 29.517 V18.3.0; 5G System; Application Function Event Exposure Service; Stage 3. url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.517/ servers: @@ -736,6 +736,8 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Supi' ueAddr: $ref: 'TS29571_CommonData.yaml#/components/schemas/IpAddr' + timeStamp: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' dataUsage: $ref: 'TS29122_CommonData.yaml#/components/schemas/UsageThreshold' flowDesp: diff --git a/TS29518_Namf_Communication.yaml b/TS29518_Namf_Communication.yaml index 6c30aa09..49b5268a 100644 --- a/TS29518_Namf_Communication.yaml +++ b/TS29518_Namf_Communication.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: 1.3.0-alpha.3 + version: 1.3.0-alpha.4 title: Namf_Communication description: | AMF Communication Service. @@ -14,7 +14,7 @@ security: - namf-comm externalDocs: - description: 3GPP TS 29.518 V18.2.0; 5G System; Access and Mobility Management Services + description: 3GPP TS 29.518 V18.3.0; 5G System; Access and Mobility Management Services url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.518/' servers: @@ -2509,6 +2509,10 @@ components: $ref: '#/components/schemas/ProSeInformation' tssInfo: $ref: '#/components/schemas/TssInformation' + rsppInfo: + $ref: '#/components/schemas/RsppInformation' + a2xInfo: + $ref: '#/components/schemas/A2xInformation' required: - n2InformationClass N1MessageNotification: @@ -2672,6 +2676,9 @@ components: iabNodeInd: type: boolean default: false + mbsrNodeInd: + type: boolean + default: false ceModeBInd: $ref: '#/components/schemas/CeModeBInd' lteMInd: @@ -2972,6 +2979,12 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/WirelineServiceAreaRestriction' asTimeDisParam: $ref: 'TS29507_Npcf_AMPolicyControl.yaml#/components/schemas/AsTimeDistributionParam' + amPolicyInfoContainer: + $ref: '#/components/schemas/AmPolicyInfoContainer' + a2xContext: + $ref: '#/components/schemas/A2xContext' + mbsrOperationAllowed: + $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/MbsrOperationAllowed' N2SmInformation: @@ -3279,6 +3292,8 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' anchorSmfOauth2Required: type: boolean + hrsboAllowedInd: + type: boolean required: - pduSessionId - smContextRef @@ -3761,6 +3776,11 @@ components: presenceInfoList IE) of the AmfEvent data type shall be the key of the map. additionalProperties: $ref: '#/components/schemas/AreaOfInterestEventState' + accessToken: + type: string + description: > + JWS Compact Serialized representation of JWS signed JSON object (AccessTokenClaims + defined in 3GPP TS 29.510) UeDifferentiationInfo: description: Represents the UE Differentiation Information and its validity time @@ -3833,6 +3853,8 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/UeAuth' l3End: $ref: 'TS29571_CommonData.yaml#/components/schemas/UeAuth' + multiPathComm: + $ref: 'TS29571_CommonData.yaml#/components/schemas/UeAuth' nrUePc5Ambr: $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' pc5QoSPara: @@ -3922,6 +3944,46 @@ components: required: - tssContainer + RsppInformation: + description: Represents Ranging/SL positioning related N2 information. + type: object + properties: + n2Pc5RsppPol: + $ref: '#/components/schemas/N2InfoContent' + + A2xContext: + description: Represents the A2X services related parameters + type: object + properties: + nrA2xServicesAuth: + $ref: 'TS29571_CommonData.yaml#/components/schemas/NrA2xAuth' + lteA2xServicesAuth: + $ref: 'TS29571_CommonData.yaml#/components/schemas/LteA2xAuth' + nrUeSidelinkAmbr: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + lteUeSidelinkAmbr: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + pc5QoSPara: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Pc5QoSPara' + + A2xInformation: + description: A2X related N2 information + type: object + properties: + n2Pc5Pol: + $ref: '#/components/schemas/N2InfoContent' + + AmPolicyInfoContainer: + description: AM Policy Information Container + type: object + properties: + sliceUsgCtrlInfoSets: + type: object + description: A map(list of key-value pairs) where Snssai serves as key. + additionalProperties: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SliceUsageControlInfo' + minProperties: 1 + # # SIMPLE DATA TYPES # @@ -3978,6 +4040,8 @@ components: - V2X - PROSE - TSS + - RSPP + - A2X - type: string N1MessageClass: description: Enumeration for N1 Message Class diff --git a/TS29518_Namf_Location.yaml b/TS29518_Namf_Location.yaml index fba69495..1cfcde7d 100644 --- a/TS29518_Namf_Location.yaml +++ b/TS29518_Namf_Location.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: 1.3.0-alpha.3 + version: 1.3.0-alpha.4 title: Namf_Location description: | AMF Location Service. @@ -14,7 +14,7 @@ security: - namf-loc externalDocs: - description: 3GPP TS 29.518 V18.2.0; 5G System; Access and Mobility Management Services + description: 3GPP TS 29.518 V18.3.0; 5G System; Access and Mobility Management Services url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.518/' servers: @@ -262,6 +262,16 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Supi' gpsi: $ref: 'TS29571_CommonData.yaml#/components/schemas/Gpsi' + requestedRangingSlResult: + type: array + items: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/RangingSlResult' + minItems: 1 + relatedUEs: + type: array + items: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/RelatedUE' + minItems: 1 lmfId: $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/LMFIdentification' priority: @@ -321,7 +331,6 @@ components: default: false maxRespTime: $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' - default: false ueUnawareInd: type: boolean enum: @@ -335,7 +344,13 @@ components: minItems: 1 maxItems: 250 reportingInd: - $ref: 'TS29515_Ngmlc_Location.yaml#/components/schemas/ReportingInd' + allOf: + - $ref: 'TS29515_Ngmlc_Location.yaml#/components/schemas/ReportingInd' + default: POSITIVE_SENSE + integrityRequirements: + $ref: 'TS29515_Ngmlc_Location.yaml#/components/schemas/IntegrityRequirements' + + required: - lcsClientType - lcsLocation @@ -398,6 +413,12 @@ components: default: false acceptedPeriodicEventInfo: $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/PeriodicEventInfo' + haGnssMetrics: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/HighAccuracyGnssMetrics' + indoorOutdoorInd: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/IndoorOutdoorInd' + losNlosMeasureInd: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/LosNlosMeasureInd' NotifiedPosInfo: @@ -464,8 +485,16 @@ components: $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/MinorLocationQoS' mscServerId: $ref: 'TS29503_Nudm_UECM.yaml#/components/schemas/E164Number' + haGnssMetrics: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/HighAccuracyGnssMetrics' + indoorOutdoorInd: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/IndoorOutdoorInd' + losNlosMeasureInd: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/LosNlosMeasureInd' required: - locationEvent + + RequestLocInfo: description: Data within Provide Location Information Request type: object @@ -541,6 +570,7 @@ components: - CURRENT_OR_LAST_KNOWN_LOCATION - NOTIFICATION_VERIFICATION_ONLY - DEFERRED_LOCATION + - RANGING_SL_LOCATION - type: string LocationEvent: description: Type of events initiating location procedures diff --git a/TS29519_Application_Data.yaml b/TS29519_Application_Data.yaml index bbada4f2..f7ed5aac 100644 --- a/TS29519_Application_Data.yaml +++ b/TS29519_Application_Data.yaml @@ -10,7 +10,7 @@ info: externalDocs: description: > - 3GPP TS 29.519 V18.2.0; 5G System; Usage of the Unified Data Repository Service for Policy Data, + 3GPP TS 29.519 V18.3.0; 5G System; Usage of the Unified Data Repository Service for Policy Data, Application Data and Structured Data for Exposure. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.519/' @@ -1622,6 +1622,16 @@ paths: required: false schema: type: boolean + - name: roam-ue-net-descs + in: query + description: > + Each element identifies oner or more PLMNs for a roaming UE. + required: false + schema: + type: array + items: + $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/NetworkDescription' + minItems: 1 - name: supp-feat in: query description: Supported Features @@ -2817,16 +2827,16 @@ components: description: Identifies the N6 traffic routing requirement. sfcIdDl: type: string - description: Reference to a pre-configured service function chain policy for DL traffic + description: Reference to a pre-configured service function chain for DL traffic sfcIdUl: type: string - description: Reference to a pre-configured service function chain policy for UL traffic + description: Reference to a pre-configured service function chain for UL traffic metadata: $ref: 'TS29571_CommonData.yaml#/components/schemas/Metadata' traffCorreInd: type: boolean tfcCorreInfo: - $ref: 'TS29522_TrafficInfluence.yaml#/components/schemas/TrafficCorrelationInfo' + $ref: '#/components/schemas/TrafficCorrelationInfo' validStartTime: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' validEndTime: @@ -2842,6 +2852,7 @@ components: upPathChgNotifUri: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' headers: + description: Contains the headers provisioned by the NEF. type: array items: type: string @@ -2934,18 +2945,18 @@ components: description: Identifies the N6 traffic routing requirement. sfcIdDl: type: string - description: Reference to a pre-configured service function chain policy for DL traffic + description: Reference to a pre-configured service function chain for DL traffic nullable: true sfcIdUl: type: string - description: Reference to a pre-configured service function chain policy for UL traffic + description: Reference to a pre-configured service function chain for UL traffic nullable: true metadata: $ref: 'TS29571_CommonData.yaml#/components/schemas/Metadata' traffCorreInd: type: boolean tfcCorreInfo: - $ref: 'TS29522_TrafficInfluence.yaml#/components/schemas/TrafficCorrelationInfo' + $ref: '#/components/schemas/TrafficCorrelationInfo' validStartTime: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' validEndTime: @@ -2962,6 +2973,7 @@ components: upPathChgNotifUri: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' headers: + description: Contains the headers provisioned by the NEF. type: array items: type: string @@ -3188,6 +3200,14 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/MacAddr48' anyUeInd: type: boolean + description: > + Identifies whether the service parameters applies to any non roaming UE. + roamUeNetDescs: + type: array + items: + $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/NetworkDescription' + minItems: 1 + description: Each element identifies one or more PLMN IDs of inbound roamers. paramOverPc5: $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParameterOverPc5' paramOverUu: @@ -3202,12 +3222,23 @@ components: $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParamForProSeU2NRelUe' paramForProSeRemUe: $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParamForProSeRemUe' + paramForProSeU2URelUe: + $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParamForProSeU2URelUe' + paramForProSeEndUe: + $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParamForProSeEndUe' urspGuidance: type: array items: $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/UrspRuleRequest' minItems: 1 - description: Contains the service parameter used to guide the URSP. + description: > + Contains the service parameter used to guide the URSP and/or VPLMN specific URSP. + tnaps: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/TnapId' + minItems: 1 + description: Contains the TNAP IDs collocated with the 5G-RG(s) of a specific user. deliveryEvents: type: array items: @@ -3226,6 +3257,7 @@ components: resUri: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' headers: + description: Contains the headers provisioned by the NEF. type: array items: type: string @@ -3235,39 +3267,71 @@ components: items: type: string minItems: 1 + paramForRangingSlPos: + $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParamForRangingSlPos' ServiceParameterDataPatch: description: Represents the service parameter data that can be updated. type: object properties: paramOverPc5: - $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParameterOverPc5' + $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParameterOverPc5Rm' paramOverUu: - $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParameterOverUu' + $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParameterOverUuRm' a2xParamsPc5: - $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/A2xParamsPc5' + $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/A2xParamsPc5Rm' paramForProSeDd: - $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParamForProSeDd' + $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParamForProSeDdRm' paramForProSeDc: - $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParamForProSeDc' + $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParamForProSeDcRm' paramForProSeU2NRelUe: - $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParamForProSeU2NRelUe' + $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParamForProSeU2NRelUeRm' paramForProSeRemUe: - $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParamForProSeRemUe' + $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParamForProSeRemUeRm' + paramForProSeU2URelUE: + $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParamForProSeU2URelUeRm' + paramForProSeEndUe: + $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParamForProSeEndUeRm' urspInfluence: type: array items: $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/UrspRuleRequest' minItems: 1 - description: Contains the service parameter used to influence the URSP. + deprecated: true + description: Contains the service parameter used to influence the URSP. This attribute is + deprecated by the urspGuidance attribute. + urspGuidance: + type: array + items: + $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/UrspRuleRequest' + minItems: 1 + nullable: true + description: > + Contains the service parameter used to influence the URSP and/or VPLMN specific URSP. + tnaps: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/TnapId' + minItems: 1 + description: Contains the TNAP IDs collocated with the 5G-RG(s) of a specific user. + nullable: true deliveryEvents: type: array items: $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/Event' minItems: 1 + nullable: true description: Contains the outcome of the UE Policy Delivery. policDelivNotifUri: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' + headers: + description: Contains the headers provisioned by the NEF. + type: array + items: + type: string + minItems: 1 + paramForRangingSlPos: + $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/ParamForRangingSlPosRm' AmInfluData: description: Represents the AM Influence Data. @@ -3512,6 +3576,35 @@ components: required: - dataInd + TrafficCorrelationInfo: + description: > + Contains the information for traffic correlation. + type: object + properties: + correType: + $ref: '#/components/schemas/CorrelationType' + tfcCorrId: + type: string + description: > + Identification of a set of UEs accessing the application identified by the + Application Identifier or traffic filtering information. + comEasIpv4Addr: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Ipv4AddrRm' + comEasIpv6Addr: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Ipv6AddrRm' + fqdnRange: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/FqdnPatternMatchingRule' + minItems: 1 + nullable: true + notifUri: + $ref: 'TS29571_CommonData.yaml#/components/schemas/UriRm' + notifId: + type: string + nullable: true + nullable: true + DataInd: anyOf: - type: string @@ -3534,3 +3627,15 @@ components: - BDT: BDT data. - SVC_PARAM: Service parameter data. - AM: AM influence data. + + CorrelationType: + description: Indicates that a common DNAI or common EAS should be selected. + anyOf: + - type: string + enum: + - COMMON_DNAI + - COMMON_EAS + - 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. diff --git a/TS29519_Policy_Data.yaml b/TS29519_Policy_Data.yaml index 3a413b7e..e7f2b577 100644 --- a/TS29519_Policy_Data.yaml +++ b/TS29519_Policy_Data.yaml @@ -10,7 +10,7 @@ info: externalDocs: description: > - 3GPP TS 29.519 V18.2.0; 5G System; Usage of the Unified Data Repository Service for Policy Data, + 3GPP TS 29.519 V18.3.0; 5G System; Usage of the Unified Data Repository Service for Policy Data, Application Data and Structured Data for Exposure. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.519/' @@ -2085,9 +2085,10 @@ paths: required: true schema: $ref: 'TS29571_CommonData.yaml#/components/schemas/GroupId' + get: summary: Retrieves a group specific policy control subscription data resource - operationId: ReadGroupPolicyControlData + operationId: ReadGroupPolCtrlData tags: - GroupPolicyControlData (Document) security: @@ -2100,14 +2101,15 @@ paths: parameters: - name: supp-feat in: query - description: Supported Features + description: Represents the supported features. required: false schema: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' responses: '200': description: > - Successful case. The group specific policy control subscription data shall be returned. + Successful case. The requested group specific policy control subscription data shall be + returned. content: application/json: schema: @@ -2130,9 +2132,10 @@ paths: $ref: 'TS29571_CommonData.yaml#/components/responses/503' default: $ref: 'TS29571_CommonData.yaml#/components/responses/default' + patch: - summary: Modify a group specific policy control subscription data resource - operationId: ModifyGroupPolicyControlData + summary: Modify an existing group specific policy control subscription data resource. + operationId: ModifyGroupPolCtrlData tags: - GroupPolicyControlData (Document) requestBody: @@ -2144,16 +2147,16 @@ paths: responses: '200': description: > - The resource has been successfully updated and a response body containing group specific - policy control subscription data shall be returned. + The resource has been successfully modified and a response body containing the updated + group specific policy control subscription data shall be returned. content: application/json: schema: $ref: '#/components/schemas/GroupPolicyData' '204': description: > - The resource has been successfully updated and no additional content is to be sent in - the response message. + The resource has been successfully modified and no additional content is to be sent in + the response body. '400': $ref: 'TS29571_CommonData.yaml#/components/responses/400' '401': @@ -2226,6 +2229,13 @@ components: items: type: string minItems: 1 + chfInfo: + $ref: 'TS29512_Npcf_SMPolicyControl.yaml#/components/schemas/ChargingInformation' + subscSpendingLimits: + type: boolean + description: > + Indicates whether the PCF must enforce Access and Mobility management related + policies based on subscriber spending limits. suppFeat: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' @@ -2271,6 +2281,13 @@ components: type: boolean epsUrspInd: type: boolean + description: Indication of UE supporting URSP provisioning in EPS. + vpsUrspInd: + type: boolean + description: Indication of UE supporting VPLMN-specific URSP. + urspEnfInd: + type: boolean + description: Indication of UE supporting URSP enforcement report. pei: $ref: 'TS29571_CommonData.yaml#/components/schemas/Pei' osIds: @@ -2278,6 +2295,19 @@ components: items: $ref: '#/components/schemas/OsId' minItems: 1 + chfInfo: + $ref: 'TS29512_Npcf_SMPolicyControl.yaml#/components/schemas/ChargingInformation' + subscSpendingLimits: + type: boolean + description: > + Indicates whether the PCF must enforce UE policies based on subscriber spending limits. + tracingReq: + type: array + items: + type: string + minItems: 1 + description: > + Tracing requirements as defined in TS 32.421 [26] suppFeat: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' resetIds: @@ -2307,6 +2337,13 @@ components: type: boolean epsUrspInd: type: boolean + description: Indication of UE supporting URSP provisioning in EPS. + vpsUrspInd: + type: boolean + description: Indication of UE supporting VPLMN-specific URSP. + urspEnfInd: + type: boolean + description: Indication of UE supporting URSP enforcement report. pei: $ref: 'TS29571_CommonData.yaml#/components/schemas/Pei' osIds: @@ -2408,6 +2445,9 @@ components: type: boolean subscSpendingLimits: type: boolean + description: > + Indicates whether the PCF must enforce session management related policies based + on subscriber spending limits. ipv4Index: $ref: '#/components/schemas/IpIndex' ipv6Index: @@ -2448,7 +2488,7 @@ components: bdtRefIds: type: object additionalProperties: - $ref: 'TS29122_CommonData.yaml#/components/schemas/BdtReferenceIdRm' + $ref: '#/components/schemas/BdtReferenceIdRm' minProperties: 1 description: > Identifies transfer policies of background data transfer. Any string value can @@ -2458,6 +2498,12 @@ components: type: boolean sfcNotAllowed: type: boolean + tnaps: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/TnapId' + minItems: 1 + description: Contains the TNAP IDs collocated with the 5G-RG(s) of a specific user. required: - dnn @@ -2778,6 +2824,10 @@ components: When set to value true MA PDU session establishment is allowed for this DNN. type: boolean default: false + lboRoamAllowed: + type: boolean + description: > + Indicates whether LBO for the DNN and S-NSSAI is allowed when roaming. required: - dnn @@ -2828,7 +2878,7 @@ components: bdtRefIds: type: object additionalProperties: - $ref: 'TS29122_CommonData.yaml#/components/schemas/BdtReferenceIdRm' + $ref: '#/components/schemas/BdtReferenceIdRm' minProperties: 1 description: > Contains updated transfer policies of background data transfer. @@ -2961,18 +3011,54 @@ components: type: string pdtqPolicy: $ref: 'TS29543_Npcf_PDTQPolicyControl.yaml#/components/schemas/PdtqPolicy' + appId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/ApplicationId' pdtqRefId: $ref: 'TS29543_Npcf_PDTQPolicyControl.yaml#/components/schemas/PdtqReferenceId' nwAreaInfo: $ref: 'TS29554_Npcf_BDTPolicyControl.yaml#/components/schemas/NetworkAreaInfo' numOfUes: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + desTimeInts: + type: array + items: + $ref: 'TS29122_CommonData.yaml#/components/schemas/TimeWindow' + minItems: 1 + description: Identifies the time interval(s). dnn: $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' snssai: $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' policyStatus: $ref: '#/components/schemas/PolicyStatus' + altQosParamSets: + type: array + items: + $ref: 'TS29543_Npcf_PDTQPolicyControl.yaml#/components/schemas/AltQosParamSet' + minItems: 1 + description: > + Contains the alternative QoS requirements as a list of individual QoS parameter + sets in a prioritized order. + altQosRefs: + type: array + items: + type: string + minItems: 1 + description: > + Contains the alternative QoS requirements as the list of QoS references in a + prioritized order. + qosParamSet: + $ref: 'TS29543_Npcf_PDTQPolicyControl.yaml#/components/schemas/QosParameterSet' + qosReference: + type: string + description: > + Requested QoS requirements expressed as the QoS Reference which represents + a pre-defined QoS information. + warnNotifEnabled: + type: boolean + description: > + Indicates whether the PDTQ warning notification is enabled (true) or not (false). + Default value is false. suppFeat: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' resetIds: @@ -3010,14 +3096,16 @@ components: minItems: 1 GroupPolicyDataPatch: - description: Contains the modified group specific policy control subscription information. + description: > + Contains the requested modification to the group specific policy control subscription + data. type: object properties: remainGroupMbrUl: $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' remainGroupMbrDl: $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' - oneOf: + anyOf: - required: [remainGroupMbrUl] - required: [remainGroupMbrDl] @@ -3105,3 +3193,10 @@ components: 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. + + BdtReferenceIdRm: + type: string + description: > + This data type is defined in the same way as the BdtReferenceId data type defined in + 3GPP TS 29.122, but with the nullable property set to true. + nullable: true diff --git a/TS29520_Nnwdaf_AnalyticsInfo.yaml b/TS29520_Nnwdaf_AnalyticsInfo.yaml index 9f1e0d18..46c5cba8 100644 --- a/TS29520_Nnwdaf_AnalyticsInfo.yaml +++ b/TS29520_Nnwdaf_AnalyticsInfo.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: 1.3.0-alpha.3 + version: 1.3.0-alpha.4 title: Nnwdaf_AnalyticsInfo description: | Nnwdaf_AnalyticsInfo Service API. @@ -9,7 +9,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.520 V18.2.0; 5G System; Network Data Analytics Services. + description: 3GPP TS 29.520 V18.3.0; 5G System; Network Data Analytics Services. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.520/' security: @@ -154,7 +154,7 @@ paths: $ref: '#/components/schemas/ContextData' '204': description: > - No Content. (\No context information could be retrieved for the requested context + No Content. No context information could be retrieved for the requested context Identifiers. '400': $ref: 'TS29571_CommonData.yaml#/components/responses/400' @@ -295,13 +295,30 @@ components: items: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/PduSesTrafficInfo' minItems: 1 - e2eDataVolTransTimeInfos: + dataVlTrnsTmInfos: type: array items: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/E2eDataVolTransTimeInfo' minItems: 1 + locAccInfos: + type: array + items: + $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/LocAccuracyInfo' + minItems: 1 accuInfo: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/AccuracyInfo' + cancelAccuInd: + type: boolean + description: > + Indicates cancelled request of the analytics accuracy information. + Set to "true" indicates the NWDAF cancelled request of analytics accuracy + information as the NWDAF does not support the accuracy checking capability. + Otherwise set to "false". Default value is "false" if omitted. + movBehavInfos: + type: array + items: + $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/MovBehavInfo' + minItems: 1 suppFeat: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' @@ -339,8 +356,22 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' minItems: 1 description: Identification(s) of LADN DNN to indicate the LADN service area as the AOI. + location: + $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/GeoLocation' networkArea: $ref: 'TS29554_Npcf_BDTPolicyControl.yaml#/components/schemas/NetworkAreaInfo' + temporalGranSize: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' + spatialGranSizeTa: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + spatialGranSizeCell: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + fineGranAreas: + type: array + items: + $ref: 'TS29522_AMPolicyAuthorization.yaml#/components/schemas/GeographicalArea' + minItems: 1 + description: Indicates the fine granularity areas to which the request applies. visitedAreas: type: array items: @@ -463,20 +494,32 @@ components: items: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/PduSesTrafficReq' minItems: 1 + locAccReqs: + type: array + items: + $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/LocAccuracyReq' + minItems: 1 locGranularity: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/LocInfoGranularity' + locOrientation: + $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/LocationOrientation' useCaseCxt: type: string description: > - Indicates the context of usage of the analytics. The value and format of this parameter + Indicates the context of usage of the analytics. The value and format of this parameter are not standardized. - e2eDataVolTransTimeReqs: + dataVlTrnsTmRqs: type: array items: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/E2eDataVolTransTimeReq' minItems: 1 accuReq: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/AccuracyReq' + movBehavReqs: + type: array + items: + $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/MovBehavReq' + minItems: 1 not: required: [anySlice, snssais] @@ -522,7 +565,7 @@ components: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/EventNotification' minItems: 1 description: > - Output analytics for the analytics subscription which have not yet been sent to the + Output analytics for the analytics subscription which have not yet been sent to the analytics consumer. histAnalytics: type: array @@ -538,8 +581,8 @@ components: $ref: '#/components/schemas/SpecificAnalyticsSubscription' minItems: 1 description: > - Information about analytics subscriptions that the NWDAF has with other NWDAFs to perform - aggregation. + Information about analytics subscriptions that the NWDAF has with other NWDAFs to + perform aggregation. histData: type: array items: @@ -575,7 +618,8 @@ components: ContextIdList: description: > - Contains a list of context identifiers of context information of analytics subscriptions. + Contains a list of context identifiers of context information of analytics + subscriptions. type: object properties: contextIds: @@ -732,6 +776,9 @@ components: required: - nwPerfType +# +# ENUMERATIONS DATA TYPES +# EventId: anyOf: - type: string @@ -754,6 +801,8 @@ components: - PFD_DETERMINATION - PDU_SESSION_TRAFFIC - E2E_DATA_VOL_TRANS_TIME + - MOVEMENT_BEHAVIOUR + - LOC_ACCURACY - type: string description: > This string provides forward-compatibility with future @@ -786,6 +835,9 @@ components: - PFD_DETERMINATION: Represents the analytics of PFD Determination information for known application identifier(s). - PDU_SESSION_TRAFFIC: Represents the analytics of PDU Session traffic. - E2E_DATA_VOL_TRANS_TIME: Represents the analytics of E2E data volume transfer time. + - MOVEMENT_BEHAVIOUR: Represents the analytics of the Movement Behaviour information. + - LOC_ACCURACY: Represents the analytics of location accuracy. + ContextType: anyOf: @@ -798,6 +850,10 @@ components: - AGGR_INFO - ML_MODELS - 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. description: | Represents the analytics context information type. Possible values are: diff --git a/TS29520_Nnwdaf_EventsSubscription.yaml b/TS29520_Nnwdaf_EventsSubscription.yaml index 344c537b..afc0dc8c 100644 --- a/TS29520_Nnwdaf_EventsSubscription.yaml +++ b/TS29520_Nnwdaf_EventsSubscription.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: 1.3.0-alpha.3 + version: 1.3.0-alpha.4 title: Nnwdaf_EventsSubscription description: | Nnwdaf_EventsSubscription Service API. @@ -9,7 +9,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.520 V18.2.0; 5G System; Network Data Analytics Services. + description: 3GPP TS 29.520 V18.3.0; 5G System; Network Data Analytics Services. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.520/' security: @@ -137,7 +137,7 @@ paths: responses: '204': description: > - No Content. The Individual NWDAF Event Subscription resource matching the subscriptionId + No Content. The Individual NWDAF Event Subscription resource matching the subscriptionId was deleted. '307': $ref: 'TS29571_CommonData.yaml#/components/responses/307' @@ -177,14 +177,14 @@ paths: parameters: - name: subscriptionId in: path - description: String identifying a subscription to the Nnwdaf_EventsSubscription Service + description: String identifying a subscription to the Nnwdaf_EventsSubscription Service. required: true schema: type: string responses: '200': description: > - The Individual NWDAF Event Subscription resource was modified successfully and a + The Individual NWDAF Event Subscription resource was modified successfully and a representation of that resource is returned. content: application/json: @@ -300,15 +300,15 @@ paths: - name: transferId in: path description: > - String identifying a request for an analytics subscription transfer to the - Nnwdaf_EventsSubscription Service + String identifying a request for an analytics subscription transfer to the + Nnwdaf_EventsSubscription Service. required: true schema: type: string responses: '204': description: > - No Content. The Individual NWDAF Event Subscription Transfer resource matching the + No Content. The Individual NWDAF Event Subscription Transfer resource matching the transferId was deleted. '307': $ref: 'TS29571_CommonData.yaml#/components/responses/307' @@ -356,7 +356,7 @@ paths: - name: transferId in: path description: > - String identifying a request for an analytics subscription transfer to the + String identifying a request for an analytics subscription transfer to the Nnwdaf_EventsSubscription Service required: true schema: @@ -488,8 +488,8 @@ components: loadLevelThreshold: type: integer description: > - Indicates that the NWDAF shall report the corresponding network slice load level to the NF - service consumer where the load level of the network slice identified by snssais is + Indicates that the NWDAF shall report the corresponding network slice load level to the + NF service consumer where the load level of the network slice identified by snssais is reached. notificationMethod: $ref: '#/components/schemas/NotificationMethod' @@ -519,6 +519,20 @@ components: minItems: 1 networkArea: $ref: 'TS29554_Npcf_BDTPolicyControl.yaml#/components/schemas/NetworkAreaInfo' + location: + $ref: '#/components/schemas/GeoLocation' + temporalGranSize: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' + spatialGranSizeTa: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + spatialGranSizeCell: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + fineGranAreas: + type: array + items: + $ref: 'TS29522_AMPolicyAuthorization.yaml#/components/schemas/GeographicalArea' + minItems: 1 + description: Indicates the fine granularity areas to which the subscription applies. visitedAreas: type: array items: @@ -558,7 +572,7 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' minItems: 1 description: > - Identification(s) of network slice to which the subscription applies. It corresponds to + Identification(s) of network slice to which the subscription applies. It corresponds to snssais in the data model definition of 3GPP TS 29.520. tgtUe: $ref: '#/components/schemas/TargetUeInformation' @@ -650,8 +664,15 @@ components: items: $ref: '#/components/schemas/PduSesTrafficReq' minItems: 1 + locAccReqs: + type: array + items: + $ref: '#/components/schemas/LocAccuracyReq' + minItems: 1 locGranularity: $ref: '#/components/schemas/LocInfoGranularity' + locOrientation: + $ref: '#/components/schemas/LocationOrientation' dataVlTrnsTmRqs: type: array items: @@ -659,6 +680,21 @@ components: minItems: 1 accuReq: $ref: '#/components/schemas/AccuracyReq' + pauseFlg: + type: boolean + description: > + Pause analytics consumption flag. Set to "true" to indicate the NWDAF to stop sending + the notifications of analytics. Default value is "false" if omitted. + resumeFlg: + type: boolean + description: > + Resume analytics consumption flag. Set to "true" to indicate the NWDAF to resume sending + the notifications of analytics. Default value is "false" if omitted. + movBehavReqs: + type: array + items: + $ref: '#/components/schemas/MovBehavReq' + minItems: 1 required: - event not: @@ -810,6 +846,33 @@ components: minItems: 1 accuInfo: $ref: '#/components/schemas/AccuracyInfo' + cancelAccuInd: + type: boolean + description: > + Indicates cancelled subscription of the analytics accuracy information. + Set to "true" indicates the NWDAF cancelled subscription of analytics accuracy + information as the NWDAF does not support the accuracy checking capability. + Otherwise set to "false". Default value is "false" if omitted. + pauseInd: + type: boolean + description: > + Pause analytics consumption indication. Set to "true" to indicate the consumer to stop + the consumption of the analytics. Default value is "false" if omitted. + resumeInd: + type: boolean + description: > + Resume analytics consumption indication. Set to "true" to indicate the consumer to + resume the consumption of the analytics. Default value is "false" if omitted. + movBehavInfos: + type: array + items: + $ref: '#/components/schemas/MovBehavInfo' + minItems: 1 + locAccInfos: + type: array + items: + $ref: '#/components/schemas/LocAccuracyInfo' + minItems: 1 required: - event @@ -895,8 +958,8 @@ components: NsiLoadLevelInfo: description: > - Represents the network slice and optionally the associated network slice instance and the - load level information. + Represents the network slice and optionally the associated network slice instance and the + load level information. type: object properties: loadLevelInformation: @@ -929,8 +992,8 @@ components: Each element indicates the time elapsed between times each threshold is met or exceeded or crossed. The start time and end time are the exact time stamps of the resource usage threshold is reached or exceeded. May be present if the "listOfAnaSubsets" attribute is - provided and the maximum number of instances shall not exceed the value provided in the - "numOfExceedLoadLevelThr" attribute. + provided and the maximum number of instances shall not exceed the value provided in the + "numOfExceedLoadLevelThr" attribute. numOfUes: $ref: '#/components/schemas/NumberAverage' numOfPduSess: @@ -970,7 +1033,8 @@ components: Each element indicates the preferred accuracy level per analytics subset. It may be present if the "listOfAnaSubsets" attribute is present in the subscription request when the subscription event is NF_LOAD, UE_COMM, DISPERSION, NETWORK_PERFORMANCE, - WLAN_PERFORMANCE, DN_PERFORMANCE or SERVICE_EXPERIENCE or E2E_DATA_VOL_TRANS_TIME. + WLAN_PERFORMANCE, DN_PERFORMANCE, SERVICE_EXPERIENCE or E2E_DATA_VOL_TRANS_TIME, + UE_MOBILITY, PDU_SESSION_TRAFFIC or MOVEMENT_BEHAVIOUR. startTs: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' endTs: @@ -981,7 +1045,7 @@ components: Offset period in units of seconds to the reporting time, if the value is negative means statistics in the past offset period, otherwise a positive value means prediction in the future offset period. May be present if the "repPeriod" attribute is included within the - "evtReq" attribute or the "repetitionPeriod" attribute is included within the + "evtReq" attribute or the "repetitionPeriod" attribute is included within the EventSubscription type. sampRatio: $ref: 'TS29571_CommonData.yaml#/components/schemas/SamplingRatio' @@ -1061,7 +1125,7 @@ components: loc: $ref: 'TS29571_CommonData.yaml#/components/schemas/UserLocation' geoLoc: - $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/GeographicalCoordinates' + $ref: 'TS29522_AMPolicyAuthorization.yaml#/components/schemas/GeographicalArea' ratio: $ref: 'TS29571_CommonData.yaml#/components/schemas/SamplingRatio' confidence: @@ -1241,7 +1305,13 @@ components: properties: areaInfo: $ref: 'TS29554_Npcf_BDTPolicyControl.yaml#/components/schemas/NetworkAreaInfo' - startTs: + fineAreaInfos: + type: array + items: + $ref: 'TS29522_AMPolicyAuthorization.yaml#/components/schemas/GeographicalArea' + minItems: 1 + description: > + This attribute contains the geographical locations in a fine granularity. startTs: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' endTs: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' @@ -1319,6 +1389,8 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Float' svcExpLevel: $ref: 'TS29571_CommonData.yaml#/components/schemas/Float' + speed: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Float' NfLoadLevelInformation: description: Represents load level information of a given NF instance. @@ -1402,8 +1474,6 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' ratio: $ref: 'TS29571_CommonData.yaml#/components/schemas/SamplingRatio' - amount: - $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' confidence: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' addtMeasInfo: @@ -1875,7 +1945,7 @@ components: DispersionInfo: description: > - Represents the Dispersion information. When subscribed event is "DISPERSION", the + Represents the Dispersion information. When subscribed event is "DISPERSION", the "disperInfos" attribute shall be included. type: object properties: @@ -2026,6 +2096,22 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/PacketDelBudget' varPktDelayDl: $ref: 'TS29571_CommonData.yaml#/components/schemas/Float' + avgE2ePktDelayUl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/PacketDelBudget' + varE2ePktDelayUl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Float' + avgE2ePktDelayDl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/PacketDelBudget' + varE2ePktDelayDl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Float' + avgE2ePktLossRateUl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/PacketLossRate' + varE2ePktLossRateUl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Float' + avgE2ePktLossRateDl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/PacketLossRate' + varE2ePktLossRateDl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Float' WlanPerformanceReq: description: Represents other WLAN performance analytics requirements. @@ -2296,18 +2382,16 @@ components: description: > UE Location order indication. Set to "true" to indicate the NWDAF to provide the UE Mobility analytics in a UE Location order, otherwise set to "false" or omit. - locationGranReq: - $ref: '#/components/schemas/LocationGranularity' PduSessionInfo: description: Represents combination of PDU Session parameter(s) information. type: object properties: - pduSessTypes: + pduSessType: $ref: 'TS29571_CommonData.yaml#/components/schemas/PduSessionType' - sscModes: + sscMode: $ref: 'TS29571_CommonData.yaml#/components/schemas/SscMode' - accessTypes: + accessType: $ref: 'TS29571_CommonData.yaml#/components/schemas/AccessType' PfdDeterminationInfo: @@ -2327,8 +2411,8 @@ components: minItems: 1 description: > Represents a 3-tuple with protocol, server ip and server port for UL/DL - application traffic. The content of the string has the same encoding as the IPFilterRule - AVP value as defined in IETF RFC 6733 [18]. + application traffic. The content of the string has the same encoding as the IPFilterRule + AVP value as defined in IETF RFC 6733. urls: type: array items: @@ -2354,14 +2438,11 @@ components: type: array items: $ref: 'TS29571_CommonData.yaml#/components/schemas/Supi' + minItems: 1 dnn: - type: array - items: - $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' + $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' snssai: - type: array - items: - $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' tdMatchTrafs: type: array items: @@ -2473,7 +2554,7 @@ components: E2eDataVolTransTimeInfo: description: > Represents the E2E data volume transfer time analytics information when subscribed event is - "E2E_DATA_VOL_TRANS_TIME", the "e2eDataVolTransTimeInfos" attribute shall be included. + "E2E_DATA_VOL_TRANS_TIME", the "dataVlTrnsTmInfos" attribute shall be included. type: object properties: e2eDataVolTransTimes: @@ -2543,6 +2624,8 @@ components: $ref: 'TS29554_Npcf_BDTPolicyControl.yaml#/components/schemas/NetworkAreaInfo' validityPeriod: $ref: 'TS29122_CommonData.yaml#/components/schemas/TimeWindow' + dataVolTransTime: + $ref: '#/components/schemas/DataVolumeTransferTime' oneOf: - required: [ueLoc] - required: [snssai] @@ -2582,6 +2665,96 @@ components: - required: [mediumLevel] - required: [lowLevel] + DataVolumeTransferTime: + description: > + Indicates the E2E data volume transfer time and the data volume used to derive the transfer + time. + properties: + uplinkVolume: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Volume' + avgTransTimeUl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' + varTransTimeUl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Float' + downlinkVolume: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Volume' + avgTransTimeDl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' + varTransTimeDl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Float' + + GeoLocation: + description: > + Represents a horizontal and optionally vertical location using either geographic + or local coordinates. + type: object + properties: + point: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Point' + pointAlt: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/PointAltitude' + refPoint: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/LocalOrigin' + localCoords: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/RelativeCartesianLocation' + anyOf: + - required: [point] + - required: [pointAlt] + - allOf: + - required: [refPoint] + - required: [localCoords] + + LocAccuracyReq: + description: > + Contains location accuracy analytics requirements. + type: object + properties: + accThres: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + accThresMatchDir: + $ref: '#/components/schemas/MatchingDirection' + inOutThres: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + inOutThresMatchDir: + $ref: '#/components/schemas/MatchingDirection' + posMethod: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/PositioningMethod' + + LocAccuracyInfo: + description: > + Contains location accuracy analytics. + type: object + properties: + locAccPerMeths: + type: array + items: + $ref: '#/components/schemas/LocAccuracyPerMethod' + minItems: 1 + description: Location accuracy information per positioning method. + inOutUePct: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + inOutInd: + type: boolean + description: Indicates if the target location is indoors or outdoors. + required: + - locAccPerMeths + not: + required: [inOutUePct, inOutInd] + + LocAccuracyPerMethod: + description: > + Contains location accuracy analytics per positioning method. + type: object + properties: + posMethod: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/PositioningMethod' + locAcc: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + losNlosPercent: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + required: + - posMethod + - locAcc AccuracyReq: description: Represents the analytics accuracy requirement information. type: object @@ -2600,6 +2773,7 @@ components: Indicates the updated Analytics flag. Set to "true" indicates that the NWDAF can provide the updated analytics if the analytics can be generated within the analytics accuracy information time window, which is specified by "accuTimeWin" attribute. + Otherwise set to “false”. Default value is “false” if omitted. correctionInterval: $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' @@ -2609,11 +2783,81 @@ components: properties: accuracyVal: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' - meetAccuReqInd: - type: boolean - description: > - Set to "true" if the accuracy value meets the requested preferred level of accuracy. - Otherwise set to "false" or omitted. + accuSampleNbr: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + + anaAccuInd: + $ref: '#/components/schemas/AnalyticsAccuracyIndication' + + MovBehavReq: + description: Represents the Movement Behaviour analytics requirements. + properties: + locationGranReq: + $ref: '#/components/schemas/LocInfoGranularity' + reportThresholds: + $ref: '#/components/schemas/ThresholdLevel' + + MovBehavInfo: + description: Represents the Movement Behaviour information. + properties: + geoLoc: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/GeographicalCoordinates' + movBehavs: + type: array + items: + $ref: '#/components/schemas/MovBehav' + minItems: 1 + confidence: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + + MovBehav: + description: Represents the Movement Behaviour information per time slot. + properties: + tsStart: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' + tsDuration: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' + numOfUe: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + ratio: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SamplingRatio' + avrSpeed: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Float' + speedThresdInfos: + type: array + items: + $ref: '#/components/schemas/SpeedThresholdInfo' + minItems: 1 + directionUeInfos: + type: array + items: + $ref: '#/components/schemas/DirectionInfo' + minItems: 1 + required: + - tsStart + - tsDuration + + SpeedThresholdInfo: + description: UEs information whose speed is faster than the speed threshold. + properties: + numOfUe: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + ratio: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SamplingRatio' + + DirectionUeInfo: + description: Heading directions information of the UE flow in the target area. + properties: + direction: + $ref: '#/components/schemas/Direction' + numOfUe: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + avrSpeed: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Float' + ratio: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SamplingRatio' + required: + - direction # # ENUMERATIONS DATA TYPES @@ -2659,6 +2903,13 @@ components: - PFD_DETERMINATION - PDU_SESSION_TRAFFIC - E2E_DATA_VOL_TRANS_TIME + - MOVEMENT_BEHAVIOUR + - NUM_OF_UE + - MOV_UE_RATIO + - AVR_SPEED + - SPEED_THRESHOLD + - MOV_UE_DIRECTION + - LOC_ACCURACY - type: string description: > This string provides forward-compatibility with future @@ -2694,6 +2945,10 @@ components: information. - E2E_DATA_VOL_TRANS_TIME: Indicates that the event subscribed is of E2E data volume transfer time. + - MOVEMENT_BEHAVIOUR: Indicates that the event subscribed is the Movement Behaviour + information. + - LOC_ACCURACY: Indicates that the event subscribed is of location accuracy. + Accuracy: anyOf: @@ -3037,28 +3292,22 @@ components: - VAR_UL_PKT_DELAY - AVG_DL_PKT_DELAY - VAR_DL_PKT_DELAY - - FLOW_DESC_MATCH_TD - - FLOW_DESC_UNMATCH_TD - - APP_ID_MATCH_TD - - APP_ID_UNMATCH_TD - - DOMAIN_DESC_MATCH_TD - - DOMAIN_DESC_UNMATCH_TD - - UL_VOL_MATCH_TD - - UL_VOL_UNMATCH_TD - - DL_VOL_MATCH_TD - - DL_VOL_UNMATCH_TD - - ALL_VOL_MATCH_TD - - ALL_VOL_UNMATCH_TD - - NUM_OF_UL_PACK_MATCH_TD - - NUM_OF_UL_PACK_UNMATCH_TD - - NUM_OF_DL_PACK_MATCH_TD - - NUM_OF_DL_PACK_UNMATCH_TD - - NUM_OF_ALL_PACK_MATCH_TD - - NUM_OF_ALL_PACK_UNMATCH_TD + - TRAFFIC_MATCH_TD + - TRAFFIC_UNMATCH_TD - NUMBER_OF_UE - UE_GEOG_DIST - UE_DIRECTION - USER_LOCATION + - AVG_E2E_UL_PKT_DELAY + - VAR_E2E_UL_PKT_DELAY + - AVG_E2E_DL_PKT_DELAY + - VAR_E2E_DL_PKT_DELAY + - AVG_E2E_UL_PKT_LOSS_RATE + - VAR_E2E_UL_PKT_LOSS_RATE + - AVG_E2E_DL_PKT_LOSS_RATE + - VAR_E2E_DL_PKT_LOSS_RATE + - E2E_DATA_VOL_TRANS_TIME_FOR_UE_LIST + - IN_OUT_PERCENT - type: string description: > This string provides forward-compatibility with future @@ -3163,44 +3412,10 @@ components: This value is only applicable to RED_TRANS_EXP event. - VAR_DL_PKT_DELAY: Indicates variance downlink packet delay round trip on GTP-U path on N3. This value is only applicable to RED_TRANS_EXP event. - - FLOW_DESC_MATCH_TD: Indicates IP Flow descriptor containing 3-tuple, server side - (destination address, port, and protocol) in the traffic that matches Traffic Descriptor - within the PDU Sessions. - - FLOW_DESC_UNMATCH_TD: Indicates IP Flow descriptor containing 3-tuple, server side - (destination address, port, and protocol) in the traffic that does not match Traffic - Descriptor within the PDU Sessions. - - APP_ID_MATCH_TD: Indicates Application ID that matches Traffic Descriptor within the PDU - Sessions. - - APP_ID_UNMATCH_TD: Indicates Application ID that does not match Traffic Descriptor within - the PDU Sessions. - - DOMAIN_DESC_MATCH_TD: Indicates Domain descriptor that matches Traffic Descriptor within - the PDU Sessions. - - DOMAIN_DESC_UNMATCH_TD: Indicates UL data volume exchanged that matches Traffic Descriptor - within the PDU Sessions. This value is only applicable to PDU_SESSION_TRAFFIC event. - - UL_VOL_MATCH_TD: Indicates UL data volume exchanged that matches Traffic Descriptor within - the PDU Sessions. - - UL_VOL_UNMATCH_TD: Indicates UL data volume exchanged that does not match Traffic - Descriptor within the PDU Sessions. - - DL_VOL_MATCH_TD: Indicates DL data volume exchanged that matches Traffic Descriptor within - the PDU Sessions. - - DL_VOL_UNMATCH_TD: Indicates DL data volume exchanged that does not match Traffic - Descriptor within the PDU Sessions. - - ALL_VOL_MATCH_TD: Indicates overall data volume exchanged that matches Traffic Descriptor - within the PDU Sessions. - - ALL_VOL_UNMATCH_TD: Indicates overall data volume exchanged that does not match Traffic - Descriptor within the PDU Sessions. - - NUM_OF_UL_PACK_MATCH_TD: Indicates the number of UL packets exchanged that matches Traffic - Descriptor within the PDU Sessions. - - NUM_OF_UL_PACK_UNMATCH_TD: Indicates the number of UL packets exchanged that does not - match Traffic Descriptor within the PDU Sessions. - - NUM_OF_DL_PACK_MATCH_TD: Indicates the number of DL packets exchanged that matches Traffic - Descriptor within the PDU Sessions. - - NUM_OF_DL_PACK_UNMATCH_TD: Indicates the number of DL packets exchanged that does not - match Traffic Descriptor within the PDU Sessions. - - NUM_OF_ALL_PACK_MATCH_TD: Indicates the number of overall packets exchanged that matches - Traffic Descriptor within the PDU Sessions. - - NUM_OF_ALL_PACK_UNMATCH_TD: Indicates the number of overall packets exchanged that does - not match Traffic Descriptor within the PDU Sessions. + - TRAFFIC_MATCH_TD: Identifies traffic that matches Traffic Descriptor provided by + the consumer. + - TRAFFIC_UNMATCH_TD: Identifies traffic that does not match Traffic Descriptor + provided by the consumer. - NUMBER_OF_UE: Indicates the number of UEs. This value is only applicable to DN_PERFORMANCE event. - UE_GEOG_DIST: Indicates the geographical distribution of the UEs that can be selected by @@ -3209,6 +3424,38 @@ components: UE_MOBILITY event. - USER_LOCATION: Indicates the user location. This value is only applicable to UE_MOBILITY event. + - AVG_E2E_UL_PKT_DELAY: Indicates average End-to-End (between UE and UPF) uplink packet + delay. This value is only applicable to RED_TRANS_EXP event. + - VAR_E2E_UL_PKT_DELAY: Indicates the variance of End-to-End (between UE and UPF) uplink + packet delay. This value is only applicable to RED_TRANS_EXP event. + - AVG_E2E_DL_PKT_DELAY: Indicates average End-to-End (between UE and UPF) downlink packet + delay. This value is only applicable to RED_TRANS_EXP event. + - VAR_E2E_DL_PKT_DELAY: Indicates the variance of End-to-End (between UE and UPF) downlink + packet delay. This value is only applicable to RED_TRANS_EXP event. + - AVG_E2E_UL_PKT_LOSS_RATE: Indicates average End-to-End (between UE and UPF) uplink packet + loss rate. This value is only applicable to RED_TRANS_EXP event. + - VAR_E2E_UL_PKT_LOSS_RATE: Indicates the variance of End-to-End (between UE and UPF) uplink + packet loss rate. This value is only applicable to RED_TRANS_EXP event. + - AVG_E2E_DL_PKT_LOSS_RATE: Indicates average End-to-End (between UE and UPF) downlink + packet loss rate. This value is only applicable to RED_TRANS_EXP event. + - VAR_E2E_DL_PKT_LOSS_RATE: Indicates the variance of End-to-End (between UE and UPF) + downlink packet loss rate. This value is only applicable to RED_TRANS_EXP event. + - E2E_DATA_VOL_TRANS_TIME_FOR_UE_LIST: Indicates the classified E2E data volume transfer + time statistics or predictions for multiple UEs with respect to one or more reporting + thresholds. + - NUM_OF_UE: Indicates the total number of users in the area of interest. This + value is only applicable to MOVEMENT_BEHAVIOUR event. + - MOV_UE_RATIO: Indicates the Ratio of moving UEs in the area of interest. This value + is only applicable to MOVEMENT_BEHAVIOUR event. + - AVR_SPEED: Indicates the average speed of all UEs in the area of interest. This value + is only applicable to MOVEMENT_BEHAVIOUR event. + - SPEED_THRESHOLD: Indicates the information on UEs in the area of interest whose speed + is faster than the speed threshold. This value is only applicable to MOVEMENT_BEHAVIOUR + event. + - MOV_UE_DIRECTION: Indicates the heading directions of the UE flow in the target area. + This value is only applicable to MOVEMENT_BEHAVIOUR event. + - IN_OUT_PERCENT: Indicates the percentage of indoor/outdoor UEs at a location. + The value is only applicable to the LOC_ACCURACY event. DispersionType: oneOf: @@ -3299,6 +3546,7 @@ components: 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. description: | + Represents the device type. Possible values are: - MOBILE_PHONE: Mobile Phone. - SMART_PHONE: Smartphone. @@ -3419,6 +3667,7 @@ components: 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. description: | + Represents the cause for requesting to terminate an analytics subscription. Possible values are: - APPLICABLE_TIME_WINDOW: The ordering criterion is the Applicable Time Window. - NETWORK_STATUS_INDICATION: The ordering criterion is the network status indication. @@ -3433,6 +3682,7 @@ components: 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. description: | + Represents the ordering criterion for the list of UE mobility analytics. Possible values are: - TIME_SLOT: The ordering criterion is the time slot. @@ -3447,6 +3697,7 @@ components: 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. description: | + Represents the ordering criterion for the list of UE communication analytics. Possible values are: - START_TIME: The ordering criterion of the analytics is the start time. - DURATION: The ordering criterion of the analytics is the duration of the communication. @@ -3463,6 +3714,7 @@ components: 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. description: | + Represents the ordering criterion for the list of network performance analytics. Possible values are: - NUMBER_OF_UES: The ordering criterion of the analytics is the number of UEs. - COMMUNICATION_PERF: The ordering criterion of the analytics is the communication performance. @@ -3474,14 +3726,17 @@ components: enum: - TA_LEVEL - CELL_LEVEL + - LON_AND_LAT_LEVEL - 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. description: | + Represents the preferred granularity of location information. Possible values are: - - TA_LEVEL: TA level. - - CELL_LEVEL: Cell level. + - TA_LEVEL: Indicates location granularity of TA level. + - CELL_LEVEL: Indicates location granularity of Cell level. + - LON_AND_LAT_LEVEL: Indicates location granularity of longitude and latitude level. TrafficDirection: anyOf: @@ -3495,6 +3750,7 @@ components: 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. description: | + Represents the traffic direction for the resource usage information. Possible values are: - UL_AND_DL: Uplink and downlink traffic. - UL: Uplink traffic. @@ -3511,6 +3767,7 @@ components: 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. description: | + Represents the average or peak value of the resource usage for the network performance type. Possible values are: - AVERAGE: Resource usage information in average value. - PEAK: Resource usage information in peak value. @@ -3526,23 +3783,62 @@ components: 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. description: | + Represents the ordering criterion for the list of E2E data volume transfer time. Possible values are: - TIME_SLOT_START: Indicates the order of time slot start. - E2E_DATA_VOL_TRANS_TIME: The ordering criterion is the E2E data volume transfer time. - LocationGranularity: + + + AnalyticsAccuracyIndication: anyOf: - type: string enum: - - TA_LEVEL - - CELL_LEVEL - - LON_AND_LAT_LEVEL + - MEET + - NOT_MEET + - 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. + description: | + Represents the notification methods for the subscribed events. + Possible values are: + - MEET: Indicates meet the analytics accuracy requirement. + - NOT_MEET: Indicates not meet the analytics accuracy requirement. + + LocationOrientation: + anyOf: + - type: string + enum: + - HORIZONTAL + - VERTICAL + - HOR_AND_VER - 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. description: | Possible values are: - - TA_LEVEL: Indicates location granularity of TA level. - - CELL_LEVEL: Indicates location granularity of cell level. - - LON_ANG_LAT_LEVEL: Indicates location granularity of longitude and latitude level. + - HORIZONTAL: Indicates horizontal orientation. + - VERTICAL: Indicates vertical orientation. + - HOR_AND_VER: Indicates both horizontal and vertical orientation. + + Direction: + anyOf: + - type: string + enum: + - NORTH + - SOUTH + - EAST + - WEST + - 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. + description: | + Possible values are: + - NORTH: North direction. + - SOUTH: South direction. + - EAST: EAST direction. + - WEST: WEST direction. diff --git a/TS29520_Nnwdaf_MLModelProvision.yaml b/TS29520_Nnwdaf_MLModelProvision.yaml index 7be02a84..c2b592ce 100644 --- a/TS29520_Nnwdaf_MLModelProvision.yaml +++ b/TS29520_Nnwdaf_MLModelProvision.yaml @@ -2,14 +2,14 @@ openapi: 3.0.0 info: title: Nnwdaf_MLModelProvision - version: 1.1.0-alpha.3 + version: 1.1.0-alpha.4 description: | Nnwdaf_MLModelProvision API Service. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.520 V18.2.0; 5G System; Network Data Analytics Services. + description: 3GPP TS 29.520 V18.3.0; 5G System; Network Data Analytics Services. url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.520/ servers: @@ -323,6 +323,8 @@ components: items: $ref: 'TS29571_CommonData.yaml#/components/schemas/NfSetId' minItems: 1 + required: + - inpEvent MLEventSubscription: @@ -456,6 +458,8 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' mlTrainRepTime: $ref: 'TS29122_CommonData.yaml#/components/schemas/TimeWindow' + mlAccuracyThreshold: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' AdditionalMLModelInformation: @@ -487,6 +491,10 @@ components: minItems: 1 description: > Training information that is used by NWDAF containing MTLF during training. + modelMetric: + $ref: '#/components/schemas/MLModelMetric' + accMLModel: + $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/Accuracy' required: - mLFileAddr diff --git a/TS29520_Nnwdaf_MLModelTraining.yaml b/TS29520_Nnwdaf_MLModelTraining.yaml index 9120b954..163849a6 100644 --- a/TS29520_Nnwdaf_MLModelTraining.yaml +++ b/TS29520_Nnwdaf_MLModelTraining.yaml @@ -2,14 +2,14 @@ openapi: 3.0.0 info: title: Nnwdaf_MLModelTraining - version: 1.0.0-alpha.1 + version: 1.0.0-alpha.2 description: | Nnwdaf_MLModelTraining API Service. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.520 V18.2.0; 5G System; Network Data Analytics Services. + description: 3GPP TS 29.520 V18.3.0; 5G System; Network Data Analytics Services. url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.520/ servers: @@ -319,9 +319,15 @@ components: mLModelInfos: type: array items: - $ref: '#/components/schemas/MLModelInfo' + $ref: 'TS29520_Nnwdaf_MLModelProvision.yaml#/components/schemas/MLEventNotif' minItems: 1 description: Represents the ML Model information. + immReports: + type: array + items: + $ref: '#/components/schemas/NwdafMLModelTrainNotif' + minItems: 1 + description: Immediately reported ML Model Training notifications. mLModelTrainInfos: type: array items: @@ -341,11 +347,6 @@ components: "true" if it is requested, otherwise set to "false". mLTrainRepInfo: $ref: '#/components/schemas/MLTrainReportInfo' - modelInterInfo: - type: string - description: > - String identifying the ML Model Interoperability Information. This is vendor-specific - information and is agreed between vendors, if necessary for sharing purposes. notifCorreId: type: string description: > @@ -361,7 +362,6 @@ components: parameter are not standardized. required: - mLEventSubscs - - modelInterInfo - notifUri - notifCorreId @@ -374,18 +374,18 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' eventReq: $ref: 'TS29523_Npcf_EventExposure.yaml#/components/schemas/ReportingInformation' - failEventReports: + mLModelInfos: type: array items: - $ref: '#/components/schemas/FailureEventInfoForMLModelTrain' + $ref: 'TS29520_Nnwdaf_MLModelProvision.yaml#/components/schemas/MLEventNotif' minItems: 1 - description: > - Supplied by the NWDAF containing MTLF when available, shall contain the event(s) that - the subscription is not successful including the failure reason(s). - mLModelInfo: - $ref: '#/components/schemas/MLModelInfo' - mLModelTrainInfo: - $ref: '#/components/schemas/MLModelTrainInfo' + description: Represents the ML Model information. + mLModelTrainInfos: + type: array + items: + $ref: '#/components/schemas/MLModelTrainInfo' + minItems: 1 + description: Represents the ML Model training information. mLPreFlag: type: boolean description: > @@ -399,12 +399,6 @@ components: "true" if it is requested, otherwise set to "false". mLTrainRepInfo: $ref: '#/components/schemas/MLTrainReportInfo' - modelInterInfo: - type: string - description: > - String identifying the ML Model Interoperability Information. This is vendor- - specific information and is agreed between vendors, if necessary for sharing - purposes. roundInd: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' tgtRepUe: @@ -419,13 +413,15 @@ components: description: Represents notifications on events that occurred. type: object properties: + delayEventNotif: + $ref: '#/components/schemas/DelayEventNotif' mLCorreId: type: string description: String identifying the subscription is for a Federated Learning procedure. mLModelInfos: type: array items: - $ref: '#/components/schemas/MLModelInfo' + $ref: 'TS29520_Nnwdaf_MLModelProvision.yaml#/components/schemas/MLEventNotif' minItems: 1 description: Represents the ML Model information. notifCorreId: @@ -434,36 +430,32 @@ components: String identifying the Notification Correlation ID in the corresponding notification. roundInd: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + statusReport: + $ref: '#/components/schemas/StatusReportInfo' termTrainReq: - $ref: '#/components/schemas/TermMLModelTrainInfo' + $ref: '#/components/schemas/TermTrainCause' uCaseCont: type: string description: > String identifying the context of use of ML model. The value and format of this parameter are not standardized. required: - - mLModelInfos - notifCorreId + oneOf: + - required: [delayEventNotif] + - required: [mLModelInfos] + - required: [termTrainReq] + - required: [mLModelInfos, termTrainReq] - MLModelInfo: - description: Represents the ML Model information. - type: object - properties: - accMLModel: - $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/Accuracy' - eventNotif: - $ref: 'TS29520_Nnwdaf_MLModelProvision.yaml#/components/schemas/MLEventNotif' - modelUniqueId: - $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' MLModelTrainInfo: - description: Represents the ML Model training informaiton, include requirement on data availability and time availability, training filter information. + description: > + Represents the ML Model training information, include requirement on data availability and + time availability, training filter information. type: object properties: dataAvReq: - type: string - description: > - String representing the requirement on available data for the ML model training. + $ref: '#/components/schemas/DataAvReq' timeAvReq: type: string description: > @@ -477,7 +469,7 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' FailureEventInfoForMLModelTrain: - description: Represents the failure event informaiton for a ML Model Training subscription. + description: Represents the failure event information for a ML Model Training subscription. type: object properties: mLTrainEvent: @@ -488,20 +480,83 @@ components: - mLTrainEvent - failureCodeTrain - TermMLModelTrainInfo: - description: Indicating that the subscription is requested to be terminated. + + DataAvReq: + description: Represents the requirement on available data for the ML model training. type: object properties: - terminationTrainReq: + dataStatProps: + type: array + items: + $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/DatasetStatisticalProperty' + minItems: 1 + inpEvents: + type: array + items: + $ref: 'TS29574_Ndccf_DataManagement.yaml#/components/schemas/DccfEvent' + minItems: 1 + minNumSamples: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + timeWindows: + type: array + items: + $ref: 'TS29122_CommonData.yaml#/components/schemas/TimeWindow' + minItems: 1 + required: + - inpEvents + + DelayEventNotif: + description: > + Indicating that the NWDAF containing MTLF is not able to complete the training of ML model + within the maximum response time, the cause code, and the expected time complete the + training. + type: object + properties: + delayEventInd: type: boolean description: > - Indication that the subscription is requested to be terminated if set to "true", i.e. no - further notifications related to this subscription will be provided. Otherwise set to - "false". The default value is "true". - termTrainCause: - $ref: '#/components/schemas/TermTrainCause' + Indicates that the NWDAF containing MTLF is not able to complete the training of ML + model within the maximum response time. Set to "true" if not able to complete the ML + model training on time, otherwise set to "false". + delayCause: + $ref: '#/components/schemas/DelayCause' + expCompTime: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' required: - - terminationTrainReq + - delayEventInd + + StatusReportInfo: + description: > + Indicating status information generated by the NWDAF containing MTLF during ML model + training. + type: object + properties: + mlModelAcc: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + trainInDataInfo: + $ref: '#/components/schemas/TrainDataInfo' + + TrainDataInfo: + description: Represents the training input data information. + type: object + properties: + areaDataSet: + type: string + description: Indicates the areas covered by the data set. + maxValues: + type: array + items: + type: string + minItems: 1 + description: Represents the maximum value of one dimension of data. + minValues: + type: array + items: + type: string + minItems: 1 + description: Represents the minimum value of one dimension of data. + samplRatio: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' # # ENUMERATIONS DATA TYPES @@ -516,6 +571,7 @@ components: 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. description: | + Represents the failure reason. Possible values are: - UNAVAILABLE_ML_MODEL_TRAIN: The ML model training is unavailable. @@ -531,7 +587,26 @@ components: 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. description: | + Represents the reasons that ML Model Training to be terminated. Possible values are: - NWDAF_OVERLOAD: The NWDAF is overloaded for the ML model training. - NOT_AVAILABLE_ML_TRAIN: The ML model training process is not available. - OTHERS: Other cause. + + DelayCause: + anyOf: + - type: string + enum: + - ML_MODEL_TRAIN_FAILURE + - NEED_MORE_TIME + - OTHERS + - 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. + description: | + Represents the reasons for ML Model training delay. + Possible values are: + - ML_MODEL_TRAIN_FAILURE: The ML model training is failure. + - NEED_MORE_TIME: The ML model training needs more time. + - OTHERS: Other cause. diff --git a/TS29522_5GLANParameterProvision.yaml b/TS29522_5GLANParameterProvision.yaml index 0028f552..a508695c 100644 --- a/TS29522_5GLANParameterProvision.yaml +++ b/TS29522_5GLANParameterProvision.yaml @@ -2,7 +2,7 @@ openapi: 3.0.0 info: title: 3gpp-5glan-pp - version: 1.2.0-alpha.3 + version: 1.2.0-alpha.4 description: | API for 5G LAN Parameter Provision. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ info: externalDocs: description: > - 3GPP TS 29.522 V18.2.0; 5G System; Network Exposure Function Northbound APIs. + 3GPP TS 29.522 V18.3.0; 5G System; Network Exposure Function Northbound APIs. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.522/' security: @@ -125,6 +125,45 @@ paths: $ref: 'TS29122_CommonData.yaml#/components/responses/503' default: $ref: 'TS29122_CommonData.yaml#/components/responses/default' + callbacks: + 5GLANParamProvNotif: + '{request.body#/notifUri}': + post: + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/5GLanParamProvNotif' + responses: + '204': + description: No Content. Successful reception of the notification. + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' /{afId}/subscriptions/{subscriptionId}: get: @@ -427,8 +466,33 @@ components: vnGroupCommInd: type: boolean description: > - Indicates that the 5G VN group is associated with 5G VN group communication when - it is present and set to "true". The default value is "false" if omitted. + Indicates whether the 5G VN group is associated with 5G VN group communication when + When set to "true", it indicates that the 5G VN group is associated with 5G VN group + communication. When set to "false", it indicates that the 5G VN group is not + associated with 5G VN group communication. The default value when omitted is "false". + maxGrpDataRateInfo: + $ref: '#/components/schemas/MaxGrpDataRateInfo' + cpParams: + $ref: '#/components/schemas/CpParams' + npConfigParams: + $ref: '#/components/schemas/NpConfigParams' + lpiParams: + $ref: '#/components/schemas/LpiParams' + acsParams: + $ref: '#/components/schemas/AcsParams' + ecsAddrParams: + $ref: '#/components/schemas/ECSAddrParams' + dnnSnssaiParams: + $ref: '#/components/schemas/DnnSnssaiParams' + notifUri: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Link' + requestTestNotification: + type: boolean + description: > + Set to true to request to send a test notification as defined in clause 5.2.5.3. + Set to false or omitted otherwise. + websockNotifConfig: + $ref: 'TS29122_CommonData.yaml#/components/schemas/WebsockNotifConfig' required: - exterGroupId - gpsis @@ -457,6 +521,20 @@ components: description: > Describes the operation systems and the corresponding applications for each operation systems. The key of map is osId. + cpParams: + $ref: '#/components/schemas/CpParams' + npConfigParams: + $ref: '#/components/schemas/NpConfigParams' + lpiParams: + $ref: '#/components/schemas/LpiParams' + acsParams: + $ref: '#/components/schemas/AcsParams' + ecsAddrParams: + $ref: '#/components/schemas/ECSAddrParams' + dnnSnssaiParams: + $ref: '#/components/schemas/DnnSnssaiParams' + notifUri: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Link' AppDescriptor: description: Represents an operation system and the corresponding applications. @@ -491,6 +569,124 @@ components: Identifies applications that are running on the UE's operating system. Any string value can be used as a key of the map. + MaxGrpDataRateInfo: + description: > + Represents the Maximum Group Data Rate related information. + type: object + properties: + maxGrpDataRateUl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + maxGrpDataRateDl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + anyOf: + - required: [maxGrpDataRateUl] + - required: [maxGrpDataRateDl] + + CpParams: + description: Represents Communication Pattern parameters. + type: object + properties: + cpParameterSets: + type: object + additionalProperties: + $ref: 'TS29122_CpProvisioning.yaml#/components/schemas/CpParameterSet' + minProperties: 1 + description: > + Contains one or more set(s) of CP parameters information for the 5G VN group. + Any string value may be used as a key of the map. + cpReports: + type: object + additionalProperties: + $ref: 'TS29122_CpProvisioning.yaml#/components/schemas/CpReport' + minProperties: 1 + description: > + Contains the identifier(s) of the set(s) of CP parameters for which the provided CP + parameters are not added or modified successfully with the corresponding failure reason. + Each element provides the related information for one or more CP set identifier(s). + The key of the map is a string representing the failure identifier. + readOnly: true + required: + - cpParameterSets + + NpConfigParams: + description: Represents Network Parameters Configuration information. + type: object + properties: + maximumLatency: + $ref: 'TS29122_CommonData.yaml#/components/schemas/DurationSec' + maximumResponseTime: + $ref: 'TS29122_CommonData.yaml#/components/schemas/DurationSec' + suggestedNumberOfDlPackets: + type: integer + minimum: 0 + description: > + Contains the number of packets that the serving gateway shall buffer in case the UE is + not reachable. + groupReportingGuardTime: + $ref: 'TS29122_CommonData.yaml#/components/schemas/DurationSec' + validityTime: + $ref: 'TS29122_CommonData.yaml#/components/schemas/DateTime' + + LpiParams: + description: Represents Location Privacy Indication parameters. + type: object + properties: + lpi: + $ref: 'TS29503_Nudm_SDM.yaml#/components/schemas/Lpi' + required: + - lpi + + AcsParams: + description: Represents ACS configuration parameters. + type: object + properties: + acsInfo: + $ref: 'TS29571_CommonData.yaml#/components/schemas/AcsInfo' + required: + - acsInfo + + ECSAddrParams: + description: Represents ECS address configuration parameters. + type: object + properties: + ecsServerAddr: + $ref: 'TS29571_CommonData.yaml#/components/schemas/EcsServerAddr' + spatialValidityCond: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SpatialValidityCond' + required: + - ecsServerAddr + + DnnSnssaiParams: + description: Represents DNN and S-NSSAI specific Group Parameters. + type: object + properties: + defQos: + $ref: 'TS29522_GroupParametersProvisioning.yaml#/components/schemas/AfReqDefaultQoS' + ladnServArea: + $ref: 'TS29522_GroupParametersProvisioning.yaml#/components/schemas/LadnServArea' + anyOf: + - required: [ defQos ] + - required: [ ladnServArea ] + + 5GLanParamProvNotif: + description: Represents a 5G LAN Parameter Provisioning Event Notification. + type: object + properties: + npConfigNotif: + $ref: '#/components/schemas/NpConfigNotif' + + NpConfigNotif: + description: Represents a Network Parameters Configuration related notification. + type: object + properties: + configResults: + type: array + items: + $ref: 'TS29122_CommonData.yaml#/components/schemas/ConfigResult' + minItems: 1 + appliedParam: + $ref: 'TS29122_MonitoringEvent.yaml#/components/schemas/AppliedParameterConfiguration' + AaaUsage: anyOf: - type: string diff --git a/TS29522_AKMA.yaml b/TS29522_AKMA.yaml index 82b2fd9e..74bb1721 100644 --- a/TS29522_AKMA.yaml +++ b/TS29522_AKMA.yaml @@ -1,14 +1,14 @@ openapi: 3.0.0 info: title: 3gpp-akma - version: 1.0.1 + version: 1.1.0-alpha.1 description: | API for AKMA. - © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: description: > - 3GPP TS 29.522 V17.7.0; 5G System; Network Exposure Function Northbound APIs. + 3GPP TS 29.522 V18.3.0; 5G System; Network Exposure Function Northbound APIs. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.522/' security: - {} @@ -73,7 +73,10 @@ components: flows: clientCredentials: tokenUrl: '{tokenUrl}' - scopes: {} + scopes: + nnef-akma:gpsi-access: > + Return GPSI in the AKMA Application Key information for the UE. + schemas: AkmaAfKeyRequest: description: > diff --git a/TS29522_AnalyticsExposure.yaml b/TS29522_AnalyticsExposure.yaml index c740eabf..3e8ac844 100644 --- a/TS29522_AnalyticsExposure.yaml +++ b/TS29522_AnalyticsExposure.yaml @@ -2,7 +2,7 @@ openapi: 3.0.0 info: title: 3gpp-analyticsexposure - version: 1.2.0-alpha.3 + version: 1.2.0-alpha.4 description: | API for Analytics Exposure. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ info: externalDocs: description: > - 3GPP TS 29.522 V18.2.0; 5G System; Network Exposure Function Northbound APIs. + 3GPP TS 29.522 V18.3.0; 5G System; Network Exposure Function Northbound APIs. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.522/' security: @@ -528,12 +528,27 @@ components: items: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/ServiceExperienceInfo' minItems: 1 + movBehavInfos: + type: array + items: + $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/MovBehavInfo' + minItems: 1 start: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' timeStampGen: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' locArea: $ref: 'TS29122_CommonData.yaml#/components/schemas/LocationArea5G' + pauseInd: + type: boolean + description: > + Pause analytics consumption indication. Set to "true" to indicate the consumer to stop + the consumption of the analytics. Default value is "false" if omitted. + resumeInd: + type: boolean + description: > + Resume analytics consumption indication. Set to "true" to indicate the consumer to + resume the consumption of the analytics. Default value is "false" if omitted. required: - analyEvent - timeStamp @@ -562,6 +577,18 @@ components: minItems: 1 locArea: $ref: 'TS29122_CommonData.yaml#/components/schemas/LocationArea5G' + fineGranAreas: + type: array + items: + $ref: 'TS29522_AMPolicyAuthorization.yaml#/components/schemas/GeographicalArea' + minItems: 1 + description: Indicates the fine granularity areas to which the subscription applies. + temporalGranSize: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' + spatialGranSizeTa: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + spatialGranSizeCell: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' appIds: type: array items: @@ -684,16 +711,33 @@ components: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/UserDataConOrderCrit' locGranularity: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/LocInfoGranularity' + locOrientation: + $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/LocationOrientation' ueMobilityReqs: type: array items: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/UeMobilityReq' minItems: 1 + movBehavReqs: + type: array + items: + $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/MovBehavReq' + minItems: 1 useCaseCxt: type: string description: > Indicates the context of usage of the analytics. The value and format of this parameter are not standardized. + pauseFlg: + type: boolean + description: > + Pause analytics consumption flag. Set to "true" to indicate the NWDAF to stop sending + the notifications of analytics. Default value is "false" if omitted. + resumeFlg: + type: boolean + description: > + Resume analytics consumption flag. Set to "true" to indicate the NWDAF to resume sending + the notifications of analytics. Default value is "false" if omitted. TargetUeId: description: Represents the target UE(s) information. @@ -774,6 +818,18 @@ components: properties: locArea: $ref: 'TS29122_CommonData.yaml#/components/schemas/LocationArea5G' + fineGranAreas: + type: array + items: + $ref: 'TS29522_AMPolicyAuthorization.yaml#/components/schemas/GeographicalArea' + minItems: 1 + description: Indicates the fine granularity areas to which the request applies. + temporalGranSize: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' + spatialGranSizeTa: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + spatialGranSizeCell: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' dnn: $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' dnns: @@ -867,11 +923,18 @@ components: $ref: 'TS29520_Nnwdaf_AnalyticsInfo.yaml#/components/schemas/UserDataCongestReq' locGranularity: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/LocInfoGranularity' + locOrientation: + $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/LocationOrientation' ueMobilityReqs: type: array items: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/UeMobilityReq' minItems: 1 + movBehavReqs: + type: array + items: + $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/MovBehavReq' + minItems: 1 useCaseCxt: type: string description: > @@ -943,6 +1006,11 @@ components: items: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/DispersionRequirement' minItems: 1 + movBehavInfos: + type: array + items: + $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/MovBehavInfo' + minItems: 1 suppFeat: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' required: @@ -954,6 +1022,8 @@ components: properties: locArea: $ref: 'TS29122_CommonData.yaml#/components/schemas/LocationArea5G' + anaPeriod: + $ref: 'TS29122_CommonData.yaml#/components/schemas/TimeWindow' nwPerfType: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/NetworkPerfType' relativeRatio: @@ -1044,6 +1114,12 @@ components: properties: locArea: $ref: 'TS29122_CommonData.yaml#/components/schemas/LocationArea5G' + fineAreaInfos: + type: array + items: + $ref: 'TS29522_AMPolicyAuthorization.yaml#/components/schemas/GeographicalArea' + minItems: 1 + description: This attribute contains the geographical locations in a fine granularity. startTs: $ref: 'TS29122_CommonData.yaml#/components/schemas/DateTime' endTs: @@ -1089,6 +1165,7 @@ components: - DN_PERFORMANCE - SERVICE_EXPERIENCE - E2E_DATA_VOL_TRANS_TIME + - MOVEMENT_BEHAVIOUR - type: string description: > This string provides forward-compatibility with future @@ -1115,6 +1192,8 @@ components: experience. - E2E_DATA_VOL_TRANS_TIME: Indicates that the event subscribed is of E2E data volume transfer time. + - MOVEMENT_BEHAVIOUR: Indicates that the event subscribed is the Movement Behaviour + information. AnalyticsFailureCode: anyOf: diff --git a/TS29522_DNAIMapping.yaml b/TS29522_DNAIMapping.yaml index 207e3720..2b40e169 100644 --- a/TS29522_DNAIMapping.yaml +++ b/TS29522_DNAIMapping.yaml @@ -2,7 +2,7 @@ openapi: 3.0.0 info: title: 3gpp-dnaimapping - version: 1.0.0-alpha.1 + version: 1.0.0-alpha.2 description: | API for DNAI Mapping. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ info: externalDocs: description: > - 3GPP TS 29.522 V18.2.0; 5G System; Network Exposure Function Northbound APIs. + 3GPP TS 29.522 V18.3.0; 5G System; Network Exposure Function Northbound APIs. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.522/' security: @@ -285,12 +285,8 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' snssai: $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' - immRep: - type: boolean - maxNumOfReps: - type: integer - expiry: - $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' + eventReq: + $ref: 'TS29523_Npcf_EventExposure.yaml#/components/schemas/ReportingInformation' dnai: $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnai' notifUri: diff --git a/TS29522_GroupParametersProvisioning.yaml b/TS29522_GroupParametersProvisioning.yaml new file mode 100644 index 00000000..b3606aa6 --- /dev/null +++ b/TS29522_GroupParametersProvisioning.yaml @@ -0,0 +1,407 @@ +openapi: 3.0.0 + +info: + title: 3gpp-grp-pp + version: 1.0.0-alpha.1 + description: | + API for Group Parameters Provisioning. + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + All rights reserved. + +externalDocs: + description: > + 3GPP TS 29.522 V18.3.0; 5G System; Network Exposure Function Northbound APIs. + url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.522/' + +servers: + - url: '{apiRoot}/3gpp-grp-pp/v1' + variables: + apiRoot: + default: https://example.com + description: apiRoot as defined in clause 4.4 of 3GPP TS 29.501 + +security: + - {} + - oAuth2ClientCredentials: [] + +paths: + /pp: + get: + summary: Request to retrieve all the active Group Parameters Provisioning resources at the NEF. + operationId: GetGrpParamsProvisionings + tags: + - Group Parameters Provisionings (Collection) + responses: + '200': + description: > + OK. All the active Group Parameters Provisioning resources managed by the NEF are + returned. + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/GrpPpData' + minItems: 0 + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '406': + $ref: 'TS29122_CommonData.yaml#/components/responses/406' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + + post: + summary: Request the creation of a new Group Parameters Provisioning. + tags: + - Group Parameters Provisioning (Collection) + operationId: CreateGrpParamsProvisioning + requestBody: + description: > + Representation of the new Group Parameters Provisioning to be created at the NEF. + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/GrpPpData' + responses: + '201': + description: > + Created. Successful creation of a new Individual Group Parameters Provisioning resource. + content: + application/json: + schema: + $ref: '#/components/schemas/GrpPpData' + headers: + Location: + description: > + Contains the URI of the newly created resource, according to the structure + {apiRoot}/3gpp-grp-pp/v1/pp/{ppId} + required: true + schema: + type: string + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + + /pp/{ppId}: + parameters: + - name: ppId + in: path + description: > + Represents the identifier of the Individual Group Parameters Provisioning resource. + required: true + schema: + type: string + + get: + summary: Request to retrieve an existing Individual Group Parameters Provisioning resource. + operationId: GetIndGrpParamsProvisioning + tags: + - Individual Group Parameters Provisioning (Document) + responses: + '200': + description: > + OK. Successful retrieval of the requested Individual Group Parameters Provisioning. + resource. + content: + application/json: + schema: + $ref: '#/components/schemas/GrpPpData' + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '406': + $ref: 'TS29122_CommonData.yaml#/components/responses/406' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + + put: + summary: Request the update of an existing Individual Group Parameters Provisioning resource. + tags: + - Individual Group Parameters Provisioning (Document) + operationId: UpdateIndGrpParamsProvisioning + requestBody: + description: > + Represents the updated Individual Group Parameters Provisioning resource representation. + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/GrpPpData' + responses: + '200': + description: > + OK. The Individual Group Parameters Provisioning resource is successfully updated and a + representation of the updated resource is returned in the response body. + content: + application/json: + schema: + $ref: '#/components/schemas/GrpPpData' + '204': + description: > + No Content. The Individual Group Parameters Provisioning resource is successfully + Updated and no content is returned in the response body. + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + + patch: + summary: Request the modification of an existing Individual Group Parameters Provisioning resource. + tags: + - Individual Group Parameters Provisioning (Document) + operationId: ModifyIndGrpParamsProvisioning + requestBody: + description: > + Contains the parameters to request the modification of the Individual Group Parameters + Provisioning resource. + required: true + content: + application/merge-patch+json: + schema: + $ref: '#/components/schemas/GrpPpDataPatch' + responses: + '200': + description: > + OK. The Individual Group Parameters Provisioning resource is successfully modified and a + representation of the updated resource is returned in the response body. + content: + application/json: + schema: + $ref: '#/components/schemas/GrpPpData' + '204': + description: > + No Content. The Individual Group Parameters Provisioning resource is successfully + Modified and no content is returned in the response body. + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + + delete: + summary: Request the deletion of an existing Individual Group Parameters Provisioning resource. + tags: + - Individual Group Parameters Provisioning (Document) + operationId: DeleteIndGrpParamsProvisioning + responses: + '204': + description: > + No Content. The Individual Group Parameters Provisioning resource is successfully + deleted. + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + +components: + securitySchemes: + oAuth2ClientCredentials: + type: oauth2 + flows: + clientCredentials: + tokenUrl: '{tokenUrl}' + scopes: {} + + schemas: +# +# STRUCTURED DATA TYPES +# + GrpPpData: + description: Represents the Group Parameters Provisioning data. + type: object + properties: + afId: + type: string + dnnSnssaiGrpData: + $ref: '#/components/schemas/DnnSnssaiGrpData' + suppFeat: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' + required: + - afId + + GrpPpDataPatch: + description: > + Represents the requested modification to the existing Group Parameters Provisioning data + instance. + type: object + properties: + dnnSnssaiGrpData: + $ref: '#/components/schemas/DnnSnssaiGrpData' + + DnnSnssaiGrpData: + description: Represents DNN and S-NSSAI specific Group Parameters data. + type: object + properties: + extGroupId: + $ref: 'TS29122_CommonData.yaml#/components/schemas/ExternalGroupId' + dnn: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' + snssai: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + defQos: + $ref: '#/components/schemas/AfReqDefaultQoS' + ladnServArea: + $ref: '#/components/schemas/LadnServArea' + required: + - extGroupId + - dnn + - snssai + anyOf: + - required: [ defQos ] + - required: [ ladnServArea ] + + AfReqDefaultQoS: + description: Represents the AF requested default QoS. + type: object + properties: + 5qi: + $ref: 'TS29571_CommonData.yaml#/components/schemas/5Qi' + arp: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Arp' + priorityLevel: + $ref: 'TS29571_CommonData.yaml#/components/schemas/5QiPriorityLevelRm' + required: + - 5qi + - arp + + LadnServArea: + description: Represents an LADN Service Area. + type: object + properties: + geographicAreas: + type: array + items: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/GeographicArea' + minItems: 1 + civicAddresses: + type: array + items: + $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/CivicAddress' + minItems: 1 + tais: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Tai' + minItems: 1 + oneOf: + - required: [ geographicAreas ] + - required: [ civicAddresses ] + - required: [ tais ] + +# +# SIMPLE DATA TYPES +# + +# +# ENUMERATIONS +# diff --git a/TS29522_MBSGroupMsgDelivery.yaml b/TS29522_MBSGroupMsgDelivery.yaml index dc15468b..95e073ac 100644 --- a/TS29522_MBSGroupMsgDelivery.yaml +++ b/TS29522_MBSGroupMsgDelivery.yaml @@ -2,7 +2,7 @@ openapi: 3.0.0 info: title: 3gpp-mbs-group-msg - version: 1.0.0-alpha.2 + version: 1.0.0-alpha.3 description: | API for MBS Group Message Delivery. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ info: externalDocs: description: > - 3GPP TS 29.522 V18.2.0; 5G System; Network Exposure Function Northbound APIs. + 3GPP TS 29.522 V18.3.0; 5G System; Network Exposure Function Northbound APIs. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.522/' security: @@ -30,7 +30,7 @@ paths: summary: Retrieve all the active MBS Group Message Deliveries. operationId: GetMbsGroupMsgDeliveries tags: - - MBS Group Message Deliveries + - MBS Group Message Deliveries (Collection) responses: '200': description: > @@ -68,7 +68,7 @@ paths: summary: Request the creation of an MBS Group Message Delivery. operationId: CreateMbsGroupMsgDelivery tags: - - MBS Group Message Deliveries + - MBS Group Message Deliveries (Collection) requestBody: required: true content: @@ -78,15 +78,18 @@ paths: responses: '201': description: > - Created. Successful case. An MBS Group Message Delivery is created. + Created. Successful case. The requested MBS Group Message Delivery is successfully + created. content: application/json: schema: $ref: '#/components/schemas/MbsGroupMsgDelResp' - '307': - $ref: 'TS29122_CommonData.yaml#/components/responses/307' - '308': - $ref: 'TS29122_CommonData.yaml#/components/responses/308' + headers: + Location: + description: Contains the URI of the newly created resource. + required: true + schema: + type: string '400': $ref: 'TS29122_CommonData.yaml#/components/responses/400' '401': @@ -115,7 +118,7 @@ paths: post: requestBody: description: > - Represents the status of MBS Group Message Delivery. + Represents the notification on the status of MBS Group Message Delivery. required: true content: application/json: @@ -123,7 +126,9 @@ paths: $ref: '#/components/schemas/MbsGroupMsgDelStatusNotif' responses: '204': - description: No content. The notification is successfully received. + description: > + No content. The MBS Group Message Delivery Status notification is successfully + received. '307': $ref: 'TS29122_CommonData.yaml#/components/responses/307' '308': @@ -157,16 +162,52 @@ paths: - name: delRef in: path description: > - Identifier of the Individual MBS Group Message Delivery resource. + Contains the identifier of the Individual MBS Group Message Delivery resource. required: true schema: type: string - put: + get: + summary: Retrieve an existing MBS Group Message Delivery. + operationId: GetMbsGroupMsgDelivery + tags: + - Individual MBS Group Message Delivery (Document) + responses: + '200': + description: > + OK. All the requested MBS Group Message Delivery is successfully returned. + content: + application/json: + schema: + $ref: '#/components/schemas/MbsGroupMsgDelData' + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '406': + $ref: 'TS29122_CommonData.yaml#/components/responses/406' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + + patch: summary: Request the modification of an existing MBS Group Message Delivery. operationId: ModifyMbsGroupMsgDelivery tags: - - Individual MBS Group Message Delivery + - Individual MBS Group Message Delivery (Document) requestBody: required: true content: @@ -176,13 +217,16 @@ paths: responses: '200': description: > - OK. Successful case. The MBS Group Message Delivery is modified. + OK. Successful case. The MBS Group Message Delivery is successfully modified and a + representation of the updated resource is returned in the response body. content: application/json: schema: $ref: '#/components/schemas/MbsGroupMsgDelResp' '204': - description: No Content. Successful case, the requested group message delivery is successfully updated. + description: > + No Content. Successful case. The MBS Group Message Delivery is + successfully modified and no content is returned in the response body. '307': $ref: 'TS29122_CommonData.yaml#/components/responses/307' '308': @@ -211,10 +255,10 @@ paths: $ref: 'TS29122_CommonData.yaml#/components/responses/default' delete: - summary: Deletes an existing Individual MBS Group Message Delivery resource. + summary: Request the deletion of an existing Individual MBS Group Message Delivery resource. operationId: DeleteMbsGroupMsgDelivery tags: - - Individual MBS Group Message Delivery + - Individual MBS Group Message Delivery (Document) responses: '204': description: > @@ -285,19 +329,22 @@ components: - externalGroupId - startTime - stopTime + - notifUri oneOf: - required: [mbsServArea] - required: [extMbsServArea] MbsGroupMsgDelResp: description: > - Represents a response to a requested group message delivery. + Represents a response to a requested MBS group message delivery. type: object properties: mbsGroupMsgDelData: $ref: '#/components/schemas/MbsGroupMsgDelData' delStatus: type: boolean + mbsUserServiceAnmt: + $ref: 'TS26517_MBSUserServiceAnnouncement.yaml#/components/schemas/UserServiceDescription' suppFeat: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' required: @@ -308,8 +355,6 @@ components: description: Represents the requested modifications to an existing MBS Group Message Delivery. type: object properties: - externalGroupId: - $ref: 'TS29122_CommonData.yaml#/components/schemas/ExternalGroupId' mbsServArea: $ref: 'TS29571_CommonData.yaml#/components/schemas/MbsServiceArea' extMbsServArea: @@ -324,7 +369,7 @@ components: required: [mbsServArea, extMbsServArea] MbsGroupMsgDelStatusNotif: - description: Represents status notification information for an MBS group message delivery. + description: Represents the status notification information for an MBS group message delivery. type: object properties: delStatus: diff --git a/TS29522_MBSUserDataIngestSession.yaml b/TS29522_MBSUserDataIngestSession.yaml index e4e647c7..b2b334cf 100644 --- a/TS29522_MBSUserDataIngestSession.yaml +++ b/TS29522_MBSUserDataIngestSession.yaml @@ -2,7 +2,7 @@ openapi: 3.0.0 info: title: 3gpp-mbs-ud-ingest - version: 1.1.0-alpha.1 + version: 1.1.0-alpha.2 description: | API for MBS User Data Ingest Session. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ info: externalDocs: description: > - 3GPP TS 29.522 V18.1.0; 5G System; Network Exposure Function Northbound APIs. + 3GPP TS 29.522 V18.3.0; 5G System; Network Exposure Function Northbound APIs. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.522/' servers: diff --git a/TS29522_MoLcsNotify.yaml b/TS29522_MoLcsNotify.yaml index 197729f6..06f4a1a3 100644 --- a/TS29522_MoLcsNotify.yaml +++ b/TS29522_MoLcsNotify.yaml @@ -1,14 +1,14 @@ openapi: 3.0.0 info: title: 3gpp-mo-lcs-notify - version: 1.1.1 + version: 1.2.0-alpha.1 description: | API for UE updated location information notification. - © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: description: > - 3GPP TS 29.522 V17.7.0; 5G System; Network Exposure Function Northbound APIs. + 3GPP TS 29.522 V18.3.0; 5G System; Network Exposure Function Northbound APIs. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.522/' security: - {} @@ -88,6 +88,11 @@ components: $ref: 'TS29515_Ngmlc_Location.yaml#/components/schemas/ServiceIdentity' suppFeat: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' + additionalLocInfo: + type: array + items: + $ref: 'TS29122_MonitoringEvent.yaml#/components/schemas/LocationInfo' + minItems: 1 required: - gpsi - lcsQosClass diff --git a/TS29522_PDTQPolicyNegotiation.yaml b/TS29522_PDTQPolicyNegotiation.yaml index af2baac2..b7a22861 100644 --- a/TS29522_PDTQPolicyNegotiation.yaml +++ b/TS29522_PDTQPolicyNegotiation.yaml @@ -2,7 +2,7 @@ openapi: 3.0.0 info: title: 3gpp-pdtq-policy-negotiation - version: 1.0.0-alpha.1 + version: 1.0.0-alpha.2 description: | API for PDTQ policy negotiation. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ info: externalDocs: description: > - 3GPP TS 29.522 V18.2.0; 5G System; Network Exposure Function Northbound APIs. + 3GPP TS 29.522 V18.3.0; 5G System; Network Exposure Function Northbound APIs. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.522/' security: @@ -325,6 +325,11 @@ components: description: > Contains the alternative QoS requirements as the list of QoS references in a prioritized order. + appId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/ApplicationId' + aspId: + description: Contains an identity of an application service provider. + type: string desTimeInts: type: array items: @@ -368,6 +373,7 @@ components: Indicates whether the PDTQ warning notification is enabled (true) or not (false). Default value is false. required: + - aspId - desTimeInts - numberOfUEs oneOf: diff --git a/TS29522_ServiceParameter.yaml b/TS29522_ServiceParameter.yaml index 4c15d980..4b103156 100644 --- a/TS29522_ServiceParameter.yaml +++ b/TS29522_ServiceParameter.yaml @@ -2,7 +2,7 @@ openapi: 3.0.0 info: title: 3gpp-service-parameter - version: 1.2.0-alpha.3 + version: 1.2.0-alpha.4 description: | API for AF service paramter © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ info: externalDocs: description: > - 3GPP TS 29.522 V18.2.0; 5G System; Network Exposure Function Northbound APIs. + 3GPP TS 29.522 V18.3.0; 5G System; Network Exposure Function Northbound APIs. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.522/' security: @@ -403,8 +403,14 @@ components: anyUeInd: type: boolean description: > - Identifies whether the AF request applies to any UE. This attribute - shall set to "true" if applicable for any UE, otherwise, set to "false". + Identifies whether the AF request applies to any non-roaming UE. This attribute, + when provided, shall set to "true" if applicable for any UE, otherwise, set to "false". + roamUeNetDescs: + type: array + items: + $ref: '#/components/schemas/NetworkDescription' + minItems: 1 + description: Each element identifies one or more PLMN IDs of inbound roamers. gpsi: $ref: 'TS29571_CommonData.yaml#/components/schemas/Gpsi' ueIpv4: @@ -445,6 +451,8 @@ components: $ref: '#/components/schemas/ParamForProSeU2URelUe' paramForProSeEndUe: $ref: '#/components/schemas/ParamForProSeEndUe' + paramForRangingSlPos: + $ref: '#/components/schemas/ParamForRangingSlPos' urspGuidance: type: array items: @@ -453,6 +461,12 @@ components: description: Contains the service parameter used to guide the URSP. a2xParamsPc5: $ref: '#/components/schemas/A2xParamsPc5' + tnaps: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/TnapId' + minItems: 1 + description: Contains the TNAP IDs collocated with the 5G-RG(s) of a specific user. mtcProviderId: $ref: 'TS29571_CommonData.yaml#/components/schemas/MtcProviderInformation' suppFeat: @@ -480,6 +494,8 @@ components: $ref: '#/components/schemas/ParamForProSeU2URelUeRm' paramForProSeEndUe: $ref: '#/components/schemas/ParamForProSeEndUeRm' + paramForRangingSlPos: + $ref: '#/components/schemas/ParamForRangingSlPosRm' urspGuidance: type: array items: @@ -488,6 +504,13 @@ components: description: Contains the service parameter used to guide the URSP. a2xParamsPc5: $ref: '#/components/schemas/A2xParamsPc5Rm' + tnaps: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/TnapId' + minItems: 1 + description: Contains the TNAP IDs collocated with the 5G-RG(s) of a specific user. + nullable: true subNotifEvents: type: array items: @@ -585,6 +608,17 @@ components: type: string nullable: true + ParamForRangingSlPos: + description: Represents the service parameters for ranging and sidelink positioning. + type: string + + ParamForRangingSlPosRm: + description: > + This data type is defined in the same way as the ParamForRangingslpos data type, + but with the OpenAPI nullable property set to true. + type: string + nullable: true + A2xParamsPc5: description: > Represents configuration parameters for A2X communications over PC5 reference point. @@ -604,6 +638,14 @@ components: $ref: '#/components/schemas/TrafficDescriptorComponents' relatPrecedence: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + visitedNetDescs: + type: array + items: + $ref: '#/components/schemas/NetworkDescription' + minItems: 1 + description: > + Each element identifies one or more PLMN IDs where AF guidance for VPLMN-specific + URSP rule applies. routeSelParamSets: type: array items: @@ -753,6 +795,29 @@ components: - required: [dnns] - required: [connCaps] + NetworkDescription: + description: > + Represents the description of a PLMN, by the definition of the PLMN ID, the MCC (and + applicable MNC(s)) or the indication of any PLMN. + type: object + properties: + plmnId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/PlmnId' + mcc: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Mcc' + mncs: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Mnc' + minItems: 1 + anyPlmnInd: + type: boolean + description: Indicates any PLMN. + oneOf: + - required: [plmnId] + - required: [mcc] + - required: [anyPlmnInd] + AuthorizationResult: anyOf: - type: string diff --git a/TS29522_SliceParamProvision.yaml b/TS29522_SliceParamProvision.yaml new file mode 100644 index 00000000..475ef106 --- /dev/null +++ b/TS29522_SliceParamProvision.yaml @@ -0,0 +1,374 @@ +openapi: 3.0.0 + +info: + title: Slice Parameters Provisionings + version: 1.0.0-alpha.1 + description: | + API for Slice Parameters Provisionings. + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + All rights reserved. + +externalDocs: + description: > + 3GPP TS 29.522 V18.3.0; 5G System; Network Exposure Function Northbound APIs. + url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.522/' + +security: + - {} + - oAuth2ClientCredentials: [] + +servers: + - url: '{apiRoot}/3gpp-slice-pp/v1' + variables: + apiRoot: + default: https://example.com + description: apiRoot as defined in clause 5.2.4 of 3GPP TS 29.122. + + +paths: + /pp: + get: + summary: Request to retrieve all the active Slice Parameters Provisionings + resources at the NEF. + operationId: GetSliceParamProvisionings + tags: + - Slice Parameters Provisionings (Collection) + responses: + '200': + description: > + OK. All the active Slice Parameters Provisioning resources managed by the + NEF are returned. + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/SlicePpData' + minItems: 1 + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '406': + $ref: 'TS29122_CommonData.yaml#/components/responses/406' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + + post: + summary: Request the creation of a new Slice Parameters Provisioning. + tags: + - Slice Parameters Provisionings (Collection) + operationId: CreateSliceParamProvisioning + requestBody: + description: > + Representation of the new Slice Parameters Provisioning to be created at + the NEF. + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/SlicePpData' + responses: + '201': + description: > + Created. Successful creation of a new Individual Slice Parameters + Provisioning resource. + content: + application/json: + schema: + $ref: '#/components/schemas/SlicePpData' + headers: + Location: + description: > + Contains the URI of the newly created resource, according to the structure + {apiRoot}/3gpp-slice-pp/v1/pp/{ppId} + required: true + schema: + type: string + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + + /pp/{ppId}: + parameters: + - name: ppId + in: path + description: > + Represents the identifier of the Individual Slice Parameters + Provisioning resource. + required: true + schema: + type: string + + get: + summary: Request to retrieve an existing Individual Slice Parameters + Provisioning resource. + operationId: GetIndSliceParamProvisioning + tags: + - Individual Slice Usage Control Parameters Provisioning (Document) + responses: + '200': + description: > + OK. Successful retrieval of the requested Individual Slice + Parameters Provisioning resource. + content: + application/json: + schema: + $ref: '#/components/schemas/SlicePpData' + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '406': + $ref: 'TS29122_CommonData.yaml#/components/responses/406' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + + put: + summary: Request to update an existing Individual Slice Parameters + Provisioning resource. + tags: + - Individual Slice Parameters Provisioning (Document) + operationId: UpdateIndSliceParamProvisioning + requestBody: + description: > + Represents the updated Individual Slice Parameters Provisioning + resource representation. + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/SlicePpData' + responses: + '200': + description: > + OK. The Individual Slice Parameters Provisioning resource is successfully + updated and a representation of the updated resource is returned in the response body. + content: + application/json: + schema: + $ref: '#/components/schemas/SlicePpData' + '204': + description: > + No Content. The Individual Slice Parameters Provisioning resource + is successfully updated and no content is returned in the response body. + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + + patch: + summary: Request the modification of an existing Individual Slice Parameters + Provisioning resource. + tags: + - Individual Slice Parameters Provisioning (Document) + operationId: ModifyIndSliceParamProvisioning + requestBody: + description: > + Contains the requested modifications to the Individual Slice Parameters + Provisioning resource. + required: true + content: + application/merge-patch+json: + schema: + $ref: '#/components/schemas/SlicePpDataPatch' + responses: + '200': + description: > + OK. The Individual Slice Parameters Provisioning resource is successfully + modified and a representation of the updated resource is returned in the response body. + content: + application/json: + schema: + $ref: '#/components/schemas/SlicePpData' + '204': + description: > + No Content. The Individual Slice Parameters Provisioning resource + is successfully modified and no content is returned in the response body. + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + + delete: + summary: Request the deletion of an existing Individual Slice Parameters + Provisioning resource. + tags: + - Individual Slice Parameters Provisioning (Document) + operationId: DeleteIndSliceParamProvisioning + responses: + '204': + description: > + No Content. The Individual Slice Parameters Provisioning resource + is successfully deleted. + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + +components: + securitySchemes: + oAuth2ClientCredentials: + type: oauth2 + flows: + clientCredentials: + tokenUrl: '{tokenUrl}' + scopes: {} + + schemas: +# +# STRUCTURED DATA TYPES +# + SlicePpData: + description: Represents the Slice Parameters Provisioning data. + type: object + properties: + afId: + type: string + sliceUsgCtrlData: + type: object + additionalProperties: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SliceUsageControlInfo' + minProperties: 1 + description: > + Contains the Network Slice Usage Control information to be provisioned. + The key of the map shall be the AF dedicated S-NSSAI to which the Network Slice Usage + Control information is related and that is provided within the snssai attribute of the + corresponding map value encoded via the SliceUsageControlInfo data structure. + suppFeat: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' + required: + - afId + + SlicePpDataPatch: + description: > + Represents the requested modifications to an existing Slice Parameters + Provisioning data. + type: object + properties: + sliceUsgCtrlData: + type: object + additionalProperties: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SliceUsageControlInfo' + minProperties: 1 + description: > + Contains the updated Network Slice Usage Control information to be provisioned. + The key of the map shall be the AF dedicated S-NSSAI to which the Network Slice Usage + Control information are related and that is provided within the snssai attribute of the + corresponding map value encoded via the SliceUsageControlInfo data structure. + + +# +# SIMPLE DATA TYPES +# + +# +# ENUMERATIONS +# diff --git a/TS29522_TimeSyncExposure.yaml b/TS29522_TimeSyncExposure.yaml index a2babf7d..7b1ebc7f 100644 --- a/TS29522_TimeSyncExposure.yaml +++ b/TS29522_TimeSyncExposure.yaml @@ -2,7 +2,7 @@ openapi: 3.0.0 info: title: 3gpp-time-sync-exposure - version: 1.1.0-alpha.3 + version: 1.1.0-alpha.4 description: | API for time synchronization exposure. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ info: externalDocs: description: > - 3GPP TS 29.522 V18.2.0; 5G System; Network Exposure Function Northbound APIs. + 3GPP TS 29.522 V18.3.0; 5G System; Network Exposure Function Northbound APIs. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.522/' security: @@ -780,10 +780,13 @@ components: $ref: 'TS29514_Npcf_PolicyAuthorization.yaml#/components/schemas/TemporalValidity' coverageArea: $ref: 'TS29571_CommonData.yaml#/components/schemas/SpatialValidityCond' - clkQltDetLvl: - $ref: '#/components/schemas/ClkQltDetLvl' - clkQltAcptCri: - $ref: '#/components/schemas/ClkQltAcptCri' + timeSyncStatusParam: + type: array + items: + $ref: '#/components/schemas/TimeSyncStatusParam' + minItems: 1 + description: > + This contains the clock quality detail level and clock quality acceptance criteria. required: - upNodeId - reqPtpIns @@ -927,6 +930,14 @@ components: items: $ref: '#/components/schemas/StateOfDstt' minItems: 1 + clkQltAcptCriReports: + description: > + Indicates if the clock quality acceptance criteria is met or not for the indicated UE(s). + type: array + items: + $ref: '#/components/schemas/ClockQualityAcceptanceCriteriaResult' + minItems: 1 + StateOfDstt: description: Contains the PTP port state of a DS-TT. type: object @@ -940,40 +951,27 @@ components: to indicate the state of configuration for DS-TT port is active; when PTP port state is in any other case, it is included and set to false to indicate the state of configuration for DS port is inactive. Default value is false. - clkQltAcptRes: - $ref: '#/components/schemas/ClkQltDetLvl' - timeSyncServStatus: - $ref: '#/components/schemas/ClkQltAcptCri' required: - gpsi - state - ClkQltAcptCri: - description: Contains the Time Synchronization service status parameters. - type: object - properties: - syncState: - $ref: '#/components/schemas/SyncState' - clkQltParams: - $ref: '#/components/schemas/ClkQltParams' - parTimeSrc: - $ref: '#/components/schemas/AsTimeResource' - - ClkQltParams: - description: Contains the clock quality parameters. + ClockQualityAcceptanceCriteriaResult: + description: > + Indicates whether the clock quality acceptance criteria is met or not for the indicated + PTP port, i.e. per the indicated UE. type: object properties: - traceableGNSS: - type: boolean - traceableUTC: - type: boolean - freqStab: - type: integer - ptpClkClass: - description: > - It is FFS about this parameter and it’s data type PtpClkClass. - clkAcc: - type: integer + supi: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Supi' + gpsi: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Gpsi' + clkQltAcptCriResInd: + $ref: '#/components/schemas/AcceptanceCriteriaResultIndication' + required: + - clkQltAcptCriResInd + anyOf: + - required: [supi] + - required: [gpsi] Protocol: anyOf: @@ -1074,8 +1072,10 @@ components: - INTERNAL_OSCILLATOR: Indicates internal oscillator is supported. - OTHER: Indicates other source of time is supported. - ClkQltDetLvl: - description: Contains the clock quality level information. + AcceptanceCriteriaResultIndication: + description: > + Contains the acceptable/not acceptable indication of the clock quality acceptance criteria + result information. anyOf: - type: string enum: @@ -1083,12 +1083,20 @@ components: - NON_ACCEPTABLE - type: string - SyncState: - description: Indicates the state of the node synchronization. + TimeSyncStatusParam: + description: > + Contains clock quality detail level and optionally clock quality acceptance criteria + per UE. + type: object + properties: + supi: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Supi' + gpsi: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Gpsi' + clkQltDetLvl: + $ref: 'TS29571_CommonData.yaml#/components/schemas/ClockQualityDetailLevel' + clkQltAcptCri: + $ref: 'TS29571_CommonData.yaml#/components/schemas/ClockQualityAcceptanceCriterion' anyOf: - - type: string - enum: - - LOCKED - - HOLDOVER - - FREERUN - - type: string + - required: [supi] + - required: [gpsi] diff --git a/TS29522_TrafficInfluence.yaml b/TS29522_TrafficInfluence.yaml index 2134157d..d334ee1c 100644 --- a/TS29522_TrafficInfluence.yaml +++ b/TS29522_TrafficInfluence.yaml @@ -2,7 +2,7 @@ openapi: 3.0.0 info: title: 3gpp-traffic-influence - version: 1.3.0-alpha.2 + version: 1.3.0-alpha.3 description: | API for AF traffic influence © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ info: externalDocs: description: > - 3GPP TS 29.522 V18.2.0; 5G System; Network Exposure Function Northbound APIs. + 3GPP TS 29.522 V18.3.0; 5G System; Network Exposure Function Northbound APIs. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.522/' security: @@ -537,7 +537,7 @@ components: candidate DNAI(s) for the PDU session need to be reported. Otherwise set to "false" or omitted. tfcCorreInfo: - $ref: '#/components/schemas/TrafficCorrelationInfo' + $ref: 'TS29519_Application_Data.yaml#/components/schemas/TrafficCorrelationInfo' suppFeat: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' allOf: @@ -659,7 +659,7 @@ components: eventReq: $ref: 'TS29523_Npcf_EventExposure.yaml#/components/schemas/ReportingInformation' tfcCorreInfo: - $ref: '#/components/schemas/TrafficCorrelationInfo' + $ref: 'TS29519_Application_Data.yaml#/components/schemas/TrafficCorrelationInfo' EventNotification: description: Represents a traffic influence event notification. @@ -752,30 +752,6 @@ components: required: - ackResult - TrafficCorrelationInfo: - description: > - Contains the information for traffic correlation. - type: object - properties: - correType: - $ref: '#/components/schemas/CorrelationType' - tfcCorrId: - type: string - description: > - Identification of a set of UEs accessing the application identified by the - Application Identifier or traffic filtering information. - comEasIpv4Addr: - $ref: 'TS29571_CommonData.yaml#/components/schemas/Ipv4AddrRm' - comEasIpv6Addr: - $ref: 'TS29571_CommonData.yaml#/components/schemas/Ipv4AddrRm' - fqdnRange: - type: array - items: - $ref: 'TS29571_CommonData.yaml#/components/schemas/FqdnPatternMatchingRule' - minItems: 1 - nullable: true - nullable: true - SubscribedEvent: anyOf: - type: string @@ -811,15 +787,3 @@ components: - RELOC_NO_ALLOWED: The application relocation fails because application relocation is not allowed. - OTHER: The application relocation fails due to other reason. - - CorrelationType: - description: Indicates that a common DNAI or common EAS should be selected. - anyOf: - - type: string - enum: - - COMMON_DNAI - - COMMON_EAS - - 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. diff --git a/TS29522_UEId.yaml b/TS29522_UEId.yaml index 5878da01..1ee345e9 100644 --- a/TS29522_UEId.yaml +++ b/TS29522_UEId.yaml @@ -2,14 +2,14 @@ openapi: 3.0.0 info: title: 3gpp-ueid - version: 1.0.1 + version: 1.1.0-alpha.1 description: | API for UE ID service. - © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.522 V17.7.0; 5G System; Network Exposure Function Northbound APIs. + description: 3GPP TS 29.522 V18.3.0; 5G System; Network Exposure Function Northbound APIs. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.522/' security: - {} @@ -90,6 +90,8 @@ components: type: string mtcProviderId: $ref: 'TS29571_CommonData.yaml#/components/schemas/MtcProviderInformation' + portNumber: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Port' snssai: $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' ueIpAddr: diff --git a/TS29525_Npcf_UEPolicyControl.yaml b/TS29525_Npcf_UEPolicyControl.yaml index 571c7eca..f9d5f51f 100644 --- a/TS29525_Npcf_UEPolicyControl.yaml +++ b/TS29525_Npcf_UEPolicyControl.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: 1.3.0-alpha.3 + version: 1.3.0-alpha.4 title: Npcf_UEPolicyControl description: | UE Policy Control Service. @@ -9,7 +9,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.525 V18.2.0; 5G System; UE Policy Control Service. + description: 3GPP TS 29.525 V18.3.0; 5G System; UE Policy Control Service. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.525/' servers: @@ -338,16 +338,15 @@ components: $ref: '#/components/schemas/RequestTrigger' minItems: 1 description: > - Request Triggers that the PCF subscribes. Only values "LOC_CH" and "PRA_CH" are - permitted. + Request Triggers that the PCF subscribes. pras: type: object additionalProperties: - $ref: 'TS29571_CommonData.yaml#/components/schemas/PresenceInfo' + $ref: 'TS29571_CommonData.yaml#/components/schemas/PresenceInfoRm' minProperties: 1 description: > Contains the presence reporting area(s) for which reporting was requested. - The praId attribute within the PresenceInfo data type is the key of the map. + The praId attribute within the PresenceInfoRm data type is the key of the map. andspDelInd: type: boolean description: > @@ -357,6 +356,12 @@ components: Indication of UE support of ANDSP. When set to true, it indicates the UE supports ANDSP, when set to false it indicates the UE does not support ANDSP. type: boolean + pduSessions: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/PduSessionInfo' + minItems: 1 + description: Combination of DNN and S-NSSAIs for which LBO information is requested. suppFeat: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' required: @@ -433,6 +438,9 @@ components: items: $ref: 'TS29531_Nnssf_NSSelection.yaml#/components/schemas/ConfiguredSnssai' minItems: 1 + description: > + The Configured NSSAI for the serving PLMN, and the mapped S-NSSAI value of home + network corresponding to the configured S-NSSAI in the serving PLMN. n3gNodeReSel: $ref: '#/components/schemas/Non3gppAccess' satBackhaulCategory: @@ -442,6 +450,23 @@ components: description: > It indicates the UE Policy Association is triggered by a 5GS to EPS mobility scenario. + vpsUePolGuidance: + type: object + additionalProperties: + $ref: '#/components/schemas/UePolicyParameters' + minProperties: 1 + description: > + Contains the service parameter used to guide the VPLMN-specific URSP. + The key of the map represents the AF request to guide VPLMN-specific URS rules. + This attribute only applies in roaming and when the V-PCF is the NF service consumer. + lboRoamInfo: + type: array + items: + $ref: '#/components/schemas/LboRoamingInformation' + minItems: 1 + description: > + Contains LBO roaming information for DNN and S-NSSAI combination(s). + This attribute only applies in roaming and when the AMF is the NF service consumer. suppFeat: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' required: @@ -520,8 +545,19 @@ components: items: $ref: 'TS29531_Nnssf_NSSelection.yaml#/components/schemas/ConfiguredSnssai' minItems: 1 + description: > + The Configured NSSAI for the serving PLMN, and the mapped S-NSSAI value of home + network corresponding to the configured S-NSSAI in the serving PLMN. satBackhaulCategory: $ref: 'TS29571_CommonData.yaml#/components/schemas/SatelliteBackhaulCategory' + urspEnfRep: + type: object + additionalProperties: + $ref: '#/components/schemas/UrspEnforcementPduSession' + description: > + Contains information about the enforced URSP rule(s) in one or more PDU sessions. + The key of the map is a character string that represents an integer value. + minProperties: 1 suppFeat: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' @@ -548,8 +584,7 @@ components: minItems: 1 nullable: true description: > - Request Triggers that the PCF subscribes. Only values "LOC_CH" and "PRA_CH" are - permitted. + Request Triggers that the PCF subscribes. pras: type: object additionalProperties: @@ -563,6 +598,14 @@ components: type: boolean description: > Indication that the updated ANDSP/WLANSP has been successfully delivered to the UE. + pduSessions: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/PduSessionInfo' + minItems: 1 + description: > + Combination of DNN and S-NSSAIs for which LBO information is requested. + nullable: true suppFeat: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' required: @@ -618,6 +661,82 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/PlmnIdNid' connectState: $ref: 'TS29518_Namf_EventExposure.yaml#/components/schemas/CmState' + confSnssais: + type: array + items: + $ref: 'TS29531_Nnssf_NSSelection.yaml#/components/schemas/ConfiguredSnssai' + minItems: 1 + description: > + The Configured NSSAI for the serving PLMN, and the mapped S-NSSAI value of home + network corresponding to the configured S-NSSAI in the serving PLMN. + satBackhaulCategory: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SatelliteBackhaulCategory' + urspEnfRep: + type: object + additionalProperties: + $ref: '#/components/schemas/UrspEnforcementPduSession' + description: > + Contains information about the enforced URSP rule(s) in one or more PDU sessions. + The key of the map is a character string that represents an integer value. + minProperties: 1 + lboRoamInfo: + type: array + items: + $ref: '#/components/schemas/LboRoamingInformation' + minItems: 1 + description: > + Contains LBO roaming information for DNN and S-NSSAI combination(s). + + UePolicyParameters: + description: > + Contains the service parameters used to guide the VPLMN-specific URSP rule determination. + type: object + properties: + urspGuidance: + type: array + items: + $ref: 'TS29522_ServiceParameter.yaml#/components/schemas/UrspRuleRequest' + minItems: 1 + description: Contains the service parameter used to guide the URSP. + + LboRoamingInformation: + description: > + Contains LBO roaming information for a DNN and S-NSSAI. + type: object + properties: + lboRoamAllowed: + type: boolean + description: > + Indicates whether LBO for the DNN and S-NSSAI is allowed when roaming. + dnn: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' + snssai: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + required: + - dnn + - snssai + + UrspEnforcementPduSession: + description: > + Represents URSP enforcement information for a PDU session. + type: object + required: + - urspEnfInfo + properties: + urspEnfInfo: + $ref: 'TS29512_Npcf_SMPolicyControl.yaml#/components/schemas/UrspEnforcementInfo' + sscMode: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SscMode' + ueReqDnn: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Dnn' + redundantPduSessionInfo: + $ref: 'TS29502_Nsmf_PDUSession.yaml#/components/schemas/RedundantPduSessionInformation' + accessType: + $ref: 'TS29571_CommonData.yaml#/components/schemas/AccessType' + ratType: + $ref: 'TS29571_CommonData.yaml#/components/schemas/RatType' + pduSessInfo: + $ref: 'TS29523_Npcf_EventExposure.yaml#/components/schemas/PduSessionInformation' UePolicy: $ref: 'TS29571_CommonData.yaml#/components/schemas/Bytes' @@ -642,7 +761,9 @@ components: - SAT_CATEGORY_CHG - NON_3GPP_NODE_RESELECTION - CONF_NSSAI_CH + - LBO_INFO_CH - FEAT_RENEG + - URSP_ENF_INFO - type: string description: > This string provides forward-compatibility with future @@ -669,9 +790,15 @@ components: category, or non-satellite backhaul. - NON_3GPP_NODE_RESELECTION: The UE has connected to a wrong non-3GPP access node that does not match its subscribed S-NSSAI(s). This policy control request trigger does not - require a subscription. - CONF_NSSAI_CH: Configured NSSAI change. Indicates that the configured NSSAI has changed. + require a subscription. + - CONF_NSSAI_CH: Configured NSSAI change. Indicates that the configured NSSAI has changed. + - LBO_INFO_CH: LBO information change. The AMF reports LBO roaming allowed or not allowed + for the requested DNN(s) and S-NSSAI(s). This policy control request trigger only applies + in roaming scenarios when the NF service consumer is the AMF. - FEAT_RENEG: The NF service consumer notifies that the target AMF is requesting feature re-negotiation. + - URSP_ENF_INFO: The V-PCF has received URSP enforcement information for one or more URSP + rules. This trigger applies in roaming scenarios and to the V-PCF. PolicyAssociationReleaseCause: anyOf: diff --git a/TS29526_Nnssaaf_AIW.yaml b/TS29526_Nnssaaf_AIW.yaml index af019bc3..fa9abb41 100644 --- a/TS29526_Nnssaaf_AIW.yaml +++ b/TS29526_Nnssaaf_AIW.yaml @@ -2,14 +2,14 @@ openapi: 3.0.0 info: title: Nnssaaf_AIW - version: 1.1.0-alpha.1 + version: 1.1.0-alpha.2 description: | AAA Interworking Authentication and Authorization Service. - © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS29.526, NSSAA Service, version 18.0.0. + description: 3GPP TS29.526, NSSAA Service, version 18.3.0. url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.526/ servers: @@ -46,7 +46,7 @@ paths: $ref: '#/components/schemas/AuthContext' headers: Location: - description: 'Contains the URI of the newly created resource according to the structure: {apiRoot}/nnssaaf-aiw/v1/authentications/{authCtxId}' + description: 'Contains the URI of the newly created resource according to the structure: {apiRoot}/nnssaaf-aiw//authentications/{authCtxId}' required: true schema: type: string diff --git a/TS29526_Nnssaaf_NSSAA.yaml b/TS29526_Nnssaaf_NSSAA.yaml index b9ec149f..fc641c24 100644 --- a/TS29526_Nnssaaf_NSSAA.yaml +++ b/TS29526_Nnssaaf_NSSAA.yaml @@ -2,14 +2,14 @@ openapi: 3.0.0 info: title: Nnssaaf_NSSAA - version: 1.2.0-alpha.1 + version: 1.2.0-alpha.2 description: | Network Slice-Specific Authentication and Authorization Service. - © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS29.526, NSSAA Service, version 18.0.0. + description: 3GPP TS29.526, NSSAA Service, version 18.3.0. url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.526/ servers: @@ -46,7 +46,7 @@ paths: $ref: '#/components/schemas/SliceAuthContext' headers: Location: - description: 'Contains the URI of the newly created resource according to the structure: {apiRoot}/nnssaaf-nssaa/v1/slice-authentications/{authCtxId}' + description: 'Contains the URI of the newly created resource according to the structure: {apiRoot}/nnssaaf-nssaa//slice-authentications/{authCtxId}' required: true schema: type: string diff --git a/TS29531_Nnssf_NSSAIAvailability.yaml b/TS29531_Nnssf_NSSAIAvailability.yaml index 5ca95bbe..99a4fab1 100644 --- a/TS29531_Nnssf_NSSAIAvailability.yaml +++ b/TS29531_Nnssf_NSSAIAvailability.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: '1.3.0-alpha.3' + version: '1.3.0-alpha.4' title: 'NSSF NSSAI Availability' description: | NSSF NSSAI Availability Service. @@ -18,7 +18,7 @@ servers: default: https://example.com description: apiRoot as defined in clause 4.4 of 3GPP TS 29.501 externalDocs: - description: 3GPP TS 29.531 V18.3.0; 5G System; Network Slice Selection Services; Stage 3 + description: 3GPP TS 29.531 V18.4.0; 5G System; Network Slice Selection Services; Stage 3 url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.531/ paths: /nssai-availability/{nfId}: @@ -305,7 +305,7 @@ paths: Location: description: > Contains the URI of the newly created resource, according to the structure: - {apiRoot}/nnssf-nssaiavailability/v1/nssai-availability/subscriptions/{subscriptionId} + {apiRoot}/nnssf-nssaiavailability//nssai-availability/subscriptions/{subscriptionId} required: true schema: type: string @@ -584,11 +584,6 @@ components: items: $ref: 'TS29531_Nnssf_NSSelection.yaml#/components/schemas/NsagInfo' minItems: 1 - unavailableNsiList: - type: array - items: - $ref: 'TS29531_Nnssf_NSSelection.yaml#/components/schemas/NsiId' - minItems: 1 RestrictedSnssai: description: This contains the restricted SNssai information per PLMN @@ -632,7 +627,6 @@ components: type: object required: - nfNssaiAvailabilityUri - - taiList - event properties: nfNssaiAvailabilityUri: @@ -643,6 +637,11 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Tai' event: $ref: '#/components/schemas/NssfEventType' + additionalEvents: + type: array + items: + $ref: '#/components/schemas/NssfEventType' + minItems: 1 expiry: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' amfSetId: @@ -660,6 +659,10 @@ components: allAmfSetTaiInd: type: boolean default: false + nsrpSubscribeInfo: + $ref: '#/components/schemas/SnssaiReplacementSubscribeInfo' + nsiunSubscribeInfo: + $ref: '#/components/schemas/NsiUnavailabilitySubscribeInfo' NssfEventSubscriptionCreatedData: description: This contains the information for created event subscription @@ -684,7 +687,6 @@ components: type: object required: - subscriptionId - - authorizedNssaiAvailabilityData properties: subscriptionId: type: string @@ -701,12 +703,52 @@ components: Indicate the impacted S-NSSAIs, the current status for each reported S-NSSAI, and if available the alternative S-NSSAI per impacted S-NSSAI for the S-NSSAIs that are reported as being not available. + unavailableNsiList: + type: array + items: + $ref: 'TS29531_Nnssf_NSSelection.yaml#/components/schemas/NsiId' + minItems: 1 + + SnssaiReplacementSubscribeInfo: + description: Present if the NF service consumer subscribes to events related to Network Slice Replacement. + type: object + properties: + snssaiToSubscribe: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + nfType: + $ref: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/NFType' + nfId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/NfInstanceId' + plmnId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/PlmnId' + required: + - snssaiToSubscribe + - nfType + - nfId + + NsiUnavailabilitySubscribeInfo: + description: Present if the NF service consumer subscribes to events related to Network Slice Instance Replacement. + type: object + properties: + nsiToSubscribe: + type: array + items: + $ref: 'TS29531_Nnssf_NSSelection.yaml#/components/schemas/NsiId' + snssaiToSubscribe: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + NssfEventType: description: This contains the event for the subscription anyOf: - type: string enum: - SNSSAI_STATUS_CHANGE_REPORT + - SNSSAI_REPLACEMENT_REPORT + - NSI_UNAVAILABILITY_REPORT - type: string PatchDocument: description: This contains the JSON Patch instructions for updating the Nssai availability data information at the NSSF diff --git a/TS29535_Naanf_AKMA.yaml b/TS29535_Naanf_AKMA.yaml index 939ee94d..191e5aa4 100644 --- a/TS29535_Naanf_AKMA.yaml +++ b/TS29535_Naanf_AKMA.yaml @@ -1,14 +1,14 @@ openapi: 3.0.0 info: title: 3gpp-akma - version: 1.1.0-alpha.3 + version: 1.1.0-alpha.4 description: | API for Naanf_AKMA. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.535 V18.2.0; 5G System; AKMA Anchor Services. + description: 3GPP TS 29.535 V18.3.0; 5G System; AKMA Anchor Services. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.535/' security: @@ -203,6 +203,8 @@ components: naanf_akma:applicationkeyget: > Access to service operations applying to request the AKMA Application Key information for the UE. + naanf-akma:applicationkeyget:supi-access: > + Return SUPI in the AKMA Application Key information for the UE. schemas: AkmaKeyInfo: diff --git a/TS29536_Nnsacf_NSAC.yaml b/TS29536_Nnsacf_NSAC.yaml index eb771379..c2a50fe2 100644 --- a/TS29536_Nnsacf_NSAC.yaml +++ b/TS29536_Nnsacf_NSAC.yaml @@ -2,14 +2,14 @@ openapi: 3.0.0 info: title: Nnsacf_NSAC - version: 1.1.0-alpha.2 + version: 1.1.0-alpha.3 description: | Nnsacf_NSAC Service. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.536 V18.2.0; 5G System; Network Slice Admission Control Services; Stage 3. + description: 3GPP TS 29.536 V18.3.0; 5G System; Network Slice Admission Control Services; Stage 3. url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.536/ servers: @@ -178,7 +178,7 @@ paths: post: summary: > Network Slice Admission Control update of the local maximum number of registered UEs and/or - number of PDU sessions of the network slice at NSACF. + PDU sessions of the network slice at NSACF. operationId: LocalNumberUpdate tags: - slice collection @@ -219,6 +219,56 @@ paths: '504': $ref: 'TS29571_CommonData.yaml#/components/responses/504' + /slices/roaming-quotas/query: + post: + summary: > + Network Slice Admission Control fetching of the maximum number of registered UEs and/or + number of PDU sessions of the network slice at NSACF. + operationId: QuotaUpdate + tags: + - slice collection + security: + - {} + - oAuth2ClientCredentials: + - nnsacf-nsac + - oAuth2ClientCredentials: + - nnsacf-nsac + - nnsacf-nsac:roaming-quotas-query + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/QuotaUpdateRequestData' + required: true + responses: + '200': + description: Successful operation + content: + application/json: + schema: + $ref: '#/components/schemas/QuotaUpdateResponseData' + '307': + $ref: 'TS29571_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29571_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + '504': + $ref: 'TS29571_CommonData.yaml#/components/responses/504' + + components: securitySchemes: @@ -236,8 +286,8 @@ components: Access to service operations applying to the collection of slice subject to NSAC for PDU sessions nnsacf-nsac:ac-info-update: > - Access to the NSAC update of the local maximum number of registered UEs and/or number - of PDU sessions of the network slice at NSACF + Access to the NSAC update of the local maximum number of registered UEs and/or + PDU sessions of the network slice at NSACF schemas: @@ -320,6 +370,10 @@ components: type: boolean enum: - true + servingPlmnId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/PlmnId' + nsacMode: + $ref: '#/components/schemas/NsacAdmissionMode' required: - updateFlag - snssai @@ -416,9 +470,10 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' maxNumUes: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + ueAdmissionThreshold: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' required: - snssai - - maxNumUes PduAdmissionValue: type: object @@ -443,6 +498,33 @@ components: required: - snssai + QuotaUpdateRequestData: + type: object + properties: + snssai: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + plmnId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/PlmnId' + quotaType: + items: + $ref: '#/components/schemas/SliceQuotaType' + required: + - snssai + - plmnId + - quotaType + + QuotaUpdateResponseData: + type: object + properties: + snssai: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai' + maxUesNumber: + type: integer + maxPdusNumber: + type: integer + required: + - snssai + # # SIMPLE DATA TYPES @@ -512,3 +594,37 @@ components: - EXCEED_MAX_PDU_NUM - EXCEED_MAX_PDU_NUM_3GPP - EXCEED_MAX_PDU_NUM_N3GPP + + SliceQuotaType: + anyOf: + - type: string + enum: + - MAX_UE_NUM + - MAX_PDU_NUM + - BOTH + - 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. + description: > + Slice quota type. Possible values are + - MAX_UE_NUM + - MAX_PDU_NUM + - BOTH + + NsacAdmissionMode: + description: > + Indicates the NSAC admission mode applied in roaming case. + anyOf: + - type: string + enum: + - VPLMN_ADMISSION + - VPLMN_WITH_HPLMN_ASSISTANCE + - 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. + - VPLMN_ADMISSION + - VPLMN_WITH_HPLMN_ASSISTANCE diff --git a/TS29536_Nnsacf_SliceEventExposure.yaml b/TS29536_Nnsacf_SliceEventExposure.yaml index 7c32a149..6a9c3f28 100644 --- a/TS29536_Nnsacf_SliceEventExposure.yaml +++ b/TS29536_Nnsacf_SliceEventExposure.yaml @@ -2,14 +2,14 @@ openapi: 3.0.0 info: title: Nnsacf_SliceEventExposure - version: 1.1.0-alpha.2 + version: 1.1.0-alpha.3 description: | Nnsacf_SliceEventExposure Service. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.536 V18.2.0; 5G System; Network Slice Admission Control Services; Stage 3. + description: 3GPP TS 29.536 V18.3.0; 5G System; Network Slice Admission Control Services; Stage 3. url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.536/ servers: diff --git a/TS29538_MSGS_MSGDelivery.yaml b/TS29538_MSGS_MSGDelivery.yaml index 4e82241f..6e7b3d9a 100644 --- a/TS29538_MSGS_MSGDelivery.yaml +++ b/TS29538_MSGS_MSGDelivery.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: title: MSGS_MSGDelivery - version: 1.1.0-alpha.1 + version: 1.1.0-alpha.2 description: | API for MSGG MSGin5G Server Message Delivery Service. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -9,7 +9,7 @@ info: externalDocs: description: > - 3GPP TS 29.538 V18.1.0; Enabling MSGin5G Service; Application Programming Interfaces (API) + 3GPP TS 29.538 V18.3.0; Enabling MSGin5G Service; Application Programming Interfaces (API) specification; Stage 3 url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.538/ @@ -182,8 +182,6 @@ components: type: string msgId: type: string - secCred: - type: string delivStReqInd: type: boolean payload: @@ -218,8 +216,6 @@ components: type: string msgId: type: string - secCred: - type: string delivStReqInd: type: boolean payload: @@ -284,8 +280,6 @@ components: $ref: 'TS29538_MSGG_L3GDelivery.yaml#/components/schemas/Address' msgId: type: string - secCred: - type: string failureCause: type: string delivSt: diff --git a/TS29543_Npcf_PDTQPolicyControl.yaml b/TS29543_Npcf_PDTQPolicyControl.yaml index b9e306aa..c5188054 100644 --- a/TS29543_Npcf_PDTQPolicyControl.yaml +++ b/TS29543_Npcf_PDTQPolicyControl.yaml @@ -2,14 +2,14 @@ openapi: 3.0.0 info: title: Npcf_PDTQPolicyControl API - version: 1.0.0-alpha.1 + version: 1.0.0-alpha.2 description: | PCF PDTQ Policy Control service. © <2023>, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.543 V0.2.0; 5G System; Data Transfer Policy Control Services; Stage 3. + description: 3GPP TS 29.543 V0.3.0; 5G System; Data Transfer Policy Control Services; Stage 3. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.543/' servers: @@ -251,9 +251,9 @@ components: description: Describes an Individual PDTQ policy resource. type: object required: - - aspId - - desTimeInts - - numOfUes + - aspId + - desTimeInts + - numOfUes oneOf: - required: [qosReference] - required: [qosParamSet] @@ -276,6 +276,8 @@ components: items: type: string minItems: 1 + appId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/ApplicationId' aspId: description: Contains an identity of an application service provider. type: string @@ -401,7 +403,7 @@ components: candPolicies: description: > Contains a list of the candidate PDTQ policies from which the AF may select a new - PDTQ policy due to a network performance is below the criteria set by the operator. + PDTQ policy. type: array items: $ref: '#/components/schemas/PdtqPolicy' diff --git a/TS29548_SDD_DDContext.yaml b/TS29548_SDD_DDContext.yaml new file mode 100644 index 00000000..18e9c011 --- /dev/null +++ b/TS29548_SDD_DDContext.yaml @@ -0,0 +1,163 @@ +openapi: 3.0.0 + +info: + title: SEALDD Server Data Delivery Context Relocation + version: 1.0.0-alpha.1 + description: | + SEALDD Server Data Delivery Context Relocation. + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + All rights reserved. + +externalDocs: + description: > + 3GPP TS 29.548 V0.3.0 Service Enabler Architecture Layer for Verticals (SEAL); + SEAL Data Delivery (SEALDD) Server Services; Stage 3. + url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.548/ + +security: + - {} + - oAuth2ClientCredentials: [] + +servers: + - url: '{apiRoot}/sdd-ddc/v1' + variables: + apiRoot: + default: https://example.com + description: apiRoot as defined in clause 6.5 of 3GPP TS 29.549 + +paths: + /contexts: + get: + summary: Pull the DD context from the SEALDD Server. + operationId: PullDdContext + tags: + - DD Context Instances (Collection) + parameters: + - name: supp-feats + in: query + description: Contains the list of supported features. + required: false + schema: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' + responses: + '200': + description: Successful case. The requested DD context is returned. + content: + application/json: + schema: + $ref: '#/components/schemas/DdContextPushReq' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + + post: + summary: Push the DD context to the SEALDD Server. + tags: + - DD Context Instances (Collection) + requestBody: + description: > + Represents the DD context to be pushed to the + SEALDD Server. + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/DdContextPushReq' + responses: + '200': + description: > + Successful case. The DD context is successfully pushed to the SEALDD Server and the + related information is returned in the response body. + content: + application/json: + schema: + $ref: '#/components/schemas/DdContextPushResp' + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + +components: + securitySchemes: + oAuth2ClientCredentials: + type: oauth2 + flows: + clientCredentials: + tokenUrl: '{tokenUrl}' + scopes: {} + + schemas: + DdContext: + description: Represents the DD context. + type: object + properties: + trLayerContext: + $ref: '#/components/schemas/TranspLayerContext' + + TranspLayerContext: + description: Represents the transport layer context. + type: object + properties: + transProtoc: + $ref: 'TS29558_Eees_EASRegistration.yaml#/components/schemas/TransportProtocol' + required: + - transProtoc + + DdContextPushReq: + description: Represents the DD context relocation push request. + type: object + properties: + ddContext: + $ref: '#/components/schemas/DdContext' + suppFeat: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' + + DdContextPushResp: + description: Represents the DD context relocation push response. + type: object + properties: + endPoint: + $ref: 'TS29571_CommonData.yaml#/components/schemas/RouteInformation' + suppFeat: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' diff --git a/TS29548_SDD_Transmission.yaml b/TS29548_SDD_Transmission.yaml new file mode 100644 index 00000000..10f2ac46 --- /dev/null +++ b/TS29548_SDD_Transmission.yaml @@ -0,0 +1,184 @@ +openapi: 3.0.0 + +info: + title: SEALDD Data Transmission Service + version: 1.0.0-alpha.1 + description: | + SEALDD Server Data Transmission Service. + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + All rights reserved. + +externalDocs: + description: > + 3GPP TS 29.548 V0.3.0; Service Enabler Architecture Layer for Verticals (SEAL); + SEAL Data Delivery (SEALDD) Server Services; Stage 3. + url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.548/ + +servers: + - url: '{apiRoot}/sdd-trans/v1' + variables: + apiRoot: + default: https://example.com + description: apiRoot as defined in clause 5.2.4 of 3GPP TS 29.122 + +security: + - {} + - oAuth2ClientCredentials: [] + +paths: + /{transType}/request-trans: + parameters: + - name: transType + in: path + description: > + Represents the requested transmission type (i.e., regular or URLLC). + required: true + schema: + $ref: '#/components/schemas/TransType' + + post: + summary: Request SEALDD enabled regular or URLLC Data Transmission. + operationId: RequestTrans + tags: + - Request SEALDD Data Transmission + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/TransReq' + responses: + '200': + description: > + OK. The SEALDD enabled regular or URLLC application data transmission service request + was successfully received and processed. + content: + application/json: + schema: + $ref: '#/components/schemas/TransResp' + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + + +components: + securitySchemes: + oAuth2ClientCredentials: + type: oauth2 + flows: + clientCredentials: + tokenUrl: '{tokenUrl}' + scopes: {} + + schemas: + TransReq: + description: > + Represents the parameters to request the SEALDD enabled regular or URLLC application data + transmission service. + type: object + properties: + valServerId: + type: string + valServiceId: + type: string + valTargetUeId: + $ref: 'TS29548_SDD_TransmissionQualityMeasurement.yaml#/components/schemas/ValTargetUeId' + valServerConnInfo: + $ref: '#/components/schemas/ConnInfo' + valServerBdw: + $ref: '#/components/schemas/ValServBdw' + valUsersBdw: + $ref: '#/components/schemas/ValUsersBdw' + suppFeat: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' + required: + - valServerId + - valServerConnInfo + + TransResp: + description: > + Represents a SEALDD enabled regular or URLLC application data transmission service response. + type: object + properties: + ddServerConnInfo: + $ref: '#/components/schemas/ConnInfo' + suppFeat: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' + + ConnInfo: + description: > + Represents SEALDD Data transmission connection information. + type: object + properties: + ipv4Addr: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Ipv4Addr' + ipv6Addr: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Ipv6Addr' + port: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Port' + uri: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Uri' + oneOf: + - required: [ipv4Addr] + - required: [ipv6Addr] + - required: [uri] + + ValServBdw: + description: > + Represents VAL Server related bandwidth information. + type: object + properties: + totalUlBdw: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Bandwidth' + totalDlBdw: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Bandwidth' + required: + - totalUlBdw + - totalDlBdw + + ValUsersBdw: + description: > + Represents VAL users related bandwidth information. + type: object + properties: + minUlBdw: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Bandwidth' + minDlBdw: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Bandwidth' + maxUlBdw: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Bandwidth' + maxDlBdw: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Bandwidth' + required: + - minUlBdw + - minDlBdw + - maxUlBdw + - maxDlBdw + + TransType: + description: > + Represents the requested transmission type (i.e., regular or URLLC). + type: string diff --git a/TS29548_SDD_TransmissionQualityMeasurement.yaml b/TS29548_SDD_TransmissionQualityMeasurement.yaml index 45528049..36b594cf 100644 --- a/TS29548_SDD_TransmissionQualityMeasurement.yaml +++ b/TS29548_SDD_TransmissionQualityMeasurement.yaml @@ -2,7 +2,7 @@ openapi: 3.0.0 info: title: SEALDD Server Data Transmission Quality Measurement Service - version: 1.0.0-alpha.1 + version: 1.0.0-alpha.2 description: | SEALDD Server Data Transmission Quality Measurement Service. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ info: externalDocs: description: > - 3GPP TS 29.548 V0.2.0; Service Enabler Architecture Layer for Verticals (SEAL); + 3GPP TS 29.548 V0.3.0; Service Enabler Architecture Layer for Verticals (SEAL); SEAL Data Delivery (SEALDD) Server Services; Stage 3. url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.548/ @@ -256,6 +256,77 @@ paths: default: $ref: 'TS29122_CommonData.yaml#/components/responses/default' + /reports: + get: + summary: Retrieve Historical Transmission Quality Measurement Report(s). + operationId: GetHistTransQualMeasReports + tags: + - Historical Transmission Quality Measurement Reports (Collection) + parameters: + - name: app-traffic-ids + in: query + required: true + schema: + type: array + items: + type: string + minItems: 1 + - name: val-group-id + in: query + required: false + schema: + type: string + - name: val-ue-ids-list + in: query + required: false + schema: + type: array + items: + $ref: '#/components/schemas/ValTargetUeId' + minItems: 1 + - name: all-val-ues + in: query + required: false + schema: + type: boolean + default: false + - name: supp-feat + in: query + required: false + schema: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' + responses: + '200': + description: > + OK. The requested Historical Transmission Quality Measurement Report(s) shall be + returned. + content: + application/json: + schema: + $ref: '#/components/schemas/HistTransQualMeasReports' + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '406': + $ref: 'TS29122_CommonData.yaml#/components/responses/406' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + components: securitySchemes: oAuth2ClientCredentials: @@ -281,15 +352,18 @@ components: valUeIdsList: type: array items: - $ref: 'TS29549_SS_UserProfileRetrieval.yaml#/components/schemas/ValTargetUe' + $ref: '#/components/schemas/ValTargetUeId' minItems: 1 allValUesInd: type: boolean + default: false measConds: type: array items: $ref: 'TS29549_SS_Events.yaml#/components/schemas/ValidityConditions' minItems: 1 + subsExpTime: + $ref: 'TS29122_CommonData.yaml#/components/schemas/DateTimeRo' suppFeat: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' required: @@ -299,6 +373,26 @@ components: - required: [valUeIdsList] - required: [allValUesInd] + TransQualMeasReq: + description: > + Represents Transmission Quality Measurement requirements. + type: object + properties: + measId: + $ref: '#/components/schemas/MeasurementId' + repType: + $ref: 'TS29508_Nsmf_EventExposure.yaml#/components/schemas/NotificationMethod' + repPeriodicity: + $ref: 'TS29122_CommonData.yaml#/components/schemas/DurationSec' + repGranularity: + $ref: '#/components/schemas/RepGranularity' + measWindow: + $ref: 'TS29122_CommonData.yaml#/components/schemas/TimeWindow' + measExpTime: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' + required: + - measId + TransQualMeasSubscPatch: description: > Represents the requested modifications to a Transmission Quality Measurement subscription. @@ -309,3 +403,103 @@ components: items: $ref: 'TS29549_SS_Events.yaml#/components/schemas/ValidityConditions' minItems: 1 + + TransQualMeasNotif: + description: > + Represents a Transmission Quality Measurement notification. + type: object + properties: + reports: + type: array + items: + $ref: '#/components/schemas/TransQualMeasReport' + minItems: 1 + + TransQualMeasReport: + description: > + Represents a Transmission Quality Measurement report. + type: object + properties: + measId: + $ref: '#/components/schemas/MeasurementId' + valUeIds: + type: array + items: + $ref: '#/components/schemas/ValTargetUeId' + minItems: 1 + required: + - measId + + ValTargetUeId: + description: Represents the identifier of a targeted VAL UE. + type: object + properties: + valUserId: + type: string + valUeId: + type: string + valUeIpv4Addr: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Ipv4Addr' + valUeIpv6Addr: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Ipv6Addr' + port: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Port' + oneOf: + - required: [valUserId] + - required: [valUeId] + - required: [valUeIpv4Addr] + - required: [valUeIpv6Addr] + + HistTransQualMeasReports: + description: > + Represents Historical Transmission Quality Measurement Report(s). + type: object + properties: + reports: + type: array + items: + $ref: '#/components/schemas/TransQualMeasReport' + minItems: 0 + suppFeat: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' + required: + - reports + + MeasurementId: + anyOf: + - type: string + enum: + - LATENCY + - BITRATE + - PACKET_LOSS_RATE + - JITTER + - 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 transmission quality measurement type. + Possible values are: + - LATENCY: Indicates that the requested/reported measurement is the latency. + - BITRATE: Indicates that the requested/reported measurement is the bit rate. + - PACKET_LOSS_RATE: Indicates that the requested/reported measurement is the packet loss + rate. + - JITTER: Indicates that the requested/reported measurement is the jitter. + + RepGranularity: + anyOf: + - type: string + enum: + - INDIVIDUAL_VAL_UE + - VAL_GROUP + - ALL_UES + - 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 reporting granularity. + Possible values are: + - INDIVIDUAL_VAL_UE: Indicates that the requested granularity is individual VAL UE. + - VAL_GROUP: Indicates that the requested granularity is VAL Group. + - ALL_UES: Indicates that the requested granularity is all UE(s). diff --git a/TS29549_SS_Events.yaml b/TS29549_SS_Events.yaml index cde75048..4df2ea6c 100644 --- a/TS29549_SS_Events.yaml +++ b/TS29549_SS_Events.yaml @@ -6,11 +6,11 @@ info: API for SEAL Events management. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. - version: "1.2.0-alpha.2" + version: "1.2.0-alpha.3" externalDocs: description: > - 3GPP TS 29.549 V18.2.0 Service Enabler Architecture Layer for Verticals (SEAL); + 3GPP TS 29.549 V18.3.0 Service Enabler Architecture Layer for Verticals (SEAL); Application Programming Interface (API) specification; Stage 3. url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.549/ @@ -620,12 +620,17 @@ components: description: List of VAL Users or UE IDs for which location monitoring is requested. locInt: $ref: 'TS29122_MonitoringEvent.yaml#/components/schemas/LocationInfo' + valSvcId: + description: Identifier of the VAL service area to monitor the location deviation. + type: string notInt: $ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec' required: - tgtUes - - locInt - notInt + oneOf: + - required: [locInt] + - required: [valSrvId] LocationDevMonReport: description: Location deviation monitoring report. diff --git a/TS29549_SS_LocationAreaInfoRetrieval.yaml b/TS29549_SS_LocationAreaInfoRetrieval.yaml index e560435f..a922c05d 100644 --- a/TS29549_SS_LocationAreaInfoRetrieval.yaml +++ b/TS29549_SS_LocationAreaInfoRetrieval.yaml @@ -6,11 +6,11 @@ info: API for SEAL Location Area Info Retrieval. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. - version: "1.1.0-alpha.1" + version: "1.1.0-alpha.2" externalDocs: description: > - 3GPP TS 29.549 V18.1.0 Service Enabler Architecture Layer for Verticals (SEAL); + 3GPP TS 29.549 V18.3.0 Service Enabler Architecture Layer for Verticals (SEAL); Application Programming Interface (API) specification; Stage 3. url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.549/ @@ -40,6 +40,12 @@ paths: required: true schema: $ref: 'TS29122_MonitoringEvent.yaml#/components/schemas/LocationInfo' + - name: val-svc-area-id + in: query + description: > + The val service area identifier around which which the UE(s) information is requested. + schema: + type: string - name: range in: query description: > diff --git a/TS29549_SS_NetworkResourceAdaptation.yaml b/TS29549_SS_NetworkResourceAdaptation.yaml index 66300895..f97e8d31 100644 --- a/TS29549_SS_NetworkResourceAdaptation.yaml +++ b/TS29549_SS_NetworkResourceAdaptation.yaml @@ -1,6 +1,6 @@ openapi: 3.0.0 info: - version: 1.2.0-alpha.2 + version: 1.2.0-alpha.3 title: SS_NetworkResourceAdaptation description: | SS Network Resource Adaptation Service. @@ -9,7 +9,7 @@ info: externalDocs: description: > - 3GPP TS 29.549 V18.2.0; Service Enabler Architecture Layer for Verticals (SEAL); + 3GPP TS 29.549 V18.3.0; Service Enabler Architecture Layer for Verticals (SEAL); Application Programming Interface (API) specification; Stage 3. url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.549/ @@ -403,6 +403,116 @@ paths: default: $ref: 'TS29122_CommonData.yaml#/components/responses/default' + /mbs-resources/{mbsResId}/activate: + parameters: + - name: mbsResId + in: path + description: Represents the identifier of the Individual MBS Resource resource. + required: true + schema: + type: string + + post: + summary: Request the activation of an existing MBS Resource. + operationId: ActivateMBSResource + tags: + - Individual MBS Resource (Document) + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/MbsResAct' + responses: + '200': + description: > + OK. The activation request is successfully received and processed. + content: + application/json: + schema: + $ref: '#/components/schemas/MbsResAct' + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + + /mbs-resources/{mbsResId}/deactivate: + parameters: + - name: mbsResId + in: path + description: Represents the identifier of the Individual MBS Resource resource. + required: true + schema: + type: string + + post: + summary: Request the deactivation of an existing MBS Resource. + operationId: DeactivateMBSResource + tags: + - Individual MBS Resource (Document) + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/MbsResDeact' + responses: + '200': + description: > + OK. The deactivation request is successfully received and processed. + content: + application/json: + schema: + $ref: '#/components/schemas/MbsResDeact' + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + /unicast-subscriptions: post: summary: Creates a new Individual Unicast Subscription resource @@ -1090,6 +1200,28 @@ components: not: required: [localMbmsInfo, localMbmsActInd] + MbsResAct: + description: Represents the parameters related to the activation of the MBS Resource. + type: object + properties: + mbs5gSessionId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/MbsSessionId' + suppFeat: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' + required: + - mbs5gSessionId + + MbsResDeact: + description: Represents the parameters related to the deactivation of the MBS Resource. + type: object + properties: + mbs5gSessionId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/MbsSessionId' + suppFeat: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' + required: + - mbs5gSessionId + # Simple data types and Enumerations diff --git a/TS29558_Ecas_SelectedEES.yaml b/TS29558_Ecas_SelectedEES.yaml new file mode 100644 index 00000000..ac78c904 --- /dev/null +++ b/TS29558_Ecas_SelectedEES.yaml @@ -0,0 +1,105 @@ +openapi: 3.0.0 + +info: + title: Selected EES Service + version: 1.0.0-alpha.1 + description: | + Selected EES Service. + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + All rights reserved. + +externalDocs: + description: > + 3GPP TS 29.558 V18.3.0; Enabling Edge Applications; + Application Programming Interface (API) specification; Stage 3. + url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.558/ + +security: + - {} + - oAuth2ClientCredentials: [] + +servers: + - url: '{apiRoot}/ecas-selected-ees/v1' + variables: + apiRoot: + default: https://example.com + description: apiRoot as defined in clause 5.2.4 of 3GPP TS 29.122 + +paths: + /declare: + post: + summary: Declare the selected EES to the CAS. + operationId: DeclareSelectedEES + tags: + - Declare Selected EES + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/SelEESDecInfo' + responses: + '204': + description: > + No Content. The Seleted EES Declaration request is received + successfully. + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + +components: + + securitySchemes: + oAuth2ClientCredentials: + type: oauth2 + flows: + clientCredentials: + tokenUrl: '{tokenUrl}' + scopes: {} + + schemas: + SelEESDecInfo: + description: > + Represents the information elements for the selected EES declaration. + type: object + properties: + ueId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Gpsi' + seleEesId: + type: string + seleEndpoint: + $ref: 'TS29558_Eees_EASRegistration.yaml#/components/schemas/EndPoint' + easId: + type: string + acId: + type: string + suppFeat: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' + required: + - ueId + - seleEesId + - seleEndpoint + - easId diff --git a/TS29558_Eecs_EESRegistration.yaml b/TS29558_Eecs_EESRegistration.yaml index ba05e4e9..f242e52e 100644 --- a/TS29558_Eecs_EESRegistration.yaml +++ b/TS29558_Eecs_EESRegistration.yaml @@ -6,11 +6,11 @@ info: API for EES Registration. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. - version: 1.1.0-alpha.3 + version: 1.1.0-alpha.4 externalDocs: description: > - 3GPP TS 29.558 V18.2.0 Enabling Edge Applications; + 3GPP TS 29.558 V18.3.0 Enabling Edge Applications; Application Programming Interface (API) specification; Stage 3 url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.558/ @@ -321,7 +321,10 @@ components: additionalProperties: $ref: '#/components/schemas/EASInstantiationInfo' minProperties: 1 - description: List of EAS(s) with the associated instantiation status and the criteria. + description: > + Represents the EAS instantiation information for the EAS(s) registered at the EES. + The key of the map shall be the EAS ID to which the provided instantiation information + within the map value relates. provId: type: string description: Identifier of the ECSP that provides the EES provider. @@ -415,7 +418,7 @@ components: EASInstantiationInfo: type: object - description: Represents the instantiation status and criteria information of a given EAS. + description: Represents the EAS instantiation information. properties: easId: type: string @@ -430,7 +433,7 @@ components: InstantiationCriteria: type: object - description: Represents the instantiation criteria for the instantiable EAS. + description: Represents the instantiation criteria for an EAS. properties: instantiationTime: type: array @@ -478,7 +481,7 @@ components: extensions to the enumeration but is not used to encode content defined in the present version of this API. description: | - Represents the instantiation status information of the EAS. + Represents the instantiation status information of an EAS. Possible values are: - - INSTANTIATED: Indicates the EAS status as instantiated. - - INSTANTIABLE: Indicates the EAS status as instantiable, nut not to be instantiated yet. + - INSTANTIATED: Indicates that the EAS status is instantiated. + - INSTANTIABLE: Indicates that the EAS status is instantiable but not yet instantiated. diff --git a/TS29558_Eecs_TargetEESDiscovery.yaml b/TS29558_Eecs_TargetEESDiscovery.yaml index e4bbd45f..f28e31ac 100644 --- a/TS29558_Eecs_TargetEESDiscovery.yaml +++ b/TS29558_Eecs_TargetEESDiscovery.yaml @@ -3,12 +3,12 @@ info: title: ECS Target EES Discovery API description: | API for Target EES Discovery. - © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. - version: 1.1.0-alpha.1 + version: 1.1.0-alpha.2 externalDocs: description: > - 3GPP TS 29.558 V18.0.0 Enabling Edge Applications; + 3GPP TS 29.558 V18.3.0 Enabling Edge Applications; Application Programming Interface (API) specification; Stage 3 url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.558/ security: @@ -60,6 +60,49 @@ paths: required: false schema: $ref: 'TS29122_CommonData.yaml#/components/schemas/LocationArea5G' + - name: eec-srv-cont-supp + in: query + description: > + Indicates whether the EEC supports service continuity or not and the related service + continuity support information. + required: false + schema: + $ref: 'TS29558_Eees_EECContextRelocation.yaml#/components/schemas/EECSrvContinuitySupport' + - name: ac-svc-cont-supp + in: query + description: > + Indicates that the AC supports service continuity and contains the related service + continuity support information (i.e., supported ACR scenarios). + required: false + schema: + type: array + items: + $ref: 'TS29558_Eecs_EESRegistration.yaml#/components/schemas/ACRScenario' + minItems: 1 + - name: bdl-id + in: query + description: > + Contains EAS bundle identifier. + required: false + schema: + type: string + - name: bdl-type + in: query + description: > + Contains EAS bundle type. + required: false + schema: + $ref: 'TS29558_Eees_EASRegistration.yaml#/components/schemas/BdlType' + - name: ens-ind + in: query + description: indicates whether edge node sharing is requested. + required: false + schema: + type: boolean + description: > + Set to true if edge node sharing is requested. + Set to false if edge node sharing is not requested. + The default value when omitted is false. responses: '200': description: The EDN configuration and the T-EES information determined by ECS. diff --git a/TS29558_Eees_ACRManagementEvent.yaml b/TS29558_Eees_ACRManagementEvent.yaml index e730ca8c..3c32c53e 100644 --- a/TS29558_Eees_ACRManagementEvent.yaml +++ b/TS29558_Eees_ACRManagementEvent.yaml @@ -6,11 +6,11 @@ info: API for EES ACR Management Event. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. - version: 1.1.0-alpha.3 + version: 1.1.0-alpha.4 externalDocs: description: > - 3GPP TS 29.558 V18.2.0 Enabling Edge Applications; + 3GPP TS 29.558 V18.3.0 Enabling Edge Applications; Application Programming Interface (API) specification; Stage 3 url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.558/ @@ -491,6 +491,14 @@ components: description: A list of EAS characteristics. trafFilterInfo: $ref: '#/components/schemas/TrafficFilterInfo' + servContPlanInd: + type: boolean + description: > + Represents the service continuity planning indication (i.e., whether or not the EES + shall monitor whether the UE(s) enter the predicted location). + When set to true, it indicates that service continuity planning is required. + When set to false, it indicates that Service continuity planning is not required. + The default value when this attribute is omitted is false. required: - event @@ -547,6 +555,19 @@ components: $ref: '#/components/schemas/ACRParameters' acId: type: string + selACRScen: + type: array + items: + $ref: '#/components/schemas/SelectedACRScenarios' + minItems: 1 + servContPlanInd: + type: boolean + description: > + Represents the service continuity planning indication (i.e., whether or not the EES will + monitor whether the UE(s) enter the predicted location). + When set to true, it indicates that service continuity planning will be performed. + When set to false, it indicates that Service continuity planning will not be performed. + The default value when this attribute is omitted is false. required: - event @@ -670,6 +691,25 @@ components: - required: [uris] - required: [domainNames] + SelectedACRScenarios: + type: object + description: > + Represents the selected ACR scenario(s) applicable for a given combination of AC and UE. + properties: + acrList: + type: array + items: + $ref: 'TS29558_Eecs_EESRegistration.yaml#/components/schemas/ACRScenario' + minItems: 0 + acId: + type: string + ueId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Gpsi' + required: + - acrList + - acId + - ueId + # # ENUMERATIONS DATA TYPES # diff --git a/TS29558_Eees_ACRParameterInformation.yaml b/TS29558_Eees_ACRParameterInformation.yaml index 7bc3f625..7088aa06 100644 --- a/TS29558_Eees_ACRParameterInformation.yaml +++ b/TS29558_Eees_ACRParameterInformation.yaml @@ -2,7 +2,7 @@ openapi: 3.0.0 info: title: EES ACR Parameters Information Service - version: 1.0.0-alpha.1 + version: 1.0.0-alpha.2 description: | EES ACR Parameters Information Service. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ info: externalDocs: description: > - 3GPP TS 29.558 V18.2.0; Enabling Edge Applications; + 3GPP TS 29.558 V18.3.0; Enabling Edge Applications; Application Programming Interface (API) specification; Stage 3. url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.558/ @@ -26,7 +26,7 @@ servers: description: apiRoot as defined in clause 5.2.4 of 3GPP TS 29.122 paths: - /send-acrparaminfo: + /send-acrparamsinfo: post: summary: Request to send ACR parameters information. operationId: Request diff --git a/TS29558_Eees_CommonEASAnnouncement.yaml b/TS29558_Eees_CommonEASAnnouncement.yaml new file mode 100644 index 00000000..1ddb5711 --- /dev/null +++ b/TS29558_Eees_CommonEASAnnouncement.yaml @@ -0,0 +1,101 @@ +openapi: 3.0.0 + +info: + title: EES Announce Common EAS Information Service + version: 1.0.0-alpha.1 + description: | + EES Announce Common EAS Information Service. + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + All rights reserved. + +externalDocs: + description: > + 3GPP TS 29.558 V18.3.0; Enabling Edge Applications; + Application Programming Interface (API) specification; Stage 3. + url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.558/ + +security: + - {} + - oAuth2ClientCredentials: [] + +servers: + - url: '{apiRoot}/eees-common-eas/v1' + variables: + apiRoot: + default: https://example.com + description: apiRoot as defined in clause 5.2.4 of 3GPP TS 29.122 + +paths: + /announce-common-eas: + post: + summary: Request to announce common EAS information. + operationId: Request + tags: + - Announce common EAS Information + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/CommonEASInfo' + responses: + '204': + description: > + No Content. The common EAS information is successfully received and no content is + returned in the response body. + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + +components: + + securitySchemes: + oAuth2ClientCredentials: + type: oauth2 + flows: + clientCredentials: + tokenUrl: '{tokenUrl}' + scopes: {} + + schemas: + CommonEASInfo: + description: > + Represents the common EAS information. + type: object + properties: + eesId: + type: string + description: Represents the identifier of the announcing EES sending the request. + easId: + type: string + description: Represents the EAS ID of the common EAS + appGrpId: + type: string + description: Represents the unique identifier of the group of UEs using same application. + required: + - eesId + - easId + - appGrpId diff --git a/TS29558_Eees_EASRegistration.yaml b/TS29558_Eees_EASRegistration.yaml index cfb21edd..6b226144 100644 --- a/TS29558_Eees_EASRegistration.yaml +++ b/TS29558_Eees_EASRegistration.yaml @@ -6,11 +6,11 @@ info: API for EAS Registration. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. - version: 1.1.0-alpha.3 + version: 1.1.0-alpha.4 externalDocs: description: > - 3GPP TS 29.558 V18.2.0 Enabling Edge Applications; + 3GPP TS 29.558 V18.3.0 Enabling Edge Applications; Application Programming Interface (API) specification; Stage 3 url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.558/ @@ -408,8 +408,54 @@ components: bdlId: type: string description: Indicates a bundle ID. + easIdsList: + type: array + items: + type: string + minItems: 1 + bdlType: + $ref: '#/components/schemas/BdlType' + easBdlReqs: + $ref: '#/components/schemas/EASBdlReqs' + mainEasId: + type: string + required: + - bdlType + oneOf: + - required: [bdlId] + - required: [easIdsList] + + EASBdlReqs: + type: object + description: Represents the EAS bundle requirements. + properties: + coordinatedEasDisc: + type: boolean + default: false + description: > + Set to true to indicate that coordianted EAS discovery is required. + Set to false to indicate that coordianted EAS discovery is not required. + The default value when this attribute is omitted is false. + coordinatedAcr: + $ref: '#/components/schemas/CoordinatedAcrReqs' + affinity: + $ref: '#/components/schemas/Affinity' + + CoordinatedAcrReqs: + type: object + description: Represents the coordinated ACR related requirements for an EAS bundle. + properties: + coordinatedAcrInd: + type: boolean + default: false + description: > + Set to true to indicate that coordianted ACR is required. + Set to false to indicate that coordianted ACR is not required. + The default value when this attribute is omitted is false. + failureAction: + $ref: '#/components/schemas/FailureAction' required: - - bdlId + - coordinatedAcrInd EndPoint: type: object @@ -514,3 +560,58 @@ components: - TCP: Indicates the Transmission Control (TCP) Protocol. - TCP_TLS: Indicates the Transmission Control Protocol (TCP) with Transport Layer Security (TLS) protocol. + + BdlType: + anyOf: + - type: string + enum: + - DIRECT + - PROXY + - 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 EAS Bundle type. + Possible values are: + - DIRECT: Indicates that the EAS Bundle type is direct bundle. + - PROXY: Indicates that the EAS Bundle type is proxy bundle. + + Affinity: + anyOf: + - type: string + enum: + - STRONG + - PREFERRED + - WEAK + - 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 affinity requirements of an EAS bundle. + Possible values are: + - STRONG: Indicates that the affinity is strong, i.e., all the EASs of the bundle shall be + in the same EDN. + - PREFERRED: Indicates that the affinity is preferred, i.e., it is nice to have all the EASs + of the bundle in the same EDN, but it is not essential. + - WEAK: Indicates that the affinity is weak, i.e., it is not essential to have all the EASs + of the bundle in the same EDN. + + FailureAction: + anyOf: + - type: string + enum: + - CANCEL + - PROCEED + - 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 EAS bundle related failure action during ACR. + Possible values are: + - CANCEL: Indicates that ACR shall be cancelled for the other EAS(s) of the bundle for which + ACR is not failed. + - PROCEED: Indicates that ACR shall proceed for the other EAS(s) of the bundle for which + ACR is not failed. diff --git a/TS29562_Nhss_imsUECM.yaml b/TS29562_Nhss_imsUECM.yaml index 22bbced8..f58420b4 100644 --- a/TS29562_Nhss_imsUECM.yaml +++ b/TS29562_Nhss_imsUECM.yaml @@ -1,15 +1,15 @@ openapi: 3.0.0 info: - version: '1.2.0-alpha.1' + version: '1.2.0-alpha.2' title: 'Nhss_imsUECM' description: | Nhss UE Context Management Service for IMS. - © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.562 Home Subscriber Server (HSS) Services, version 18.0.0 + description: 3GPP TS 29.562 Home Subscriber Server (HSS) Services, version 18.2.0 url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.562/' servers: @@ -168,7 +168,7 @@ paths: Location: description: > Contains the URI of the newly created resource, according to the structure: - {apiRoot}/nhss-ims-uecm/v1/{impu}/scscf-registration + {apiRoot}/nhss-ims-uecm/v1/{imsUeId}/scscf-registration required: true schema: type: string @@ -213,7 +213,7 @@ paths: default: $ref: 'TS29571_CommonData.yaml#/components/responses/default' - /{impu}/scscf-registration/scscf-restoration-info: + /{imsUeId}/scscf-registration/scscf-restoration-info: put: summary: Update the S-CSCF restoration information of the UE operationId: UpdateScscfRestorationInfo @@ -227,12 +227,12 @@ paths: - nhss-ims-uecm - nhss-ims-uecm:restoration:modify parameters: - - name: impu + - name: imsUeId in: path - description: Public identity of the user. + description: IMS Identity. required: true schema: - $ref: '#/components/schemas/Impu' + $ref: '#/components/schemas/ImsUeId' requestBody: content: application/json: @@ -250,7 +250,7 @@ paths: Location: description: > Contains the URI of the newly created resource, according to the structure: - {apiRoot}/nhss-ims-uecm/v1/{impu}/scscf-registration/scscf-restoration-info + {apiRoot}/nhss-ims-uecm/v1/{imsUeId}/scscf-registration/scscf-restoration-info required: true schema: type: string diff --git a/TS29563_Nhss_EE.yaml b/TS29563_Nhss_EE.yaml index 671c25a0..7fcdd1bc 100644 --- a/TS29563_Nhss_EE.yaml +++ b/TS29563_Nhss_EE.yaml @@ -1,15 +1,15 @@ openapi: 3.0.0 info: - version: '1.2.0-alpha.1' + version: '1.2.0-alpha.2' title: 'Nhss_EE' description: | HSS Event Exposure. - © 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.563 HSS Services for Interworking With UDM, version 18.0.0 + description: 3GPP TS 29.563 HSS Services for Interworking With UDM, version 18.3.0 url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.563/' servers: @@ -283,7 +283,9 @@ components: type: string CreatedEeSubscription: - description: It represents the response body of the subscription request, containing data of the created subscription in the HSS + description: > + It represents the response body of the subscription request, containing data of the created + subscription in the HSS type: object required: - eeSubscription @@ -296,11 +298,18 @@ components: $ref: '#/components/schemas/MonitoringReport' minItems: 1 failedMonitoringConfigs: - description: A map (list of key-value pairs where referenceId converted from integer to string serves as key; see clause 6.4.6.3.2) of FailedMonitoringConfiguration + description: > + A map (list of key-value pairs where referenceId converted from integer to string serves + as key; see clause 6.4.6.3.2) of FailedMonitoringConfiguration type: object additionalProperties: $ref: '#/components/schemas/FailedMonitoringConfiguration' minProperties: 1 + currentStatusNotAvailableList: + type: array + items: + $ref: '#/components/schemas/EventType' + minItems: 1 supportedFeatures: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' @@ -347,7 +356,7 @@ components: - timeStamp properties: referenceId: - $ref: '#/components/schemas/ReferenceId' + $ref: 'TS29503_Nudm_EE.yaml#/components/schemas/ReferenceId' eventType: $ref: '#/components/schemas/EventType' timeStamp: @@ -446,10 +455,6 @@ components: # SIMPLE TYPES: - ReferenceId: - description: The ID to refer to a given Monitoring Event (and its corresponding Monitoring Configuration and Monitoring Event Report) - type: integer - Imsi: description: IMSI of the UE type: string diff --git a/TS29564_Nupf_EventExposure.yaml b/TS29564_Nupf_EventExposure.yaml index 74903799..96f3254c 100644 --- a/TS29564_Nupf_EventExposure.yaml +++ b/TS29564_Nupf_EventExposure.yaml @@ -2,14 +2,14 @@ openapi: 3.0.0 info: title: 'UPF Event Exposure Service' - version: 1.1.0-alpha.2 + version: 1.1.0-alpha.3 description: | UPF Event Exposure Service. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.564 V18.1.0; 5G System; User Plane Function Services; Stage 3. + description: 3GPP TS 29.564 V18.2.0; 5G System; User Plane Function Services; Stage 3. url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.564/ servers: @@ -279,7 +279,7 @@ components: anyOf: - required: [ ueIpv4Addr ] - required: [ ueIpv6Prefix ] -# anyOf construct requires further considerations to cover non-IP PDU sessions and subscription for ANY UE + - required: [ ueMacAddr ] properties: eventType: $ref: '#/components/schemas/EventType' @@ -397,7 +397,7 @@ components: trafficFilters: type: array items: - $ref: 'TS29122_CommonData.yaml#/components/schemas/FlowInfo' + $ref: 'TS29512_Npcf_SMPolicyControl.yaml#/components/schemas/FlowInformation' minItems: 1 granularityOfMeasurement: $ref: '#/components/schemas/GranularityOfMeasurement' @@ -451,6 +451,16 @@ components: description: QoS Monitoring Measurement information type: object properties: + flowInfos: + type: array + items: + $ref: 'TS29512_Npcf_SMPolicyControl.yaml#/components/schemas/FlowInformation' + minItems: 1 + appIds: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/ApplicationId' + minItems: 1 dlPacketDelay: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uint32' ulPacketDelay: @@ -461,6 +471,25 @@ components: type: boolean enum: - true + dlMinThroughput: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + dlMaxThroughput: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + dlAveThroughput: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + ulMinThroughput: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + ulMaxThroughput: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + ulAveThroughput: + $ref: 'TS29571_CommonData.yaml#/components/schemas/BitRate' + dlCongestion: + type: string + ulCongestion: + type: string +# Editor's note: whether and how to report the minimum, maximum and average DL and/or UL throughput +# over the measurement period is FFS. +# Editor's note: the encoding of the dlCongestion and ulCongestion IEs is FFS TscManagementInfo: description: TSC Management Information @@ -482,7 +511,7 @@ components: appId: $ref: 'TS29571_CommonData.yaml#/components/schemas/ApplicationId' flowInfo: - $ref: 'TS29122_CommonData.yaml#/components/schemas/FlowInfo' + $ref: 'TS29512_Npcf_SMPolicyControl.yaml#/components/schemas/FlowInformation' volumeMeasurement: $ref: '#/components/schemas/VolumeMeasurement' throughputMeasurement: @@ -565,6 +594,8 @@ components: properties: domainName: $ref: 'TS29571_CommonData.yaml#/components/schemas/Fqdn' + domainNameProtocol: + $ref: '#/components/schemas/DnProtocol' required: - domainName @@ -588,11 +619,9 @@ components: - type: string enum: - ONE_TIME - - CONTINUOUS - PERIODIC - type: string -# The need for the CONTINUOUS value is FFS MeasurementType: description: Measurement Type @@ -614,4 +643,16 @@ components: - PER_FLOW - type: string + DnProtocol: + description: Domain Name Protocol + anyOf: + - type: string + enum: + - DNS_QNAME + - TLS_SNI + - TLS_SAN + - TLS_SCN + - type: string + + # SIMPLE TYPES diff --git a/TS29565_Ntsctsf_QoSandTSCAssistance.yaml b/TS29565_Ntsctsf_QoSandTSCAssistance.yaml index c5cdec8b..9932b9f6 100644 --- a/TS29565_Ntsctsf_QoSandTSCAssistance.yaml +++ b/TS29565_Ntsctsf_QoSandTSCAssistance.yaml @@ -2,7 +2,7 @@ openapi: 3.0.0 info: title: Ntsctsf_QoSandTSCAssistance Service API - version: 1.1.0-alpha.3 + version: 1.1.0-alpha.4 description: | TSCTSF QoS and TSC Assistance Service. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ info: externalDocs: description: > - 3GPP TS 29.565 V18.2.0; 5G System; Time Sensitive Communication and Time Synchronization function + 3GPP TS 29.565 V18.3.0; 5G System; Time Sensitive Communication and Time Synchronization function Services; Stage 3. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.565/' @@ -52,9 +52,10 @@ paths: description: > Contains the URI of the created individual TSC application session context resource, according to the structure - {apiRoot}/ntsctsf-qos-tscai/v1/tsc-app-sessions/{appSessionId} or the URI of the - created events subscription sub-resource, according to the structure - {apiRoot}/ntsctsf-qos-tscai/v1/tsc-app-sessions/{appSessionId}/events-subscription} + {apiRoot}/ntsctsf-qos-tscai//tsc-app-sessions/{appSessionId} or the + URI of the created events subscription sub-resource, according to the structure + {apiRoot}/ntsctsf-qos-tscai//tsc-app-sessions/{appSessionId}/ + events-subscription} required: true schema: type: string @@ -428,7 +429,8 @@ paths: description: > Contains the URI of the created Events Subscription resource, according to the structure - {apiRoot}/ntsctsf-qos-tscai/v1/tsc-app-sessions/{appSessionId}/events-subscription} + {apiRoot}/ntsctsf-qos-tscai//tsc-app-sessions/{appSessionId}/ + events-subscription} required: true schema: type: string @@ -574,13 +576,18 @@ components: - notifUri - afId - qosReference - oneOf: - - required: [ueIpAddr] - - required: [ueMac] - - required: [ueId] - - required: [externalGroupId] - not: - required: [ethFlowInfo, enEthFlowInfo] + allOf: + - oneOf: + - required: [ueIpAddr] + - required: [ueMac] + - required: [ueId] + - required: [externalGroupId] + - not: + required: [ethFlowInfo, enEthFlowInfo] + - not: + required: [altQosReqs, altQosReferences] + - not: + required: [qosReference, altQosReqs] properties: ueIpAddr: $ref: 'TS29571_CommonData.yaml#/components/schemas/IpAddr' @@ -653,7 +660,6 @@ components: $ref: '#/components/schemas/EventsSubscReqData' tempInValidity: $ref: '#/components/schemas/TemporalInValidity' - suppFeat: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' @@ -716,8 +722,13 @@ components: $ref: '#/components/schemas/EventsSubscReqDataRm' tempInValidity: $ref: '#/components/schemas/TemporalInValidity' - not: - required: [ethFlowInfo, enEthFlowInfo] + allOf: + - not: + required: [ethFlowInfo, enEthFlowInfo] + - not: + required: [altQosReqs, altQosReferences] + - not: + required: [qosReference, altQosReqs] EventsSubscReqData: description: Identifies the events the application subscribes to. @@ -830,6 +841,9 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' stopTime: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' + required: + - startTime + - stopTime # # ENUMERATIONS DATA TYPES diff --git a/TS29565_Ntsctsf_TimeSynchronization.yaml b/TS29565_Ntsctsf_TimeSynchronization.yaml index e361f19d..4f629ac6 100644 --- a/TS29565_Ntsctsf_TimeSynchronization.yaml +++ b/TS29565_Ntsctsf_TimeSynchronization.yaml @@ -2,7 +2,7 @@ openapi: 3.0.0 info: title: Ntsctsf_TimeSynchronization Service API - version: 1.1.0-alpha.3 + version: 1.1.0-alpha.4 description: | TSCTSF Time Synchronization Service. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ info: externalDocs: description: > - 3GPP TS 29.565 V18.2.0; 5G System; Time Sensitive Communication and Time Synchronization Function + 3GPP TS 29.565 V18.3.0; 5G System; Time Sensitive Communication and Time Synchronization Function Services; Stage 3. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.565/' servers: @@ -713,10 +713,13 @@ components: items: $ref: '#/components/schemas/StateOfDstt' minItems: 1 - clkQltAcptCriRes: - $ref: 'TS29522_TimeSyncExposure.yaml#/components/schemas/ClkQltDetLvl' - timeSyncServStatus: - $ref: 'TS29522_TimeSyncExposure.yaml#/components/schemas/ClkQltAcptCri' + clkQltAcptCriReports: + type: array + items: + $ref: 'TS29522_TimeSyncExposure.yaml#/components/schemas/ClockQualityAcceptanceCriteriaResult' + minItems: 1 + description: > + Indicates if the clock quality acceptance criteria is met or not for the indicated UE(s). StateOfDstt: description: Contains the PTP port state of a DS-TT. @@ -771,10 +774,8 @@ components: items: $ref: 'TS29534_Npcf_AMPolicyAuthorization.yaml#/components/schemas/ServiceAreaCoverageInfo' minItems: 1 - clkQltDetLvl: - $ref: 'TS29522_TimeSyncExposure.yaml#/components/schemas/ClkQltDetLvl' - clkQltAcptCri: - $ref: 'TS29522_TimeSyncExposure.yaml#/components/schemas/ClkQltAcptCri' + timeSyncStatusParam: + $ref: 'TS29522_TimeSyncExposure.yaml#/components/schemas/TimeSyncStatusParam' required: - upNodeId - reqPtpIns diff --git a/TS29571_CommonData.yaml b/TS29571_CommonData.yaml index db0f5194..a8cc39ba 100644 --- a/TS29571_CommonData.yaml +++ b/TS29571_CommonData.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: '1.5.0-alpha.3' + version: '1.5.0-alpha.4' title: 'Common Data Types' @@ -11,7 +11,7 @@ info: All rights reserved.   externalDocs: - description: 3GPP TS 29.571 Common Data Types for Service Based Interfaces, version 18.2.0 + description: 3GPP TS 29.571 Common Data Types for Service Based Interfaces, version 18.3.0 url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.571/' paths: {} @@ -921,11 +921,11 @@ components: Dnn: type: string description: > - String representing a Data Network as defined in clause 9A of 3GPP TS 23.003; - it shall contain either a DNN Network Identifier, or a full DNN with both the Network - Identifier and Operator Identifier, as specified in 3GPP TS 23.003 clause 9.1.1 and 9.1.2. - It shall be coded as string in which the labels are separated by dots - (e.g. "Label1.Label2.Label3"). + String representing a Data Network as defined in clause 9A of 3GPP TS 23.003; + it shall contain either a DNN Network Identifier, or a full DNN with both the Network + Identifier and Operator Identifier, as specified in 3GPP TS 23.003 clause 9.1.1 and 9.1.2. + It shall be coded as string in which the labels are separated by dots + (e.g. "Label1.Label2.Label3"). DnnRm: type: string nullable: true @@ -1017,7 +1017,8 @@ components: pattern: '^(imei-[0-9]{15}|imeisv-[0-9]{16}|mac((-[0-9a-fA-F]{2}){6})(-untrusted)?|eui((-[0-9a-fA-F]{2}){8})|.+)$' nullable: true description: > - This data type is defined in the same way as the 'Pei' data type but with the OpenAPI 'nullable: true' property. + This data type is defined in the same way as the 'Pei' data type but with + the OpenAPI 'nullable: true' property. Supi: type: string @@ -1111,6 +1112,41 @@ components: pattern: '^(imsi-[0-9]{5,15}|nai-.+|gli-.+|gci-.+|suci-(0-[0-9]{3}-[0-9]{2,3}|[1-7]-.+)-[0-9]{1,4}-(0-0-.*|[a-fA-F1-9]-([1-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])-[a-fA-F0-9]+)|.+)$' description: String identifying a SUPI or a SUCI. + Imsi: + description: String identifying an IMSI + type: string + pattern: '^[0-9]{5,15}$' + + ApplicationlayerId: + type: string + description: > + String identifying an UE with application layer ID. The format of the application + layer ID parameter is same as the Application layer ID defined in clause 11.3.4 of + 3GPP TS 24.554. + + +# +# ENUMERATED DATA TYPES +# + + GroupServiceId: + anyOf: + - type: integer + enum: + - 1 + - 2 + - 3 + - type: integer + description: > + This integer provides forward-compatibility with future + extensions to the enumeration but is not used to encode + content defined in the present version of this API. + description: | + Possible values are: + - 1: Group specific NAS level congestion control + - 2: Group specific Monitoring of Number of UEs present in a geographical area + - 3: Group specific Group specific for 5G LAN Type service + # # STRUCTURED DATA TYPES # @@ -1978,6 +2014,16 @@ components: - type: string description: Indicates the S-NSSAI availability. + TerminationIndication: + description: Indicates the termination of Network Slice Replacement. + anyOf: + - type: string + enum: + - NEW_UES_TERMINATION + - ALL_UES_TERMINATION + - type: string + + # # STRUCTURED DATA TYPES # @@ -3388,6 +3434,9 @@ components: type: integer minimum: 0 maximum: 100 + uesWithPduSessionInd: + type: boolean + default: false SACEventStatus: description: > @@ -3583,8 +3632,8 @@ components: items: $ref: '#/components/schemas/FqdnPatternMatchingRule' minItems: 1 - sessionAmbr: - $ref: '#/components/schemas/Ambr' + sessionDIAmbr: + $ref: '#/components/schemas/BitRate' PartiallyAllowedSnssai: description: > @@ -3629,6 +3678,40 @@ components: $ref: '#/components/schemas/UeAuth' rgSlPosLocAuth: $ref: '#/components/schemas/UeAuth' + rgSlPosClientAuth: + $ref: '#/components/schemas/UeAuth' + rgSlPosServerAuth: + $ref: '#/components/schemas/UeAuth' + + + NrA2xAuth: + description: Contains NR A2X services authorized information. + type: object + properties: + uavUeAuth: + $ref: '#/components/schemas/UeAuth' + + LteA2xAuth: + description: Contains LTE A2X services authorized information. + type: object + properties: + uavUeAuth: + $ref: '#/components/schemas/UeAuth' + + SliceUsageControlInfo: + type: object + required: + - sNssai + properties: + sNssai: + $ref: '#/components/schemas/Snssai' + deregInactTimer: + $ref: '#/components/schemas/DurationSec' + sessInactTimer: + $ref: '#/components/schemas/DurationSec' + anyOf: + - required: [ deregInactTimer ] + - required: [ sessInactTimer ] # @@ -3645,7 +3728,7 @@ components: any value (if the wildcardSd attribute is present). SnssaiReplaceInfo: - description: Indicates the status of an S-NSSAI and optionally an alternative S-NSSAI. + description: Indicates the status of an S-NSSAI and an alternative S-NSSAI optionally. type: object properties: snssai: @@ -3654,9 +3737,13 @@ components: $ref: '#/components/schemas/SnssaiStatus' altSnssai: $ref: '#/components/schemas/Snssai' + nsReplTerminInd: + $ref: '#/components/schemas/TerminationIndication' + plmnId: + $ref: '#/components/schemas/PlmnId' required: - snssai - - status + # # Data Types related to 5G QoS as defined in clause 5.5 @@ -4107,6 +4194,22 @@ components: description: > This data type is defined in the same way as the ' PartitioningCriteria ' data type, but with the OpenAPI 'nullable: true' property. + + PduSetHandlingInfo: + anyOf: + - type: string + enum: + - ALL_PDUS_NEEDED + - ALL_PDUS_NOT_NEEDED + - 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. + description: | + Possible values are: + - "ALL_PDUS_NEEDED": All PDUs of the PDU Set are needed + - "ALL_PDUS_NOT_NEEDED": All PDUs of the PDU Set are not needed # # # STRUCTURED DATA TYPES @@ -4235,9 +4338,8 @@ components: pduSetErrRate: $ref: '#/components/schemas/PduSetErrRate' pduSetHandlingInfo: - type: string -# The data type of "pduSetHandlingInfo" attribute is FFS - + $ref: '#/components/schemas/PduSetHandlingInfo' +# PduSetQosParaRm: description: "PduSetQosPara with nullable: true" @@ -4252,6 +4354,7 @@ components: # # SIMPLE DATA TYPES # + PhysCellId: type: integer minimum: 0 @@ -4259,6 +4362,7 @@ components: description: > Integer value identifying the physical cell identity (PCI), as definition of "PhysCellId" IE in clause 6.3.2 of 3GPP TS 38.331. + ArfcnValueNR: type: integer minimum: 0 @@ -4267,10 +4371,28 @@ components: Integer value indicating the ARFCN applicable for a downlink, uplink or bi-directional (TDD) NR global frequency raster, as definition of "ARFCN-ValueNR" IE in clause 6.3.2 of 3GPP TS 38.331. + + QoeReference: + description: > + String containing MCC (3 digits), MNC (2 or 3 digits) + and QMC ID (3 octets, encoded as 6 hexadecimal digits). + type: string + pattern: '^[0-9]{3}-[0-9]{2,3}-[A-Fa-f0-9]{6}$' + + MdtAlignmentInfo: + description: | + String containing: + - Trace Reference: MCC (3 digits), MNC (2 or 3 digits), + Trace ID (3 octets, encoded as 6 hexadecimal digits) + - Trace Recording Session Reference (2 octets, encoded as 4 hexadecimal digits) + format: string + pattern: '^[0-9]{3}-[0-9]{2,3}-[A-Fa-f0-9]{6}-[A-Fa-f0-9]{4}$' + # # # Enumerations # + TraceDepth: anyOf: - type: string @@ -4283,9 +4405,10 @@ components: - MAXIMUM_WO_VENDOR_EXTENSION - type: string description: > - The enumeration TraceDepth defines how detailed information should be recorded in the trace. - See 3GPP TS 32.422 for further description of the values. It shall comply with the - provisions defined in table 5.6.3.1-1 + The enumeration TraceDepth defines how detailed information should be recorded + in the trace. See 3GPP TS 32.422 for further description of the values. + It shall comply with the provisions defined in table 5.6.3.1-1 + TraceDepthRm: anyOf: - $ref: '#/components/schemas/TraceDepth' @@ -4365,8 +4488,8 @@ components: - type: string description: > The enumeration MeasurementNrForMdt defines Measurements used for MDT in NR in the trace. - See 3GPP TS 32.422 for further description of the values. It shall comply with the provisions - defined in table 5.6.3.6-1. + See 3GPP TS 32.422 for further description of the values. It shall comply with the + provisions defined in table 5.6.3.6-1. SensorMeasurement: anyOf: @@ -4377,9 +4500,9 @@ components: - UE_ORIENTATION - type: string description: > - The enumeration SensorMeasurement defines sensor measurement type for MDT in the trace. See 3GPP - TS 32.422 for further description of the values. It shall comply with the provisions defined - in table 5.6.3.7-1. + The enumeration SensorMeasurement defines sensor measurement type for MDT in the trace. + See 3GPP TS 32.422 for further description of the values. It shall comply with the + provisions defined in table 5.6.3.7-1. ReportingTrigger: anyOf: @@ -4508,8 +4631,8 @@ components: - type: string description: > The enumeration CollectionPeriodRmmLteMdt defines Collection period for RRM measurements - LTE for MDT in the trace. See 3GPP TS 32.422 for further description of the values. It shall - comply with the provisions defined in table 5.6.3.15-1. + LTE for MDT in the trace. See 3GPP TS 32.422 for further description of the values. + It shall comply with the provisions defined in table 5.6.3.15-1. MeasurementPeriodLteMdt: anyOf: @@ -4524,9 +4647,9 @@ components: - 60000 - type: string description: > - The enumeration MeasurementPeriodLteMdt defines Measurement period LTE for MDT in the trace. - See 3GPP TS 32.422 for further description of the values. It shall comply with the - provisions defined in table 5.6.3.16-1. + The enumeration MeasurementPeriodLteMdt defines Measurement period LTE for MDT in the + trace. See 3GPP TS 32.422 for further description of the values. It shall comply + with the provisions defined in table 5.6.3.16-1. ReportIntervalNrMdt: anyOf: @@ -4585,8 +4708,8 @@ components: - 60000 - type: string description: > - The enumeration CollectionPeriodRmmNrMdt defines Collection period for RRM measurements NR for MDT in the trace. - See 3GPP TS 32.422 for further description of the values. It shall comply with the provisions defined in table 5.6.3.19-1 + The enumeration CollectionPeriodRmmNrMdt defines Collection period for RRM measurements NR + for MDT in the trace. See 3GPP TS 32.422 for further description of the values. It shall comply with the provisions defined in table 5.6.3.19-1 LoggingDurationNrMdt: anyOf: @@ -4603,9 +4726,42 @@ components: The enumeration LoggingDurationMdt defines Logging Duration in NR for MDT in the trace. See 3GPP TS 32.422 for further description of the values. It shall comply with the provisions defined in table 5.6.3.20-1. + + QoeServiceType: + description: > + The enumeration QoeServiceType indicates the kind of service that shall be recorded for + QMC. It shall comply with the provisions defined in TS 29.571, table 5.6.3.21-1. + anyOf: + - type: string + enum: + - DASH + - MTSI + - VR + - 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. + + AvailableRanVisibleQoeMetric: + description: > + The enumeration AvailableRanVisibleQoeMetric indicates different available + RAN-visible QoE metrics to the gNB. It shall comply with the provisions defined + in TS 29.571, table 5.6.3.22-1. + anyOf: + - type: string + enum: + - APPLICATION_LAYER_BUFFER_LEVEL_LIST + - PLAYOUT_DELAY_FOR_MEDIA_STARTUP + - 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. + + # # STRUCTURED DATA TYPES # + TraceData: description: contains Trace control and configuration parameters. type: object @@ -4616,12 +4772,12 @@ components: pattern: '^[0-9]{3}[0-9]{2,3}-[A-Fa-f0-9]{6}$' description: > Trace Reference (see 3GPP TS 32.422).It shall be encoded as the concatenation of MCC, - MNC and Trace ID as follows: 'MCC' + It contains the configuration information for signaling-based activation of the + Quality of Experience (QoE) Measurements Collection (QMC) functionality. + type: object + required: + - qoeReference + properties: + qoeReference: + $ref: '#/components/schemas/QoeReference' + serviceType: + $ref: '#/components/schemas/QoeServiceType' + sliceScope: + type: array + items: + $ref: '#/components/schemas/Snssai' + minItems: 1 + areaScope: + $ref: '#/components/schemas/QmcAreaScope' + qoeCollectionEntityAddress: + $ref: '#/components/schemas/IpAddr' + qoeTarget: + $ref: '#/components/schemas/QoeTarget' + mdtAlignmentInfo: + $ref: '#/components/schemas/MdtAlignmentInfo' + availableRanVisibleQoeMetrics: + type: array + items: + $ref: '#/components/schemas/AvailableRanVisibleQoeMetric' + minItems: 1 + containerForAppLayerMeasConfig: + $ref: '#/components/schemas/Bytes' + + QmcAreaScope: + description: > + This IE contains the area in Cells or Tracking Areas where the QMC data collection + shall take place. + type: object + properties: + nrCellIdList: + type: array + items: + $ref: '#/components/schemas/NrCellId' + minItems: 1 + tacList: + type: array + items: + $ref: '#/components/schemas/Tac' + minItems: 1 + taiList: + type: array + items: + $ref: '#/components/schemas/Tai' + minItems: 1 + plmnList: + type: array + items: + $ref: '#/components/schemas/PlmnId' + minItems: 1 + + QoeTarget: + description: > + This parameter specifies the target object (individual UE) for the QMC in case of + signalling based QMC. It shall be able to carry an IMSI or a SUPI. + type: object + properties: + supi: + $ref: '#/components/schemas/Supi' + imsi: + $ref: '#/components/schemas/Imsi' + + + # Data Types related to 5G ODB as defined in clause 5.7 # @@ -5485,6 +5714,217 @@ components: - $ref: '#/components/schemas/Ssm' - type: string + + +# Data Types related to Time Synchronization as defined in clause 5.10 +# + +# +# SIMPLE DATA TYPES +# +# + + +# +# Enumerations +# +# + + SynchronizationState: + description: Indicates the Synchronization State. + anyOf: + - type: string + enum: + - LOCKED + - HOLDOVER + - FREERUN + - 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. + + TimeSource: + description: Indicates the Time Source. + anyOf: + - type: string + enum: + - PTP + - GNSS + - ATOMIC_CLOCK + - TERRESTRIAL_RADIO + - SERIAL_TIME_CODE + - NTP + - HAND_SET + - OTHER + - 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. + + ClockQualityDetailLevel: + description: Indicates the Clock Quality Detail Level. + anyOf: + - type: string + enum: + - CLOCK_QUALITY_METRICS + - ACCEPT_INDICATION + - 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. + +# +# STRUCTURED DATA TYPES +# + + ClockQualityAcceptanceCriterion: + description: Contains a Clock Quality Acceptance Criterion. + type: object + properties: + synchronizationState: + $ref: '#/components/schemas/SynchronizationState' + clockQuality: + $ref: '#/components/schemas/ClockQuality' + parentTimeSource: + $ref: '#/components/schemas/TimeSource' + + ClockQuality: + description: Contains Clock Quality. + type: object + properties: + traceabilityToGnss: + type: boolean + traceabilityToUtc: + type: boolean + frequencyStability: + $ref: '#/components/schemas/Uint16' + clockAccuracy: + type: string + pattern: '^[A-Fa-f0-9]{2}$' + + + +# Data Types related to IMS SBA as defined in clause 5.11 +# + +# +# SIMPLE DATA TYPES +# +# + + SessionId: + description: IMS Session Identifier + type: string + + MediaId: + description: IMS Media Flow Identifier + type: string + + MaxMessageSize: + description: Maximum SCTP user message size + type: integer + maximum: 64 + default: 64 + + +# +# Enumerations +# +# + MediaResourceType: + description: Indicates the Media Resource type + anyOf: + - type: string + enum: + - DC + - AR + - AUDIO + - VIDEO + - type: string + + MediaProxy: + description: Media Proxy Configuration applicable to the media flow + anyOf: + - type: string + enum: + - HTTP + - UDP + - type: string + + SecuritySetup: + description: security setup of the DTLS connection + anyOf: + - type: string + enum: + - ACTIVE + - PASSIVE + - ACTPASS + - type: string + +# STRUCTURED DATA TYPES +# + DcEndpoint: + description: Endpoint for Data Channel + type: object + properties: + sctpPort: + type: integer + maximum: 65535 + minimum: 0 + description: Local or remote port for Data Channel + fingerprint: + type: string + pattern: '^(SHA-1|SHA-224|SHA-256|SHA-384|SHA-512|MD5|MD2|TOKEN)\s[0-9A-F]{2}(:[0-9A-F]{2})+' + description: local or remote certificate fingerprint for the DTLS association + tlsId: + type: string + pattern: '^[A-Fa-f0-9+/_-]{20,255}$' + description: local or remote TLS ID for the media stream + + DcStream: + description: Data Channel mapping and configuration information + type: object + properties: + streamId: + type: integer + maximum: 65535 + default: 0 + description: Stream identifier for Data Channel + subprotocol: + type: string + pattern: '^[A-Fa-f0-9]{20}$' + description: Subprotocol of the SCTP stream + order: + type: boolean + maxRetry: + type: integer + default: 0 + description: maximal number of the times a message will be retransmitted + maxTime: + type: integer + default: 0 + description: maximal lifetime in milliseconds after which a message will no longer be transmitted or retransmitted + priority: + type: integer + default: 256 + description: priority of data channel relative to other data channels + + + ReplaceHttpUrl: + description: replacement HTTP URL per stream + type: object + properties: + replaceHttpUrl: + $ref: '#/components/schemas/Uri' + streamId: + type: integer + maximum: 65535 + default: 0 + description: Stream identifier for Data Channel + # # HTTP responses # diff --git a/TS29572_Nlmf_Location.yaml b/TS29572_Nlmf_Location.yaml index ddfbe7bb..4884bd9d 100644 --- a/TS29572_Nlmf_Location.yaml +++ b/TS29572_Nlmf_Location.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: '1.3.0-alpha.3' + version: '1.3.0-alpha.4' title: 'LMF Location' description: | LMF Location Service. @@ -9,7 +9,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.572 V18.2.0; 5G System; Location Management Services; Stage 3 + description: 3GPP TS 29.572 V18.3.0; 5G System; Location Management Services; Stage 3 url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.572/' servers: @@ -156,6 +156,102 @@ paths: $ref: 'TS29571_CommonData.yaml#/components/responses/504' default: $ref: 'TS29571_CommonData.yaml#/components/responses/default' + /up-subscription: + post: + summary: subscribe about status of a secure LCS-UP connection for a target UE + operationId: UpSubscription + tags: + - UP Subscribe + security: + - {} + - oAuth2ClientCredentials: + - nlmf_loc + - oAuth2ClientCredentials: + - nlmf_loc + - nlmf_loc:up-subscription:invoke + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/UpSubscription' + required: true + responses: + '204': + description: Expected response to successful UP Subscription + '307': + $ref: 'TS29571_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29571_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29571_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29571_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29571_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + '504': + $ref: 'TS29571_CommonData.yaml#/components/responses/504' + default: + $ref: 'TS29571_CommonData.yaml#/components/responses/default' + callbacks: + UPNotify: + '{$request.body#/upNotifyCallBackURI}': + post: + requestBody: + description: UP Connection Status Notification + content: + application/json: + schema: + $ref: '#/components/schemas/UpNotifyData' + responses: + '204': + description: Expected response to a valid notification + '307': + $ref: 'TS29571_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29571_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29571_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29571_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29571_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + '504': + $ref: 'TS29571_CommonData.yaml#/components/responses/504' + default: + $ref: 'TS29571_CommonData.yaml#/components/responses/default' + /cancel-location: post: summary: request cancellation of periodic or triggered location @@ -260,6 +356,62 @@ paths: $ref: 'TS29571_CommonData.yaml#/components/responses/504' default: $ref: 'TS29571_CommonData.yaml#/components/responses/default' + /location-measure: + post: + summary: PRU location measurement + operationId: LocationMeasure + tags: + - Location Measure + security: + - {} + - oAuth2ClientCredentials: + - nlmf_loc + - oAuth2ClientCredentials: + - nlmf_loc + - nlmf_loc:location-measure:invoke + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/LocMeasurementReq' + required: true + responses: + '200': + description: Expected response to a valid request + content: + application/json: + schema: + $ref: '#/components/schemas/LocMeasurementResp' + '307': + $ref: 'TS29571_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29571_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29571_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29571_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29571_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + '504': + $ref: 'TS29571_CommonData.yaml#/components/responses/504' + default: + $ref: 'TS29571_CommonData.yaml#/components/responses/default' components: securitySchemes: @@ -273,6 +425,9 @@ components: nlmf_loc:determine-location:invoke: Access to invoke Determine Location nlmf-loc:cancel-location:invoke: Access to invoke Cancel Location nlmf-loc:location-context-transfer:invoke: Access to invoke Location Context + nlmf_loc:location-measure:invoke: Access to invoke Location Measurement + nlmf-loc:up-subscription:invoke: Access to invoke UP Subscription + schemas: # # COMPLEX TYPES @@ -302,6 +457,16 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Pei' gpsi: $ref: 'TS29571_CommonData.yaml#/components/schemas/Gpsi' + requestedRangingSlResult: + type: array + items: + $ref: '#/components/schemas/RangingSlResult' + minItems: 1 + relatedUEs: + type: array + items: + $ref: '#/components/schemas/RelatedUE' + minItems: 1 ecgi: $ref: 'TS29571_CommonData.yaml#/components/schemas/Ecgi' ecgiOnSecondNode: @@ -390,9 +555,13 @@ components: userPlanePositioningCapability: $ref: '#/components/schemas/UeUpPositioningCapabilities' reportingInd: - $ref: 'TS29515_Ngmlc_Location.yaml#/components/schemas/ReportingInd' + allOf: + - $ref: 'TS29515_Ngmlc_Location.yaml#/components/schemas/ReportingInd' + default: POSITIVE_SENSE mbsrInfo: $ref: '#/components/schemas/MbsrInfo' + integrityRequirements: + $ref: 'TS29515_Ngmlc_Location.yaml#/components/schemas/IntegrityRequirements' LocationData: description: Information within Determine Location Response. @@ -449,6 +618,10 @@ components: $ref: '#/components/schemas/IndoorOutdoorInd' acceptedPeriodicEventInfo: $ref: '#/components/schemas/PeriodicEventInfo' + haGnssMetrics: + $ref: '#/components/schemas/HighAccuracyGnssMetrics' + losNlosMeasureInd: + $ref: '#/components/schemas/LosNlosMeasureInd' GeographicArea: description: Geographic area specified by different shape. @@ -1113,6 +1286,8 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' indoorOutdoorInd: $ref: '#/components/schemas/IndoorOutdoorInd' + losNlosMeasureInd: + $ref: '#/components/schemas/LosNlosMeasureInd' EventReportMessage: description: Indicates an event report message. @@ -1205,6 +1380,10 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' indoorOutdoorInd: $ref: '#/components/schemas/IndoorOutdoorInd' + haGnssMetrics: + $ref: '#/components/schemas/HighAccuracyGnssMetrics' + losNlosMeasureInd: + $ref: '#/components/schemas/LosNlosMeasureInd' UeConnectivityState: description: Indicates the connectivity state of a UE. @@ -1235,6 +1414,110 @@ components: ecgi: $ref: 'TS29571_CommonData.yaml#/components/schemas/Ecgi' + + LocMeasurementReq: + description: Location Measurement Request. + type: object + properties: + ncgi: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Ncgi' + ecgi: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Ecgi' + preCalcuLocEstimate: + $ref: '#/components/schemas/GeographicArea' + timestampOfPreCalcuLocEstimate: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' + + LocMeasurementResp: + description: Location Measurement Response. + type: object + required: + - locMeasurements + - locationEstimate + properties: + locMeasurements: + $ref: '#/components/schemas/LocMeasurements' + locationEstimate: + $ref: '#/components/schemas/GeographicArea' + ageOfLocationEstimate: + $ref: '#/components/schemas/AgeOfLocationEstimate' + timestampOfLocationEstimate: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' + velocityEstimate: + $ref: '#/components/schemas/VelocityEstimate' + localLocationEstimate: + $ref: '#/components/schemas/LocalArea' + + LocMeasurements: + description: Location Measurements. + type: object + properties: + rtsd: + type: integer + + HighAccuracyGnssMetrics: + description: High Accuracy GNSS Positioning Metrics. + type: object + properties: + nrOfUsedSatellites: + type: integer + minimum: 0 + maximum: 64 + hdopi: + type: integer + minimum: 1 + maximum: 256 + pdopi: + type: integer + minimum: 1 + maximum: 256 + age: + type: integer + minimum: 0 + maximum: 99 + fixType: + $ref: '#/components/schemas/FixType' + + UpNotifyData: + description: UP Subscription + type: object + required: + - ldrReference + - upConnectionStatus + properties: + ldrReference: + $ref: '#/components/schemas/LdrReference' + upConnectionStatus: + $ref: '#/components/schemas/UpConnectionStatus' + targetLMFIdentification: + $ref: '#/components/schemas/LMFIdentification' + + UpSubscription: + description: UP Subscription + type: object + required: + - upNotifyCallBackURI + - supi + properties: + upNotifyCallBackURI: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' + supi: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Supi' + gpsi: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Gpsi' + + RelatedUE: + description: Related UE Information + type: object + required: + - applicationlayerId + - relatedUEType + properties: + applicationlayerId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/ApplicationlayerId' + relatedUEType: + $ref: '#/components/schemas/RelatedUEType' + # # # SIMPLE TYPES @@ -1446,6 +1729,9 @@ components: - ELLIPSOID_ARC - LOCAL_2D_POINT_UNCERTAINTY_ELLIPSE - LOCAL_3D_POINT_UNCERTAINTY_ELLIPSOID + - RANGE_DIRECTION + - RELATIVE_2D_LOCATION_UNCERTAINTY_ELLIPSE + - RELATIVE_3D_LOCATION_UNCERTAINTY_ELLIPSOID - type: string ResponseTime: @@ -1659,3 +1945,54 @@ components: - INDOOR - OUTDOOR - type: string + + FixType: + description: Specifies the positioning fix type. + anyOf: + - type: string + enum: + - CARRIER_PHASE_FLOAT + - CARRIER_PHASE_FIX + - type: string + + LosNlosMeasureInd: + description: Specifies LOS measurement or NLOS measurement. + anyOf: + - type: string + enum: + - LOS + - NLOS + - type: string + + UpConnectionStatus: + description: UP Connection Status. + anyOf: + - type: string + enum: + - ESTABLISHED + - RELEASED + - MODIFICATION + - type: string + + RangingSlResult: + description: Specifies the type of result requested for ranging and sidelink positioning. + anyOf: + - type: string + enum: + - ABSOLUTE_LOCATION + - RELATIVE_LOCATION + - RANGING_DIRECTION + - RANGING + - DIRECTION + - VELOCITY + - RELATIVE_VELOCITY + - type: string + + RelatedUEType: + description: Specifies the different roles of UE for ranging and sidelink positioning service. + anyOf: + - type: string + enum: + - LOCATED_UE + - REFERENCE_UE + - type: string diff --git a/TS29574_Ndccf_DataManagement.yaml b/TS29574_Ndccf_DataManagement.yaml index 827e7b3e..f38813da 100644 --- a/TS29574_Ndccf_DataManagement.yaml +++ b/TS29574_Ndccf_DataManagement.yaml @@ -1,7 +1,7 @@ openapi: 3.0.0 info: - version: 1.1.0-alpha.3 + version: 1.1.0-alpha.4 title: Ndccf_DataManagement description: | DCCF Data Management Service. @@ -9,7 +9,7 @@ info: All rights reserved. externalDocs: - description: 3GPP TS 29.574 V18.2.0; 5G System; Data Collection Coordination Services; Stage 3. + description: 3GPP TS 29.574 V18.3.0; 5G System; Data Collection Coordination Services; Stage 3. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.574/' # servers: @@ -835,6 +835,8 @@ components: - required: [sacEvent] - required: [nrfEvent] - required: [udmEvent] + - required: [gmlcEvent] + - required: [upfEvent] properties: nwdafEvent: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/NwdafEvent' @@ -852,6 +854,10 @@ components: $ref: 'TS29536_Nnsacf_SliceEventExposure.yaml#/components/schemas/SACEvent' nrfEvent: $ref: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/NotificationEventType' + gmlcEvent: + $ref: 'TS29515_Ngmlc_Location.yaml#/components/schemas/EventNotifyDataType' + upfEvent: + $ref: 'TS29564_Nupf_EventExposure.yaml#/components/schemas/EventType' # ParameterProcessingInstruction: description: > diff --git a/TS29575_Nadrf_DataManagement.yaml b/TS29575_Nadrf_DataManagement.yaml index b4ac4082..86b20301 100644 --- a/TS29575_Nadrf_DataManagement.yaml +++ b/TS29575_Nadrf_DataManagement.yaml @@ -1,13 +1,13 @@ openapi: 3.0.0 info: - version: 1.1.0-alpha.3 + version: 1.1.0-alpha.4 title: Nadrf_DataManagement description: | ADRF Data Management Service. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.575 V18.2.0; 5G System; Analytics Data Repository Services; Stage 3. + description: 3GPP TS 29.575 V18.3.0; 5G System; Analytics Data Repository Services; Stage 3. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.575/' # servers: @@ -617,6 +617,9 @@ components: $ref: '#/components/schemas/StorageHandlingInfo' dataSetTag: $ref: '#/components/schemas/DataSetTag' + dsc: + type: string + description: Data synthesis and compression information. suppFeat: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' # @@ -723,6 +726,9 @@ components: description: > It indicates the termination of the data management subscription that requested by the ADRF. + dsc: + type: string + description: Data synthesis and compression information. timeStamp: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' # @@ -771,6 +777,8 @@ components: - required: [afDataSub] - required: [nrfDataSub] - required: [nsacfDataSub] + - required: [upfDataSub] + - required: [gmlcDataSub] properties: amfDataSub: $ref: 'TS29518_Namf_EventExposure.yaml#/components/schemas/AmfEventSubscription' @@ -786,6 +794,10 @@ components: $ref: 'TS29510_Nnrf_NFManagement.yaml#/components/schemas/SubscriptionData' nsacfDataSub: $ref: 'TS29536_Nnsacf_SliceEventExposure.yaml#/components/schemas/SACEventSubscription' + upfDataSub: + $ref: 'TS29564_Nupf_EventExposure.yaml#/components/schemas/UpfEventSubscription' + gmlcDataSub: + $ref: 'TS29515_Ngmlc_Location.yaml#/components/schemas/InputData' # DataNotification: description: Represents a Data Subscription Notification. @@ -799,6 +811,7 @@ components: - required: [nrfEventNotifs] - required: [nsacfEventNotifs] - required: [upfEventNotifs] + - required: [gmlcEventNotifs] properties: amfEventNotifs: type: array @@ -848,6 +861,12 @@ components: $ref: 'TS29564_Nupf_EventExposure.yaml#/components/schemas/NotificationData' minItems: 1 description: List of notifications of UPF events. + gmlcEventNotifs: + type: array + items: + $ref: 'TS29515_Ngmlc_Location.yaml#/components/schemas/EventNotifyData' + minItems: 1 + description: List of notifications of GMLC events. timeStamp: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' diff --git a/TS29575_Nadrf_MLModelManagement.yaml b/TS29575_Nadrf_MLModelManagement.yaml new file mode 100644 index 00000000..e55e1170 --- /dev/null +++ b/TS29575_Nadrf_MLModelManagement.yaml @@ -0,0 +1,259 @@ +openapi: 3.0.0 +info: + version: 1.0.0-alpha.1 + title: Nadrf_MLModelManagement + description: | + ADRF ML Model Management Service. + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + All rights reserved. +externalDocs: + description: 3GPP TS 29.575 V18.3.0; 5G System; Analytics Data Repository Services; Stage 3. + url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.575/' +# +servers: + - url: '{apiRoot}/nadrf-mlmodelmanagement/v1' + variables: + apiRoot: + default: https://example.com + description: apiRoot as defined in clause 4.4 of 3GPP TS 29.501. +# +security: + - {} + - oAuth2ClientCredentials: + - nadrf-mlmodelmanagement +# +paths: + /mlmodel-store-records: + post: + summary: Creates a new Individual ADRF ML Model Store Record resource. + operationId: CreateADRFMLModelStoreRecord + tags: + - ADRF ML Model Store Records (Collection) + requestBody: + content: + application/json: + schema: + $ref: '#/components/schemas/NadrfMLModelStoreRecord' + required: true + description: ADRF ML model store record to be stored. + responses: + '201': + description: Successful creation of new Individual ADRF ML Model Store Record resource. + headers: + Location: + description: > + Contains the URI of the newly created resource, according to the structure + {apiRoot}/nadrf-mlmodelmanagement//mlmodel-store-records/{storeTransId} + required: true + schema: + type: string + content: + application/json: + schema: + $ref: '#/components/schemas/NadrfMLModelStoreRecord' + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29571_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29571_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29571_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29571_CommonData.yaml#/components/responses/default' + get: + summary: Retrieves existing Individual ADRF ML Model Store Record. + operationId: GetAdrfMLModelStoreRecord + tags: + - ADRF ML Model Store Records (Collection) + parameters: + - name: store-trans-id + description: A storage transaction identifier of a ML model store record in ADRF. + in: query + required: false + schema: + type: string + - name: modelUniqueId + description: Unique Model identifier of a ML model. + in: query + required: false + schema: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + minItems: 1 + responses: + '200': + description: ML model store records are returned. + content: + application/json: + schema: + $ref: '#/components/schemas/NadrfMLModelStoreRecord' + '204': + description: No matching ADRF ML Model were found. + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '406': + $ref: 'TS29571_CommonData.yaml#/components/responses/406' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29571_CommonData.yaml#/components/responses/default' + /mlmodel-store-records/{storeTransId}: + delete: + summary: Delete an existing Individual ADRF ML Model Store Record. + operationId: DeleteADRFMLModelStoreRecord + tags: + - Individual ADRF ML Model Store Record (Document) + parameters: + - name: storeTransId + in: path + description: String identifying a ML Model Store Record in ADRF. + required: true + schema: + type: string + responses: + '204': + description: > + No Content. The Individual ADRF ML Model Store Record resource matching the + storeTransId was deleted. + '307': + $ref: 'TS29571_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29571_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29571_CommonData.yaml#/components/responses/default' + /remove-stored-mlmodel: + post: + summary: Remove stored ML model based on unique ML model identifier. + operationId: DeleteADRFMLModel + tags: + - ADRF Stored ML Model + requestBody: + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/NadrfMLModelStoreRecord' + minItems: 1 + required: true + responses: + '204': + description: No Content. The ADRF ML model matching the provided unique ML model identifier is deleted. + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29571_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29571_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29571_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29571_CommonData.yaml#/components/responses/default' +# +components: + securitySchemes: + oAuth2ClientCredentials: + type: oauth2 + flows: + clientCredentials: + tokenUrl: '{nrfApiRoot}/oauth2/token' + scopes: + nadrf-mlmodelmanagement: Access to the nadrf-mlmodelmanagement API +# + schemas: +# + NadrfMLModelStoreRecord: + description: Represents an Individual ADRF ML Model Store Record. + type: object + allOf: + - oneOf: + - required: [nfInstanceId] + - required: [nfSetId] + - required: [mlModelIdnfo] + properties: + nfInstanceId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/NfInstanceId' + nfSetId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/NfSetId' + mlModelInfo: + type: array + items: + $ref: '#/components/schemas/MLModelInfo' + minItems: 1 + description: List of ML Model Information. + suppFeat: + $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' +# + MLModelInfo: + description: Represents informatiom of the ML Model. + type: object + allOf: + - required: [modelUniqueId] + - required: [mlFileAddr] + - required: [mlStrorageSize] + properties: + modelUniqueId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' + mlModelAddr: + $ref: 'TS29520_Nnwdaf_MLModelProvision.yaml#/components/schemas/MLModelAddr' + mlStrorageSize: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger' +# diff --git a/TS29580_Nmbsf_MBSUserDataIngestSession.yaml b/TS29580_Nmbsf_MBSUserDataIngestSession.yaml index b155cd21..1c060e1a 100644 --- a/TS29580_Nmbsf_MBSUserDataIngestSession.yaml +++ b/TS29580_Nmbsf_MBSUserDataIngestSession.yaml @@ -2,7 +2,7 @@ openapi: 3.0.0 info: title: nmbsf-mbs-ud-ingest - version: 1.1.0-alpha.3 + version: 1.1.0-alpha.4 description: | API for MBS User Data Ingest Session Service. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). @@ -10,7 +10,7 @@ info: externalDocs: description: > - 3GPP TS 29.580 V18.2.0; 5G System; Multicast/Broadcast Service Function Services. + 3GPP TS 29.580 V18.3.0; 5G System; Multicast/Broadcast Service Function Services. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.580/' servers: @@ -688,8 +688,8 @@ components: nullable: true description: > Represents one or more MBS Distribution Session(s) composing the MBS User Data Ingest - Session. The key of the map shall be set to the value ofthe "mbsDistSessionId" attribute - of the MBSDistributionSessionInfo data structure encoding the corresponding map entry. + Session. + The key of the map shall be any unique string encoded value. actPeriods: type: array items: @@ -788,6 +788,7 @@ components: description: > Contains the requested modifications to one or more MBS Distribution Session(s) composing the MBS User Data Ingest Session. + The key of the map shall be any unique string encoded value. actPeriods: type: array items: @@ -808,7 +809,7 @@ components: type: array items: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' - minItems: 1 + minItems: 0 objIngUri: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uri' objDistrUri: @@ -1055,6 +1056,11 @@ components: - DATA_INGEST_FAILURE - DELIVERY_STARTED - SESSION_TERMINATED + - DIST_SESS_ACTIVATED + - DIST_SESS_DEACTIVATED + - DIST_SESS_EST_FAILURE + - DIST_SESS_ESTABLISHED + - USER_SER_AD - type: string description: > This string provides forward-compatibility with future extensions to the enumeration @@ -1095,3 +1101,16 @@ components: The MBS User Data delivery is started. - SESSION_TERMINATED: > The MBS User Data Ingest Session is terminated. + - DIST_SESS_ACTIVATED: + Indicates that the MBS Distribution Session is activated successfully. + - DIST_SESS_DEACTIVATED: + Indicates that the MBS Distribution Session is deactivated. + - DIST_SESS_EST_FAILURE: + Indicates that the MBSF failed to successfully establish the MBS Distribution Session at + the MBSTF. This is an "MBS Distribution Session" level event. + - DIST_SESS_ESTABLISHED: + Indicates that the MBS Distribution Session established. + This is an "MBS Distribution Session" level event. + - USER_SER_AD: + Indicates that the MBSF advertises the User Service Announcement information to the MBS + Application Provider. diff --git a/TS29583_Ppinserver_ASRegistration.yaml b/TS29583_Ppinserver_ASRegistration.yaml new file mode 100644 index 00000000..adb0ca38 --- /dev/null +++ b/TS29583_Ppinserver_ASRegistration.yaml @@ -0,0 +1,322 @@ +openapi: 3.0.0 +info: + title: PINServer PAS Registration_API + version: 1.0.0-alpha.1 + description: | + API for PAS registration to PIN server. + © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + All rights reserved. + +externalDocs: + description: > + 3GPP TS 29.583; Application layer support for Personal IoT Network (PINAPP); + Personal IoT Network (PIN) Server Services; Stage 3. + url: 'http://www.3gpp.org/ftp/Specs/archive/29_series/29.583/' + +security: + - {} + - oAuth2ClientCredentials: [] + +servers: + - url: '{apiRoot}/ppinserver-as-registration/v1' + variables: + apiRoot: + default: https://example.com + description: apiRoot as defined in clause 6.3 of 3GPP TS 29.583. + +paths: + /registrations: + post: + summary: Create a new PAS Registration + operationId: CreatePASRegistration + tags: + - PAS Registrations (Collection) + description: Register a new PAS at the PIN Server. + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/PASRegistration' + responses: + '201': + description: PAS information is registered successfully at PIN server. + content: + application/json: + schema: + $ref: '#/components/schemas/PASRegistration' + headers: + Location: + description: 'Contains the URI of the newly created resource' + required: true + schema: + type: string + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + + /registrations/{registrationId}: + get: + summary: Get an Individual PAS Registration + operationId: GetIndPASReg + tags: + - Individual PAS Registration (Document) + description: Retrieve an Individual PAS registration resource. + parameters: + - name: registrationId + in: path + description: Registration Id. + required: true + schema: + type: string + responses: + '200': + description: OK (The PAS registration information at the PIN Server). + content: + application/json: + schema: + $ref: '#/components/schemas/PASRegistration' + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '406': + $ref: 'TS29122_CommonData.yaml#/components/responses/406' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + put: + summary: Update an Individual PAS Registration + operationId: UpdateIndPASReg + tags: + - Individual PAS Registration (Document) + description: Fully replace an existing PAS Registration resource. + parameters: + - name: registrationId + in: path + description: PAS Registration Id. + required: true + schema: + type: string + requestBody: + required: true + content: + application/json: + schema: + $ref: '#/components/schemas/PASRegistration' + responses: + '200': + description: OK (The PAS registration information is updated successfully). + content: + application/json: + schema: + $ref: '#/components/schemas/PASRegistration' + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + patch: + summary: Modify an Individual PAS Registration + operationId: ModifyIndPASReg + tags: + - Individual PAS Registration (Document) + description: Partially update an existing PAS Registration resource. + parameters: + - name: registrationId + in: path + description: PAS registration Id. + required: true + schema: + type: string + requestBody: + description: Partial update an existing PAS registration resource. + required: true + content: + application/merge-patch+json: + schema: + $ref: '#/components/schemas/PASRegistrationPatch' + responses: + '200': + description: > + The Individual PAS registration is successfully modified and + the updated registration information is returned in the response. + content: + application/json: + schema: + $ref: '#/components/schemas/PASRegistration' + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29122_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29122_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29122_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + + delete: + summary: Delete an Individual PAS Registration + operationId: DeleteIndPASReg + tags: + - Individual PAS Registration (Document) + description: Delete an existing PAS registration at PIN server. + parameters: + - name: registrationId + in: path + description: Registration Id. + required: true + schema: + type: string + responses: + '204': + description: The individual PAS registration is deleted. + '307': + $ref: 'TS29122_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29122_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29122_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29122_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29122_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29122_CommonData.yaml#/components/responses/404' + '429': + $ref: 'TS29122_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29122_CommonData.yaml#/components/responses/500' + '503': + $ref: 'TS29122_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29122_CommonData.yaml#/components/responses/default' + +components: + securitySchemes: + oAuth2ClientCredentials: + type: oauth2 + flows: + clientCredentials: + tokenUrl: '{tokenUrl}' + scopes: {} + + schemas: + PASRegistration: + type: object + description: Represents an PAS registration information. + properties: + conInfo: + $ref: '#/components/schemas/ConnectivityInfo' + expTime: + $ref: 'TS29122_CommonData.yaml#/components/schemas/DateTime' + requestorId: + type: string + description: Indentify a PAS + passId: + type: string + description: Indentify a PIN service + required: + - requestorId + - conInfo + - passId + + ConnectivityInfo: + type: object + description: Represents a connection information of PAS. + properties: + fqdn: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Fqdn' + ipv4Addrs: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Ipv4Addr' + ipv6Addrs: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Ipv6Addr' + uri: + $ref: 'TS29122_CommonData.yaml#/components/schemas/Uri' + oneOf: + - required: [uri] + - required: [fqdn] + - required: [ipv4Addrs] + - required: [ipv6Addrs] + + PASRegistrationPatch: + type: object + description: Represents partial update request of individual PAS registration information. + properties: + conInfo: + $ref: '#/components/schemas/ConnectivityInfo' + expTime: + $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTimeRm' + passId: + type: string + description: Identify a PIN service provided by PAS. diff --git a/TS29591_Nnef_DNAIMapping.yaml b/TS29591_Nnef_DNAIMapping.yaml new file mode 100644 index 00000000..429895e8 --- /dev/null +++ b/TS29591_Nnef_DNAIMapping.yaml @@ -0,0 +1,207 @@ +openapi: 3.0.0 +info: + title: Nnef_DNAIMapping + version: 1.0.0-alpha.1 + description: | + NEF DNAI Mapping Service. + © 2023 , 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + All rights reserved. +externalDocs: + description: > + 3GPP TS 29.591 V18.3.0; 5G System; Network Exposure Function Southbound Services; Stage 3. + url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.591/ +servers: + - url: '{apiRoot}/nnef-dnai-mapping/v1' + variables: + apiRoot: + default: https://example.com + description: apiRoot as defined in clause 4.4 of 3GPP TS 29.501 +security: + - {} + - oAuth2ClientCredentials: + - nnef-dnai-mapping +paths: + + /subscriptions: + post: + summary: subscribe to notifications + operationId: CreateIndividualSubcription + tags: + - Subscriptions (Collection) + requestBody: + required: true + content: + application/json: + schema: + $ref: 'TS29522_DNAIMapping.yaml#/components/schemas/DnaiMapSub' + responses: + '201': + description: Success + content: + application/json: + schema: + $ref: 'TS29522_DNAIMapping.yaml#/components/schemas/DnaiMapSub' + headers: + Location: + description: > + Contains the URI of the newly created resource, according to the structure + {apiRoot}/nnef-dnai-mapping//subscriptions/{subscriptionId} + required: true + schema: + type: string + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29571_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29571_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29571_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29571_CommonData.yaml#/components/responses/default' + callbacks: + myNotification: + '{$request.body#/notifUri}': + post: + requestBody: + required: true + content: + application/json: + schema: + $ref: 'TS29522_DNAIMapping.yaml#/components/schemas/DnaiMapUpdateNotif' + responses: + '204': + description: No Content, Notification was succesfull + '307': + $ref: 'TS29571_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29571_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '411': + $ref: 'TS29571_CommonData.yaml#/components/responses/411' + '413': + $ref: 'TS29571_CommonData.yaml#/components/responses/413' + '415': + $ref: 'TS29571_CommonData.yaml#/components/responses/415' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29571_CommonData.yaml#/components/responses/default' + + /subscriptions/{subscriptionId}: + get: + summary: retrieve subscription + operationId: GetIndividualSubcription + tags: + - IndividualSubscription (Document) + parameters: + - name: subscriptionId + in: path + description: Subscription ID + required: true + schema: + type: string + responses: + '200': + description: OK. Resource representation is returned + content: + application/json: + schema: + $ref: 'TS29522_DNAIMapping.yaml#/components/schemas/DnaiMapSub' + '307': + $ref: 'TS29571_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29571_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '406': + $ref: 'TS29571_CommonData.yaml#/components/responses/406' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29571_CommonData.yaml#/components/responses/default' + delete: + summary: unsubscribe from notifications + operationId: DeleteIndividualSubcription + tags: + - IndividualSubscription (Document) + parameters: + - name: subscriptionId + in: path + description: Subscription ID + required: true + schema: + type: string + responses: + '204': + description: No Content. Resource was succesfully deleted + '307': + $ref: 'TS29571_CommonData.yaml#/components/responses/307' + '308': + $ref: 'TS29571_CommonData.yaml#/components/responses/308' + '400': + $ref: 'TS29571_CommonData.yaml#/components/responses/400' + '401': + $ref: 'TS29571_CommonData.yaml#/components/responses/401' + '403': + $ref: 'TS29571_CommonData.yaml#/components/responses/403' + '404': + $ref: 'TS29571_CommonData.yaml#/components/responses/404' + '429': + $ref: 'TS29571_CommonData.yaml#/components/responses/429' + '500': + $ref: 'TS29571_CommonData.yaml#/components/responses/500' + '502': + $ref: 'TS29571_CommonData.yaml#/components/responses/502' + '503': + $ref: 'TS29571_CommonData.yaml#/components/responses/503' + default: + $ref: 'TS29571_CommonData.yaml#/components/responses/default' +components: + securitySchemes: + oAuth2ClientCredentials: + type: oauth2 + flows: + clientCredentials: + tokenUrl: '{nrfApiRoot}/oauth2/token' + scopes: + nnef-dnai-mapping: Access to the Nnef_DNAIMapping API diff --git a/TS29591_Nnef_ECSAddress.yaml b/TS29591_Nnef_ECSAddress.yaml index 2899b85f..5642ffab 100644 --- a/TS29591_Nnef_ECSAddress.yaml +++ b/TS29591_Nnef_ECSAddress.yaml @@ -1,14 +1,14 @@ openapi: 3.0.0 info: title: Nnef_ECSAddressConfigurationInformation - version: 1.0.0-alpha.1 + version: 1.0.0-alpha.2 description: | NEF ECS Address Service. © 2023 , 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: description: > - 3GPP TS 29.591 V18.2.0; 5G System; Network Exposure Function Southbound Services; Stage 3. + 3GPP TS 29.591 V18.3.0; 5G System; Network Exposure Function Southbound Services; Stage 3. url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.591/ servers: - url: '{apiRoot}/nnef-ecs-addr-cfg-info/v1' @@ -284,22 +284,19 @@ components: description: Each element identifies a slice. internalGroupId: $ref: 'TS29571_CommonData.yaml#/components/schemas/GroupId' - anyUe: - type: boolean - description: > - Identifies any UE when setting to "true". Default value is "false" if omitted. immRepInd: type: boolean description: > - Contains the ECS Address Configuration Information that match this subscription. - It may be included only in the POST (or PUT) response body of a subscription creation - (or modification), and only if the "immRepInd" attribute is set to "true". + Indication of immediate reporting. If included, when it is set to true it indicates + immediate reporting of the subscribed events, if available. Otherwise, reporting will + occur when the event is met. immReports: type: array items: $ref: '#/components/schemas/EcsAddrCfgInfoNotification' minItems: 1 - description: Immediate report with ECS Address Configuration Information. + description: Immediate report with ECS Address Configuration Information that + match this subscription. supportedFeatures: $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures' required: diff --git a/TS29591_Nnef_TrafficInfluenceData.yaml b/TS29591_Nnef_TrafficInfluenceData.yaml index 15981f8c..d01bdbb8 100644 --- a/TS29591_Nnef_TrafficInfluenceData.yaml +++ b/TS29591_Nnef_TrafficInfluenceData.yaml @@ -1,14 +1,14 @@ openapi: 3.0.0 info: title: Nnef_TrafficInfluenceData - version: 1.0.0-alpha.1 + version: 1.0.0-alpha.2 description: | NEF Traffic Influence Data Service. © 2023 , 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: description: > - 3GPP TS 29.591 V18.2.0; 5G System; Network Exposure Function Southbound Services; Stage 3. + 3GPP TS 29.591 V18.3.0; 5G System; Network Exposure Function Southbound Services; Stage 3. url: https://www.3gpp.org/ftp/Specs/archive/29_series/29.591/ servers: - url: '{apiRoot}/nnef-traffic-influence-data/v1' @@ -316,6 +316,7 @@ paths: $ref: 'TS29571_CommonData.yaml#/components/responses/503' default: $ref: 'TS29571_CommonData.yaml#/components/responses/default' + components: securitySchemes: oAuth2ClientCredentials: @@ -376,6 +377,12 @@ components: required: - notifUri - notifCorrId + anyOf: + - required: [dnns] + - required: [snssais] + - required: [internalGroupIds] + - required: [supis] + - required: [anyUe] TrafficInfluDataNotify: description: Represents notifications for traffic influence data. diff --git a/TS29598_Nudsf_DataRepository.yaml b/TS29598_Nudsf_DataRepository.yaml index 2191886b..f33b2505 100644 --- a/TS29598_Nudsf_DataRepository.yaml +++ b/TS29598_Nudsf_DataRepository.yaml @@ -1,14 +1,14 @@ openapi: 3.0.0 info: title: Nudsf_DataRepository - version: 1.2.0-alpha.3 + version: 1.2.0-alpha.4 description: | Nudsf Data Repository Service. © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: - description: 3GPP TS 29.598 UDSF Services, V18.2.0. + description: 3GPP TS 29.598 UDSF Services, V18.3.0. url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.598/' servers: @@ -264,10 +264,12 @@ paths: $ref: 'TS29571_CommonData.yaml#/components/responses/404' '406': $ref: 'TS29571_CommonData.yaml#/components/responses/406' + '412': + $ref: '#/components/responses/412' '429': $ref: 'TS29571_CommonData.yaml#/components/responses/429' '500': - $ref: 'TS29571_CommonData.yaml#/components/responses/500' + $ref: '#/components/responses/500' '502': $ref: 'TS29571_CommonData.yaml#/components/responses/502' '503': @@ -412,6 +414,8 @@ paths: $ref: 'TS29571_CommonData.yaml#/components/responses/404' '408': $ref: 'TS29571_CommonData.yaml#/components/responses/408' + '409': + $ref: '#/components/responses/409' '411': $ref: 'TS29571_CommonData.yaml#/components/responses/411' '412': # Return Record value if get-previous=true @@ -596,10 +600,12 @@ paths: $ref: 'TS29571_CommonData.yaml#/components/responses/404' '406': $ref: 'TS29571_CommonData.yaml#/components/responses/406' + '412': + $ref: '#/components/responses/412' '429': $ref: 'TS29571_CommonData.yaml#/components/responses/429' '500': - $ref: 'TS29571_CommonData.yaml#/components/responses/500' + $ref: '#/components/responses/500' '502': $ref: 'TS29571_CommonData.yaml#/components/responses/502' '503': @@ -700,8 +706,12 @@ paths: $ref: 'TS29571_CommonData.yaml#/components/responses/404' '408': $ref: 'TS29571_CommonData.yaml#/components/responses/408' + '409': + $ref: '#/components/responses/409' '411': $ref: 'TS29571_CommonData.yaml#/components/responses/411' + '412': + $ref: '#/components/responses/412' '413': $ref: 'TS29571_CommonData.yaml#/components/responses/413' '415': @@ -806,10 +816,12 @@ paths: $ref: 'TS29571_CommonData.yaml#/components/responses/404' '406': $ref: 'TS29571_CommonData.yaml#/components/responses/406' + '412': + $ref: '#/components/responses/412' '429': $ref: 'TS29571_CommonData.yaml#/components/responses/429' '500': - $ref: 'TS29571_CommonData.yaml#/components/responses/500' + $ref: '#/components/responses/500' '502': $ref: 'TS29571_CommonData.yaml#/components/responses/502' '503': @@ -893,10 +905,12 @@ paths: $ref: 'TS29571_CommonData.yaml#/components/responses/404' '406': $ref: 'TS29571_CommonData.yaml#/components/responses/406' + '412': + $ref: '#/components/responses/412' '429': $ref: 'TS29571_CommonData.yaml#/components/responses/429' '500': - $ref: 'TS29571_CommonData.yaml#/components/responses/500' + $ref: '#/components/responses/500' '502': $ref: 'TS29571_CommonData.yaml#/components/responses/502' '503': @@ -1009,6 +1023,8 @@ paths: $ref: 'TS29571_CommonData.yaml#/components/responses/404' '408': $ref: 'TS29571_CommonData.yaml#/components/responses/408' + '409': + $ref: '#/components/responses/409' '411': $ref: 'TS29571_CommonData.yaml#/components/responses/411' '412': # Return previous Block value if get-previous=true @@ -2384,6 +2400,17 @@ components: $ref: '#/components/schemas/NotificationSubscription' minItems: 1 + ExtendedProblemDetails: + description: Extending problemDetails + allOf: + - $ref: 'TS29571_CommonData.yaml#/components/schemas/ProblemDetails' + - $ref: '#/components/schemas/ProblemDetailsExtension' + + ProblemDetailsExtension: + anyOf: + - $ref: '#/components/schemas/Record' + - $ref: '#/components/schemas/RecordMeta' + headers: Cache-Control: description: Cache-Control containing max-age, as described in RFC 7234, 5.2 @@ -2583,3 +2610,22 @@ components: $ref: '#/components/headers/ETag' Last-Modified: $ref: '#/components/headers/Last-Modified' + + '409': + description: Conflict + content: + application/problem+json: + schema: + $ref: '#/components/schemas/ExtendedProblemDetails' + '412': + description: Precondition Failed + content: + application/problem+json: + schema: + $ref: '#/components/schemas/ExtendedProblemDetails' + '500': + description: Internal Server Error + content: + application/problem+json: + schema: + $ref: '#/components/schemas/ExtendedProblemDetails' diff --git a/TS32291_Nchf_ConvergedCharging.yaml b/TS32291_Nchf_ConvergedCharging.yaml index f1eb207e..09fe0fe8 100644 --- a/TS32291_Nchf_ConvergedCharging.yaml +++ b/TS32291_Nchf_ConvergedCharging.yaml @@ -1,13 +1,13 @@ openapi: 3.0.0 info: title: Nchf_ConvergedCharging - version: 3.2.0-alpha.2 + version: 3.2.0-alpha.3 description: | ConvergedCharging Service © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). All rights reserved. externalDocs: description: > - 3GPP TS 32.291 V18.2.0: Telecommunication management; Charging management; + 3GPP TS 32.291 V18.3.0: Telecommunication management; Charging management; 5G system, charging service; Stage 3. url: 'http://www.3gpp.org/ftp/Specs/archive/32_series/32.291/' servers: @@ -282,6 +282,8 @@ components: type: string eASProviderIdentifier: type: string + aMFId: + $ref: 'TS29571_CommonData.yaml#/components/schemas/AmfId' pDUSessionChargingInformation: $ref: '#/components/schemas/PDUSessionChargingInformation' roamingQBCInformation: @@ -431,7 +433,6 @@ components: tariffTimeChange: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' required: - - triggerType - triggerCategory MultipleUnitInformation: type: object @@ -686,8 +687,8 @@ components: type: boolean 5GLANTypeService: $ref: '#/components/schemas/5GLANTypeService' - sNPNID: - $ref: 'TS29571_CommonData.yaml#/components/schemas/PlmnIdNid' + sNPNInformation: + $ref: '#/components/schemas/SNPNInformation' required: - pduSessionID - dnnId @@ -744,12 +745,18 @@ components: NSPAContainerInformation: type: object properties: - latency: + uplinkLatency: type: integer - throughput: + downlinkLatency: + type: integer + uplinkThroughput: $ref: '#/components/schemas/Throughput' - maximumPacketLossRate: - type: string + downlinkThroughput: + $ref: '#/components/schemas/Throughput' + maximumPacketLossRateUL: + type: integer + maximumPacketLossRateDL: + type: integer serviceExperienceStatisticsData: $ref: 'TS29520_Nnwdaf_EventsSubscription.yaml#/components/schemas/ServiceExperienceInfo' theNumberOfPDUSessions: @@ -1080,6 +1087,15 @@ components: type: string required: - aPIName + SNPNInformation: + type: object + properties: + sNPNID: + $ref: 'TS29571_CommonData.yaml#/components/schemas/PlmnIdNid' + accessType: + $ref: 'TS29571_CommonData.yaml#/components/schemas/AccessType' + required: + - sNPNID RegistrationChargingInformation: type: object properties: @@ -1139,6 +1155,11 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/GlobalRanNodeId' sNPNID: $ref: 'TS29571_CommonData.yaml#/components/schemas/PlmnIdNid' + cAGIDList: + type: array + items: + $ref: 'TS29571_CommonData.yaml#/components/schemas/CagId' + minItems: 0 required: - registrationMessagetype PSCellInformation: @@ -1599,6 +1620,10 @@ components: $ref: 'TS29571_CommonData.yaml#/components/schemas/Float' meanVirtualDiskUsage: $ref: 'TS29571_CommonData.yaml#/components/schemas/Float' + measuredInBytes: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uint64' + measuredOutBytes: + $ref: 'TS29571_CommonData.yaml#/components/schemas/Uint64' durationStartTime: $ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime' durationEndTime: @@ -1990,7 +2015,7 @@ components: items: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uint32' minItems: 0 - optionalCapability : + optionalCapability: type: array items: $ref: 'TS29571_CommonData.yaml#/components/schemas/Uint32' @@ -2140,6 +2165,9 @@ components: - IMS_Node - MMS_Node - EES + - PCF + - UDM + - UPF - type: string ChargingCharacteristicsSelectionMode: anyOf: