gcloud compute addresses move

NAME

gcloud compute addresses move - move an address to another project

SYNOPSIS

gcloud compute addresses move NAME --target-project=TARGET_PROJECT [--description=DESCRIPTION] [--new-name=NEW_NAME] [--global | --region=REGION] [GCLOUD_WIDE_FLAG …]

EXAMPLES

The following command moves address external-ip1 in region us-central1 to project test-playground with new address name test-ip1:

gcloud compute addresses move external-ip1 --new-name=test-ip1 --target-project=test-playground --region=us-central1

POSITIONAL ARGUMENTS

NAME: Name of the address to operate on.

REQUIRED FLAGS

--target-project=TARGET_PROJECT: The target project to move address to. It can be either a project name or a project numerical ID. It must not be the same as the current project.

OPTIONAL FLAGS

--description=DESCRIPTION: Description of moved new address.
--new-name=NEW_NAME: Name of moved new address. If not specified, current address's name is used.
At most one of these can be specified: --global If set, the address is global. --region=REGION Region of the address to operate on. Overrides the default compute/region property value for this command invocation.

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

These variants are also available:

gcloud alpha compute addresses move

gcloud beta compute addresses move

gcloud preview compute addresses move

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-05-27 UTC.