Change quota
Added by IBM contributorRajmeet S Bal | Edited by Claudia R Elbourn on June 8, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

This operation is to assign or allocate extra storage for a pooled storage subscription.

Table 1. API details

Method Resource address Operation header
POST resource/subscription/<subscription_id>/seat/<seat_id> changeQuota

This operation allocates specified amount of storage in the seat. EntitlementQuantityAllocated to the specified subscription and updates seat and subscription entities in BSS. It sends change subscriber profile event to the services.

 

URL parameters


Provide the following parameter.

Table 2. URL parameters

Parameter
Required
Description
subscription_id
Yes
The ID of the subscription for which quota is to be changed.
seat_id
Yes The ID of the seat for which quota is to be changed.



Input attributes


The input attribute must be a well formatted JSON object.Retrieve most recent payload for the seat using getSeat API.Then modify the payload received and submit as input to changeQuota API

Example payload:

{
"Seat": {
"SubscriberId": 20000021,
"TermsOfUseId": 4,
"SeatServiceProductAttributeSet": [],
"ProvisioningWorkflowId": 0,
"Created": "02/19/2010 09:55:36",
"Modified": "02/19/2010 09:55:37",
"Oid": 121,
"HasAcceptedTermsOfUse": false,
"SeatState": "ASSIGNED",
"EntitlementQuantityAllocated": 0,
"Owner": 20000034,
"WorkflowIdList": [],
"Version": 6,
"SubscriptionId": 8,
"OptimisticLock": 0,
"Deleted": false,
"Id": 121
}
}

 

Response Codes:

Code

Possible Messages

Reason for Error Message(If Error)

DATA_NOT_FOUND (404)

Seat not found.

Incorrect seat id

 

Subscription not found

Subscription with specified id has been removed

     

INPUT_FORMAT_ERROR (400)

SubscriptionId in the URI must be same as the subscriptionId in Seat JSON

SubscriptionId in the Seat object should be same the subscriptionId in the URI.

 

ChangeQuota can be called only for Pooled Subscriptions

Subscription should belong to a pooled offering.

  Seat does not belong to the specified Subscription Incorrect seat id.
  Cannot update the Subscriber Id for a Seat.

Cannot change subscriber id in the Seat object being passed as HTTP request body.

  Minimum value for EntitlementQuantityAllocated can be 0.

EntitlementQuantityAllocated of seat cannot be less than zero.

  Required amount of storage is not available on the Subscription. Required amount of storage is not available.
  Enter a value for Seat Id Missing required parameter SeatId
  Seat Id should be a valid integer Integer greater than 0 is valid
  value Enter a valaue for subscription Id. Missing required parameter subscription Id
  Subscription Id should be a valid Integer Integer greater than 0 is valid


For a list of common HTTP status codes that are returned for API calls, see HTTP status codes.

Parent topic: Subscription management services