Thanks Dhaval for clarifying
The Bucket entity, like all top-level (managed) entities in the Open API, has an ID (Bucket.id), which is unique across the entire population of Buckets (no matter which customer owns the bucket, or which usage type the bucket serves).
So whenever you retrieve a bucket (doesn't matter if retrieve by ID or search by owning customer, or whatever), the id in the returned resource will be the unique ID of the bucket. In the published user guide, you can see examples of (admittedly not very realistics) IDs, 11 and 12 in the GET response.
There is no concept of subscription in Open API (or in SID - information framework), the equivalent is Product. A bucket can cover multiple products (Bucket.product is an array of ProductRef), and when you retrieve a bucket you would expect to see the IDs of all the products populated in those ProductRefs.
Hope it helps
P.S. I can see that there is discrepancy between the example contents and the query string in the user guide, I plan to open a defect report on that.
------------------------------
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.
------------------------------
Original Message:
Sent: Nov 01, 2021 09:52
From: Dhaval Solanki
Subject: PrepayBalanceManagement Bucket API query
@Jonathan Goldberg Thanks for you reply.
So as per your comment I am updating the question
In PrepayBalanceManagement TMF654 my query is
Suppose I have a product offer plan with three bucket
1) Facebook 2gb
2) Youtube 5gb
3) default 10gb
Now if I am onboarding a customer and customer subscribes above plan then, he will have 3 buckets one for facebook, one for youtube, and last will be default.
So in PrepayBalanceManagement when we implement GET without ID - which searches for the entity using filter criteria, in response for bucketId will, we have to give subscriptionId or particular primary key id of facebook or youtube bucket.
------------------------------
Dhaval Solanki
Sterlite Technologies Limited
Original Message:
Sent: Oct 31, 2021 03:11
From: Jonathan Goldberg
Subject: PrepayBalanceManagement Bucket API query
Hi Dhaval
Not sure what exactly you are asking. In general, TMF Open APIs provide two variations on GET:
- GET with ID - retrieve the entity by its primary key (the ID field of the entity)
- GET without ID - searches for the entity using filter criteria
Can you match your use case into one of the above alternatives?
------------------------------
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.
Original Message:
Sent: Oct 29, 2021 01:54
From: Dhaval Solanki
Subject: PrepayBalanceManagement Bucket API query
Hello,
We want to implement bucket api, so we have a query that suppose If my product had subscription of three buckets facebook, whatsapp and voice then on getBucket API we want to return list of three bucket, for one subscription of my product offer or just one record of subscription. So bucket id will be subcriptionId or balanceId.
------------------------------
Dhaval Solanki
Sterlite Technologies Limited
------------------------------