GET Object

Use a GET object request to:

You should not use a GET object request to retrieve general object metadata, because doing so incurs charges associated with downloading the entire object. Use a HEAD object request instead.

To download an object you make a GET request that is scoped to a bucket and object. You can also use various request headers to further scope the request. The request returns the object's contents in the response body. To list an object's ACLs you make a GET request that is scoped to a bucket and object and you use the acl query string parameter. The ACLs are returned in an XML document in the response body.

If you make a GET request for an object that doesn't exist, you get a 404 Not Found status code and the body of the error response contains NoSuchKey in the Code element.

Common request headers

The following are common request headers for GET object requests.

Header Description Required
Authorization The authentication string for the request. Required for objects without public read access. Maybe
Host The URI for Cloud Storage. For more information, see Request Endpoints. Yes
x-goog-user-project The project to be billed for charges associated with the request. No