.TH "GCLOUD_ARTIFACTS_ATTACHMENTS_DOWNLOAD" 1



.SH "NAME"
.HP
gcloud artifacts attachments download \- download an Artifact Registry attachment from a repository



.SH "SYNOPSIS"
.HP
\f5gcloud artifacts attachments download\fR [\fIATTACHMENT\fR\ :\ \fB\-\-location\fR=\fILOCATION\fR\ \fB\-\-repository\fR=\fIREPOSITORY\fR] \fB\-\-destination\fR=\fIDESTINATION\fR [\fB\-\-chunk\-size\fR=\fICHUNK_SIZE\fR] [\fB\-\-oci\-version\-name\fR=\fIOCI_VERSION_NAME\fR] [\fB\-\-parallelism\fR=\fIPARALLELISM\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

Download an Artifact Registry attachment from a repository.



.SH "EXAMPLES"

To download the attachment \f5my\-attachment\fR to \f5/path/to/destination/\fR:

.RS 2m
$ gcloud artifacts attachments download my\-attachment \e
  \-\-destination=/path/to/destination/
.RE

To download the attachment \f5my\-attachment\fR in 8000 byte chunks to
\f5/path/to/destination/\fR:

.RS 2m
$ gcloud artifacts attachments download my\-attachment \e
  \-\-destination=/path/to/destination/ \-\-chunk\-size=8000
.RE

To download the attachment \f5my\-attachment\fR using parallel multipart
download with 4 threads:

.RS 2m
$ gcloud artifacts attachments download my\-attachment \e
  \-\-destination=/path/to/destination/ \-\-parallelism=4
.RE

For Docker\-format repositories only: to download the attachment stored in the
OCI version
\f5projects/my\-project/locations/us/repositories/my\-repo/packages/my\-package/versions/sha256:123\fR
to \f5/path/to/destination/\fR:

.RS 2m
$ gcloud artifacts attachments download \e
  \-\-oci\-version\-name=projects/my\-project/locations/us/\e
repositories/my\-repo/packages/my\-package/versions/sha256:123 \e
    \-\-destination=/path/to/destination/
.RE

For Docker\-format repositories only: to download the attachment stored in the
OCI version with URI
\f5us\-docker.pkg.dev/my\-project/my\-repo/my\-package@sha256:123\fR to
\f5/path/to/destination/\fR:

.RS 2m
$ gcloud artifacts attachments download \e
  \-\-oci\-version\-name=us\-docker.pkg.dev/my\-project/my\-repo/\e
my\-package@sha256:123 \-\-destination=/path/to/destination/
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m

Attachment resource \- The Artifact Registry attachment 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 \f5attachment\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


.RS 2m
.TP 2m
\fIATTACHMENT\fR

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

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

To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5attachment\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 attachment.

To set the \f5repository\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5attachment\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

Path where you want to save the downloaded attachment files.


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-chunk\-size\fR=\fICHUNK_SIZE\fR

If specified, the chunk size (bytes) to use for downloading the package.

.TP 2m
\fB\-\-oci\-version\-name\fR=\fIOCI_VERSION_NAME\fR

For Docker\-format repositories only. The version name of the OCI artifact to
download.

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

Specifies the number of threads to use for downloading the attachment files 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.