[[["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-07 UTC."],[],[],null,["# Buckets: lockRetentionPolicy\n\nPermanently locks the [retention policy](/storage/docs/bucket-lock) that is\ncurrently applied to the specified bucket.\n| **Caution** : Locking a bucket is an irreversible action. Once you lock a bucket:\n|\n| - You cannot remove the retention policy from the bucket.\n| - You cannot decrease the retention period for the policy.\n|\n| Once locked, you must delete the entire bucket in order to \"remove\" the bucket's\n| retention policy. However, before you can delete the bucket, you must be\n| able to delete all the objects in the bucket, which itself is only possible\n| if all the objects have reached the retention period set by the retention policy.\n\nRequired permissions\n--------------------\n\nThe authenticated user must have the `storage.buckets.update` IAM\npermission to use this method.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://storage.googleapis.com/storage/v1/b/bucket/lockRetentionPolicy\n```\n\nIn addition to [standard query parameters](/storage/docs/json_api/v1/parameters#query),\nthe following query parameters apply to this method.\n\nTo see an example of how to include query parameters in a request, see the\n[JSON API Overview](/storage/docs/json_api#query_parameters) page.\n\n### Parameters\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a [bucket\nresource](/storage/docs/json_api/v1/buckets#resource) in the response body.\n\nFor information about status and error codes returned by this API, see the\n[reference page](/storage/docs/json_api/v1/status-codes).\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
