Create a namespace

post

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

Creates a namespace on Akamai's STAGING or PRODUCTION network. You should create namespaces in both networks so that you can test your EdgeWorkers code on staging.

Path Params

network

string

enum

required

Enum Network environment to execute the API request on.

Allowed:

Query Params

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

Represents an EdgeKV namespace.

dataAccessPolicy

object

Overrides the default data access policy. If not specified, all new namespaces use the current dataAccessPolicy. The default data access policy is defined when first initializing EdgeKV. You can change the settings for new namespaces by running the Modify the default data access policy operation after initialization. You can't change the data access policy after you create a namespace.

geoLocation

string

enum

Defaults to US

Write-once Specifies the storage location for data when creating a namespace on the production network. This can help optimize performance by storing data where most of your users are located. Once you set this value, you can't modify it. The value defaults to US on the STAGING and PRODUCTION networks. The available locations on the PRODUCTION network also include EU (Europe), JP (Japan), and GLOBAL. The GLOBAL location automatically replicates data to US, EU, and JP storage locations. If you use the GLOBAL location, reads are faster but write operations are slightly slower.

Allowed:

groupId

integer

required

≥ 0

The Akamai access group the namespace is assigned to. A value of 0 makes the namespace available to all Akamai access groups on the account with EdgeKV capabilities.

namespace

string

required

A name for a namespace.

retentionInSeconds

enum

required

Retention period of underlying data, represented in seconds. Accepts values between 86400 for one day and 315360000 for 10 years. You can also enter a value of 0 to retain data indefinitely.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200Successful response.

400Bad request. Invalid namespace name or missing attribute.

409Conflict. Namespace name already exists.

500Internal server error.