GET Object
Use a GET object request to:
- Download an object
- List the uploaded parts of an object
- List object ACLs
- Get an object's encryption information
- Get an object's retention configuration
Youshould not use a GET object request to retrieve general object metadata,because doing so incurs charges associated with downloadingthe entire object. Use aHEAD object request instead.
To download an object you make a GET request that is scoped to a bucketand object. You can also use various request headers to further scope therequest. The request returns the object's contents in the response body. Tolist an object's ACLs you make a GET request that is scoped to a bucket andobject and you use theacl query string parameter. The ACLs arereturned in an XML document in the response body.
If you make a GET request for an object that doesn't exist, you get a404 Not Found statuscode and the body of the error response containsNoSuchKeyin theCode 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, seeRequest Endpoints. | Yes |
x-goog-user-project | The project to be billed for charges associated with the request. | No |
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-12-17 UTC.