Update a Converged Charging Session
{apiRoot}/nchf-convergedcharging/v2/chargingdata/{ChargingDataRef}/update
You may need to reserve additional units for an existing Nchf converged charging session when:
- The granted service unit for one rating group is spent. For example, when a subscriber uses the last of their 2 GB of data per month during an online web session.
- The validity period expires for the granted service. For example, a telephone call starts at 11:45am using a grant of free minutes that expires at noon. In this case, an update request would be required just before noon.
- Service events occur that might affect the rating of the current service. For example, when the QoS increases or decreases during a session.
Request
-
ChargingDataRef(required): string
A unique identifier for a charging data resource in a Public Land Mobile Network (PLMN).
- application/json
object
-
invocationSequenceNumber(required): integer
(int32)
Minimum Value:
0
The sequence number for the charging service invocation by the NF consumer. -
invocationTimeStamp(required): string
(date-time)
The timestamp for when the request was sent.
-
locationReportingChargingInformation: object
LocationReportingChargingInformation
The 5G N2 connection-specific information.
-
mnSConsumerIdentifier: string
The ID of the Management Server (MnS) consumer.
-
multipleUnitUsage: array
multipleUnitUsage
Minimum Number of Items:
0
The parameters for the quota management request or usage report. -
n2ConnectionChargingInformation: object
N2ConnectionChargingInformation
Information about a 5G N2 charging connection.
-
nEFChargingInformation: object
NEFChargingInformation
Exposure Function Northbound API-specific information.
-
nfConsumerIdentification(required): object
NFIdentification
A grouped field that contains a set of information identifying the NF consumer of the charging service.
-
notifyUri: string
The recipient of notifications sent by the CHF, such as http://test-notification-url. For session-based charging, this parameter is required for create requests and optional for update requests.
-
nSMChargingInformation: object
NSMChargingInformation
The Network Slice Management (NSM)-specific information.
-
nSPAChargingInformation: object
NSPAChargingInformation
The network slice information, which is reported to the CHF.
-
oneTimeEvent: boolean
Whether this uses event-based charging for a one-time event (true) or to expect an update and ending request (false).
-
oneTimeEventType: string
Allowed Values:
[ "IEC", "PEC" ]
The type of one-time event, such as immediate (IEC) or post-event charging (PEC). -
pDUSessionChargingInformation: object
PDUSessionChargingInformation
The 5G data connectivity-specific information.
-
registrationChargingInformation: object
RegistrationChargingInformation
The 5G registration-specific information.
-
retransmissionIndicator: boolean
Whether this is a retransmitted request message (true) or not (false).
-
roamingQBCInformation: object
RoamingQBCInformation
The 5G data connectivity-specific information for roaming QBC.
-
serviceSpecificationInfo: string
The technical specification for the service, such as TS 32.255, and release version, such as Release 16, that applies to the request.
-
sMSChargingInformation: object
SMSChargingInformation
SMS-specific information.
-
subscriberIdentifier: string
Pattern:
^(imsi-[0-9]{5,15}|nai-.+|.+)$
The unique identifier for the subscriber that uses the requested service. The ID is either a SUPI or an IMSI. -
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$
The list of supported features. -
tenantIdentifier: string
The ID of the tenant.
-
triggers: array
triggers
Minimum Number of Items:
0
The triggers for usage reporting associated to the rating group, which is supplied from the CHF.The presence of the triggers attribute without any triggerType is used by CHF to disable all of the triggers to the associated rating group.
object
-
locationReportingMessageType(required): integer
-
presenceReportingAreaInformation: object
presenceReportingAreaInformation
Minimum Number of Properties:
0
Additional Properties Allowed: PresenceInfo -
rATType:
-
uetimeZone: string
-
userInformation: object
UserInformation
-
userLocationinfo: object
UserLocation
array
0
object
-
allowedNSSAI: array
allowedNSSAI
Minimum Number of Items:
0
-
amfUeNgapId: integer
The UE association over the N2 interface within the AMF.
-
forbiddenAreaList: array
forbiddenAreaList
Minimum Number of Items:
0
-
n2ConnectionMessageType(required): integer
-
ranNodeId: object
GlobalRanNodeId
-
ranUeNgapId: integer
The RAN UE NGAP ID over the N2 interface.
-
rATType:
-
restrictedCnList: array
restrictedCnList
Minimum Number of Items:
0
-
restrictedRatList: array
restrictedRatList
Minimum Number of Items:
0
-
rrcEstCause: string
Pattern:
^[0-9a-fA-F]+$
-
serviceAreaRestriction: array
serviceAreaRestriction
Minimum Number of Items:
0
-
uetimeZone: string
-
userInformation: object
UserInformation
-
userLocationinfo: object
UserLocation
object
-
aPIContent: string
-
aPIDirection: string
Allowed Values:
[ "INVOCATION", "NOTIFICATION" ]
-
aPIName(required): string
-
aPIReference: string
-
aPIResultCode: integer
(int32)
Minimum Value:
0
-
aPITargetNetworkFunction: object
NFIdentification
A grouped field that contains a set of information identifying the NF consumer of the charging service.
-
groupIdentifier: string
Pattern:
^[A-Fa-f0-9]{8}-[0-9]{3}-[0-9]{2,3}-([A-Fa-f0-9][A-Fa-f0-9]){1,10}$
object
-
nFFqdn: string
-
nFIPv4Address: string
Pattern:
^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$
Example:198.51.100.1
-
nFIPv6Address: string
Ipv6Addr
-
nFName: string
(uuid)
-
nFPLMNID: object
PlmnId
-
nodeFunctionality(required): string
Allowed Values:
[ "AMF", "SMF", "SMSF", "SGW", "I_SMF", "ePDG", "CEF" ]
object
-
idNetworkSliceInstance: string
-
listOfserviceProfileChargingInformation: array
listOfserviceProfileChargingInformation
Minimum Number of Items:
0
-
managementOperation(required): string
Allowed Values:
[ "CreateMOI", "ModifyMOIAttributes", "DeleteMOI" ]
-
managementOperationStatus: string
Allowed Values:
[ "OPERATION_SUCCEEDED", "OPERATION_FAILED" ]
object
-
singleNSSAI: object
Snssai
The S-NSSAIs of the NF.
object
-
chargingId: integer
(int32)
Minimum Value:
0
-
homeProvidedChargingId: integer
(int32)
Minimum Value:
0
-
mAPDUNon3GPPUserLocationInfo: object
UserLocation
-
pduSessionInformation: object
PDUSessionInformation
-
presenceReportingAreaInformation: object
presenceReportingAreaInformation
Minimum Number of Properties:
0
Additional Properties Allowed: PresenceInfo -
rANSecondaryRATUsageReport: object
RANSecondaryRATUsageReport
-
uetimeZone: string
-
unitCountInactivityTimer: integer
-
userInformation: object
UserInformation
-
userLocationinfo: object
UserLocation
object
-
5GMMCapability: string
(byte)
-
allowedNSSAI: array
allowedNSSAI
Minimum Number of Items:
0
-
mICOModeIndication: string
Allowed Values:
[ "MICO_MODE", "NO_MICO_MODE" ]
-
rATType:
-
registrationMessagetype(required): string
Allowed Values:
[ "INITIAL", "MOBILITY", "PERIODIC", "EMERGENCY", "DEREGISTRATION" ]
-
rejectedNSSAI: array
rejectedNSSAI
Minimum Number of Items:
0
-
requestedNSSAI: array
requestedNSSAI
Minimum Number of Items:
0
-
serviceAreaRestriction: array
serviceAreaRestriction
Minimum Number of Items:
0
-
smsIndication: string
Allowed Values:
[ "SMS_SUPPORTED", "SMS_NOT_SUPPORTED" ]
-
taiList: array
taiList
Minimum Number of Items:
0
-
uetimeZone: string
-
userInformation: object
UserInformation
-
userLocationinfo: object
UserLocation
object
-
multipleQFIcontainer: array
multipleQFIcontainer
Minimum Number of Items:
0
-
roamingChargingProfile: object
RoamingChargingProfile
-
uPFID: string
(uuid)
object
-
deliveryReportRequested: string
Allowed Values:
[ "YES", "NO" ]
-
messageClass: object
MessageClass
-
messageReference: string
-
messageSize: integer
(int32)
Minimum Value:
0
-
numberofMessagesSent: integer
(int32)
Minimum Value:
0
-
originatorInfo: object
OriginatorInfo
-
rATType:
-
recipientInfo: array
recipientInfo
Minimum Number of Items:
0
-
sMDataCodingScheme: integer
-
sMDischargeTime: string
(date-time)
-
sMMessageType: string
Allowed Values:
[ "SUBMISSION", "DELIVERY_REPORT", "SM_SERVICE_REQUEST" ]
-
sMPriority: string
Allowed Values:
[ "LOW", "NORMAL", "HIGH" ]
-
sMReplyPathRequested: string
Allowed Values:
[ "NO_REPLY_PATH_SET", "REPLY_PATH_SET" ]
-
sMSCAddress: string
-
sMSequenceNumber: integer
(int32)
Minimum Value:
0
-
sMServiceType: string
Allowed Values:
[ "VAS4SMS_SHORT_MESSAGE_CONTENT_PROCESSING", "VAS4SMS_SHORT_MESSAGE_FORWARDING", "VAS4SMS_SHORT_MESSAGE_FORWARDING_MULTIPLE_SUBSCRIPTIONS", "VAS4SMS_SHORT_MESSAGE_FILTERING", "VAS4SMS_SHORT_MESSAGE_RECEIPT", "VAS4SMS_SHORT_MESSAGE_NETWORK_STORAGE", "VAS4SMS_SHORT_MESSAGE_TO_MULTIPLE_DESTINATIONS", "VAS4SMS_SHORT_MESSAGE_VIRTUAL_PRIVATE_NETWORK(VPN)", "VAS4SMS_SHORT_MESSAGE_AUTO_REPLY", "VAS4SMS_SHORT_MESSAGE_PERSONAL_SIGNATURE", "VAS4SMS_SHORT_MESSAGE_DEFERRED_DELIVERY" ]
-
sMSresult: integer
(int32)
Minimum Value:
0
-
sMStatus: string
-
sMUserDataHeader: string
-
submissionTime: string
(date-time)
-
uetimeZone: string
-
userEquipmentInfo: string
Pattern:
^(imei-[0-9]{15}|imeisv-[0-9]{16}|.+)$
-
userLocationinfo: object
UserLocation
array
0
The presence of the triggers attribute without any triggerType is used by CHF to disable all of the triggers to the associated rating group.
object
0
object
-
roamerInOut: string
Allowed Values:
[ "IN_BOUND", "OUT_BOUND" ]
-
servedGPSI: string
Pattern:
^(msisdn-[0-9]{5,15}|extid-[^@]+@[^@]+|.+)$
-
servedPEI: string
Pattern:
^(imei-[0-9]{15}|imeisv-[0-9]{16}|.+)$
-
unauthenticatedFlag: boolean
object
-
ecgiList: array
ecgiList
Minimum Number of Items:
1
-
globalRanNodeIdList: array
globalRanNodeIdList
Minimum Number of Items:
1
-
ncgiList: array
ncgiList
Minimum Number of Items:
1
-
praId: string
-
presenceState:
-
trackingAreaList: array
trackingAreaList
Minimum Number of Items:
1
object
-
eutraCellId(required): string
Pattern:
^[A-Fa-f0-9]{7}$
-
plmnId(required): object
PlmnId
object
-
mcc(required): string
Pattern:
^\d{3}$
-
mnc(required): string
Pattern:
^\d{2,3}$
object
-
gNbId: object
GNbId
-
n3IwfId: string
Pattern:
^[A-Fa-f0-9]+$
-
ngeNbId: string
Pattern:
^(MacroNGeNB-[A-Fa-f0-9]{5}|LMacroNGeNB-[A-Fa-f0-9]{6}|SMacroNGeNB-[A-Fa-f0-9]{5})$
-
plmnId(required): object
PlmnId
object
-
bitLength(required): integer
Minimum Value:
22
Maximum Value:32
-
gNBValue(required): string
Pattern:
^[A-Fa-f0-9]{6,8}$
object
-
nrCellId(required): string
Pattern:
^[A-Fa-f0-9]{9}$
-
plmnId(required): object
PlmnId
object
-
plmnId(required): object
PlmnId
-
tac(required): string
Pattern:
(^[A-Fa-f0-9]{4}$)|(^[A-Fa-f0-9]{6}$)
object
-
ageOfLocationInformation: integer
Minimum Value:
0
Maximum Value:32767
-
ecgi(required): object
Ecgi
-
geodeticInformation: string
Pattern:
^[0-9A-F]{20}$
-
geographicalInformation: string
Pattern:
^[0-9A-F]{16}$
-
globalNgenbId: object
GlobalRanNodeId
-
tai(required): object
Tai
-
ueLocationTimestamp: string
(date-time)
object
-
n3gppTai: object
Tai
-
n3IwfId: string
Pattern:
^[A-Fa-f0-9]+$
-
portNumber: integer
Minimum Value:
0
-
ueIpv4Addr: string
Pattern:
^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$
Example:198.51.100.1
-
ueIpv6Addr: string
Ipv6Addr
object
-
ageOfLocationInformation: integer
Minimum Value:
0
Maximum Value:32767
-
geodeticInformation: string
Pattern:
^[0-9A-F]{20}$
-
geographicalInformation: string
Pattern:
^[0-9A-F]{16}$
-
globalGnbId: object
GlobalRanNodeId
-
ncgi(required): object
Ncgi
-
tai(required): object
Tai
-
ueLocationTimestamp: string
(date-time)
-
Pattern:
^((:|(0?|([1-9a-f][0-9a-f]{0,3}))):)((0?|([1-9a-f][0-9a-f]{0,3})):){0,6}(:|(0?|([1-9a-f][0-9a-f]{0,3})))$
-
Pattern:
^((([^:]+:){7}([^:]+))|((([^:]+:)*[^:]+)?::(([^:]+:)*[^:]+)?))$
2001:db8:85a3::8a2e:370:7334
object
-
ratingGroup(required): integer
(int32)
Minimum Value:
0
The ID of the rating group. -
requestedUnit: object
RequestedUnit
-
uPFID: string
(uuid)
-
usedUnitContainer: array
usedUnitContainer
Minimum Number of Items:
0
object
-
downlinkVolume: integer
(int64)
Minimum Value:
0
-
serviceSpecificUnits: integer
(int64)
Minimum Value:
0
-
time: integer
(int32)
Minimum Value:
0
-
totalVolume: integer
(int64)
Minimum Value:
0
-
uplinkVolume: integer
(int64)
Minimum Value:
0
object
-
downlinkVolume: integer
(int64)
Minimum Value:
0
-
eventTimeStamps: array
eventTimeStamps
Minimum Number of Items:
0
-
localSequenceNumber(required): integer
-
nSPAContainerInformation: object
NSPAContainerInformation
-
pDUContainerInformation: object
PDUContainerInformation
-
quotaManagementIndicator: string
Allowed Values:
[ "ONLINE_CHARGING", "OFFLINE_CHARGING", "QUOTA_MANAGEMENT_SUSPENDED" ]
Indicates the charging type for the usage request: (ONLINE_CHARGING) for online charging, (OFFLINE_CHARGING) for offline-only charging, or (QUOTA_MANAGEMENT_SUSPENDED) for suspended charging. -
serviceId: integer
(int32)
Minimum Value:
0
The ID of the service. -
serviceSpecificUnits: integer
(int64)
Minimum Value:
0
-
time: integer
(int32)
Minimum Value:
0
-
totalVolume: integer
(int64)
Minimum Value:
0
-
triggers: array
triggers
Minimum Number of Items:
0
-
triggerTimestamp: string
(date-time)
-
uplinkVolume: integer
(int64)
Minimum Value:
0
object
-
latency: integer
-
loadLevel: object
NsiLoadLevelInfo
Represents the network slice and optionally the associated network slice instance and the load level information.
-
maximumPacketLossRate: string
-
serviceExperienceStatisticsData: object
ServiceExperienceInfo
Represents service experience information.
-
theNumberOfPDUSessions: integer
-
theNumberOfRegisteredSubscribers: integer
-
throughput: object
Throughput
object
-
3gppPSDataOffStatus: string
Allowed Values:
[ "ACTIVE", "INACTIVE" ]
-
afChargingIdentifier: integer
(int32)
Minimum Value:
0
-
applicationserviceProviderIdentity: string
-
chargingRuleBaseName: string
-
mAPDUSteeringFunctionality:
Possible values are:
- MPTCP: Indicates that PCF authorizes the MPTCP functionality to support traffic steering, switching and splitting.
- ATSSS_LL: Indicates that PCF authorizes the ATSSS-LL functionality to support traffic steering, switching and splitting.
-
mAPDUSteeringMode: object
SteeringMode
Contains the steering mode value and parameters determined by the PCF.
-
presenceReportingAreaInformation: object
presenceReportingAreaInformation
Minimum Number of Properties:
0
Additional Properties Allowed: PresenceInfo -
qoSCharacteristics: object
QosCharacteristics
Contains QoS characteristics for a non-standardized or a non-configured 5QI.
-
qoSInformation: object
QosData
-
rATType:
-
servingNodeID: array
servingNodeID
Minimum Number of Items:
0
-
sponsorIdentity: string
-
timeofFirstUsage: string
(date-time)
-
timeofLastUsage: string
(date-time)
-
uetimeZone: string
-
userLocationInformation: object
UserLocation
object
-
confidence: integer
Minimum Value:
0
-
exceedLoadLevelThrInd: boolean
-
loadLevelInformation(required): integer
Load-level information of the network slice and the optionally associated network slice instance.
-
networkArea: object
NetworkAreaInfo
Describes a network area in which the NF service consumer requests the number of UEs.
-
numOfExceedLoadLevelThr: integer
Minimum Value:
0
-
numOfPduSess: object
NumberAverage
Represents average and variance information.
-
numOfUes: object
NumberAverage
Represents average and variance information.
-
resUsage: object
ResourceUsage
The current usage of the virtual resources assigned to the NF instances belonging to a particular network slice instance.
-
snssai(required): object
Snssai
The S-NSSAIs of the NF.
-
timePeriod: object
TimeWindow
Represents a time window identified by a start time and a stop time.
object
-
appId: string
-
confidence: integer
Minimum Value:
0
-
dnn: string
-
networkArea: object
NetworkAreaInfo
Describes a network area in which the NF service consumer requests the number of UEs.
-
ratType:
-
snssai: object
Snssai
The S-NSSAIs of the NF.
-
srvExpcType:
This string provides forward-compatibility with future extensions to the enumeration but is not used to encode content defined in the present version of this API.
Possible values are:
- VOICE: Indicates that the service experience analytics is for voice service.
- VIDEO: Indicates that the service experience analytics is for video service.
-
supis: array
supis
Minimum Number of Items:
1
-
svcExprcVariance: number
(float)
object
-
ecgis: array
ecgis
Minimum Number of Items:
1
Contains a list of E-UTRA cell identities. -
gRanNodeIds: array
gRanNodeIds
Minimum Number of Items:
1
Contains a list of NG RAN nodes. -
ncgis: array
ncgis
Minimum Number of Items:
1
Contains a list of NR cell identities. -
tais: array
tais
Minimum Number of Items:
1
Contains a list of tracking area identities.
object
-
number(required): integer
The average number.
-
variance(required): number
(float)
object
-
cpuUsage: integer
Minimum Value:
0
-
memoryUsage: integer
Minimum Value:
0
-
storageUsage: integer
Minimum Value:
0
object
-
sd: string
Pattern:
^[A-Fa-f0-9]{6}$
The S-NSSAI Slice Differentiator (SD) ID of the network slices that are allowed to access the HTTP Gateway server. -
sst(required): integer
Minimum Value:
0
Maximum Value:255
The S-NSSAI Slice/Service Type (SST) ID of the network slices that are allowed to access the HTTP Gateway server.
object
-
startTime(required): string
(date-time)
The starting time.
-
stopTime(required): string
(date-time)
The stopping time.
array
1
array
1
array
1
array
1
array
1
-
Array of:
string
Pattern:
^(imsi-[0-9]{5,15}|nai-.+|.+)$
object
-
3gLoad: integer
Minimum Value:
0
-
active: string
Allowed Values:
[ "3GPP_ACCESS", "NON_3GPP_ACCESS" ]
-
prioAcc: string
Allowed Values:
[ "3GPP_ACCESS", "NON_3GPP_ACCESS" ]
-
standby: string
Allowed Values:
[ "3GPP_ACCESS", "NON_3GPP_ACCESS" ]
-
steerModeInd:
Contains an autonomous load-balance indicator or UE-assistance indicator.
-
steerModeValue(required):
-
thresValue: object
ThresholdValue
Indicates the threshold values for round-trip time (RTT) and packet loss rate.
object
0
object
-
5qi(required): integer
Minimum Value:
0
Maximum Value:255
-
averagingWindow: integer
Minimum Value:
1
Maximum Value:4095
Default Value:2000
The averaging window. -
maxDataBurstVol: integer
Minimum Value:
1
Maximum Value:4095
The maximum data burst volume. -
packetDelayBudget(required): integer
Minimum Value:
1
The packet delay budget. -
packetErrorRate(required): string
Pattern:
^([0-9]E-[0-9])$
The packet error rate. -
priorityLevel(required): integer
Minimum Value:
1
Maximum Value:127
An unsigned integer indicating the 5QI priority level, from range 1 through 127. Values are ordered in decreasing order of priority, with 1 as the highest priority. -
resourceType(required):
Whether a QoS Flow is non-GBR, delay critical GBR, or non-delay critical GBR.
object
-
5qi: integer
Minimum Value:
0
Maximum Value:255
-
arp: object
Arp
-
averWindow: integer
Minimum Value:
1
Maximum Value:4095
Default Value:2000
The averaging window. This field can have a nullable value. -
defQosFlowIndication: boolean
Indicates that the dynamic PCC rule shall always have its binding with the QoS Flow associated with the default QoS rule
-
gbrDl: string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
gbrUl: string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
maxbrDl: string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
maxbrUl: string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
maxDataBurstVol: integer
Minimum Value:
1
Maximum Value:4095
The maximum data burst volume. This field can have a nullable value. -
maxPacketLossRateDl: integer
Minimum Value:
0
Maximum Value:1000
The packet loss rate. This field can have a nullable value. -
maxPacketLossRateUl: integer
Minimum Value:
0
Maximum Value:1000
The packet loss rate. This field can have a nullable value. -
priorityLevel: integer
Minimum Value:
1
Maximum Value:127
-
qnc: boolean
Indicates whether notifications are requested from 3GPP NG-RAN when the GFBR can no longer (or again) be guaranteed for a QoS Flow during the lifetime of the QoS Flow.
-
qosId(required): string
Univocally identifies the QoS control policy data within a PDU session.
-
reflectiveQos: boolean
Indicates whether the QoS information is reflective for the corresponding service data flow.
-
sharingKeyDl: string
Indicates, by containing the same value, what PCC rules may share resource in downlink direction.
-
sharingKeyUl: string
Indicates, by containing the same value, what PCC rules may share resource in uplink direction.
object
-
plrThres: integer
Minimum Value:
0
Maximum Value:1000
The packet loss rate. This field can have a nullable value. -
rttThres: integer
Minimum Value:
0
object
-
preemptCap(required):
Whether a bearer with a lower priority level should be dropped to free up the required resources.
-
preemptVuln(required):
Whether a service data flow can lose the resources assigned to it in order to admit a service data flow that has a higher priority level.
-
priorityLevel(required): integer
Minimum Value:
1
Maximum Value:15
nullable true shall not be used for this attribute
object
-
aMFId: string
Pattern:
^[A-Fa-f0-9]{6}$
-
servingNetworkFunctionInformation(required): object
NFIdentification
A grouped field that contains a set of information identifying the NF consumer of the charging service.
object
-
maxNumberOfccc: integer
(int32)
Minimum Value:
0
-
timeLimit: integer
-
triggerCategory(required): string
Allowed Values:
[ "IMMEDIATE_REPORT", "DEFERRED_REPORT" ]
-
triggerType(required): string
Allowed Values:
[ "QUOTA_THRESHOLD", "QHT", "FINAL", "QUOTA_EXHAUSTED", "VALIDITY_TIME", "OTHER_QUOTA_TYPE", "FORCED_REAUTHORISATION", "UNUSED_QUOTA_TIMER", "UNIT_COUNT_INACTIVITY_TIMER", "ABNORMAL_RELEASE", "QOS_CHANGE", "VOLUME_LIMIT", "TIME_LIMIT", "EVENT_LIMIT", "PLMN_CHANGE", "USER_LOCATION_CHANGE", "RAT_CHANGE", "SESSION_AMBR_CHANGE", "UE_TIMEZONE_CHANGE", "TARIFF_TIME_CHANGE", "MAX_NUMBER_OF_CHANGES_IN_CHARGING_CONDITIONS", "MANAGEMENT_INTERVENTION", "CHANGE_OF_UE_PRESENCE_IN_PRESENCE_REPORTING_AREA", "CHANGE_OF_3GPP_PS_DATA_OFF_STATUS", "SERVING_NODE_CHANGE", "REMOVAL_OF_UPF", "ADDITION_OF_UPF", "INSERTION_OF_ISMF", "REMOVAL_OF_ISMF", "CHANGE_OF_ISMF", "START_OF_SERVICE_DATA_FLOW", "ECGI_CHANGE", "TAI_CHANGE", "HANDOVER_CANCEL", "HANDOVER_START", "HANDOVER_COMPLETE", "GFBR_GUARANTEED_STATUS_CHANGE", "ADDITION_OF_ACCESS", "REMOVAL_OF_ACCESS", "START_OF_SDF_ADDITIONAL_ACCESS" ]
-
volumeLimit: integer
(int32)
Minimum Value:
0
-
volumeLimit64: integer
(int64)
Minimum Value:
0
array
0
-
Array of:
object Snssai
The S-NSSAIs of the NF.
object
-
areaCode: string
-
tacs: array
tacs
Minimum Number of Items:
1
array
1
-
Array of:
string
Pattern:
(^[A-Fa-f0-9]{4}$)|(^[A-Fa-f0-9]{6}$)
object
-
areas: array
areas
-
maxNumOfTAs: integer
Minimum Value:
0
-
maxNumOfTAsForNotAllowedAreas: integer
Minimum Value:
0
-
restrictionType:
array
0
object
-
addServiceProfileInfo: string
-
availability: number
-
coverageArea: string
-
dLThptPerSlice: object
Throughput
-
dLThptPerUE: object
Throughput
-
jitter: integer
-
kPIMonitoringList: string
-
latency: integer
-
maxNumberofPDUsessions: integer
-
maxNumberofUEs: integer
-
reliability: string
-
serviceProfileIdentifier: string
-
sNSSAIList: array
sNSSAIList
Minimum Number of Items:
0
-
supportedAccessTechnology: integer
-
uLThptPerSlice: object
Throughput
-
uLThptPerUE: object
Throughput
array
0
-
Array of:
object Snssai
The S-NSSAIs of the NF.
object
-
3gppPSDataOffStatus: string
Allowed Values:
[ "ACTIVE", "INACTIVE" ]
-
authorizedQoSInformation: object
AuthorizedDefaultQos
-
authorizedSessionAMBR: object
Ambr
-
chargingCharacteristics: string
Pattern:
^[0-9a-fA-F]{1,4}$
-
chargingCharacteristicsSelectionMode: string
Allowed Values:
[ "HOME_DEFAULT", "ROAMING_DEFAULT", "VISITING_DEFAULT" ]
-
diagnostics: integer
-
dnnId(required): string
-
dnnSelectionMode: string
Allowed Values:
[ "VERIFIED", "UE_DNN_NOT_VERIFIED", "NW_DNN_NOT_VERIFIED" ]
-
hPlmnId: object
PlmnId
-
mAPDUNon3GPPRATType:
-
mAPDUSessionInformation: object
MAPDUSessionInformation
-
networkSlicingInfo: object
NetworkSlicingInfo
-
pduAddress: object
PDUAddress
-
pduSessionID(required): integer
Minimum Value:
0
Maximum Value:255
-
pduType:
-
ratType:
-
servingCNPlmnId: object
PlmnId
-
servingNetworkFunctionID: object
ServingNetworkFunctionID
-
sessionStopIndicator: boolean
-
sscMode:
-
startTime: string
(date-time)
-
stopTime: string
(date-time)
-
subscribedQoSInformation: object
SubscribedDefaultQos
-
subscribedSessionAMBR: object
Ambr
object
0
object
-
5qi: integer
Minimum Value:
0
Maximum Value:255
-
arp: object
Arp
-
averWindow: integer
Minimum Value:
1
Maximum Value:4095
Default Value:2000
The averaging window. This field can have a nullable value. -
gbrDl: string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
gbrUl: string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
maxbrDl: string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
maxbrUl: string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
maxDataBurstVol: integer
Minimum Value:
1
Maximum Value:4095
The maximum data burst volume. This field can have a nullable value. -
priorityLevel: integer
Minimum Value:
1
Maximum Value:127
-
qnc: boolean
Indicates whether notifications are requested from 3GPP NG-RAN when the GFBR can no longer (or again) be guaranteed for a QoS Flow during the lifetime of the QoS Flow.
object
-
downlink(required): string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
uplink(required): string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
object
-
sNSSAI(required): object
Snssai
The S-NSSAIs of the NF.
object
-
iPv4dynamicAddressFlag: boolean
-
iPv6dynamicPrefixFlag: boolean
-
pduAddressprefixlength: integer
-
pduIPv4Address: string
Pattern:
^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$
Example:198.51.100.1
-
pduIPv6AddresswithPrefix: string
Ipv6Addr
object
-
5qi(required): integer
Minimum Value:
0
Maximum Value:255
-
arp(required): object
Arp
-
priorityLevel: integer
Minimum Value:
1
Maximum Value:127
An unsigned integer indicating the 5QI priority level, from range 1 through 127. Values are ordered in decreasing order of priority, with 1 as the highest priority.
object
-
downlinkVolume: integer
(int64)
Minimum Value:
0
-
endTimestamp: string
(date-time)
-
qFI: integer
Minimum Value:
0
Maximum Value:63
-
startTimestamp: string
(date-time)
-
uplinkVolume: integer
(int64)
Minimum Value:
0
array
0
-
Array of:
object Snssai
The S-NSSAIs of the NF.
array
0
-
Array of:
object Snssai
The S-NSSAIs of the NF.
array
0
-
Array of:
object Snssai
The S-NSSAIs of the NF.
object
-
partialRecordMethod: string
Allowed Values:
[ "DEFAULT", "INDIVIDUAL" ]
-
triggers: array
triggers
Minimum Number of Items:
0
object
-
downlinkVolume: integer
(int64)
Minimum Value:
0
-
localSequenceNumber(required): integer
-
qFIContainerInformation: object
QFIContainerInformation
-
time: integer
(int32)
Minimum Value:
0
-
totalVolume: integer
(int64)
Minimum Value:
0
-
triggers: array
triggers
Minimum Number of Items:
0
-
triggerTimestamp: string
(date-time)
-
uplinkVolume: integer
(int64)
Minimum Value:
0
object
-
3gppChargingId: integer
(int32)
Minimum Value:
0
-
3gppPSDataOffStatus: string
Allowed Values:
[ "ACTIVE", "INACTIVE" ]
-
diagnostics: integer
-
enhancedDiagnostics: array
enhancedDiagnostics
-
presenceReportingAreaInformation: object
presenceReportingAreaInformation
Minimum Number of Properties:
0
Additional Properties Allowed: PresenceInfo -
qFI: integer
Minimum Value:
0
Maximum Value:63
-
qoSCharacteristics: object
QosCharacteristics
Contains QoS characteristics for a non-standardized or a non-configured 5QI.
-
qoSInformation: object
QosData
-
rATType:
-
reportTime(required): string
(date-time)
-
servingNetworkFunctionID: array
servingNetworkFunctionID
Minimum Number of Items:
0
-
timeofFirstUsage: string
(date-time)
-
timeofLastUsage: string
(date-time)
-
uetimeZone: string
-
userLocationInformation: object
UserLocation
object
0
object
-
classIdentifier: string
Allowed Values:
[ "PERSONAL", "ADVERTISEMENT", "INFORMATIONAL", "AUTO" ]
-
tokenText: string
object
-
originatorGPSI: string
Pattern:
^(msisdn-[0-9]{5,15}|extid-[^@]+@[^@]+|.+)$
-
originatorOtherAddress: object
SMAddressInfo
-
originatorReceivedAddress: object
SMAddressInfo
-
originatorSCCPAddress: string
-
originatorSUPI: string
Pattern:
^(imsi-[0-9]{5,15}|nai-.+|.+)$
-
sMOriginatorInterface: object
SMInterface
-
sMOriginatorProtocolId: string
object
-
sMaddressData: string
-
sMaddressDomain: object
SMAddressDomain
-
sMaddressType: string
Allowed Values:
[ "EMAIL_ADDRESS", "MSISDN", "IPV4_ADDRESS", "IPV6_ADDRESS", "NUMERIC_SHORTCODE", "ALPHANUMERIC_SHORTCODE", "OTHER", "IMSI" ]
object
-
interfaceId: string
-
interfacePort: string
-
interfaceText: string
-
interfaceType: string
Allowed Values:
[ "UNKNOWN", "MOBILE_ORIGINATING", "MOBILE_TERMINATING", "APPLICATION_ORIGINATING", "APPLICATION_TERMINATING" ]
object
-
recipientGPSI: string
Pattern:
^(msisdn-[0-9]{5,15}|extid-[^@]+@[^@]+|.+)$
-
recipientOtherAddress: object
SMAddressInfo
-
recipientReceivedAddress: object
SMAddressInfo
-
recipientSCCPAddress: string
-
recipientSUPI: string
Pattern:
^(imsi-[0-9]{5,15}|nai-.+|.+)$
-
sMDestinationInterface: object
SMInterface
-
sMrecipientProtocolId: string
Response
- application/json
- application/problem+json
200 Response
object
-
invocationResult: object
InvocationResult
The result.
-
invocationSequenceNumber(required): integer
(int32)
Minimum Value:
0
The sequence number of the charging service invocation by the NF consumer. -
invocationTimeStamp(required): string
(date-time)
The timestamp of the charging service response from the CHF.
-
multipleUnitInformation: array
multipleUnitInformation
Minimum Number of Items:
0
The parameters for quota management or usage reporting. It may have multiple occurrences. -
pDUSessionChargingInformation: object
PDUSessionChargingInformation
The 5G data connectivity-specific information.
-
roamingQBCInformation: object
RoamingQBCInformation
The 5G data connectivity-specific information for roaming QBC.
-
sessionFailover: string
Allowed Values:
[ "FAILOVER_NOT_SUPPORTED", "FAILOVER_SUPPORTED" ]
Whether an alternative CHF is supported for ongoing charging service failover handling by the NF consumer. -
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$
The list of supported features. -
triggers: array
triggers
Minimum Number of Items:
0
The triggers for usage reporting associated to the rating group, which is supplied from the CHF.The presence of the triggers attribute without a triggerType is used by CHF to disable all triggers to the associated rating group.
object
-
error: object
ProblemDetails
Information about an error.
-
failureHandling: string
Allowed Values:
[ "TERMINATE", "CONTINUE", "RETRY_AND_TERMINATE" ]
Failure handling.
array
0
object
-
chargingId: integer
(int32)
Minimum Value:
0
-
homeProvidedChargingId: integer
(int32)
Minimum Value:
0
-
mAPDUNon3GPPUserLocationInfo: object
UserLocation
-
pduSessionInformation: object
PDUSessionInformation
-
presenceReportingAreaInformation: object
presenceReportingAreaInformation
Minimum Number of Properties:
0
Additional Properties Allowed: PresenceInfo -
rANSecondaryRATUsageReport: object
RANSecondaryRATUsageReport
-
uetimeZone: string
-
unitCountInactivityTimer: integer
-
userInformation: object
UserInformation
-
userLocationinfo: object
UserLocation
object
-
multipleQFIcontainer: array
multipleQFIcontainer
Minimum Number of Items:
0
-
roamingChargingProfile: object
RoamingChargingProfile
-
uPFID: string
(uuid)
array
0
The presence of the triggers attribute without a triggerType is used by CHF to disable all triggers to the associated rating group.
object
-
cause: string
The reason for the failure.
-
detail: string
Details about the error.
-
instance: string
The instance.
-
invalidParams: array
invalidParams
Minimum Number of Items:
1
A list of invalid parameters. -
status: integer
The status code.
-
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$
The list of supported features. -
title: string
The problem's title.
-
type: string
The type of problem.
array
1
-
Array of:
object InvalidParam
An invalid parameter.
object
-
param(required): string
The name of the parameter.
-
reason: string
The reason why the parameter didn't pass validation.
object
-
finalUnitIndication: object
FinalUnitIndication
-
grantedUnit: object
GrantedUnit
-
quotaHoldingTime: integer
-
ratingGroup(required): integer
(int32)
Minimum Value:
0
The ID of the rating group. -
resultCode: string
Allowed Values:
[ "SUCCESS", "END_USER_SERVICE_DENIED", "QUOTA_MANAGEMENT_NOT_APPLICABLE", "QUOTA_LIMIT_REACHED", "END_USER_SERVICE_REJECTED", "USER_UNKNOWN", "RATING_FAILED", "QUOTA_MANAGEMENT" ]
-
timeQuotaThreshold: integer
-
triggers: array
triggers
Minimum Number of Items:
0
-
unitQuotaThreshold: integer
-
uPFID: string
(uuid)
-
validityTime: integer
-
volumeQuotaThreshold: integer
(int64)
Minimum Value:
0
object
-
filterId: string
-
finalUnitAction(required): string
Allowed Values:
[ "TERMINATE", "REDIRECT", "RESTRICT_ACCESS" ]
-
redirectServer: object
RedirectServer
-
restrictionFilterRule: string
object
-
downlinkVolume: integer
(int64)
Minimum Value:
0
-
serviceSpecificUnits: integer
(int64)
Minimum Value:
0
-
tariffTimeChange: string
(date-time)
-
time: integer
(int32)
Minimum Value:
0
-
totalVolume: integer
(int64)
Minimum Value:
0
-
uplinkVolume: integer
(int64)
Minimum Value:
0
object
-
redirectAddressType(required): string
Allowed Values:
[ "IPV4", "IPV6", "URL" ]
-
redirectServerAddress(required): string
object
-
maxNumberOfccc: integer
(int32)
Minimum Value:
0
-
timeLimit: integer
-
triggerCategory(required): string
Allowed Values:
[ "IMMEDIATE_REPORT", "DEFERRED_REPORT" ]
-
triggerType(required): string
Allowed Values:
[ "QUOTA_THRESHOLD", "QHT", "FINAL", "QUOTA_EXHAUSTED", "VALIDITY_TIME", "OTHER_QUOTA_TYPE", "FORCED_REAUTHORISATION", "UNUSED_QUOTA_TIMER", "UNIT_COUNT_INACTIVITY_TIMER", "ABNORMAL_RELEASE", "QOS_CHANGE", "VOLUME_LIMIT", "TIME_LIMIT", "EVENT_LIMIT", "PLMN_CHANGE", "USER_LOCATION_CHANGE", "RAT_CHANGE", "SESSION_AMBR_CHANGE", "UE_TIMEZONE_CHANGE", "TARIFF_TIME_CHANGE", "MAX_NUMBER_OF_CHANGES_IN_CHARGING_CONDITIONS", "MANAGEMENT_INTERVENTION", "CHANGE_OF_UE_PRESENCE_IN_PRESENCE_REPORTING_AREA", "CHANGE_OF_3GPP_PS_DATA_OFF_STATUS", "SERVING_NODE_CHANGE", "REMOVAL_OF_UPF", "ADDITION_OF_UPF", "INSERTION_OF_ISMF", "REMOVAL_OF_ISMF", "CHANGE_OF_ISMF", "START_OF_SERVICE_DATA_FLOW", "ECGI_CHANGE", "TAI_CHANGE", "HANDOVER_CANCEL", "HANDOVER_START", "HANDOVER_COMPLETE", "GFBR_GUARANTEED_STATUS_CHANGE", "ADDITION_OF_ACCESS", "REMOVAL_OF_ACCESS", "START_OF_SDF_ADDITIONAL_ACCESS" ]
-
volumeLimit: integer
(int32)
Minimum Value:
0
-
volumeLimit64: integer
(int64)
Minimum Value:
0
object
-
3gppPSDataOffStatus: string
Allowed Values:
[ "ACTIVE", "INACTIVE" ]
-
authorizedQoSInformation: object
AuthorizedDefaultQos
-
authorizedSessionAMBR: object
Ambr
-
chargingCharacteristics: string
Pattern:
^[0-9a-fA-F]{1,4}$
-
chargingCharacteristicsSelectionMode: string
Allowed Values:
[ "HOME_DEFAULT", "ROAMING_DEFAULT", "VISITING_DEFAULT" ]
-
diagnostics: integer
-
dnnId(required): string
-
dnnSelectionMode: string
Allowed Values:
[ "VERIFIED", "UE_DNN_NOT_VERIFIED", "NW_DNN_NOT_VERIFIED" ]
-
hPlmnId: object
PlmnId
-
mAPDUNon3GPPRATType:
-
mAPDUSessionInformation: object
MAPDUSessionInformation
-
networkSlicingInfo: object
NetworkSlicingInfo
-
pduAddress: object
PDUAddress
-
pduSessionID(required): integer
Minimum Value:
0
Maximum Value:255
-
pduType:
-
ratType:
-
servingCNPlmnId: object
PlmnId
-
servingNetworkFunctionID: object
ServingNetworkFunctionID
-
sessionStopIndicator: boolean
-
sscMode:
-
startTime: string
(date-time)
-
stopTime: string
(date-time)
-
subscribedQoSInformation: object
SubscribedDefaultQos
-
subscribedSessionAMBR: object
Ambr
object
0
object
-
roamerInOut: string
Allowed Values:
[ "IN_BOUND", "OUT_BOUND" ]
-
servedGPSI: string
Pattern:
^(msisdn-[0-9]{5,15}|extid-[^@]+@[^@]+|.+)$
-
servedPEI: string
Pattern:
^(imei-[0-9]{15}|imeisv-[0-9]{16}|.+)$
-
unauthenticatedFlag: boolean
object
-
ageOfLocationInformation: integer
Minimum Value:
0
Maximum Value:32767
-
ecgi(required): object
Ecgi
-
geodeticInformation: string
Pattern:
^[0-9A-F]{20}$
-
geographicalInformation: string
Pattern:
^[0-9A-F]{16}$
-
globalNgenbId: object
GlobalRanNodeId
-
tai(required): object
Tai
-
ueLocationTimestamp: string
(date-time)
object
-
n3gppTai: object
Tai
-
n3IwfId: string
Pattern:
^[A-Fa-f0-9]+$
-
portNumber: integer
Minimum Value:
0
-
ueIpv4Addr: string
Pattern:
^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$
Example:198.51.100.1
-
ueIpv6Addr: string
Ipv6Addr
object
-
ageOfLocationInformation: integer
Minimum Value:
0
Maximum Value:32767
-
geodeticInformation: string
Pattern:
^[0-9A-F]{20}$
-
geographicalInformation: string
Pattern:
^[0-9A-F]{16}$
-
globalGnbId: object
GlobalRanNodeId
-
ncgi(required): object
Ncgi
-
tai(required): object
Tai
-
ueLocationTimestamp: string
(date-time)
object
-
eutraCellId(required): string
Pattern:
^[A-Fa-f0-9]{7}$
-
plmnId(required): object
PlmnId
object
-
gNbId: object
GNbId
-
n3IwfId: string
Pattern:
^[A-Fa-f0-9]+$
-
ngeNbId: string
Pattern:
^(MacroNGeNB-[A-Fa-f0-9]{5}|LMacroNGeNB-[A-Fa-f0-9]{6}|SMacroNGeNB-[A-Fa-f0-9]{5})$
-
plmnId(required): object
PlmnId
object
-
plmnId(required): object
PlmnId
-
tac(required): string
Pattern:
(^[A-Fa-f0-9]{4}$)|(^[A-Fa-f0-9]{6}$)
object
-
mcc(required): string
Pattern:
^\d{3}$
-
mnc(required): string
Pattern:
^\d{2,3}$
object
-
bitLength(required): integer
Minimum Value:
22
Maximum Value:32
-
gNBValue(required): string
Pattern:
^[A-Fa-f0-9]{6,8}$
-
Pattern:
^((:|(0?|([1-9a-f][0-9a-f]{0,3}))):)((0?|([1-9a-f][0-9a-f]{0,3})):){0,6}(:|(0?|([1-9a-f][0-9a-f]{0,3})))$
-
Pattern:
^((([^:]+:){7}([^:]+))|((([^:]+:)*[^:]+)?::(([^:]+:)*[^:]+)?))$
2001:db8:85a3::8a2e:370:7334
object
-
nrCellId(required): string
Pattern:
^[A-Fa-f0-9]{9}$
-
plmnId(required): object
PlmnId
object
-
5qi: integer
Minimum Value:
0
Maximum Value:255
-
arp: object
Arp
-
averWindow: integer
Minimum Value:
1
Maximum Value:4095
Default Value:2000
The averaging window. This field can have a nullable value. -
gbrDl: string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
gbrUl: string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
maxbrDl: string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
maxbrUl: string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
maxDataBurstVol: integer
Minimum Value:
1
Maximum Value:4095
The maximum data burst volume. This field can have a nullable value. -
priorityLevel: integer
Minimum Value:
1
Maximum Value:127
-
qnc: boolean
Indicates whether notifications are requested from 3GPP NG-RAN when the GFBR can no longer (or again) be guaranteed for a QoS Flow during the lifetime of the QoS Flow.
object
-
downlink(required): string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
uplink(required): string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
object
-
sNSSAI(required): object
Snssai
The S-NSSAIs of the NF.
object
-
iPv4dynamicAddressFlag: boolean
-
iPv6dynamicPrefixFlag: boolean
-
pduAddressprefixlength: integer
-
pduIPv4Address: string
Pattern:
^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$
Example:198.51.100.1
-
pduIPv6AddresswithPrefix: string
Ipv6Addr
object
-
aMFId: string
Pattern:
^[A-Fa-f0-9]{6}$
-
servingNetworkFunctionInformation(required): object
NFIdentification
A grouped field that contains a set of information identifying the NF consumer of the charging service.
object
-
5qi(required): integer
Minimum Value:
0
Maximum Value:255
-
arp(required): object
Arp
-
priorityLevel: integer
Minimum Value:
1
Maximum Value:127
An unsigned integer indicating the 5QI priority level, from range 1 through 127. Values are ordered in decreasing order of priority, with 1 as the highest priority.
object
-
preemptCap(required):
Whether a bearer with a lower priority level should be dropped to free up the required resources.
-
preemptVuln(required):
Whether a service data flow can lose the resources assigned to it in order to admit a service data flow that has a higher priority level.
-
priorityLevel(required): integer
Minimum Value:
1
Maximum Value:15
nullable true shall not be used for this attribute
object
-
sd: string
Pattern:
^[A-Fa-f0-9]{6}$
The S-NSSAI Slice Differentiator (SD) ID of the network slices that are allowed to access the HTTP Gateway server. -
sst(required): integer
Minimum Value:
0
Maximum Value:255
The S-NSSAI Slice/Service Type (SST) ID of the network slices that are allowed to access the HTTP Gateway server.
object
-
nFFqdn: string
-
nFIPv4Address: string
Pattern:
^(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$
Example:198.51.100.1
-
nFIPv6Address: string
Ipv6Addr
-
nFName: string
(uuid)
-
nFPLMNID: object
PlmnId
-
nodeFunctionality(required): string
Allowed Values:
[ "AMF", "SMF", "SMSF", "SGW", "I_SMF", "ePDG", "CEF" ]
object
-
ecgiList: array
ecgiList
Minimum Number of Items:
1
-
globalRanNodeIdList: array
globalRanNodeIdList
Minimum Number of Items:
1
-
ncgiList: array
ncgiList
Minimum Number of Items:
1
-
praId: string
-
presenceState:
-
trackingAreaList: array
trackingAreaList
Minimum Number of Items:
1
object
-
downlinkVolume: integer
(int64)
Minimum Value:
0
-
endTimestamp: string
(date-time)
-
qFI: integer
Minimum Value:
0
Maximum Value:63
-
startTimestamp: string
(date-time)
-
uplinkVolume: integer
(int64)
Minimum Value:
0
object
-
partialRecordMethod: string
Allowed Values:
[ "DEFAULT", "INDIVIDUAL" ]
-
triggers: array
triggers
Minimum Number of Items:
0
object
-
downlinkVolume: integer
(int64)
Minimum Value:
0
-
localSequenceNumber(required): integer
-
qFIContainerInformation: object
QFIContainerInformation
-
time: integer
(int32)
Minimum Value:
0
-
totalVolume: integer
(int64)
Minimum Value:
0
-
triggers: array
triggers
Minimum Number of Items:
0
-
triggerTimestamp: string
(date-time)
-
uplinkVolume: integer
(int64)
Minimum Value:
0
object
-
3gppChargingId: integer
(int32)
Minimum Value:
0
-
3gppPSDataOffStatus: string
Allowed Values:
[ "ACTIVE", "INACTIVE" ]
-
diagnostics: integer
-
enhancedDiagnostics: array
enhancedDiagnostics
-
presenceReportingAreaInformation: object
presenceReportingAreaInformation
Minimum Number of Properties:
0
Additional Properties Allowed: PresenceInfo -
qFI: integer
Minimum Value:
0
Maximum Value:63
-
qoSCharacteristics: object
QosCharacteristics
Contains QoS characteristics for a non-standardized or a non-configured 5QI.
-
qoSInformation: object
QosData
-
rATType:
-
reportTime(required): string
(date-time)
-
servingNetworkFunctionID: array
servingNetworkFunctionID
Minimum Number of Items:
0
-
timeofFirstUsage: string
(date-time)
-
timeofLastUsage: string
(date-time)
-
uetimeZone: string
-
userLocationInformation: object
UserLocation
object
0
object
-
5qi(required): integer
Minimum Value:
0
Maximum Value:255
-
averagingWindow: integer
Minimum Value:
1
Maximum Value:4095
Default Value:2000
The averaging window. -
maxDataBurstVol: integer
Minimum Value:
1
Maximum Value:4095
The maximum data burst volume. -
packetDelayBudget(required): integer
Minimum Value:
1
The packet delay budget. -
packetErrorRate(required): string
Pattern:
^([0-9]E-[0-9])$
The packet error rate. -
priorityLevel(required): integer
Minimum Value:
1
Maximum Value:127
An unsigned integer indicating the 5QI priority level, from range 1 through 127. Values are ordered in decreasing order of priority, with 1 as the highest priority. -
resourceType(required):
Whether a QoS Flow is non-GBR, delay critical GBR, or non-delay critical GBR.
object
-
5qi: integer
Minimum Value:
0
Maximum Value:255
-
arp: object
Arp
-
averWindow: integer
Minimum Value:
1
Maximum Value:4095
Default Value:2000
The averaging window. This field can have a nullable value. -
defQosFlowIndication: boolean
Indicates that the dynamic PCC rule shall always have its binding with the QoS Flow associated with the default QoS rule
-
gbrDl: string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
gbrUl: string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
maxbrDl: string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
maxbrUl: string
Pattern:
^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
-
maxDataBurstVol: integer
Minimum Value:
1
Maximum Value:4095
The maximum data burst volume. This field can have a nullable value. -
maxPacketLossRateDl: integer
Minimum Value:
0
Maximum Value:1000
The packet loss rate. This field can have a nullable value. -
maxPacketLossRateUl: integer
Minimum Value:
0
Maximum Value:1000
The packet loss rate. This field can have a nullable value. -
priorityLevel: integer
Minimum Value:
1
Maximum Value:127
-
qnc: boolean
Indicates whether notifications are requested from 3GPP NG-RAN when the GFBR can no longer (or again) be guaranteed for a QoS Flow during the lifetime of the QoS Flow.
-
qosId(required): string
Univocally identifies the QoS control policy data within a PDU session.
-
reflectiveQos: boolean
Indicates whether the QoS information is reflective for the corresponding service data flow.
-
sharingKeyDl: string
Indicates, by containing the same value, what PCC rules may share resource in downlink direction.
-
sharingKeyUl: string
Indicates, by containing the same value, what PCC rules may share resource in uplink direction.
400 Response
object
-
cause: string
The reason for the failure.
-
detail: string
Details about the error.
-
instance: string
The instance.
-
invalidParams: array
invalidParams
Minimum Number of Items:
1
A list of invalid parameters. -
status: integer
The status code.
-
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$
The list of supported features. -
title: string
The problem's title.
-
type: string
The type of problem.
array
1
-
Array of:
object InvalidParam
An invalid parameter.
object
-
param(required): string
The name of the parameter.
-
reason: string
The reason why the parameter didn't pass validation.
401 Response
object
-
cause: string
The reason for the failure.
-
detail: string
Details about the error.
-
instance: string
The instance.
-
invalidParams: array
invalidParams
Minimum Number of Items:
1
A list of invalid parameters. -
status: integer
The status code.
-
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$
The list of supported features. -
title: string
The problem's title.
-
type: string
The type of problem.
array
1
-
Array of:
object InvalidParam
An invalid parameter.
object
-
param(required): string
The name of the parameter.
-
reason: string
The reason why the parameter didn't pass validation.
403 Response
object
-
cause: string
The reason for the failure.
-
detail: string
Details about the error.
-
instance: string
The instance.
-
invalidParams: array
invalidParams
Minimum Number of Items:
1
A list of invalid parameters. -
status: integer
The status code.
-
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$
The list of supported features. -
title: string
The problem's title.
-
type: string
The type of problem.
array
1
-
Array of:
object InvalidParam
An invalid parameter.
object
-
param(required): string
The name of the parameter.
-
reason: string
The reason why the parameter didn't pass validation.
404 Response
object
-
cause: string
The reason for the failure.
-
detail: string
Details about the error.
-
instance: string
The instance.
-
invalidParams: array
invalidParams
Minimum Number of Items:
1
A list of invalid parameters. -
status: integer
The status code.
-
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$
The list of supported features. -
title: string
The problem's title.
-
type: string
The type of problem.
array
1
-
Array of:
object InvalidParam
An invalid parameter.
object
-
param(required): string
The name of the parameter.
-
reason: string
The reason why the parameter didn't pass validation.
410 Response
object
-
cause: string
The reason for the failure.
-
detail: string
Details about the error.
-
instance: string
The instance.
-
invalidParams: array
invalidParams
Minimum Number of Items:
1
A list of invalid parameters. -
status: integer
The status code.
-
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$
The list of supported features. -
title: string
The problem's title.
-
type: string
The type of problem.
array
1
-
Array of:
object InvalidParam
An invalid parameter.
object
-
param(required): string
The name of the parameter.
-
reason: string
The reason why the parameter didn't pass validation.
411 Response
object
-
cause: string
The reason for the failure.
-
detail: string
Details about the error.
-
instance: string
The instance.
-
invalidParams: array
invalidParams
Minimum Number of Items:
1
A list of invalid parameters. -
status: integer
The status code.
-
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$
The list of supported features. -
title: string
The problem's title.
-
type: string
The type of problem.
array
1
-
Array of:
object InvalidParam
An invalid parameter.
object
-
param(required): string
The name of the parameter.
-
reason: string
The reason why the parameter didn't pass validation.
413 Response
object
-
cause: string
The reason for the failure.
-
detail: string
Details about the error.
-
instance: string
The instance.
-
invalidParams: array
invalidParams
Minimum Number of Items:
1
A list of invalid parameters. -
status: integer
The status code.
-
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$
The list of supported features. -
title: string
The problem's title.
-
type: string
The type of problem.
array
1
-
Array of:
object InvalidParam
An invalid parameter.
object
-
param(required): string
The name of the parameter.
-
reason: string
The reason why the parameter didn't pass validation.
500 Response
object
-
cause: string
The reason for the failure.
-
detail: string
Details about the error.
-
instance: string
The instance.
-
invalidParams: array
invalidParams
Minimum Number of Items:
1
A list of invalid parameters. -
status: integer
The status code.
-
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$
The list of supported features. -
title: string
The problem's title.
-
type: string
The type of problem.
array
1
-
Array of:
object InvalidParam
An invalid parameter.
object
-
param(required): string
The name of the parameter.
-
reason: string
The reason why the parameter didn't pass validation.
503 Response
object
-
cause: string
The reason for the failure.
-
detail: string
Details about the error.
-
instance: string
The instance.
-
invalidParams: array
invalidParams
Minimum Number of Items:
1
A list of invalid parameters. -
status: integer
The status code.
-
supportedFeatures: string
Pattern:
^[A-Fa-f0-9]*$
The list of supported features. -
title: string
The problem's title.
-
type: string
The type of problem.
array
1
-
Array of:
object InvalidParam
An invalid parameter.
object
-
param(required): string
The name of the parameter.
-
reason: string
The reason why the parameter didn't pass validation.
Default Response
Examples
The following example shows how to update an Nchf converged charging session by submitting a POST request on the REST resource using cURL. For more information about cURL, see "Use cURL".
The -d option specifies the file to attach as the request body.
curl -X POST "apiroot/nchf-convergedcharging/v2/chargingdata/7e5f7eb2-6f5a-8d7d-63df-5202fadbc512/update" -H "accept: */*" -H "Content-Type: application/json" -d @file.json
where:
-
apiRoot is for accessing the HTTP Gateway server at either http://hostname:httpPort or https://hostname:httpsPort.
- file.json is the JSON file that specifies the converged charging session to update.
Example of Request Body
The following is an example of the contents of file.json sent as the request body:
{ "invocationSequenceNumber": 9, "invocationTimeStamp": "2019-09-24T07:30:33.882Z", "multipleUnitUsage": [ { "ratingGroup": 10, "requestedUnit": { "time": 600 }, "usedUnitContainer": [{ "serviceId": 123, "localSequenceNumber": 0, "quotaManagementIndicator": "ONLINE_CHARGING", "time": 600 }], "uPFID": "123e4567-e89b-12d3-a456-426655440000" } ], "nfConsumerIdentification": { "nodeFunctionality": "SMF" }, "notifyUri": "http://test-notification-url", "pDUSessionChargingInformation": { "chargingId": 1000, "pduSessionInformation": { "pduSessionID": 1, "dnnId": "1" } }, "roamingQBCInformation": {}, "subscriberIdentifier": "imsi-6500000427", "triggers": [ { "triggerCategory": "IMMEDIATE_REPORT", "triggerType": "QUOTA_THRESHOLD" } ] }
Example of Response Body
If successful, the response code 200 is returned along with a header and a response payload. The following shows sample header contents:
connection: keep-alive
content-length: 154
content-type: application/json
date: Tue, 12 Jul 2022 08:21:13 +0530
The following shows sample response body contents:
{
"invocationTimeStamp": "2019-09-24T13:00:33.882+05:30",
"invocationSequenceNumber": 9,
"multipleUnitInformation": [
{
"resultCode": "SUCCESS",
"ratingGroup": 10,
"grantedUnit": {
"time" : 600
}
}
]
}
If the request fails, the response includes the appropriate HTTP code. For a 4xx/5xx code, the message body also contains a ProblemDetails structure with the cause attribute set to the appropriate application error.