gcloud alpha cloud-shell scp - copies files between Cloud Shell and the local machine
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 ...]
(ALPHA) gcloud alpha cloud-shell scp copies files between your Cloud Shell instance and your local machine using the scp command.
To denote a file in Cloud Shell, prefix the file name with the string "cloudshell:" (e.g. cloudshell:~/FILE). To denote a local 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:
$ gcloud alpha cloud-shell scp cloudshell:~/REMOTE-DIR \ localhost:~/LOCAL-DIR
In the above example, ~/REMOTE-DIR from your Cloud Shell instance is copied into the ~/LOCAL-DIR directory.
Conversely, files from your local computer can be copied into Cloud Shell:
$ gcloud alpha cloud-shell scp localhost:~/LOCAL-FILE-1 \ localhost:~/LOCAL-FILE-2 cloudshell:~/REMOTE-DIR
Under the covers, scp(1) or pscp (on Windows) is used to facilitate the transfer.
- (cloudshell|localhost):SRC [(cloudshell|localhost):SRC ...]
Specifies the files to copy.
- (cloudshell|localhost):DEST
Specifies a destination for the source files.
- --dry-run
If provided, prints the command that would be run to standard out instead of executing it.
- --force-key-file-overwrite
If enabled gcloud will regenerate and overwrite the files associated with a broken SSH key without asking for confirmation in both interactive and non-interactive environment.
If disabled gcloud will not attempt to regenerate the files associated with a broken 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.
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.
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. These variants are also available:
$ gcloud cloud-shell scp
$ gcloud beta cloud-shell scp