--select

See also: Parameters

Description

Used for row selection by column value on list actions. The first colon (:) in the parameter value delineates the column name or number from a regex selection pattern. Each row's column value is used with the regex pattern to determined row inclusion in the final result. By default, row is included if the regex pattern is found in the column value. The options parameter can be set to one or more of the following to modify the default behavior: literal - to treat the regex string as a literal string, exact - to require an exact match of the value (not just a find!), negative - to reverse the condition so a match means exclude the row. Row selection takes place after all other action specific filtering conditions including the limit determination and so generally should not be used with the limit parameter.

Long

select

Short

Has Valuetrue
Typestring

Default Value

Multiple Use Allowed

true

Related Actions

Related How-Tos



Explainer status key:

 We haven't begun to work on this, but we plan to do so as soon as possible: PLANNED

 We're updating the content, but the information remains accurate: UPDATING

 The content is up to date as of the current version of the CLI: UPDATED