Read an item

get

https://{hostname}/edgekv/v1/networks/{network}/namespaces/{namespaceId}/groups/{groupId}/items/{itemId}

Read an EdgeKV item. You need to specify the namespace and group the item belongs to. It can take ten seconds or longer to read an item that has been recently written to EdgeKV. The API may return a 404 error during that period. This is normal behavior for EdgeKV, which is an eventually consistent database.

Path Params

itemId

string

required

Unique identifier for each item. The key of a key-value pair.

groupId

string

required

Unique identifier for each group within a namespace.

namespaceId

string

required

Unique identifier for each namespace.

network

string

enum

required

Enum Network environment to execute the API request on.

Allowed:

Query Params

sandboxId

string

Accesses EdgeKV data in the specified sandbox environment. To list existing sandbox identifiers, run the Sandbox API's List sandboxes operation.

accountSwitchKey

string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Headers

string

enum

Defaults to application/problem+json

Generated from available response content types

Allowed:

Responses

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

text/plain

application/problem+json

200Returns the value for the item ID (key).

400Bad request. Invalid namespace, group or item specified.

404Not found. Namespace, group, or item doesn't exist.

429Too many requests.

500Internal server error.