Edit TS29369_Nadm_DM.yaml (78fba7cc) · Commits · All Groups / 5G APIs

TS29369_Nadm_DM.yaml

+243 −7

Original line number	Diff line number	Diff line
		@@ -41,7 +41,7 @@ paths:
		parameters:
		- name: aiotDevPermId
		in: path
		description: AIoT Device Permanent ID
		description: AIoT Device Permanent Identifier
		required: true
		schema:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/AiotDevPermId'
		@@ -95,7 +95,7 @@ paths:
		parameters:
		- name: aiotDevPermId
		in: path
		description: AIoT Device Permanent ID
		description: AIoT Device Permanent Identifier
		required: true
		schema:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/AiotDevPermId'
		@@ -106,7 +106,7 @@ paths:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
		requestBody:
		content:
		application/merge-patch+json:
		application/json-patch+json:
		schema:
		$ref: '#/components/schemas/AiotDevProfileData'
		required: true
		@@ -168,7 +168,7 @@ paths:
		parameters:
		- name: requester-aiot-devices-id
		in: query
		description: a list of AIoT Device Permanent ID
		description: a list of AIoT Device Permanent Identifier
		required: true
		style: form
		explode: false
		@@ -329,6 +329,207 @@ paths:
		default:
		description: Unexpected error

		/af-authorization-data/subscriptions:
		post:
		summary: Create a subscription of AF Authorization Data Changes
		operationId: Subscribe AF Authorization Data Change
		tags:
		- Create a subscription of AF Authorization Data Changes
		security:
		- {}
		- oAuth2ClientCredentials:
		- nadm-dm
		- oAuth2ClientCredentials:
		- nadm-dm
		- nadm-dm:af-authorization-data:subscriptions:create
		requestBody:
		content:
		application/json:
		schema:
		$ref: '#/components/schemas/AfAuthorizationDataSubscription'
		required: true
		callbacks:
		afAuthorizationDataChangeNotification:
		'{$request.body#/notifyCalblackUri}':
		post:
		requestBody: # contents of the callback message
		required: true
		content:
		application/json:
		schema:
		$ref: '#/components/schemas/AfAuthorizationDataChangeNotification'
		responses:
		'204':
		description: successful notification
		'307':
		$ref: 'TS29571_CommonData.yaml#/components/responses/307'
		'308':
		$ref: 'TS29571_CommonData.yaml#/components/responses/308'
		'400':
		$ref: 'TS29571_CommonData.yaml#/components/responses/400'
		'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'
		responses:
		'201':
		description: successful creation of the subscription
		content:
		application/json:
		schema:
		$ref: '#/components/schemas/AfAuthorizationDataSubscription'
		headers:
		Location:
		description: >
		'Contains the URI of the newly created subscription, according to the structure:
		{apiRoot}/nadm-dm/<apiVersion>/af-authorization-data/subscriptions/{subId}'
		required: true
		schema:
		type: string
		'307':
		$ref: 'TS29571_CommonData.yaml#/components/responses/307'
		'308':
		$ref: 'TS29571_CommonData.yaml#/components/responses/308'
		'400':
		$ref: 'TS29571_CommonData.yaml#/components/responses/400'
		'401':
		$ref: 'TS29571_CommonData.yaml#/components/responses/401'
		'403':
		$ref: 'TS29571_CommonData.yaml#/components/responses/403'
		'404':
		$ref: 'TS29571_CommonData.yaml#/components/responses/404'
		'411':
		$ref: 'TS29571_CommonData.yaml#/components/responses/411'
		'413':
		$ref: 'TS29571_CommonData.yaml#/components/responses/413'
		'415':
		$ref: 'TS29571_CommonData.yaml#/components/responses/415'
		'429':
		$ref: 'TS29571_CommonData.yaml#/components/responses/429'
		'500':
		$ref: 'TS29571_CommonData.yaml#/components/responses/500'
		'502':
		$ref: 'TS29571_CommonData.yaml#/components/responses/502'
		'503':
		$ref: 'TS29571_CommonData.yaml#/components/responses/503'
		'504':
		$ref: 'TS29571_CommonData.yaml#/components/responses/504'
		default:
		$ref: 'TS29571_CommonData.yaml#/components/responses/default'

		/af-authorization-data/subscriptions/{subId}:
		patch:
		summary: Modify a subscription of AF Authorization Data Changes
		operationId: Modify Subscription of AF Authorization Data Change
		tags:
		- Modify a subscription of AF Authorization Data Changes
		security:
		- {}
		- oAuth2ClientCredentials:
		- nadm-dm
		- oAuth2ClientCredentials:
		- nadm-dm
		- nadm-dm:af-authorization-data:subscriptions:modify
		requestBody:
		content:
		application/json-patch+json:
		schema:
		type: array
		items:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/PatchItem'
		required: true
		responses:
		'200':
		description: Expected response to partially successful patch
		content:
		application/json:
		schema:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/PatchResult'
		'204':
		description: Expected response to successful patch
		'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'

		delete:
		summary: Delete a subscription of AF Authorization Data Changes
		operationId: Unsubscribe to AF Authorization Data Change
		tags:
		- Delete a subscription of AF Authorization Data Changes
		security:
		- {}
		- oAuth2ClientCredentials:
		- nadm-dm
		- oAuth2ClientCredentials:
		- nadm-dm
		- nadm-dm:af-authorization-data:subscriptions:modify
		responses:
		'204':
		description: Expected response to successful deletion
		'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'
		'429':
		$ref: 'TS29571_CommonData.yaml#/components/responses/429'
		'500':
		$ref: 'TS29571_CommonData.yaml#/components/responses/500'
		'501':
		$ref: 'TS29571_CommonData.yaml#/components/responses/501'
		'503':
		$ref: 'TS29571_CommonData.yaml#/components/responses/503'
		default:
		$ref: 'TS29571_CommonData.yaml#/components/responses/default'

		components:
		securitySchemes:
		oAuth2ClientCredentials:
		@@ -341,6 +542,8 @@ components:
		nadm-dm:aiot-device-profile-data:read: Access to read AIoT Device Profile Data
		nadm-dm:aiot-device-profile-data:modify: Access to update AIoT Device Profile Data
		nadm-dm:af-authorization-data:read: Access to read AF Authorization Data
		nadm-dm:af-authorization-data:subscriptions:create: Access to create the subscriptions of AF Authorization Data Changes
		nadm-dm:af-authorization-data:subscriptions:modify: Access to modify or delete the subscriptions of AF Authorization Data Changes

		schemas:
		#
		@@ -360,8 +563,6 @@ components:
		$ref: '#/components/schemas/LastKnownAiotfInfo'
		tidCurrent:
		$ref: '#/components/schemas/Tid'
		tidPrevious:
		$ref: '#/components/schemas/Tid'
		tidHandlingInformation:
		$ref: '#/components/schemas/TidHandlingInformation'

		@@ -426,6 +627,41 @@ components:
		additionalProperties:
		$ref: '#/components/schemas/IndividualAfAuthorizationData'
		minProperties: 1

		AfAuthorizationDataSubscription:
		description: Contains a AF Authorization Data Change Subscription.
		type: object
		required:
		- notifyCallbackUri
		- notifyCorrelationId
		properties:
		notifyCallbackUri:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/Uri'
		notifyCorrelationId
		type: string
		afId:
		$ref: '#/components/schemas/AfId'
		expiry:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/DateTime'

		AfAuthorizationDataChangeNotification:
		description: Contains a AF Authorization Data Change Notification.
		type: object
		required:
		- udpateAfAuthData
		- notifyCorrelationId
		properties:
		udpateAfAuthData:
		type: object
		description: >
		'Map carrying the Updated AF Authorization Data.
		The key of the map is the AF ID of the corresponding Authorization Data'
		additionalProperties:
		$ref: '#/components/schemas/IndividualAfAuthorizationData'
		minProperties: 1
		notifyCorrelationId
		type: string

		#
		# SIMPLE TYPES
		#
		@@ -435,7 +671,7 @@ components:
		type: string

		Tid:
		description: Temporary ID of the AIoT device.
		description: Temporary Identifier of the AIoT device.
		type: string
		pattern: '^[A-Fa-f0-9]{32}$'