Newer
Older
title: ETSI GS MEC 021 Application Mobility Service API
piscione
committed
version: '2.2.1'
description: ETSI GS MEC 021 Application Mobility Service API described using OpenAPI.
license:
name: BSD-3-Clause
url: 'https://forge.etsi.org/legal-matters'
piscione
committed
description: ETSI GS MEC 021 Application Mobility Service API, v2.2.1
url: https://www.etsi.org/deliver/etsi_gs/MEC/001_099/021/02.02.01_60/gs_mec021v020201p.pdf
jsonSchemaDialect: https://json-schema.org/draft/2020-12/schema
- url: https://localhost/amsi/v1
variables: {}
tags:
- name: adj-app-inst
description: Adjacent App instances
- name: app-mob-ser
description: Application Mobility Services
- name: app-mob-ser-der
description: Application Mobility Services Deregister task
- name: subscriptions
description: Subscription for Application Mobility Service
piscione
committed
- name: notifications
description: Notification for Application Mobility Service
/queries/adjacent_app_instances:
get:
tags:
- adj-app-inst
summary: 'Retrieve information about this subscription.'
description: Retrieve information about this subscription.
operationId: adj_app_instGET
parameters:
- name: filter
in: query
piscione
committed
description: Attribute-based filtering parameters according to ETSI GS MEC 009
style: form
explode: true
schema:
type: string
- name: all_fields
in: query
description: Include all complex attributes in the response.
style: form
explode: true
schema:
type: string
- name: fields
in: query
piscione
committed
description: Complex attributes to be included into the response. See clause 6.18 in ETSI GS MEC 009
style: form
explode: true
schema:
type: string
- name: exclude_fields
in: query
piscione
committed
description: Complex attributes to be excluded from the response.See clause 6.18 in ETSI GS MEC 009
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
style: form
explode: true
schema:
type: string
- name: exclude_default
in: query
description: Indicates to exclude the following complex attributes from the response See clause 6.18 in ETSI GS MEC 011 for details.
style: form
explode: true
schema:
type: string
responses:
'200':
description: A response body containing zero or more adjacent application instances
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/AdjacentAppInstanceInfo'
description: ''
contentMediaType: application/json
'400':
description: 'Bad Request : used to indicate that incorrect parameters were passed to the request.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'401':
description: 'Unauthorized : used when the client did not submit credentials.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'403':
description: 'Forbidden : operation is not allowed given the current status of the resource.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'404':
description: 'Not Found : used when a client provided a URI that cannot be mapped to a valid resource URI.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'406':
description: 'Not Acceptable : used to indicate that the server cannot provide the any of the content formats supported by the client.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'429':
description: 'Too Many Requests : used when a rate limiter has triggered.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
deprecated: false
parameters: []
/app_mobility_services:
get:
summary: 'Retrieve information about the registered application mobility service.'
description: ' Retrieve information about the registered application mobility service.'
operationId: app_mobility_serviceGET
parameters:
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
- name: filter
in: query
description: Attribute-based filtering parameters according to ETSI GS MEC 011
style: form
explode: true
schema:
type: string
- name: all_fields
in: query
description: Include all complex attributes in the response.
style: form
explode: true
schema:
type: string
- name: fields
in: query
description: Complex attributes to be included into the response. See clause 6.18 in ETSI GS MEC 011
style: form
explode: true
schema:
type: string
- name: exclude_fields
in: query
description: Complex attributes to be excluded from the response.See clause 6.18 in ETSI GS MEC 011
style: form
explode: true
schema:
type: string
- name: exclude_default
in: query
description: Indicates to exclude the following complex attributes from the response See clause 6.18 in ETSI GS MEC 011 for details.
style: form
explode: true
schema:
type: string
description: Contains in an array the representations of zero or more application mobility services.
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/RegistrationInfo'
description: ''
contentMediaType: application/json
description: 'Bad Request : used to indicate that incorrect parameters were passed to the request.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Unauthorized : used when the client did not submit credentials.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Forbidden : operation is not allowed given the current status of the resource.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Found : used when a client provided a URI that cannot be mapped to a valid resource URI.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Acceptable : used to indicate that the server cannot provide the any of the content formats supported by the client.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Too Many Requests : used when a rate limiter has triggered.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
deprecated: false
post:
summary: 'Create a new application mobility service for the service requester.'
description: Create a new application mobility service for the service requester.
requestBody:
description: Application mobility service to be created
content:
application/json:
schema:
$ref: '#/components/schemas/RegistrationInfo'
required: true
responses:
'201':
description: Successful response for application mobility service creation
$ref: '#/components/schemas/RegistrationInfo'
description: 'Bad Request : used to indicate that incorrect parameters were passed to the request.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Unauthorized : used when the client did not submit credentials.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Forbidden : operation is not allowed given the current status of the resource.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Found : used when a client provided a URI that cannot be mapped to a valid resource URI.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Acceptable : used to indicate that the server cannot provide the any of the content formats supported by the client.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Too Many Requests : used when a rate limiter has triggered.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
deprecated: false
parameters: []
/app_mobility_services/{appMobilityServiceId}:
get:
tags:
- app-mob-ser
summary: 'Retrieve information about this individual application mobility service'
description: Retrieve information about this individual application mobility service
operationId: app_mobility_service_by_idGET
parameters:
- name: appMobilityServiceId
in: path
description: It uniquely identifies the created individual application mobility service
required: true
style: simple
schema:
type: string
responses:
description: Contains a representation of the application mobility service.
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/RegistrationInfo'
'400':
description: 'Bad Request : used to indicate that incorrect parameters were passed to the request.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Unauthorized : used when the client did not submit credentials.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Forbidden : operation is not allowed given the current status of the resource.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Found : used when a client provided a URI that cannot be mapped to a valid resource URI.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Acceptable : used to indicate that the server cannot provide the any of the content formats supported by the client.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Too Many Requests : used when a rate limiter has triggered.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
deprecated: false
put:
tags:
- app-mob-ser
summary: ' update the existing individual application mobility service'
description: ' update the existing individual application mobility service'
operationId: app_mobility_service_by_idPUT
parameters:
- name: appMobilityServiceId
in: path
description: It uniquely identifies the created individual application mobility service
style: simple
schema:
type: string
requestBody:
description: ''
$ref: '#/components/schemas/RegistrationInfo'
required: true
responses:
description: Contains a data type describing the updated application mobility service.
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/RegistrationInfo'
'400':
description: 'Bad Request : used to indicate that incorrect parameters were passed to the request.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Unauthorized : used when the client did not submit credentials.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Forbidden : operation is not allowed given the current status of the resource.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Found : used when a client provided a URI that cannot be mapped to a valid resource URI.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Acceptable : used to indicate that the server cannot provide the any of the content formats supported by the client.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Precondition failed : used when a condition has failed during conditional requests, e.g. when using ETags to avoid write conflicts when using PUT'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Unprocessable Entity : used to indicate that the server understands the content type of the request entity and that the syntax of the request entity is correct but that the server is unable to process the contained instructions. This error condition can occur if an JSON request body is syntactically correct but semantically incorrect, for example if the target area for the request is considered too large. This error condition can also occur if the capabilities required by the request are not supported.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Too Many Requests : used when a rate limiter has triggered.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
deprecated: false
delete:
tags:
- app-mob-ser
summary: ' deregister the individual application mobility service'
description: ' deregister the individual application mobility service'
operationId: app_mobility_service_by_idDELETE
parameters:
- name: appMobilityServiceId
in: path
description: It uniquely identifies the created individual application mobility service
required: true
style: simple
schema:
type: string
responses:
description: No Content
headers: {}
content: {}
description: 'Unauthorized : used when the client did not submit credentials.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Forbidden : operation is not allowed given the current status of the resource.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Found : used when a client provided a URI that cannot be mapped to a valid resource URI.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Too Many Requests : used when a rate limiter has triggered.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
deprecated: false
parameters: []
/app_mobility_services/{appMobilityServiceId}/deregister_task:
post:
tags:
- app-mob-ser-der
summary: ' deregister the individual application mobility service'
description: ' deregister the individual application mobility service'
operationId: app_mobility_service_derPOST
parameters:
- name: appMobilityServiceId
in: path
description: It uniquely identifies the created individual application mobility service
required: true
style: simple
schema:
type: string
responses:
description: No Content
headers: {}
content: {}
description: 'Unauthorized : used when the client did not submit credentials.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Forbidden : operation is not allowed given the current status of the resource.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Found : used when a client provided a URI that cannot be mapped to a valid resource URI.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Acceptable : used to indicate that the server cannot provide the any of the content formats supported by the client.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Too Many Requests : used when a rate limiter has triggered.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
deprecated: false
parameters: []
summary: 'Retrieve information about the subscriptions for this requestor.'
description: Retrieve information about the subscriptions for this requestor.
- name: subscriptionType
in: query
description: 'Query parameter to filter on a specific subscription type. Permitted values: mobility_proc or adj_app_info'
required: true
style: form
explode: true
schema:
type: string
description: Contains the list of links to requestor subscriptions.
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/SubscriptionLinkList'
description: 'Bad Request : used to indicate that incorrect parameters were passed to the request.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Unauthorized : used when the client did not submit credentials.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Forbidden : operation is not allowed given the current status of the resource.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Found : used when a client provided a URI that cannot be mapped to a valid resource URI.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Acceptable : used to indicate that the server cannot provide the any of the content formats supported by the client.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Too Many Requests : used when a rate limiter has triggered.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
deprecated: false
post:
summary: 'Create a new subscription to Application Mobility Service notifications.'
description: Create a new subscription to Application Mobility Service notifications.
- $ref: '#/components/schemas/MobilityProcedureSubscription'
- $ref: '#/components/schemas/AdjacentAppInfoSubscription'
contentMediaType: application/json
required: true
description: Created subscription is described using the appropriate data type
headers: {}
oneOf:
- $ref: '#/components/schemas/MobilityProcedureSubscription'
- $ref: '#/components/schemas/AdjacentAppInfoSubscription'
contentMediaType: application/json
description: 'Bad Request : used to indicate that incorrect parameters were passed to the request.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Unauthorized : used when the client did not submit credentials.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Forbidden : operation is not allowed given the current status of the resource.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Found : used when a client provided a URI that cannot be mapped to a valid resource URI.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Acceptable : used to indicate that the server cannot provide the any of the content formats supported by the client.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Unsupported Media Type : used to indicate that the server or the client does not support the content type of the entity body.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Unprocessable Entity : used to indicate that the server understands the content type of the request entity and that the syntax of the request entity is correct but that the server is unable to process the contained instructions. This error condition can occur if an JSON request body is syntactically correct but semantically incorrect, for example if the target area for the request is considered too large. This error condition can also occur if the capabilities required by the request are not supported.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Too Many Requests : used when a rate limiter has triggered.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
deprecated: false
parameters: []
/subscriptions/{subscriptionId}:
get:
tags:
- subscriptions
summary: 'Retrieve information about this subscription.'
description: Retrieve information about this subscription.
operationId: sub_byIdGET
parameters:
- name: subscriptionId
in: path
description: Refers to created subscription, where the AMS API allocates a unique resource name for this subscription
required: true
style: simple
schema:
type: string
responses:
description: A response body containing data type describing the specific RNI event subscription
headers: {}
oneOf:
- $ref: '#/components/schemas/MobilityProcedureSubscription'
- $ref: '#/components/schemas/AdjacentAppInfoSubscription'
contentMediaType: application/json
description: 'Bad Request : used to indicate that incorrect parameters were passed to the request.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Unauthorized : used when the client did not submit credentials.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Forbidden : operation is not allowed given the current status of the resource.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Found : used when a client provided a URI that cannot be mapped to a valid resource URI.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Acceptable : used to indicate that the server cannot provide the any of the content formats supported by the client.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Too Many Requests : used when a rate limiter has triggered.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
deprecated: false
put:
tags:
- subscriptions
summary: 'update the existing individual subscription.'
description: update the existing individual subscription.
operationId: sub_byIdPUT
parameters:
- name: subscriptionId
in: path
description: Refers to created subscription, where the AMS API allocates a unique resource name for this subscription
style: simple
schema:
type: string
requestBody:
description: ''
- $ref: '#/components/schemas/MobilityProcedureSubscription'
- $ref: '#/components/schemas/AdjacentAppInfoSubscription'
contentMediaType: application/json
required: true
responses:
description: a response body containing data type describing the updated subscription
headers: {}
oneOf:
- $ref: '#/components/schemas/MobilityProcedureSubscription'
- $ref: '#/components/schemas/AdjacentAppInfoSubscription'
contentMediaType: application/json
description: 'Bad Request : used to indicate that incorrect parameters were passed to the request.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Unauthorized : used when the client did not submit credentials.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Forbidden : operation is not allowed given the current status of the resource.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Found : used when a client provided a URI that cannot be mapped to a valid resource URI.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Acceptable : used to indicate that the server cannot provide the any of the content formats supported by the client.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Precondition failed : used when a condition has failed during conditional requests, e.g. when using ETags to avoid write conflicts when using PUT'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Unprocessable Entity : used to indicate that the server understands the content type of the request entity and that the syntax of the request entity is correct but that the server is unable to process the contained instructions. This error condition can occur if an JSON request body is syntactically correct but semantically incorrect, for example if the target area for the request is considered too large. This error condition can also occur if the capabilities required by the request are not supported.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Too Many Requests : used when a rate limiter has triggered.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
deprecated: false
delete:
tags:
- subscriptions
summary: 'cancel the existing individual subscription'
description: cancel the existing individual subscription
operationId: sub_byIdDELETE
parameters:
- name: subscriptionId
in: path
description: Refers to created subscription, where the AMS API allocates a unique resource name for this subscription
required: true
style: simple
schema:
type: string
responses:
description: No Content
headers: {}
content: {}
description: 'Unauthorized : used when the client did not submit credentials.'
headers: {}
$ref: '#/components/schemas/ProblemDetails'
description: 'Forbidden : operation is not allowed given the current status of the resource.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Not Found : used when a client provided a URI that cannot be mapped to a valid resource URI.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
description: 'Too Many Requests : used when a rate limiter has triggered.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
deprecated: false
parameters: []
piscione
committed
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
/uri_provided_by_subscriber:
post:
tags:
- notifications
summary: delivers a notification from the AMS resource to the subscriber
description: delivers a notification from the AMS resource to the subscriber
operationId: notificationPOST
parameters: []
requestBody:
description: ''
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/MobilityProcedureNotification'
- $ref: '#/components/schemas/AdjacentAppInfoNotification'
- $ref: '#/components/schemas/ExpiryNotification'
contentMediaType: application/json
required: true
responses:
'204':
description: The notification was delivered successfully. The response body shall be empty.
headers: {}
content: {}
'401':
description: It is used when the client did not submit credentials.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'403':
description: operation is not allowed given the current status of the resource.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'404':
description: Used when a client provided a URI that cannot be mapped to a valid resource URI.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'406':
description: Used to indicate that the server cannot provide the any of the content formats supported by the client.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'429':
description: Used when a rate limiter has triggered.'
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetails'
components:
schemas:
AdjacentAppInfoSubscription.links:
title: AdjacentAppInfoSubscription.links
properties:
self:
$ref: '#/components/schemas/LinkType'
description: Hyperlink related to the resource. This shall be only included in the HTTP responses and in HTTP PUT requests.
title: AdjacentAppInfoSubscription.filterCriteria
type: object
appInstanceId:
type: string
description: List of filtering criteria for the subscription. Any filtering criteria from below, which is included in the request, shall also be included in the response.
title: AdjacentAppInfoSubscription
required:
- callbackReference
- filterCriteria
- subscriptionType
type: object
properties:
_links:
$ref: '#/components/schemas/AdjacentAppInfoSubscription.links'
callbackReference:
piscione
committed
type: uri
description: URI selected by the service consumer to receive notifications on the subscribed Application Mobility Service. This shall be included both in the request and in response.
piscione
committed
requestTestNotification:
type: boolean
description: Shall be set to TRUE by the service consumer to request a test notification via HTTP on the callbackReference URI, specified in ETSI GS MEC 009, as described in clause 6.12a.
websockNotifConfig:
$ref: '#/components/schemas/WebsockNotifConfig'
piscione
committed
description: Identifies a boundary after which the subscription will expire.
$ref: '#/components/schemas/TimeStamp'
filterCriteria:
$ref: '#/components/schemas/AdjacentAppInfoSubscription.filterCriteria'
subscriptionType:
const: AdjacentAppInfoSubscription
description: Shall be set to "AdjacentAppInfoSubscription".
examples:
- AdjacentAppInfoSubscription
AdjacentAppInstanceInfo:
title: AdjacentAppInstanceInfo
- appDId
- appInstanceCommLink
- appInstanceId
description: Identifier of the application descriptor.
appInstanceCommLink:
type: array
items:
$ref: '#/components/schemas/CommunicationInterface'
description: It specifies the communication interface of application instance.
description: Identifier of the application instance.
mecHostInformation:
$ref: '#/components/schemas/MECHostInformation'
piscione
committed
registeredInstanceId:
type: string
description: dentifier of the application instance that registers to the AMS, which is instantiated from the application descriptor identified by the attribute "appDId".
enum:
- APP_MOBILITY_NOT_ALLOWED
- APP_MOBILITY_WITH_CONFIRMATION
- APP_MOBILITY_WITHOUT_CONFIRMATION
description: This attribute provides an option for the application instance (server) to communicate with the application client before relocating this application instance to another MEC host.
examples:
- APP_MOBILITY_NOT_ALLOWED
title: CommunicationInterface.IpAddresses
required:
- host
- port
type: object
properties:
host:
type: string
port:
type: integer
contentEncoding: int32
title: CommunicationInterface
type: object
type: array
items:
$ref: '#/components/schemas/CommunicationInterface.IpAddresses'
description: ''
title: MobilityProcedureSubscription.links
required:
- self
type: object
properties:
self:
$ref: '#/components/schemas/LinkType'
title: MobilityProcedureSubscription.filterCriteria
type: object
properties:
appInstanceId:
type: string
piscione
committed
description: Identifier of the application instance that registers the Application Mobility Service.
associateId:
type: array
items:
$ref: '#/components/schemas/AssociateId'
description: 0 to N identifiers to associate the information for specific UE(s) and flow(s).
mobilityStatus:
type: array
items:
$ref: '#/components/schemas/MobilityStatus'
description: In case mobilityStatus is not included in the subscription request, the default value 1 = INTER_HOST_MOBILITY_TRIGGERED shall be used and included in the response.
description: List of filtering criteria for the subscription. Any filtering criteria from below, which is included in the request, shall also be included in the response.
piscione
committed
WebsockNotifConfig:
type: object
properties:
websocketUri:
description: Set by AMS to indicate to the service consumer the Websocket URI to be used for delivering notifications.
type: uri
requestWebsocketUri:
type: boolean
description: Set to true by the service consumer to indicate that Websocket delivery is requested.
title: MobilityProcedureSubscription
required:
- filterCriteria
- subscriptionType
type: object
properties:
_links:
$ref: '#/components/schemas/MobilityProcedureSubscription.links'
callbackReference:
piscione
committed
type: uri
description: URI selected by the service consumer to receive notifications on the subscribed Application Mobility Service. This shall be included both in the request and in response.
piscione
committed
requestTestNotification:
type: boolean
description: Shall be set to TRUE by the service consumer to request a test notification via HTTP on the callbackReference URI, specified in ETSI GS MEC 009, as described in clause 6.12a.
websockNotifConfig:
description: Provides details to negotiate and signal the use of a Websocket connection between AMS and the service consumer for notifications.
$ref: '#/components/schemas/WebsockNotifConfig'
piscione
committed
description: Identifies a boundary after which the subscription will expire.
$ref: '#/components/schemas/TimeStamp'
filterCriteria:
$ref: '#/components/schemas/MobilityProcedureSubscription.filterCriteria'
subscriptionType:
const: MobilityProcedureSubscription
description: Shall be set to "MobilityProcedureSubscription".
examples:
- MobilityProcedureSubscription
piscione
committed
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
MobilityProcedureNotification:
title: MobilityProcedureNotification
required:
- notificationType
- associateId
- mobilityStatus
- links
properties:
notificationType:
type: string
description: Shall be set to "MobilityProcedureNotification".
timeStamp:
description: Date and time of the generation of the notification
$ref: '#/components/schemas/TimeStamp'
associateId:
type: array
description: 1 to N identifiers to associate the information for specific
items:
$ref: '#/components/schemas/AssociateId'
mobilityStatus:
description: Indicate the status of the UE mobility. Values are defined as following 1 = INTERHOST_MOVEOUT_TRIGGERED. 2 = INTERHOST_MOVEOUT_COMPLETED. 3 = INTERHOST_MOVEOUT_FAILED. Other values are reserved.
$ref: '#/components/schemas/MobilityStatus'
targetAppInfo:
type: object
required:
- appInstanceId
properties:
appInstanceId:
type: string
description: Identifiers of the target application instance.
commInterface:
description: If present, it specifies the communication interface of the application instance.
$ref: '#/components/schemas/CommunicationInterface'
_links:
$ref: '#/components/schemas/LinkType'
AdjacentAppInfoNotification:
title: AdjacentAppInfoNotification
required:
- notificationType
- _links
properties:
notificationType:
type: string
description: Shall be set to "AdjacentAppInfoNotification".
timeStamp:
description: Date and time of the generation of the notification
$ref: '#/components/schemas/TimeStamp'
associateId:
type: array
description: 1 to N identifiers to associate the information for specific
items:
$ref: '#/components/schemas/AssociateId'
adjacentAppInfo:
type: object
required:
- appInstanceId
- commInterface
properties:
appInstanceId:
type: string
description: Identifier of the adjacent application instance.
commInterface:
type: array
description: If present, it represents the communication interface(s) information of the application instance.
items:
$ref: '#/components/schemas/CommunicationInterface'
_links:
$ref: '#/components/schemas/LinkType'
ExpiryNotification:
title: ExpiryNotification
required:
- notificationType
- _links
- expiryDeadline
properties:
notificationType:
type: string
description: Shall be set to "ExpiryNotification".
timeStamp:
description: Date and time of the generation of the notification
$ref: '#/components/schemas/TimeStamp'
_links:
type: object
required:
- subscription
properties:
subscription:
$ref: '#/components/schemas/LinkType'
expiryDeadline:
description: The boundary value setting in the subscription request.
$ref: '#/components/schemas/TimeStamp'
TestNotification:
title: TestNotification
required:
- notificationType
- _links
properties:
notificationType:
type: string
description: Shall be set to "TestNotification".
_links:
type: object
description: Hyperlink related to the resource.
required:
- subscription
properties:
subscription:
description: URI identifying the subscription for the test notification.
$ref: '#/components/schemas/LinkType'
enum:
- INTERHOST_MOVEOUT_TRIGGERED
- INTERHOST_MOVEOUT_COMPLETED
- INTERHOST_MOVEOUT_FAILED
type: string
description: Indicate the status of the UE mobility
examples:
- INTERHOST_MOVEOUT_TRIGGERED
title: RegistrationInfo.deviceInformation
required:
- associateId
type: object
properties:
associateId:
$ref: '#/components/schemas/AssociateId'
appMobilityServiceLevel:
$ref: '#/components/schemas/AppMobilityServiceLevel'
contextTransferState:
$ref: '#/components/schemas/contextTransferState'
title: RegistrationInfo.serviceConsumerId
type: object
properties:
appInstanceId:
type: string
piscione
committed
description: If present, it represents the identifier of the application instance registering the Application Mobility Service.
piscione
committed
description: If present, it represents the identifier of the MEC platform registering the Application Mobility Service.
description: The identifier of service consumer requesting the application mobility service, i.e. either the application instance ID or the MEC platform ID.
title: RegistrationInfo
required:
- serviceConsumerId
type: object
properties:
appMobilityServiceId:
type: string
description: The identifier of registered application mobility service. Shall be absent in POST requests, and present otherwise.
$ref: '#/components/schemas/RegistrationInfo.deviceInformation'
piscione
committed
description: If present, it specifies the device served by the application instance which is registering is registering the Application Mobility Service.
piscione
committed
description: If present, it indicates the time of Application Mobility Service expiration from the time of registration accepted.The value "0" means infinite time, i.e. no expiration.The unit of expiry time is one second.
serviceConsumerId:
$ref: '#/components/schemas/RegistrationInfo.serviceConsumerId'
SubscriptionLinkList.links:
title: SubscriptionLinkList.links
piscione
committed
description: List of hyperlinks related to the resource.
required:
- self
type: object
properties:
self:
piscione
committed
$ref: '#/components/schemas/LinkType'
description: URI of this resource.
subscription:
type: array
description: The service consumer’s subscriptions.
items:
$ref: '#/components/schemas/SubscriptionLinkList.subscription'
title: SubscriptionLinkList.subscription
required:
- href
- subscriptionType
type: object
properties:
href:
type: string
description: The URI referring to the subscription.
subscriptionType:
piscione
committed
description:
$ref: '#/components/schemas/subscriptionType'
piscione
committed
title: SubscriptionLinkList
required:
- _links
type: object
properties:
_links:
$ref: '#/components/schemas/SubscriptionLinkList.links'
piscione
committed
description: Hyperlinks related to the resource.
enum:
- NOT_TRANSFERRED
- USER_CONTEXT_TRANSFER_COMPLETED
type: string
description: If present, it represents the state of transferring the user context to another application instance.
examples:
- NOT_TRANSFERRED
description: 'Numeric value (0 - 255) corresponding to specified type of subscription as following: 0 = RESERVED. 1 = MOBILITY_PROCEDURE. 2 = ADJACENT_APPINFO.'
examples:
- 0
properties:
type:
$ref: '#/components/schemas/Type'
value:
type: string
description: Value for the identifier.
type: string
description: The URI referring to the subscription.
description: "'This data type represents a type of link'"
- seconds
- nanoSeconds
type: object
type: integer
description: "'The seconds part of the Time. Time is defined as Unix-time since January 1, 1970, 00:00:00 UTC.'"
contentEncoding: int32
type: integer
description: "'The nanoseconds part of the Time. Time is defined as Unix-time since January 1, 1970, 00:00:00 UTC.'"
contentEncoding: int32
description: "'This data type represents the time stamp as Unix-time since January 1, 1970, 00:00:00 UTC'"
piscione
committed
KeyValuePairs:
type: object
additionalProperties:
type: object
type: string
description: Human-readable name of MEC host.
description: "'This data type represents a list of key-value pairs. The order of the pairs in the list is not significant. In JSON, a set of key-value pairs is represented as an object. It shall comply with the provisions defined in clause 4 of IETF RFC 8259'"
piscione
committed
$ref: '#/components/schemas/KeyValuePairs'
title: ProblemDetails
type: object
description: A human-readable explanation specific to this occurrence of the problem
description: A URI reference that identifies the specific occurrence of the problem
description: The HTTP status code for this occurrence of the problem
contentEncoding: int32
description: A short, human-readable summary of the problem type
description: A URI reference according to IETF RFC 3986 that identifies the problem type
Type:
title: Type
enum:
- UE_IPv4_ADDRESS
- UE_IPV6_ADDRESS
- NATED_IP_ADDRESS
- GTP_TEID
type: string
description: Numeric value (0-255) corresponding to specified type of identifier
examples:
- UE_IPv4_ADDRESS
security: