Python 2.7 has reached end of support
and will be deprecated
on January 31, 2026. After deprecation, you won't be able to deploy Python 2.7
applications, even if your organization previously used an organization policy to
re-enable deployments of legacy runtimes. Your existing Python
2.7 applications will continue to run and receive traffic after their
deprecation date. We recommend that
you migrate to the latest supported version of Python.
Stay organized with collections
Save and categorize content based on your preferences.
GCSFileStat is provided by the App Engine client library for
Cloud Storage contained in /src/cloudstorage. This class is used to
store file stat data from cloudstorage.stat().
Instance Properties
A GCSFileStat instance has the following properties:
filename
String. The name of the file that this file stat is describing, in the
format /bucket/object. For example, /my_bucket/lyrics/southamerica/list5.txt.
is_dir
True if this represents a directory. False if this is a real file.
st_size
Long compatible. The file size in bytes.
etag
String. The hex representation of the MD5 hash of the file's content.
st_ctime
Float compatible. The posix file creation time.
content_type
String. The file's content type.
metadata
Dict. Contains any user-specified metadata from thex-goog-meta-
header. For example, {'x-goog-meta-foo': 'foo', 'x-goog-meta-bar': 'bar'}.
[[["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-09-03 UTC."],[[["\u003cp\u003e\u003ccode\u003eGCSFileStat\u003c/code\u003e stores file stat data retrieved from \u003ccode\u003ecloudstorage.stat()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIt includes properties like \u003ccode\u003efilename\u003c/code\u003e, \u003ccode\u003eis_dir\u003c/code\u003e, \u003ccode\u003est_size\u003c/code\u003e, \u003ccode\u003eetag\u003c/code\u003e, \u003ccode\u003est_ctime\u003c/code\u003e, \u003ccode\u003econtent_type\u003c/code\u003e, and \u003ccode\u003emetadata\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003efilename\u003c/code\u003e represents the file's path in the format \u003ccode\u003e/bucket/object\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eis_dir\u003c/code\u003e indicates whether the entry is a directory or a file.\u003c/p\u003e\n"],["\u003cp\u003eWhen listed via \u003ccode\u003elistbucket\u003c/code\u003e, directory entries only contain \u003ccode\u003efilename\u003c/code\u003e, while file entries include all properties.\u003c/p\u003e\n"]]],[],null,["# The GCSFileStat Class\n\n`GCSFileStat` is provided by the App Engine client library for\nCloud Storage contained in `/src/cloudstorage`. This class is used to\nstore file stat data from [cloudstorage.stat()](/appengine/docs/legacy/standard/python/googlecloudstorageclient/functions#stat).\n\nInstance Properties\n-------------------\n\nA `GCSFileStat` instance has the following properties:\n\nfilename\n: String. The name of the file that this file stat is describing, in the\n format `/bucket/object`. For example, `/my_bucket/lyrics/southamerica/list5.txt`.\n\nis_dir\n: True if this represents a directory. False if this is a real file.\n\nst_size\n: Long compatible. The file size in bytes.\n\netag\n: String. The hex representation of the MD5 hash of the file's content.\n\nst_ctime\n: Float compatible. The posix file creation time.\n\ncontent_type\n: String. The file's content type.\n\nmetadata\n: Dict. Contains any user-specified metadata from the`x-goog-meta-`\n header. For example, {'x-goog-meta-foo': 'foo', 'x-goog-meta-bar': 'bar'}.\n| **Important:** When returned from a `listbucket` call, if the `is_dir` property is `True` then the object contains only the `filename`. If `is_dir` is `False`, then the object contains all of the properties."]]