From 4e2df2365fae5b110e4befc4ee88abe427032a5f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Refik=20Fatih=20=C3=9Cstok?= Date: Fri, 7 Feb 2025 15:00:47 +0000 Subject: [PATCH 1/5] Replace TS28312_IntentNrm.yaml --- OpenAPI/TS28312_IntentNrm.yaml | 1009 ++++++++++++++++---------------- 1 file changed, 506 insertions(+), 503 deletions(-) diff --git a/OpenAPI/TS28312_IntentNrm.yaml b/OpenAPI/TS28312_IntentNrm.yaml index 248eac3dc..a3f06c067 100644 --- a/OpenAPI/TS28312_IntentNrm.yaml +++ b/OpenAPI/TS28312_IntentNrm.yaml @@ -1,503 +1,506 @@ -openapi: 3.0.1 -info: - title: Intent NRM - version: 19.0.0 - description: >- - OAS 3.0.1 definition of the Intent NRM - © 2024, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). - All rights reserved. -externalDocs: - description: 3GPP TS 28.312; Intent driven management services for mobile networks - url: http://www.3gpp.org/ftp/Specs/archive/28_series/28.312/ -paths: {} -components: - schemas: - - #-------- Definition of types for name-containments ------ - SubNetwork-ncO-IntentNrm: - type: object - properties: - IntentHandlingFunction: - $ref: '#/components/schemas/IntentHandlingFunction-Multiple' - - #-------Definition of generic IOCs ----------# - - Intent-Single: - description: >- - This IOC represents the properties of an Intent driven management information between MnS consumer and MnS producer. - allOf: - - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' - - type: object - properties: - userLabel: - type: string - intentExpectations: - type: array - uniqueItems: true - minItems: 1 - items: - type: object - oneOf: - - $ref: "#/components/schemas/IntentExpectation" - - $ref: "TS28312_IntentExpectations.yaml#/components/schemas/RadioNetworkExpectation" - - $ref: "TS28312_IntentExpectations.yaml#/components/schemas/EdgeServiceSupportExpectation" - - $ref: "TS28312_IntentExpectations.yaml#/components/schemas/5GCNetworkExpectation" - - $ref: "TS28312_IntentExpectations.yaml#/components/schemas/RadioServiceExpectation" - contextSelectivity: - $ref: "#/components/schemas/Selectivity" - intentContexts: - type: array - uniqueItems: true - items: - $ref: '#/components/schemas/Context' - description: >- - It describes the list of Context(s) which represents the constraints and conditions that should apply - for the entire intent even if there may be specific contexts defined for specific parts of the intent - intentAdminState: - type: string - enum: - - ACTIVATED - - DEACTIVATED - description: >- - It describes the intent administrative state. - This attribute is used when MnS consumer-suspension mechanism is supported - intentPriority: - type: integer - minimum: 1 - maximum: 100 - description: It expresses the priority of the stated intent within a MnS consumer. - intentPreemptionCapability: - type: boolean - observationPeriod: - type: integer - description: >- - It represents the observation period of the fulfilmentInfo for corresponding - ExpectationTargets, IntentExpectations and Intent. - intentReportReference: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo' - IntentReport-Single: - description: It represents intent report information from MnS producer to MnS consumer. - allOf: - - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' - - type: object - properties: - intentFulfilmentReport: - $ref: '#/components/schemas/IntentFulfilmentReport' - intentConflictReports: - type: array - uniqueItems: true - items: - $ref: '#/components/schemas/IntentConflictReport' - intentFeasibilityCheckReport: - $ref: '#/components/schemas/IntentFeasibilityCheckReport' - lastUpdatedTime: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTimeRo' - intentReference: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo' - IntentHandlingFunction-Single: - description: >- - It represents the intent handling capabilities can be supported by a specific intent - handling function of MnS producer. - allOf: - - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' - - type: object - properties: - intentHandlingCapabilityList: - type: array - uniqueItems: true - minItems: 1 - 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 ----------# - IntentExpectation: - description: >- - This data type is the "IntentExpectation" data type without specialisations - It represents MnS consumer's requirements, goals and contexts given to a 3GPP system - type: object - properties: - expectationId: - type: string - description: A unique identifier of the intentExpectation within the intent. - expectationVerb: - $ref: "#/components/schemas/ExpectationVerb" - expectationObject: - $ref: "#/components/schemas/ExpectationObject" - expectationTargets: - type: array - uniqueItems: true - minItems: 1 - items: - $ref: '#/components/schemas/ExpectationTarget' - contextSelectivity: - $ref: "#/components/schemas/Selectivity" - expectationContexts: - type: array - uniqueItems: true - items: - $ref: '#/components/schemas/Context' - required: - - expectationId - #-------Definition of the generic IntentExpectation dataType ----------# - - #-------Definition of the generic ExpectationObject dataType ----------# - ExpectationObject: - description: >- - It represents the Object to which the IntentExpectation should apply. - This data type is the "ExpectationObject" data type without specialisations - type: object - properties: - objectType: - type: string - enum: - - RAN_SUBNETWORK #value for Radio Network Expectation--# - - EDGE_SERVICE_SUPPORT #value for Edge Service Support Expectation--# - - 5GC_SUBNETWORK #value for 5GC Network Expectation--# - - Radio_Service #value for Radio Service Expectation--# - objectInstance: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' - objectContexts: - type: array - uniqueItems: true - items: - $ref: '#/components/schemas/Context' - description: >- - It describes the list of Context(s) which represents the constraints and conditions to be - used as filter information to identify the object(s) to which a given intentExpectation should apply. - #-------Definition of the generic ExpectationObject dataType ----------# - - #-------Definition of the generic dataType --------------# - Condition: - type: string - enum: - - IS_EQUAL_TO - - IS_LESS_THAN - - IS_GREATER_THAN - - IS_WITHIN_RANGE - - IS_OUTSIDE_RANGE - - IS_ONE_OF - - IS_NOT_ONE_OF - - IS_EQUAL_TO_OR_LESS_THAN - - IS_EQUAL_TO_OR_GREATER_THAN - - IS_ALL_OF - Selectivity: - type: string - enum: - - ALL_OF - - ONE_OF - - ANY_OF - FulfilmentStatus: - type: string - readOnly: true - enum: - - FULFILLED - - NOT_FULFILLED - default: NOT_FULFILLED - description: It describes the current status of the intent fulfilment result. - NotFulfilledState: - type: string - readOnly: true - enum: - - ACKNOWLEDGED - - COMPLIANT - - DEGRADED - - SUSPENDED - - TERMINATED - - FULFILMENTFAILED - default: ACKNOWLEDGED - description: It describes the current progress of or the reason for not achieving fulfilment - for the intent, intentExpectation or expectationTarget. - An attribute which is used when FulfilmentInfo is implemented for IntentFulfilmentInfo - FulfilmentInfo: - description: >- - This dataType represents the properties of a specific fulfilment information for an aspect of - the intent (i.e. either an expectation, a target or the whole intent). - type: object - properties: - fulfilmentStatus: - $ref: '#/components/schemas/FulfilmentStatus' - notFullfilledState: - $ref: "#/components/schemas/NotFulfilledState" - notFulfilledReasons: - type: array - uniqueItems: true - items: - type: string - readOnly: true - description: An attribute which is used when FulfilmentInfo is implemented for IntentFulfilmentInfo - ExpectationVerb: - type: string - enum: - - DELIVER - - ENSURE - description: It describes the characteristic of the intentExpectation and is the property that describes the types of intentExpectations. Vendor extensions are allowed - Frequency: - description: >- - It desribes the RF reference frequency (i.e. Absolute Radio Frequency Channel Number) - and/or the frequency operating band used for a given direction (UL or DL) in FDD or - for both UL and DL directions in TDD. - type: object - properties: - arfcn: - type: integer - description: >- - This attribute shall be supported, when the frequency information represent RF reference frequency. - The allowed values for NR see TS 38.104 subclause 5.4.2.1; The allowed values for EUTRAN see TS 36.104 [X] subclause 5.7.3; - freqband: - type: string - description: >- - This attribute shall be supported, when the frequency information represent frequency operating band. - The allowed values for NR see TS 38.104 subclause 5.4.2.3; The allowed value for EUTRAN see TS 36.104 subclause 5.7.3 - 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' - - $ref: '#/components/schemas/UEGroup' - - $ref: '#/components/schemas/Frequency' - UEGroup: - description: >- - It describes the UE Group, which is - represented by specific 5QI, specific S-NSSAI, or a specific combination - of S-NSSAI and 5QI - type: object - properties: - fiveQI: - type: integer - minimum: 0 - maximum: 255 - sNssai: - $ref: 'TS28541_NrNrm.yaml#/components/schemas/Snssai' - #-------Definition of the generic dataType --------------# - - #-------Definition of the generic ExpectationTarget dataType----------# - ExpectationTarget: - description: >- - This data type represents the target of the IntentExpectation that are required to be achieved. - This data type is the "ExpectationTarget" data type without specialisations - type: object - properties: - targetName: - type: string - targetCondition: - $ref: '#/components/schemas/Condition' - targetValueRange: - oneOf: - - type: array - uniqueItems: true - minItems: 1 - items: - $ref: "#/components/schemas/ValueRangeType" - - $ref: "#/components/schemas/ValueRangeType" - contextSelectivity: - $ref: "#/components/schemas/Selectivity" - targetContexts: - type: array - uniqueItems: true - items: - $ref: '#/components/schemas/Context' - description: It describes the list of constraints and conditions that should apply for a specific expectationTarget. - #-------Definition of the generic ExpectationTarget dataType----------# - - #-------Definition of the generic Context dataType----------------# - Context: - description: >- - This data type is the "Context" data type without specialisations - type: object - properties: - contextAttribute: - type: string - contextCondition: - $ref: '#/components/schemas/Condition' - contextValueRange: - oneOf: - - type: array - uniqueItems: true - minItems: 1 - items: - $ref: "#/components/schemas/ValueRangeType" - - $ref: "#/components/schemas/ValueRangeType" - #-------Definition of the generic Context dataType----------------# - - #-------Definition of the generic IntentFulfilmentReport dataType----------------# - IntentFulfilmentReport: - description: >- - It includes the intentFulfilmentInfo and expectationFulfilmetResult. - This attribute shall be supported when intent fulfilment information is supported by IntentReport - type: object - properties: - intentFulfilmentInfo: - $ref: '#/components/schemas/FulfilmentInfo' - expectationFulfilmentResult: - type: array - uniqueItems: true - minItems: 1 - items: - $ref: '#/components/schemas/ExpectationFulfilmentResult' - #-------Definition of the concrete IntentFulfilmentReport dataType----------------# - - #-------Definition of the generic ExpectationFulfilmentResult dataType----------------# - ExpectationFulfilmentResult: - description: >- - It includes the expectationFulfilmentInfo and targetFulfilmentResults for each IntentExpectation. - type: object - properties: - expectaitonId: - type: string - readOnly: true - expectationFulfilmentInfo: - $ref: '#/components/schemas/FulfilmentInfo' - targetFulfilmentResults: - type: array - uniqueItems: true - items: - $ref: '#/components/schemas/TargetFulfilmentResult' - #-------Definition of the concrete ExpectationFulfilmentResult dataType----------------# - - #-------Definition of the generic TargetFulfilmentResult dataType----------------# - TargetFulfilmentResult: - description: >- - This data type includes targetFulfilmentInfo and targetAchievedValue for each ExpectationTarget. - type: object - properties: - targetName: - type: string - readOnly: true - targetFulfilmentInfo: - $ref: '#/components/schemas/FulfilmentInfo' - targetAchievedValue: - type: number - description: >- - It describes the value that has been achieved for the expectation target at the time at which - the report is generated. - readOnly: true - #-------Definition of the concrete TargetFulfilmentResult dataType----------------# - - #-------Definition of the generic IntentConflictReport dataType----------------# - IntentConflictReport: - description: >- - It represents the conflict information for the detected conflict - This attribute shall be supported when intent conflict information is supported by IntentReport - type: object - properties: - conflictId: - type: string - readOnly: true - conflictType: - type: string - readOnly: true - enum: - - INTENT_CONFLICT - - EXPECTATION_CONFLICT - - TARGET_CONFLICT - conflictingIntent: - description: >- - This will be present if the value of conflictType is INTENT_CONFLICT. It describes the DN of the conflicting intent - $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo' - conflictingExpectation: - description: >- - This will be present if the value of conflictType is EXPECTATION_CONFLICT. It describes the expectationId of the conflicting IntentExpectation with an Intent - type: string - readOnly: true - conflictingTarget: - description: >- - This will be present if the value of conflictType is TARGET_CONFLICT. It describes the targetName of the conflicting ExpectationTarget with an IntentExpectation - type: string - readOnly: true - recommendedSolutions: - type: string - readOnly: true - enum: - - MODIFY - - DELETE - - #-------Definition of the concrete IntentConflictReport dataType----------------# - - #-------Definition of the generic IntentFeasibilityCheckReport dataType----------------# - IntentFeasibilityCheckReport: - description: >- - It represents the intent feasibility check information - This attribute shall be supported when intent feasibility check information information is supported by IntentReport - type: object - properties: - feasibilityCheckResult: - type: string - readOnly: true - enum: - - FEASIBLE - - INFEASIBLE - infeasibilityReasons: - type: string - readOnly: true - description: An attribute which is used when feasibilityCheckResult is INFEASIBLE - #-------Definition of the concrete IntentFeasibilityCheckReport dataType----------------# - - #-------Definition of the generic IntentHandlingCapability dataType----------------# - IntentHandlingCapability: - description: >- - It represents expectation object information and expectation target information - which can be supported by a specific intent handling function of MnS producer. - type: object - properties: - intentHandlingCapabilityId: - type: string - readOnly: true - supportedExpectationObjectType: - type: string - enum: - - RAN_SUBNETWORK - - EDGE_SERVICE_SUPPORT - - 5GC_SUBNETWORK - - Radio_Service - readOnly: true - description: It describes the expectation object type which can be supported by a specific intent handling function of MnS producer. - supportedExpectationTargetNames: - type: array - uniqueItems: true - minItems: 1 - items: - type: string - readOnly: true - description: It describes the supported expectation targets for the supported expectation object type. - #-------Definition of the concrete IntentHandlingCapability dataType----------------# - - #------Definition of JSON arrays for name-contained IOCs ---------------# - - Intent-Multiple: - type: array - items: - $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 --------------------------# - resources-intentNrm: - oneOf: - - $ref: '#/components/schemas/IntentHandlingFunction-Single' - - $ref: '#/components/schemas/Intent-Single' - - $ref: '#/components/schemas/IntentReport-Single' - #----- Definitions in TS 28.312 for TS 28.532 --------------------------# - +openapi: 3.0.1 +info: + title: Intent NRM + version: 19.0.0 + description: >- + OAS 3.0.1 definition of the Intent NRM + © 2024, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + All rights reserved. +externalDocs: + description: 3GPP TS 28.312; Intent driven management services for mobile networks + url: http://www.3gpp.org/ftp/Specs/archive/28_series/28.312/ +paths: {} +components: + schemas: + + #-------- Definition of types for name-containments ------ + SubNetwork-ncO-IntentNrm: + type: object + properties: + IntentHandlingFunction: + $ref: '#/components/schemas/IntentHandlingFunction-Multiple' + + #-------Definition of generic IOCs ----------# + + Intent-Single: + description: >- + This IOC represents the properties of an Intent driven management information between MnS consumer and MnS producer. + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + userLabel: + type: string + intentExpectations: + type: array + uniqueItems: true + minItems: 1 + items: + type: object + oneOf: + - $ref: "#/components/schemas/IntentExpectation" + - $ref: "TS28312_IntentExpectations.yaml#/components/schemas/RadioNetworkExpectation" + - $ref: "TS28312_IntentExpectations.yaml#/components/schemas/EdgeServiceSupportExpectation" + - $ref: "TS28312_IntentExpectations.yaml#/components/schemas/5GCNetworkExpectation" + - $ref: "TS28312_IntentExpectations.yaml#/components/schemas/RadioServiceExpectation" + - $ref: "TS28312_IntentExpectations.yaml#/components/schemas/NetworkMaintenanceExpectation" + contextSelectivity: + $ref: "#/components/schemas/Selectivity" + intentContexts: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/Context' + description: >- + It describes the list of Context(s) which represents the constraints and conditions that should apply + for the entire intent even if there may be specific contexts defined for specific parts of the intent + intentAdminState: + type: string + enum: + - ACTIVATED + - DEACTIVATED + description: >- + It describes the intent administrative state. + This attribute is used when MnS consumer-suspension mechanism is supported + intentPriority: + type: integer + minimum: 1 + maximum: 100 + description: It expresses the priority of the stated intent within a MnS consumer. + intentPreemptionCapability: + type: boolean + observationPeriod: + type: integer + description: >- + It represents the observation period of the fulfilmentInfo for corresponding + ExpectationTargets, IntentExpectations and Intent. + intentReportReference: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo' + IntentReport-Single: + description: It represents intent report information from MnS producer to MnS consumer. + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + intentFulfilmentReport: + $ref: '#/components/schemas/IntentFulfilmentReport' + intentConflictReports: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/IntentConflictReport' + intentFeasibilityCheckReport: + $ref: '#/components/schemas/IntentFeasibilityCheckReport' + lastUpdatedTime: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTimeRo' + intentReference: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo' + IntentHandlingFunction-Single: + description: >- + It represents the intent handling capabilities can be supported by a specific intent + handling function of MnS producer. + allOf: + - $ref: 'TS28623_GenericNrm.yaml#/components/schemas/Top' + - type: object + properties: + intentHandlingCapabilityList: + type: array + uniqueItems: true + minItems: 1 + 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 ----------# + IntentExpectation: + description: >- + This data type is the "IntentExpectation" data type without specialisations + It represents MnS consumer's requirements, goals and contexts given to a 3GPP system + type: object + properties: + expectationId: + type: string + description: A unique identifier of the intentExpectation within the intent. + expectationVerb: + $ref: "#/components/schemas/ExpectationVerb" + expectationObject: + $ref: "#/components/schemas/ExpectationObject" + expectationTargets: + type: array + uniqueItems: true + minItems: 1 + items: + $ref: '#/components/schemas/ExpectationTarget' + contextSelectivity: + $ref: "#/components/schemas/Selectivity" + expectationContexts: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/Context' + required: + - expectationId + #-------Definition of the generic IntentExpectation dataType ----------# + + #-------Definition of the generic ExpectationObject dataType ----------# + ExpectationObject: + description: >- + It represents the Object to which the IntentExpectation should apply. + This data type is the "ExpectationObject" data type without specialisations + type: object + properties: + objectType: + type: string + enum: + - RAN_SUBNETWORK #value for Radio Network Expectation--# + - EDGE_SERVICE_SUPPORT #value for Edge Service Support Expectation--# + - 5GC_SUBNETWORK #value for 5GC Network Expectation--# + - Radio_Service #value for Radio Service Expectation--# + - SUBNETWORK #value for Network Maintenance Expectation--# + objectInstance: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' + objectContexts: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/Context' + description: >- + It describes the list of Context(s) which represents the constraints and conditions to be + used as filter information to identify the object(s) to which a given intentExpectation should apply. + #-------Definition of the generic ExpectationObject dataType ----------# + + #-------Definition of the generic dataType --------------# + Condition: + type: string + enum: + - IS_EQUAL_TO + - IS_LESS_THAN + - IS_GREATER_THAN + - IS_WITHIN_RANGE + - IS_OUTSIDE_RANGE + - IS_ONE_OF + - IS_NOT_ONE_OF + - IS_EQUAL_TO_OR_LESS_THAN + - IS_EQUAL_TO_OR_GREATER_THAN + - IS_ALL_OF + Selectivity: + type: string + enum: + - ALL_OF + - ONE_OF + - ANY_OF + FulfilmentStatus: + type: string + readOnly: true + enum: + - FULFILLED + - NOT_FULFILLED + default: NOT_FULFILLED + description: It describes the current status of the intent fulfilment result. + NotFulfilledState: + type: string + readOnly: true + enum: + - ACKNOWLEDGED + - COMPLIANT + - DEGRADED + - SUSPENDED + - TERMINATED + - FULFILMENTFAILED + default: ACKNOWLEDGED + description: It describes the current progress of or the reason for not achieving fulfilment + for the intent, intentExpectation or expectationTarget. + An attribute which is used when FulfilmentInfo is implemented for IntentFulfilmentInfo + FulfilmentInfo: + description: >- + This dataType represents the properties of a specific fulfilment information for an aspect of + the intent (i.e. either an expectation, a target or the whole intent). + type: object + properties: + fulfilmentStatus: + $ref: '#/components/schemas/FulfilmentStatus' + notFullfilledState: + $ref: "#/components/schemas/NotFulfilledState" + notFulfilledReasons: + type: array + uniqueItems: true + items: + type: string + readOnly: true + description: An attribute which is used when FulfilmentInfo is implemented for IntentFulfilmentInfo + ExpectationVerb: + type: string + enum: + - DELIVER + - ENSURE + - MAINTAIN + description: It describes the characteristic of the intentExpectation and is the property that describes the types of intentExpectations. Vendor extensions are allowed + Frequency: + description: >- + It desribes the RF reference frequency (i.e. Absolute Radio Frequency Channel Number) + and/or the frequency operating band used for a given direction (UL or DL) in FDD or + for both UL and DL directions in TDD. + type: object + properties: + arfcn: + type: integer + description: >- + This attribute shall be supported, when the frequency information represent RF reference frequency. + The allowed values for NR see TS 38.104 subclause 5.4.2.1; The allowed values for EUTRAN see TS 36.104 [X] subclause 5.7.3; + freqband: + type: string + description: >- + This attribute shall be supported, when the frequency information represent frequency operating band. + The allowed values for NR see TS 38.104 subclause 5.4.2.3; The allowed value for EUTRAN see TS 36.104 subclause 5.7.3 + 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' + - $ref: '#/components/schemas/UEGroup' + - $ref: '#/components/schemas/Frequency' + UEGroup: + description: >- + It describes the UE Group, which is + represented by specific 5QI, specific S-NSSAI, or a specific combination + of S-NSSAI and 5QI + type: object + properties: + fiveQI: + type: integer + minimum: 0 + maximum: 255 + sNssai: + $ref: 'TS28541_NrNrm.yaml#/components/schemas/Snssai' + #-------Definition of the generic dataType --------------# + + #-------Definition of the generic ExpectationTarget dataType----------# + ExpectationTarget: + description: >- + This data type represents the target of the IntentExpectation that are required to be achieved. + This data type is the "ExpectationTarget" data type without specialisations + type: object + properties: + targetName: + type: string + targetCondition: + $ref: '#/components/schemas/Condition' + targetValueRange: + oneOf: + - type: array + uniqueItems: true + minItems: 1 + items: + $ref: "#/components/schemas/ValueRangeType" + - $ref: "#/components/schemas/ValueRangeType" + contextSelectivity: + $ref: "#/components/schemas/Selectivity" + targetContexts: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/Context' + description: It describes the list of constraints and conditions that should apply for a specific expectationTarget. + #-------Definition of the generic ExpectationTarget dataType----------# + + #-------Definition of the generic Context dataType----------------# + Context: + description: >- + This data type is the "Context" data type without specialisations + type: object + properties: + contextAttribute: + type: string + contextCondition: + $ref: '#/components/schemas/Condition' + contextValueRange: + oneOf: + - type: array + uniqueItems: true + minItems: 1 + items: + $ref: "#/components/schemas/ValueRangeType" + - $ref: "#/components/schemas/ValueRangeType" + #-------Definition of the generic Context dataType----------------# + + #-------Definition of the generic IntentFulfilmentReport dataType----------------# + IntentFulfilmentReport: + description: >- + It includes the intentFulfilmentInfo and expectationFulfilmetResult. + This attribute shall be supported when intent fulfilment information is supported by IntentReport + type: object + properties: + intentFulfilmentInfo: + $ref: '#/components/schemas/FulfilmentInfo' + expectationFulfilmentResult: + type: array + uniqueItems: true + minItems: 1 + items: + $ref: '#/components/schemas/ExpectationFulfilmentResult' + #-------Definition of the concrete IntentFulfilmentReport dataType----------------# + + #-------Definition of the generic ExpectationFulfilmentResult dataType----------------# + ExpectationFulfilmentResult: + description: >- + It includes the expectationFulfilmentInfo and targetFulfilmentResults for each IntentExpectation. + type: object + properties: + expectaitonId: + type: string + readOnly: true + expectationFulfilmentInfo: + $ref: '#/components/schemas/FulfilmentInfo' + targetFulfilmentResults: + type: array + uniqueItems: true + items: + $ref: '#/components/schemas/TargetFulfilmentResult' + #-------Definition of the concrete ExpectationFulfilmentResult dataType----------------# + + #-------Definition of the generic TargetFulfilmentResult dataType----------------# + TargetFulfilmentResult: + description: >- + This data type includes targetFulfilmentInfo and targetAchievedValue for each ExpectationTarget. + type: object + properties: + targetName: + type: string + readOnly: true + targetFulfilmentInfo: + $ref: '#/components/schemas/FulfilmentInfo' + targetAchievedValue: + type: number + description: >- + It describes the value that has been achieved for the expectation target at the time at which + the report is generated. + readOnly: true + #-------Definition of the concrete TargetFulfilmentResult dataType----------------# + + #-------Definition of the generic IntentConflictReport dataType----------------# + IntentConflictReport: + description: >- + It represents the conflict information for the detected conflict + This attribute shall be supported when intent conflict information is supported by IntentReport + type: object + properties: + conflictId: + type: string + readOnly: true + conflictType: + type: string + readOnly: true + enum: + - INTENT_CONFLICT + - EXPECTATION_CONFLICT + - TARGET_CONFLICT + conflictingIntent: + description: >- + This will be present if the value of conflictType is INTENT_CONFLICT. It describes the DN of the conflicting intent + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DnRo' + conflictingExpectation: + description: >- + This will be present if the value of conflictType is EXPECTATION_CONFLICT. It describes the expectationId of the conflicting IntentExpectation with an Intent + type: string + readOnly: true + conflictingTarget: + description: >- + This will be present if the value of conflictType is TARGET_CONFLICT. It describes the targetName of the conflicting ExpectationTarget with an IntentExpectation + type: string + readOnly: true + recommendedSolutions: + type: string + readOnly: true + enum: + - MODIFY + - DELETE + + #-------Definition of the concrete IntentConflictReport dataType----------------# + + #-------Definition of the generic IntentFeasibilityCheckReport dataType----------------# + IntentFeasibilityCheckReport: + description: >- + It represents the intent feasibility check information + This attribute shall be supported when intent feasibility check information information is supported by IntentReport + type: object + properties: + feasibilityCheckResult: + type: string + readOnly: true + enum: + - FEASIBLE + - INFEASIBLE + infeasibilityReasons: + type: string + readOnly: true + description: An attribute which is used when feasibilityCheckResult is INFEASIBLE + #-------Definition of the concrete IntentFeasibilityCheckReport dataType----------------# + + #-------Definition of the generic IntentHandlingCapability dataType----------------# + IntentHandlingCapability: + description: >- + It represents expectation object information and expectation target information + which can be supported by a specific intent handling function of MnS producer. + type: object + properties: + intentHandlingCapabilityId: + type: string + readOnly: true + supportedExpectationObjectType: + type: string + enum: + - RAN_SUBNETWORK + - EDGE_SERVICE_SUPPORT + - 5GC_SUBNETWORK + - Radio_Service + readOnly: true + description: It describes the expectation object type which can be supported by a specific intent handling function of MnS producer. + supportedExpectationTargetNames: + type: array + uniqueItems: true + minItems: 1 + items: + type: string + readOnly: true + description: It describes the supported expectation targets for the supported expectation object type. + #-------Definition of the concrete IntentHandlingCapability dataType----------------# + + #------Definition of JSON arrays for name-contained IOCs ---------------# + + Intent-Multiple: + type: array + items: + $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 --------------------------# + resources-intentNrm: + oneOf: + - $ref: '#/components/schemas/IntentHandlingFunction-Single' + - $ref: '#/components/schemas/Intent-Single' + - $ref: '#/components/schemas/IntentReport-Single' + #----- Definitions in TS 28.312 for TS 28.532 --------------------------# + -- GitLab From 60aae99c51d8044348356aec40a8fea2a52ffea0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Refik=20Fatih=20=C3=9Cstok?= Date: Fri, 7 Feb 2025 15:03:30 +0000 Subject: [PATCH 2/5] Replace TS28312_IntentExpectations.yaml --- OpenAPI/TS28312_IntentExpectations.yaml | 2483 ++++++++++++----------- 1 file changed, 1305 insertions(+), 1178 deletions(-) diff --git a/OpenAPI/TS28312_IntentExpectations.yaml b/OpenAPI/TS28312_IntentExpectations.yaml index e1d2bb5f6..8335063e5 100644 --- a/OpenAPI/TS28312_IntentExpectations.yaml +++ b/OpenAPI/TS28312_IntentExpectations.yaml @@ -1,1178 +1,1305 @@ -openapi: 3.0.1 -info: - title: Scenario specific Intent Expectations - version: 19.0.0 - description: >- - OAS 3.0.1 definition of scenario specific Intent Expectations - © 2024, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). - All rights reserved. -externalDocs: - description: 3GPP TS 28.312; Intent driven management services for mobile networks - url: http://www.3gpp.org/ftp/Specs/archive/28_series/28.312/ -paths: {} -components: - schemas: - - #-------Definition of the Scenario specific IntentExpectation dataType ----------# - RadioNetworkExpectation: - description: >- - This data type is the "IntentExpectation" data type with specialisations to represent MnS consumer's expectations for radio network delivering and performance assurance - type: object - properties: - expectationId: - type: string - expectationVerb: - $ref: "TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb" - expectationObject: - $ref: "#/components/schemas/RadioNetworkExpectationObject" - expectationTargets: - type: array - uniqueItems: true - 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/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 - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/TargetAssuranceTimeContext' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' - required: - - expectationId - RadioServiceExpectation: - description: >- - This data type is the "IntentExpectation" data type with specialisations to represent MnS consumer's expectations for radio service delivering - type: object - properties: - expectationId: - type: string - expectationVerb: - $ref: "TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb" - expectationObject: - $ref: "#/components/schemas/RadioServiceExpectationObject" - expectationTargets: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/DLLatencyTarget' - - $ref: '#/components/schemas/ULLatencyTarget' - - $ref: '#/components/schemas/DLThptPerUETarget' - - $ref: '#/components/schemas/ULThptPerUETarget' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget' - expectationContexts: - type: array - uniqueItems: true - items: - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' - required: - - expectationId - 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/EdgeServiceSupportExpectationObject' - expectationTargets: - type: array - uniqueItems: true - 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 - uniqueItems: true - 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/Context' - 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 - expectationVerb: - $ref: "TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb" - expectationObjects: - type: array - uniqueItems: true - items: - $ref: "#/components/schemas/5GCNetworkExpectationObject" - expectationTargets: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: "#/components/schemas/MaxNumberofPDUsessionsTarget" - - $ref: "#/components/schemas/MaxNumberofRegisteredsubscribersTarget" - - $ref: "#/components/schemas/IncomingDataTarget" - - $ref: "#/components/schemas/OutgoingDataTarget" - - $ref: "TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget" - expectationContexts: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/StartTimeContext' - - $ref: '#/components/schemas/ResourceSharingLevelContext' - - $ref: "TS28312_IntentNrm.yaml#/components/schemas/Context" - required: - - expectationId - #-------Definition of the IntentExpectation dataType ----------# - - #-------Definition of the scenario specific ExpectationObject dataType ----------# - RadioNetworkExpectationObject: - description: >- - This data type is the "ExpectationObject" data type with specialisations for RadioNetworkExpectation - type: object - properties: - objectType: - type: string - enum: - - RAN_SubNetwork - objectInstance: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' - objectContexts: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/CoverageAreaPolygonContext' - - $ref: '#/components/schemas/CoverageTACContext' - - $ref: '#/components/schemas/PLMNContext' - - $ref: '#/components/schemas/DlFrequencyContext' - - $ref: '#/components/schemas/UlFrequencyContext' - - $ref: '#/components/schemas/RATContext' - - $ref: "#/components/schemas/UEGroupContext" - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' - RadioServiceExpectationObject: - description: >- - This data type is the "ExpectationObject" data type with specialisations for RadioServicekExpectation - type: object - properties: - objectType: - type: string - enum: - - Radio_Service - objectInstance: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' - objectContexts: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/CoverageAreaPolygonContext' - - $ref: '#/components/schemas/ServiceTypeContext' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' - EdgeServiceSupportExpectationObject: - description: >- - This data type is the "ExpectationObject" data type with specialisations for EdgeServiceSupportExpectation - type: object - properties: - objectType: - type: string - enum: - - EdgeService_Support #value for Edge Service Support Expectation--# - objectInstance: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' - objectContexts: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: '#/components/schemas/EdgeIdentificationIdContext' - - $ref: '#/components/schemas/EdgeIdentificationLocContext' - - $ref: '#/components/schemas/CoverageAreaTAContext' - - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' - 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: - type: array - uniqueItems: true - items: - type: object - oneOf: - - $ref: "#/components/schemas/NfTypeContext" - - $ref: "#/components/schemas/NfInstanceLocationContext" - - $ref: "#/components/schemas/PLMNContext" - - $ref: "#/components/schemas/TaiContext" - - $ref: "#/components/schemas/ServingScopeContext" - - $ref: "#/components/schemas/DnnContext" - - $ref: "TS28312_IntentNrm.yaml#/components/schemas/Context" - #-------Definition of the ExpectationObject dataType ----------# - - - #-------Definition of the Scenario specific ExpectationTarget dataType----------# - WeakRSRPRatioTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for WeakRSRPRatioTarget. It describes - the downlink weak coverage ratio target for the RAN SubNetwork that the intent expectation is applied. - The numerator is the number of the cells with downlink weak RSRP, and the denominator is the total number - of cells of the RAN Subnetwork in the specified area. - type: object - properties: - targetName: - type: string - enum: - - WeakRSRPRatio - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - minimum: 0 - maximum: 100 - targetContexts: - $ref: '#/components/schemas/WeakRSRPContext' - WeakRSRPContext: - description: >- - This data type is the "TargetContext" data type with specialisations for WeakRSRPContext. It describes the threshold - for downlink weak RSRP of the cells (see RSRP measurements in TS 28.552 [6]) of the RAN SubNetwork that the intent - expectation is applied. - type: object - properties: - contextAttribute: - type: string - enum: - - WeakRSRPThreshold - contextCondition: - type: string - enum: - - IS_LESS_THAN - contextValueRange: - type: number - LowSINRRatioTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for LowSINRatioTarget.It describes the low SINR - ratio target for the RAN SubNetwork that the intent expectation is applied. The numerator is the number of the cells with - low SINR, and the denominator is the total number of cells of the RAN Subnetwork in the specified area. - type: object - properties: - targetName: - type: string - enum: - - LowSINRRatio - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - minimum: 0 - maximum: 100 - targetContexts: - $ref: '#/components/schemas/LowSINRContext' - LowSINRContext: - description: >- - This data type is the "TargetContext" data type with specialisations for LowSINRContext.It describes the threshold for - low SINR of the cells (see SINR measurements in TS 28.552 [6]) of the RAN SubNetwork that the intent expectation is applied. - type: object - properties: - contextAttribute: - type: string - enum: - - LowSINRThreshold - contextCondition: - type: string - enum: - - IS_LESS_THAN - contextValueRange: - type: integer - AveULRANUEThptTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for AveULRANUEThptTarget.It describes the average - UL RAN UE throughput target for RAN SubNetwork (see UL RAN UE throughput for a sub-network in TS 28.554[11]) that the intent - expectation is applied. - type: object - properties: - targetName: - type: string - enum: - - AveULRANUEThpt - targetCondition: - type: string - enum: - - IS_GREATER_THAN - targetValueRange: - type: integer - AveDLRANUEThptTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for AveDLRANUEThptTarget.It describes the average - DL RAN UE throughput target for RAN SubNetwork (see DL RAN UE throughput for a sub-network in TS 28.554[11]) that the intent - expectation is applied. - type: object - properties: - targetName: - type: string - enum: - - AveDLRANUEThpt - targetCondition: - type: string - enum: - - IS_GREATER_THAN - targetValueRange: - type: integer - LowULRANUEThptRatioTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for LowULRANUEThptRatioTarget.It describes the low - UL RAN UE throughput ratio target for the RAN SubNetwork that the intent expectation is applied. The numerator is the number - of the cells with low UL RAN UE throughput, and the denominator is the total number of cells of the RAN Subnetwork in the - specified area. - type: object - properties: - targetName: - type: string - enum: - - LowULRANUEThptRatio - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - minimum: 0 - maximum: 100 - targetContexts: - $ref: '#/components/schemas/LowULRANUEThptContext' - LowULRANUEThptContext: - description: >- - This data type is the "TargetContext" data type with specialisations for LowULRANUEThptContext.It describes the threshold - for the low UL RAN UE throughput cells (see average UL RAN UE throughput in gNB and distribution of UL UE throughput in gNB - in TS 28.552[6]) of the RAN SubNetwork that the intent expectation is applied. - type: object - properties: - contextAttribute: - type: string - enum: - - LowULRANUEThptThreshold - contextCondition: - type: string - enum: - - Is_less_than - contextValueRange: - type: number - LowDLRANUEThptRatioTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for LowDLRANUEThptRatioTarget. It describes - the low DL RAN UE throughput ratio target for the RAN SubNetwork that the intent expectation is applied.The numerator - is the number of the cells with low DL RAN UE throughput, and the denominator is the total number of cells of the - RAN Subnetwork in the specified area. - type: object - properties: - targetName: - type: string - enum: - - LowDLRANUEThptRatio - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - minimum: 0 - maximum: 100 - targetContexts: - $ref: '#/components/schemas/LowDLRANUEThptContext' - LowDLRANUEThptContext: - description: >- - This data type is the "TargetContext" data type with specialisations for LowDLRANUEThptContext.It describes the threshold - for the low DL RAN UE throughput cells ((see average DL RAN UE throughput in gNB and distribution of DL UE throughput in gNB - in TS 28.552[6]) ) of the RAN SubNetwork that the intent expectation is applied. - type: object - properties: - contextAttribute: - type: string - enum: - - LowDLRANUEThptThreshold - contextCondition: - type: string - enum: - - IS_LESS_THAN - contextValueRange: - type: number - HighULPrbLoadRatioTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for HighULPrbLoadRatioTarget. It describes the high UL - PRB load ratio target (as percentage) for the RAN SubNetwork that the intent expectation is applied. The numerator is the number - of the cells with high UL PRB load, and the denominator is the total number of cells of the RAN Subnetwork in the specified area. - 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.It describes the threshold for high - uplink PRB load (i.e. UL Total PRB Usage in TS 28.552 [12] to represent the percentage of UL PRBs used) of the cells of the RAN - SubNetwork in the specified area that the intent expectation is applied. - 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.It describes the high DL PRB - load ratio target (as percentage) for the RAN SubNetwork that the intent expectation is applied. The numerator is the number of the - cells with high DL PRB load, and the denominator is the total number of cells of the RAN Subnetwork in the specified area. - 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.It describes the threshold for high downlink - PRB load (i.e. DL Total PRB Usage in TS 28.552 [12] to represent the percentage of DL PRBs used) of the cells of the RAN SubNetwork in the - specified area that the intent expectation is applied. - 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.It describes the average uplink PRB load target - (i.e. UL Total PRB Usage in TS 28.552 [12] to represent the percentage of UL PRBs used) of the cells of the RAN SubNetwork that the intent - expectation is applied. - 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.It describes the average dowlink PRB load - (i.e. DL Total PRB Usage in TS 28.552 [12] to represent the percentage of DL PRBs used) target for RAN SubNetwork that the intent expectation - is applied. - 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.It describes the RAN energy consumption - target for RAN SubNetwork that the intent expectation is applied. The definition for RAN energy consumption see ECNG-RAN in clause 6.7.3.4.1 in - TS 28.554 [11]. - 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.It describes the RAN energy efficiency target - for RAN SubNetwork that the intent expectation is applied. The unit of this target is bit/J. The definition for RAN energy efficiency target for RAN - SubNetwork see EEMN,DV in clause 6.7.1.1 in TS 28.554 [11]. - 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. It describes the DL throughput target by the per UE for the - edge service supporting or radio servicde that the intent expectation is applied. For details see dlThptPerUE defined in clause 6.3.1 of TS 28.541 [5]. - type: object - properties: - targetName: - type: string - enum: - - DlThptPerUE - targetCondition: - type: string - enum: - - IS_GREATER_THAN - targetValueRange: - $ref: 'TS28541_SliceNrm.yaml#/components/schemas/XLThpt' - ULThptPerUETarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for ULThptPerUETarget.It describes the UL throughput target by the per UE for the edge - service supporting or radio service that the intent expectation is applied. For details see ulThptPerUE defined in clause 6.3.1 of TS 28.541 [5]. - type: object - properties: - targetName: - type: string - enum: - - UlThptPerUE - targetCondition: - type: string - enum: - - IS_GREATER_THAN - targetValueRange: - $ref: 'TS28541_SliceNrm.yaml#/components/schemas/XLThpt' - DLLatencyTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for DLLatencyTarget.It describes the DL latency target for the edge service supporting or radio service - that the intent expectation is applied - type: object - properties: - targetName: - type: string - enum: - - DlLatency - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - ULLatencyTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for ULLatencyTarget. It describes the UL latency target for the edge service supporting or radioService - that the intent expectation is applied. For details see attribute ulLatency defined in clause 6.3.1 of TS 28.541 [5] - type: object - properties: - targetName: - type: string - enum: - - UlLatency - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - MaxNumberofUEsTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for MaxNumberofUEsTarget.It describes the the number of UEs for edge service supporting - that the intent expectation is applied. For details see attribute maxNumberofUE defined in clause 6.3.1 of of TS 28.541 [5] - type: object - properties: - targetName: - type: string - enum: - - maxNumberofUEs - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - ActivityFactorTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for ActivityFactorTarget.It describes the percentage value of the amount of simultaneous - active UEs to the total number of UEs where active means the UEs are exchanging data with the edge service supporting that the intent expectation is applied. - For details see activityFactor in clause 6.3.1 in TS 28.541 [5]. - type: object - properties: - targetName: - type: string - enum: - - activityFactor - targetCondition: - type: string - enum: - - IS_EQUAL_TO - targetValueRange: - type: integer - UESpeedTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for UESpeedTarget.It describes the speed (in km/hour) supported for edge service supporting - that the intent expectation is applied. For details see uESpeed in clause 6.3.1 in TS 28.541[5]. - type: object - properties: - targetName: - type: string - enum: - - uESpeed - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - MaxNumberofPDUsessionsTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for MaxNumberofPDUsessionsTarget.It describes the maximum number of PDU sessions for 5GC - SubNetwork supporting that the intent expectation is applied. For details, see maxNumberofPDUsessions in clause 5.3.1.2 in TS 28.552 [12]. - type: object - properties: - targetName: - type: string - enum: - - MaxNumberofPDUsessions - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - targetContexts: - $ref: '#/components/schemas/5GSessionContext' - 5GSessionContext: - description: >- - This data type is the "TargetContext" data type with specialisations for 5GSessionContext.It describes the maximum supported 5G PDU session of the 5GC SubNetwork - related to the intent expectation. - type: object - properties: - contextAttribute: - type: string - enum: - - 5GSession - contextCondition: - type: string - enum: - - IS_less_THAN - contextValueRange: - type: integer - MaxNumberofRegisteredsubscribersTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for MaxNumberofRegisteredsubscribersTarget.It describes the maximum number of Registered - subscribers for 5GC SubNetwork supporting that the intent expectation is applied. For details, see maxNumberofRegisteredsubscribers in clause 5.6.2 in TS 28.552 [12]. - type: object - properties: - targetName: - type: string - enum: - - MaxNumberofRegisteredsubscribers - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - IncomingDataTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for IncomingDataTarget.It describes the maximum incoming data packets for 5GC SubNetwork - related to the intent expectation. For details, see N6 incoming link usage measurement in clause 5.4.2.1 in TS 28.552 [12]. - type: object - properties: - targetName: - type: string - enum: - - IncomingData - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - OutgoingDataTarget: - description: >- - This data type is the "ExpectationTarget" data type with specialisations for OutgoingDataTarget.It describes the maximum outgoing data packets for 5GC SubNetwork - related to the intent expectation. For details, see N6 outgoing link usage measurement in clause 5.4.2.2 in TS 28.552 [12]. - type: object - properties: - targetName: - type: string - enum: - - OutgoingData - targetCondition: - type: string - enum: - - IS_LESS_THAN - targetValueRange: - type: integer - - #-------Definition of the concrete ExpectationTarget dataType----------# - - #-------Definition of the concrete ObjectTarget dataType----------------# - CoverageAreaPolygonContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for CoverageAreaPolygonContext.It describes the coverage areas for the RAN SubNetwork that the - intent expectation is applied in the form of polygon. - type: object - properties: - contextAttribute: - type: string - enum: - - CoverageAreaPolygon - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoArea' - CoverageTACContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for CoverageTACContext.It describes the coverage areas for the RAN SubNetwork that the intent - expectation is applied in the form of TAC. - type: object - properties: - contextAttribute: - type: string - enum: - - CoverageAreaTac - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - $ref: "TS28623_ComDefs.yaml#/components/schemas/Tac" - PLMNContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for PLMNContext - type: object - properties: - contextAttribute: - type: string - enum: - - PLMN - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/PlmnId' - DlFrequencyContext: - description: >- - This data type is the "Context" data type with specialisations for Object context "DLFrequencyContext". It describes the downlink frequency information (RF reference - frequencies and/ or the frequency operating band) supported by the RAN SubNetwork that the intent expectation is applied. - type: object - properties: - contextAttribute: - type: string - enum: - - DlFrequency - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Frequency' - UlFrequencyContext: - description: >- - This data type is the "Context" data type with specialisations for Object context "ULFrequencyContext".It describes the uplink frequency information (RF reference - frequencies and/ or the frequency operating band) supported by the RAN SubNetwork that the intent expectation is applied. - type: object - properties: - contextAttribute: - type: string - enum: - - UlFrequency - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Frequency' - RATContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for RATContext.It describes the RAT supported by the RAN SubNetwork that the intent expectation - is applied. - type: object - properties: - contextAttribute: - type: string - enum: - - RAT - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - type: string - enum: - - 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 - uniqueItems: true - items: - $ref: "TS28312_IntentNrm.yaml#/components/schemas/UEGroup" - EdgeIdentificationIdContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for EdgeIdentificationIdContext - type: object - properties: - contextAttribute: - type: string - enum: - - edgeIdentificationId - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - type: string - EdgeIdentificationLocContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for EdgeIdentificationLocContext - type: object - properties: - contextAttribute: - type: string - enum: - - edgeIdentificationTarget - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoCoordinate' - CoverageAreaTAContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for CoverageAreaTAContext - type: object - properties: - contextAttribute: - type: string - enum: - - coverageAreaTA - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - $ref: "TS28623_ComDefs.yaml#/components/schemas/Tac" - 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 - uniqueItems: true - items: - $ref: "TS28541_5GcNrm.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 - uniqueItems: true - 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 - uniqueItems: true - items: - $ref: "TS28623_GenericNrm.yaml#/components/schemas/Tai" - ServingScopeContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for ServingScopeContext - type: object - properties: - contextAttribute: - type: string - enum: - - ServingScope - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - type: string - DnnContext: - description: >- - This data type is the "ObjectContext" data type with specialisations for DnnContext - type: object - properties: - contextAttribute: - type: string - enum: - - Dnn - contextCondition: - type: string - enum: - - IS_ALL_OF - contextValueRange: - type: array - uniqueItems: true - items: - type: string - #-------Definition of the scenario specific ObjectTarget dataType----------------# - - #-------Definition of the concrete ExpectationContext dataType----------------# - - TargetAssuranceTimeContext: - description: >- - This data type is the "Expectation Context" data type with specialisations for TargetAssuranceTimeContext.It describes the timeWindows - (including startTime, endTime) when the targets in the Intent Expectation need to be assured. - type: object - properties: - contextAttribute: - type: string - enum: - - TargetAssuranceTime - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow' - - ServiceStartTimeContext: - description: >- - This data type is the "ExpectationContext" data type with specialisations for ServiceStartTimeContext - type: object - properties: - contextAttribute: - type: string - enum: - - ServiceStartTime - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' - ServiceEndTimeContext: - description: >- - This data type is the "ExpectationContext" data type with specialisations for ServiceEndTimeContext - type: object - properties: - contextAttribute: - type: string - enum: - - ServiceEndTime - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' - UEMobilityLevelContext: - description: >- - This data type is the "ExpectationContext" data type with specialisations for UEMobilityLevelContext - type: object - properties: - contextAttribute: - type: string - enum: - - UEMobilityLevel - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - $ref: "TS28541_SliceNrm.yaml#/components/schemas/MobilityLevel" - ResourceSharingLevelContext: - description: >- - This data type is the "ExpectationContext" data type with specialisations for ResourceSharingLevelContext - type: object - properties: - contextAttribute: - type: string - enum: - - ResourceSharingLevel - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - $ref: "TS28541_SliceNrm.yaml#/components/schemas/SharingLevel" - ServiceTypeContext: - description: >- - This data type is the "ExpectationContext" data type with specialisations for ServiceTypeContext.It describes - the service type for the Radio Service that the intent expectation is applied. For details see sST in clause 6.4.1 in TS 28.541 [5] - type: object - properties: - contextAttribute: - type: string - enum: - - ServiceType - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - $ref: "TS28541_NrNrm.yaml#/components/schemas/Sst" - StartTimeContext: - description: >- - This data type is the "ExpectationContext" data type with specialisations for StartTimeContext - type: object - properties: - contextAttribute: - type: string - enum: - - StartTime - contextCondition: - type: string - enum: - - IS_EQUAL_TO - contextValueRange: - $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' - #-------Definition of the concrete ExpectionContext dataType----------------# +openapi: 3.0.1 +info: + title: Scenario specific Intent Expectations + version: 19.0.0 + description: >- + OAS 3.0.1 definition of scenario specific Intent Expectations + © 2024, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC). + All rights reserved. +externalDocs: + description: 3GPP TS 28.312; Intent driven management services for mobile networks + url: http://www.3gpp.org/ftp/Specs/archive/28_series/28.312/ +paths: {} +components: + schemas: + + #-------Definition of the Scenario specific IntentExpectation dataType ----------# + RadioNetworkExpectation: + description: >- + This data type is the "IntentExpectation" data type with specialisations to represent MnS consumer's expectations for radio network delivering and performance assurance + type: object + properties: + expectationId: + type: string + expectationVerb: + $ref: "TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb" + expectationObject: + $ref: "#/components/schemas/RadioNetworkExpectationObject" + expectationTargets: + type: array + uniqueItems: true + 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/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 + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/TargetAssuranceTimeContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' + required: + - expectationId + RadioServiceExpectation: + description: >- + This data type is the "IntentExpectation" data type with specialisations to represent MnS consumer's expectations for radio service delivering + type: object + properties: + expectationId: + type: string + expectationVerb: + $ref: "TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb" + expectationObject: + $ref: "#/components/schemas/RadioServiceExpectationObject" + expectationTargets: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/DLLatencyTarget' + - $ref: '#/components/schemas/ULLatencyTarget' + - $ref: '#/components/schemas/DLThptPerUETarget' + - $ref: '#/components/schemas/ULThptPerUETarget' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget' + expectationContexts: + type: array + uniqueItems: true + items: + $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' + required: + - expectationId + 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/EdgeServiceSupportExpectationObject' + expectationTargets: + type: array + uniqueItems: true + 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 + uniqueItems: true + 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/Context' + 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 + expectationVerb: + $ref: "TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb" + expectationObjects: + type: array + uniqueItems: true + items: + $ref: "#/components/schemas/5GCNetworkExpectationObject" + expectationTargets: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: "#/components/schemas/MaxNumberofPDUsessionsTarget" + - $ref: "#/components/schemas/MaxNumberofRegisteredsubscribersTarget" + - $ref: "#/components/schemas/IncomingDataTarget" + - $ref: "#/components/schemas/OutgoingDataTarget" + - $ref: "TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget" + expectationContexts: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/StartTimeContext' + - $ref: '#/components/schemas/ResourceSharingLevelContext' + - $ref: "TS28312_IntentNrm.yaml#/components/schemas/Context" + required: + - expectationId + NetworkMaintenanceExpectation: + description: >- + This data type is the "IntentExpectation" data type with specialisations to represent MnS consumer's expectations for Network Maintenance + type: object + properties: + expectationId: + type: string + expectationVerb: + $ref: "TS28312_IntentNrm.yaml#/components/schemas/ExpectationVerb" + expectationObjects: + type: array + uniqueItems: true + items: + $ref: "#/components/schemas/NetworkMaintenanceExpectationObject" + expectationTargets: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/MaintenanceVersionTarget' + - $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: "#/components/schemas/MaxNumberofPDUsessionsTarget" + - $ref: "#/components/schemas/MaxNumberofRegisteredsubscribersTarget" + - $ref: "#/components/schemas/IncomingDataTarget" + - $ref: "#/components/schemas/OutgoingDataTarget" + - $ref: "TS28312_IntentNrm.yaml#/components/schemas/ExpectationTarget" + expectationContexts: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/MaintenanceTimeContext' + - $ref: "TS28312_IntentNrm.yaml#/components/schemas/Context" + required: + - expectationId + #-------Definition of the IntentExpectation dataType ----------# + + #-------Definition of the scenario specific ExpectationObject dataType ----------# + RadioNetworkExpectationObject: + description: >- + This data type is the "ExpectationObject" data type with specialisations for RadioNetworkExpectation + type: object + properties: + objectType: + type: string + enum: + - RAN_SubNetwork + objectInstance: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' + objectContexts: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/CoverageAreaPolygonContext' + - $ref: '#/components/schemas/CoverageTACContext' + - $ref: '#/components/schemas/PLMNContext' + - $ref: '#/components/schemas/DlFrequencyContext' + - $ref: '#/components/schemas/UlFrequencyContext' + - $ref: '#/components/schemas/RATContext' + - $ref: "#/components/schemas/UEGroupContext" + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' + RadioServiceExpectationObject: + description: >- + This data type is the "ExpectationObject" data type with specialisations for RadioServicekExpectation + type: object + properties: + objectType: + type: string + enum: + - Radio_Service + objectInstance: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' + objectContexts: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/CoverageAreaPolygonContext' + - $ref: '#/components/schemas/ServiceTypeContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' + EdgeServiceSupportExpectationObject: + description: >- + This data type is the "ExpectationObject" data type with specialisations for EdgeServiceSupportExpectation + type: object + properties: + objectType: + type: string + enum: + - EdgeService_Support #value for Edge Service Support Expectation--# + objectInstance: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' + objectContexts: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: '#/components/schemas/EdgeIdentificationIdContext' + - $ref: '#/components/schemas/EdgeIdentificationLocContext' + - $ref: '#/components/schemas/CoverageAreaTAContext' + - $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Context' + 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: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: "#/components/schemas/NfTypeContext" + - $ref: "#/components/schemas/NfInstanceLocationContext" + - $ref: "#/components/schemas/PLMNContext" + - $ref: "#/components/schemas/TaiContext" + - $ref: "#/components/schemas/ServingScopeContext" + - $ref: "#/components/schemas/DnnContext" + - $ref: "TS28312_IntentNrm.yaml#/components/schemas/Context" + NetworkMaintenanceExpectationObject: + description: >- + This data type is the "ExpectationObject" data type with specialisations for NetworkMaintenanceExpectation + type: object + properties: + objectType: + type: string + enum: + - SubNetwork #value for Network Maintenance Expectation--# + objectInstance: + $ref: "TS28623_ComDefs.yaml#/components/schemas/Dn" + objectContexts: + type: array + uniqueItems: true + items: + type: object + oneOf: + - $ref: "#/components/schemas/MaintenanceGuidelinesContext" + - $ref: "#/components/schemas/NfTypeContext" + - $ref: "#/components/schemas/NfInstanceLocationContext" + - $ref: "#/components/schemas/PLMNContext" + - $ref: "#/components/schemas/TaiContext" + - $ref: "#/components/schemas/ServingScopeContext" + - $ref: "#/components/schemas/DnnContext" + - $ref: '#/components/schemas/CoverageAreaPolygonContext' + - $ref: '#/components/schemas/CoverageTACContext' + - $ref: '#/components/schemas/PLMNContext' + - $ref: '#/components/schemas/DlFrequencyContext' + - $ref: '#/components/schemas/UlFrequencyContext' + - $ref: '#/components/schemas/RATContext' + - $ref: "#/components/schemas/UEGroupContext" + - $ref: "TS28312_IntentNrm.yaml#/components/schemas/Context" + #-------Definition of the ExpectationObject dataType ----------# + + + #-------Definition of the Scenario specific ExpectationTarget dataType----------# + WeakRSRPRatioTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for WeakRSRPRatioTarget. It describes + the downlink weak coverage ratio target for the RAN SubNetwork that the intent expectation is applied. + The numerator is the number of the cells with downlink weak RSRP, and the denominator is the total number + of cells of the RAN Subnetwork in the specified area. + type: object + properties: + targetName: + type: string + enum: + - WeakRSRPRatio + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + minimum: 0 + maximum: 100 + targetContexts: + $ref: '#/components/schemas/WeakRSRPContext' + WeakRSRPContext: + description: >- + This data type is the "TargetContext" data type with specialisations for WeakRSRPContext. It describes the threshold + for downlink weak RSRP of the cells (see RSRP measurements in TS 28.552 [6]) of the RAN SubNetwork that the intent + expectation is applied. + type: object + properties: + contextAttribute: + type: string + enum: + - WeakRSRPThreshold + contextCondition: + type: string + enum: + - IS_LESS_THAN + contextValueRange: + type: number + LowSINRRatioTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for LowSINRatioTarget.It describes the low SINR + ratio target for the RAN SubNetwork that the intent expectation is applied. The numerator is the number of the cells with + low SINR, and the denominator is the total number of cells of the RAN Subnetwork in the specified area. + type: object + properties: + targetName: + type: string + enum: + - LowSINRRatio + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + minimum: 0 + maximum: 100 + targetContexts: + $ref: '#/components/schemas/LowSINRContext' + LowSINRContext: + description: >- + This data type is the "TargetContext" data type with specialisations for LowSINRContext.It describes the threshold for + low SINR of the cells (see SINR measurements in TS 28.552 [6]) of the RAN SubNetwork that the intent expectation is applied. + type: object + properties: + contextAttribute: + type: string + enum: + - LowSINRThreshold + contextCondition: + type: string + enum: + - IS_LESS_THAN + contextValueRange: + type: integer + AveULRANUEThptTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for AveULRANUEThptTarget.It describes the average + UL RAN UE throughput target for RAN SubNetwork (see UL RAN UE throughput for a sub-network in TS 28.554[11]) that the intent + expectation is applied. + type: object + properties: + targetName: + type: string + enum: + - AveULRANUEThpt + targetCondition: + type: string + enum: + - IS_GREATER_THAN + targetValueRange: + type: integer + AveDLRANUEThptTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for AveDLRANUEThptTarget.It describes the average + DL RAN UE throughput target for RAN SubNetwork (see DL RAN UE throughput for a sub-network in TS 28.554[11]) that the intent + expectation is applied. + type: object + properties: + targetName: + type: string + enum: + - AveDLRANUEThpt + targetCondition: + type: string + enum: + - IS_GREATER_THAN + targetValueRange: + type: integer + LowULRANUEThptRatioTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for LowULRANUEThptRatioTarget.It describes the low + UL RAN UE throughput ratio target for the RAN SubNetwork that the intent expectation is applied. The numerator is the number + of the cells with low UL RAN UE throughput, and the denominator is the total number of cells of the RAN Subnetwork in the + specified area. + type: object + properties: + targetName: + type: string + enum: + - LowULRANUEThptRatio + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + minimum: 0 + maximum: 100 + targetContexts: + $ref: '#/components/schemas/LowULRANUEThptContext' + LowULRANUEThptContext: + description: >- + This data type is the "TargetContext" data type with specialisations for LowULRANUEThptContext.It describes the threshold + for the low UL RAN UE throughput cells (see average UL RAN UE throughput in gNB and distribution of UL UE throughput in gNB + in TS 28.552[6]) of the RAN SubNetwork that the intent expectation is applied. + type: object + properties: + contextAttribute: + type: string + enum: + - LowULRANUEThptThreshold + contextCondition: + type: string + enum: + - Is_less_than + contextValueRange: + type: number + LowDLRANUEThptRatioTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for LowDLRANUEThptRatioTarget. It describes + the low DL RAN UE throughput ratio target for the RAN SubNetwork that the intent expectation is applied.The numerator + is the number of the cells with low DL RAN UE throughput, and the denominator is the total number of cells of the + RAN Subnetwork in the specified area. + type: object + properties: + targetName: + type: string + enum: + - LowDLRANUEThptRatio + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + minimum: 0 + maximum: 100 + targetContexts: + $ref: '#/components/schemas/LowDLRANUEThptContext' + LowDLRANUEThptContext: + description: >- + This data type is the "TargetContext" data type with specialisations for LowDLRANUEThptContext.It describes the threshold + for the low DL RAN UE throughput cells ((see average DL RAN UE throughput in gNB and distribution of DL UE throughput in gNB + in TS 28.552[6]) ) of the RAN SubNetwork that the intent expectation is applied. + type: object + properties: + contextAttribute: + type: string + enum: + - LowDLRANUEThptThreshold + contextCondition: + type: string + enum: + - IS_LESS_THAN + contextValueRange: + type: number + HighULPrbLoadRatioTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for HighULPrbLoadRatioTarget. It describes the high UL + PRB load ratio target (as percentage) for the RAN SubNetwork that the intent expectation is applied. The numerator is the number + of the cells with high UL PRB load, and the denominator is the total number of cells of the RAN Subnetwork in the specified area. + 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.It describes the threshold for high + uplink PRB load (i.e. UL Total PRB Usage in TS 28.552 [12] to represent the percentage of UL PRBs used) of the cells of the RAN + SubNetwork in the specified area that the intent expectation is applied. + 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.It describes the high DL PRB + load ratio target (as percentage) for the RAN SubNetwork that the intent expectation is applied. The numerator is the number of the + cells with high DL PRB load, and the denominator is the total number of cells of the RAN Subnetwork in the specified area. + 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.It describes the threshold for high downlink + PRB load (i.e. DL Total PRB Usage in TS 28.552 [12] to represent the percentage of DL PRBs used) of the cells of the RAN SubNetwork in the + specified area that the intent expectation is applied. + 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.It describes the average uplink PRB load target + (i.e. UL Total PRB Usage in TS 28.552 [12] to represent the percentage of UL PRBs used) of the cells of the RAN SubNetwork that the intent + expectation is applied. + 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.It describes the average dowlink PRB load + (i.e. DL Total PRB Usage in TS 28.552 [12] to represent the percentage of DL PRBs used) target for RAN SubNetwork that the intent expectation + is applied. + 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.It describes the RAN energy consumption + target for RAN SubNetwork that the intent expectation is applied. The definition for RAN energy consumption see ECNG-RAN in clause 6.7.3.4.1 in + TS 28.554 [11]. + 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.It describes the RAN energy efficiency target + for RAN SubNetwork that the intent expectation is applied. The unit of this target is bit/J. The definition for RAN energy efficiency target for RAN + SubNetwork see EEMN,DV in clause 6.7.1.1 in TS 28.554 [11]. + 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. It describes the DL throughput target by the per UE for the + edge service supporting or radio servicde that the intent expectation is applied. For details see dlThptPerUE defined in clause 6.3.1 of TS 28.541 [5]. + type: object + properties: + targetName: + type: string + enum: + - DlThptPerUE + targetCondition: + type: string + enum: + - IS_GREATER_THAN + targetValueRange: + $ref: 'TS28541_SliceNrm.yaml#/components/schemas/XLThpt' + ULThptPerUETarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for ULThptPerUETarget.It describes the UL throughput target by the per UE for the edge + service supporting or radio service that the intent expectation is applied. For details see ulThptPerUE defined in clause 6.3.1 of TS 28.541 [5]. + type: object + properties: + targetName: + type: string + enum: + - UlThptPerUE + targetCondition: + type: string + enum: + - IS_GREATER_THAN + targetValueRange: + $ref: 'TS28541_SliceNrm.yaml#/components/schemas/XLThpt' + DLLatencyTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for DLLatencyTarget.It describes the DL latency target for the edge service supporting or radio service + that the intent expectation is applied + type: object + properties: + targetName: + type: string + enum: + - DlLatency + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + ULLatencyTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for ULLatencyTarget. It describes the UL latency target for the edge service supporting or radioService + that the intent expectation is applied. For details see attribute ulLatency defined in clause 6.3.1 of TS 28.541 [5] + type: object + properties: + targetName: + type: string + enum: + - UlLatency + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + MaxNumberofUEsTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for MaxNumberofUEsTarget.It describes the the number of UEs for edge service supporting + that the intent expectation is applied. For details see attribute maxNumberofUE defined in clause 6.3.1 of of TS 28.541 [5] + type: object + properties: + targetName: + type: string + enum: + - maxNumberofUEs + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + ActivityFactorTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for ActivityFactorTarget.It describes the percentage value of the amount of simultaneous + active UEs to the total number of UEs where active means the UEs are exchanging data with the edge service supporting that the intent expectation is applied. + For details see activityFactor in clause 6.3.1 in TS 28.541 [5]. + type: object + properties: + targetName: + type: string + enum: + - activityFactor + targetCondition: + type: string + enum: + - IS_EQUAL_TO + targetValueRange: + type: integer + UESpeedTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for UESpeedTarget.It describes the speed (in km/hour) supported for edge service supporting + that the intent expectation is applied. For details see uESpeed in clause 6.3.1 in TS 28.541[5]. + type: object + properties: + targetName: + type: string + enum: + - uESpeed + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + MaxNumberofPDUsessionsTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for MaxNumberofPDUsessionsTarget.It describes the maximum number of PDU sessions for 5GC + SubNetwork supporting that the intent expectation is applied. For details, see maxNumberofPDUsessions in clause 5.3.1.2 in TS 28.552 [12]. + type: object + properties: + targetName: + type: string + enum: + - MaxNumberofPDUsessions + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + targetContexts: + $ref: '#/components/schemas/5GSessionContext' + 5GSessionContext: + description: >- + This data type is the "TargetContext" data type with specialisations for 5GSessionContext.It describes the maximum supported 5G PDU session of the 5GC SubNetwork + related to the intent expectation. + type: object + properties: + contextAttribute: + type: string + enum: + - 5GSession + contextCondition: + type: string + enum: + - IS_less_THAN + contextValueRange: + type: integer + MaxNumberofRegisteredsubscribersTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for MaxNumberofRegisteredsubscribersTarget.It describes the maximum number of Registered + subscribers for 5GC SubNetwork supporting that the intent expectation is applied. For details, see maxNumberofRegisteredsubscribers in clause 5.6.2 in TS 28.552 [12]. + type: object + properties: + targetName: + type: string + enum: + - MaxNumberofRegisteredsubscribers + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + IncomingDataTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for IncomingDataTarget.It describes the maximum incoming data packets for 5GC SubNetwork + related to the intent expectation. For details, see N6 incoming link usage measurement in clause 5.4.2.1 in TS 28.552 [12]. + type: object + properties: + targetName: + type: string + enum: + - IncomingData + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + OutgoingDataTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for OutgoingDataTarget.It describes the maximum outgoing data packets for 5GC SubNetwork + related to the intent expectation. For details, see N6 outgoing link usage measurement in clause 5.4.2.2 in TS 28.552 [12]. + type: object + properties: + targetName: + type: string + enum: + - OutgoingData + targetCondition: + type: string + enum: + - IS_LESS_THAN + targetValueRange: + type: integer + MaintenanceVersionTarget: + description: >- + This data type is the "ExpectationTarget" data type with specialisations for Maintenance Version Target. It describes the maintenance version target for the network maintenance, such as target version of the maintenance object after maintenance. + type: object + properties: + targetName: + type: string + enum: + - MaintenanceVersion + targetCondition: + type: string + enum: + - IS_EQUAL_TO + targetValueRange: + type: string + + #-------Definition of the concrete ExpectationTarget dataType----------# + + #-------Definition of the concrete ObjectTarget dataType----------------# + CoverageAreaPolygonContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for CoverageAreaPolygonContext.It describes the coverage areas for the RAN SubNetwork that the + intent expectation is applied in the form of polygon. + type: object + properties: + contextAttribute: + type: string + enum: + - CoverageAreaPolygon + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoArea' + CoverageTACContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for CoverageTACContext.It describes the coverage areas for the RAN SubNetwork that the intent + expectation is applied in the form of TAC. + type: object + properties: + contextAttribute: + type: string + enum: + - CoverageAreaTac + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + $ref: "TS28623_ComDefs.yaml#/components/schemas/Tac" + PLMNContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for PLMNContext + type: object + properties: + contextAttribute: + type: string + enum: + - PLMN + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/PlmnId' + DlFrequencyContext: + description: >- + This data type is the "Context" data type with specialisations for Object context "DLFrequencyContext". It describes the downlink frequency information (RF reference + frequencies and/ or the frequency operating band) supported by the RAN SubNetwork that the intent expectation is applied. + type: object + properties: + contextAttribute: + type: string + enum: + - DlFrequency + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Frequency' + UlFrequencyContext: + description: >- + This data type is the "Context" data type with specialisations for Object context "ULFrequencyContext".It describes the uplink frequency information (RF reference + frequencies and/ or the frequency operating band) supported by the RAN SubNetwork that the intent expectation is applied. + type: object + properties: + contextAttribute: + type: string + enum: + - UlFrequency + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + $ref: 'TS28312_IntentNrm.yaml#/components/schemas/Frequency' + RATContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for RATContext.It describes the RAT supported by the RAN SubNetwork that the intent expectation + is applied. + type: object + properties: + contextAttribute: + type: string + enum: + - RAT + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + type: string + enum: + - 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 + uniqueItems: true + items: + $ref: "TS28312_IntentNrm.yaml#/components/schemas/UEGroup" + EdgeIdentificationIdContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for EdgeIdentificationIdContext + type: object + properties: + contextAttribute: + type: string + enum: + - edgeIdentificationId + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + type: string + EdgeIdentificationLocContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for EdgeIdentificationLocContext + type: object + properties: + contextAttribute: + type: string + enum: + - edgeIdentificationTarget + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/GeoCoordinate' + CoverageAreaTAContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for CoverageAreaTAContext + type: object + properties: + contextAttribute: + type: string + enum: + - coverageAreaTA + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + $ref: "TS28623_ComDefs.yaml#/components/schemas/Tac" + 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 + uniqueItems: true + items: + $ref: "TS28541_5GcNrm.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 + uniqueItems: true + 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 + uniqueItems: true + items: + $ref: "TS28623_GenericNrm.yaml#/components/schemas/Tai" + ServingScopeContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for ServingScopeContext + type: object + properties: + contextAttribute: + type: string + enum: + - ServingScope + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + type: string + DnnContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for DnnContext + type: object + properties: + contextAttribute: + type: string + enum: + - Dnn + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + uniqueItems: true + items: + type: string + MaintenanceGuidelinesContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for MaintenanceGuidelinesContext. It describes the guidelines for the network maintenance task of a managed object. + type: object + properties: + contextAttribute: + type: string + enum: + - MaintenanceGuidelines + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + items: + type: string + #-------Definition of the scenario specific ObjectTarget dataType----------------# + + #-------Definition of the concrete ExpectationContext dataType----------------# + + TargetAssuranceTimeContext: + description: >- + This data type is the "Expectation Context" data type with specialisations for TargetAssuranceTimeContext.It describes the timeWindows + (including startTime, endTime) when the targets in the Intent Expectation need to be assured. + type: object + properties: + contextAttribute: + type: string + enum: + - TargetAssuranceTime + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow' + + ServiceStartTimeContext: + description: >- + This data type is the "ExpectationContext" data type with specialisations for ServiceStartTimeContext + type: object + properties: + contextAttribute: + type: string + enum: + - ServiceStartTime + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' + ServiceEndTimeContext: + description: >- + This data type is the "ExpectationContext" data type with specialisations for ServiceEndTimeContext + type: object + properties: + contextAttribute: + type: string + enum: + - ServiceEndTime + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' + UEMobilityLevelContext: + description: >- + This data type is the "ExpectationContext" data type with specialisations for UEMobilityLevelContext + type: object + properties: + contextAttribute: + type: string + enum: + - UEMobilityLevel + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + $ref: "TS28541_SliceNrm.yaml#/components/schemas/MobilityLevel" + ResourceSharingLevelContext: + description: >- + This data type is the "ExpectationContext" data type with specialisations for ResourceSharingLevelContext + type: object + properties: + contextAttribute: + type: string + enum: + - ResourceSharingLevel + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + $ref: "TS28541_SliceNrm.yaml#/components/schemas/SharingLevel" + ServiceTypeContext: + description: >- + This data type is the "ExpectationContext" data type with specialisations for ServiceTypeContext.It describes + the service type for the Radio Service that the intent expectation is applied. For details see sST in clause 6.4.1 in TS 28.541 [5] + type: object + properties: + contextAttribute: + type: string + enum: + - ServiceType + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + $ref: "TS28541_NrNrm.yaml#/components/schemas/Sst" + StartTimeContext: + description: >- + This data type is the "ExpectationContext" data type with specialisations for StartTimeContext + type: object + properties: + contextAttribute: + type: string + enum: + - StartTime + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/DateTime' + MaintenanceTimeContext: + description: >- + This data type is the "ExpectationContext" data type with specialisations for MaintenanceTimeContext + type: object + properties: + contextAttribute: + type: string + enum: + - MaintenanceTime + contextCondition: + type: string + enum: + - IS_EQUAL_TO + contextValueRange: + $ref: 'TS28623_ComDefs.yaml#/components/schemas/TimeWindow' + #-------Definition of the concrete ExpectionContext dataType----------------# -- GitLab From b9c2f323e8ce8aff61cf676b4a416cf046f10309 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Refik=20Fatih=20=C3=9Cstok?= Date: Fri, 7 Feb 2025 15:13:34 +0000 Subject: [PATCH 3/5] Replace new TS28312_IntentNrm.yaml -- GitLab From 37c7e7fbc4ce730e1bf534d196043162cdfe3d29 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Refik=20Fatih=20=C3=9Cstok?= Date: Fri, 7 Feb 2025 15:16:16 +0000 Subject: [PATCH 4/5] Update TS28312_IntentNrm.yaml --- OpenAPI/TS28312_IntentNrm.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/OpenAPI/TS28312_IntentNrm.yaml b/OpenAPI/TS28312_IntentNrm.yaml index a3f06c067..1f14f7684 100644 --- a/OpenAPI/TS28312_IntentNrm.yaml +++ b/OpenAPI/TS28312_IntentNrm.yaml @@ -161,7 +161,7 @@ components: - EDGE_SERVICE_SUPPORT #value for Edge Service Support Expectation--# - 5GC_SUBNETWORK #value for 5GC Network Expectation--# - Radio_Service #value for Radio Service Expectation--# - - SUBNETWORK #value for Network Maintenance Expectation--# + - SUBNETWORK #value for Network Maintenance Expectation--# objectInstance: $ref: 'TS28623_ComDefs.yaml#/components/schemas/Dn' objectContexts: -- GitLab From cb5393a4b86ac7fac2a3ba80f2c17cbaa26e8487 Mon Sep 17 00:00:00 2001 From: ruiyue Date: Thu, 20 Feb 2025 07:46:50 +0000 Subject: [PATCH 5/5] Update file TS28312_IntentExpectations.yaml --- OpenAPI/TS28312_IntentExpectations.yaml | 31 ++++++++++++++++++------- 1 file changed, 22 insertions(+), 9 deletions(-) diff --git a/OpenAPI/TS28312_IntentExpectations.yaml b/OpenAPI/TS28312_IntentExpectations.yaml index 8335063e5..0fc82aeab 100644 --- a/OpenAPI/TS28312_IntentExpectations.yaml +++ b/OpenAPI/TS28312_IntentExpectations.yaml @@ -303,10 +303,6 @@ components: This data type is the "ExpectationObject" data type with specialisations for NetworkMaintenanceExpectation type: object properties: - objectType: - type: string - enum: - - SubNetwork #value for Network Maintenance Expectation--# objectInstance: $ref: "TS28623_ComDefs.yaml#/components/schemas/Dn" objectContexts: @@ -315,7 +311,8 @@ components: items: type: object oneOf: - - $ref: "#/components/schemas/MaintenanceGuidelinesContext" + - $ref: "#/components/schemas/MaintenanceVersionContext" + - $ref: "#/components/schemas/MaintenanceOrderContext" - $ref: "#/components/schemas/NfTypeContext" - $ref: "#/components/schemas/NfInstanceLocationContext" - $ref: "#/components/schemas/PLMNContext" @@ -328,7 +325,6 @@ components: - $ref: '#/components/schemas/DlFrequencyContext' - $ref: '#/components/schemas/UlFrequencyContext' - $ref: '#/components/schemas/RATContext' - - $ref: "#/components/schemas/UEGroupContext" - $ref: "TS28312_IntentNrm.yaml#/components/schemas/Context" #-------Definition of the ExpectationObject dataType ----------# @@ -1158,15 +1154,15 @@ components: uniqueItems: true items: type: string - MaintenanceGuidelinesContext: + MaintenanceVersionContext: description: >- - This data type is the "ObjectContext" data type with specialisations for MaintenanceGuidelinesContext. It describes the guidelines for the network maintenance task of a managed object. + This data type is the "ObjectContext" data type with specialisations for MaintenanceVersionContext. It describes the versions for the network maintenance task of a managed object. type: object properties: contextAttribute: type: string enum: - - MaintenanceGuidelines + - swVersion contextCondition: type: string enum: @@ -1175,6 +1171,23 @@ components: type: array items: type: string + MaintenanceOrderContext: + description: >- + This data type is the "ObjectContext" data type with specialisations for MaintenanceOrderContext. It describes the list of DNs of NFs/NEs based on the orders for the network maintenance. + type: object + properties: + contextAttribute: + type: string + enum: + - maintenanceOrder + contextCondition: + type: string + enum: + - IS_ALL_OF + contextValueRange: + type: array + items: + type: string #-------Definition of the scenario specific ObjectTarget dataType----------------# #-------Definition of the concrete ExpectationContext dataType----------------# -- GitLab