Guide

Namespace

New-EdgeKVNamespace

Suggest Edits

Synopsis

Create a namespace.

Syntax

New-EdgeKVNamespace [-Name] <String> [[-RetentionInSeconds] <String>] [[-GeoLocation] <String>] [-Network] <String> [-GroupID] <String> [-RestrictDataAccess] <Boolean> [[-EdgeRCFile] <String>] [[-Section] <String>] [[-AccountSwitchKey] <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

Creates a namespace on Akamai's staging or production network.

You should create namespaces first on the staging network so that you can test your EdgeWorkers code before you deploy it to production.

Parameters

‑AccountSwitchKey
String Pipeline input: False

An account credential key that lets you move between accounts when using an API client enabled for multiple accounts. To find account switch keys, use Get-AccountSwitchKey.
‑EdgeRCFile
String Pipeline input: False

Your EdgeGrid resource file to authenticate your command. Defaults to ~/.edgerc.
‑GeoLocation
String Accepted values: US, EU, JP Pipeline input: False

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.
‑GroupID
Required
String Pipeline input: False

Your EdgeKV access group's ID.
‑Name
Required
String Pipeline input: False

Your token's name. Used when retrieving tokens by name.
‑Network
Required
String Accepted values: STAGING, PRODUCTION Pipeline input: False

The type of network to execute the API request on, either STAGING or PRODUCTION.
‑RestrictDataAccess
Required
Boolean Pipeline input: False

The default dataAccessPolicy for new namespaces. If present, this allows new namespaces to access Akamai's Enhanced TLS network. If absent, this allows access on both the Enhanced TLS and the Standard TLS networks. To disable it, you need access to the EdgeKV Beta for Standard TLS.
‑RetentionInSeconds
String Pipeline input: False

A 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.
‑Section
String Pipeline input: False

The section name in your EdgeGrid resource file to retrieve authentication credentials from. Defaults to default.

Related Links

Updated about 7 hours ago