Upload namespace data

post

https://{hostname}/edgekv/v1/networks/{network}/namespaces/{namespaceId}/upload

Upload CSV-formatted data into a namespace. The CSV syntax generally follows RFC 4180, but allows empty lines, which are ignored. Each line needs at least three comma-delimited fields: the groupId, itemId, and item content for the namespace. An optional fourth field defines the number of seconds the item is retained. If this field is absent, the namespace's retentionInSeconds applies.

Path Params

namespaceId

string

required

Unique identifier for each namespace.

network

string

enum

required

Enum Network environment to execute the API request on.

Allowed:

Query Params

dryRun

boolean

Defaults to false

When true, it simulates a namespace data upload request. The response data shows what the results will look like after the upload, but without committing any changes to the database.

maxItems

int64

1 to 5000000

Maximum number of CSV records to upload, if specified.

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.

Body Params

Headers

Content-Encoding

string

enum

Enum The content encoding of the CSV file being uploaded, currently limited to gzip.

Allowed:

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

URL

Response

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

application/json

application/problem+json

202Returns information on the status of the upload request.

400Bad request. Namespace doesn't exist.

401Not authorized.

403Forbidden. Forbidden.

405Method not allowed.

415Unsupported media type.

500Internal server error.