Open APIs

 View Only

  • 1.  Device management API's

    Posted Jan 14, 2020 06:18
    Hello All,

    For operations to be performed on a device (CPE) like a modem or a hub, example reset your CPE or check device speed etc, what would be the corresponding open API?

    Thank you for your help

    Warm Regards,

    ------------------------------
    Suman Bagde

    ------------------------------


  • 2.  RE: Device management API's

    TM Forum Member
    Posted Jan 15, 2020 03:28
    Edited by Vance Shipley Jan 15, 2020 03:32
    Each of these would be represented with  a base class type of Resource and so you could use TMF639 Resource Inventory Management API to locate them. 
    If you provide a characteristic for device speed you could query with TMF639 to get the value.
    Where you really need to support conceptual operations you should implement a task resource as described in TMF630 section 8: Task Resource Pattern.  Your new (sub)resource should be named as a verb so in your case simple synchronous tasks might  be something like:
    POST /resourceInventoryManagement/v4/resource/42/checkSpeed
    Accept: application/json
    Content-Length: 0
     
    HTTP/1.1 200 OK
    Content-Type: application/json
    Content-Length: 25
    {
         "deviceSpeed": "10M"
    }
    ... and:
    POST /resourceInventoryManagement/v4/resource/42/reset
    Content-Length: 0
     
    HTTP/1.1 204 No Content
    Content-Length: 0
     
    A more sophisticated implementation may respond asynchronously with a created task resource and support a monitor. This is documented in TMF630 section 8.



    Original Message


  • 3.  RE: Device management API's

    Posted Jan 16, 2020 02:49
    Thanks very much Vance.

    ------------------------------
    Suman Bagde
    Infosys
    ------------------------------

    Original Message


  • 4.  RE: Device management API's

    TM Forum Member
    Posted Mar 31, 2022 23:47
    Hi @Vance Shipley,

    ​is TMF639 still applicable for this case for managing the CPE? is the TMF664 or TMF702 should be use for managing or retrieving status for CPE?
    ​

    ------------------------------
    Chio Chuan Ooi
    SingTel Optus
    ------------------------------

    Original Message


  • 5.  RE: Device management API's

    TM Forum Member
    Posted Apr 01, 2022 00:35
    Technically, if you were to implement a CPE device producing a TMF Open API you should use an "Activation & Configuration" API, here TMF702 or TMF664. TMF639 and TMF702 are the same API, just with different resource paths, but TMF639 is meant for a different role.

    interfaces diagram


    ------------------------------
    Vance Shipley
    SigScale
    ------------------------------

    Original Message


  • 6.  RE: Device management API's

    Posted Jan 15, 2020 08:40
    Hi Suman
    Who is exposing the API? Is it the device itself or a cloud entity like an ACS that acts as a mediator?

    Best regards,
    Oru

    ------------------------------
    Ori Lior
    GlobalLogic
    ------------------------------

    Original Message


  • 7.  RE: Device management API's

    Posted Jan 16, 2020 02:47
    Hello,

    API will not be exposed by the device but a mediator

    Warm Regards,
    Suman

    ------------------------------
    Suman Bagde
    Infosys
    ------------------------------

    Original Message


  • 8.  RE: Device management API's

    Posted Apr 01, 2022 03:13
    Hi,

    Bouncing off Vance's response, in IG1228 use case 008 (IG1228 How to use ODA – Using Open APIs to realize Use Cases v8.0.0 | TM Forum), we also propose a component to expose the TMF702 API. This component is not yet formally identified by the ODA component technical team. Work for this might start in this Sprint (April/May 2022). The name ("Resource Activation & Configuration" in IG1228 versus "Resource Orchestration" like proposed by Vance) is also under debate.

    Hope this helps,

    ------------------------------
    Roland Leners
    alvatross by SATEC
    ------------------------------

    Original Message


  • 9.  RE: Device management API's

    Posted Jan 16, 2020 02:00
    Edited by Ori Lior Jan 16, 2020 02:00
    Anyway, my two cents - Assuming you mean to expose these APIs by a CPE as a replacement to TR-069, none of the TMF APIs is really suitable for this purpose, they are more suitable for B2B / M2M use cases and interaction between cloud based systems.
    I recommend to have a look at the work being done by the prpl foundation (high level APIs)

    Good luck,

    ------------------------------
    Ori Lior
    GlobalLogic
    ------------------------------

    Original Message