NAME

gcloud privateca roots update - update an existing root certificate authority

SYNOPSIS

gcloud privateca roots update (CERTIFICATE_AUTHORITY : --location=LOCATION --pool=POOL) [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...]

EXAMPLES

To update labels on a root CA:

$ gcloud privateca roots update prod-root --location=us-west1 \ --pool=my-pool --update-labels=foo=bar

POSITIONAL ARGUMENTS

CERTIFICATE AUTHORITY resource - The certificate authority to update. The

arguments in this group can be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the project attribute:

—

provide the argument CERTIFICATE_AUTHORITY on the command line with a fully specified name;

—

provide the argument --project on the command line;

—

set the property core/project.

This must be specified.

CERTIFICATE_AUTHORITY

ID of the CERTIFICATE_AUTHORITY or fully qualified identifier for the CERTIFICATE_AUTHORITY. To set the certificate_authority attribute:

• provide the argument CERTIFICATE_AUTHORITY on the command line.

This positional argument must be specified if any of the other arguments in this group are specified.

--location=LOCATION

The location of the CERTIFICATE_AUTHORITY. To set the location attribute:

• provide the argument CERTIFICATE_AUTHORITY on the command line with a fully specified name;

• provide the argument --location on the command line;

• set the property privateca/location.

--pool=POOL

The parent CA Pool of the CERTIFICATE_AUTHORITY. To set the pool attribute:

• provide the argument CERTIFICATE_AUTHORITY on the command line with a fully specified name;

• provide the argument --pool on the command line.

FLAGS

--update-labels=[KEY=VALUE,...]

List of label KEY=VALUE pairs to update. If a label exists, its value is modified. Otherwise, a new label is created.

Keys must start with a lowercase character and contain only hyphens (-), underscores (_), lowercase characters, and numbers. Values must contain only hyphens (-), underscores (_), lowercase characters, and numbers.

At most one of these can be specified:

--clear-labels

Remove all labels. If --update-labels is also specified then --clear-labels is applied first.

For example, to remove all labels:

$ gcloud privateca roots update --clear-labels

To remove all existing labels and create two new labels, foo and baz:

$ gcloud privateca roots update --clear-labels \ --update-labels foo=bar,baz=qux

--remove-labels=[KEY,...]

List of label keys to remove. If a label does not exist it is silently ignored. If --update-labels is also specified then --update-labels is applied first.

GCLOUD WIDE FLAGS

These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

NOTES

This variant is also available:

$ gcloud beta privateca roots update