Boundary
host-catalogs list
Command: boundary host-catalogs list
The boundary host-catalogs list
command lets you list the Boundary host catalogs within a given scope or resource.
Example
This example lists all host catalogs in the scope _1234567890
.
The recursive
option means Boundary runs the operation recursively on any child scopes, if applicable:
$ boundary host-catalogs list -scope-id _1234567890 -recursive
Usage
$ boundary host-catalogs list [options] [args]
Command options
-filter=<string>
- If set, Boundary filters the list operation before the results are returned. The filter operates against each item in the list. We recommend that you use single quotes, because the filters contain double quotes. Refer to the Filter resource listings documentation for more details.-recursive
- If set, runs the list operation recursively on any child scopes, if the type supports it.-scope-id=<string>
- The scope from which you want to list host catalogs. The default scope isglobal
. You can also specify the scope using the BOUNDARY_SCOPE_ID environment variable.list_token
(optional) - An opaque token that is returned from the previouslist
response. If you do not supply a value, pagination starts from the beginning.page_size
(optional) - An unsigned integer that indicates the number of items that should be included on the page of search results. If you do not provide a value, or if you provide a value of0
, Boundary uses the default page size of 1000 items. If you configure it, thepage_size
value overrides the default page size. Controller administrators can also configure amax_page_size
option that constrains the maximum page size a user can request.
CLI options
In addition to the command specific options, there are options common to all CLI commands and subcommands: