ETSI GS MEC 040 V3.1.1 (2023-02)

Multi-access Edge Computing (MEC); Federation enablement APIs

DGS/MEC-0040FederationAPI

General Information

• Status: Not Published
• Technical Committee: MEC - Multi-access Edge Computing
• Current Stage: 12 - Completion
• Due Date: 10-Feb-2023
• Completion Date: 08-Feb-2023

Standards Content (Sample)

ETSI GS MEC 040 V3.1.1 (2023-02)






GROUP SPECIFICATION
Multi-access Edge Computing (MEC);
Federation enablement APIs
Disclaimer
The present document has been produced and approved by the Multi-access Edge Computing (MEC) ETSI Industry
Specification Group (ISG) and represents the views of those members who participated in this ISG.
It does not necessarily represent the views of the entire ETSI membership.

---------------------- Page: 1 ----------------------
2 ETSI GS MEC 040 V3.1.1 (2023-02)

Reference
DGS/MEC-0040FederationAPI
Keywords
API, interworking, MEC, service

ETSI
650 Route des Lucioles
F-06921 Sophia Antipolis Cedex - FRANCE

Tel.: [phone]  Fax: [phone]

Siret N° 348 623 562 00017 - APE 7112B
Association à but non lucratif enregistrée à la
Sous-Préfecture de Grasse (06) N° w061004871

Important notice
The present document can be downloaded from:
http://www.etsi.org/standards-search
The present document may be made available in electronic versions and/or in print. The content of any electronic and/or
print versions of the present document shall not be modified without the prior written authorization of ETSI. In case of any
existing or perceived difference in contents between such versions and/or in print, the prevailing version of an ETSI
deliverable is the one made publicly available in PDF format at www.etsi.org/deliver.
Users of the present document should be aware that the document may be subject to revision or change of status.
Information on the current status of this and other ETSI documents is available at
https://portal.etsi.org/TB/ETSIDeliverableStatus.aspx
If you find errors in the present document, please send your comment to one of the following services:
https://portal.etsi.org/People/CommiteeSupportStaff.aspx
If you find a security vulnerability in the present document, please report it through our
Coordinated Vulnerability Disclosure Program:
https://www.etsi.org/standards/coordinated-vulnerability-disclosure
Notice of disclaimer & limitation of liability
The information provided in the present deliverable is directed solely to professionals who have the appropriate degree of
experience to understand and interpret its content in accordance with generally accepted engineering or
other professional standard and applicable regulations.
No recommendation as to products and services or vendors is made or should be implied.
No representation or warranty is made that this deliverable is technically accurate or sufficient or conforms to any law
rule and/or regulation and further, no representation or warranty is made of merchantability or fitness
and/or governmental
for any particular purpose or against infringement of intellectual property rights.
In no event shall ETSI be held liable for loss of profits or any other incidental or consequential damages.

Any software contained in this deliverable is provided "AS IS" with no warranties, express or implied, including but not
limited to, the warranties of merchantability, fitness for a particular purpose and non-infringement of intellectual property
rights and ETSI shall not be held liable in any event for any damages whatsoever (including, without limitation, damages
for loss of profits, business interruption, loss of information, or any other pecuniary loss) arising out of or related to the use
of or inability to use the software.
Copyright Notification
No part may be reproduced or utilized in any form or by any means, electronic or mechanical, including photocopying and
microfilm except as authorized by written permission of ETSI.
The content of the PDF version shall not be modified without the written authorization of ETSI.
The copyright and the foregoing restriction extend to reproduction in all media.

© ETSI 2023.
All rights reserved.

ETSI

