Displays the content of the specified object in the bucket to the screen.
Usage notes
To view object content, you must have the oss:GetObject permission. For more information, see Grant a custom policy.
Command syntax
ossutil cat oss://bucket/object [flags]|
Parameter |
Type |
Description |
|
--count |
int |
Displays the specified number of characters. Default value: -1. |
|
--encoding-type |
string |
The encoding type of the object name. Valid values: url. |
|
--head |
int |
Displays only the first N characters. |
|
--offset |
int |
The start position of the display. |
|
--request-payer |
string |
The payer of the request. If pay-by-requester is enabled for the bucket, set this parameter to requester. Valid value: requester. |
|
--tail |
int |
Displays only the last N characters. |
|
--version-id |
string |
The version ID of the object. |
For more information, see Command-line options.
Examples
-
Display the content of the example.txt object in the examplebucket bucket to the screen.
ossutil cat oss://examplebucket/example.txt -
Display the first 10 characters.
ossutil cat oss://examplebucket/example.txt --head 10 -
Display the last 10 characters.
ossutil cat oss://examplebucket/example.txt --tail 10 -
Display 20 characters starting at position 10.
ossutil cat oss://examplebucket/example.txt --offset 10 --count 20 -
Display characters from position 10 to the end.
ossutil cat oss://examplebucket/example.txt --offset 10