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
.
Query time limits are used to prevent overloading the Descartes Labs Platform with too many
computationally intensive requests. The amount of computation resources required to return the
results of a search request vary greatly based on the search parameters. If too many complex queries
are sent to our platform within a designated time frame by a single user, the service will return a
RateLimitExceeded
error. Image search and summary queries from the Catalog service
are limited by total query time with one minute and five minute windows.
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
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 - 20,000/minute
Image operations
- Create a new image - 10,000/minute
- Change an image - 10,000/minute
- Delete an image - 500/minute
- Get an image - 10,000/minute
- Search images - 5,000/minute (note: these requests are also limited by query time)
- Get image summary statistics - 60/minute (note: these requests are also limited by query time)
- 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
- Retrieve the status for the above operations - 500/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
- 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 withinclude_modules
and does not apply to packages included withrequires
.
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 afilter
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