diff --git a/UEAppInterfaceApi.json b/UEAppInterfaceApi.json index 55c431e2c30ed34b426927beb692da9c874a3707..e897b4d07d83d4d97ab8209be7cd4a49a787b828 100644 --- a/UEAppInterfaceApi.json +++ b/UEAppInterfaceApi.json @@ -1,6 +1,9 @@ { "openapi": "3.0.0", "info": { + "contact": { + "url": "https://forge.etsi.org/rep/mec/gs016-dev-app-api" + }, "title": "ETSI GS MEC 016 Device application interface", "version": "2.2.1", "description": "The ETSI MEC ISG Device application interface API described using OpenAPI.", @@ -15,14 +18,19 @@ }, "servers": [ { - "url": "https://{apiRoot}/dev_app/v1" + "url": "https://localhost/dev_app/v1" + } + ], + "tags": [ + { + "name": "dev_app" } ], "paths": { "/app_list": { "get": { "tags": [ - "" + "dev_app" ], "summary": "Get available application information.", "description": "Used to query information about the available MEC applications.", @@ -78,7 +86,7 @@ "/app_contexts": { "post": { "tags": [ - "" + "dev_app" ], "summary": "Creation of a new application context.", "description": "Used to create a new application context. Upon success, the response contains entity body describing the created application context.", @@ -188,7 +196,7 @@ "/app_contexts/{contextId}": { "put": { "tags": [ - "" + "dev_app" ], "summary": "Updating the callbackReference and/or appLocation of an existing application context.", "description": "Used to update the callback reference and/or application location constraints of an existing application context. Upon successful operation, the target resource is updated with the new application context information.", @@ -234,7 +242,7 @@ }, "delete": { "tags": [ - "" + "dev_app" ], "summary": "Deletion of an existing application context.", "description": "Used to delete the resource that represents the existing application context.", @@ -266,7 +274,7 @@ "/obtain_app_loc_availability": { "post": { "tags": [ - "" + "dev_app" ], "summary": "Obtain the location constraints for a new application context.", "description": "Used to obtain the locations available for instantiation of a specific user application in the MEC system.", @@ -573,20 +581,7 @@ "x-etsi-mec-origin-type": "String" }, "appLocation": { - "allOf": [ - { - "$ref": "#/components/schemas/LocationConstraints" - }, - { - "description": "Location of the user application instance. For a user application not provided by the requesting device application it shall match one of the appLocations in ApplicationList." - }, - { - "x-etsi-mec-cardinality": "0..1" - }, - { - "x-etsi-mec-origin-type": "LocationConstraints" - } - ] + "$ref": "#/components/schemas/LocationConstraints" }, "referenceURI": { "description": "Address of the user application instance. It shall only be included in the response.", @@ -697,20 +692,7 @@ "x-etsi-mec-origin-type": "String" }, "appLocation": { - "allOf": [ - { - "$ref": "#/components/schemas/LocationConstraints" - }, - { - "description": "Location of the user application instance." - }, - { - "x-etsi-mec-cardinality": "0..1" - }, - { - "x-etsi-mec-origin-type": "LocationConstraints" - } - ] + "$ref": "#/components/schemas/LocationConstraints" }, "referenceURI": { "description": "Address of the user application instance.", @@ -755,21 +737,21 @@ "bandwidth": { "description": "The required connection bandwidth in kbit/s for the use of the MEC application instance. ", "type": "integer", - "format": "uint32", + "format": "int32", "x-etsi-mec-cardinality": "0..1", "x-etsi-mec-origin-type": "uint32" }, "latency": { "description": "The target round trip time in milliseconds supported by the MEC system for the MEC application instance.", "type": "integer", - "format": "uint32", + "format": "int32", "x-etsi-mec-cardinality": "0..1", "x-etsi-mec-origin-type": "uint32" }, "memory": { "description": "The maximum size in Mbytes of the memory resource expected to be used by the MEC application instance in the MEC system.", "type": "integer", - "format": "uint32", + "format": "int32", "x-etsi-mec-cardinality": "0..1", "x-etsi-mec-origin-type": "uint32" }, @@ -779,14 +761,14 @@ 0, 1 ], - "type": "string", + "type": "integer", "x-etsi-mec-cardinality": "0..1", "x-etsi-mec-origin-type": "Enum" }, "storage": { "description": "The maximum size in Mbytes of the storage resource expected to be used by the MEC application instance in the MEC system.", "type": "integer", - "format": "uint32", + "format": "int32", "x-etsi-mec-cardinality": "0..1", "x-etsi-mec-origin-type": "uint32" } @@ -943,20 +925,7 @@ "type": "object", "properties": { "appLocation": { - "allOf": [ - { - "$ref": "#/components/schemas/LocationConstraints" - }, - { - "description": "Shall only be included in the response, where it indicates a location constraint available in the MEC system." - }, - { - "x-etsi-mec-cardinality": "0..1" - }, - { - "x-etsi-mec-origin-type": "LocationConstraints" - } - ] + "$ref": "#/components/schemas/LocationConstraints" } } }, @@ -998,20 +967,7 @@ "type": "object", "properties": { "appLocation": { - "allOf": [ - { - "$ref": "#/components/schemas/LocationConstraints" - }, - { - "description": "It shall match one of the appLocations in the AppContext sent in the Application context create " - }, - { - "x-etsi-mec-cardinality": "1" - }, - { - "x-etsi-mec-origin-type": "LocationConstraints" - } - ] + "$ref": "#/components/schemas/LocationConstraints" } } }, @@ -1046,20 +1002,7 @@ "LocationConstraints": { "properties": { "area": { - "allOf": [ - { - "$ref": "#/components/schemas/Polygon" - }, - { - "description": "Geographic area. Shall be absent if the \"civicAddressElement\" attribute is present. The content of this attribute shall follow the provisions for the \"Polygon\" geometry object as defined in IETF RFC 7946 [8], for which the \"type\" member shall be set to the value \"Polygon\". See note." - }, - { - "x-etsi-mec-cardinality": "0..1" - }, - { - "x-etsi-mec-origin-type": "Polygon" - } - ] + "$ref": "#/components/schemas/Polygon" }, "civicAddressElement": { "description": "Zero or more elements comprising the civic address. Shall be absent if the \"area\" attribute is present.", @@ -1139,7 +1082,7 @@ }, "status": { "description": "The HTTP status code for this occurrence of the problem", - "format": "uint32", + "format": "int32", "type": "integer", "x-etsi-mec-cardinality": "0..1", "x-etsi-mec-origin-type": "Uint32" diff --git a/UEAppInterfaceApi.yaml b/UEAppInterfaceApi.yaml index 608dfd91932ebc995f76cb80c1a9f083d36a489a..dd88735b82f30cdf84756e316b06f67120d98d13 100644 --- a/UEAppInterfaceApi.yaml +++ b/UEAppInterfaceApi.yaml @@ -1,5 +1,7 @@ openapi: 3.0.0 info: + contact: + url: https://forge.etsi.org/rep/mec/gs016-dev-app-api title: 'ETSI GS MEC 016 Device application interface' version: 2.2.1 description: The ETSI MEC ISG Device application interface API described using OpenAPI. @@ -12,13 +14,16 @@ externalDocs: url: 'https://www.etsi.org/deliver/etsi_gs/MEC/001_099/016/02.02.01_60/gs_MEC016v020201p.pdf' servers: - - url: 'https://{apiRoot}/dev_app/v1' + - url: 'https://localhost/dev_app/v1' + +tags: +- name: "dev_app" paths: /app_list: get: tags: - - "" + - "dev_app" summary: "Get available application information." description: "Used to query information about the available MEC applications." operationId: "meAppListGET" @@ -49,7 +54,7 @@ paths: /app_contexts: post: tags: - - "" + - "dev_app" summary: "Creation of a new application context." description: "Used to create a new application context. Upon success, the response contains entity body describing the created application context." operationId: "devAppContextsGET" @@ -89,7 +94,7 @@ paths: summary: 'Callback POST used to send a notification' description: 'Notification with content based on subscription type' operationId: notificationPOST - requestBody: + requestBody: description: Subscription notification required: true content: @@ -115,7 +120,7 @@ paths: /app_contexts/{contextId}: put: tags: - - "" + - "dev_app" summary: "Updating the callbackReference and/or appLocation of an existing application context." description: "Used to update the callback reference and/or application location constraints of an existing application context. Upon successful operation, the target resource is updated with the new application context information." operationId: "devAppContextPUT" @@ -144,7 +149,7 @@ paths: $ref: '#/components/responses/404' delete: tags: - - "" + - "dev_app" summary: "Deletion of an existing application context." description: "Used to delete the resource that represents the existing application context." operationId: "devAppContextDELETE" @@ -164,7 +169,7 @@ paths: /obtain_app_loc_availability: post: tags: - - "" + - "dev_app" summary: "Obtain the location constraints for a new application context." description: "Used to obtain the locations available for instantiation of a specific user application in the MEC system." operationId: "appLocationAvailabilityPOST" @@ -391,11 +396,10 @@ components: x-etsi-mec-cardinality: 0..1 x-etsi-mec-origin-type: String appLocation: - allOf: - - $ref: '#/components/schemas/LocationConstraints' - - description: 'Location of the user application instance. For a user application not provided by the requesting device application it shall match one of the appLocations in ApplicationList.' - - x-etsi-mec-cardinality: 0..1 - - x-etsi-mec-origin-type: LocationConstraints + $ref: '#/components/schemas/LocationConstraints' + # description: 'Location of the user application instance. For a user application not provided by the requesting device application it shall match one of the appLocations in ApplicationList.' + # x-etsi-mec-cardinality: 0..1 + # x-etsi-mec-origin-type: LocationConstraints referenceURI: description: 'Address of the user application instance. It shall only be included in the response.' format: uri @@ -489,11 +493,10 @@ components: x-etsi-mec-cardinality: '1' x-etsi-mec-origin-type: String appLocation: - allOf: - - $ref: '#/components/schemas/LocationConstraints' - - description: Location of the user application instance. - - x-etsi-mec-cardinality: 0..1 - - x-etsi-mec-origin-type: LocationConstraints + $ref: '#/components/schemas/LocationConstraints' + # description: Location of the user application instance. + # x-etsi-mec-cardinality: 0..1 + # x-etsi-mec-origin-type: LocationConstraints referenceURI: description: Address of the user application instance. format: uri @@ -529,19 +532,19 @@ components: bandwidth: description: 'The required connection bandwidth in kbit/s for the use of the MEC application instance. ' type: integer - format: uint32 + format: int32 x-etsi-mec-cardinality: 0..1 x-etsi-mec-origin-type: uint32 latency: description: The target round trip time in milliseconds supported by the MEC system for the MEC application instance. type: integer - format: uint32 + format: int32 x-etsi-mec-cardinality: 0..1 x-etsi-mec-origin-type: uint32 memory: description: The maximum size in Mbytes of the memory resource expected to be used by the MEC application instance in the MEC system. type: integer - format: uint32 + format: int32 x-etsi-mec-cardinality: 0..1 x-etsi-mec-origin-type: uint32 serviceCont: @@ -551,13 +554,13 @@ components: enum: - 0 - 1 - type: string + type: integer x-etsi-mec-cardinality: 0..1 x-etsi-mec-origin-type: Enum storage: description: The maximum size in Mbytes of the storage resource expected to be used by the MEC application instance in the MEC system. type: integer - format: uint32 + format: int32 x-etsi-mec-cardinality: 0..1 x-etsi-mec-origin-type: uint32 type: object @@ -687,11 +690,10 @@ components: type: object properties: appLocation: - allOf: - - $ref: '#/components/schemas/LocationConstraints' - - description: Shall only be included in the response, where it indicates a location constraint available in the MEC system. - - x-etsi-mec-cardinality: 0..1 - - x-etsi-mec-origin-type: LocationConstraints + $ref: '#/components/schemas/LocationConstraints' + # description: Shall only be included in the response, where it indicates a location constraint available in the MEC system. + # x-etsi-mec-cardinality: 0..1 + # x-etsi-mec-origin-type: LocationConstraints minItems: 0 type: array x-etsi-mec-cardinality: 0..N @@ -722,11 +724,10 @@ components: type: object properties: appLocation: - allOf: - - $ref: '#/components/schemas/LocationConstraints' - - description: 'It shall match one of the appLocations in the AppContext sent in the Application context create ' - - x-etsi-mec-cardinality: '1' - - x-etsi-mec-origin-type: LocationConstraints + $ref: '#/components/schemas/LocationConstraints' + # description: 'It shall match one of the appLocations in the AppContext sent in the Application context create ' + # x-etsi-mec-cardinality: '1' + # x-etsi-mec-origin-type: LocationConstraints minItems: 1 required: - appLocation @@ -751,11 +752,10 @@ components: LocationConstraints: properties: area: - allOf: - - $ref: '#/components/schemas/Polygon' - - description: "Geographic area. Shall be absent if the \"civicAddressElement\" attribute is present. The content of this attribute shall follow the provisions for the \"Polygon\" geometry object as defined in IETF RFC 7946 [8], for which the \"type\" member shall be set to the value \"Polygon\". See note." - - x-etsi-mec-cardinality: 0..1 - - x-etsi-mec-origin-type: Polygon + $ref: '#/components/schemas/Polygon' + # description: "Geographic area. Shall be absent if the \"civicAddressElement\" attribute is present. The content of this attribute shall follow the provisions for the \"Polygon\" geometry object as defined in IETF RFC 7946 [8], for which the \"type\" member shall be set to the value \"Polygon\". See note." + # x-etsi-mec-cardinality: 0..1 + # x-etsi-mec-origin-type: Polygon civicAddressElement: description: Zero or more elements comprising the civic address. Shall be absent if the "area" attribute is present. items: @@ -822,7 +822,7 @@ components: x-etsi-mec-origin-type: URI status: description: The HTTP status code for this occurrence of the problem - format: uint32 + format: int32 type: integer x-etsi-mec-cardinality: 0..1 x-etsi-mec-origin-type: Uint32