getmeta (show object's metadata)

Top  Previous  Next

getmeta [BUCKET_NAME]/[FOLDER]/OBJECT [-showmeta:META] [-version:ID]

Shows S3 metadata associated with an object. To show the metadata associated with multiple objects, use the ls command.

 

Parameter

Description

Examples

[BUCKET_NAME]/[FOLDER]/OBJECT

Name of the bucket, folder and object to show metadata for.

getmeta file.txt (shows metadata of 'file.txt' at current S3 working location, see cd command for setting working location)

 

getmeta mybucket/folder/file.txt (shows metadata of object 'mybucket/folder/file.txt')

 

getmeta "mybucket/folder/object name with space.txt" (shows metadata of object "mybucket/folder/object name with space.txt". Note that surrounding quotation marks are needed to specify names with spaces)

 

getmeta ../file.txt (shows metadata of object 'file.txt' in parent folder)

-showmeta:
"[META]"

 

 

Only include specified object metadata in the listing output. Wildcard character can be used (i.e. * and ?). Multiple metadata headers should be separated by |. If this flag is not specified, by default, all object's metadata are shown.

getmeta file.txt -showmeta:* (include ALL the metadata headers in the output. This is the default if not specified)

 

getmeta file.txt -showmeta:"cache-control" (include only the cache-control header in the output)

 

getmeta file.txt -showmeta:"cache-control|x-amz-server-side​-encryption" (include only the cache-control and x-amz-server-side​-encryption metadata headers in the output)

 

getmeta file.txt -showmeta:"x-amz-meta-*" (include all the metadata headers that start with x-amz-meta- in the output)

-version:ID

Show the metadata associated with a specific version of the object.

getmeta file.txt -version:12909188 (show metadata of file.txt and version ID: 12909188).

 

Notes:
To show the metadata associated with multiple objects, use the ls command.