Updates the state of an HMAC key. See the HMAC Key resource descriptor for valid states. Try it now.
The authenticated user must have storage.hmacKeys.update permission for the project
in which the key exists.
For general information about HMAC keys in Cloud Storage, see HMAC Keys.
Request
HTTP request
PUT https://storage.googleapis.com/storage/v1/projects/projectId/hmacKeys/accessId
In addition to standard query parameters, the following query parameters apply to this method:
Parameters
| Parameter name | Value | Description |
|---|---|---|
| Path parameters | ||
accessId |
string |
The access ID of the HMAC key being updated. |
projectId |
string |
The project ID of the project that owns the service account of the specified HMAC key. |
Request body
In the request body, supply the metadata portion of a Projects.hmacKeys resource with the following properties:
| Property name | Value | Description | Notes |
|---|---|---|---|
| Optional Properties | |||
etag |
string |
HTTP 1.1 Entity tag for the HMAC key. Inclusion of an etag makes the operation's success conditional on the HMAC key's current etag matching the given value. | |
state |
string |
The state of the key. Can be updated to ACTIVE or INACTIVE. To set the state of the key to DELETED, use the `hmacKeys.delete` method. | writable |
Response
If successful, this method returns the metadata portion of a Projects.hmacKeys resource in the response body.
Try it!
Use the APIs Explorer below to call this method on live data and see the response.