Boundary
host-catalogs update
Command: host-catalogs update
The host-catalogs update command lets you update an existing host catalog.
Example
This example updates a static host catalog with the ID hcst_1234567890 to add the name devops and the description For DevOps usage:
$ boundary host-catalogs update static -id hcst_1234567890 -name devops -description "For DevOps usage"
Usage
$ boundary host-catalogs update [type] <subcommand> [options] [args]
Please see the typed subcommand help for detailed usage information.
Subcommands:
plugin Update a plugin-type host catalog
static Update a static-type host catalog
Usages by type
You can update plugin or static host set types.
The boundary host-catalogs update plugin command lets you update a plugin type host catalog.
Example
This example updates a plugin type host catalog with the ID hc_1234567890 to add the name devops and the description Plugin host-catalog for DevOps.
$ boundary host-catalogs update plugin -id hc_1234567890 -name "devops" -description "Plugin host-catalog for DevOps"
Usage
$ boundary host-catalogs update plugin [options] [args]
Command options
-description=<string>- The description to set on the plugin host catalog.-id=<string>- The ID of the plugin type host catalog to update.-name=<string>- The name to set on the plugin host catalog.-version=<int>- The version of the plugin host catalog to update. If you do not specify a version, the command automatically performs a check-and-set.
Attribute options
-attr- A key=value pair to add to the request's attribute map. This option can also be a key value only, which sets a JSON null as the value. If you provide a value, Boundary automatically infers the type. You can override the type using-string-attr,-bool-attr, or-num-attr. You can specify this value multiple times. This option supports referencing values from files usingfile://and environment variables usingenv://.-attributes=<string>- A JSON map value that you can use as the entirety of the request's attributes map. Usually this value is sourced from a file using thefile://syntax. This option is exclusive with otherattrflags.-bool-attr- A key=value Boolean value that you can add to the request's attributes map. You can specify this value multiple times. This option supports referencing values from files usingfile://and environment variables usingenv://.-num-attr- A key=value numeric value that you can add to the request's attributes map. You can specify this value multiple times. This attribute supports referencing values from files usingfile://and environment variables usingenv://.-string-attr- A key=value string value that you can add to the request's attributes map. You can specify this value multiple times. This option supports referencing values from files usingfile://and environment variables usingenv://.
Secrets options
-bool-secret- A key=value Boolean value that you can add to the request's secrets map. You can specify this value multiple times. This option supports referencing values from files usingfile://and environment variables usingenv://.-num-secret- A key=value numeric value that you can add to the request's secrets map. You can specify this value multiple times. This option supports referencing values from files usingfile://and environment variables usingenv://.-secret- A key=value pair that you can add to the request's secrets map. This option can also be a key value only, which sets a JSON null as the value. If you provide a value, Boundary automatically infers the type. You can override the type using-string-secret,-bool-secret, or-num-secret. You can specify this value multiple times. This option supports referencing values from files usingfile://and environment variables usingenv://.-secrets=<string>- A JSON map value that you can use as the entirety of the request's secrets map. Usually this value is sourced from file usingfile://syntax. This option is exclusive with other secret flags.-string-secret- A key=value string value that you can add to the request's attributes map. You can specify this value multiple times. This option supports referencing values from files usingfile://and environment variables usingenv://.