- INFORMATION
-
gcloud alpha compute dhcp-options-configs updateis not available in universe domainuniverse. - NAME
-
- gcloud alpha compute dhcp-options-configs update - update a Google Compute Engine DHCP options configuration
- SYNOPSIS
-
-
gcloud alpha compute dhcp-options-configs updateNAME[--region=REGION] [--update-associations=[NAME=NETWORK,…]] [--boot-file-name=BOOT_FILE_NAME|--clear-boot-file-name] [--boot-file-params=[BOOT_FILE_PARAMS,…] |--clear-boot-file-params] [--boot-file-url=BOOT_FILE_URL|--clear-boot-file-url] [--clear-associations|--remove-associations=[NAME,…]] [--clear-description|--description=DESCRIPTION] [--clear-dns-search-paths|--dns-search-paths=[DNS_SEARCH_PATHS,…]] [--clear-dns-server-ipv4-addresses|--dns-server-ipv4-addresses=[DNS_SERVER_IPV4_ADDRESSES,…]] [--clear-dns-server-ipv6-addresses|--dns-server-ipv6-addresses=[DNS_SERVER_IPV6_ADDRESSES,…]] [--clear-domain-name|--domain-name=DOMAIN_NAME] [--clear-lease-time|--lease-time=LEASE_TIME] [--clear-ntp-server-ipv4-addresses|--ntp-server-ipv4-addresses=[NTP_SERVER_IPV4_ADDRESSES,…]] [--clear-ntp-server-ipv6-addresses|--ntp-server-ipv6-addresses=[NTP_SERVER_IPV6_ADDRESSES,…]] [--clear-tftp-server-ipv4-addresses|--tftp-server-ipv4-addresses=[TFTP_SERVER_IPV4_ADDRESSES,…]] [--clear-tftp-server-name|--tftp-server-name=TFTP_SERVER_NAME] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(ALPHA)gcloud alpha compute dhcp-options-configs updateis used to update fields of a regional DHCP options configuration. - EXAMPLES
-
To update the domain name of a DHCP options config in us-central1, run:
gcloud alpha compute dhcp-options-configs update my-dhcp-config --region=us-central1 --domain-name=new.example.comTo add a new VPC network association or update an existing one without affecting other associations, run:
gcloud alpha compute dhcp-options-configs update my-dhcp-config --region=us-central1 --update-associations=my-assoc=my-vpcTo remove an association from a DHCP options config, run:
gcloud alpha compute dhcp-options-configs update my-dhcp-config --region=us-central1 --remove-associations=my-assocTo clear all VPC network associations from a DHCP options config, run:
gcloud alpha compute dhcp-options-configs update my-dhcp-config --region=us-central1 --clear-associationsTo clear domain search paths, run:
gcloud alpha compute dhcp-options-configs update my-dhcp-config --region=us-central1 --clear-dns-search-paths - POSITIONAL ARGUMENTS
-
NAME- Name of the dhcp options config to update.
- FLAGS
-
--region=REGION-
Region of the dhcp options config to update. If not specified, you might be
prompted to select a region (interactive mode only).
To avoid prompting when this flag is omitted, you can set the
property:compute/regiongcloud config set compute/region REGIONA list of regions can be fetched by running:
gcloud compute regions listTo unset the property, run:
gcloud config unset compute/regionAlternatively, the region can be stored in the environment variable
.CLOUDSDK_COMPUTE_REGION --update-associations=[NAME=NETWORK,…]- Map of association name to VPC network name or URL. If an association name already exists, its VPC network is updated; if it does not exist, a new association is added. Existing associations not specified in this flag are preserved.
-
At most one of these can be specified:
--boot-file-name=BOOT_FILE_NAME- File path of the TFTP boot file (Option 67).
--clear-boot-file-name- Clear the TFTP boot file path.
-
At most one of these can be specified:
--boot-file-params=[BOOT_FILE_PARAMS,…]- Boot file parameter arguments for IPv6 (Option 60).
--clear-boot-file-params- Clear the IPv6 boot file parameter arguments.
-
At most one of these can be specified:
--boot-file-url=BOOT_FILE_URL- URL of the IPv6 boot file (Option 59).
--clear-boot-file-url- Clear the IPv6 boot file URL.
-
At most one of these can be specified:
--clear-associations- Remove all VPC network associations from this DHCP options config.
--remove-associations=[NAME,…]- List of association names to detach from this DHCP options config.
-
At most one of these can be specified:
--clear-description- Clear the textual description.
--description=DESCRIPTION- An optional, textual description for the DHCP options config.
-
At most one of these can be specified:
--clear-dns-search-paths- Clear the list of domain search suffixes.
--dns-search-paths=[DNS_SEARCH_PATHS,…]- List of domain search suffixes (Options 119 and 24).
-
At most one of these can be specified:
--clear-dns-server-ipv4-addresses- Clear the list of IPv4 recursive DNS servers.
--dns-server-ipv4-addresses=[DNS_SERVER_IPV4_ADDRESSES,…]- List of IPv4 addresses of recursive DNS servers (Option 6).
-
At most one of these can be specified:
--clear-dns-server-ipv6-addresses- Clear the list of IPv6 recursive DNS servers.
--dns-server-ipv6-addresses=[DNS_SERVER_IPV6_ADDRESSES,…]- List of IPv6 addresses of recursive DNS servers (Option 23).
-
At most one of these can be specified:
--clear-domain-name- Clear the primary DNS domain name suffix.
--domain-name=DOMAIN_NAME- The primary DNS domain name suffix (Option 15).
-
At most one of these can be specified:
--clear-lease-time- Clear the IPv4 address lease time duration.
--lease-time=LEASE_TIME- The duration of the IPv4 address lease offered by the DHCP server to the client VM. See $ gcloud topic datetimes for information on duration formats (e.g. 24h, 86400s, 60m). Corresponds to DHCPv4 Option 51.
-
At most one of these can be specified:
--clear-ntp-server-ipv4-addresses- Clear the list of IPv4 NTP servers.
--ntp-server-ipv4-addresses=[NTP_SERVER_IPV4_ADDRESSES,…]- List of IPv4 addresses of NTP servers (Option 42).
-
At most one of these can be specified:
--clear-ntp-server-ipv6-addresses- Clear the list of IPv6 NTP servers.
--ntp-server-ipv6-addresses=[NTP_SERVER_IPV6_ADDRESSES,…]- List of IPv6 addresses of NTP servers (Option 56).
-
At most one of these can be specified:
--clear-tftp-server-ipv4-addresses- Clear the list of IPv4 TFTP boot servers.
--tftp-server-ipv4-addresses=[TFTP_SERVER_IPV4_ADDRESSES,…]- List of IPv4 addresses of TFTP boot servers (Option 150).
-
At most one of these can be specified:
--clear-tftp-server-name- Clear the TFTP boot server hostname.
--tftp-server-name=TFTP_SERVER_NAME- Hostname of the TFTP boot server (Option 66).
- 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 helpfor details. - NOTES
- This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist.
gcloud alpha compute dhcp-options-configs update
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-09-09 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-09-09 UTC."],[],[]]