Querying Object Properties

Updated on 2025-02-10 GMT+08:00

View PDF

Function

You can use this command to query the basic properties of an object.

Command Line Structure

In Windows

obsutil stat obs://bucket/key [-acl][-bf=xxx] [-config=xxx]

In Linux or macOS

./obsutil stat obs://bucket/key [-acl][-bf=xxx] [-config=xxx]

Examples

Take the Windows OS as an example. Run the obsutil stat obs://bucket-test/key command to query the basic properties of an object.

obsutil stat obs://bucket-test/key

Start at 2024-09-25 04:48:10.1147483 +0000 UTC

Key:
  obs://bucket-test/key
LastModified:
  2018-11-16T02:15:49Z
Size:
  7
StorageClass:
  standard
ETag:
  43d93b553855b0e1fc67e31c28c07b65
ContentType:
  text/plain
Type:
  file
Metadata:
  key=value

Parameter Description

Parameter	Optional or Mandatory	Description
bucket	Mandatory	Bucket name
key	Mandatory	Object name
acl	Optional	Queries the access control policies of the object at the same time.
bf	Optional (additional parameter)	Display format of the object size (in bytes). Possible values are: human-readable raw NOTE: If this parameter is not configured, the display format of the object size (in bytes) is determined by the humanReadableFormat parameter in the configuration file.
config	Optional (additional parameter)	User-defined configuration file for executing the current command. To learn the parameters that can be configured in this file, see .

Response

Field	Description
Key	Object name
LastModified	Latest modification time of the object
Size	Object size, in bytes
StorageClass	Storage class of the object
MD5	Real MD5 of the object NOTE: You can query this value only after running the cp command and configuring the -vmd5 parameter.
ETag	ETag value of an object calculated on the server
ContentType	Content-Type of the object
Type	Object type
Metadata	Customized metadata of the object NOTE: The value of this field can be queried only after the object has customized metadata.

Parent topic: Object Commands

Previous topic: Uploading an Object

Next topic: Setting Object Properties

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot