TAG LINE
TAG LINE
SMALL TITLE

Account / SharePlan / Bucket Usage / By Service

(API Version v8)


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": 23
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": 27
Type: Number
The total usage amount for the bucket as part of this Account Share Plan.
accountServiceUsageBucketTotalUsageConsumed
READ-ONLY
"accountServiceUsageBucketTotalUsageConsumed": 19
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": 0
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": 3
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": 19
Type: Number
The number of services defined by serviceId that are part of this Account Share Plan.
usageConsumed
READ-ONLY
"usageConsumed": "Hello World"
Type: String
How much usage have all the included packages/services consumed.
accountServiceUsageBucketRecurFrequency
"accountServiceUsageBucketRecurFrequency": 13
Type: Number
The frequency of the usage bucket, e.g. 6.
accountServiceUsageBucketRecurFrequencyTypeId
"accountServiceUsageBucketRecurFrequencyTypeId": 6
Type: Number
The frequency type ID of the usage bucket.
accountServiceUsageBucketRecurFrequencyTypeName
"accountServiceUsageBucketRecurFrequencyTypeName": "Hello World"
Type: String
The frequency type name of the usage bucket, e.g. Month.
accountServiceUsageBucketIsThresholdPerAccountService
"accountServiceUsageBucketIsThresholdPerAccountService": true
Type: Boolean
Whether or not the bucket threshold is per account service.
accountServiceUsageBucketIsInfiniteLastTier
"accountServiceUsageBucketIsInfiniteLastTier": true
Type: Boolean
Whether or not the bucket has an infinite final tier.
usageBucketId
"usageBucketId": 17
Type: Number
The ID of the Bucket.
usageBucketName
READ-ONLY
"usageBucketName": "Hello World"
Type: String
The name of the bucket participating in the Share Plan.
usageBucketBaseUnitId
READ-ONLY
"usageBucketBaseUnitId": 4
Type: Number
The identifier that represents the BucketBaseUnit. For example time, data, or count.


End Points

GETAccount/SharePlan/BucketUsage/ByService/
Retrieve all of the ViewSharePlanBucketUsageByService objects.
Retrieve all of the ViewSharePlanBucketUsageByService objects.
GET Account/SharePlan/BucketUsage/ByService/
View Sample Response
HTTP/1.1 200 OK
{
    "trackingId": "d2ae5304-2355-44eb-a328-272f02935f8b",
    "totalCount": 1,
    "items": [
        {
            "accountSharePlanId": 3,
            "accountServiceUsageBucketId": 24,
            "accountServiceUsageBucketTotalUsageAmount": 26,
            "accountServiceUsageBucketTotalUsageConsumed": 18,
            "accountServiceUsageBucketIsAddOn": true,
            "packageId": 9,
            "packageName": "Sample Text Data",
            "serviceId": 10,
            "serviceName": "Sample Text Data",
            "quantity": 4,
            "usageConsumed": "Sample Text Data",
            "accountServiceUsageBucketRecurFrequency": 4,
            "accountServiceUsageBucketRecurFrequencyTypeId": 27,
            "accountServiceUsageBucketRecurFrequencyTypeName": "Sample Text Data",
            "accountServiceUsageBucketIsThresholdPerAccountService": true,
            "accountServiceUsageBucketIsInfiniteLastTier": true,
            "usageBucketId": 12,
            "usageBucketName": "Sample Text Data",
            "usageBucketBaseUnitId": 12
        }
    ]
}
GETAccount/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 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": 25,
                "accountServiceUsageBucketId": 14,
                "accountServiceUsageBucketTotalUsageAmount": 21,
                "accountServiceUsageBucketTotalUsageConsumed": 17,
                "accountServiceUsageBucketIsAddOn": true,
                "packageId": 22,
                "packageName": "Sample Text Data",
                "serviceId": 6,
                "serviceName": "Sample Text Data",
                "quantity": 27,
                "usageConsumed": "Sample Text Data",
                "accountServiceUsageBucketRecurFrequency": 4,
                "accountServiceUsageBucketRecurFrequencyTypeId": 16,
                "accountServiceUsageBucketRecurFrequencyTypeName": "Sample Text Data",
                "accountServiceUsageBucketIsThresholdPerAccountService": true,
                "accountServiceUsageBucketIsInfiniteLastTier": true,
                "usageBucketId": 22,
                "usageBucketName": "Sample Text Data",
                "usageBucketBaseUnitId": 21
            }
        ]
    }
}