TAG LINE
SMALL TITLE

Account / SharePlan / Bucket Usage / By Service

(API Version v3)


This object provides a view into which services are actively participating in a Share Plan assigned to an Account.


What can you do with ViewSharePlanBucketUsageByService?


Properties

Property Details
accountSharePlanId
"accountSharePlanId": 27
Type: Number
accountServiceUsageBucketId
READ-ONLY
"accountServiceUsageBucketId": 8
Type: Number
The Identity or ID of the bucket that is part of this Account Share Plan.
accountServiceUsageBucketTotalUsageAmount
READ-ONLY
"accountServiceUsageBucketTotalUsageAmount": 1
Type: Number
The total usage amount for the bucket as part of this Account Share Plan.
accountServiceUsageBucketTotalUsageConsumed
READ-ONLY
"accountServiceUsageBucketTotalUsageConsumed": 22
Type: Number
The total usage amount consumed from this bucket as part of this Account Share Plan.
accountServiceUsageBucketIsAddOn
READ-ONLY
"accountServiceUsageBucketIsAddOn": true
Type: Boolean
If this bucket is an add-on.
packageId
READ-ONLY
"packageId": 22
Type: Number
The Identity or ID of the package that is part of this Account Share Plan.
packageName
READ-ONLY
"packageName": "Hello World"
Type: String
The name of the package that is part of this Account Share Plan.
serviceId
READ-ONLY
"serviceId": 8
Type: Number
The Identity or ID of the service that is part of this Account Share Plan.
serviceName
READ-ONLY
"serviceName": "Hello World"
Type: String
The name of the service that is part of this Account Share Plan.
quantity
READ-ONLY
"quantity": 7
Type: Number
The number of services defined by serviceId that are part of this Account Share Plan.
usageConsumed
READ-ONLY
"usageConsumed": 26
Type: Number
How much usage have all the included packages/services consumed.
accountServiceUsageBucketRecurFrequency
"accountServiceUsageBucketRecurFrequency": 22
Type: Number
accountServiceUsageBucketRecurFrequencyTypeId
"accountServiceUsageBucketRecurFrequencyTypeId": 7
Type: Number
accountServiceUsageBucketRecurFrequencyTypeName
"accountServiceUsageBucketRecurFrequencyTypeName": "Hello World"
Type: String
accountServiceUsageBucketIsThresholdPerAccountService
"accountServiceUsageBucketIsThresholdPerAccountService": true
Type: Boolean
accountServiceUsageBucketIsInfiniteLastTier
"accountServiceUsageBucketIsInfiniteLastTier": true
Type: Boolean
usageBucketName
READ-ONLY
"usageBucketName": "Hello World"
Type: String
The name of the bucket participating in the Share Plan.
usageBucketBaseUnitId
READ-ONLY
"usageBucketBaseUnitId": 6
Type: Number
The identifier that represents the BucketBaseUnit. For example time, data, or count.


End Points

GETapi/v3/Account/SharePlan/BucketUsage/ByService/
Retrieve all of the ViewSharePlanBucketUsageByService objects.
Retrieve all of the ViewSharePlanBucketUsageByService objects.
GET api/v3/Account/SharePlan/BucketUsage/ByService/
View Sample Response
HTTP/1.1 200 OK
{
    "trackingId": "d2ae5304-2355-44eb-a328-272f02935f8b",
    "totalCount": 1,
    "items": [
        {
            "accountSharePlanId": 23,
            "accountServiceUsageBucketId": 27,
            "accountServiceUsageBucketTotalUsageAmount": 4,
            "accountServiceUsageBucketTotalUsageConsumed": 25,
            "accountServiceUsageBucketIsAddOn": true,
            "packageId": 1,
            "packageName": "Sample Text Data",
            "serviceId": 10,
            "serviceName": "Sample Text Data",
            "quantity": 8,
            "usageConsumed": 2,
            "accountServiceUsageBucketRecurFrequency": 1,
            "accountServiceUsageBucketRecurFrequencyTypeId": 14,
            "accountServiceUsageBucketRecurFrequencyTypeName": "Sample Text Data",
            "accountServiceUsageBucketIsThresholdPerAccountService": true,
            "accountServiceUsageBucketIsInfiniteLastTier": true,
            "usageBucketName": "Sample Text Data",
            "usageBucketBaseUnitId": 0
        }
    ]
}
GETapi/v3/Account/SharePlan/BucketUsage/ByService/Paged
Retrieve all of the ViewSharePlanBucketUsageByService objects in a paged fashion. This endpoint implements pagination for its results. Individual pages can be requested to return a particular paged set in the list of results. To learn more, see details on working with paginated endpoints.
Retrieve all of the ViewSharePlanBucketUsageByService objects in a paged fashion.
GET api/v3/Account/SharePlan/BucketUsage/ByService/Paged
View Sample Response
HTTP/1.1 200 OK
{
    "trackingId": "d2ae5304-2355-44eb-a328-272f02935f8b",
    "pagination": {
        "pageNumber": 1,
        "pageSize": 20,
        "excludeTotalCount": false
    },
    "pagedResults": {
        "totalCount": 1,
        "items": [
            {
                "accountSharePlanId": 6,
                "accountServiceUsageBucketId": 26,
                "accountServiceUsageBucketTotalUsageAmount": 14,
                "accountServiceUsageBucketTotalUsageConsumed": 6,
                "accountServiceUsageBucketIsAddOn": true,
                "packageId": 6,
                "packageName": "Sample Text Data",
                "serviceId": 23,
                "serviceName": "Sample Text Data",
                "quantity": 26,
                "usageConsumed": 10,
                "accountServiceUsageBucketRecurFrequency": 14,
                "accountServiceUsageBucketRecurFrequencyTypeId": 8,
                "accountServiceUsageBucketRecurFrequencyTypeName": "Sample Text Data",
                "accountServiceUsageBucketIsThresholdPerAccountService": true,
                "accountServiceUsageBucketIsInfiniteLastTier": true,
                "usageBucketName": "Sample Text Data",
                "usageBucketBaseUnitId": 24
            }
        ]
    }
}