---------------------- Page: 2 ----------------------
3 ETSI GS MEC 040 V3.1.1 (2023-02)
Contents
Intellectual Property Rights . 5
Foreword . 5
Modal verbs terminology . 5
1 Scope . 6
2 References . 6
2.1 Normative references . 6
2.2 Informative references . 6
3 Definition of terms, symbols and abbreviations . 7
3.1 Terms . 7
3.2 Symbols . 7
3.3 Abbreviations . 7
4 Overview . 7
4.1 Introduction . 7
4.2 GSMA Operator Platform and its interfaces . 8
5 Description of the services (informative) . 9
5.1 Federation enablement service introduction . 9
5.2 Sequence diagrams . 9
5.2.1 Introduction. 9
5.2.2 Request/Response model . 10
5.2.2.1 Registration/Update/Deregistration of MEC system to the MEC federator . 10
5.2.2.1.1 Registration . 10
5.2.2.1.2 Update . 10
5.2.2.1.3 Deregistration . 10
5.2.2.2 MEC system discovery . 11
5.2.2.3 MEC application instance discovery . 12
5.2.2.4 MEC service discovery . 13
5.2.2.5 Application package management and Application instance lifecycle management . 14
5.2.2.5.1 Introduction . 14
5.2.2.5.2 On-boarding application package . 15
5.2.2.5.3 Application Instantiation . 15
5.2.2.6 Providing MEC system-wide MEC application instance information updates to MEF . 16
5.2.2.7 Forwarding MEC system-wide MEC application instance information updates to another MEC
system of MEC federation . 17
5.2.3 REST based subscribe-notify model . 17
5.2.3.1 Subscribing to federation event notifications . 17
5.2.3.2 Receiving notification on expiry of federation event subscription . 18
5.2.3.3 Updating subscription for federation event notifications . 18
5.2.3.4 Unsubscribing from federation event notifications . 19
5.2.3.5 Receiving MEC system registration/update notifications . 19
5.2.3.6 Receiving MEC application instance registration/ registration update/ deregistration notifications . 20
6 Data model . 20
6.1 Introduction . 20
6.2 Resource data types . 20
6.2.1 Introduction. 20
6.2.2 Type: SystemInfo . 20
6.2.3 Type: SystemInfoUpdate . 21
6.3 Subscription data types . 21
6.3.1 Introduction. 21
6.3.2 Type: SystemUpdateNotificationSubscription . 21
6.4 Notifications data types . 22
6.4.1 Introduction. 22
6.4.2 Type: SystemUpdateNotification . 22
6.5 Referenced structured data types . 22
ETSI

---------------------- Page: 3 ----------------------
4 ETSI GS MEC 040 V3.1.1 (2023-02)
6.5.1 Introduction. 22
6.5.2 Type: TimeStamp . 22
7 API definition . 22
7.1 Introduction . 22
7.2 Global definitions and resource structure . 22
7.3 Resource: A list of system_info . 24
7.3.1 Description . 24
7.3.2 Resource definition . 24
7.3.3 Resource methods . 24
7.3.3.1 GET . 24
7.3.3.2 PUT . 25
7.3.3.3 PATCH . 25
7.3.3.4 POST . 25
7.3.3.5 DELETE . 26
7.4 Resource: Individual system_info . 26
7.4.1 Description . 26
7.4.2 Resource definition . 26
7.4.3 Resource methods . 27
7.4.3.1 GET . 27
7.4.3.2 PUT . 27
7.4.3.3 PATCH . 27
7.4.3.4 POST . 28
7.4.3.5 DELETE . 28
Annex A (informative): Enabling MEC App providers to access MEC federation services . 30
A.1 Introduction . 30
Annex B (informative): Complementary material for API utilization . 32
History . 33


ETSI

