(Optional) Defaults to True. If True, instead of adding exceptions to the list of return responses, the final exception will be raised. Note that exceptions are unwrapped after all operations are complete in success or failure, and only the last exception is raised.
Methods
current
current()
Return the topmost batch, or None.
finish
finish(raise_exception=True)
Submit a singlemultipart/mixedrequest with deferred requests.
Parameter
Name
Description
raise_exception
bool
(Optional) Defaults to True. If True, instead of adding exceptions to the list of return responses, the final exception will be raised. Note that exceptions are unwrapped after all operations are complete in success or failure, and only the last exception is raised.
[[["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,["# Class Batch (3.3.0)\n\nVersion latestkeyboard_arrow_down\n\n- [3.3.0 (latest)](/python/docs/reference/storage/latest/google.cloud.storage.batch.Batch)\n- [3.2.0](/python/docs/reference/storage/3.2.0/google.cloud.storage.batch.Batch)\n- [3.1.1](/python/docs/reference/storage/3.1.1/google.cloud.storage.batch.Batch)\n- [3.0.0](/python/docs/reference/storage/3.0.0/google.cloud.storage.batch.Batch)\n- [2.19.0](/python/docs/reference/storage/2.19.0/google.cloud.storage.batch.Batch)\n- [2.17.0](/python/docs/reference/storage/2.17.0/google.cloud.storage.batch.Batch)\n- [2.16.0](/python/docs/reference/storage/2.16.0/google.cloud.storage.batch.Batch)\n- [2.15.0](/python/docs/reference/storage/2.15.0/google.cloud.storage.batch.Batch)\n- [2.14.0](/python/docs/reference/storage/2.14.0/google.cloud.storage.batch.Batch)\n- [2.13.0](/python/docs/reference/storage/2.13.0/google.cloud.storage.batch.Batch)\n- [2.12.0](/python/docs/reference/storage/2.12.0/google.cloud.storage.batch.Batch)\n- [2.11.0](/python/docs/reference/storage/2.11.0/google.cloud.storage.batch.Batch)\n- [2.10.0](/python/docs/reference/storage/2.10.0/google.cloud.storage.batch.Batch)\n- [2.9.0](/python/docs/reference/storage/2.9.0/google.cloud.storage.batch.Batch)\n- [2.8.0](/python/docs/reference/storage/2.8.0/google.cloud.storage.batch.Batch)\n- [2.7.0](/python/docs/reference/storage/2.7.0/google.cloud.storage.batch.Batch)\n- [2.6.0](/python/docs/reference/storage/2.6.0/google.cloud.storage.batch.Batch)\n- [2.5.0](/python/docs/reference/storage/2.5.0/google.cloud.storage.batch.Batch)\n- [2.4.0](/python/docs/reference/storage/2.4.0/google.cloud.storage.batch.Batch)\n- [2.3.0](/python/docs/reference/storage/2.3.0/google.cloud.storage.batch.Batch)\n- [2.2.1](/python/docs/reference/storage/2.2.1/google.cloud.storage.batch.Batch)\n- [2.1.0](/python/docs/reference/storage/2.1.0/google.cloud.storage.batch.Batch)\n- [2.0.0](/python/docs/reference/storage/2.0.0/google.cloud.storage.batch.Batch)\n- [1.44.0](/python/docs/reference/storage/1.44.0/google.cloud.storage.batch.Batch)\n- [1.43.0](/python/docs/reference/storage/1.43.0/google.cloud.storage.batch.Batch)\n- [1.42.3](/python/docs/reference/storage/1.42.3/google.cloud.storage.batch.Batch)\n- [1.41.1](/python/docs/reference/storage/1.41.1/google.cloud.storage.batch.Batch)\n- [1.40.0](/python/docs/reference/storage/1.40.0/google.cloud.storage.batch.Batch)\n- [1.39.0](/python/docs/reference/storage/1.39.0/google.cloud.storage.batch.Batch)\n- [1.38.0](/python/docs/reference/storage/1.38.0/google.cloud.storage.batch.Batch)\n- [1.37.1](/python/docs/reference/storage/1.37.1/google.cloud.storage.batch.Batch)\n- [1.36.2](/python/docs/reference/storage/1.36.2/google.cloud.storage.batch.Batch)\n- [1.35.1](/python/docs/reference/storage/1.35.1/google.cloud.storage.batch.Batch)\n- [1.34.0](/python/docs/reference/storage/1.34.0/google.cloud.storage.batch.Batch)\n- [1.33.0](/python/docs/reference/storage/1.33.0/google.cloud.storage.batch.Batch)\n- [1.32.0](/python/docs/reference/storage/1.32.0/google.cloud.storage.batch.Batch)\n- [1.31.2](/python/docs/reference/storage/1.31.2/google.cloud.storage.batch.Batch)\n- [1.30.0](/python/docs/reference/storage/1.30.0/google.cloud.storage.batch.Batch)\n- [1.29.0](/python/docs/reference/storage/1.29.0/google.cloud.storage.batch.Batch)\n- [1.28.1](/python/docs/reference/storage/1.28.1/google.cloud.storage.batch.Batch)\n- [1.27.0](/python/docs/reference/storage/1.27.0/google.cloud.storage.batch.Batch)\n- [1.26.0](/python/docs/reference/storage/1.26.0/google.cloud.storage.batch.Batch)\n- [1.25.0](/python/docs/reference/storage/1.25.0/google.cloud.storage.batch.Batch)\n- [1.24.1](/python/docs/reference/storage/1.24.1/google.cloud.storage.batch.Batch)\n- [1.23.0](/python/docs/reference/storage/1.23.0/google.cloud.storage.batch.Batch)\n- [1.22.0](/python/docs/reference/storage/1.22.0/google.cloud.storage.batch.Batch)\n- [1.21.0](/python/docs/reference/storage/1.21.0/google.cloud.storage.batch.Batch)\n- [1.20.0](/python/docs/reference/storage/1.20.0/google.cloud.storage.batch.Batch)\n- [1.19.0](/python/docs/reference/storage/1.19.0/google.cloud.storage.batch.Batch)\n- [1.18.0](/python/docs/reference/storage/1.18.0/google.cloud.storage.batch.Batch)\n- [1.17.0](/python/docs/reference/storage/1.17.0/google.cloud.storage.batch.Batch) \n\n Batch(client, raise_exception=True)\n\nProxy an underlying connection, batching up change operations.\n| **Warning:** Cloud Storage does not support batch operations for uploading or downloading. Additionally, the current batch design does not support library methods whose return values depend on the response payload.\n\nMethods\n-------\n\n### current\n\n current()\n\nReturn the topmost batch, or None.\n\n### finish\n\n finish(raise_exception=True)\n\nSubmit a single `multipart/mixed` request with deferred requests."]]