The LSO Legato SDK is the complete set of deliverables developed by the MEF membership in order to
- Enable market adoption of LSO Legato APIs in the current release of the LSO API Framework.
- Support of development of additional features for the upcoming release of the LSO Legato SDK.
The latest release of LSO Legato SDK is in the LSO API Release 'Haley' and is available on GitHub (see Latest Release section for details).
Any MEF member can participate in the development of each new release of the LSO Legato SDK:
Contact the LSO Developer Community Manager (Michał Łączyński) either via GitHub or by email to let him know of your interest and to ask questions
MEF-LSO-Legato-SDK Haley Release
Download Link
Download the entire repository by clicking here
Overview
This repository contains the release of the Legato SDK. The SDK includes APIs for Service Catalog, Service Order, Service Inventory, Performance Monitoring, and Streaming Management functions of the Service Orchestration Functionality (SOF) at the LSO Legato Interface Reference Point (IRP) as defined in the MEF LSO Reference Architecture.
Also included are Service schemas and Performance Monitoring definitions.
High-level release notes
- Updated documents:
- MEF 128.1 - LSO API Security Profile
Scope
It includes API definitions for the following functional areas:
- Service Catalog - This includes support for
- Service Specification - Retrieve operations only
- Not in scope
- Service Specifications - Create, Amend/Modify, Delete operations
- Service Catalog, Service Category, Service Candidate, Job/Task
- Service Ordering - This includes support for
- Service Order/OrderItem - Create and Retrieve operations only
- Not in scope
- Service Order/OrderItem - Amend/Modify/Cancel, Delete operations
- Service Inventory - This includes support for
- Service - Retrieve operations only
- Not in scope
- Service - Create, Amend/Modify, Delete operations
- Performance Monitoring
- Streaming Management
In addition to the Service Provisioning APIs, the SDK includes the following MEF Service Specification schemas:
- SD-WAN Services
- Carrier Ethernet Services
- L1 Connectivity Services
- IP/IP-VPN Services
The MEF LSO Legato SDK is released under the Apache 2.0 license.
More information about the LSO Legato API reference point and its roadmap can be found here:
https://wiki.mef.net/display/CESG/LSO+Legato
Maturity Level
The API files contained in this SDK are evolving and subject to change. They are based on documents that are either work in progress or draft standards that have not yet completed the review cycles and approvals necessary to achieve the status as a MEF standard. MEF is making these publicly available at this time to invite wider industry review.
The maturity per functionality is presented as follows:
(*) is used to mark an item that changes its maturity compared to the previous release.
APIs and Developer Guides:
- Service Catalog API - early draft version, on hold
- MEF 99 - LSO Service Ordering Management API - Developer Guide W99 - Published Standard
- MEF 135 - LSO Legato Service Inventory Management API - Developer Guide - Published Standard
Service Schemas:
- SD-WAN (MEF W100) - work in progress - CfC#2
- Carrier Ethernet (MEF W101) - work in progress - CfC#2
- Internet Protocol (MEF W102) - work in progress - CfC#4
- LSO Legato Service Provisioning Specification - L1 (MEF W103) - work in progress - CfC#3 - on hold
SOAM:
MEF 133 - Allegro, Interlude and Legato Fault Management and Performance Monitoring BR&UC - Published Standard
MEF W133.1 - Allegro, Interlude and Legato Fault Management and Performance Monitoring BR&UC - early draft version, CfC#1
MEF 136 - Service Function Testing Business Requirements and Use Cases - Published Standard
MEF W143 - Performance Monitoring API and Developer Guide - work in progress - CfC#2
MEF W147 - Streaming Management API and Developer Guide - work in progress - CfC#2
Performance Monitoring reports and statistics definitions for Carrier Ethernet and IP - early draft version, schemas only
Security:
- *MEF 128.1 - Published Standard
Contents
This SDK contains the following items:
COPYRIGHT
- Copyright 2024 MEF ForumLICENSE
- Contains a copy of the Apache 2.0 licenseREADME
- This fileserviceApi
- Definitions of the APIs are found in this directory, provided as yaml files.serviceSchema
- Contains JSON schema (draft 7) files for service specifications.documentation
- documentation including API/Schema developer guides and openapi-tools generated API descriptions in markdown formatsupportingStandards
- The rest of the documents and standards.
generated
staticBinding
- No longer provided - please visit
LSO Marketplace to use self-blending possibility.security
- A not normative version of the standard APIs including the
security profiles as required by MEF 128.1. Provided for evaluation.
Issues, questions, and Feedback
Issues should be reported with the use of GitHub issues. Questions and feedback should be asked either at Legato SDK Discussions or directly to community_manager@mef.net.
NOTE: All artifacts included in this repository have line numbers. When referring to specific content in any of these artifacts, please quote the line numbers to which you are referring.
Reference Implementations
A reference implementation of the MEF Service Instantiation API may be available from the ONAP EXTAPI project.
https://wiki.onap.org/display/DW/External+API+Framework+Project
Copyright
© MEF Forum 2024. All Rights Reserved.
BR&UC - Business Requirements & Use Cases
Underlined item indicates a release deliverable that is a delta from the previous SDK release.
Published standard | Draft standard | Work in progress |
---|
LSO Legato SDK Haley (Production)
Version: haley
Date: June 20th 2024
Release Haley Deliverables:
Deliverable | Maturity |
---|---|
None |
LSO Legato SDK Irene (Planned: December 2024)
Release Irene Deliverables:
Deliverable | Maturity |
---|---|
MEF W102 - IP-VPN Schema/Guide for Service Provisioning | CfC #5 |
MEF W100 - SD-WAN Schema/Guide for Service Provisioning | CfC #4 |
MEF W101 - Carrier Ethernet Schema/Guide for Service Provisioning | CfC #4 |
MEF W133.1 - Fault Management and Performance Monitoring BR&UC | RfD#1 |
MEF W136.1 - Service Function Testing BR&UC | RfD#1 |
MEF W143 - Performance Monitoring and Passive Statistics | CfC #3 |
MEF W147 - Streaming Management API and Dev Guide | LB |
MEF W158 - Allegro, Interlude, Legato Service Ordering BR/UC | RfD#1 |
MEF W159 - Allegro, Interlude, Legato Service Inventory BR/UC | RfD#1 |
MEF W99.1 - Service Provisioning API & Dev Guide | CfC #1 |
MEF W135.1 - Service Inventory API & Dev Guide | CfC #1 |
MEF W145 - Threshold Crossing Alert Profile Management, Jobs API and Dev Guide | CfC #1 |
MEF W146 - Threshold Crossing Alerts (Alarms) API and Dev Guide | CfC #1 |
MEF W148 - Fault Management API and Dev Guide | CfC #1 |
MEF W149 - Service Function Testing API and Dev Guide | CfC #1 |
LSO Legato SDK Janis (Planned: June 2025)
Release Janis Deliverables:
Deliverable | Maturity |
---|---|
MEF W100 - SD-WAN Schema/Guide for Service Provisioning | LB |
MEF W101 - Carrier Ethernet Schema/Guide for Service Provisioning | LB |
MEF W102 - IP-VPN Schema/Guide for Service Provisioning | LB |
MEF W133.1 - Fault Management and Performance Monitoring BR&UC | LB |
MEF W136.1 - Service Function Testing BR&UC | LB |
MEF W99.1 - Service Provisioning API & Dev Guide | CfC #2 |
MEF W135.1 - Service Inventory API & Dev Guide | CfC #2 |
MEF W145 - Threshold Crossing Alert Profile Management, Jobs API and Dev Guide | CfC #2 |
MEF W146 - Threshold Crossing Alerts (Alarms) API and Dev Guide | CfC #2 |
MEF W148 - Fault Management API and Dev Guide | CfC #2 |
MEF W149 - Service Function Testing API and Dev Guide | CfC #2 |
MEF W158 - Allegro, Interlude, Legato Service Ordering BR/UC | RfD #2 |
MEF W159 - Allegro, Interlude, Legato Service Inventory BR/UC | RfD #2 |
LSO Legato SDK Grace
Version: grace
Date: December 20th 2023
Release Grace Deliverables:
Deliverable | Maturity |
---|---|
MEF W102 - IP-VPN Schema/Guide for Service Provisioning | CfC #4 |
MEF W143 - Performance Monitoring and Passive Statistics | CfC #2 |
MEF W147 - Streaming Management API and Dev Guide | CfC #2 |
LSO Legato SDK Fergie
Version: fergie
Date: June 23rd 2023
Release Fergie Deliverables:
Deliverable | Maturity | comment |
---|---|---|
MEF W133 - Fault Management and Performance Monitoring BR&UC | Standard | |
MEF W136 - Service Function Testing BR&UC | Standard | |
MEF W99 - Service Provisioning API & Dev Guide | LB | |
MEF W135 - Service Inventory API & Dev Guide | LB | |
MEF W100 - SD-WAN Schema/Guide for Service Provisioning | CfC #2 | |
MEF W143 - Performance Monitoring and Passive Statistics | CfC #1 | |
MEF W147 - Streaming Management API and Dev Guide | CfC #1 | |
MEF W152 - Carrier Ethernet Payload Schema/Guide for SOAM | only yamls | |
MEF W153 - IP/IPVPN Schema/Guide for SOAM | only yamls |
LSO Legato SDK Ella
Version: ella
Date: January 5th 2023
Release Ella Deliverables:
Deliverable | Maturity |
---|---|
MEF W112 - MEF Services Model Information Model for IP and IP VPN | Standard |
MEF W133 - Interlude SOAM, FM, PM | LB |
MEF W128 - LSO API Security Profile | Standard |
MEF W101 - Carrier Ethernet Schema/Guide for Service Provisioning | CfC #2 |
MEF W102 - IP-VPN Schema/Guide for Service Provisioning | CfC #2 |
MEF W99 - Service Provisioning API & Dev Guide | CfC #3 |
MEF W135 - Service Inventory API & Dev Guide | CfC #1 |
LSO Legato SDK Release Dolly
Version: dolly
Date: June 14th 2022
Release Dolly Deliverables:
Deliverable | Maturity |
---|---|
MEF W112 - MEF Services Model Information Model for IP and IP VPN | RfD #1 |
MEF W128 - LSO API Security Profile | RfD #2 |
LSO Legato SDK Release Celine
Version: celine
Date: January 14th 2022
Release Celine Deliverables:
Deliverable | Maturity |
---|---|
MEF W99 (Developer Guide document) | CfC#2 |
MEF W99 Generic API & Schema incl. following functions:
| CfC#2 |
MEF W100 SD-WAN Developer Guide | CfC#3 |
MEF W100 SD-WAN Schema | CfC#3 |
MEF W101 CE (EVC_OVC) Developer Guide | CfC#3 |
MEF W101 CE (EVC_OVC) Schema | CfC#3 |
MEF W103 L1 Developer Guide | CfC#3 |
MEF W103 L1 Schema | CfC#3 |
LSO Legato SDK Release Billie (June 2021)
Version: billie
Date: June 2021
SDK Repository:https://github.com/MEF-GIT/MEF-LSO-Legato-SDK/releases/tag/billie
Release Billie Deliverables:
Deliverable | Maturity |
---|---|
MEF W99 Generic API & Schema incl. following functions:
| CfC#2 |
MEF W100 SD-WAN Developer Guide | CfC#2 |
MEF W100 SD-WAN Schema | CfC#2 |
MEF W101 CE (EVC_OVC) Developer Guide | CfC#2 |
MEF W101 CE (EVC_OVC) Schema | CfC#2 |
MEF W103 L1 Developer Guide | CfC#2 |
MEF W103 L1 Schema | CfC#2 |
LSO Legato SDK Release Aretha
GitHub tag: aretha
Date: 22nd December 2021
SDK Repository: https://github.com/MEF-GIT/MEF-LSO-Legato-SDK
Maturity Map:
Underlined item indicates a release deliverable that is a delta from the previous SDK release.
Function | BR&UC | IIS | Product specs | ||
---|---|---|---|---|---|
Doc | Spec | Document | Spec | ||
Service Catalog | MEF W73 | MEF W99 | MEF W101 CE (EVC_OVC) MEF W100 SD-WAN | SD-WAN CE (EVC_OVC) L1 IP | |
Service Ordering | |||||
Service Inventory | |||||
Service Notification |
Release Aretha Deliverables:
Theme: Multi-technology service provisioning
Deliverable | Maturity |
---|---|
MEF W99 Generic API & Schema incl. following functions:
| CfC#2 partially resolved |
MEF W100 SD-WAN Schema | Working draft |
MEF W101 CE (EVC_OVC) Schema | Working draft |
MEF W103 L1 Schema | Working draft |
LSO Legato SDK Release 4
Version: R4
Date: 31st July 2020
SDK Repository: https://github.com/MEF-GIT/MEF-LSO-Legato-SDK/releases/download/rc4/MEF-LSO-Legato-SDK-rc4.zip
Maturity Map
Function | BR&UC | Developer Guide | Service specs | ||
---|---|---|---|---|---|
Doc | API | Document | Spec | ||
Service Catalog | SD-WAN CE (EVC_OVC) L1 | ||||
Service Ordering | |||||
Service Inventory | |||||
Service Notification |
Release 4 Deliverables
Deliverable | Change |
---|---|
Generic API & Schema incl. following functions:
| Update |
Align envelope-payload approach to Sonata Pattern | Update |
SD-WAN - Service Schema only (part of MEF W100) | Update |
CE (EVC_OVC) - Service Schema only (part of MEF W101) | Update |
L1 - Service Schema only (part of MEF W103) | New |
LSO Legato SDK Release 3
Version: R3
Date: Aug 2019
SDK Repository: https://github.com/MEF-GIT/MEF-LSO-Legato-SDK/releases/tag/r3
Function | BR&UC | Swagger | Product specs |
---|---|---|---|
Service Catalog | CE (EVC_OVC) SD-WAN | ||
Service Ordering | |||
Service Inventory | |||
Service Notification |
PUBLIC
Core (public):
https://github.com/MEF-GIT/MEF-LSO-Legato-SDK
Extensions (MEF Members only):
https://github.com/MEF-GIT/MEF-LSO-Legato-SDK-extended
If you are a MEF Member, update your wiki profile with your GitHub account name. Access to the LSO Legato SDK Extensions repository is periodically updated with provided GitHub accounts. Additionally contact the LSO Developer Community Manager to request the immediate access.
Are you a core contributor to this LSO SDK but not mentioned here? Please let the LSO Developer Community Manager know and we will add you!