| Index: third_party/gsutil/gslib/addlhelp/metadata.py
|
| diff --git a/third_party/gsutil/gslib/addlhelp/metadata.py b/third_party/gsutil/gslib/addlhelp/metadata.py
|
| index f0b547fd1bf441dcf0e4c48f44009dc4b6765810..60f64714da9ace77d352c56d6bd39ee8275bc327 100644
|
| --- a/third_party/gsutil/gslib/addlhelp/metadata.py
|
| +++ b/third_party/gsutil/gslib/addlhelp/metadata.py
|
| @@ -85,7 +85,7 @@ _DETAILED_HELP_TEXT = ("""
|
| allowed to cache your objects. Cache-Control only applies to objects with
|
| a public-read ACL. Non-public data are not cacheable.
|
|
|
| - Here's an example of uploading an object set to allow caching:
|
| + Here's an example of uploading a set of objects to allow caching:
|
|
|
| gsutil -h "Cache-Control:public,max-age=3600" cp -a public-read \\
|
| -r html gs://bucket/html
|
| @@ -98,7 +98,11 @@ _DETAILED_HELP_TEXT = ("""
|
| of objects after uploading a newer replacement object. Note also that because
|
| objects can be cached at various places on the Internet there is no way to
|
| force a cached object to expire globally (unlike the way you can force your
|
| - browser to refresh its cache).
|
| + browser to refresh its cache). If you want to prevent caching of publicly
|
| + readable objects you should set a Cache-Control:private header on the object.
|
| + You can do this with a command such as:
|
| +
|
| + gsutil -h Cache-Control:private cp -a public-read file.png gs://your-bucket
|
|
|
| Another use of the Cache-Control header is through the "no-transform" value,
|
| which instructs Google Cloud Storage to not apply any content transformations
|
| @@ -107,14 +111,6 @@ _DETAILED_HELP_TEXT = ("""
|
| respected by the XML API. The Google Cloud Storage JSON API respects only the
|
| no-cache and max-age Cache-Control parameters.
|
|
|
| - Note that if you upload an object with a public-read ACL and don't include a
|
| - Cache-Control header, it will be served with a Cache-Control header allowing
|
| - the object to be cached for 3600 seconds. This will not happen if the object
|
| - is uploaded with a non-public ACL and then changed to public. Moreover, if you
|
| - upload an object with a public-read ACL and later change the ACL not to be
|
| - public-read, the object will no longer be served with the default
|
| - Cache-Control header noted above (so will be served as not cacheable).
|
| -
|
| For details about how to set the Cache-Control header see
|
| "gsutil help setmeta".
|
|
|
|
|