When you call this API, the time to live (TTL) of data entries stops
resetting and data is evicted from the cache when the entry expires. During this
time, new data entries cannot be written to the cache, but existing data entries
can still be read from the cache. After being disabled for a 1-hour grace
period, the cache is deleted.
[[["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-26 UTC."],[],[],null,["# AnywhereCaches: disable\n\nDisables a [cache instance](/storage/docs/anywhere-cache)\nin a specified bucket.\n\nWhen you call this API, the time to live (TTL) of data entries stops\nresetting and data is evicted from the cache when the entry expires. During this\ntime, new data entries cannot be written to the cache, but existing data entries\ncan still be read from the cache. After being disabled for a 1-hour grace\nperiod, the cache is deleted.\n\nThe [`AnywhereCaches: resume` API](/storage/docs/json_api/v1/AnywhereCaches/resume)\ncan revoke the disablement during the 1-hour grace period.\n\nRequired permissions\n--------------------\n\nThe authenticated user must have the `storage.anywhereCaches.disable` IAM permission on the bucket to use this method.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://storage.googleapis.com/storage/v1/b/bucket/anywhereCaches/anywhereCacheID/disable\n```\n\nIn addition to [standard query parameters](/storage/docs/json_api/v1/parameters#query), the following parameters apply to this method.\n\n### Parameters\n\nTo see an example of how to include parameters in a request, see the\n[JSON API Overview](/storage/docs/json_api#query_parameters) page.\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns an\n[AnywhereCache resource](/storage/docs/json_api/v1/AnywhereCache#resource-representation)\nin the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]