Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel

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 'ArethaBillie' 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



Panel
titleLatest Release

MEF-LSO-Legato-SDK

Aretha

Billie Release

Download the entire repository by clicking here.

Overview

This repository contains the Aretha Billie release of the LSO Legato SDK. The SDK includes Service Provisioning APIs describing the Application Programming Interfaces
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.

This version updates the payload schemas for:

  • Carrier Ethernet (based on MEF 7.4),
  • SD-WAN (based on MEF 82) and
  • L1CS (based on MEF 111).

Future versions will include full Also included are draft, in-progress versions of the API Developer Guides for
each of the service types listed above.

Scope

It includes API definitions for the following functional areas:

  • Service Catalog
    - This includes support for
      Included
    • 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
      Included
    • Service Order/OrderItem - Create, Retrieve operations only
    • Not in scope
      • Service Order/OrderItem - Amend/Modify/Cancel, Delete operations
  • Service Inventory - This includes support for
      Included
    • Service - Retrieve operations only
    • Not in scope
      • Service - Create, Amend/Modify, Delete operations
  • Service Notification - This includes support for
      Included
    • 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

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 , ratified standards, 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 Provisioning API (MEF W99)
    • OAS3 API/Schema definitions as YAML files (READYDRAFT, part of this SDK
      release)
    • API Developer Guide as GFM file (To be delivered)
  • LSO Legato Service Provisioning Specification - SD-WAN (MEF W100)
    • JSON Schema definitions as YAML files (READYDRAFT, part of this SDK release)
    • Requirements document Schema Guide as GFM file (To be deliveredDRAFT, part of this SDK release)
  • LSO Legato Service Provisioning Specification - Carrier Ethernet (MEF W101)
    • JSON Schema definitions as YAML files (READYDRAFT, part of this SDK release)
    • Requirements document Schema Guide as GFM file (To be deliveredDRAFT, part of this SDK release)
  • LSO Legato Service Provisioning Specification - L1 (MEF W103)
    • JSON Schema definitions as YAML files (READYDRAFT, part of this SDK release)
    • Requirements document Schema Guide as GFM file (To be deliveredDRAFT, part of this SDK 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
  • api\legato\serviceProvisioning serviceApi - Definitions of the API are found in this directory
    • serviceCatalog catalog - Contains the API definitions for querying and retrieving
      Service-Specification instances from the service catalog system in the
      SOF.
    • serviceInventory inventory - Contains the API definitions for querying and retrieving
      Service instances from the service inventory system in the SOF.
    • serviceOrdering order - Contains the API definitions for posting Service-Order request
      to the service order system in the SOF. Each Service-Order contains one or
      more Service-Order-Items, each of which specifies the Service instance
      (and its characteristics) to be added/updated/deleted.
    • serviceCommon common - Contains the API definitions for registering
      Notification-Listeners to be called-back when the specified condition
      occurs. Also common API resources and error definition can be found here.
  • doc – automatically generated documentation.
  • serviceSchema - Contains JSON schema (draft 7) files forspec – Contains OpenAPI 3.0 Specification files for
      • SD-WAN
      ,
      • Services
      • Carrier Ethernet Services
      and
      • L1 Connectivity Services.
    • documentation - documentation including API/Schema developer guides and
      openapi-tools generated API descriptions in markdown format
    • generated\staticBinding - contains automatically generated (with help of the
      open source Sonata Blending Tool), not normative static bindings of envelope APIs with Service payloads.

    Issues,

    Questions

    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

    Related Projects

    The MEF Legato IPS is based on ONAP EXternal API (Dublin) which can be found here:An instance of the ONAP project may be provided in MEFnet for MEF members to
    undertake integration testing. Please see the MEFnet Terms of Use.

    https://docswiki.onapmef.orgnet/endisplay/latest/submodules/externalapi/nbi.git/docs/offeredapis/offeredapis.htmlCESG/MEFnet

    https://mef.net/TOU

    © MEF Forum 2021. All Rights Reserved.

    Disclaimer

    The information in this publication is freely available for reproduction and use
    by any recipient and is believed to be accurate as of its publication date. Such
    information is subject to change without notice and MEF Forum (MEF) is not
    responsible for any errors. MEF does not assume responsibility to update or
    correct any information in this publication. No representation or warranty,
    expressed or implied, is made by MEF concerning the completeness, accuracy, or
    applicability of any information contained herein and no liability of any kind
    shall be assumed by MEF as a result of reliance upon such information.

    The information contained herein is intended to be used without modification by
    the recipient or user of this document. MEF is not responsible or liable for any
    modifications to this document made by any other party.

    The receipt or any use of this document or its contents does not in any way
    create, by implication or otherwise:

    (a) any express or implied license or right to or under any patent, copyright,
    trademark or trade secret rights held or claimed by any MEF member which are or
    may be associated with the ideas, techniques, concepts or expressions contained
    herein; nor

    (b) any warranty or representation that any MEF member will announce any
    product(s) and/or service(s) related thereto, or if such announcements are made,
    that such announced product(s) and/or service(s) embody any or all of the ideas,
    technologies, or concepts contained herein; nor

    (c) any form of relationship between any MEF member and the recipient or user of
    this document.

    Implementation or use of specific MEF standards, specifications, or
    recommendations will be voluntary, and no Member shall be obliged to implement
    them by virtue of participation in MEF Forum. MEF is a non-profit international
    organization to enable the development and worldwide adoption of agile, assured
    and orchestrated network services. MEF does not, expressly or otherwise, endorse
    or promote any specific products or services.


MEF
Panel
titleLSO Legato SDK Releases

LSO Legato SDK

Aretha

Release Billie (Production)

Version: billie-finalGitHub tag: aretha

Date: 22nd December 2020  16th June 2021

Release Aretha Billie Deliverables:

Theme

:

Multi-technology service provisioning

DeliverableMaturity

MEF W99 Generic API & Schema incl. following functions:

    • Service Catalog (to remove from the API?)
    • Service Ordering
    • Service Inventory
    • Service Notification
CfC#3
MEF W100 SD-WAN Developer GuideCfC#2 partially resolved
MEF W100 SD-WAN SchemaCfC#2
MEF W101 CE (EVC_OVC) Developer GuideCfC#2Working draft
MEF W101 CE (EVC_OVC) SchemaCfC#2
MEF W103 L1 Developer GuideCfC#2Working draft
MEF W103 L1 SchemaWorking draftCfC#2


LSO Legato SDK

Release Billie (Planned: May 2021)

Aretha

GitHub tag: aretha billie

Date:  May 2021 22nd December 2020


Release Billie Aretha Deliverables:

Theme: ???Multi-technology service provisioning

DeliverableMaturity

MEF

W99  (Developer Guide document)
CfC#3

W99 Generic API & Schema incl. following functions:

    • Service Catalog
(subject for removal from the scope)
    • Service Ordering
    • Service Inventory
    • Service Notification
CfC#3MEF W100 SD-WAN Developer Guide
CfC#2 partially resolved
MEF W100 SD-WAN Schema
CfC#2
Working draft
MEF W101 CE (EVC_OVC)
Developer GuideCfC#2MEF W101 CE (EVC_OVC)
Schema
CfC#2
Working draft
MEF W103 L1
Developer GuideCfC#2MEF W103 L1
Schema
CfC#2
Working draft



Panel

Source: LSO Legato Graphics




Panel
titleStatus

Status
colourGreen
titlePUBLIC


Panel
titleLSO Developer Community

LSO Legato SDK Community

LSO Developer Community Home Page


Panel
titleLSO Developer Community Manager

Michał Łączyński

Contact: community_manager@mef.net


Panel
titleLSO Legato SDK @ GitHub

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

Note

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.



Panel
titleCore Contributors

Karthik Sethuraman

Jack Pugaczewski

Min Yoon


Note

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!