Stay organized with collectionsSave and categorize content based on your preferences.
To update the state of an HMAC key for the specified service account, make aPOSTrequest
that is scoped to a project. The authenticated user must havestorage.hmacKeys.updatepermission for the project in which the key will be updated.
For general information about HMAC keys in Cloud Storage, seeHMAC Keys.
HTTP Request
POST https://storage.googleapis.com/?Action=UpdateAccessKey&AccessKeyId=AccessKeyId&Status=Status
Query string parameters
Parameter
Description
Required
Action
The HMAC key operation to be performed.
Yes
AccessKeyId
Access Key ID for the HMAC key.
Yes
Status
Update the status of this HMAC key. Valid values are:
Active: This key can be used to sign requests.
Inactive: Requests signed with this key will be denied.
Yes
UserName
The email address of a service account in the project. This is only used to
validate that the specified service account owns the key before updating.
The service account owner of a key cannot be updated.
[[["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,["# Update an HMAC key\n\nTo update the state of an HMAC key for the specified service account, make a `POST` request\nthat is scoped to a project. The authenticated user must have\n`storage.hmacKeys.update` permission for the project in which the key will be updated.\n\nFor general information about HMAC keys in Cloud Storage, see\n[HMAC Keys](/storage/docs/authentication/hmackeys).\n\nHTTP Request\n------------\n\n```\nPOST https://storage.googleapis.com/?Action=UpdateAccessKey&AccessKeyId=AccessKeyId&Status=Status\n```\n\n### Query string parameters\n\nRequest headers\n---------------\n\nUse the [common request headers](/storage/docs/xml-api/post-hmac-key#request-headers).\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure: \n\n```\n\u003cUpdateAccessKeyResponse\u003e\n \u003cResponseMetadata\u003e\n \u003cRequestId\u003eEXAMPLE-REQUEST-ID\u003c/RequestId\u003e\n \u003c/ResponseMetadata\u003e\n\u003c/UpdateAccessKeyResponse\u003e\n```"]]
