summary:Retrieve a list of system_info resources (see clause 6 for data model) of federation members.
description:The GET method retrieves the information of a list of system_info resources of federation members. This method is typically used in the sequence of "MEC system discovery" as described in clause 5.2.2.2. The method shall comply with the URI query parameters, request and response data structures, and response codes, as specified in Tables 7.3.3.1-1 and 7.3.3.1-2.
description:It is used to indicate that the query for retrieving system_info resource(s) is successful. Response body containing one or multiple system_info resources shall be returned.
@@ -46,7 +45,7 @@ paths:
post:
summary:Create new system_info resource for a given MEC system.
summary:Retrieve the system_info resource of the federation member with systemId as its system identifier.
description:The GET method retrieves the system_info resource information. This method is typically used in the sequence of "MEC system discovery" as described in clause 5.2.2.2. The method shall comply with the URI query parameters, request and response data structures, and response codes, as specified in Tables 7.4.3.1-1 and 7.4.3.1-2.
operationId:systeminfoByIdGET
operationId:FedresourcesSysteminfoGETSystemid
tags:
-systemInfo
parameters:
-$ref:'#/components/parameters/Path.systemId'
responses:
'200':
description:It is used to indicate that the query for retrieving system_info resource is successful. Response body containing one system_info resource shall be returned.
@@ -107,14 +105,19 @@ paths:
$ref:'#/components/responses/403'
'404':
$ref:'#/components/responses/404'
parameters:
-name:systemId
in:path
required:true
description:The unique identifier of the systemId.
schema:
type:string
patch:
summary:Update the system_info resource for a given MEC system.
description:The PATCH method updates the information of system_info resources stored in the MEC federator through previous registration. This method is typically used in the sequence of "Update of MEC system to the federation" as described in clause 5.2.2.2. The method shall comply with the URI query parameters, request and response data structures, and response codes, as specified in Tables 7.4.3.3-1 and 7.4.3.3-2.
operationId:systeminfoByIdPATCH
operationId:FedresourcesSysteminfoPATCHSystemid
tags:
-systemInfo
parameters:
-$ref:'#/components/parameters/Path.systemId'
requestBody:
description:It contains attributes to be update.
required:true
@@ -143,14 +146,19 @@ paths:
$ref:'#/components/responses/403'
'404':
$ref:'#/components/responses/404'
parameters:
-name:systemId
in:path
required:true
description:The unique identifier of the systemId.
schema:
type:string
delete:
summary:Delete the system_info resource for a given MEC system.
description:The DELETE method deletes the information of system_info resources stored in the MEF. This method is typically used in the sequence of "Deregistration of MEC system to the federation" as described in clause 5.2.2.1.1. The method shall comply with the URI query parameters, request and response data structures, and response codes, as specified in Tables 7.4.3.5-1 and 7.4.3.5-2.
operationId:systeminfoByIdDELETE
operationId:FedresourcesSysteminfoDELETESystemid
tags:
-systemInfo
parameters:
-$ref:'#/components/parameters/Path.systemId'
responses:
'204':
$ref:'#/components/responses/204'
@@ -162,6 +170,13 @@ paths:
$ref:'#/components/responses/403'
'404':
$ref:'#/components/responses/404'
parameters:
-name:systemId
in:path
required:true
description:The unique identifier of the systemId.
schema:
type:string
components:
schemas:
ProblemDetails:
@@ -181,19 +196,66 @@ components:
detail:
type:string
description:A human-readable explanation specific to this occurrence of the problem
x-etsi-mec-cardinality:0..1
x-etsi-mec-origin-type:String
instance:
type:string
format:uri
description:A URI reference that identifies the specific occurrence of the problem
Addresses:
description:Entry point information of the service as one or more pairs of IP address and port. See note.
type:object
minItems:0
properties:
host:
description:Host portion of the address.
type:string
port:
description:Port portion of the address.
type:integer
required:
-host
-port
LinkType:
type:object
required:
-href
properties:
href:
type:string
format:uri
description:The hyperlink reference.
EndPointInfo:
x-etsi-ref:8.1.5.3
type:object
properties:
uris:
description:Entry point information of the service as string, formatted according to URI syntax (see IETF RFC 3986 [8]). Shall be used for REST APIs. See note.
type:array
minItems:0
items:
type:string
fqdn:
description:Fully Qualified Domain Name of the service. See note.
description:This type represents a subscription to the notifications from the MEC federator related to information update of the MEC systems in the MEC federation.
properties:
subscriptionType:
description:Shall be set to "SystemUpdateNotificationSubscription".
@@ -238,8 +289,8 @@ components:
description:URI selected by the MEC orchestrator to receive notifications on the subscribed MEC system information updates in the MEC federation. This shall be included in both the request and the response.
type:string
format:uri
links:
$ref:'#/components/schemas/links'
_links:
$ref:'#/components/schemas/_links'
systemId:
description:Identifier(s) to uniquely specify the target MEC system(s) for the subscription. If absent, the subscription should include all MEC systems in the MEC federation.
type:array
@@ -247,17 +298,14 @@ components:
items:
type:string
expiryDeadline:
# description': The expiration time of the subscription determined by the MEC Federation Enablement Service.
description:The expiration time of the subscription determined by the MEC Federation Enablement Service.
$ref:'#/components/schemas/TimeStamp'
# x-etsi-mec-origin-type': TimeStamp
# x-etsi-mec-cardinality': 0..1
required:
-subscriptionType
-callbackReference
SystemUpdateNotification:
title:SystemUpdateNotification
x-etsi-ref:6.4.2
type:object
description:This type represents the information that the MEC federator notifies the subscribed MEC orchestrator about the information update of the MEC systems in the MEC federation.
properties:
notificationType:
description:Shall be set to "SystemUpdateNotification".
@@ -268,16 +316,15 @@ components:
minItems:1
items:
$ref:'#/components/schemas/SystemInfo'
links:
$ref:'#/components/schemas/links1'
_links:
$ref:'#/components/schemas/_links1'
required:
-notificationType
-updatedSystemInfo
-links
-_links
TimeStamp:
title:TimeStamp
x-etsi-ref:6.5.2
type:object
description:The expiration time of the subscription determined by the MEC Federation Enablement Service.
properties:
seconds:
description:The seconds part of the time. Time is defined as Unixtime since January 1, 1970, 00:00:00 UTC.
@@ -290,42 +337,27 @@ components:
required:
-seconds
-nanoSeconds
links:
title:links
_links:
description:Object containing hyperlinks related to the resource. This shall only be included in the HTTP responses.
type:object
properties:
self:
#description': Self-referring URI. The URI shall be unique within the MEC Federation Enablement API as it acts as an ID for the subscription (SubscriptionId).
description:Self-referring URI. The URI shall be unique within the MEC Federation Enablement API as it acts as an ID for the subscription (SubscriptionId).
$ref:'#/components/schemas/LinkType'
# x-etsi-mec-origin-type': LinkType
# x-etsi-mec-cardinality': '1'
required:
-self
links1:
title:links1
_links1:
description:Object containing hyperlinks related to the resource.
type:object
properties:
subscription:
# description': A link to the related subscription.
description:A link to the related subscription.
$ref:'#/components/schemas/LinkType'
# x-etsi-mec-origin-type': LinkType
# x-etsi-mec-cardinality': '1'
required:
-subscription
LinkType:
title:LinkType
description:Self-referring URI. The URI shall be unique within the MEC Federation Enablement API as it acts as an ID for the subscription (SubscriptionId).