Skip to main content
Skip table of contents

Create a quota profile

Request

You can set up any number of quota profiles to which user accounts can be associated.

To create a quota profile, send a POST request to:

CODE
https://<host>:<port>/cdvr/v1/operator/quotaprofile

Headers

  • Content-Type: application/json

Mandatory arguments

  • name – the name of the quota profile to be created
  • quota – the size of the quota in seconds
  • status  ENABLED or DISABLED

Other arguments

  • retentionPeriod – the retention period applied to the recordings made by accounts to which the profile applies. This is in ISO8601 format (for example, P60D for 60 days). autoDelete must be true for this to have any effect.
  • autoDelete – enables/disables automatic deletion (true or false)
  • autoDeleteOptions – options for automatic deletion (autoDelete must be true for these to have any effect):
    • isBasedOnAge – enables/disables automatic deletion based on recording age (true or false)
    • isBasedOnNumberOfEpisodes – enables/disables automatic deletion of the oldest episodes in series (true or false)

Example

A POST request with this payload creates a quota profile called LARGE with a size of 100 hours and enables it:

CODE
{
  "name": "LARGE",
  "quota": "360000",
  "status": "ENABLED"
}

Response

A successful request returns an HTTP 201 status.
A bad request returns an HTTP 400 status.

See also

For full details of this API, see the User Recordings API documentation.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.