If user_project is set, bills the API request to that project.
Note that this won't actually remove ALL the rules, but it
will remove all the non-default rules. In short, you'll still
have access to a bucket that you created even after you clear
ACL rules with this method.
Save this ACL for the current object using a predefined ACL.
If user_project is set, bills the API request to that project.
Parameters
Name
Description
predefined
str
An identifier for a predefined ACL. Must be one of the keys in PREDEFINED_JSON_ACLS or PREDEFINED_XML_ACLS (which will be aliased to the corresponding JSON name). If passed, acl must be None.
[[["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-08-12 UTC."],[],[],null,["# Class ObjectACL (3.3.0)\n\nVersion latestkeyboard_arrow_down\n\n- [3.3.0 (latest)](/python/docs/reference/storage/latest/google.cloud.storage.acl.ObjectACL)\n- [3.2.0](/python/docs/reference/storage/3.2.0/google.cloud.storage.acl.ObjectACL)\n- [3.1.1](/python/docs/reference/storage/3.1.1/google.cloud.storage.acl.ObjectACL)\n- [3.0.0](/python/docs/reference/storage/3.0.0/google.cloud.storage.acl.ObjectACL)\n- [2.19.0](/python/docs/reference/storage/2.19.0/google.cloud.storage.acl.ObjectACL)\n- [2.17.0](/python/docs/reference/storage/2.17.0/google.cloud.storage.acl.ObjectACL)\n- [2.16.0](/python/docs/reference/storage/2.16.0/google.cloud.storage.acl.ObjectACL)\n- [2.15.0](/python/docs/reference/storage/2.15.0/google.cloud.storage.acl.ObjectACL)\n- [2.14.0](/python/docs/reference/storage/2.14.0/google.cloud.storage.acl.ObjectACL)\n- [2.13.0](/python/docs/reference/storage/2.13.0/google.cloud.storage.acl.ObjectACL)\n- [2.12.0](/python/docs/reference/storage/2.12.0/google.cloud.storage.acl.ObjectACL)\n- [2.11.0](/python/docs/reference/storage/2.11.0/google.cloud.storage.acl.ObjectACL)\n- [2.10.0](/python/docs/reference/storage/2.10.0/google.cloud.storage.acl.ObjectACL)\n- [2.9.0](/python/docs/reference/storage/2.9.0/google.cloud.storage.acl.ObjectACL)\n- [2.8.0](/python/docs/reference/storage/2.8.0/google.cloud.storage.acl.ObjectACL)\n- [2.7.0](/python/docs/reference/storage/2.7.0/google.cloud.storage.acl.ObjectACL)\n- [2.6.0](/python/docs/reference/storage/2.6.0/google.cloud.storage.acl.ObjectACL)\n- [2.5.0](/python/docs/reference/storage/2.5.0/google.cloud.storage.acl.ObjectACL)\n- [2.4.0](/python/docs/reference/storage/2.4.0/google.cloud.storage.acl.ObjectACL)\n- [2.3.0](/python/docs/reference/storage/2.3.0/google.cloud.storage.acl.ObjectACL)\n- [2.2.1](/python/docs/reference/storage/2.2.1/google.cloud.storage.acl.ObjectACL)\n- [2.1.0](/python/docs/reference/storage/2.1.0/google.cloud.storage.acl.ObjectACL)\n- [2.0.0](/python/docs/reference/storage/2.0.0/google.cloud.storage.acl.ObjectACL)\n- [1.44.0](/python/docs/reference/storage/1.44.0/google.cloud.storage.acl.ObjectACL)\n- [1.43.0](/python/docs/reference/storage/1.43.0/google.cloud.storage.acl.ObjectACL)\n- [1.42.3](/python/docs/reference/storage/1.42.3/google.cloud.storage.acl.ObjectACL)\n- [1.41.1](/python/docs/reference/storage/1.41.1/google.cloud.storage.acl.ObjectACL)\n- [1.40.0](/python/docs/reference/storage/1.40.0/google.cloud.storage.acl.ObjectACL)\n- [1.39.0](/python/docs/reference/storage/1.39.0/google.cloud.storage.acl.ObjectACL)\n- [1.38.0](/python/docs/reference/storage/1.38.0/google.cloud.storage.acl.ObjectACL)\n- [1.37.1](/python/docs/reference/storage/1.37.1/google.cloud.storage.acl.ObjectACL)\n- [1.36.2](/python/docs/reference/storage/1.36.2/google.cloud.storage.acl.ObjectACL)\n- [1.35.1](/python/docs/reference/storage/1.35.1/google.cloud.storage.acl.ObjectACL)\n- [1.34.0](/python/docs/reference/storage/1.34.0/google.cloud.storage.acl.ObjectACL)\n- [1.33.0](/python/docs/reference/storage/1.33.0/google.cloud.storage.acl.ObjectACL)\n- [1.32.0](/python/docs/reference/storage/1.32.0/google.cloud.storage.acl.ObjectACL)\n- [1.31.2](/python/docs/reference/storage/1.31.2/google.cloud.storage.acl.ObjectACL)\n- [1.30.0](/python/docs/reference/storage/1.30.0/google.cloud.storage.acl.ObjectACL)\n- [1.29.0](/python/docs/reference/storage/1.29.0/google.cloud.storage.acl.ObjectACL)\n- [1.28.1](/python/docs/reference/storage/1.28.1/google.cloud.storage.acl.ObjectACL)\n- [1.27.0](/python/docs/reference/storage/1.27.0/google.cloud.storage.acl.ObjectACL)\n- [1.26.0](/python/docs/reference/storage/1.26.0/google.cloud.storage.acl.ObjectACL)\n- [1.25.0](/python/docs/reference/storage/1.25.0/google.cloud.storage.acl.ObjectACL)\n- [1.24.1](/python/docs/reference/storage/1.24.1/google.cloud.storage.acl.ObjectACL)\n- [1.23.0](/python/docs/reference/storage/1.23.0/google.cloud.storage.acl.ObjectACL)\n- [1.22.0](/python/docs/reference/storage/1.22.0/google.cloud.storage.acl.ObjectACL)\n- [1.21.0](/python/docs/reference/storage/1.21.0/google.cloud.storage.acl.ObjectACL)\n- [1.20.0](/python/docs/reference/storage/1.20.0/google.cloud.storage.acl.ObjectACL)\n- [1.19.0](/python/docs/reference/storage/1.19.0/google.cloud.storage.acl.ObjectACL)\n- [1.18.0](/python/docs/reference/storage/1.18.0/google.cloud.storage.acl.ObjectACL)\n- [1.17.0](/python/docs/reference/storage/1.17.0/google.cloud.storage.acl.ObjectACL) \n\n ObjectACL(blob)\n\nAn ACL specifically for a Cloud Storage object / blob.\n\nProperties\n----------\n\n### client\n\nThe client bound to this ACL's blob.\n\n### reload_path\n\nCompute the path for GET API requests for this ACL.\n\n### save_path\n\nCompute the path for PATCH API requests for this ACL.\n\n### user_project\n\nCompute the user project charged for API requests for this ACL.\n\nMethods\n-------\n\n### clear\n\n clear(client=None, if_generation_match=None, if_generation_not_match=None, if_metageneration_match=None, if_metageneration_not_match=None, timeout=60, retry=\u003cgoogle.api_core.retry.retry_unary.Retry object\u003e)\n\nRemove all ACL entries.\n\nIf `user_project` is set, bills the API request to that project.\n\nNote that this won't actually remove *ALL* the rules, but it\nwill remove all the non-default rules. In short, you'll still\nhave access to a bucket that you created even after you clear\nACL rules with this method.\n\n### save\n\n save(acl=None, client=None, if_generation_match=None, if_generation_not_match=None, if_metageneration_match=None, if_metageneration_not_match=None, timeout=60, retry=\u003cgoogle.api_core.retry.retry_unary.Retry object\u003e)\n\nSave this ACL for the current object.\n\nIf `user_project` is set, bills the API request to that project.\n\n### save_predefined\n\n save_predefined(predefined, client=None, if_generation_match=None, if_generation_not_match=None, if_metageneration_match=None, if_metageneration_not_match=None, timeout=60, retry=\u003cgoogle.api_core.retry.retry_unary.Retry object\u003e)\n\nSave this ACL for the current object using a predefined ACL.\n\nIf `user_project` is set, bills the API request to that project."]]