gcloud_beta_dns_managed-zones_update (1)

NAME

gcloud beta dns managed-zones update - update an existing Cloud DNS managed-zone

SYNOPSIS

gcloud beta dns managed-zones update ZONE [--denial-of-existence=DENIAL_OF_EXISTENCE] [--description=DESCRIPTION] [--dnssec-state=DNSSEC_STATE] [--forwarding-targets=[IP_ADDRESSES,...]] [--ksk-algorithm=KSK_ALGORITHM] [--ksk-key-length=KSK_KEY_LENGTH] [--networks=[NETWORK,...]] [--update-labels=[KEY=VALUE,...]] [--zsk-algorithm=ZSK_ALGORITHM] [--zsk-key-length=ZSK_KEY_LENGTH] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

(BETA) Update an existing Cloud DNS managed-zone.

POSITIONAL ARGUMENTS

Zone resource - The name of the managed-zone to be updated. This represents a Cloud 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 [zone] 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.

ZONE

ID of the zone or fully qualified identifier for the zone.

FLAGS

--denial-of-existence=DENIAL_OF_EXISTENCE

Requires DNSSEC enabled. DENIAL_OF_EXISTENCE must be one of: nsec, nsec3.

--description=DESCRIPTION

Short description for the managed-zone.

--dnssec-state=DNSSEC_STATE

The DNSSEC state for this managed zone. DNSSEC_STATE must be one of:

off

Disable DNSSEC for the managed zone.

on

Enable DNSSEC for the managed zone.

transfer

Enable DNSSEC and allow transferring a signed zone in or out.

--forwarding-targets=[IP_ADDRESSES,...]

List of IPv4 addresses of target name servers that the zone will forward queries to. Ignored for private visibility.

--ksk-algorithm=KSK_ALGORITHM

String mnemonic specifying the DNSSEC algorithm of the key-signing key. Requires DNSSEC enabled. KSK_ALGORITHM must be one of: ecdsap256sha256, ecdsap384sha384, rsasha1, rsasha256, rsasha512.

--ksk-key-length=KSK_KEY_LENGTH

Length of the key-signing key in bits. Requires DNSSEC enabled.

--networks=[NETWORK,...]

List of networks that the zone should be visible in if the zone visibility is [private].

--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.

--zsk-algorithm=ZSK_ALGORITHM

String mnemonic specifying the DNSSEC algorithm of the key-signing key. Requires DNSSEC enabled. ZSK_ALGORITHM must be one of: ecdsap256sha256, ecdsap384sha384, rsasha1, rsasha256, rsasha512.

--zsk-key-length=ZSK_KEY_LENGTH

Length of the zone-signing key in bits. Requires DNSSEC enabled.

At most one of these may 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 beta dns managed-zones update --clear-labels

To set the labels to exactly "foo" and "baz":

$ gcloud beta dns managed-zones 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.

GCLOUD WIDE FLAGS

These flags are available to all commands: --account, --configuration, --flags-file, --flatten, --format, --help, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details.

EXAMPLES

To change the description of a managed-zone, run:

$ gcloud beta dns managed-zones update my_zone \
    --description="Hello, world!"

NOTES

This command is currently in BETA and may change without notice. This variant is also available:

$ gcloud dns managed-zones update