Viewing Object Properties
Every object stored in QStorage has a set of properties that provide information about the object. These properties include metadata, size, and other attributes. This topic explains how to view and understand object properties in QStorage.
Object Properties Overview
Object properties in QStorage include:
- Key (Name): The unique identifier for the object within the bucket
- Size: The size of the object in bytes
- Last Modified: The date and time when the object was last modified
- ETag: A hash of the object, which can be used to verify the integrity of the object
- Owner: The owner of the object
- Content Type: The MIME type of the object
- User-defined Metadata: Custom metadata that you can assign to objects
Viewing Object Properties
- Using QConsole
- Using Q's CLI Tooling
- Using a Third-Party S3-Compatible CLI
To view object properties using QConsole:
- Sign in to QConsole
- Navigate to QStorage
- Select the bucket containing the object
- Select the object you want to view
- View the object properties in the details panel
To view object properties using Q's CLI:
q s3api head-object --bucket bucket-name --key object-key
For a more detailed view:
q s3api get-object-attributes --bucket bucket-name --key object-key --object-attributes "ETag,Checksum,ObjectSize,StorageClass,ObjectParts"
Using the AWS CLI:
aws s3api head-object --bucket bucket-name --key object-key --endpoint-url https://qstorage.quilibrium.com
Understanding Object Metadata
Object metadata in QStorage is divided into two categories:
System-defined Metadata
System-defined metadata includes information that QStorage sets automatically, such as:
- Date created
- Object size
- Content type
- Last modified date
You cannot modify system-defined metadata after the object is created.
User-defined Metadata
User-defined metadata consists of name-value pairs that you can specify when you upload an object. This metadata is stored with the object and returned when you download the object.
To view user-defined metadata:
- Using QConsole
- Using Q's CLI Tooling
- Sign in to QConsole
- Navigate to QStorage
- Select the bucket containing the object
- Select the object
- View the metadata in the object properties section
q s3api head-object --bucket bucket-name --key object-key
The response will include any user-defined metadata with the prefix x-amz-meta-
.
Viewing Object Versions
If versioning is enabled on your bucket, you can view properties for specific versions of an object:
- Using QConsole
- Using Q's CLI Tooling
- Using a Third-Party S3-Compatible CLI
- Sign in to QConsole
- Navigate to QStorage
- Select the bucket containing the object
- Enable the "Show versions" option
- Select the specific version of the object
- View the properties for that version
q s3api head-object --bucket bucket-name --key object-key --version-id version-id
aws s3api head-object --bucket bucket-name --key object-key --version-id version-id --endpoint-url https://qstorage.quilibrium.com
Viewing Object Legal Holds and Retention Information
If you're using Object Lock features, you can view legal hold and retention information:
- Using Q's CLI Tooling
- Using a Third-Party S3-Compatible CLI
q s3api get-object-legal-hold --bucket bucket-name --key object-key
q s3api get-object-retention --bucket bucket-name --key object-key
aws s3api get-object-legal-hold --bucket bucket-name --key object-key --endpoint-url https://qstorage.quilibrium.com
aws s3api get-object-retention --bucket bucket-name --key object-key --endpoint-url https://qstorage.quilibrium.com
Best Practices for Working with Object Properties
- Regularly audit object properties to ensure they meet your storage and compliance requirements
- Use consistent metadata naming conventions to make it easier to search and organize objects
- Monitor object sizes and last modified dates to track changes and manage storage costs
- Use ETags for integrity verification when transferring objects between systems
- Leverage user-defined metadata to add application-specific information to your objects