Item

New-EdgeKVItem

Synopsis

Write an EdgeKV item.

Syntax

New-EdgeKVItem [-Network] <String> [-NamespaceID] <String> [-GroupID] <String> [-ItemID] <String> [-Value] <Object> [[-EdgeRCFile] <String>] [[-Section] <String>] [[-AccountSwitchKey] <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

Creates or updates an EdgeKV item (name-value) on a given network. You need to specify the namespace and group to which the item belongs. The target namespace ID needs to already exist before writing. Whereas, the group ID is automatically created for you if it doesn't exist yet.

Note: If you don't specify the group ID, a value of 0 is used, which makes the item available to all groups.

Parameters

‑AccountSwitchKey

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

Your EdgeGrid resource file to authenticate your command. Defaults to ~/.edgerc.

‑GroupID
Required

Your EdgeKV access group's ID.

‑ItemID
Required

An item's ID. The key of a key-value pair.

‑NamespaceID
Required

A namespace's ID.

‑Network
Required

The type of network to execute the API request on, either STAGING or PRODUCTION.

‑Section

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

‑Value
Required

A value to assign to the new or updated item, can be a string or a PSCustomObject which will be converted to JSON. Supports pipelining.

Related Links