Open APIs

 View Only
  • 1.  TMF685

    TM Forum Member
    Posted Sep 04, 2020 07:50
      |   view attached
    ​​The swagger and Resource model are not in sync for TMF685.

    ResourceCapacityDemand is defined inside the AppliedCapacityAmount, which is not as per the Resource Model defined in TMF685.

    Thanks,
    Raj​​​​

    ------------------------------
    Rajasekhar Kellampalli
    Tata Consultancy Services
    ------------------------------


  • 2.  RE: TMF685

    TM Forum Member
    Posted Sep 06, 2020 03:37
    Hi Raj
    Perhaps you are aware that we are in the middle of a major republishing process, bringing all the APIs up to v4.x, including alignment with recently republished design guidelines TMF630.
    As part of this, we are now generating swagger and user guides (new name for api specification) from a unified schema, meaning that going forward there should be no discrepancy.
    Resource Pool is being done by @Kiyotaka Mizuno - perhaps he can address your concern and help you understand when the new assets might be available.
    Hope it helps.​

    ------------------------------
    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.
    ------------------------------



  • 3.  RE: TMF685

    TM Forum Member
    Posted Sep 07, 2020 03:54
    > Dear Rajasekhar
    Thank you very much for your comment.
    As Jonathan said,  I am updating TMF685 now. In next revision, I will fix swagger and resource model based on your comment.

    > Dear Jonathan
    Thank you very much for your help!

    ------------------------------
    Kiyotaka Mizuno
    NTT Group
    ------------------------------



  • 4.  RE: TMF685

    Posted Sep 18, 2020 09:32
    Good day @Kiyotaka Mizuno

    My apologies for adding to this thread but I also picked up a few differences between TMF685 and the auto generated documenation.

    As an example in /Reservation
    we have resourceReservationItem and in the auto generated swagger documentation it is reservationItem.

    Which one should we use? Does the auto generated API superceed the ​documentation?

    ------------------------------
    Liyaqat Mugjenkar
    Altron TMT
    ------------------------------



  • 5.  RE: TMF685

    TM Forum Member
    Posted Sep 24, 2020 10:56
    @Liyaqat Mugjenkar
    Thank you very much for your comments.
    As I wrote in other thread, currently, we are considering simplification of TMF685, then the data model will be changed.
    (However, I think reservationItem is more appropriate than resourceReservationItem.)
    Current revision of TMF685 is not generated using automate tool, therefore, there are many differences between specification document and swagger.
    ​​

    ------------------------------
    Kiyotaka Mizuno
    NTT Group
    ------------------------------



  • 6.  RE: TMF685

    TM Forum Member
    Posted Dec 01, 2021 10:02
    Hi @Kiyotaka Mizuno,
    Hope you are doing well.

    Sorry for reopening this thread however based on above comments, wanted to check by when do you plan to have updated documentation of TMF685 posted on official portal. Current version as I see is this one:
    https://www.tmforum.org/resources/specification/tmf685-resource-pool-management-api-rest-specification-r18-0-0/

    Saumitra
    ​​

    ------------------------------
    Saumitra Paliwal
    Netcracker Technology
    ------------------------------