get https://{serverid}.nexusrun.com/databases/{databaseid}/buckets//keys//info
This API endpoint is used to retrieve information about a specific key in the NexusRunDB database, including details such as the size of the key.
- The Master access key or any access keys with "read_key", "read_write_key", or "list_all_keys" permissions (or tokens generated for these access keys) have the ability to retrieve information about a specific key by its key ID in the NexusRunDB database.
- The JSON response from this API endpoint includes the actual size of the key's value, as well as the size on disk. This provides information about the size of the key's data and the space it occupies in the storage system.
- The "size" mentioned in the JSON response represents the number of bytes occupied by the value of the key.
- The "size on disk" mentioned in the JSON response refers to the file block size occupied by the key's value on the disk for persistence. In this example, it indicates that every key takes at least 4KB of space on the disk, regardless of the actual size of the key's value.