commit after CT3 147 (9a70b879) · Commits · All Groups / 5G APIs

TS29521_Nbsf_Management.yaml

+200 −6

Original line number	Diff line number	Diff line
		openapi: 3.0.0

		info:
		version: 1.5.0
		version: 1.6.0-alpha.1
		title: Nbsf_Management
		description: \|
		Binding Support Management Service API.
		© 2025, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
		© 2026, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
		All rights reserved.

		externalDocs:
		description: 3GPP TS 29.521 V19.5.0; 5G System; Binding Support Management Service.
		description: 3GPP TS 29.521 V20.0.0; 5G System; Binding Support Management Service.
		url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.521/'

		servers:
		@@ -82,6 +82,55 @@ paths:
		$ref: 'TS29571_CommonData.yaml#/components/responses/503'
		default:
		$ref: 'TS29571_CommonData.yaml#/components/responses/default'
		callbacks:
		StaleRegNotif:
		'{$request.body#/cleanUpCallbackUri}':
		post:
		requestBody:
		required: true
		content:
		application/json:
		schema:
		$ref: '#/components/schemas/BsfNotification'
		responses:
		'200':
		description: >
		The Notification is acknowledged and a response including the validity of all
		the registrations are returned.
		content:
		application/json:
		schema:
		$ref: '#/components/schemas/BsfNotificationRsp'
		'204':
		description: No Content. Notification was successful.
		'307':
		$ref: 'TS29571_CommonData.yaml#/components/responses/307'
		'308':
		$ref: 'TS29571_CommonData.yaml#/components/responses/308'
		'400':
		$ref: 'TS29571_CommonData.yaml#/components/responses/400'
		'401':
		$ref: 'TS29571_CommonData.yaml#/components/responses/401'
		'403':
		$ref: 'TS29571_CommonData.yaml#/components/responses/403'
		'404':
		$ref: 'TS29571_CommonData.yaml#/components/responses/404'
		'411':
		$ref: 'TS29571_CommonData.yaml#/components/responses/411'
		'413':
		$ref: 'TS29571_CommonData.yaml#/components/responses/413'
		'415':
		$ref: 'TS29571_CommonData.yaml#/components/responses/415'
		'429':
		$ref: 'TS29571_CommonData.yaml#/components/responses/429'
		'500':
		$ref: 'TS29571_CommonData.yaml#/components/responses/500'
		'502':
		$ref: 'TS29571_CommonData.yaml#/components/responses/502'
		'503':
		$ref: 'TS29571_CommonData.yaml#/components/responses/503'
		default:
		$ref: 'TS29571_CommonData.yaml#/components/responses/default'

		get:
		summary: Read PCF for a PDU Session Bindings information
		@@ -518,6 +567,55 @@ paths:
		$ref: 'TS29571_CommonData.yaml#/components/responses/503'
		default:
		$ref: 'TS29571_CommonData.yaml#/components/responses/default'
		callbacks:
		StaleRegNotif:
		'{$request.body#/cleanUpCallbackUri}':
		post:
		requestBody:
		required: true
		content:
		application/json:
		schema:
		$ref: '#/components/schemas/BsfNotification'
		responses:
		'200':
		description: >
		The Notification is acknowledged and a response including the validity of all
		the registrations are returned.
		content:
		application/json:
		schema:
		$ref: '#/components/schemas/BsfNotificationRsp'
		'204':
		description: No Content. Notification was successful.
		'307':
		$ref: 'TS29571_CommonData.yaml#/components/responses/307'
		'308':
		$ref: 'TS29571_CommonData.yaml#/components/responses/308'
		'400':
		$ref: 'TS29571_CommonData.yaml#/components/responses/400'
		'401':
		$ref: 'TS29571_CommonData.yaml#/components/responses/401'
		'403':
		$ref: 'TS29571_CommonData.yaml#/components/responses/403'
		'404':
		$ref: 'TS29571_CommonData.yaml#/components/responses/404'
		'411':
		$ref: 'TS29571_CommonData.yaml#/components/responses/411'
		'413':
		$ref: 'TS29571_CommonData.yaml#/components/responses/413'
		'415':
		$ref: 'TS29571_CommonData.yaml#/components/responses/415'
		'429':
		$ref: 'TS29571_CommonData.yaml#/components/responses/429'
		'500':
		$ref: 'TS29571_CommonData.yaml#/components/responses/500'
		'502':
		$ref: 'TS29571_CommonData.yaml#/components/responses/502'
		'503':
		$ref: 'TS29571_CommonData.yaml#/components/responses/503'
		default:
		$ref: 'TS29571_CommonData.yaml#/components/responses/default'

		get:
		summary: Read PCF for a UE Bindings information
		@@ -734,6 +832,55 @@ paths:
		$ref: 'TS29571_CommonData.yaml#/components/responses/503'
		default:
		$ref: 'TS29571_CommonData.yaml#/components/responses/default'
		callbacks:
		StaleRegNotif:
		'{$request.body#/cleanUpCallbackUri}':
		post:
		requestBody:
		required: true
		content:
		application/json:
		schema:
		$ref: '#/components/schemas/BsfNotification'
		responses:
		'200':
		description: >
		The Notification is acknowledged and a response including the validity of all
		the registrations are returned.
		content:
		application/json:
		schema:
		$ref: '#/components/schemas/BsfNotificationRsp'
		'204':
		description: No Content. Notification was successful.
		'307':
		$ref: 'TS29571_CommonData.yaml#/components/responses/307'
		'308':
		$ref: 'TS29571_CommonData.yaml#/components/responses/308'
		'400':
		$ref: 'TS29571_CommonData.yaml#/components/responses/400'
		'401':
		$ref: 'TS29571_CommonData.yaml#/components/responses/401'
		'403':
		$ref: 'TS29571_CommonData.yaml#/components/responses/403'
		'404':
		$ref: 'TS29571_CommonData.yaml#/components/responses/404'
		'411':
		$ref: 'TS29571_CommonData.yaml#/components/responses/411'
		'413':
		$ref: 'TS29571_CommonData.yaml#/components/responses/413'
		'415':
		$ref: 'TS29571_CommonData.yaml#/components/responses/415'
		'429':
		$ref: 'TS29571_CommonData.yaml#/components/responses/429'
		'500':
		$ref: 'TS29571_CommonData.yaml#/components/responses/500'
		'502':
		$ref: 'TS29571_CommonData.yaml#/components/responses/502'
		'503':
		$ref: 'TS29571_CommonData.yaml#/components/responses/503'
		default:
		$ref: 'TS29571_CommonData.yaml#/components/responses/default'

		get:
		summary: Retrieve an existing PCF for an MBS Session binding.
		@@ -969,6 +1116,8 @@ components:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/NfSetId'
		recoveryTime:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime'
		cleanUpCallbackUri:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/Uri'
		paraCom:
		$ref: '#/components/schemas/ParameterCombination'
		bindLevel:
		@@ -1028,6 +1177,8 @@ components:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/DiameterIdentity'
		pcfDiamRealm:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/DiameterIdentity'
		cleanUpCallbackUri:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/Uri'

		ParameterCombination:
		description: >
		@@ -1138,9 +1289,16 @@ components:
		$ref: '#/components/schemas/BsfEventNotification'
		minItems: 1
		description: Notifications about Individual Events.
		required:
		- notifCorreId
		- eventNotifs
		bindingIds:
		type: array
		items:
		type: string
		minItems: 1
		oneOf:
		- required: [bindingIds]
		- allOf:
		- required: [notifCorreId]
		- required: [eventNotifs]

		BsfEventNotification:
		description: Contains an event notification.
		@@ -1246,6 +1404,8 @@ components:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/NfInstanceId'
		recoveryTime:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime'
		cleanUpCallbackUri:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/Uri'
		pcfSetId:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/NfSetId'
		bindLevel:
		@@ -1273,6 +1433,8 @@ components:
		description: IP end points of the PCF hosting the Npcf_AmPolicyAuthorization service.
		pcfId:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/NfInstanceId'
		cleanUpCallbackUri:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/Uri'

		SnssaiDnnPair:
		description: Contains a S-NSSAI and DNN combination.
		@@ -1307,6 +1469,8 @@ components:
		$ref: '#/components/schemas/BindingLevel'
		recoveryTime:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime'
		cleanUpCallbackUri:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/Uri'
		suppFeat:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
		required:
		@@ -1329,6 +1493,36 @@ components:
		minItems: 1
		pcfId:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/NfInstanceId'
		cleanUpCallbackUri:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/Uri'

		BsfNotificationRsp:
		description: >
		Represents the BSF notification response.
		type: object
		properties:
		invalidBindingIds:
		type: array
		items:
		type: string
		minItems: 1
		validBindingIds:
		type: array
		items:
		type: string
		minItems: 1
		allRegsValid:
		type: boolean
		description: >
		Indicates the validity of all the registrations. Set to "true" to indicate that all the
		registrations identified by the "bindingIds" attribute included in the BsfNotification
		need to be maintained in BSF. Set to "false" to indicate that all the registrations
		identified by the "bindingIds" attribute included in the BsfNotification need to be
		removed from BSF. The default value doesn’t apply.
		oneOf:
		- required: [invalidBindingIds]
		- required: [validBindingIds]
		- required: [allRegsValid]

		BindingLevel:
		anyOf: