.TH "GCLOUD_BETA_APP_INSTANCES_SCP" 1



.SH "NAME"
.HP
gcloud beta app instances scp \- SCP from or to the VM of an App Engine Flexible environment instance



.SH "SYNOPSIS"
.HP
\f5gcloud beta app instances scp\fR [\fIINSTANCE\fR:]\fISRC\fR [[\fIINSTANCE\fR:]\fISRC\fR\ ...] [\fIINSTANCE\fR:]\fIDEST\fR [\fB\-\-compress\fR] [\fB\-\-recurse\fR] [\fB\-\-service\fR=\fISERVICE\fR] [\fB\-\-tunnel\-through\-iap\fR] [\fB\-\-version\fR=\fIVERSION\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(BETA)\fR \fBgcloud beta app instances scp\fR lets you remotely copy files to
or from an App Engine Flexible environment instance.

\fBgcloud beta app instances scp\fR resolves the instance's IP address and
pre\-populates the VM with a public key managed by gcloud. If the gcloud managed
key pair does not exist, it is generated the first time an SSH command is run,
which may prompt you for a passphrase for the private key encryption.

All SSH commands require the OpenSSH client suite to be installed on Linux and
Mac OS X. On Windows, the Google Cloud CLI comes with a bundled PuTTY suite
instead, so it has no external dependencies.



.SH "EXAMPLES"

To copy one file from a remote instance to the local machine, run:

.RS 2m
$ gcloud beta app instances scp \-\-service=s1 \-\-version=v1 \e
  i1:remote_file local_file
.RE

To copy several local files to a remote instance, run:

.RS 2m
$ gcloud beta app instances scp \-\-service=s1 \-\-version=v1 local_1 \e
  local_1 i1:remote_dir
.RE

To use recursive copy, run:

.RS 2m
$ gcloud beta app instances scp \-\-service=s1 \-\-version=v1 \e
  \-\-recurse local_dir i1:remote_dir
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
[\fIINSTANCE\fR:]\fISRC\fR [[\fIINSTANCE\fR:]\fISRC\fR ...]

Specifies the files to copy.

.TP 2m
[\fIINSTANCE\fR:]\fIDEST\fR

Specifies a destination for the source files.


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-compress\fR

Enable compression.

.TP 2m
\fB\-\-recurse\fR

Upload directories recursively.

.TP 2m
\fB\-\-service\fR=\fISERVICE\fR

The service ID.

.TP 2m
\fB\-\-tunnel\-through\-iap\fR

Tunnel the ssh connection through Identity\-Aware Proxy for TCP forwarding.

To learn more, see the IAP for TCP forwarding documentation
(https://cloud.google.com/iap/docs/tcp\-forwarding\-overview).

.TP 2m
\fB\-\-version\fR=\fIVERSION\fR

The version ID.


.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "NOTES"

This command is currently in beta and might change without notice. This variant
is also available:

.RS 2m
$ gcloud app instances scp
.RE