Quotas & Limits¶
Limits and quotas are tied to your user account and apply to all requests you make.
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
.
Compute 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, and similarly with
rastering requests. If too many complex requests are sent to our platform within a designated
time frame by a single user, the service will return a RateLimitExceeded
error. The values
of these limits are expressed as number of seconds of compute time/unit of time
and
represent aggregated usage across all queries in the 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
client.
Rate limits¶
Band operations
- Create a new band - 1000/minute
- Change a band - 1000/minute
- Delete a band - 1000/minute
- Get a band - 20,000/minute
- Search bands - 40,000/minute
Image operations
- Create a new image - 20,000/minute
- Change an image - 20,000/minute
- Delete an image - 1000/minute
- Get an image - 20,000/minute
- Search images - 10,000/minute (note: these requests are also limited by query time)
- Get image summary statistics - 120/minute (note: these requests are also limited by query time)
- Upload an image file or
ndarray
- 20,000/minute - Get image upload task status - 1000/minute
Product operations
- Create a new product - 1000/minute
- Change a product - 1000/minute
- Delete a product - 1000/minute
- Get a product - 20,000/minute
- Search products - 10,000/minute
- Delete all related objects - 120/minute
- Update permissions for all related objects - 120/minute
- Retrieve the status for the above operations - 1000/minute
Compute¶
These limits apply to the Compute
client.
General limitations¶
When creating or calling a Function
- Maximum concurrency for
Function
invocations - 1000 - Maximum function return payload - 1MB
CPU & Memory Configurations
CPU value | Memory |
---|---|
0.25 | 0.5GB, 1GB, 2GB |
0.5 | 1GB, 2GB, 3GB, 4GB |
1 | 1GB, 2GB, 3GB, 4GB, 5GB, 6GB, 7GB, 8GB |
2 | Between 4GB and 16GB in 1GB increments |
4 | Between 8GB and 30GB in 1GB increments |
8 | Between 16GB and 60GB in 4GB increments |
16 | Between 32GB and 120GB in 8GB increments |
Scenes¶
These limits apply to the Scenes
client.
General limitations¶
When retrieving a GeoTiff or ndarray
- Maximum number of scenes to rasterize - 128
- Maximum image size - 5 GiB
Rate limits¶
Band operations
- Get a band by id - 20,000/minute
- Search bands - 40,000/minute
Scene operations
- Get an scene by id - 20,000/minute
- Search scenes - 10,000/minute, 3000 secs/minute cumulative, 15000 secs/5 minutes cumulative
- Rasterize a GeoTiff or
ndarray
- 2000 secs/sec cumulative
Product operations
- Get a product by id - 20,000/minute
- Search products - 10,000/minute