.TH "GCLOUD_LOOKER_INSTANCES_EXPORT" 1



.SH "NAME"
.HP
gcloud looker instances export \- export a Looker instance



.SH "SYNOPSIS"
.HP
\f5gcloud looker instances export\fR (\fIINSTANCE\fR\ :\ \fB\-\-region\fR=\fIREGION\fR) \fB\-\-kms\-key\fR=\fIKMS_KEY\fR \fB\-\-target\-gcs\-uri\fR=\fITARGET_GCS_URI\fR [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

This command can fail for the following reasons:
.RS 2m
.IP "\(bu" 2m
The instance specified does not exist.
.IP "\(bu" 2m
The active account does not have permission to access the given instance.
.IP "\(bu" 2m
The Google Cloud Storage bucket does not exist.
.RE
.sp



.SH "EXAMPLES"

To export an instance with the name \f5my\-looker\-instance\fR in the default
region, run:

.RS 2m
$ gcloud looker instances export my\-looker\-instance \e
    \-\-target\-gcs\-uri='gs://bucketName/folderName' \e
    \-\-kms\-key='projects/my\-project/locations/us\-central1/keyRings/my\e
\-key\-ring/cryptoKeys/my\-key'
.RE

Note that the kms\-key flag should be the full name of the kms key.



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Instance resource \- Arguments and flags that specify the Looker instance you
want to export. The arguments in this group can be used to specify the
attributes of this resource. (NOTE) Some attributes are not given arguments in
this group but can be set in other ways.

To set the \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5instance\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp

This must be specified.


.RS 2m
.TP 2m
\fIINSTANCE\fR

ID of the instance or fully qualified identifier for the instance.

To set the \f5instance\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5instance\fR on the command line.
.RE
.sp

This positional argument must be specified if any of the other arguments in this
group are specified.

.TP 2m
\fB\-\-region\fR=\fIREGION\fR

The region of the instance.

To set the \f5region\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5instance\fR on the command line with a fully specified
name;
.IP "\(bu" 2m
provide the argument \f5\-\-region\fR on the command line.
.RE
.sp


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m

Key resource \- The Cloud KMS (Key Management Service) cryptokey that will be
used to protect the Looker instance and backups. The 'Looker Service Agent'
service account must hold role 'Cloud KMS CryptoKey Encrypter'. The arguments in
this group can be used to specify the attributes of this resource.

This must be specified.


.RS 2m
.TP 2m
\fB\-\-kms\-key\fR=\fIKMS_KEY\fR

Fully qualified identifier (name) for the key.

.RE
.sp
.TP 2m

Export Destination \- The path and storage where the export will be stored.

This must be specified.


.RS 2m
.TP 2m
\fB\-\-target\-gcs\-uri\fR=\fITARGET_GCS_URI\fR

The path to the folder in Google Cloud Storage where the export will be stored.
The URI is in the form \f5gs://bucketName/folderName\fR. The Looker Service
Agent should have the role Storage Object Creator.


.RE
.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 variant is also available:

.RS 2m
$ gcloud alpha looker instances export
.RE