gcloud_alpha_cloud-shell_scp (1)
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 files between your
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.
POSITIONAL ARGUMENTS
-
- (cloudshell|localhost):SRC [(cloudshell|localhost):SRC ...]
-
Specifies the files to copy.
- (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 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.
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.
NOTES
This command is currently in ALPHA and may change without notice. If this command fails with API permission errors despite specifying the right project, you will have to apply for early access and have your projects registered on the API whitelist to use it. To do so, contact Support at cloud.google.com/support