A wrapper around Cloud Storage's concept of anObject.
Parameters
Name
Description
name
str
The name of the blob. This corresponds to the unique path of the object in the bucket. If bytes, will be converted to a unicode object. Blob / object names can contain any sequence of valid unicode characters, of length 1-1024 bytes when UTF-8 encoded.
bucket
Bucket
The bucket to which this blob belongs.
chunk_size
int
The size of a chunk of data whenever iterating (in bytes). This must be a multiple of 256 KB per the API specification.
[[["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-04 UTC."],[],[],null,["Version 1.19.0keyboard_arrow_down\n\n- [3.3.1 (latest)](/python/docs/reference/storage/latest/google.cloud.storage.blob)\n- [3.3.0](/python/docs/reference/storage/3.3.0/google.cloud.storage.blob)\n- [3.2.0](/python/docs/reference/storage/3.2.0/google.cloud.storage.blob)\n- [3.1.1](/python/docs/reference/storage/3.1.1/google.cloud.storage.blob)\n- [3.0.0](/python/docs/reference/storage/3.0.0/google.cloud.storage.blob)\n- [2.19.0](/python/docs/reference/storage/2.19.0/google.cloud.storage.blob)\n- [2.17.0](/python/docs/reference/storage/2.17.0/google.cloud.storage.blob)\n- [2.16.0](/python/docs/reference/storage/2.16.0/google.cloud.storage.blob)\n- [2.15.0](/python/docs/reference/storage/2.15.0/google.cloud.storage.blob)\n- [2.14.0](/python/docs/reference/storage/2.14.0/google.cloud.storage.blob)\n- [2.13.0](/python/docs/reference/storage/2.13.0/google.cloud.storage.blob)\n- [2.12.0](/python/docs/reference/storage/2.12.0/google.cloud.storage.blob)\n- [2.11.0](/python/docs/reference/storage/2.11.0/google.cloud.storage.blob)\n- [2.10.0](/python/docs/reference/storage/2.10.0/google.cloud.storage.blob)\n- [2.9.0](/python/docs/reference/storage/2.9.0/google.cloud.storage.blob)\n- [2.8.0](/python/docs/reference/storage/2.8.0/google.cloud.storage.blob)\n- [2.7.0](/python/docs/reference/storage/2.7.0/google.cloud.storage.blob)\n- [2.6.0](/python/docs/reference/storage/2.6.0/google.cloud.storage.blob)\n- [2.5.0](/python/docs/reference/storage/2.5.0/google.cloud.storage.blob)\n- [2.4.0](/python/docs/reference/storage/2.4.0/google.cloud.storage.blob)\n- [2.3.0](/python/docs/reference/storage/2.3.0/google.cloud.storage.blob)\n- [2.2.1](/python/docs/reference/storage/2.2.1/google.cloud.storage.blob)\n- [2.1.0](/python/docs/reference/storage/2.1.0/google.cloud.storage.blob)\n- [2.0.0](/python/docs/reference/storage/2.0.0/google.cloud.storage.blob)\n- [1.44.0](/python/docs/reference/storage/1.44.0/google.cloud.storage.blob)\n- [1.43.0](/python/docs/reference/storage/1.43.0/google.cloud.storage.blob)\n- [1.42.3](/python/docs/reference/storage/1.42.3/google.cloud.storage.blob)\n- [1.41.1](/python/docs/reference/storage/1.41.1/google.cloud.storage.blob)\n- [1.40.0](/python/docs/reference/storage/1.40.0/google.cloud.storage.blob)\n- [1.39.0](/python/docs/reference/storage/1.39.0/google.cloud.storage.blob)\n- [1.38.0](/python/docs/reference/storage/1.38.0/google.cloud.storage.blob)\n- [1.37.1](/python/docs/reference/storage/1.37.1/google.cloud.storage.blob)\n- [1.36.2](/python/docs/reference/storage/1.36.2/google.cloud.storage.blob)\n- [1.35.1](/python/docs/reference/storage/1.35.1/google.cloud.storage.blob)\n- [1.34.0](/python/docs/reference/storage/1.34.0/google.cloud.storage.blob)\n- [1.33.0](/python/docs/reference/storage/1.33.0/google.cloud.storage.blob)\n- [1.32.0](/python/docs/reference/storage/1.32.0/google.cloud.storage.blob)\n- [1.31.2](/python/docs/reference/storage/1.31.2/google.cloud.storage.blob)\n- [1.30.0](/python/docs/reference/storage/1.30.0/google.cloud.storage.blob)\n- [1.29.0](/python/docs/reference/storage/1.29.0/google.cloud.storage.blob)\n- [1.28.1](/python/docs/reference/storage/1.28.1/google.cloud.storage.blob)\n- [1.27.0](/python/docs/reference/storage/1.27.0/google.cloud.storage.blob)\n- [1.26.0](/python/docs/reference/storage/1.26.0/google.cloud.storage.blob)\n- [1.25.0](/python/docs/reference/storage/1.25.0/google.cloud.storage.blob)\n- [1.24.1](/python/docs/reference/storage/1.24.1/google.cloud.storage.blob)\n- [1.23.0](/python/docs/reference/storage/1.23.0/google.cloud.storage.blob)\n- [1.22.0](/python/docs/reference/storage/1.22.0/google.cloud.storage.blob)\n- [1.21.0](/python/docs/reference/storage/1.21.0/google.cloud.storage.blob)\n- [1.20.0](/python/docs/reference/storage/1.20.0/google.cloud.storage.blob)\n- [1.19.0](/python/docs/reference/storage/1.19.0/google.cloud.storage.blob)\n- [1.18.0](/python/docs/reference/storage/1.18.0/google.cloud.storage.blob)\n- [1.17.0](/python/docs/reference/storage/1.17.0/google.cloud.storage.blob) \nCreate / interact with Google Cloud Storage blobs.\n\n.. _API reference docs: \u003chttps://cloud.google.com/storage/docs/\u003e json_api/v1/objects\n.. _customer-supplied: \u003chttps://cloud.google.com/storage/docs/\u003e encryption#customer-supplied\n.. _google-resumable-media: \u003chttps://googleapis.github.io/\u003e google-resumable-media-python/latest/ google.resumable_media.requests.html\n\nClasses\n\n[Blob](/python/docs/reference/storage/1.19.0/google.cloud.storage.blob.Blob) \n\n Blob(\n name,\n bucket,\n chunk_size=None,\n encryption_key=None,\n kms_key_name=None,\n generation=None,\n )\n\nA wrapper around Cloud Storage's concept of an `Object`.\n\n| **Parameters** ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Name** | **Description** |\n| `name` | `str` The name of the blob. This corresponds to the unique path of the object in the bucket. If bytes, will be converted to a unicode object. Blob / object names can contain any sequence of valid unicode characters, of length 1-1024 bytes when UTF-8 encoded. |\n| `bucket` | Bucket The bucket to which this blob belongs. |\n| `chunk_size` | `int` The size of a chunk of data whenever iterating (in bytes). This must be a multiple of 256 KB per the API specification. |\n| `encryption_key` | `bytes` Optional 32 byte encryption key for customer-supplied encryption. See \u003chttps://cloud.google.com/storage/docs/encryption#customer-supplied\u003e. |\n| `kms_key_name` | `str` Optional resource name of Cloud KMS key used to encrypt the blob's contents. |"]]
