Updated description to GS version 1.1.1, i.e. the published version (bc793c40) · Commits · MEC - Multi-access Edge Computing / Bandwidth Management API

BwManagementApi.json

+616 −620

Original line number	Original line	Diff line number	Diff line
	{		{
	"swagger": "2.0",		"swagger": "2.0",
	"info": {		"info": {
	"description": "An initial attempt to describe the MEC Bandwidth Management API using OpenAPI",		"description": "The ETSI MEC ISG MEC015 Bandwidth Management API described using OpenAPI",
	"version": "0.3.3",		"version": "1.1.1",
	"title": "Bandwidth Management API",		"title": "BWM API",
	"termsOfService": "TBD",
	"contact": {
	"name": "TBD",
	"url": "TBD"
	},
	"license": {		"license": {
	"name": "ETSI MEC",		"name": "ETSI Forge copyright notice",
	"url": "TBD"		"url": "https://forge.etsi.org/etsi-forge-copyright-notice.txt"
	}		}
	},		},
	"externalDocs": {		"externalDocs": {
	"description": "ETSI MEC015 V0.3.3 Bandwidth Management API",		"description": "ETSI MEC015 V1.1.1 Bandwidth Management API",
	"url": "https://docbox.etsi.org/ISG/MEC/70-Draft/0015BandMngtAPI"		"url": "http://www.etsi.org/deliver/etsi_gs/MEC/001_099/015/01.01.01_60/gs_MEC015v010101p.pdf"
	},		},
	"host": "127.0.0.1:8081",		"host": "127.0.0.1:8081",
	"basePath": "/bwm/v1",		"basePath": "/bwm/v1",
	@@ -96,7 +91,7 @@
	"Query.SessionId": {		"Query.SessionId": {
	"name": "session_id",		"name": "session_id",
	"in": "query",		"in": "query",
	"description": "A mobile edge application instance may use session_id as an input parameter to query the bandwitdth allocation of a list of sessions. ",		"description": "A mobile edge application instance may use session_id as an input parameter to query the bandwidth allocation of a list of sessions. ",
	"required": false,		"required": false,
	"type": "array",		"type": "array",
	"items": {		"items": {
	@@ -219,7 +214,7 @@
	}		}
	},		},
	"404": {		"404": {
	"description": "TIt is used when a client provided a URI that cannot be mapped to a valid resource URI. In the returned ProblemDetails structure, the \"detail\" attribute should convey more information about the error.",		"description": "It is used when a client provided a URI that cannot be mapped to a valid resource URI. In the returned ProblemDetails structure, the \"detail\" attribute should convey more information about the error.",
	"schema": {		"schema": {
	"properties": {		"properties": {
	"ProblemDetails": {		"ProblemDetails": {
	@@ -233,7 +228,7 @@
	},		},
	"/bw_allocations/{allocationId}": {		"/bw_allocations/{allocationId}": {
	"get": {		"get": {
	"description": "This method retrieves information about a a bandwidthAllocation resource. ",		"description": "This method retrieves information about a specific bandwidthAllocation resource. ",
	"produces": [		"produces": [
	"application/json"		"application/json"
	],		],
	@@ -282,7 +277,7 @@
	}		}
	},		},
	"put": {		"put": {
	"description": "This method updates the information about a bandwidthAllocation resource. ",		"description": "This method updates the information about a specific bandwidthAllocation resource. ",
	"produces": [		"produces": [
	"application/json"		"application/json"
	],		],
	@@ -354,7 +349,7 @@
	}		}
	},		},
	"patch": {		"patch": {
	"description": "This method updates the information about a bandwidthAllocation resource. ",		"description": "This method updates the information about a specific bandwidthAllocation resource. ",
	"produces": [		"produces": [
	"application/json"		"application/json"
	],		],
	@@ -426,7 +421,7 @@
	}		}
	},		},
	"delete": {		"delete": {
	"description": "DELETE method is typically used in \"Unregister from Bandwidth Management Service \" procedure",		"description": "Remove a specific bandwidthAllocation resource. DELETE method is typically used in \"Unregister from Bandwidth Management Service\" procedure",
	"produces": [		"produces": [
	"application/json"		"application/json"
	],		],
	@@ -583,10 +578,11 @@
	}		}
	},		},
	"AppInsId": {		"AppInsId": {
	"description": "application instance identifier",		"description": "Application instance identifier",
	"type": "string"		"type": "string"
	},		},
	"RequestType": {		"RequestType": {
			"description": "Numeric value (0 - 255) corresponding to specific type of consumer",
	"type": "string",		"type": "string",
	"enum": [		"enum": [
	"APPLICATION_SPECIFIC_BW_ALLOCATION",		"APPLICATION_SPECIFIC_BW_ALLOCATION",
	@@ -594,7 +590,7 @@
	]		]
	},		},
	"SessionFilter": {		"SessionFilter": {
	"description": "Session filtering criteria, applicable whenWhen requestType is from type session specific:set as SESSION_SPECIFIC_BW_ALLOCATION Session filtering criteria. Any filtering criteria should suite shall define a single session only. In case multiple sessions match sessionFilterof suitable multiple sessions the request should shall be rejected",		"description": "Session filtering criteria, applicable when requestType is set as SESSION_SPECIFIC_BW_ALLOCATION. Any filtering criteria shall define a single session only. In case multiple sessions match sessionFilter the request shall be rejected",
	"type": "array",		"type": "array",
	"items": {		"items": {
	"type": "object",		"type": "object",
	@@ -634,7 +630,7 @@
	"enum": [		"enum": [
	"00 = Downlink (towards the UE)",		"00 = Downlink (towards the UE)",
	"01 = Uplink (towards the application/session)",		"01 = Uplink (towards the application/session)",
	"10 = symmetrical"		"10 = Symmetrical"
	]		]
	},		},
	"Seconds": {		"Seconds": {
	@@ -643,7 +639,7 @@
	"format": "uint32"		"format": "uint32"
	},		},
	"NanoSeconds": {		"NanoSeconds": {
	"description": "Time in nanoseconds in Unix-time since January 1, 1970, 00:00:00 UTC",		"description": "The nanoseconds part of the Time. Time is defined as Unix-time since January 1, 1970, 00:00:00 UTC",
	"type": "integer",		"type": "integer",
	"format": "uint32"		"format": "uint32"
	},		},

BwManagementApi.yaml

+20 −25

Original line number	Original line	Diff line number	Diff line
	swagger: '2.0'		swagger: '2.0'
	info:		info:
	description: >-		description: >-
	An initial attempt to describe the MEC Bandwidth Management API using		The ETSI MEC ISG MEC015 Bandwidth Management API described using OpenAPI
	OpenAPI		version: 1.1.1
	version: 0.3.3		title: BWM API
	title: Bandwidth Management API
	termsOfService: TBD
	contact:
	name: TBD
	url: TBD
	license:		license:
	name: ETSI MEC		name: ETSI Forge copyright notice
	url: TBD		url: 'https://forge.etsi.org/etsi-forge-copyright-notice.txt'
	externalDocs:		externalDocs:
	description: ETSI MEC015 V0.3.3 Bandwidth Management API		description: ETSI MEC015 V1.1.1 Bandwidth Management API
	url: 'https://docbox.etsi.org/ISG/MEC/70-Draft/0015BandMngtAPI'		url: 'http://www.etsi.org/deliver/etsi_gs/MEC/001_099/015/01.01.01_60/gs_MEC015v010101p.pdf'
	host: '127.0.0.1:8081'		host: '127.0.0.1:8081'
	basePath: /bwm/v1		basePath: /bwm/v1
	schemes:		schemes:
	@@ -34,7 +29,6 @@ securityDefinitions:
	tokenUrl: 'https://oauth.exampleAPI/token'		tokenUrl: 'https://oauth.exampleAPI/token'
	scopes:		scopes:
	all: Single oauth2 scope for API		all: Single oauth2 scope for API

	parameters:		parameters:
	Body.BwInfo:		Body.BwInfo:
	name: bwInfo		name: bwInfo
	@@ -81,7 +75,7 @@ parameters:
	name: session_id		name: session_id
	in: query		in: query
	description: >-		description: >-
	A mobile edge application instance may use session_id as an input parameter to query the bandwitdth allocation of a list of sessions.		A mobile edge application instance may use session_id as an input parameter to query the bandwidth allocation of a list of sessions.
	required: false		required: false
	type: array		type: array
	items:		items:
	@@ -163,7 +157,7 @@ paths:
	$ref: '#/definitions/ProblemDetails'		$ref: '#/definitions/ProblemDetails'
	'404':		'404':
	description: >-		description: >-
	TIt is used when a client provided a URI that cannot be mapped to a valid resource URI. In the returned ProblemDetails structure, the "detail" attribute should convey more information about the error.		It is used when a client provided a URI that cannot be mapped to a valid resource URI. In the returned ProblemDetails structure, the "detail" attribute should convey more information about the error.
	schema:		schema:
	properties:		properties:
	ProblemDetails:		ProblemDetails:
	@@ -171,7 +165,7 @@ paths:
	/bw_allocations/{allocationId}:		/bw_allocations/{allocationId}:
	get:		get:
	description: >-		description: >-
	This method retrieves information about a a bandwidthAllocation resource.		This method retrieves information about a specific bandwidthAllocation resource.
	produces:		produces:
	- application/json		- application/json
	parameters:		parameters:
	@@ -209,7 +203,7 @@ paths:
	$ref: '#/definitions/ProblemDetails'		$ref: '#/definitions/ProblemDetails'
	put:		put:
	description: >-		description: >-
	This method updates the information about a bandwidthAllocation resource.		This method updates the information about a specific bandwidthAllocation resource.
	produces:		produces:
	- application/json		- application/json
	parameters:		parameters:
	@@ -256,7 +250,7 @@ paths:
	$ref: '#/definitions/ProblemDetails'		$ref: '#/definitions/ProblemDetails'
	patch:		patch:
	description: >-		description: >-
	This method updates the information about a bandwidthAllocation resource.		This method updates the information about a specific bandwidthAllocation resource.
	produces:		produces:
	- application/json		- application/json
	parameters:		parameters:
	@@ -302,7 +296,7 @@ paths:
	ProblemDetails:		ProblemDetails:
	$ref: '#/definitions/ProblemDetails'		$ref: '#/definitions/ProblemDetails'
	delete:		delete:
	description: DELETE method is typically used in "Unregister from Bandwidth Management Service " procedure		description: Remove a specific bandwidthAllocation resource. DELETE method is typically used in "Unregister from Bandwidth Management Service" procedure
	produces:		produces:
	- application/json		- application/json
	parameters:		parameters:
	@@ -411,16 +405,18 @@ definitions:
	$ref: '#/definitions/NanoSeconds'		$ref: '#/definitions/NanoSeconds'
	AppInsId:		AppInsId:
	description: >-		description: >-
	application instance identifier		Application instance identifier
	type: string		type: string
	RequestType:		RequestType:
			description: >-
			Numeric value (0 - 255) corresponding to specific type of consumer
	type: string		type: string
	enum:		enum:
	- APPLICATION_SPECIFIC_BW_ALLOCATION		- APPLICATION_SPECIFIC_BW_ALLOCATION
	- SESSION_SPECIFIC_BW_ALLOCATION		- SESSION_SPECIFIC_BW_ALLOCATION
	SessionFilter:		SessionFilter:
	description: >-		description: >-
	Session filtering criteria, applicable whenWhen requestType is from type session specific:set as SESSION_SPECIFIC_BW_ALLOCATION Session filtering criteria. Any filtering criteria should suite shall define a single session only. In case multiple sessions match sessionFilterof suitable multiple sessions the request should shall be rejected		Session filtering criteria, applicable when requestType is set as SESSION_SPECIFIC_BW_ALLOCATION. Any filtering criteria shall define a single session only. In case multiple sessions match sessionFilter the request shall be rejected
	type: array		type: array
	items:		items:
	type: object		type: object
	@@ -452,7 +448,7 @@ definitions:
	enum:		enum:
	- 00 = Downlink (towards the UE)		- 00 = Downlink (towards the UE)
	- 01 = Uplink (towards the application/session)		- 01 = Uplink (towards the application/session)
	- 10 = symmetrical		- 10 = Symmetrical
	Seconds:		Seconds:
	description: >-		description: >-
	The seconds part of the Time. Time is defined as Unix-time since January 1, 1970, 00:00:00 UTC		The seconds part of the Time. Time is defined as Unix-time since January 1, 1970, 00:00:00 UTC
	@@ -460,7 +456,7 @@ definitions:
	format: uint32		format: uint32
	NanoSeconds:		NanoSeconds:
	description: >-		description: >-
	Time in nanoseconds in Unix-time since January 1, 1970, 00:00:00 UTC		The nanoseconds part of the Time. Time is defined as Unix-time since January 1, 1970, 00:00:00 UTC
	type: integer		type: integer
	format: uint32		format: uint32
	SourceIp:		SourceIp:
	@@ -487,4 +483,3 @@ definitions:
	description: >-		description: >-
	Protocol number		Protocol number
	type: string		type: string
			No newline at end of file

Admin message