---------------------- Page: 4 ----------------------
5 ETSI GS MEC 040 V3.1.1 (2023-02)
Intellectual Property Rights
Essential patents
IPRs essential or potentially essential to normative deliverables may have been declared to ETSI. The declarations
pertaining to these essential IPRs, if any, are publicly available for ETSI members and non-members, and can be
found in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to
ETSI in respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the
ETSI Web server (https://ipr.etsi.org/).
Pursuant to the ETSI Directives including the ETSI IPR Policy, no investigation regarding the essentiality of IPRs,
including IPR searches, has been carried out by ETSI. No guarantee can be given as to the existence of other IPRs not
referenced in ETSI SR 000 314 (or the updates on the ETSI Web server) which are, or may be, or may become,
essential to the present document.
Trademarks
The present document may include trademarks and/or tradenames which are asserted and/or registered by their owners.
ETSI claims no ownership of these except for any which are indicated as being the property of ETSI, and conveys no
right to use or reproduce any trademark and/or tradename. Mention of those trademarks in the present document does
not constitute an endorsement by ETSI of products, services or organizations associated with those trademarks.
DECT™, PLUGTESTS™, UMTS™ and the ETSI logo are trademarks of ETSI registered for the benefit of its

Members. 3GPP™ and LTE™ are trademarks of ETSI registered for the benefit of its Members and of the 3GPP
Organizational Partners. oneM2M™ logo is a trademark of ETSI registered for the benefit of its Members and of the
®
oneM2M Partners. GSM and the GSM logo are trademarks registered and owned by the GSM Association.
Foreword
This Group Specification (GS) has been produced by ETSI Industry Specification Group (ISG) Multi-access Edge
Computing (MEC).
Modal verbs terminology
In the present document "shall", "shall not", "should", "should not", "may", "need not", "will", "will not", "can" and
"cannot" are to be interpreted as described in clause 3.2 of the ETSI Drafting Rules (Verbal forms for the expression of
provisions).
"must" and "must not" are NOT allowed in ETSI deliverables except when used in direct citation.

ETSI

---------------------- Page: 5 ----------------------
6 ETSI GS MEC 040 V3.1.1 (2023-02)
1 Scope
The present document focuses on the functionalities enabled over the relevant reference points (i.e. Mfm and Mff) to
support MEC federation. It describes the information flows, required information, and specifies the necessary
operations, data models and API definitions. The present document carefully considers the relevant work of other
industry bodies relating to MEC federation (e.g. GSMA OPG, 5GAA, etc.) and all relevant work done in ETSI.
2 References
2.1 Normative references
References are either specific (identified by date of publication and/or edition number or version number) or
non-specific. For specific references, only the cited version applies. For non-specific references, the latest version of the
referenced document (including any amendments) applies.
Referenced documents which are not found to be publicly available in the expected location might be found at
https://docbox.etsi.org/Reference.
NOTE: While any hyperlinks included in this clause were valid at the time of publication, ETSI cannot guarantee
their long term validity.
The following referenced documents are necessary for the application of the present document.
[1] ETSI GS MEC 001: "Multi-access Edge Computing (MEC); Terminology".
[2] IETF RFC 5246: "The Transport Layer Security (TLS) Protocol Version 1.2".
NOTE: Available at RFC 5246: The Transport Layer Security (TLS) Protocol Version 1.2 (rfc-editor.org).
[3] IETF RFC 8446: "The Transport Layer Security (TLS) Protocol Version 1.3".
NOTE: Available at RFC 8446: The Transport Layer Security (TLS) Protocol Version 1.3 (rfc-editor.org).
[4] ETSI TS 133 210: "Digital cellular telecommunications system (Phase 2+) (GSM); Universal
Mobile Telecommunications System (UMTS); LTE; 5G; Network Domain Security (NDS);
IP network layer security (3GPP TS 33.210)".
2.2 Informative references
References are either specific (identified by date of publication and/or edition number or version number) or
non-specific. For specific references, only the cited version applies. For non-specific references, the latest version of the
referenced document (including any amendments) applies.
NOTE: While any hyperlinks included in this clause were valid at the time of publication, ETSI cannot guarantee
their long term validity.
The following referenced documents are not necessary for the application of the present document but they assist the
user with regard to a particular subject area.
[i.1] GSMA Permanent Reference Document: "Operator Platform Telco Edge Requirements", v1.0,
June 2021.
NOTE: Available at https://www.gsma.com/futurenetworks/wp-content/uploads/2021/06/OPG-Telco-Edge-
Requirements-2021.pdf.
[i.2] ETSI GR MEC 035: "Multi-access Edge Computing (MEC); Study on Inter-MEC systems and
MEC-Cloud systems coordination".
[i.3] ETSI GS MEC 002: "Multi-access Edge Computing (MEC); Use Cases and Requirements".
ETSI

---------------------- Page: 6 ----------------------
7 ETSI GS MEC 040 V3.1.1 (2023-02)
[i.4] ETSI GS MEC 003: "Multi-access Edge Computing (MEC); Framework and Reference
Architecture".
[i.5] ETSI GS MEC 011: "Multi-access Edge Computing (MEC); Edge Platform Application
Enablement".
[i.6] ETSI GS MEC 010-2: "Multi-access Edge Computing (MEC); MEC Management; Part 2:
Application lifecycle, rules and requirements management".
[i.7] OpenAPI™ Specification.
NOTE: Available at https://github.com/OAI/OpenAPI-Specification.
[i.8] ETSI GS MEC 009: "Multi-access Edge Computing (MEC); General principles, patterns and
common aspects of MEC Service APIs".
[i.9] IETF RFC 4122: "A Universally Unique IDentifier (UUID) URN Namespace".
NOTE: Available at RFC 4122: A Universally Unique IDentifier (UUID) URN Namespace (rfc-editor.org).
3 Definition of terms, symbols and abbreviations
3.1 Terms
Void.
3.2 Symbols
Void.
3.3 Abbreviations
For the purposes of the present document, the abbreviations given in ETSI GS MEC 001 [1] and the following apply:
App Application
CHF Charging Functions
CR Cloud Resources
E/WBI East/West Bound Interface
GSMA GSM Association
MEF MEC Federator
NBI NorthBound Interface
NR Network Resources
OP Operator Platform
SBI SouthBound Interface
UNI User Network Interface
4 Overview
4.1 Introduction
The present document specifies Federation enablement APIs that enable the shared usage of MEC services and
applications across different systems (e.g. MEC system, Cloud system).
Clause 4 introduces the relevant work of other industry bodies (e.g. GSMA OPG).
ETSI

---------------------- Page: 7 ----------------------
8 ETSI GS MEC 040 V3.1.1 (2023-02)
Clause 5 presents the reference scenarios for the MEC federation, and introduces the functionalities enabled via the
relevant reference points (i.e. Mfm and Mff). It provides the high-level information flows and describes the necessary
operations.
Clause 6 describes the data models that can be exchanged over the Federation enablement APIs, which provide detailed
descriptions of all information elements used for MEC federation.
Clause 7 defines the actual Federation enablement APIs providing detailed information of how information elements are
mapped into a RESTful API design.
4.2 GSMA Operator Platform and its interfaces
According to the GSMA Permanent Reference Document (PRD), "Operator Platform Telco Edge Requirements" [i.1],
an Operator Platform (OP) is a facilitator of subscribers' seamless access to edge applications instantiated within a
federation of edge networks involving multiple owners. Such seamless access is needed either when subscribers roam to
visited networks or when a partner network is a better choice for edge application instantiation.
The objective of the OP concept is to guide the industry ecosystem, i.e. MNOs, vendors, OEMs and service providers
towards shaping a common solution for the exposure of network capabilities. As an initial step, [i.1] provides both an
end-to-end definition and requirements of the OP for the support of edge computing. In further details, the GSMA
defines OP requirements as well as OP architecture and functional modules. Therefore, aim of GSMA is to engage with
standardization and open source communities that will undertake the standard definition of the OP. As depicted in
Figure 4.2-1, the following OP interfaces have been defined [i.1]:

Figure 4.2-1: High-level OP reference architecture (source: [i.1])
• Northbound Interface (NBI)
• Southbound Interface (SBI); Cloud Resources (SBI-CR)
• Southbound Interface (SBI); Network Resources (SBI-NR)
• Southbound Interface (SBI); Charging Functions (SBI-CHF)
• User Network Interface (UNI)
• East/West Bound Interface (E/WBI)
ETSI

---------------------- Page: 8 ----------------------
9 ETSI GS MEC 040 V3.1.1 (2023-02)
5 Description of the services (informative)
5.1 Federation enablement service introduction
Federation enablement APIs offer services such as discovery, information exchange and application life cycle
management to enable the inter-work of one MEC system with another MEC system. The related requirements were
carefully studied and extracted from various use cases in ETSI GR MEC 035 [i.2] including V2X services scenario,
multi-operator environment, Application instance transfer between a MEC system and a MEC/Cloud system,
connecting different services, immersive AR game scenario, edge service delivery through visited network and
edge node sharing.
The extracted requirements are listed as follows, summarized from ETSI GS MEC 002 [i.3].
• MEC system discovery ([Federation-02])
• MEC platform discovery ([Federation-03])
• Information exchange between MEC systems ([Federation-04])
• Information exchange between MEC platforms ([Federation-05])
• Support handling direct/indirect MEC system communication ([Federation-06])
• MEC application discovery ([Federation-07])
• MEC application on-boarding/instantiation ([Federation-08])
• Information exchange among MEC applications ([Federation-09])
• MEC service discovery ([Federation-10])
NOTE: Reusing the data models and APIs for MEC-Cloud coordination is considered if applicable, but its
information flow is out of scope of the present document.
5.2 Sequence diagrams
5.2.1 Introduction
The rest of clause 5.2 introduces the following sequence diagrams based on the extracted requirements.
• Registration of MEC system(s) to the federation (clause 5.2.2.1)
• Discovery:
- MEC system discovery (clause 5.2.2.2)
- MEC application discovery (clause 5.2.2.3)
- MEC service discovery (clause 5.2.2.4)
• Application package management and Application instance lifecycle management (clause 5.2.2.5)
NOTE 1: Support handling direct/indirect MEC system communication is satisfied by MEC Federator as defined in
ETSI GS MEC 003 [i.4].
NOTE 2: The requirement for registration is based on the premise that multiple MEOs can register to a single MEF.
ETSI

---------------------- Page: 9 ----------------------
10 ETSI GS MEC 040 V3.1.1 (2023-02)
5.2.2 Request/Response model
5.2.2.1 Registration/Update/Deregistration of MEC system to the MEC federator
5.2.2.1.1 Registration
The registration information flow is used for enabling a MEO to register its MEC system information with a
MEC Federator over Mfm reference point, as depicted in Figure 5.2.2.1.1-1.

Figure 5.2.2.1.1-1: Information flow of Registration
Registration procedure consists of the following steps:
1) The MEO sends a registration request to the MEC federator.
2) The MEC federator responds with a unique ID among federation members.
5.2.2.1.2 Update
Information flow of update of MEC system(s) to the federation is depicted in Figure 5.2.2.1.2-1.

Figure 5.2.2.1.2-1: Information flow of Update
Update procedure consists of the following steps:
1) The MEO sends an update request to MEC Federator.
2) MEC Federator returns an acknowledgement to MEO.
5.2.2.1.3 Deregistration
Information flow of deregistration of MEC system(s) from the federation is depicted in Figure 5.2.2.1.3-1.
ETSI

---------------------- Page: 10 ----------------------
11 ETSI GS MEC 040 V3.1.1 (2023-02)

Figure 5.2.2.1.3-1: Information flow of Deregistration
Deregistration procedure consists of the following steps:
1) The MEO sends an update request to MEC Federator.
2) MEC Federator returns an acknowledgement to MEO.
5.2.2.2 MEC system discovery
Information flow of MEC system discovery is used for enabling MEO to be aware of another MEC system. MEC
system discovery is the primitive and essential procedure for enabling the other functionalities relating to Feature MEC
Federation. The information flow is depicted in Figure 5.2.2.2-1.

Figure 5.2.2.2-1: Information flow of MEC system discovery
As a prerequisite of this flow, MEC Federator Discovery is
...