.TH "GCLOUD_ALPHA_STORAGE_CAT" 1



.SH "NAME"
.HP
gcloud alpha storage cat \- outputs the contents of one or more URLs to stdout



.SH "SYNOPSIS"
.HP
\f5gcloud alpha storage cat\fR \fIURL\fR [\fIURL\fR\ ...] [\fB\-\-additional\-headers\fR=\fIHEADER\fR=\fIVALUE\fR] [\fB\-\-display\-url\fR,\ \fB\-d\fR] [\fB\-\-range\fR=\fIRANGE\fR,\ \fB\-r\fR\ \fIRANGE\fR] [\fB\-\-decryption\-keys\fR=[\fIDECRYPTION_KEY\fR,...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR The cat command outputs the contents of one or more URLs to
stdout. While the cat command does not compute a checksum, it is otherwise
equivalent to doing:

.RS 2m
$ gcloud alpha storage cp url... \-
.RE

(The final '\-' causes gcloud to stream the output to stdout.)



.SH "EXAMPLES"

The following command writes all text files in a bucket to stdout:

.RS 2m
$ gcloud alpha storage cat gs://bucket/*.txt
.RE

The following command outputs a short header describing file.txt, along with its
contents:

.RS 2m
$ gcloud alpha storage cat \-d gs://my\-bucket/file.txt
.RE

The following command outputs bytes 256\-939 of file.txt:

.RS 2m
$ gcloud alpha storage cat \-r 256\-939 gs://my\-bucket/file.txt
.RE

The following command outputs the last 5 bytes of file.txt:

.RS 2m
$ gcloud alpha storage cat \-r \-5 gs://my\-bucket/file.txt
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIURL\fR [\fIURL\fR ...]

The url of objects to list.


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-additional\-headers\fR=\fIHEADER\fR=\fIVALUE\fR

Includes arbitrary headers in storage API calls. Accepts a comma separated list
of key=value pairs, e.g. \f5header1=value1,header2=value2\fR. Overrides the
default \fBstorage/additional_headers\fR property value for this command
invocation.

.TP 2m
\fB\-\-display\-url\fR, \fB\-d\fR

Prints the header before each object.

.TP 2m
\fB\-\-range\fR=\fIRANGE\fR, \fB\-r\fR \fIRANGE\fR

Causes gcloud storage to output just the specified byte range of the object. In
a case where "start" = 'x', and "end" = 'y', ranges take the form: \f5x\-y\fR
(e.g., \f5\-r 256\-5939\fR), \f5x\-\fR (e.g., \f5\-r 256\-\fR), \f5\-y\fR (e.g.,
\f5\-r \-5\fR)

When offsets start at 0, x\-y means to return bytes x through y (inclusive), x\-
means to return bytes x through the end of the object, and \-y changes the role
of y. If \-y is present, then it returns the last y bytes of the object.

If the bytes are out of range of the object, then nothing is printed


.RE
.sp

.SH "ENCRYPTION FLAGS"

.RS 2m
.TP 2m
\fB\-\-decryption\-keys\fR=[\fIDECRYPTION_KEY\fR,...]

A comma\-separated list of customer\-supplied encryption keys (RFC 4648 section
4 base64\-encoded AES256 strings) that will be used to decrypt Cloud Storage
objects. Data encrypted with a customer\-managed encryption key (CMEK) is
decrypted automatically, so CMEKs do not need to be listed here.


.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 alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation\-only early access
allowlist. This variant is also available:

.RS 2m
$ gcloud storage cat
.RE