Open APIs

Expand all | Collapse all

TMF 664 ResourceFunction services.

  • 1.  TMF 664 ResourceFunction services.

    Posted May 27, 2020 08:07
    TMF 664 ResourceFunction Activation & Configuration API specification has services for Heal, Scale & Migrate. Once ResourceFunction gets created, which api specification should be used for handling other life cycle methods of created ResourceFunction like Start, Stop & Terminate ?
    Any specific REST api specification introduced for this ?

    ------------------------------
    ----------------------------
    Thanks & Regards
    Santosh
    SingTel Optus.
    ----------------------------
    ------------------------------


  • 2.  RE: TMF 664 ResourceFunction services.

    TM Forum Member
    Posted May 28, 2020 07:05
    TMF664 covers both the Activation and config of the Resource Function lifecycle and the virtualisation lifecycle.
    Full background to this API is in TR255 Suite of documents ( full list of documents at   RN361 Release Notes for TR255 Resource Function Activation and Configuration v5.0.1)

    This API was used to enable a couple of policy based management Real Virtuality catalysts  - see videos at https://www.tmforum.org/catalysts/real-virtuality-phase-ii/

    ------------------------------
    Dave Milham
    TM Forum chief architect
    ------------------------------



  • 3.  RE: TMF 664 ResourceFunction services.

    Posted May 30, 2020 00:52
    Hi Dave,
    Thanks for the reply. I have gone through the TR255 Suite and founf ResourceFunction services like Heal, Scale and Migrate. Similarly can we have Start, Stop and Terminate services as well ?


    ------------------------------
    Venkata Santosh Pavan Raju Baliyarusimhula
    SingTel Optus
    ------------------------------



  • 4.  RE: TMF 664 ResourceFunction services.

    TM Forum Member
    Posted Jun 01, 2020 01:57
    Linking in @Vance Shipley - as lead for the resource​ function API I'm sure he'll be able to add some constructive input to this thread.

    ------------------------------
    Jonathan Goldberg
    Amdocs Management Limited
    Any opinions and statements made by me on this forum are purely personal, and do not necessarily reflect the position of the TM Forum or my employer.
    ------------------------------



  • 5.  RE: TMF 664 ResourceFunction services.

    TM Forum Member
    Posted Jun 01, 2020 08:28
    The TMF664 API is used for activation and configuration of resources having a type of ResourceFunction. You have the Heal, Migrate, Scale operations which are specific to ResourceFunctions. All Resources have the lifecycle attributes administrationState and operationalState.

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



  • 6.  RE: TMF 664 ResourceFunction services.

    TM Forum Member
    Posted Jun 03, 2020 22:29
    Dear Shipley,​

    We are trying to use TMF664 to do infrastructure resource activation, basically, start/stop/terminate/scale/heal virtual machines.  I have following questions

    1.  From my understanding, when I issue a start command to a  VM, its operation state should change to "Active". But it is categorized under usageStateType. I was thinking if it should come under the operational state?

    ResourceUsageStateType { "idle", "active", "busy" }
    ResourceAdminstrativeStateType { "locked", "unlocked" , "shutdown"}
    ResourceOperationStateType { "enable", "disable" }
    ResourceStatusType {"standby", "alarm", "available", "reserved", "unknown", "suspend"}

    2. Is it correct to extend the heal/migrate/scale to include start/stop/terminate commands to the resource?

    Thank you very much for your valuable input.

    Regards,
    Nahfees

    ------------------------------
    Mohamed Nahfees
    SingTel Optus
    ------------------------------



  • 7.  RE: TMF 664 ResourceFunction services.

    TM Forum Member
    Posted Jun 04, 2020 06:32
    Nahfees,

    You are indeed using TMF664 for what it is intended.

    1)  In the SID a LogicalResource has the boolean attribute isOperational which is "used to define the operational status of the object" which matches the API's operationalState attribute. The resourceStatus API attribute lines up with LogicalResource attribute lrStatus where it has similar but somewhat different values (I think we should reevaluate that enumeration). In any event you have a number of dimensions to a resource's state which should all be take together.  I suggest reading TR255 and GB922 Resources.

    2) You could polymorphically extend TMF664 however I'm not sure your use case requires it. I would start by using the attributes you've identified to drive the state changes.


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