Product limits
Familiarize yourself with these limitations before you start building your EdgeKV data model.
EdgeKV is only supported in EdgeWorker IDs created using the Dynamic Compute resource tier. Refer to the resource tiers section in the EdgeWorkers User Guide for more information.
Description | Limit |
---|---|
Number of namespaces per account on each network | 20 on the staging network Note: The "default" namespace, created automatically on each network, counts towards this limit. |
Namespace retention | Data within the "default" namespace is stored for 6 months after it was written or last updated. You cannot modify the retention period for the "default" namespace. For all other namespaces that you create, you must specify a retention period upon creation. You can also update the retention period for any existing namespace other than the "default" namespace. For more information refer to Update namespace details in the EdgeKV API documentation. You should only use the default namespace for experimentation and testing purposes. When deploying your EdgeKV database in production, please use a new namespace with a different name. |
Namespace retention for data written to a Sandbox environment | Data written to a sandbox environment has a 2 day retention period regardless of the retention period of the namespace in which the data exists. |
Data storage per account | 20 TB (recommended limit) Note: 1 TB = 1,000,000,000,000 Bytes |
Namespace name limitations | 1 to 32 characters in length. |
Items per account/namespace | 200,000,000 per customer account Note: If these limits are exceeded writes will continue to succeed until the database reaches the data storage limit. Exceeding these limits may, however, have a significant impact the read performance of all data within your database. |
Items per group | There is no limit to the number of items you can add to a group. There is, as specified above, a limit to the number of items you can create per account/namespace. |
Group name limitations | 1 to 128 characters in length. |
Key name limitations | 1 to 512 characters in length. |
Value size | 999,999 Bytes |
Number of item reads per second from EdgeWorkers | The maximum number of reads per second is defined by the EdgeWorkers HTTP sub-request limitations. EdgeKV has further limits that apply globally:
|
Number of group reads per second | A group read returns N items up to the items per group limit below. Each of these are counted as a separate request towards the item read limit above. |
Number of items returned per group read request | 100 by default. You can use the If the number of items returned exceeds the default value of 100 or the number specified using the |
Number of item writes/deletes per second from EdgeWorkers | The number of item writes/deletes supported from all EdgeWorkers is:
These limits exist to help distribute resources across customers. Note: Exceeding more than an aggregate of 40 write/delete operations per second for distinct items negatively impacts read performance and throughput. |
Number of Administrative API operations per second | The limits above apply to Administrative API operations but are further restricted as follows:
Note: Exceeding these limits will cause subsequent requests to be blocked. The block lasts 10 minutes after the limit is no longer exceeded. The API response will have a 403 http status code in this case. |
Number of tokens per account | 50 If you generate more than one token per namespace, you will have redundant tokens that reduce your remaining available tokens. Refer to the Generate and retrieve EdgeKV access tokens section for more information. Expired tokens may count towards the limit for one month after expiry. Please contact us if you encounter this problem. You can list expired tokens using the EdgeKV CLI. |
Token name limitations | 1 to 32 characters in length. |
Maximum number of namespace permissions per token | 20 |
Maximum number of EdgeWorker IDs per token | 8 |
Maximum number of token Administrative API operations per second | Maximum of 1 per second or 10 per minute. |
Updated about 1 month ago