Edit TS29437_SS_SAnUsage.yaml with CRs agreed in CT3#145 meeting. (1d23e868) · Commits · All Groups / 5G APIs

TS29437_SS_SAnUsage.yaml

+69 −69

Original line number	Diff line number	Diff line
		@@ -4,7 +4,7 @@ info:
		title: SAn Server Spatial Anchor Usage Service
		version: 1.0.1
		description: \|
		API for Spatial Anchor Usage Service.
		API for SAn Server Spatial Anchor Usage Service.
		©2025, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
		All rights reserved.

		@@ -83,6 +83,47 @@ paths:
		$ref: 'TS29122_CommonData.yaml#/components/responses/503'
		default:
		$ref: 'TS29122_CommonData.yaml#/components/responses/default'
		callbacks:
		SpatialAnchorsUsageInfoNotif:
		'{$request.body#/notifUri}':
		post:
		requestBody:
		required: true
		content:
		application/json:
		schema:
		$ref: '#/components/schemas/SpatialAnchorsUsageInfoNotif'
		responses:
		'204':
		description: >
		No Content. The Spatial Anchors Usage Information Notification is successfully
		received and acknowledged.
		'307':
		$ref: 'TS29122_CommonData.yaml#/components/responses/307'
		'308':
		$ref: 'TS29122_CommonData.yaml#/components/responses/308'
		'400':
		$ref: 'TS29122_CommonData.yaml#/components/responses/400'
		'401':
		$ref: 'TS29122_CommonData.yaml#/components/responses/401'
		'403':
		$ref: 'TS29122_CommonData.yaml#/components/responses/403'
		'404':
		$ref: 'TS29122_CommonData.yaml#/components/responses/404'
		'411':
		$ref: 'TS29122_CommonData.yaml#/components/responses/411'
		'413':
		$ref: 'TS29122_CommonData.yaml#/components/responses/413'
		'415':
		$ref: 'TS29122_CommonData.yaml#/components/responses/415'
		'429':
		$ref: 'TS29122_CommonData.yaml#/components/responses/429'
		'500':
		$ref: 'TS29122_CommonData.yaml#/components/responses/500'
		'503':
		$ref: 'TS29122_CommonData.yaml#/components/responses/503'
		default:
		$ref: 'TS29122_CommonData.yaml#/components/responses/default'

		/subscriptions/{subscriptionId}:
		parameters:
		@@ -234,6 +275,7 @@ paths:
		$ref: 'TS29122_CommonData.yaml#/components/responses/503'
		default:
		$ref: 'TS29122_CommonData.yaml#/components/responses/default'

		delete:
		summary: Delete an existing Individual Spatial Anchors Usage Information Subscription resource.
		operationId: DeleteIndSpatialAnchorsUsageInfoSub
		@@ -268,7 +310,7 @@ paths:
		/report:
		post:
		summary: Enables a service consumer to report the spatial anchor usage information.
		operationId: RequestSpatialAnchorsUsageInfo
		operationId: ReportSpatialAnchorsUsageInfo
		tags:
		- Report Spatial Anchor Usage Information
		requestBody:
		@@ -280,57 +322,8 @@ paths:
		responses:
		'204':
		description: >
		Created. The Spatial Anchor Usage Information is successfully received and
		No Content. The reported Spatial Anchor Usage Information is successfully received and
		processed.
		content:
		application/json:
		schema:
		$ref: '#/components/schemas/SpatialAnchorsUsageInfoSub'
		headers:
		Location:
		description: >
		Contains an alternative target URI located in an alternative San Server.
		required: true
		schema:
		type: string
		'400':
		$ref: 'TS29122_CommonData.yaml#/components/responses/400'
		'401':
		$ref: 'TS29122_CommonData.yaml#/components/responses/401'
		'403':
		$ref: 'TS29122_CommonData.yaml#/components/responses/403'
		'404':
		$ref: 'TS29122_CommonData.yaml#/components/responses/404'
		'411':
		$ref: 'TS29122_CommonData.yaml#/components/responses/411'
		'413':
		$ref: 'TS29122_CommonData.yaml#/components/responses/413'
		'415':
		$ref: 'TS29122_CommonData.yaml#/components/responses/415'
		'429':
		$ref: 'TS29122_CommonData.yaml#/components/responses/429'
		'500':
		$ref: 'TS29122_CommonData.yaml#/components/responses/500'
		'503':
		$ref: 'TS29122_CommonData.yaml#/components/responses/503'
		default:
		$ref: 'TS29122_CommonData.yaml#/components/responses/default'

		callbacks:
		SpatialAnchorsUsageInfoNotif:
		'{$request.body#/notifUri}':
		post:
		requestBody:
		required: true
		content:
		application/json:
		schema:
		$ref: 'TS29122_CommonData.yaml#/components/schemas/Uri'
		responses:
		'204':
		description: >
		No Content. The Spatial Anchors Usage Information Notification Successfully
		received and acknowledged.
		'307':
		$ref: 'TS29122_CommonData.yaml#/components/responses/307'
		'308':
		@@ -366,6 +359,7 @@ components:
		clientCredentials:
		tokenUrl: "{tokenUrl}"
		scopes: {}

		schemas:
		#
		# STRUCTURED DATA TYPES
		@@ -384,6 +378,8 @@ components:
		$ref: 'TS29122_CommonData.yaml#/components/schemas/Uri'
		report:
		$ref: '#/components/schemas/SpatialAnchorsUsageInfoNotif'
		sampInt:
		$ref: 'TS29122_CommonData.yaml#/components/schemas/DurationSec'
		reportReq:
		$ref: 'TS29523_Npcf_EventExposure.yaml#/components/schemas/ReportingInformation'
		expTime:
		@@ -392,7 +388,6 @@ components:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
		required:
		- eventSubs
		- notifUri

		SpatialAnchorsUsageInfoSubPatch:
		description: >
		@@ -404,8 +399,10 @@ components:
		items:
		$ref: '#/components/schemas/AnchorsUsageSub'
		minItems: 1
		notiUri:
		notifUri:
		$ref: 'TS29122_CommonData.yaml#/components/schemas/Uri'
		sampInt:
		$ref: 'TS29122_CommonData.yaml#/components/schemas/DurationSec'
		reportReq:
		$ref: 'TS29523_Npcf_EventExposure.yaml#/components/schemas/ReportingInformation'
		expTime:
		@@ -448,14 +445,11 @@ components:
		$ref: 'TS29558_Eecs_EESRegistration.yaml#/components/schemas/ServiceArea'
		appId:
		type: string
		sampInt:
		$ref: 'TS29122_CommonData.yaml#/components/schemas/DurationSec'
		anyOf:
		- required: [anchIds]
		- required: [anchLoc]
		- required: [area]
		- required: [appId]
		- required: [sampInt]

		SpatialAnchorsUsageInfoNotif:
		description: >
		@@ -523,6 +517,8 @@ components:
		items:
		$ref: '#/components/schemas/AnchorUsage'
		minItems: 1
		suppFeat:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
		required:
		- anchUsg

		@@ -537,6 +533,9 @@ components:
		$ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger'
		repPer:
		$ref: 'TS29122_CommonData.yaml#/components/schemas/TimeWindow'
		required:
		- anchId
		- access

		SpatialAnchorsUsageInfo:
		description: >
		@@ -575,3 +574,4 @@ components:
		# Data types describing alternative data types or combinations of data types:
		#