Send feedback
Module blob (3.3.1) Stay organized with collections
Save and categorize content based on your preferences.
Version latest keyboard_arrow_down
Create / interact with Google Cloud Storage blobs.
Classes
Blob
(
name
,
bucket
,
chunk_size
=
None
,
encryption_key
=
None
,
kms_key_name
=
None
,
generation
=
None
,
crc32c_checksum
=
None
,
)
A wrapper around Cloud Storage's concept of an Object
.
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
(Optional) The size of a chunk of data whenever iterating (in bytes). This must be a multiple of 256 KB per the API specification. If not specified, the chunk_size of the blob itself is used. If that is not specified, a default value of 40 MB is used.
kms_key_name
str
(Optional) Resource name of Cloud KMS key used to encrypt the blob's contents.
generation
long
(Optional) If present, selects a specific revision of this object.
Retention
(
blob
,
mode
=
None
,
retain_until_time
=
None
,
retention_expiration_time
=
None
)
Map an object's retention configuration.
Send feedback
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-04 UTC.
Need to tell us more?
[[["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,["# Module blob (3.3.0)\n\nVersion latestkeyboard_arrow_down\n\n- [3.3.0 (latest)](/python/docs/reference/storage/latest/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\nClasses\n-------\n\n### [Blob](/python/docs/reference/storage/latest/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### [Retention](/python/docs/reference/storage/latest/google.cloud.storage.blob.Retention)\n\n Retention(blob, mode=None, retain_until_time=None, retention_expiration_time=None)\n\nMap an object's retention configuration."]]
