gcloud alpha cloud-shell scp

NAME
gcloud alpha cloud-shell scp - copies files between Cloud Shell and the local machine
SYNOPSIS
gcloud alpha cloud-shell scp(cloudshell|localhost):SRC[(cloudshell|localhost):SRC …](cloudshell|localhost):DEST[--dry-run][--force-key-file-overwrite][--recurse][--scp-flag=SCP_FLAG][--ssh-key-file][GCLOUD_WIDE_FLAG …]
DESCRIPTION
(ALPHA)gcloud alpha cloud-shell scp copies filesbetween your Cloud Shell instance and your local machine using the scp command.
EXAMPLES
To denote a file in Cloud Shell, prefix the file name with the string"cloudshell:" (e.g.cloudshell:~/FILE). To denote alocal file, prefix the file name with the string "localhost:" (e.g.localhost:~/FILE). For example,to copy a remote directory to your local machine, run:
gcloudalphacloud-shellscpcloudshell:~/REMOTE-DIRlocalhost:~/LOCAL-DIR

In the above example,~/REMOTE-DIR fromyour Cloud Shell instance is copied into the ~/LOCAL-DIRdirectory.

Conversely, files from your local computer can be copied into Cloud Shell:

gcloudalphacloud-shellscplocalhost:~/LOCAL-FILE-1localhost:~/LOCAL-FILE-2cloudshell:~/REMOTE-DIR

Under the covers,scp(1) or pscp (on Windows) is used to facilitatethe transfer.

POSITIONAL ARGUMENTS
cloudshell|localhost):SRC-[(cloudshell|localhost):SRC-…]">(cloudshell|localhost):SRC [(cloudshell|localhost):SRC …]
Specifies the files to copy.
cloudshell|localhost):DEST">(cloudshell|localhost):DEST
Specifies a destination for the source files.
FLAGS
--dry-run
If provided, prints the command that would be run to standard out instead ofexecuting it.
--force-key-file-overwrite
If enabled gcloud will regenerate and overwrite the files associated with abroken SSH key without asking for confirmation in both interactive andnon-interactive environment.

If disabled gcloud will not attempt to regenerate the files associated with abroken SSH key and fail in both interactive and non-interactive environment.

--recurse
Upload directories recursively.
--scp-flag=SCP_FLAG
Extra flag to be sent to scp. This flag may be repeated.
--ssh-key-file
The path to the SSH key file. By default, this is~/.ssh/google_compute_engine.
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 command is currently in alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. These variants are also available:
gcloudcloud-shellscp
gcloudbetacloud-shellscp

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-07 UTC.