Updates a data blob's associated metadata. Try it now .
The invoking user must have either
FULL_CONTROL
of the object or
WRITE
permission on the
bucket
.
Request
HTTP request
PUT https://www.googleapis.com/storage/v1beta2/b/bucket/o/object
Parameters
| Parameter name | Value | Description |
|---|---|---|
| Path parameters | ||
bucket
|
string
|
Name of the bucket in which the object resides. |
object
|
string
|
Name of the object. |
| Optional query parameters | ||
generation
|
unsigned long
|
If present, selects a specific revision of this object (as opposed to the latest version, the default). |
ifGenerationMatch
|
unsigned long
|
Makes the operation conditional on whether the object's current generation matches the given value. |
ifGenerationNotMatch
|
unsigned long
|
Makes the operation conditional on whether the object's current generation does not match the given value. |
ifMetagenerationMatch
|
unsigned long
|
Makes the operation conditional on whether the object's current metageneration matches the given value. |
ifMetagenerationNotMatch
|
unsigned long
|
Makes the operation conditional on whether the object's current metageneration does not match the given value. |
projection
|
string
|
Set of properties to return. Defaults to
full
.
Acceptable values are:
|
Request body
In the request body, supply an object resource with the following properties:
| Property name | Value | Description | Notes |
|---|---|---|---|
| Required Properties | |||
acl[]
|
list
|
Access controls on the object. | writable |
contentType
|
string
|
Content-Type of the object data. | writable |
| Optional Properties | |||
cacheControl
|
string
|
Cache-Control directive for the object data. | writable |
contentDisposition
|
string
|
Content-Disposition of the object data. | writable |
contentEncoding
|
string
|
Content-Encoding of the object data. | writable |
contentLanguage
|
string
|
Content-Language of the object data. | writable |
metadata
|
object
|
User-provided metadata, in key/value pairs. | writable |
metadata.
(key)
|
string
|
An individual metadata entry. | writable |
Response
By default, this responds with an
object resource
in the response body. If you provide the URL parameter
alt=media
, then it will respond with the object data in the response body. If you use
alt=media
, then you can use the
Range
HTTP header to specify the portion of the object you wish to retrieve.
Try it!
Use the APIs Explorer below to call this method on live data and see the response. Alternatively, try the standalone Explorer .