Client list

Get-ClientList

Synopsis

Get a specific client list.

Syntax

Get-ClientList [[-Name] <String>] [-IncludeItems] [-IncludeNetworkList] [-IncludeDeprecated] [-Search <String>] [-Page <Int32>] [-PageSize <Int32>] [-Sort <String>] [-Type <String>] [-IncludeMetadata] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
Get-ClientList -ListID <String> [-IncludeItems] [-IncludeNetworkList] [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

Gets all client lists or retrieves a specific list by its ID. With retrieving a list, you can page the results with the -Page and -PageSize parameters as well as sort and filter them.

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.

‑IncludeDeprecated

Includes deprecated client lists in the response.

‑IncludeItems

Includes client list entries in the response.

‑IncludeMetadata

Include request metadata in the response. Without this, only the response content object will be returned.

‑IncludeNetworkList

Includes network lists in the response.

‑ListID
Conditionally required

Your client list's ID.

‑Name

Your client list's name.

‑Page

The request page number for a paginated output, starting from the default 0.

‑PageSize

Number of entries in paginated output. The default page size is 10.

‑Search

Returns results that match the specified substring in any client list's details or entry details.

‑Section

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

‑Sort

Sorts your collection of client lists by property and order (ASC, DESC). Case-insensitive, repeatable parameter.

‑Type

Filters the output to lists of specified types: IP, GEO, ASN, TLS, or FILEHASH. Repeat the parameter to filter on more than one type.

Related Links