"description":"Number of available PTP Servers (referred to as \"masters\" in IEEE 1588-2019)"
}
},
"description":"This type represents the information provided by the MEC platform in response to the Timing capabilities Query message."
@@ -2341,7 +2356,7 @@
},
"priority":{
"type":"integer",
"description":"Priority of this traffic rule. If traffic rule conflicts, the one with higher priority take precedence",
"description":"Priority of this traffic rule within the range 0 to 255. If traffic rules conflict, the one with higher priority take precedence. Value indicates the priority in descending order, i.e. with 0 as the highest priority and 255 as the lowest priority.",
description:Priority of this traffic rule. If traffic rule conflicts, the one with higher priority take precedence
description:Priority of this traffic rule within the range 0 to 255. If traffic rules conflict, the one with higher priority take precedence. Value indicates the priority in descending order, i.e. with 0 as the highest priority and 255 as the lowest priority.
contentEncoding:int32
examples:
-1
@@ -1625,7 +1630,10 @@ components:
action:
$ref:'#/components/schemas/TrafficRule.Action'
dstInterface:
type:array
items:
$ref:'#/components/schemas/DestinationInterface'
maxItems:2
state:
$ref:'#/components/schemas/TrafficRule.State'
description:This type represents the general information of a traffic rule.
"description":"This method retrieves information about an \"Individual mecServiceLiveness\" resource",
"operationId":"get_individual_MEC_service",
"responses":{
"200":{
"description":"It is used to indicate nonspecific success. The response body contains a representation of the resource.",
"content":{
"application/json":{
"schema":{
"$ref":"#/components/schemas/ServiceLivenessInfo"
}
}
}
},
"400":{
"description":"It is used to indicate that incorrect parameters were passed to the request. In the returned ProblemDetails structure, the \"detail\" attribute should convey more information about the error.",
"content":{
"application/problem+json":{
"schema":{
"$ref":"#/components/schemas/ProblemDetails"
}
}
}
},
"403":{
"description":"The operation is not allowed given the current status of the resource. More information shall be provided in the \"detail\" attribute of the \"ProblemDetails\" structure.",
"content":{
"application/problem+json":{
"schema":{
"$ref":"#/components/schemas/ProblemDetails"
}
}
}
},
"404":{
"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.",
"content":{
"application/problem+json":{
"schema":{
"$ref":"#/components/schemas/ProblemDetails"
}
}
}
}
}
},
"patch":{
"tags":[
"individualMECservice"
],
"description":"This method updates a resource on top of the existing resource state with partial changes described by the client.",
"operationId":"patch_individual_MEC_service",
"requestBody":{
"description":"It contains an update of the liveness state.",
"description":"Upon success, a response body is returned containing the updated liveness interval value of the service Instance.",
"content":{
"application/json":{
"schema":{
"$ref":"#/components/schemas/ServiceLivenessInfo"
}
}
}
},
"204":{
"description":"Successful response sent when there is no need to provide a new liveness interval value to the service Instance.",
"headers":{},
"content":{}
},
"400":{
"description":"It is used to indicate that incorrect parameters were passed to the request. In the returned ProblemDetails structure, the \"detail\" attribute should convey more information about the error.",
"content":{
"application/problem+json":{
"schema":{
"$ref":"#/components/schemas/ProblemDetails"
}
}
}
},
"403":{
"description":"The operation is not allowed given the current status of the resource. More information shall be provided in the \"detail\" attribute of the \"ProblemDetails\" structure.",
"content":{
"application/problem+json":{
"schema":{
"$ref":"#/components/schemas/ProblemDetails"
}
}
}
},
"404":{
"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.",
"content":{
"application/problem+json":{
"schema":{
"$ref":"#/components/schemas/ProblemDetails"
}
}
}
},
"409":{
"description":"The operation is not allowed due to a conflict with the state of the resource. The MEC platform shall respond with this code if the service instance is in \"INACTIVE\" state. More information shall be provided in the \"detail\" attribute of the \"ProblemDetails\" structure.",
"content":{
"application/problem+json":{
"schema":{
"$ref":"#/components/schemas/ProblemDetails"
}
}
}
},
"412":{
"description":"It is used when a condition has failed during conditional requests, e.g. when using ETags to avoid write conflicts. In the returned ProblemDetails structure, the \"detail\" attribute should convey more information about the error.",
"description":"Identifiers of service instances about which to report events."
},
"serNames":{
"minItems":0,
"type":"array",
"items":{
"type":"string"
@@ -1948,7 +2080,6 @@
"description":"Names of services about which to report events."
},
"serCategories":{
"minItems":0,
"type":"array",
"items":{
"$ref":"#/components/schemas/CategoryRef"
@@ -1956,7 +2087,6 @@
"description":"Categories of services about which to report events."
},
"states":{
"minItems":0,
"type":"array",
"items":{
"$ref":"#/components/schemas/ServiceState"
@@ -2047,7 +2177,7 @@
"ATTRIBUTES_CHANGED"
],
"type":"string",
"description":"Type of the change. Valid values:\n ADDED: The service was newly added.\n REMOVED: The service was removed.\n STATE_CHANGED: Only the state of the service was changed. \n ATTRIBUTES_CHANGED: At least one attribute of the service other than state was changed. The change may or may not include changing the state.",
"description":"Type of the change. Valid values:\n1. ADDED: The service was newly added.\n2. REMOVED: The service was removed.\n3. STATE_CHANGED: Only the state of the service was changed. \n4. ATTRIBUTES_CHANGED: At least one attribute of the service other than state was changed. The change may or may not include changing the state.",
"examples":[
"ADDED"
]
@@ -2085,7 +2215,8 @@
"title":"ServiceState",
"enum":[
"ACTIVE",
"INACTIVE"
"INACTIVE",
"SUSPENDED"
],
"type":"string",
"description":"This enumeration defines the possible states of a service.",
@@ -2153,10 +2284,72 @@
"examples":[
true
]
},
"livenessInterval":{
"type":"integer",
"description":"Interval (in seconds) between two consecutive \"heartbeat\" messages (see clause 8.2.10.3.3). If the service-producing application supports sending \"heartbeat\" messages, it shall include this attribute in the registration request. In this case, the application shall either set the value of this attribute to zero or shall use this attribute to propose a non-zero positive value for the liveness interval. If the application has provided this attribute in the request and the MEC platform requires \"heartbeat\" messages, the MEC platform shall return this attribute value in the HTTP responses. The MEC platform may use the value proposed in the request or may choose a different value. If the MEC platform does not require \"heartbeat\" messages for this service instance it shall omit the attribute in responses."
},
"_links":{
"type":"object",
"required":[
"self"
],
"properties":{
"self":{
"$ref":"#/components/schemas/LinkType"
},
"liveness":{
"$ref":"#/components/schemas/LinkType"
}
}
}
},
"description":"This type represents the general information of a MEC service."
},
"ServiceLivenessInfo":{
"type":"object",
"required":[
"state",
"timeStamp",
"interval"
],
"properties":{
"state":{
"$ref":"#/components/schemas/ServiceState"
},
"timeStamp":{
"type":"object",
"description":"The time when the last \"heartbeat\" message was received by MEC platform",
"required":[
"seconds",
"nanoSeconds"
],
"properties":{
"seconds":{
"type":"integer"
},
"nanoSeconds":{
"type":"integer"
}
}
},
"interval":{
"type":"integer",
"description":"The interval (in seconds) between two consecutive \"heartbeat\" messages (see clause 8.2.10.3.3) that MEC platform has determined."
description:This method retrieves information about an "Individual mecServiceLiveness" resource
operationId:get_individual_MEC_service
responses:
'200':
description:It is used to indicate nonspecific success. The response body contains a representation of the resource.
content:
application/json:
schema:
$ref:'#/components/schemas/ServiceLivenessInfo'
'400':
description:It is used to indicate that incorrect parameters were passed to the request. In the returned ProblemDetails structure, the "detail" attribute should convey more information about the error.
content:
application/problem+json:
schema:
$ref:'#/components/schemas/ProblemDetails'
'404':
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.
content:
application/problem+json:
schema:
$ref:'#/components/schemas/ProblemDetails'
'403':
description:The operation is not allowed given the current status of the resource.
More information shall be provided in the "detail" attribute of the "ProblemDetails" structure.
content:
application/problem+json:
schema:
$ref:'#/components/schemas/ProblemDetails'
patch:
tags:
-individualMECservice
description:This method updates a resource on top of the existing resource state with partial changes described by the client.
operationId:patch_individual_MEC_service
requestBody:
description:It contains an update of the liveness state.
content:
application/json:
schema:
$ref:'#/components/schemas/ServiceLivenessUpdate'
required:true
responses:
'200':
description:Upon success, a response body is returned containing the updated liveness interval value of the service Instance.
content:
application/json:
schema:
$ref:'#/components/schemas/ServiceLivenessInfo'
'204':
description:Successful response sent when there is no need to provide a new liveness interval value to the service Instance.
headers:{}
content:{}
'400':
description:It is used to indicate that incorrect parameters were passed to the request. In the returned ProblemDetails structure, the "detail" attribute should convey more information about the error.
content:
application/problem+json:
schema:
$ref:'#/components/schemas/ProblemDetails'
'404':
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.
content:
application/problem+json:
schema:
$ref:'#/components/schemas/ProblemDetails'
'403':
description:The operation is not allowed given the current status of the resource. More information shall be provided in the "detail" attribute of the "ProblemDetails" structure.
content:
application/problem+json:
schema:
$ref:'#/components/schemas/ProblemDetails'
'409':
description:The operation is not allowed due to a conflict with the state of the resource. The MEC platform shall respond with this code if the service instance is in "INACTIVE" state. More information shall be provided in the "detail" attribute of the "ProblemDetails" structure.
content:
application/problem+json:
schema:
$ref:'#/components/schemas/ProblemDetails'
'412':
description:It is used when a condition has failed during conditional requests, e.g. when using ETags to avoid write conflicts. In the returned ProblemDetails structure, the "detail" attribute should convey more information about the error.
content:
application/problem+json:
schema:
$ref:'#/components/schemas/ProblemDetails'
components:
schemas:
CategoryRef:
@@ -1164,7 +1249,6 @@ components:
type:object
properties:
addresses:
minItems:0
type:array
items:
$ref:'#/components/schemas/EndPointInfo.Address'
@@ -1186,7 +1270,6 @@ components:
type:object
properties:
uris:
minItems:0
type:array
items:
type:string
@@ -1334,25 +1417,21 @@ components:
type:object
properties:
serInstanceIds:
minItems:0
type:array
items:
type:string
description:Identifiers of service instances about which to report events.
serNames:
minItems:0
type:array
items:
type:string
description:Names of services about which to report events.
serCategories:
minItems:0
type:array
items:
$ref:'#/components/schemas/CategoryRef'
description:Categories of services about which to report events.
description:This enumeration defines the possible states of a service.
examples:
@@ -1498,7 +1578,56 @@ components:
description:Indicate whether the service is located in the same locality (as defined by scopeOfLocality) as the consuming MEC application.
examples:
-true
livenessInterval:
type:integer
description:Interval (in seconds) between two consecutive "heartbeat" messages (see clause 8.2.10.3.3).
If the service-producing application supports sending "heartbeat" messages, it shall include this attribute in the registration request. In this case, the application shall either set the value of this attribute to zero or shall use this attribute to propose a non-zero positive value for the liveness interval.
If the application has provided this attribute in the request and the MEC platform requires "heartbeat" messages, the MEC platform shall return this attribute value in the HTTP responses. The MEC platform may use the value proposed in the request or may choose a different value.
If the MEC platform does not require "heartbeat" messages for this service instance it shall omit the attribute in responses.
_links:
type:object
required:
-self
properties:
self:
$ref:'#/components/schemas/LinkType'
liveness:
$ref:'#/components/schemas/LinkType'
description:This type represents the general information of a MEC service.
ServiceLivenessInfo:
type:object
required:
-state
-timeStamp
-interval
properties:
state:
$ref:'#/components/schemas/ServiceState'
timeStamp:
type:object
description:The time when the last "heartbeat" message was received by MEC platform
required:
-seconds
-nanoSeconds
properties:
seconds:
type:integer
nanoSeconds:
type:integer
interval:
type:integer
description:The interval (in seconds) between two consecutive "heartbeat" messages (see clause 8.2.10.3.3) that MEC platform has determined.