Category

New-APICategory

Synopsis

Create a category

Syntax

New-APICategory [-APICategoryName] <String> [[-APICategoryDescription] <String>] [[-EdgeRCFile] <String>] [[-Section] <String>] [[-AccountSwitchKey] <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

Creates a category that you can use to tag endpoints. The request's -APICategoryName needs to be unique per account.

Parameters

‑APICategoryDescription

The description of the category that you may use to tag related endpoints. If you specify null or an empty string in the request, the JSON response doesn't include this field.

‑APICategoryName
Required

A unique-per-account name of the category. Any empty value reflects back as an UNCATEGORIZED keyword.

‑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.

‑Section

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

Related Links