.TH "GCLOUD_AI_MODELS_COPY" 1



.SH "NAME"
.HP
gcloud ai models copy \- copy a model



.SH "SYNOPSIS"
.HP
\f5gcloud ai models copy\fR \fB\-\-source\-model\fR=\fISOURCE_MODEL\fR [\fB\-\-kms\-key\-name\fR=\fIKMS_KEY_NAME\fR] [\fB\-\-region\fR=\fIREGION\fR] [\fB\-\-destination\-model\-id\fR=\fIDESTINATION_MODEL_ID\fR\ |\ \fB\-\-destination\-parent\-model\fR=\fIDESTINATION_PARENT_MODEL\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "EXAMPLES"

To copy a model \f5123\fR of project \f5example\fR from region
\f5us\-central1\fR to region \f5europe\-west4\fR, run:

.RS 2m
$ gcloud ai models copy \e
    \-\-source\-model=projects/example/locations/us\-central1/models/\e
123 \-\-region=projects/example/locations/europe\-west4
.RE



.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-source\-model\fR=\fISOURCE_MODEL\fR

The resource name of the Model to copy. That Model must be in the same Project.
Format: \f5projects/{project}/locations/{location}/models/{model}\fR.


.RE
.sp

.SH "OPTIONAL FLAGS"

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

The Cloud KMS resource identifier of the customer managed encryption key used to
protect the resource. Has the form:
\f5projects/my\-project/locations/my\-region/keyRings/my\-kr/cryptoKeys/my\-key\fR.
The key needs to be in the same region as the destination region of the model to
be copied.

.TP 2m

Region resource \- Cloud region to copy the model into. This represents a Cloud
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 \f5\-\-region\fR on the command line with a fully specified
name;
.IP "\(em" 2m
set the property \f5ai/region\fR with a fully specified name;
.IP "\(em" 2m
choose one from the prompted list of available regions 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


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

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

To set the \f5region\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-region\fR on the command line;
.IP "\(em" 2m
set the property \f5ai/region\fR;
.IP "\(em" 2m
choose one from the prompted list of available regions.
.RE
.sp

.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-destination\-model\-id\fR=\fIDESTINATION_MODEL_ID\fR

Copy source_model into a new Model with this ID. The ID will become the final
component of the model resource name. This value may be up to 63 characters, and
valid characters are \f5[a\-z0\-9\fI\-]\fR. The first character cannot be a
number or hyphen.

.TP 2m
\fB\-\-destination\-parent\-model\fR=\fRDESTINATION_PARENT_MODEL\fI

Specify this field to copy source_model into this existing Model as a new
version. Format: \f5projects/{project}/locations/{location}/models/{model}\fR.


\fR
.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"

These variants are also available:

.RS 2m
$ gcloud alpha ai models copy
.RE

.RS 2m
$ gcloud beta ai models copy
.RE