The LSO Legato SDK is the complete set of deliverables developed by the MEF membership in order to

1. Enable market adoption of LSO Legato APIs in the current release of the LSO API Framework.
2. 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 'Ella' 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 Ella 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 and Service Notification 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 draft, in-progress versions of the API Developer Guides for each of the service types listed above.

High-level release notes

• Service Ordering and Service Inventory APIs are updated to match all Sonata API patterns and have API Developer Guide documents provided (MEF W99 and MEF W135).
• Carrier Ethernet and IP service schemas are revised and updated, together with their guide documents (MEF W101, MEF W102)
• Following documents have been published as MEF Standards:
  • MEF 112 - Draft Release 1 MEF Services Model Information Model for IP and IP VPN
  • MEF 128 - Draft Release 2 LSO API Security Profile
• New document:
  • MEF W133 - Allegro, Interlude and Legato Fault Management and Performance Monitoring BR&UC

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, 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
• Service Notification - This includes support for
  • Hub - Create, Delete, Retrieve operations
  • Service Specification - Create, Delete, StateChange event notifications
  • Service Order/OrderItem - Create, StateChange event notifications
  • Service events - Create, Delete, StateChange event notifications
  • Not in scope
    • Hub - Modify operations
    • Retrieve Notification records history/log
    • AttributeValueChange event notifications

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 it's 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.

There is currently LSO Legato Service Provisioning Project open that aims to deliver:

• *LSO Legato Service Ordering Management API (MEF W99) - work in progress - ready for CfC#2
• *LSO Legato Service Inventory Management API - Developer Guide (MEF W135) - work in progress - ready for CfC#2
• LSO Legato Service Provisioning Specification - SD-WAN (MEF W100) - DRAFT version
• *LSO Legato Carrier Ethernet Service Schemas and Developer Guide (MEF W101) - work in progress - ready for CfC#2
• *LSO Legato Internet Protocol Service Schemas and Developer Guide (MEF W102) - work in progress - ready for CfC#2
• LSO Legato Service Provisioning Specification - L1 (MEF W103) - DRAFT version

(*) is used to mark item that changes their maturity comparing to previous release.

Contents

This SDK contains the following items:

• COPYRIGHT - Copyright 2020 MEF Forum
• LICENSE - Contains a copy of the Apache 2.0 license
• README - This file
• serviceApi - 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 format
  • supportingStandards - The rest of 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. 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 Community 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

BR&UC - Business Requirements & Use Cases

Underlined item indicates a release deliverable that is a delta from the previous SDK release.

LSO Legato SDK Ella  (Production)

Version: ella

Date:  January 5th 2023

Release Ella Deliverables:

LSO Legato SDK Fergie (Planned: June 2023)

Release Fergie Deliverables:

LSO Legato SDK Grace (Planned: December 2023)

Release Grace Deliverables:

LSO Legato SDK Haley (Planned: June 2024)

Release Haley Deliverables:

LSO Legato SDK Release Dolly

Version: dolly

Date:  June 14th 2022

Release Dolly Deliverables:

LSO Legato SDK Release Celine

Version: celine

Date:  January 14th 2022

Release Celine Deliverables:

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:

LSO Legato SDK Release Aretha

GitHub tag: aretha

Date:  22^nd 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.

Release Aretha Deliverables:

Theme: Multi-technology service provisioning

LSO Legato SDK Release 4

Version: R4

Date:  31^st July 2020

SDK Repository: https://github.com/MEF-GIT/MEF-LSO-Legato-SDK/releases/download/rc4/MEF-LSO-Legato-SDK-rc4.zip

Maturity Map

Release 4 Deliverables

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 specs	Product specs
Service Catalog			CE (EVC_OVC) SD-WAN
Service Ordering
Service Inventory
Service Notification