.TH "GCLOUD_ARTIFACTS_FILES_DOWNLOAD" 1



.SH "NAME"
.HP
gcloud artifacts files download \- download an Artifact Registry file



.SH "SYNOPSIS"
.HP
\f5gcloud artifacts files download\fR (\fIFILE\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR\ \fB\-\-repository\fR=\fIREPOSITORY\fR) \fB\-\-destination\fR=\fIDESTINATION\fR [\fB\-\-allow\-overwrite\fR] [\fB\-\-local\-filename\fR=\fILOCAL_FILENAME\fR] [\fB\-\-parallelism\fR=\fIPARALLELISM\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Downloads an Artifact Registry file based on file name.



.SH "EXAMPLES"

To download a file named \f5myfile\fR in project \f5my\-project\fR under
repository \f5my\-repo\fR in \f5us\-central1\fR to the local path \f5~/\fR:

.RS 2m
$ gcloud artifacts files download \-\-location=us\-central1 \e
  \-\-project=my\-project \-\-repository=my\-repo \-\-destination=~/ \e
  myfile
.RE

To download a file named \f5myfile\fR in project \f5my\-project\fR under
repository \f5my\-repo\fR in \f5us\-central1\fR to the local path \f5~/\fR using
parallel multipart download with 4 threads:

.RS 2m
$ gcloud artifacts files download \-\-location=us\-central1 \e
  \-\-project=my\-project \-\-repository=my\-repo \-\-destination=~/ \e
  \-\-parallelism=4 myfile
.RE

To download a file named \f5myfile\fR in project \f5my\-project\fR under
repository \f5my\-repo\fR in \f5us\-central1\fR to the local path \f5~/\fR with
file overwriting enabled:

.RS 2m
$ gcloud artifacts files download \-\-location=us\-central1 \e
  \-\-project=my\-project \-\-repository=my\-repo \-\-destination=~/ \e
  myfile \-\-allow\-overwrite
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

File resource \- The Artifact Registry file name. 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 \f5file\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
\fIFILE\fR

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

To set the \f5name\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5file\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\-\-location\fR=\fILOCATION\fR

Location of the file.

To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5file\fR on the command line with a fully specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-location\fR on the command line;
.IP "\(bu" 2m
set the property \f5artifacts/location\fR.
.RE
.sp

.TP 2m
\fB\-\-repository\fR=\fIREPOSITORY\fR

Repository of the file.

To set the \f5repository\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5file\fR on the command line with a fully specified name;
.IP "\(bu" 2m
provide the argument \f5\-\-repository\fR on the command line;
.IP "\(bu" 2m
set the property \f5artifacts/repository\fR.
.RE
.sp


.RE
.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-destination\fR=\fIDESTINATION\fR

The path where you want to download the file.


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-allow\-overwrite\fR

If specified, the command overwrites an existing file

.TP 2m
\fB\-\-local\-filename\fR=\fILOCAL_FILENAME\fR

If specified, the name of the downloaded file on the local system is set to the
value you use for LOCAL_FILENAME. Otherwise the name of the downloaded file is
based on the file name in the registry.

.TP 2m
\fB\-\-parallelism\fR=\fIPARALLELISM\fR

Specifies the number of threads to use for downloading the file in parallel.


.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.