Quotas & Limits

Limits and quotas are tied to your user account and apply to all requests you make, including requests made to the Descartes Labs Platform from your Tasks.

Various limits and quotas apply to each service and operation. The most common types of limits are Rate Limits and Usage Quotas.

Rate limits are used to prevent overloading the Descartes Labs Platform with too many concurrent requests. Rate limits are specified as number of requests/unit of time.

Usage quotas keep track of how much you use the Descartes Labs platform and prevent you from accessing the platform after your quota has been reached. Each service measures usage differently, see below for details on how usage is measured and limited. Usage quotas are typically reset monthly. Contact support@descarteslabs.com for help with usage quotas.

Catalog

These limits apply to the Catalog ~descarteslabs.catalog client.

Rate limits

Band operations

  • Create a new band - 500/minute

  • Change a band - 500/minute

  • Delete a band - 500/minute

  • Get a band - 10,000/minute

  • Search bands - 5,000/minute

Image operations

  • Create a new image - 500/minute

  • Change an image - 500/minute

  • Delete an image - 500/minute

  • Get an image - 10,000/minute

  • Search images - 500/minute

  • Get image summary statistics - 60/minute

  • Upload an image file or ndarray - 10,000/minute

  • Get image upload task status - 500/minute

Product operations

  • Create a new product - 500/minute

  • Change a product - 500/minute

  • Delete a product - 500/minute

  • Get a product - 10,000/minute

  • Search products - 5,000/minute

  • Delete all related objects - 60/minute

  • Update permissions for all related objects - 60/minute

Scenes

These limits apply to the Scenes client.

Rate limits

Band operations

  • Get a band by id - 10,000/minute

  • Get all bands for a product - 5,000/minute

  • Get band fields - 500/minute

  • Get multiple bands by id - 5,000/minute

  • Search bands - 5,000/minute

Derived Band operations

  • Get derived band fields - 500/minute

  • Search derived bands - 5,000/minute

Image operations

  • Get an image by id - 10,000/minute

  • Get multiple images by id - 50,000/minute

  • Get image fields - 1,000/minute

  • Search images - 5,000/minute

Product operations

  • Get a summary of product images - 500/minute

  • List products - 500/minute

  • Search products - 5,000/minute

Raster

These limits apply both to the Raster and Scenes clients.

General limitations

When retrieving a GeoTiff or ndarray

  • Maximum number of scenes to rasterize - 500

  • Maximum image size - 5 GiB

Rate Limits

  • Rasterize a GeoTiff or ndarray - 8,000/minute

  • Get DLTile keys from shape - 10,000/minute

  • Get DLTile from a key - 10,000/minute

  • Get DLTile from LatLon - 10,000/minute

Storage

These limits apply to the Storage client.

General limitations

You can gain access to some proprietary products through storage by speaking with support@descarteslabs.com.

Rate limits

  • List objects - 10,000/minute

  • Delete an object - 50,000/minute

  • Upload an object - 50,000/minute

Tasks

These limits apply to the Tasks client.

General limitations

  • Maximum number of concurrent workers per Task group - 500

  • Maximum size of memory per worker - 96 GiB

  • Maximum number of CPU cores per worker -16

  • Maximum number of GPUs per worker - 1

  • Maximum runtime per task - 24 hours

  • Maximum size of bundled code - 10 MiB

This limitation only applies to the code you include with include_modules and does not apply to packages included with requires.

Vectors

These limits apply both to the Vectors and Vector clients.

Rate limits

Feature collection operations

  • List feature collections - 1,000/minute

  • Get a feature collection - 1,000/minute

  • Create a new feature collection - 10/minute

  • Delete a feature collection - 10/minute

  • Get the status of a delete feature collection task - 1,000/minute

  • Copy a feature collection - 10/minute

  • Get the status of a copy feature collection task - 1,000/minute

  • Export a feature collection - 10/minute

  • Get the status of an export feature collection task - 1,000/minute

  • Search features in a feature collection - 50/minute

Results from a search operation are paged, and retrieving page results are rate limited at 5,000 requests per minute. This means it’s possible to be rate-limited as you are iterating through the result of a filter operation.

  • Create new features - 2,000/minute

  • Upload new features - 1,000/minute

  • List the status of a upload feature collection tasks - 1,000/minute

Usage Quotas

If you do not have a specific quota for you or your organization, then you are limited to querying 2 TiB of data per month.