The following command writes all text files in a bucket to stdout:
gdcloud storage cat s3://bucket/*.txt
The following command outputs a short header describing file.txt, along with its contents:
gdcloud storage cat -d s3://my-bucket/file.txt
The following command outputs bytes 256-939 of file.txt:
gdcloud storage cat -r 256-939 s3://my-bucket/file.txt
The following command outputs the last 5 bytes of file.txt:
gdcloud storage cat -r -5 s3://my-bucket/file.txt
OPTIONAL FLAGS
-d, --display-url Print the header before each object.
--log-http Log all HTTP server requests and responses to stderr.
-r, --range string Output just the specified byte range of the
object. In a case where "start" = 'x', and "end" = 'y', ranges take the
form: x-y (e.g., -r 256-5939), x- (e.g., -r 256-), -y (e.g., -r -5)
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.
--verbosity string Override the default verbosity for this command. VERBOSITY must be one of:
debug, info, warning, error, critical, none. (default "warning")
GDCLOUD WIDE FLAGS
These flags are available to all commands: --configuration, --format, --help, --project, --quiet.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eThe \u003ccode\u003egdcloud storage cat\u003c/code\u003e command outputs the contents of one or more specified URLs to the standard output.\u003c/p\u003e\n"],["\u003cp\u003eYou can display a header before each object's content using the \u003ccode\u003e-d\u003c/code\u003e or \u003ccode\u003e--display-url\u003c/code\u003e flag.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003e-r\u003c/code\u003e or \u003ccode\u003e--range\u003c/code\u003e flag allows you to specify a byte range of the object to output, including options like x-y, x-, and -y to designate specific byte ranges or the last 'y' bytes.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify the output verbosity level with the \u003ccode\u003e--verbosity\u003c/code\u003e flag, choosing between debug, info, warning, error, critical, or none.\u003c/p\u003e\n"],["\u003cp\u003eThe command also supports various global flags such as \u003ccode\u003e--configuration\u003c/code\u003e, \u003ccode\u003e--format\u003c/code\u003e, \u003ccode\u003e--help\u003c/code\u003e, \u003ccode\u003e--project\u003c/code\u003e, and \u003ccode\u003e--quiet\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# gdcloud storage cat\n\nNAME\n----\n\ngdcloud storage cat - Output the contents of one or more URLs to stdout.\n\nSYNOPSIS\n--------\n\n gdcloud storage cat [URLS ...]\n [--display-url, -d]\n [--range, -r]\n [--format=FORMAT]\n [--log-http]\n [--verbosity=VERBOSITY] [flags]\n\n### EXAMPLES\n\n The following command writes all text files in a bucket to stdout:\n\n gdcloud storage cat s3://bucket/*.txt\n\n The following command outputs a short header describing file.txt, along with its contents:\n\n gdcloud storage cat -d s3://my-bucket/file.txt\n\n The following command outputs bytes 256-939 of file.txt:\n\n gdcloud storage cat -r 256-939 s3://my-bucket/file.txt\n\n The following command outputs the last 5 bytes of file.txt:\n\n gdcloud storage cat -r -5 s3://my-bucket/file.txt\n\n### OPTIONAL FLAGS\n\n -d, --display-url Print the header before each object.\n --log-http Log all HTTP server requests and responses to stderr.\n -r, --range string Output just the specified byte range of the\n object. In a case where \"start\" = 'x', and \"end\" = 'y', ranges take the\n form: x-y (e.g., -r 256-5939), x- (e.g., -r 256-), -y (e.g., -r -5)\n \n When offsets start at 0, x-y means to return bytes x through y (inclusive),\n x- means to return bytes x through the end of the object, and -y changes the\n role of y. If -y is present, then it returns the last y bytes of the object.\n \n If the bytes are out of range of the object, then nothing is printed.\n --verbosity string Override the default verbosity for this command. VERBOSITY must be one of:\n debug, info, warning, error, critical, none. (default \"warning\")\n\n### GDCLOUD WIDE FLAGS\n\nThese flags are available to all commands: `--configuration`, `--format`, `--help`, `--project`, `--quiet`.\n\nFor more information, see the [gdcloud CLI reference overview](/distributed-cloud/hosted/docs/latest/gdch/resources/gdcloud-reference/gdcloud) page."]]