Enable and use object retention configurations | Cloud Storage

<!doctype html> <html lang="en" dir="ltr"> <head> <meta name="google-signin-client-id" content="721724668570-nbkv1cfusk7kk4eni4pjvepaus73b13t.apps.googleusercontent.com"> <meta name="google-signin-scope" content="profile email https://www.googleapis.com/auth/developerprofiles https://www.googleapis.com/auth/developerprofiles.award https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/webhistory"> <meta property="og:site_name" content="Google Cloud"> <meta property="og:type" content="website"><meta name="theme-color" content="#039be5"><meta charset="utf-8"> <meta content="IE=Edge" http-equiv="X-UA-Compatible"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="manifest" href="/_pwa/cloud/manifest.json" crossorigin="use-credentials"> <link rel="preconnect" href="//www.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.googleapis.com" crossorigin> <link rel="preconnect" href="//apis.google.com" crossorigin> <link rel="preconnect" href="//www.google-analytics.com" crossorigin><link rel="stylesheet" href="//fonts.googleapis.com/css?family=Google+Sans:400,500,700|Google+Sans+Text:400,400italic,500,500italic,700,700italic|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"> <link rel="stylesheet" href="//fonts.googleapis.com/css2?family=Material+Icons&family=Material+Symbols+Outlined&display=block"><link rel="stylesheet" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/cloud/css/app.css"> <link rel="shortcut icon" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/cloud/images/favicons/onecloud/favicon.ico"> <link rel="apple-touch-icon" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/cloud/images/favicons/onecloud/super_cloud.png"><link rel="canonical" href="https://cloud.google.com/storage/docs/using-object-lock"><link rel="search" type="application/opensearchdescription+xml" title="Google Cloud" href="https://cloud.google.com/s/opensearch.xml"> <link rel="alternate" hreflang="en" href="https://cloud.google.com/storage/docs/using-object-lock" /><link rel="alternate" hreflang="x-default" href="https://cloud.google.com/storage/docs/using-object-lock" /><link rel="alternate" hreflang="zh-Hans" href="https://cloud.google.com/storage/docs/using-object-lock?hl=zh-cn" /><link rel="alternate" hreflang="fr" href="https://cloud.google.com/storage/docs/using-object-lock?hl=fr" /><link rel="alternate" hreflang="de" href="https://cloud.google.com/storage/docs/using-object-lock?hl=de" /><link rel="alternate" hreflang="id" href="https://cloud.google.com/storage/docs/using-object-lock?hl=id" /><link rel="alternate" hreflang="it" href="https://cloud.google.com/storage/docs/using-object-lock?hl=it" /><link rel="alternate" hreflang="ja" href="https://cloud.google.com/storage/docs/using-object-lock?hl=ja" /><link rel="alternate" hreflang="ko" href="https://cloud.google.com/storage/docs/using-object-lock?hl=ko" /><link rel="alternate" hreflang="pt-BR" href="https://cloud.google.com/storage/docs/using-object-lock?hl=pt-br" /><link rel="alternate" hreflang="es-419" href="https://cloud.google.com/storage/docs/using-object-lock?hl=es-419" /><title>Enable and use object retention configurations  |  Cloud Storage  |  Google Cloud</title> <meta property="og:title" content="Enable and use object retention configurations  |  Cloud Storage  |  Google Cloud"><meta property="og:url" content="https://cloud.google.com/storage/docs/using-object-lock"><meta property="og:image" content="https://cloud.google.com/_static/cloud/images/social-icon-google-cloud-1200-630.png"> <meta property="og:image:width" content="1200"> <meta property="og:image:height" content="630"><meta property="og:locale" content="en"><meta name="twitter:card" content="summary_large_image"><script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Article", "headline": "Enable and use object retention configurations" } </script><script type="application/ld+json"> { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [{ "@type": "ListItem", "position": 1, "name": "Cloud Storage", "item": "https://cloud.google.com/storage" },{ "@type": "ListItem", "position": 2, "name": "Documentation", "item": "https://cloud.google.com/storage/docs" },{ "@type": "ListItem", "position": 3, "name": "Enable and use object retention configurations", "item": "https://cloud.google.com/storage/docs/using-object-lock" }] } </script> <link rel="stylesheet" href="/extras.css"></head> <body class="" template="page" theme="cloud-theme" type="article" layout="docs" free-trial display-toc pending> <devsite-progress type="indeterminate" id="app-progress"></devsite-progress> <section class="devsite-wrapper"> <devsite-cookie-notification-bar></devsite-cookie-notification-bar><cloudx-track userCountry="SG"></cloudx-track> <cloudx-utils-init></cloudx-utils-init> <devsite-header keep-tabs-visible> <div class="devsite-header--inner nocontent"> <div class="devsite-top-logo-row-wrapper-wrapper"> <div class="devsite-top-logo-row-wrapper"> <div class="devsite-top-logo-row"> <button type="button" id="devsite-hamburger-menu" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Navigation menu button" visually-hidden aria-label="Open menu"> </button> <div class="devsite-product-name-wrapper"> <a href="/" class="devsite-site-logo-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Site logo" track-type="globalNav" track-name="googleCloud" track-metadata-position="nav" track-metadata-eventDetail="nav"> <picture> <img src="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/cloud/images/cloud-logo.svg" class="devsite-site-logo" alt="Google Cloud"> </picture> </a> <ul class="devsite-breadcrumb-list" > <li class="devsite-breadcrumb-item devsite-has-google-wordmark"> </li> </ul> </div> <div class="devsite-top-logo-row-middle"> <div class="devsite-header-upper-tabs"> <cloudx-tabs-nav class="upper-tabs"> <nav class="devsite-tabs-wrapper" aria-label="Upper tabs"> <tab class="devsite-active"> <a href="https://cloud.google.com/docs" track-metadata-eventdetail="https://cloud.google.com/docs" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - docs-home" track-metadata-module="primary nav" aria-label="Documentation, selected" data-category="Site-Wide Custom Events" data-label="Tab: Documentation" track-name="docs-home" track-link-column-type="single-column" > Documentation </a> </tab> <tab class="devsite-dropdown devsite-clickable "> <a href="https://cloud.google.com/docs/tech-area-overviews" track-metadata-eventdetail="https://cloud.google.com/docs/tech-area-overviews" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - technology-areas" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Technology areas" track-name="technology-areas" track-link-column-type="single-column" > Technology areas </a> <a href="#" role="button" aria-haspopup="true" aria-expanded="false" aria-label="Dropdown menu for Technology areas" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/tech-area-overviews" track-metadata-position="nav - technology-areas" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Technology areas" track-name="technology-areas" track-link-column-type="single-column" class="devsite-tabs-dropdown-toggle devsite-icon devsite-icon-arrow-drop-down"></a> <div class="devsite-tabs-dropdown" aria-label="submenu" hidden> <button class="devsite-tabs-close-button material-icons button-flat gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Close dropdown menu" aria-label="Close dropdown menu" track-type="nav" track-name="close" track-metadata-eventdetail="#" track-metadata-position="nav - technology-areas" track-metadata-module="tertiary nav">close</button> <div class="devsite-tabs-dropdown-content"> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section "> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/ai-ml" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/ai-ml" track-metadata-position="nav - technology-areas" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> AI and ML </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/application-development" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/application-development" track-metadata-position="nav - technology-areas" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Application development </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/application-hosting" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/application-hosting" track-metadata-position="nav - technology-areas" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Application hosting </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/compute-area" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/compute-area" track-metadata-position="nav - technology-areas" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Compute </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/data" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/data" track-metadata-position="nav - technology-areas" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Data analytics and pipelines </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/databases" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/databases" track-metadata-position="nav - technology-areas" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Databases </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/dhm-cloud" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/dhm-cloud" track-metadata-position="nav - technology-areas" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Distributed, hybrid, and multicloud </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/generative-ai" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/generative-ai" track-metadata-position="nav - technology-areas" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Generative AI </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/industry" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/industry" track-metadata-position="nav - technology-areas" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Industry solutions </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/networking" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/networking" track-metadata-position="nav - technology-areas" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Networking </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/observability" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/observability" track-metadata-position="nav - technology-areas" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Observability and monitoring </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/security" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/security" track-metadata-position="nav - technology-areas" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Security </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/storage" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/storage" track-metadata-position="nav - technology-areas" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Storage </div> </a> </li> </ul> </div> </div> </div> </tab> <tab class="devsite-dropdown devsite-clickable "> <a href="https://cloud.google.com/docs/cross-product-overviews" track-metadata-eventdetail="https://cloud.google.com/docs/cross-product-overviews" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - crossproduct" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Cross-product tools" track-name="crossproduct" track-link-column-type="single-column" > Cross-product tools </a> <a href="#" role="button" aria-haspopup="true" aria-expanded="false" aria-label="Dropdown menu for Cross-product tools" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/cross-product-overviews" track-metadata-position="nav - crossproduct" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Cross-product tools" track-name="crossproduct" track-link-column-type="single-column" class="devsite-tabs-dropdown-toggle devsite-icon devsite-icon-arrow-drop-down"></a> <div class="devsite-tabs-dropdown" aria-label="submenu" hidden> <button class="devsite-tabs-close-button material-icons button-flat gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Close dropdown menu" aria-label="Close dropdown menu" track-type="nav" track-name="close" track-metadata-eventdetail="#" track-metadata-position="nav - crossproduct" track-metadata-module="tertiary nav">close</button> <div class="devsite-tabs-dropdown-content"> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section "> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/access-resources" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/access-resources" track-metadata-position="nav - crossproduct" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Access and resources management </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/costs-usage" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/costs-usage" track-metadata-position="nav - crossproduct" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Costs and usage management </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/devtools" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/devtools" track-metadata-position="nav - crossproduct" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Google Cloud SDK, languages, frameworks, and tools </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/iac" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/iac" track-metadata-position="nav - crossproduct" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Infrastructure as code </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/docs/migration" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/docs/migration" track-metadata-position="nav - crossproduct" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Migration </div> </a> </li> </ul> </div> </div> </div> </tab> <tab class="devsite-dropdown devsite-clickable "> <a href="https://cloud.google.com/" track-metadata-eventdetail="https://cloud.google.com/" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - related-sites" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Related sites" track-name="related-sites" track-link-column-type="single-column" > Related sites </a> <a href="#" role="button" aria-haspopup="true" aria-expanded="false" aria-label="Dropdown menu for Related sites" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/" track-metadata-position="nav - related-sites" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Related sites" track-name="related-sites" track-link-column-type="single-column" class="devsite-tabs-dropdown-toggle devsite-icon devsite-icon-arrow-drop-down"></a> <div class="devsite-tabs-dropdown" aria-label="submenu" hidden> <button class="devsite-tabs-close-button material-icons button-flat gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Close dropdown menu" aria-label="Close dropdown menu" track-type="nav" track-name="close" track-metadata-eventdetail="#" track-metadata-position="nav - related-sites" track-metadata-module="tertiary nav">close</button> <div class="devsite-tabs-dropdown-content"> <div class="devsite-tabs-dropdown-column "> <ul class="devsite-tabs-dropdown-section "> <li class="devsite-nav-item"> <a href="https://cloud.google.com/" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/" track-metadata-position="nav - related-sites" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Google Cloud Home </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/free" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/free" track-metadata-position="nav - related-sites" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Free Trial and Free Tier </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/architecture" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/architecture" track-metadata-position="nav - related-sites" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Architecture Center </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/blog" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/blog" track-metadata-position="nav - related-sites" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Blog </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/contact" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/contact" track-metadata-position="nav - related-sites" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Contact Sales </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/developers" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/developers" track-metadata-position="nav - related-sites" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Google Cloud Developer Center </div> </a> </li> <li class="devsite-nav-item"> <a href="https://developers.google.com/" track-type="nav" track-metadata-eventdetail="https://developers.google.com/" track-metadata-position="nav - related-sites" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Google Developer Center </div> </a> </li> <li class="devsite-nav-item"> <a href="https://console.cloud.google.com/marketplace" track-type="nav" track-metadata-eventdetail="https://console.cloud.google.com/marketplace" track-metadata-position="nav - related-sites" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Google Cloud Marketplace </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/marketplace/docs" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/marketplace/docs" track-metadata-position="nav - related-sites" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Google Cloud Marketplace Documentation </div> </a> </li> <li class="devsite-nav-item"> <a href="https://www.cloudskillsboost.google/paths" track-type="nav" track-metadata-eventdetail="https://www.cloudskillsboost.google/paths" track-metadata-position="nav - related-sites" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Google Cloud Skills Boost </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/solutions" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/solutions" track-metadata-position="nav - related-sites" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Google Cloud Solution Center </div> </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/support-hub" track-type="nav" track-metadata-eventdetail="https://cloud.google.com/support-hub" track-metadata-position="nav - related-sites" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Google Cloud Support </div> </a> </li> <li class="devsite-nav-item"> <a href="https://www.youtube.com/@googlecloudtech" track-type="nav" track-metadata-eventdetail="https://www.youtube.com/@googlecloudtech" track-metadata-position="nav - related-sites" track-metadata-module="tertiary nav" tooltip > <div class="devsite-nav-item-title"> Google Cloud Tech Youtube Channel </div> </a> </li> </ul> </div> </div> </div> </tab> </nav> </cloudx-tabs-nav> </div> <devsite-search enable-signin enable-search enable-suggestions project-name="Cloud Storage" tenant-name="Google Cloud" project-scope="/storage/docs" url-scoped="https://cloud.google.com/s/results/storage/docs" > <form class="devsite-search-form" action="https://cloud.google.com/s/results" method="GET"> <div class="devsite-search-container"> <button type="button" search-open class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Open search"></button> <div class="devsite-searchbox"> <input aria-activedescendant="" aria-autocomplete="list" aria-label="Search" aria-expanded="false" aria-haspopup="listbox" autocomplete="off" class="devsite-search-field devsite-search-query" name="q" placeholder="Search" role="combobox" type="text" value="" > <div class="devsite-search-image material-icons" aria-hidden="true"> </div> <div class="devsite-search-shortcut-icon-container" aria-hidden="true"> <kbd class="devsite-search-shortcut-icon">/</kbd> </div> </div> </div> </form> <button type="button" search-close class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Close search"></button> </devsite-search> </div> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> <devsite-user enable-profiles fp-auth id="devsite-user"> Sign in </devsite-user> </div> </div> </div> <div class="devsite-collapsible-section "> <div class="devsite-header-background"> <div class="devsite-product-id-row" hidden> <div class="devsite-product-description-row"> </div> </div> <div class="devsite-doc-set-nav-row"> <ul class="devsite-breadcrumb-list" > <li class="devsite-breadcrumb-item "> <a href="https://cloud.google.com/storage" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Lower Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="Cloud Storage" > Cloud Storage </a> </li> </ul> <cloudx-tabs-nav class="lower-tabs"> <nav class="devsite-tabs-wrapper" aria-label="Lower tabs"> <tab class="devsite-active"> <a href="https://cloud.google.com/storage/docs/discover-object-storage-console" track-metadata-eventdetail="https://cloud.google.com/storage/docs/discover-object-storage-console" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - guides" track-metadata-module="primary nav" aria-label="Guides, selected" data-category="Site-Wide Custom Events" data-label="Tab: Guides" track-name="guides" > Guides </a> </tab> <tab > <a href="https://cloud.google.com/storage/docs/apis" track-metadata-eventdetail="https://cloud.google.com/storage/docs/apis" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - reference" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Reference" track-name="reference" > Reference </a> </tab> <tab > <a href="https://cloud.google.com/storage/docs/samples" track-metadata-eventdetail="https://cloud.google.com/storage/docs/samples" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - samples" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Samples" track-name="samples" > Samples </a> </tab> <tab > <a href="https://cloud.google.com/storage/docs/resources" track-metadata-eventdetail="https://cloud.google.com/storage/docs/resources" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - resources" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Resources" track-name="resources" > Resources </a> </tab> </nav> </cloudx-tabs-nav> <div class="devsite-product-button-row"> <a href="https://cloud.google.com/contact" class="cta-button-secondary button " data-overflow-container="left" track-type="contact" track-name="sales" data-overflow="devsite-tabs-wrapper" data-overflow-wrapper="tab" track-metadata-position="nav" track-metadata-eventDetail="nav" >Contact Us</a> <a href="//console.cloud.google.com/freetrial" class="cloud-free-trial-button cta-button-primary button-primary button cloud-button cloud-button--primary " track-type="freeTrial" track-metadata-eventDetail="nav" data-overflow-class="devsite-header-link devsite-top-button button cloud-free-trial-button cloud-free-trial-enabled cloud-button cloud-button--primary" track-name="gcpCta" referrerpolicy="no-referrer-when-downgrade" track-metadata-position="nav" data-overflow="devsite-top-logo-row" data-overflow-container="right" >Start free</a> </div> </div> </div> </div> </div> </devsite-header> <devsite-book-nav scrollbars > <div class="devsite-book-nav-filter" > <input type="text" placeholder="Filter" aria-label="Type to filter" role="searchbox"> </div> <nav class="devsite-book-nav devsite-nav nocontent" aria-label="Side menu"> <div class="devsite-mobile-header"> <button type="button" id="devsite-close-nav" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Close navigation" aria-label="Close navigation"> </button> <div class="devsite-product-name-wrapper"> <a href="/" class="devsite-site-logo-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Site logo" track-type="globalNav" track-name="googleCloud" track-metadata-position="nav" track-metadata-eventDetail="nav"> <picture> <img src="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/cloud/images/cloud-logo.svg" class="devsite-site-logo" alt="Google Cloud"> </picture> </a> <ul class="devsite-breadcrumb-list" > <li class="devsite-breadcrumb-item devsite-has-google-wordmark"> </li> </ul> </div> </div> <div class="devsite-book-nav-wrapper"> <div class="devsite-mobile-nav-top"> <ul class="devsite-nav-list"> <li class="devsite-nav-item"> <a href="/docs" class="devsite-nav-title gc-analytics-event devsite-nav-active" data-category="Site-Wide Custom Events" data-label="Tab: Documentation" track-name="docs-home" track-link-column-type="single-column" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Documentation" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Documentation </a> <ul class="devsite-nav-responsive-tabs"> <li class="devsite-nav-item"> <a href="/storage/docs/discover-object-storage-console" class="devsite-nav-title gc-analytics-event devsite-nav-has-children devsite-nav-active" data-category="Site-Wide Custom Events" data-label="Tab: Guides" track-name="guides" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Guides" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Guides </a> </li> <li class="devsite-nav-item"> <a href="/storage/docs/apis" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Reference" track-name="reference" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Reference" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Reference </a> </li> <li class="devsite-nav-item"> <a href="/storage/docs/samples" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Samples" track-name="samples" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Samples" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Samples </a> </li> <li class="devsite-nav-item"> <a href="/storage/docs/resources" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Tab: Resources" track-name="resources" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Resources" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Resources </a> </li> </ul> </li> <li class="devsite-nav-item"> <a href="/docs/tech-area-overviews" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Technology areas" track-name="technology-areas" track-link-column-type="single-column" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Technology areas" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Technology areas </a> <ul class="devsite-nav-responsive-tabs devsite-nav-has-menu "> <li class="devsite-nav-item"> More </li> </ul> </li> <li class="devsite-nav-item"> <a href="/docs/cross-product-overviews" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Cross-product tools" track-name="crossproduct" track-link-column-type="single-column" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Cross-product tools" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Cross-product tools </a> <ul class="devsite-nav-responsive-tabs devsite-nav-has-menu "> <li class="devsite-nav-item"> More </li> </ul> </li> <li class="devsite-nav-item"> <a href="/" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Related sites" track-name="related-sites" track-link-column-type="single-column" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Related sites" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Related sites </a> <ul class="devsite-nav-responsive-tabs devsite-nav-has-menu "> <li class="devsite-nav-item"> More </li> </ul> </li> <li class="devsite-nav-item"> <a href="//console.cloud.google.com/" class="devsite-nav-title gc-analytics-event " track-type="globalNav" referrerpolicy="no-referrer-when-downgrade" track-name="console" track-metadata-eventDetail="nav" track-metadata-position="nav" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Console" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Console </a> </li> <li class="devsite-nav-item"> <a href="/contact" class="cta-button-secondary button" data-overflow-container="left" track-type="contact" track-name="sales" data-overflow="devsite-tabs-wrapper" data-overflow-wrapper="tab" track-metadata-position="nav" track-metadata-eventDetail="nav" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Contact Us" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Contact Us </a> </li> <li class="devsite-nav-item"> <a href="//console.cloud.google.com/freetrial" class="cloud-free-trial-button cta-button-primary button-primary button cloud-button cloud-button--primary" track-type="freeTrial" track-metadata-eventDetail="nav" data-overflow-class="devsite-header-link devsite-top-button button cloud-free-trial-button cloud-free-trial-enabled cloud-button cloud-button--primary" track-name="gcpCta" referrerpolicy="no-referrer-when-downgrade" track-metadata-position="nav" data-overflow="devsite-top-logo-row" data-overflow-container="right" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Start free" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Start free </a> </li> </ul> </div> <div class="devsite-mobile-nav-bottom"> <ul class="devsite-nav-list" menu="_book"> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> Discover </div></li> <li class="devsite-nav-item"><a href="/storage/docs/introduction" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/introduction" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/introduction" >Product overview</a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> Get started </div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Quickstarts </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/discover-object-storage-console" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/discover-object-storage-console" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/discover-object-storage-console" >Use the Console</a></li><li class="devsite-nav-item"><a href="/storage/docs/discover-object-storage-gcloud" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/discover-object-storage-gcloud" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/discover-object-storage-gcloud" >Use the gcloud tool</a></li><li class="devsite-nav-item"><a href="/storage/docs/terraform-create-bucket-upload-object" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/terraform-create-bucket-upload-object" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/terraform-create-bucket-upload-object" >Use Terraform</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Use client libraries </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/reference/libraries" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/reference/libraries" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/reference/libraries" >Get started with client libraries</a></li><li class="devsite-nav-item"><a href="/storage/docs/enable-grpc-api" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/enable-grpc-api" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/enable-grpc-api" >Get started with gRPC</a></li><li class="devsite-nav-item"><a href="/storage/docs/reference/storage_control_quickstart" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/reference/storage_control_quickstart" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/reference/storage_control_quickstart" >Get started with the Storage Control API</a></li></ul></div></li> <li class="devsite-nav-item"><a href="/storage/docs/terraform-for-cloud-storage" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/terraform-for-cloud-storage" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/terraform-for-cloud-storage" >Terraform support for Cloud Storage</a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> Create storage buckets </div></li> <li class="devsite-nav-item"><a href="/storage/docs/buckets" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/buckets" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/buckets" >About buckets</a></li> <li class="devsite-nav-item"><a href="/storage/docs/creating-buckets" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/creating-buckets" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/creating-buckets" >Create buckets</a></li> <li class="devsite-nav-item"><a href="/storage/docs/locations" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/locations" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/locations" >Bucket locations</a></li> <li class="devsite-nav-item"><a href="/storage/docs/storage-classes" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/storage-classes" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/storage-classes" >Storage classes</a></li> <li class="devsite-nav-item"><a href="/storage/docs/changing-default-storage-class" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/changing-default-storage-class" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/changing-default-storage-class" >Change the default storage class of a bucket</a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> Enable Hierarchical Namespace </div></li> <li class="devsite-nav-item"><a href="/storage/docs/hns-overview" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/hns-overview" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/hns-overview" >Overview</a></li> <li class="devsite-nav-item"><a href="/storage/docs/create-hns-bucket" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/create-hns-bucket" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/create-hns-bucket" >Create and manage buckets with hierarchical namespace enabled</a></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Folders </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/folders-overview" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/folders-overview" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/folders-overview" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/create-folders" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/create-folders" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/create-folders" >Create and manage folders</a></li><li class="devsite-nav-item"><a href="/storage/docs/rename-hns-folders" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/rename-hns-folders" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/rename-hns-folders" >Rename and move folders</a></li></ul></div></li> <li class="devsite-nav-item"><a href="/storage/docs/hns-hadoop-workloads" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/hns-hadoop-workloads" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/hns-hadoop-workloads" >Use hierarchical namespace enabled buckets for Hadoop workloads</a></li> <li class="devsite-nav-item"><a href="/storage/docs/hns-buckets-best-practices" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/hns-buckets-best-practices" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/hns-buckets-best-practices" >Optimize performance</a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> Manage storage buckets </div></li> <li class="devsite-nav-item"><a href="/storage/docs/listing-buckets" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/listing-buckets" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/listing-buckets" >List buckets</a></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Bucket metadata </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/bucket-metadata" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/bucket-metadata" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/bucket-metadata" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/getting-bucket-metadata" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/getting-bucket-metadata" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/getting-bucket-metadata" >Get bucket metadata</a></li><li class="devsite-nav-item"><a href="/storage/docs/getting-bucket-size" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/getting-bucket-size" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/getting-bucket-size" >Get bucket size</a></li><li class="devsite-nav-item"><a href="/storage/docs/getting-storage-layout" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/getting-storage-layout" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/getting-storage-layout" >Get bucket storage layout</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Tags and labels </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/tags-and-labels" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/tags-and-labels" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/tags-and-labels" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/using-bucket-labels" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/using-bucket-labels" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/using-bucket-labels" >Label buckets</a></li></ul></div></li> <li class="devsite-nav-item"><a href="/storage/docs/moving-buckets" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/moving-buckets" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/moving-buckets" >Move and rename buckets</a></li> <li class="devsite-nav-item"><a href="/storage/docs/deleting-buckets" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/deleting-buckets" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/deleting-buckets" >Delete buckets</a></li> <li class="devsite-nav-item"><a href="/storage/docs/domain-name-verification" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/domain-name-verification" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/domain-name-verification" >Domain-named bucket verification</a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> Upload and download objects </div></li> <li class="devsite-nav-item"><a href="/storage/docs/objects" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/objects" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/objects" >About objects</a></li> <li class="devsite-nav-item"><a href="/storage/docs/uploads-downloads" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/uploads-downloads" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/uploads-downloads" >Overview of uploads and downloads</a></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Download objects </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/downloading-objects" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/downloading-objects" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/downloading-objects" >Download objects as files</a></li><li class="devsite-nav-item"><a href="/storage/docs/downloading-objects-into-memory" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/downloading-objects-into-memory" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/downloading-objects-into-memory" >Download objects into memory</a></li><li class="devsite-nav-item"><a href="/storage/docs/sliced-object-downloads" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/sliced-object-downloads" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/sliced-object-downloads" >Sliced object downloads</a></li><li class="devsite-nav-item"><a href="/storage/docs/streaming-downloads" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/streaming-downloads" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/streaming-downloads" >Streaming downloads</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Upload objects </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/uploading-objects" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/uploading-objects" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/uploading-objects" >Upload objects from files</a></li><li class="devsite-nav-item"><a href="/storage/docs/uploading-objects-from-memory" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/uploading-objects-from-memory" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/uploading-objects-from-memory" >Upload objects from memory</a></li><li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Resumable uploads </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/resumable-uploads" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/resumable-uploads" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/resumable-uploads" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/performing-resumable-uploads" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/performing-resumable-uploads" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/performing-resumable-uploads" >Perform resumable uploads</a></li></ul></div></li><li class="devsite-nav-item"><a href="/storage/docs/multipart-uploads" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/multipart-uploads" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/multipart-uploads" >XML API multipart uploads</a></li><li class="devsite-nav-item"><a href="/storage/docs/parallel-composite-uploads" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/parallel-composite-uploads" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/parallel-composite-uploads" >Parallel composite uploads</a></li><li class="devsite-nav-item"><a href="/storage/docs/streaming-uploads" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/streaming-uploads" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/streaming-uploads" >Streaming uploads</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Composite objects </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/composite-objects" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/composite-objects" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/composite-objects" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/composing-objects" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/composing-objects" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/composing-objects" >Compose objects</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> Manage objects </div></li> <li class="devsite-nav-item"><a href="/storage/docs/changing-storage-classes" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/changing-storage-classes" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/changing-storage-classes" >Change an object's storage class</a></li> <li class="devsite-nav-item"><a href="/storage/docs/listing-objects" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/listing-objects" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/listing-objects" >List objects</a></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Object metadata </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/metadata" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/metadata" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/metadata" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/viewing-editing-metadata" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/viewing-editing-metadata" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/viewing-editing-metadata" >View and edit object metadata</a></li></ul></div></li> <li class="devsite-nav-item"><a href="/storage/docs/copying-renaming-moving-objects" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/copying-renaming-moving-objects" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/copying-renaming-moving-objects" >Copy, rename, and move objects</a></li> <li class="devsite-nav-item"><a href="/storage/docs/deleting-objects" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/deleting-objects" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/deleting-objects" >Delete objects</a></li> <li class="devsite-nav-item"><a href="/storage/docs/caching" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/caching" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/caching" >Caching objects</a></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Get insights about objects </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/insights/inventory-reports" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/insights/inventory-reports" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/insights/inventory-reports" >Overview of inventory reports</a></li><li class="devsite-nav-item"><a href="/storage/docs/insights/using-inventory-reports" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/insights/using-inventory-reports" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/insights/using-inventory-reports" >Create and manage inventory reports</a></li></ul></div></li> <li class="devsite-nav-item"><a href="/storage/docs/transcoding" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/transcoding" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/transcoding" >Object transcoding</a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> Control data lifecycles </div></li> <li class="devsite-nav-item"><a href="/storage/docs/control-data-lifecycles" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/control-data-lifecycles" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/control-data-lifecycles" >Options for controlling data lifecycles</a></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Object Lifecycle Management feature </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/lifecycle" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/lifecycle" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/lifecycle" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/managing-lifecycles" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/managing-lifecycles" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/managing-lifecycles" >Manage object lifecycles</a></li><li class="devsite-nav-item"><a href="/storage/docs/lifecycle-configurations" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/lifecycle-configurations" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/lifecycle-configurations" >Configuration examples</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Autoclass feature </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/autoclass" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/autoclass" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/autoclass" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/using-autoclass" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/using-autoclass" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/using-autoclass" >Use Autoclass</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Object Versioning feature </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/object-versioning" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/object-versioning" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/object-versioning" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/using-object-versioning" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/using-object-versioning" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/using-object-versioning" >Use the Object Versioning feature</a></li><li class="devsite-nav-item"><a href="/storage/docs/using-versioned-objects" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/using-versioned-objects" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/using-versioned-objects" >Use versioned objects</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> Make requests </div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Request endpoints </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/request-endpoints" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/request-endpoints" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/request-endpoints" >Global endpoints</a></li><li class="devsite-nav-item"><a href="/storage/docs/regional-endpoints" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/regional-endpoints" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/regional-endpoints" >Regional endpoints</a></li><li class="devsite-nav-item"><a href="/storage/docs/locational-endpoints" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/locational-endpoints" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/locational-endpoints" >Locational endpoints for ITAR</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Authenticating and OAuth </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/authentication" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/authentication" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/authentication" >Authenticating requests</a></li><li class="devsite-nav-item"><a href="/storage/docs/user-accounts" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/user-accounts" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/user-accounts" >Accessing data on a user's behalf</a></li><li class="devsite-nav-item"><a href="/storage/docs/oauth-scopes" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/oauth-scopes" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/oauth-scopes" >OAuth 2.0 scopes</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Validate and retry requests </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/request-rate" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/request-rate" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/request-rate" >Request rate and access distribution guidelines</a></li><li class="devsite-nav-item"><a href="/storage/docs/retry-strategy" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/retry-strategy" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/retry-strategy" >Retry strategy</a></li><li class="devsite-nav-item"><a href="/storage/docs/request-preconditions" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/request-preconditions" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/request-preconditions" >Request preconditions</a></li><li class="devsite-nav-item"><a href="/storage/docs/data-validation" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/data-validation" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/data-validation" >Data validation and change detection</a></li></ul></div></li> <li class="devsite-nav-item"><a href="/storage/docs/consistency" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/consistency" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/consistency" >Consistency in Cloud Storage operations</a></li> <li class="devsite-nav-item"><a href="/storage/docs/batch" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/batch" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/batch" >Batched requests</a></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Requester Pays feature </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/requester-pays" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/requester-pays" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/requester-pays" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/using-requester-pays" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/using-requester-pays" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/using-requester-pays" >Use the Requester Pays feature</a></li></ul></div></li> <li class="devsite-nav-item"><a href="/storage/docs/using-long-running-operations" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/using-long-running-operations" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/using-long-running-operations" >Use long-running operations</a></li> <li class="devsite-nav-item"><a href="/storage/docs/paginate-results" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/paginate-results" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/paginate-results" >Paginate results</a></li> <li class="devsite-nav-item"><a href="/storage/docs/wildcards" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/wildcards" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/wildcards" >URI wildcards</a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> Secure data </div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Access control </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/access-control" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/access-control" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/access-control" >Overview</a></li><li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Control public access to data </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/access-control/making-data-public" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/access-control/making-data-public" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/access-control/making-data-public" >Make data public</a></li><li class="devsite-nav-item"><a href="/storage/docs/access-public-data" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/access-public-data" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/access-public-data" >Access public data</a></li><li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Public access prevention </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/public-access-prevention" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/public-access-prevention" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/public-access-prevention" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/using-public-access-prevention" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/using-public-access-prevention" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/using-public-access-prevention" >Use public access prevention</a></li></ul></div></li></ul></div></li><li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Cloud Identity and Access Management (Cloud IAM) </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/access-control/iam" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/access-control/iam" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/access-control/iam" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/access-control/using-iam-permissions" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/access-control/using-iam-permissions" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/access-control/using-iam-permissions" >Set IAM policies on buckets</a></li><li class="devsite-nav-item"><a href="/storage/docs/access-control/using-iam-for-managed-folders" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/access-control/using-iam-for-managed-folders" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/access-control/using-iam-for-managed-folders" >Set IAM policies on managed folders</a></li><li class="devsite-nav-item"><a href="/storage/docs/access-control/iam-reference" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/access-control/iam-reference" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/access-control/iam-reference" >IAM references for Cloud Storage</a></li></ul></div></li><li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Managed folders </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/managed-folders" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/managed-folders" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/managed-folders" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/creating-managing-managed-folders" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/creating-managing-managed-folders" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/creating-managing-managed-folders" >Create and manage managed folders</a></li></ul></div></li><li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Access control lists (ACLs) </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/access-control/lists" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/access-control/lists" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/access-control/lists" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/access-control/create-manage-lists" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/access-control/create-manage-lists" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/access-control/create-manage-lists" >Create and manage ACLs</a></li></ul></div></li><li class="devsite-nav-item devsite-nav-expandable devsite-nav-preview"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Bucket IP filtering </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/ip-filtering-overview" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/ip-filtering-overview" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/ip-filtering-overview" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/create-ip-filter" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/create-ip-filter" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/create-ip-filter" >Create bucket IP filtering rules</a></li><li class="devsite-nav-item"><a href="/storage/docs/update-ip-filter" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/update-ip-filter" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/update-ip-filter" >Update bucket IP filtering rules</a></li><li class="devsite-nav-item"><a href="/storage/docs/get-ip-filter" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/get-ip-filter" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/get-ip-filter" >Get IP bucket filtering rules</a></li><li class="devsite-nav-item"><a href="/storage/docs/list-ip-filter" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/list-ip-filter" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/list-ip-filter" >List bucket IP filtering rules</a></li><li class="devsite-nav-item"><a href="/storage/docs/disable-ip-filtering" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/disable-ip-filtering" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/disable-ip-filtering" >Disable bucket IP filtering</a></li><li class="devsite-nav-item"><a href="/storage/docs/bypass-ip-filter" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/bypass-ip-filter" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/bypass-ip-filter" >Bypass bucket IP filtering rules</a></li></ul></div></li><li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Uniform bucket-level access </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/uniform-bucket-level-access" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/uniform-bucket-level-access" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/uniform-bucket-level-access" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/using-uniform-bucket-level-access" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/using-uniform-bucket-level-access" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/using-uniform-bucket-level-access" >Use uniform bucket-level access</a></li></ul></div></li><li class="devsite-nav-item"><a href="/storage/docs/collaboration" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/collaboration" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/collaboration" >Sharing and collaboration scenarios</a></li><li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Cross-origin resource sharing (CORS) </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/cross-origin" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/cross-origin" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/cross-origin" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/using-cors" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/using-cors" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/using-cors" >Set up and view CORS configurations</a></li><li class="devsite-nav-item"><a href="/storage/docs/cors-configurations" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/cors-configurations" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/cors-configurations" >CORS configuration examples</a></li></ul></div></li><li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Authenticate with V4 signing </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/access-control/signed-urls" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/access-control/signed-urls" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/access-control/signed-urls" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/access-control/signing-urls-with-helpers" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/access-control/signing-urls-with-helpers" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/access-control/signing-urls-with-helpers" >V4 signing process with Cloud Storage tools</a></li><li class="devsite-nav-item"><a href="/storage/docs/access-control/signing-urls-manually" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/access-control/signing-urls-manually" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/access-control/signing-urls-manually" >V4 signing process with your own program</a></li><li class="devsite-nav-item"><a href="/storage/docs/authentication/canonical-requests" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/authentication/canonical-requests" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/authentication/canonical-requests" >Canonical requests</a></li><li class="devsite-nav-item"><a href="/storage/docs/authentication/signatures" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/authentication/signatures" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/authentication/signatures" >Signatures</a></li><li class="devsite-nav-item"><a href="/storage/docs/authentication/creating-signatures" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/authentication/creating-signatures" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/authentication/creating-signatures" >Create signatures</a></li></ul></div></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Encryption </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/encryption" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/encryption" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/encryption" >Data encryption options</a></li><li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Customer-managed encryption keys </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/encryption/customer-managed-keys" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/encryption/customer-managed-keys" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/encryption/customer-managed-keys" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/encryption/using-customer-managed-keys" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/encryption/using-customer-managed-keys" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/encryption/using-customer-managed-keys" >Use customer-managed encryption keys</a></li></ul></div></li><li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Customer-supplied encryption keys </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/encryption/customer-supplied-keys" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/encryption/customer-supplied-keys" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/encryption/customer-supplied-keys" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/encryption/using-customer-supplied-keys" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/encryption/using-customer-supplied-keys" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/encryption/using-customer-supplied-keys" >Use customer-supplied encryption keys</a></li></ul></div></li><li class="devsite-nav-item"><a href="/storage/docs/encryption/default-keys" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/encryption/default-keys" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/encryption/default-keys" >Standard encryption</a></li><li class="devsite-nav-item"><a href="/storage/docs/encryption/client-side-keys" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/encryption/client-side-keys" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/encryption/client-side-keys" >Client-side keys</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Organization policy constraints </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/org-policy-constraints" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/org-policy-constraints" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/org-policy-constraints" >Predefined constraints</a></li><li class="devsite-nav-item"><a href="/storage/docs/custom-constraints" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/custom-constraints" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/custom-constraints" >Custom constraints</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> Monitor data and usage </div></li> <li class="devsite-nav-item"><a href="/storage/docs/monitoring" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/monitoring" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/monitoring" >Bucket monitoring</a></li> <li class="devsite-nav-item"><a href="/storage/docs/bandwidth-usage" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/bandwidth-usage" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/bandwidth-usage" >Monitor bandwidth usage</a></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Pub/Sub notifications for Cloud Storage </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/pubsub-notifications" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/pubsub-notifications" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/pubsub-notifications" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/reporting-changes" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/reporting-changes" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/reporting-changes" >Configure Pub/Sub notifications</a></li></ul></div></li> <li class="devsite-nav-item"><a href="/storage/docs/audit-logging" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/audit-logging" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/audit-logging" >Use Cloud Audit Logs with Cloud Storage</a></li> <li class="devsite-nav-item"><a href="/storage/docs/access-logs" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/access-logs" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/access-logs" >Usage logs and storage logs</a></li> <li class="devsite-nav-item"><a href="/storage/docs/insights/audit-logging" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/insights/audit-logging" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/insights/audit-logging" >Use Cloud Audit Logs with Storage Insights</a></li> <li class="devsite-nav-item"><a href="/storage/docs/client-side-metrics" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/client-side-metrics" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/client-side-metrics" >Use gRPC client-side metrics</a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> Protection, backup, and recovery </div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Object holds </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/object-holds" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/object-holds" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/object-holds" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/holding-objects" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/holding-objects" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/holding-objects" >Use object holds</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Soft Delete </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/soft-delete" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/soft-delete" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/soft-delete" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/use-soft-delete" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/use-soft-delete" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/use-soft-delete" >Set and manage soft delete policies</a></li><li class="devsite-nav-item"><a href="/storage/docs/use-soft-deleted-objects" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/use-soft-deleted-objects" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/use-soft-deleted-objects" >Use soft-deleted objects</a></li><li class="devsite-nav-item"><a href="/storage/docs/use-soft-deleted-buckets" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/use-soft-deleted-buckets" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/use-soft-deleted-buckets" >Use soft-deleted buckets</a></li><li class="devsite-nav-item"><a href="/storage/docs/use-tags-for-soft-delete" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/use-tags-for-soft-delete" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/use-tags-for-soft-delete" >Set a default soft delete retention duration</a></li><li class="devsite-nav-item"><a href="/storage/docs/soft-delete-recommender" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/soft-delete-recommender" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/soft-delete-recommender" >Use soft delete recommendations</a></li><li class="devsite-nav-item"><a href="/storage/docs/disable-soft-delete" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/disable-soft-delete" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/disable-soft-delete" >Disable soft delete</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Bucket Lock </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/bucket-lock" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/bucket-lock" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/bucket-lock" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/using-bucket-lock" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/using-bucket-lock" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/using-bucket-lock" >Use and lock retention policies</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Object Retention Lock </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/object-lock" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/object-lock" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/object-lock" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/using-object-lock" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/using-object-lock" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/using-object-lock" >Enable and use object retention configurations</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Availability and durability </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/availability-durability" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/availability-durability" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/availability-durability" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/managing-turbo-replication" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/managing-turbo-replication" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/managing-turbo-replication" >Manage turbo replication</a></li><li class="devsite-nav-item devsite-nav-preview"><a href="/storage/docs/using-cross-bucket-replication" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/using-cross-bucket-replication" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/using-cross-bucket-replication" >Use cross-bucket replication</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> Mount buckets with Cloud Storage FUSE </div></li> <li class="devsite-nav-item"><a href="/storage/docs/cloud-storage-fuse/overview" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/cloud-storage-fuse/overview" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/cloud-storage-fuse/overview" >Overview</a></li> <li class="devsite-nav-item"><a href="/storage/docs/cloud-storage-fuse/quickstart-mount-bucket" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/cloud-storage-fuse/quickstart-mount-bucket" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/cloud-storage-fuse/quickstart-mount-bucket" >Quickstart</a></li> <li class="devsite-nav-item"><a href="/storage/docs/cloud-storage-fuse/install" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/cloud-storage-fuse/install" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/cloud-storage-fuse/install" >Install Cloud Storage FUSE</a></li> <li class="devsite-nav-item"><a href="/storage/docs/cloud-storage-fuse/mount-bucket" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/cloud-storage-fuse/mount-bucket" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/cloud-storage-fuse/mount-bucket" >Mount buckets</a></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Caching </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/cloud-storage-fuse/caching" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/cloud-storage-fuse/caching" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/cloud-storage-fuse/caching" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/cloud-storage-fuse/file-caching" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/cloud-storage-fuse/file-caching" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/cloud-storage-fuse/file-caching" >Use file caching</a></li></ul></div></li> <li class="devsite-nav-item"><a href="/storage/docs/cloud-storage-fuse/performance" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/cloud-storage-fuse/performance" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/cloud-storage-fuse/performance" >Performance</a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> Work across products, Clouds, and platforms </div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Projects </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/projects" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/projects" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/projects" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/getting-service-agent" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/getting-service-agent" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/getting-service-agent" >Get a service agent</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Serve website content </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/hosting-static-website" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/hosting-static-website" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/hosting-static-website" >Host a static website</a></li><li class="devsite-nav-item"><a href="/storage/docs/static-website" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/static-website" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/static-website" >Static website example and tips</a></li></ul></div></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> Migrate from Amazon S3 to Cloud Storage </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/aws-simple-migration" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/aws-simple-migration" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/aws-simple-migration" >Simple migration</a></li><li class="devsite-nav-item"><a href="/storage/docs/migrating" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/migrating" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/migrating" >Full migration</a></li></ul></div></li> <li class="devsite-nav-item"><a href="/storage/docs/interoperability" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/interoperability" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/interoperability" >Interoperability</a></li> <li class="devsite-nav-item devsite-nav-expandable"><div class="devsite-expandable-nav"> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"> HMAC keys </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/storage/docs/authentication/hmackeys" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/authentication/hmackeys" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/authentication/hmackeys" >Overview</a></li><li class="devsite-nav-item"><a href="/storage/docs/authentication/managing-hmackeys" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/authentication/managing-hmackeys" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/authentication/managing-hmackeys" >Manage HMAC keys for service accounts</a></li></ul></div></li> <li class="devsite-nav-item"><a href="/storage/docs/working-with-big-data" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/working-with-big-data" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/working-with-big-data" >Use Cloud Storage with Big Data</a></li> <li class="devsite-nav-item"><a href="/storage/docs/google-integration" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/google-integration" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/google-integration" >Integration with Google Cloud Platform services and tools</a></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> Troubleshoot </div></li> <li class="devsite-nav-item"><a href="/storage/docs/troubleshooting" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /storage/docs/troubleshooting" track-type="bookNav" track-name="click" track-metadata-eventdetail="/storage/docs/troubleshooting" >Troubleshooting</a></li> </ul> <ul class="devsite-nav-list" menu="Technology areas" aria-label="Side menu" hidden> <li class="devsite-nav-item"> <a href="/docs/ai-ml" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: AI and ML" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> AI and ML </a> </li> <li class="devsite-nav-item"> <a href="/docs/application-development" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Application development" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Application development </a> </li> <li class="devsite-nav-item"> <a href="/docs/application-hosting" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Application hosting" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Application hosting </a> </li> <li class="devsite-nav-item"> <a href="/docs/compute-area" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Compute" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Compute </a> </li> <li class="devsite-nav-item"> <a href="/docs/data" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Data analytics and pipelines" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Data analytics and pipelines </a> </li> <li class="devsite-nav-item"> <a href="/docs/databases" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Databases" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Databases </a> </li> <li class="devsite-nav-item"> <a href="/docs/dhm-cloud" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Distributed, hybrid, and multicloud" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Distributed, hybrid, and multicloud </a> </li> <li class="devsite-nav-item"> <a href="/docs/generative-ai" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Generative AI" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Generative AI </a> </li> <li class="devsite-nav-item"> <a href="/docs/industry" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Industry solutions" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Industry solutions </a> </li> <li class="devsite-nav-item"> <a href="/docs/networking" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Networking" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Networking </a> </li> <li class="devsite-nav-item"> <a href="/docs/observability" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Observability and monitoring" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Observability and monitoring </a> </li> <li class="devsite-nav-item"> <a href="/docs/security" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Security" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Security </a> </li> <li class="devsite-nav-item"> <a href="/docs/storage" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Storage" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Storage </a> </li> </ul> <ul class="devsite-nav-list" menu="Cross-product tools" aria-label="Side menu" hidden> <li class="devsite-nav-item"> <a href="/docs/access-resources" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Access and resources management" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Access and resources management </a> </li> <li class="devsite-nav-item"> <a href="/docs/costs-usage" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Costs and usage management" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Costs and usage management </a> </li> <li class="devsite-nav-item"> <a href="/docs/devtools" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Google Cloud SDK, languages, frameworks, and tools" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Google Cloud SDK, languages, frameworks, and tools </a> </li> <li class="devsite-nav-item"> <a href="/docs/iac" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Infrastructure as code" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Infrastructure as code </a> </li> <li class="devsite-nav-item"> <a href="/docs/migration" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Migration" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Migration </a> </li> </ul> <ul class="devsite-nav-list" menu="Related sites" aria-label="Side menu" hidden> <li class="devsite-nav-item"> <a href="/" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Google Cloud Home" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Google Cloud Home </a> </li> <li class="devsite-nav-item"> <a href="/free" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Free Trial and Free Tier" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Free Trial and Free Tier </a> </li> <li class="devsite-nav-item"> <a href="/architecture" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Architecture Center" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Architecture Center </a> </li> <li class="devsite-nav-item"> <a href="https://cloud.google.com/blog" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Blog" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Blog </a> </li> <li class="devsite-nav-item"> <a href="/contact" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Contact Sales" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Contact Sales </a> </li> <li class="devsite-nav-item"> <a href="/developers" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Google Cloud Developer Center" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Google Cloud Developer Center </a> </li> <li class="devsite-nav-item"> <a href="https://developers.google.com/" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Google Developer Center" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Google Developer Center </a> </li> <li class="devsite-nav-item"> <a href="https://console.cloud.google.com/marketplace" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Google Cloud Marketplace" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Google Cloud Marketplace </a> </li> <li class="devsite-nav-item"> <a href="/marketplace/docs" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Google Cloud Marketplace Documentation" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Google Cloud Marketplace Documentation </a> </li> <li class="devsite-nav-item"> <a href="https://www.cloudskillsboost.google/paths" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Google Cloud Skills Boost" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Google Cloud Skills Boost </a> </li> <li class="devsite-nav-item"> <a href="/solutions" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Google Cloud Solution Center" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Google Cloud Solution Center </a> </li> <li class="devsite-nav-item"> <a href="/support-hub" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Google Cloud Support" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Google Cloud Support </a> </li> <li class="devsite-nav-item"> <a href="https://www.youtube.com/@googlecloudtech" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Google Cloud Tech Youtube Channel" track-type="navMenu" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Google Cloud Tech Youtube Channel </a> </li> </ul> </div> </div> </nav> </devsite-book-nav> <section id="gc-wrapper"> <main role="main" class="devsite-main-content" has-book-nav has-sidebar > <div class="devsite-sidebar"> <div class="devsite-sidebar-content"> <devsite-toc class="devsite-nav" role="navigation" aria-label="On this page" depth="2" scrollbars ></devsite-toc> <devsite-recommendations-sidebar class="nocontent devsite-nav"> </devsite-recommendations-sidebar> </div> </div> <devsite-content> <article class="devsite-article"> <div class="devsite-article-meta nocontent" role="navigation"> <ul class="devsite-breadcrumb-list" aria-label="Breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://cloud.google.com/" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="Google Cloud" > Home </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://cloud.google.com/storage" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="Cloud Storage" > Cloud Storage </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://cloud.google.com/storage/docs" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="3" track-type="globalNav" track-name="breadcrumb" track-metadata-position="3" track-metadata-eventdetail="Cloud Storage" > Documentation </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://cloud.google.com/storage/docs/discover-object-storage-console" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="4" track-type="globalNav" track-name="breadcrumb" track-metadata-position="4" track-metadata-eventdetail="" > Guides </a> </li> </ul> <devsite-thumb-rating position="header"> </devsite-thumb-rating> </div> <devsite-feedback position="header" project-name="Cloud Storage" product-id="81864" bucket="documentation" context="" version="t-devsite-webserver-20241114-r00-rc02.464922260396498922" data-label="Send Feedback Button" track-type="feedback" track-name="sendFeedbackLink" track-metadata-position="header" class="nocontent" project-feedback-url="https://issuetracker.google.com/issues/new?component=187243" project-icon="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/cloud/images/favicons/onecloud/super_cloud.png" project-support-url="https://cloud.google.com/support-hub" > <button> Send feedback </button> </devsite-feedback> <h1 class="devsite-page-title" tabindex="-1"> Enable and use object retention configurations </h1> <devsite-feature-tooltip ack-key="AckCollectionsBookmarkTooltipDismiss" analytics-category="Site-Wide Custom Events" analytics-action-show="Callout Profile displayed" analytics-action-close="Callout Profile dismissed" analytics-label="Create Collection Callout" class="devsite-page-bookmark-tooltip nocontent" dismiss-button="true" id="devsite-collections-dropdown" dismiss-button-text="Dismiss" close-button-text="Got it"> <devsite-bookmark></devsite-bookmark> Stay organized with collections Save and categorize content based on your preferences. </devsite-feature-tooltip> <div class="devsite-page-title-meta"><devsite-view-release-notes></devsite-view-release-notes></div> <devsite-toc class="devsite-nav" depth="2" devsite-toc-embedded > </devsite-toc> <div class="devsite-article-body clearfix "> <a class="button" href="/storage/docs/object-lock" track-type="tasks" track-name="internalLink" track-metadata-position="introParagraph">Overview</a> This page describes how to use the Object Retention Lock feature, including enabling it for a bucket and setting retention configurations for objects within the bucket. <h2 id="required-roles" data-text="Required roles" tabindex="-1">Required roles</h2> To get the permissions that you need to enable the Object Retention Lock feature for a bucket and set retention configurations on objects, ask your administrator to grant you the Storage Admin (<code translate="no" dir="ltr">roles/storage.admin</code>) IAM role on the bucket or the project that contains the bucket. This <a href="/iam/docs/understanding-roles#predefined">predefined role</a> contains the permissions required to set and manage retention configurations. To see the exact permissions that are required, expand the Required permissions section: <div> <devsite-expandable id="roles-and-permissions"> <h4 class="showalways" id="required-permissions" data-text="Required permissions" tabindex="-1">Required permissions</h4> <ul> <li><code translate="no" dir="ltr">storage.buckets.create</code></li> <li><code translate="no" dir="ltr">storage.buckets.enableObjectRetention</code></li> <li><code translate="no" dir="ltr">storage.buckets.get</code></li> <li><code translate="no" dir="ltr">storage.buckets.list</code> <ul><li>This permission is only required if you plan on using the Google Cloud console to perform the instructions on this page.</li></ul></li> <li><code translate="no" dir="ltr">storage.objects.get</code></li> <li><code translate="no" dir="ltr">storage.objects.list</code> <ul><li>This permission is only required if you plan on using the Google Cloud console to perform the instructions on this page.</li></ul></li> <li><code translate="no" dir="ltr">storage.objects.overrideUnlockedRetention</code> <ul><li>This permission is only required if you plan on locking or shortening an existing retention configuration.</li></ul></li> <li><code translate="no" dir="ltr">storage.objects.setRetention</code></li> <li><code translate="no" dir="ltr">storage.objects.update</code></li> </ul> </devsite-expandable> </div> You might also be able to get these permissions with <a href="/iam/docs/creating-custom-roles">custom roles</a>. For information about granting roles on buckets, see <a href="/storage/docs/access-control/using-iam-permissions#bucket-iam">Use IAM with buckets</a>. For information about granting roles on projects, see <a href="/iam/docs/granting-changing-revoking-access">Manage access to projects</a>. <h2 id="enable-retentions" data-text="Enable object retentions for a bucket" tabindex="-1">Enable object retentions for a bucket</h2> <aside class="special">Important: Once the ability to set object retention configurations is enabled on a bucket, it cannot be disabled.</aside> Use the following instructions to allow retention configurations for objects in a bucket. If you want to enable object retention configurations for an existing bucket, you must follow the Google Cloud console instructions. <div class="ds-selector-tabs" data-ds-scope="code-sample"> <section><h3 id="console" data-text="Console" tabindex="-1">Console</h3>To enable object retention configurations for a new bucket: <ol> <li><a href="/storage/docs/creating-buckets">Create a bucket</a> as you normally would, and in the Choose how to protect object data step, select Retention (For compliance) followed by Enable object retention.</li> </ol> To enable object retention configurations for an existing bucket: <ol> <li>In the Google Cloud console, go to the Cloud Storage Buckets page. <a class="button button-primary" href="https://console.cloud.google.com/storage/browser" target="console">Go to Buckets</a></li> <li>In the list of buckets, click the name of the bucket for which you want to enable object retentions.</li> <li>Select the Protection tab near the top of the page. The bucket's object retention status is displayed in the Object retention section.</li> <li>In the Object retention section, click Object Retention Not Enabled.</li> <li>In the dialog that appears, click Confirm.</li> </ol></section> <section><h3 id="command-line" data-text="Command line" tabindex="-1">Command line</h3><a href="/sdk/gcloud/reference/storage/buckets/create">Create a bucket</a> as you normally would, and include the <code translate="no" dir="ltr">--enable-per-object-retention</code> flag in the command.</section> <section><h3 id="client-libraries" data-text="Client libraries" tabindex="-1">Client libraries</h3> <section> <div id="storage-set-bucket-object-retentions-code-sample" class="ds-selector-tabs" data-ds-scope="code-sample"> <section> <h3 id="storage-set-bucket-object-retentions-cpp" track-metadata-position="storage-set-bucket-object-retentions" track-metadata-region-tag="storage-set-bucket-object-retentions" data-text="C++" tabindex="-1">C++</h3> For more information, see the <a href="/cpp/docs/reference/storage/latest" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="cpp" track-metadata-snippet-file-url="https://github.com/googleapis/google-cloud-cpp/blob/HEAD/google/cloud/storage/examples/storage_bucket_object_retention_samples.cc" track-metadata-region-tag="storage-set-bucket-object-retentions">Cloud Storage C++ API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="googleapis/google-cloud-cpp/google/cloud/storage/examples/storage_bucket_object_retention_samples.cc/HEAD/storage_create_bucket_with_object_retention" data-code-snippet="true" data-github-includecode-link="https://github.com/googleapis/google-cloud-cpp/blob/HEAD/google/cloud/storage/examples/storage_bucket_object_retention_samples.cc" feedback-context="{"language": "cpp", "region_tag": "storage-set-bucket-object-retentions", "snippet_file_url": "https://github.com/googleapis/google-cloud-cpp/blob/HEAD/google/cloud/storage/examples/storage_bucket_object_retention_samples.cc"}" feedback-product="1634365" feedback-bucket="storage" language="cpp" data-github-path="googleapis/google-cloud-cpp/google/cloud/storage/examples/storage_bucket_object_retention_samples.cc" data-git-revision="HEAD" data-region-tag="storage_create_bucket_with_object_retention" dir="ltr" is-upgraded syntax="C++"><code translate="no" dir="ltr">//! [create-bucket-with-object-retention] namespace gcs = ::google::cloud::storage; using ::google::cloud::StatusOr; [](gcs::Client client, std::string const& bucket_name, std::string const& project_id) { auto bucket = client.CreateBucket(bucket_name, gcs::BucketMetadata{}, gcs::EnableObjectRetention(true), gcs::OverrideDefaultProject(project_id)); if (!bucket) throw std::move(bucket).status(); if (!bucket->has_object_retention()) { throw std::runtime_error("missing object retention in new bucket"); } std::cout << "Successfully created bucket " << bucket_name << " with object retention: " << bucket->object_retention() << "\n"; } //! [create-bucket-with-object-retention]</code></pre></devsite-code> </div> </section> <section> <h3 id="storage-set-bucket-object-retentions-csharp" track-metadata-position="storage-set-bucket-object-retentions" track-metadata-region-tag="storage-set-bucket-object-retentions" data-text="C#" tabindex="-1">C#</h3> For more information, see the <a href="https://cloud.google.com/dotnet/docs/reference/Google.Cloud.Storage.V1/latest" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="csharp" track-metadata-snippet-file-url="https://github.com/GoogleCloudPlatform/dotnet-docs-samples/blob//storage/api/Storage.Samples/CreateBucketWithObjectRetention.cs" track-metadata-region-tag="storage-set-bucket-object-retentions">Cloud Storage C# API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="GoogleCloudPlatform/dotnet-docs-samples/storage/api/Storage.Samples/CreateBucketWithObjectRetention.cs/HEAD/storage_create_bucket_with_object_retention" data-code-snippet="true" data-github-includecode-link="https://github.com/GoogleCloudPlatform/dotnet-docs-samples/blob/HEAD/storage/api/Storage.Samples/CreateBucketWithObjectRetention.cs" feedback-context="{"language": "csharp", "region_tag": "storage-set-bucket-object-retentions", "snippet_file_url": "https://github.com/GoogleCloudPlatform/dotnet-docs-samples/blob/HEAD/storage/api/Storage.Samples/CreateBucketWithObjectRetention.cs"}" feedback-product="1634365" feedback-bucket="storage" language="csharp" data-github-path="GoogleCloudPlatform/dotnet-docs-samples/storage/api/Storage.Samples/CreateBucketWithObjectRetention.cs" data-git-revision="HEAD" data-region-tag="storage_create_bucket_with_object_retention" dir="ltr" is-upgraded syntax="C#"><code translate="no" dir="ltr"> using Google.Apis.Storage.v1.Data; using Google.Cloud.Storage.V1; using System; public class CreateBucketWithObjectRetentionSample { public Bucket CreateBucketWithObjectRetention( string projectId = "your-project-id", string bucketName = "your-unique-bucket-name") { var storage = StorageClient.Create(); var bucket = storage.CreateBucket(projectId, bucketName, new CreateBucketOptions { ObjectRetentionEnabled = true }); Console.WriteLine($"Created {bucketName}, with Object Retention enabled."); return bucket; } } </code></pre></devsite-code> </div> </section> <section> <h3 id="storage-set-bucket-object-retentions-java" track-metadata-position="storage-set-bucket-object-retentions" track-metadata-region-tag="storage-set-bucket-object-retentions" data-text="Java" tabindex="-1">Java</h3> For more information, see the <a href="https://cloud.google.com/java/docs/reference/google-cloud-storage/latest/overview" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="java" track-metadata-snippet-file-url="https://github.com/googleapis/java-storage/blob//samples/snippets/src/main/java/com/example/storage/bucket/CreateBucketWithObjectRetention.java" track-metadata-region-tag="storage-set-bucket-object-retentions">Cloud Storage Java API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="googleapis/java-storage/samples/snippets/src/main/java/com/example/storage/bucket/CreateBucketWithObjectRetention.java/HEAD/storage_create_bucket_with_object_retention" data-code-snippet="true" data-github-includecode-link="https://github.com/googleapis/java-storage/blob/HEAD/samples/snippets/src/main/java/com/example/storage/bucket/CreateBucketWithObjectRetention.java" feedback-context="{"language": "java", "region_tag": "storage-set-bucket-object-retentions", "snippet_file_url": "https://github.com/googleapis/java-storage/blob/HEAD/samples/snippets/src/main/java/com/example/storage/bucket/CreateBucketWithObjectRetention.java"}" feedback-product="1634365" feedback-bucket="storage" language="java" data-github-path="googleapis/java-storage/samples/snippets/src/main/java/com/example/storage/bucket/CreateBucketWithObjectRetention.java" data-git-revision="HEAD" data-region-tag="storage_create_bucket_with_object_retention" dir="ltr" is-upgraded syntax="Java"><code translate="no" dir="ltr"> import com.google.cloud.storage.Bucket; import com.google.cloud.storage.BucketInfo; import com.google.cloud.storage.Storage; import com.google.cloud.storage.StorageOptions; public class CreateBucketWithObjectRetention { public static void createBucketWithObjectRetention(String projectId, String bucketName) { // The ID of your GCP project // String projectId = "your-project-id"; // The ID to give your GCS bucket // String bucketName = "your-unique-bucket-name"; Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService(); Bucket bucket = storage.create( BucketInfo.of(bucketName), Storage.BucketTargetOption.enableObjectRetention(true)); System.out.println( "Created bucket " + bucket.getName() + " with object retention enabled setting: " + bucket.getObjectRetention().getMode().toString()); } } </code></pre></devsite-code> </div> </section> <section> <h3 id="storage-set-bucket-object-retentions-nodejs" track-metadata-position="storage-set-bucket-object-retentions" track-metadata-region-tag="storage-set-bucket-object-retentions" data-text="Node.js" tabindex="-1">Node.js</h3> For more information, see the <a href="https://cloud.google.com/nodejs/docs/reference/storage/latest" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="nodejs" track-metadata-snippet-file-url="https://github.com/googleapis/nodejs-storage/blob//samples/createBucketWithObjectRetention.js" track-metadata-region-tag="storage-set-bucket-object-retentions">Cloud Storage Node.js API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="googleapis/nodejs-storage/samples/createBucketWithObjectRetention.js/HEAD/storage_create_bucket_with_object_retention" data-code-snippet="true" data-github-includecode-link="https://github.com/googleapis/nodejs-storage/blob/HEAD/samples/createBucketWithObjectRetention.js" feedback-context="{"language": "nodejs", "region_tag": "storage-set-bucket-object-retentions", "snippet_file_url": "https://github.com/googleapis/nodejs-storage/blob/HEAD/samples/createBucketWithObjectRetention.js"}" feedback-product="1634365" feedback-bucket="storage" language="nodejs" data-github-path="googleapis/nodejs-storage/samples/createBucketWithObjectRetention.js" data-git-revision="HEAD" data-region-tag="storage_create_bucket_with_object_retention" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">/** * TODO(developer): Uncomment the following lines before running the sample. */ // The ID of your GCS bucket // const bucketName = 'your-unique-bucket-name'; // Imports the Google Cloud client library const {Storage} = require('@google-cloud/storage'); // Creates a client // The bucket in the sample below will be created in the project associated with this client. // For more information, please see https://cloud.google.com/docs/authentication/production or https://googleapis.dev/nodejs/storage/latest/Storage.html const storage = new Storage(); async function createBucketWithObjectRetention() { const [bucket] = await storage.createBucket(bucketName, { enableObjectRetention: true, }); console.log( `Created '${bucket.name}' with object retention enabled setting: ${bucket.metadata.objectRetention.mode}` ); } createBucketWithObjectRetention().catch(console.error);</code></pre></devsite-code> </div> </section> <section> <h3 id="storage-set-bucket-object-retentions-php" track-metadata-position="storage-set-bucket-object-retentions" track-metadata-region-tag="storage-set-bucket-object-retentions" data-text="PHP" tabindex="-1">PHP</h3> For more information, see the <a href="https://googleapis.github.io/google-cloud-php/#/docs/google-cloud/latest/storage/storageclient" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="php" track-metadata-snippet-file-url="https://github.com/GoogleCloudPlatform/php-docs-samples/blob//storage/src/create_bucket_with_object_retention.php" track-metadata-region-tag="storage-set-bucket-object-retentions">Cloud Storage PHP API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="GoogleCloudPlatform/php-docs-samples/storage/src/create_bucket_with_object_retention.php/HEAD/storage_create_bucket_with_object_retention" data-code-snippet="true" data-github-includecode-link="https://github.com/GoogleCloudPlatform/php-docs-samples/blob/HEAD/storage/src/create_bucket_with_object_retention.php" feedback-context="{"language": "php", "region_tag": "storage-set-bucket-object-retentions", "snippet_file_url": "https://github.com/GoogleCloudPlatform/php-docs-samples/blob/HEAD/storage/src/create_bucket_with_object_retention.php"}" feedback-product="1634365" feedback-bucket="storage" language="php" data-github-path="GoogleCloudPlatform/php-docs-samples/storage/src/create_bucket_with_object_retention.php" data-git-revision="HEAD" data-region-tag="storage_create_bucket_with_object_retention" dir="ltr" is-upgraded syntax="PHP"><code translate="no" dir="ltr">use Google\Cloud\Storage\StorageClient; /** * Create a Cloud Storage bucket with the object retention enabled. * * @param string $bucketName The name of your Cloud Storage bucket. * (e.g. 'my-bucket') */ function create_bucket_with_object_retention(string $bucketName): void { $storage = new StorageClient(); $bucket = $storage->createBucket($bucketName, [ 'enableObjectRetention' => true ]); printf( 'Created bucket %s with object retention enabled setting: %s' . PHP_EOL, $bucketName, $bucket->info()['objectRetention']['mode'] ); }</code></pre></devsite-code> </div> </section> <section> <h3 id="storage-set-bucket-object-retentions-python" track-metadata-position="storage-set-bucket-object-retentions" track-metadata-region-tag="storage-set-bucket-object-retentions" data-text="Python" tabindex="-1">Python</h3> For more information, see the <a href="https://cloud.google.com/python/docs/reference/storage/latest" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="python" track-metadata-snippet-file-url="https://github.com/googleapis/python-storage/blob//samples/snippets/storage_create_bucket_object_retention.py" track-metadata-region-tag="storage-set-bucket-object-retentions">Cloud Storage Python API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="googleapis/python-storage/samples/snippets/storage_create_bucket_object_retention.py/HEAD/storage_create_bucket_with_object_retention" data-code-snippet="true" data-github-includecode-link="https://github.com/googleapis/python-storage/blob/HEAD/samples/snippets/storage_create_bucket_object_retention.py" feedback-context="{"language": "python", "region_tag": "storage-set-bucket-object-retentions", "snippet_file_url": "https://github.com/googleapis/python-storage/blob/HEAD/samples/snippets/storage_create_bucket_object_retention.py"}" feedback-product="1634365" feedback-bucket="storage" language="python" data-github-path="googleapis/python-storage/samples/snippets/storage_create_bucket_object_retention.py" data-git-revision="HEAD" data-region-tag="storage_create_bucket_with_object_retention" dir="ltr" is-upgraded syntax="Python"><code translate="no" dir="ltr">from google.cloud import storage def create_bucket_object_retention(bucket_name): """Creates a bucket with object retention enabled.""" # The ID of your GCS bucket # bucket_name = "your-bucket-name" storage_client = storage.Client() bucket = storage_client.create_bucket(bucket_name, enable_object_retention=True) print(f"Created bucket {bucket_name} with object retention enabled setting: {bucket.object_retention_mode}") </code></pre></devsite-code> </div> </section> </div> </section> </section> <section><h3 id="rest-apis" data-text="REST APIs" tabindex="-1">REST APIs</h3><div class="ds-selector-tabs" data-ds-scope="code-sample"> <section><h3 id="json-api" data-text="JSON API" tabindex="-1">JSON API</h3><a href="/storage/docs/json_api/v1/buckets/insert">Create a bucket</a> as you normally would, and include the query parameter <code translate="no" dir="ltr">enableObjectRetention=true</code> as part of the request.</section> <section><h3 id="xml-api" data-text="XML API" tabindex="-1">XML API</h3><a href="/storage/docs/xml-api/put-bucket-create">Create a bucket</a> as you normally would, and include the header <code translate="no" dir="ltr">x-goog-bucket-object-lock-enabled: True</code> as part of the request.</section> </div></section> </div> <h2 id="view-bucket-status" data-text="View a bucket's object retention status" tabindex="-1">View a bucket's object retention status</h2> To see if retention configurations can be set for objects in a bucket: <div class="ds-selector-tabs" data-ds-scope="code-sample"> <section><h3 id="console_1" data-text="Console" tabindex="-1">Console</h3><ol> <li>In the Google Cloud console, go to the Cloud Storage Buckets page. <a class="button button-primary" href="https://console.cloud.google.com/storage/browser" target="console">Go to Buckets</a></li> <li>Click the name of the bucket whose status you want to check.</li> <li>Click the Protection tab.</li> <li>The bucket's object retention status is displayed in the Object retention section.</li> </ol></section> <section><h3 id="command-line_1" data-text="Command line" tabindex="-1">Command line</h3>Use the <a href="/sdk/gcloud/reference/storage/buckets/describe"><code translate="no" dir="ltr">gcloud storage buckets describe</code></a> command with the <code translate="no" dir="ltr">--format</code> flag: <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded>gcloud storage buckets describe gs://<var translate="no">BUCKET_NAME</var> --format="default(per_object_retention)"</pre></devsite-code> Where <code translate="no" dir="ltr"><var translate="no">BUCKET_NAME</var></code> is the name of the bucket whose retention policy you want to view. For example, <code translate="no" dir="ltr">my-bucket</code>. If successful and a retention policy exists for the bucket, the response is similar to the following: <div></div><devsite-code><pre class="readonly" translate="no" dir="ltr" is-upgraded> per_object_retention: mode: Enabled </pre></devsite-code> If successful and a retention policy does not exist for the bucket, the response is similar to the following: <div></div><devsite-code><pre class="readonly" translate="no" dir="ltr" is-upgraded>null</pre></devsite-code></section> <section><h3 id="client-libraries_1" data-text="Client libraries" tabindex="-1">Client libraries</h3> <section> <div id="storage-get-bucket-object-retention-code-sample" class="ds-selector-tabs" data-ds-scope="code-sample"> <section> <h3 id="storage-get-bucket-object-retention-cpp" track-metadata-position="storage-get-bucket-object-retention" track-metadata-region-tag="storage-get-bucket-object-retention" data-text="C++" tabindex="-1">C++</h3> For more information, see the <a href="/cpp/docs/reference/storage/latest" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="cpp" track-metadata-snippet-file-url="https://github.com/googleapis/google-cloud-cpp/blob//google/cloud/storage/examples/storage_bucket_samples.cc" track-metadata-region-tag="storage-get-bucket-object-retention">Cloud Storage C++ API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. To view a bucket's object retention configuration, follow the instructions for displaying a bucket's metadata and look for the object retention field in the response. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="googleapis/google-cloud-cpp/google/cloud/storage/examples/storage_bucket_samples.cc/HEAD/storage_get_bucket_metadata" data-code-snippet="true" data-github-includecode-link="https://github.com/googleapis/google-cloud-cpp/blob/HEAD/google/cloud/storage/examples/storage_bucket_samples.cc" feedback-context="{"language": "cpp", "region_tag": "storage-get-bucket-object-retention", "snippet_file_url": "https://github.com/googleapis/google-cloud-cpp/blob/HEAD/google/cloud/storage/examples/storage_bucket_samples.cc"}" feedback-product="1634365" feedback-bucket="storage" language="cpp" data-github-path="googleapis/google-cloud-cpp/google/cloud/storage/examples/storage_bucket_samples.cc" data-git-revision="HEAD" data-region-tag="storage_get_bucket_metadata" dir="ltr" is-upgraded syntax="C++"><code translate="no" dir="ltr">namespace gcs = ::google::cloud::storage; using ::google::cloud::StatusOr; [](gcs::Client client, std::string const& bucket_name) { StatusOr<gcs::BucketMetadata> bucket_metadata = client.GetBucketMetadata(bucket_name); if (!bucket_metadata) throw std::move(bucket_metadata).status(); std::cout << "The metadata for bucket " << bucket_metadata->name() << " is " << *bucket_metadata << "\n"; }</code></pre></devsite-code> </div> </section> <section> <h3 id="storage-get-bucket-object-retention-csharp" track-metadata-position="storage-get-bucket-object-retention" track-metadata-region-tag="storage-get-bucket-object-retention" data-text="C#" tabindex="-1">C#</h3> For more information, see the <a href="https://cloud.google.com/dotnet/docs/reference/Google.Cloud.Storage.V1/latest" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="csharp" track-metadata-snippet-file-url="https://github.com/GoogleCloudPlatform/dotnet-docs-samples/blob//storage/api/Storage.Samples/GetBucketMetadata.cs" track-metadata-region-tag="storage-get-bucket-object-retention">Cloud Storage C# API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. To view a bucket's object retention configuration, follow the instructions for displaying a bucket's metadata and look for the object retention field in the response. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="GoogleCloudPlatform/dotnet-docs-samples/storage/api/Storage.Samples/GetBucketMetadata.cs/HEAD/storage_get_bucket_metadata" data-code-snippet="true" data-github-includecode-link="https://github.com/GoogleCloudPlatform/dotnet-docs-samples/blob/HEAD/storage/api/Storage.Samples/GetBucketMetadata.cs" feedback-context="{"language": "csharp", "region_tag": "storage-get-bucket-object-retention", "snippet_file_url": "https://github.com/GoogleCloudPlatform/dotnet-docs-samples/blob/HEAD/storage/api/Storage.Samples/GetBucketMetadata.cs"}" feedback-product="1634365" feedback-bucket="storage" language="csharp" data-github-path="GoogleCloudPlatform/dotnet-docs-samples/storage/api/Storage.Samples/GetBucketMetadata.cs" data-git-revision="HEAD" data-region-tag="storage_get_bucket_metadata" dir="ltr" is-upgraded syntax="C#"><code translate="no" dir="ltr"> using Google.Apis.Storage.v1.Data; using Google.Cloud.Storage.V1; using System; public class GetBucketMetadataSample { public Bucket GetBucketMetadata(string bucketName = "your-unique-bucket-name") { var storage = StorageClient.Create(); var bucket = storage.GetBucket(bucketName, new GetBucketOptions { Projection = Projection.Full }); Console.WriteLine($"Bucket:\t{bucket.Name}"); Console.WriteLine($"Acl:\t{bucket.Acl}"); Console.WriteLine($"Billing:\t{bucket.Billing}"); Console.WriteLine($"Cors:\t{bucket.Cors}"); Console.WriteLine($"DefaultEventBasedHold:\t{bucket.DefaultEventBasedHold}"); Console.WriteLine($"DefaultObjectAcl:\t{bucket.DefaultObjectAcl}"); Console.WriteLine($"Encryption:\t{bucket.Encryption}"); if (bucket.Encryption != null) { Console.WriteLine($"KmsKeyName:\t{bucket.Encryption.DefaultKmsKeyName}"); } Console.WriteLine($"Id:\t{bucket.Id}"); Console.WriteLine($"Kind:\t{bucket.Kind}"); Console.WriteLine($"Lifecycle:\t{bucket.Lifecycle}"); Console.WriteLine($"Location:\t{bucket.Location}"); Console.WriteLine($"LocationType:\t{bucket.LocationType}"); Console.WriteLine($"Logging:\t{bucket.Logging}"); Console.WriteLine($"Metageneration:\t{bucket.Metageneration}"); Console.WriteLine($"ObjectRetention:\t{bucket.ObjectRetention}"); Console.WriteLine($"Owner:\t{bucket.Owner}"); Console.WriteLine($"ProjectNumber:\t{bucket.ProjectNumber}"); Console.WriteLine($"RetentionPolicy:\t{bucket.RetentionPolicy}"); Console.WriteLine($"SelfLink:\t{bucket.SelfLink}"); Console.WriteLine($"StorageClass:\t{bucket.StorageClass}"); Console.WriteLine($"TimeCreated:\t{bucket.TimeCreated}"); Console.WriteLine($"Updated:\t{bucket.Updated}"); Console.WriteLine($"Versioning:\t{bucket.Versioning}"); Console.WriteLine($"Website:\t{bucket.Website}"); Console.WriteLine($"TurboReplication:\t{bucket.Rpo}"); if (bucket.Labels != null) { Console.WriteLine("Labels:"); foreach (var label in bucket.Labels) { Console.WriteLine($"{label.Key}:\t{label.Value}"); } } return bucket; } }</code></pre></devsite-code> </div> </section> <section> <h3 id="storage-get-bucket-object-retention-java" track-metadata-position="storage-get-bucket-object-retention" track-metadata-region-tag="storage-get-bucket-object-retention" data-text="Java" tabindex="-1">Java</h3> For more information, see the <a href="https://cloud.google.com/java/docs/reference/google-cloud-storage/latest/overview" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="java" track-metadata-snippet-file-url="https://github.com/googleapis/java-storage/blob//samples/snippets/src/main/java/com/example/storage/bucket/GetBucketMetadata.java" track-metadata-region-tag="storage-get-bucket-object-retention">Cloud Storage Java API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. To view a bucket's object retention configuration, follow the instructions for displaying a bucket's metadata and look for the object retention field in the response. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="googleapis/java-storage/samples/snippets/src/main/java/com/example/storage/bucket/GetBucketMetadata.java/HEAD/storage_get_bucket_metadata" data-code-snippet="true" data-github-includecode-link="https://github.com/googleapis/java-storage/blob/HEAD/samples/snippets/src/main/java/com/example/storage/bucket/GetBucketMetadata.java" feedback-context="{"language": "java", "region_tag": "storage-get-bucket-object-retention", "snippet_file_url": "https://github.com/googleapis/java-storage/blob/HEAD/samples/snippets/src/main/java/com/example/storage/bucket/GetBucketMetadata.java"}" feedback-product="1634365" feedback-bucket="storage" language="java" data-github-path="googleapis/java-storage/samples/snippets/src/main/java/com/example/storage/bucket/GetBucketMetadata.java" data-git-revision="HEAD" data-region-tag="storage_get_bucket_metadata" dir="ltr" is-upgraded syntax="Java"><code translate="no" dir="ltr"> import com.google.cloud.storage.Bucket; import com.google.cloud.storage.BucketInfo; import com.google.cloud.storage.Storage; import com.google.cloud.storage.StorageOptions; import java.util.Map; public class GetBucketMetadata { public static void getBucketMetadata(String projectId, String bucketName) { // The ID of your GCP project // String projectId = "your-project-id"; // The ID of your GCS bucket // String bucketName = "your-unique-bucket-name"; Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService(); // Select all fields. Fields can be selected individually e.g. Storage.BucketField.NAME Bucket bucket = storage.get(bucketName, Storage.BucketGetOption.fields(Storage.BucketField.values())); // Print bucket metadata System.out.println("BucketName: " + bucket.getName()); System.out.println("DefaultEventBasedHold: " + bucket.getDefaultEventBasedHold()); System.out.println("DefaultKmsKeyName: " + bucket.getDefaultKmsKeyName()); System.out.println("Id: " + bucket.getGeneratedId()); System.out.println("IndexPage: " + bucket.getIndexPage()); System.out.println("Location: " + bucket.getLocation()); System.out.println("LocationType: " + bucket.getLocationType()); System.out.println("Metageneration: " + bucket.getMetageneration()); System.out.println("NotFoundPage: " + bucket.getNotFoundPage()); System.out.println("RetentionEffectiveTime: " + bucket.getRetentionEffectiveTime()); System.out.println("RetentionPeriod: " + bucket.getRetentionPeriod()); System.out.println("RetentionPolicyIsLocked: " + bucket.retentionPolicyIsLocked()); System.out.println("RequesterPays: " + bucket.requesterPays()); System.out.println("SelfLink: " + bucket.getSelfLink()); System.out.println("StorageClass: " + bucket.getStorageClass().name()); System.out.println("TimeCreated: " + bucket.getCreateTime()); System.out.println("VersioningEnabled: " + bucket.versioningEnabled()); System.out.println("ObjectRetention: " + bucket.getObjectRetention()); if (bucket.getLabels() != null) { System.out.println("\n\n\nLabels:"); for (Map.Entry<String, String> label : bucket.getLabels().entrySet()) { System.out.println(label.getKey() + "=" + label.getValue()); } } if (bucket.getLifecycleRules() != null) { System.out.println("\n\n\nLifecycle Rules:"); for (BucketInfo.LifecycleRule rule : bucket.getLifecycleRules()) { System.out.println(rule); } } } }</code></pre></devsite-code> </div> </section> <section> <h3 id="storage-get-bucket-object-retention-nodejs" track-metadata-position="storage-get-bucket-object-retention" track-metadata-region-tag="storage-get-bucket-object-retention" data-text="Node.js" tabindex="-1">Node.js</h3> For more information, see the <a href="https://cloud.google.com/nodejs/docs/reference/storage/latest" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="nodejs" track-metadata-snippet-file-url="https://github.com/googleapis/nodejs-storage/blob//samples/bucketMetadata.js" track-metadata-region-tag="storage-get-bucket-object-retention">Cloud Storage Node.js API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. To view a bucket's object retention configuration, follow the instructions for displaying a bucket's metadata and look for the object retention field in the response. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="googleapis/nodejs-storage/samples/bucketMetadata.js/HEAD/storage_get_bucket_metadata" data-code-snippet="true" data-github-includecode-link="https://github.com/googleapis/nodejs-storage/blob/HEAD/samples/bucketMetadata.js" feedback-context="{"language": "nodejs", "region_tag": "storage-get-bucket-object-retention", "snippet_file_url": "https://github.com/googleapis/nodejs-storage/blob/HEAD/samples/bucketMetadata.js"}" feedback-product="1634365" feedback-bucket="storage" language="nodejs" data-github-path="googleapis/nodejs-storage/samples/bucketMetadata.js" data-git-revision="HEAD" data-region-tag="storage_get_bucket_metadata" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">// Imports the Google Cloud client library const {Storage} = require('@google-cloud/storage'); // Creates a client const storage = new Storage(); async function getBucketMetadata() { /** * TODO(developer): Uncomment the following lines before running the sample. */ // The ID of your GCS bucket // const bucketName = 'your-unique-bucket-name'; // Get Bucket Metadata const [metadata] = await storage.bucket(bucketName).getMetadata(); console.log(JSON.stringify(metadata, null, 2)); }</code></pre></devsite-code> </div> </section> <section> <h3 id="storage-get-bucket-object-retention-php" track-metadata-position="storage-get-bucket-object-retention" track-metadata-region-tag="storage-get-bucket-object-retention" data-text="PHP" tabindex="-1">PHP</h3> For more information, see the <a href="https://googleapis.github.io/google-cloud-php/#/docs/google-cloud/latest/storage/storageclient" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="php" track-metadata-snippet-file-url="https://github.com/GoogleCloudPlatform/php-docs-samples/blob//storage/src/get_bucket_metadata.php" track-metadata-region-tag="storage-get-bucket-object-retention">Cloud Storage PHP API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. To view a bucket's object retention configuration, follow the instructions for displaying a bucket's metadata and look for the object retention field in the response. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="GoogleCloudPlatform/php-docs-samples/storage/src/get_bucket_metadata.php/HEAD/storage_get_bucket_metadata" data-code-snippet="true" data-github-includecode-link="https://github.com/GoogleCloudPlatform/php-docs-samples/blob/HEAD/storage/src/get_bucket_metadata.php" feedback-context="{"language": "php", "region_tag": "storage-get-bucket-object-retention", "snippet_file_url": "https://github.com/GoogleCloudPlatform/php-docs-samples/blob/HEAD/storage/src/get_bucket_metadata.php"}" feedback-product="1634365" feedback-bucket="storage" language="php" data-github-path="GoogleCloudPlatform/php-docs-samples/storage/src/get_bucket_metadata.php" data-git-revision="HEAD" data-region-tag="storage_get_bucket_metadata" dir="ltr" is-upgraded syntax="PHP"><code translate="no" dir="ltr">use Google\Cloud\Storage\StorageClient; /** * Get bucket metadata. * * @param string $bucketName The name of your Cloud Storage bucket. * (e.g. 'my-bucket') */ function get_bucket_metadata(string $bucketName): void { $storage = new StorageClient(); $bucket = $storage->bucket($bucketName); $info = $bucket->info(); printf('Bucket Metadata: %s' . PHP_EOL, print_r($info)); }</code></pre></devsite-code> </div> </section> <section> <h3 id="storage-get-bucket-object-retention-python" track-metadata-position="storage-get-bucket-object-retention" track-metadata-region-tag="storage-get-bucket-object-retention" data-text="Python" tabindex="-1">Python</h3> For more information, see the <a href="https://cloud.google.com/python/docs/reference/storage/latest" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="python" track-metadata-snippet-file-url="https://github.com/googleapis/python-storage/blob//samples/snippets/storage_get_bucket_metadata.py" track-metadata-region-tag="storage-get-bucket-object-retention">Cloud Storage Python API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. To view a bucket's object retention configuration, follow the instructions for displaying a bucket's metadata and look for the object retention field in the response. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="googleapis/python-storage/samples/snippets/storage_get_bucket_metadata.py/HEAD/storage_get_bucket_metadata" data-code-snippet="true" data-github-includecode-link="https://github.com/googleapis/python-storage/blob/HEAD/samples/snippets/storage_get_bucket_metadata.py" feedback-context="{"language": "python", "region_tag": "storage-get-bucket-object-retention", "snippet_file_url": "https://github.com/googleapis/python-storage/blob/HEAD/samples/snippets/storage_get_bucket_metadata.py"}" feedback-product="1634365" feedback-bucket="storage" language="python" data-github-path="googleapis/python-storage/samples/snippets/storage_get_bucket_metadata.py" data-git-revision="HEAD" data-region-tag="storage_get_bucket_metadata" dir="ltr" is-upgraded syntax="Python"><code translate="no" dir="ltr"> from google.cloud import storage def bucket_metadata(bucket_name): """Prints out a bucket's metadata.""" # bucket_name = 'your-bucket-name' storage_client = storage.Client() bucket = storage_client.get_bucket(bucket_name) print(f"ID: {bucket.id}") print(f"Name: {bucket.name}") print(f"Storage Class: {bucket.storage_class}") print(f"Location: {bucket.location}") print(f"Location Type: {bucket.location_type}") print(f"Cors: {bucket.cors}") print(f"Default Event Based Hold: {bucket.default_event_based_hold}") print(f"Default KMS Key Name: {bucket.default_kms_key_name}") print(f"Metageneration: {bucket.metageneration}") print( f"Public Access Prevention: {bucket.iam_configuration.public_access_prevention}" ) print(f"Retention Effective Time: {bucket.retention_policy_effective_time}") print(f"Retention Period: {bucket.retention_period}") print(f"Retention Policy Locked: {bucket.retention_policy_locked}") print(f"Object Retention Mode: {bucket.object_retention_mode}") print(f"Requester Pays: {bucket.requester_pays}") print(f"Self Link: {bucket.self_link}") print(f"Time Created: {bucket.time_created}") print(f"Versioning Enabled: {bucket.versioning_enabled}") print(f"Labels: {bucket.labels}") </code></pre></devsite-code> </div> </section> </div> </section> </section> <section><h3 id="rest-apis_1" data-text="REST APIs" tabindex="-1">REST APIs</h3><div class="ds-selector-tabs" data-ds-scope="code-sample"> <section><h3 id="json-api_1" data-text="JSON API" tabindex="-1">JSON API</h3><ol> <li>Have gcloud CLI <a href="/sdk/docs/install">installed and initialized<a>, which lets you generate an access token for the <code translate="no" dir="ltr">Authorization</code> header.</li> <li>Use <a href="http://curl.haxx.se/" class="external"><code translate="no" dir="ltr">cURL</code></a> to call the JSON API with a <a href="/storage/docs/json_api/v1/buckets/get"><code translate="no" dir="ltr">GET</code> Bucket</a> request that includes the <code translate="no" dir="ltr">objectRetention</code> field: <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded>curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/<var translate="no">BUCKET_NAME</var>?fields=objectRetention"</pre></devsite-code> Where <code translate="no" dir="ltr"><var translate="no">BUCKET_NAME</var></code> is the name of the relevant bucket. For example, <code translate="no" dir="ltr">my-bucket</code>.</li> </ol></section> <section><h3 id="xml-api_1" data-text="XML API" tabindex="-1">XML API</h3><ol> <li>Have gcloud CLI <a href="/sdk/docs/install">installed and initialized<a>, which lets you generate an access token for the <code translate="no" dir="ltr">Authorization</code> header.</li> <li>Use <a href="http://curl.haxx.se/" class="external"><code translate="no" dir="ltr">cURL</code></a> to call the XML API with a <a href="/storage/docs/xml-api/get-bucket-metadata"><code translate="no" dir="ltr">GET</code> Bucket</a> request scoped to <code translate="no" dir="ltr">?object-lock</code>: <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded>curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/<var translate="no">BUCKET_NAME</var>?object-lock"</pre></devsite-code> Where <code translate="no" dir="ltr"><var translate="no">BUCKET_NAME</var></code> is the name of the relevant bucket. For example, <code translate="no" dir="ltr">my-bucket</code>.</li> </ol></section> </div></section> </div> <h2 id="set-object-config" data-text="Set an object's retention configuration" tabindex="-1">Set an object's retention configuration</h2> <aside class="caution">Caution: Setting the mode of a retention configuration to <code translate="no" dir="ltr">Locked</code> (<code translate="no" dir="ltr">COMPLIANCE</code> in the XML API) is an irreversible action. If you do so: <ul><li>You cannot remove the retention configuration from the object.</li> <li>You cannot decrease the retention time for the object.</li></ul></aside> In order to set a retention configuration for an object, the object must be stored in a bucket for which <a href="#enable-retentions">object retentions are enabled</a>. To set a retention configuration for an object: <div class="ds-selector-tabs" data-ds-scope="code-sample"> <section><h3 id="console_2" data-text="Console" tabindex="-1">Console</h3><ol> <li>In the Google Cloud console, go to the Cloud Storage Buckets page. <a class="button button-primary" href="https://console.cloud.google.com/storage/browser" target="console">Go to Buckets</a></li> <li>In the list of buckets, click the name of the bucket that contains the object whose retention configuration you want to set or modify. The Bucket details page opens, with the Objects tab selected.</li> <li>Navigate to the object, which might be located in a folder.</li> <li>Click the name of the object. The Object details page opens, which displays object metadata.</li> <li>In the Protection section, click the Edit icon (edit) associated with From object retention configuration. The Edit retention pane opens.</li> <li>In the Object retention configuration section, click Enabled or Disabled. <ol> <li>If the retention configuration is enabled, select a date and time for the configuration in the Retain until time section, and click Unlocked or Locked in the Retention mode section.</li> </ol></li> <li>Click Confirm.</li> </ol> <aside class="note">Note: You can also set a retention configuration for an object at the time the object is uploaded to the bucket. If the bucket you're uploading the object to has the object retention feature enabled, a panel appears during the upload that lets you specify a retention configuration for the object.</aside></section> <section><h3 id="command-line_2" data-text="Command line" tabindex="-1">Command line</h3>Use the <a href="/sdk/gcloud/reference/storage/objects/update"><code translate="no" dir="ltr">gcloud storage objects update</code></a> command with the appropriate flags. To add or modify a retention configuration, use the following command. Note that you must additionally include the <code translate="no" dir="ltr">--override-unlocked-retention</code> flag if you are modifying an existing configuration in a way that locks it or shortens its retain-until time: <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded>gcloud storage objects update gs://<var translate="no">BUCKET_NAME</var>/<var translate="no">OBJECT_NAME</var> --retain-until=<var translate="no">DATETIME</var> --retention-mode=<var translate="no">STATE</var></pre></devsite-code> Where: <ul> <li><code translate="no" dir="ltr"><var translate="no">BUCKET_NAME</var></code> is the name of the relevant bucket. For example, <code translate="no" dir="ltr">my-bucket</code>.</li> <li><code translate="no" dir="ltr"><var translate="no">OBJECT_NAME</var></code> is the name of the relevant object. For example, <code translate="no" dir="ltr">kitten.png</code>.</li> <li><code translate="no" dir="ltr"><var translate="no">DATETIME</var></code> is the earliest date and time that the object can be deleted. For example, <code translate="no" dir="ltr">2028-02-15T05:30:00Z</code>.</li> <li><code translate="no" dir="ltr"><var translate="no">STATE</var></code> is either <code translate="no" dir="ltr">Locked</code> or <code translate="no" dir="ltr">Unlocked</code>.</li> </ul> If successful, the response looks similar to the following example: <div></div><devsite-code><pre translate="no" dir="ltr" is-upgraded>Updating gs://my-bucket/kitten.png... Completed 1 </pre></devsite-code> To remove a retention configuration from an object, use the following command: <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded>gcloud storage objects update gs://<var translate="no">BUCKET_NAME</var>/<var translate="no">OBJECT_NAME</var> --clear-retention --override-unlocked-retention</pre></devsite-code> Where: <ul> <li><code translate="no" dir="ltr"><var translate="no">BUCKET_NAME</var></code> is the name of the relevant bucket. For example, <code translate="no" dir="ltr">my-bucket</code>.</li> <li><code translate="no" dir="ltr"><var translate="no">OBJECT_NAME</var></code> is the name of the relevant object. For example, <code translate="no" dir="ltr">kitten.png</code>.</li> </ul> <aside class="note">Note: You can also set a retention configuration for an object at the time the object is written to the bucket. See command documentation, such as <a href="/sdk/gcloud/reference/storage/cp"><code translate="no" dir="ltr">gcloud storage cp</code></a> for more information.</aside></section> <section><h3 id="client-libraries_2" data-text="Client libraries" tabindex="-1">Client libraries</h3> <section> <div id="storage-set-object-retention-policy-code-sample" class="ds-selector-tabs" data-ds-scope="code-sample"> <section> <h3 id="storage-set-object-retention-policy-cpp" track-metadata-position="storage-set-object-retention-policy" track-metadata-region-tag="storage-set-object-retention-policy" data-text="C++" tabindex="-1">C++</h3> For more information, see the <a href="/cpp/docs/reference/storage/latest" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="cpp" track-metadata-snippet-file-url="https://github.com/googleapis/google-cloud-cpp/blob//google/cloud/storage/examples/storage_object_retention_samples.cc" track-metadata-region-tag="storage-set-object-retention-policy">Cloud Storage C++ API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="googleapis/google-cloud-cpp/google/cloud/storage/examples/storage_object_retention_samples.cc/HEAD/storage_set_object_retention_policy" data-code-snippet="true" data-github-includecode-link="https://github.com/googleapis/google-cloud-cpp/blob/HEAD/google/cloud/storage/examples/storage_object_retention_samples.cc" feedback-context="{"language": "cpp", "region_tag": "storage-set-object-retention-policy", "snippet_file_url": "https://github.com/googleapis/google-cloud-cpp/blob/HEAD/google/cloud/storage/examples/storage_object_retention_samples.cc"}" feedback-product="1634365" feedback-bucket="storage" language="cpp" data-github-path="googleapis/google-cloud-cpp/google/cloud/storage/examples/storage_object_retention_samples.cc" data-git-revision="HEAD" data-region-tag="storage_set_object_retention_policy" dir="ltr" is-upgraded syntax="C++"><code translate="no" dir="ltr">namespace gcs = ::google::cloud::storage; using ::google::cloud::StatusOr; [](gcs::Client client, std::string const& bucket_name, std::string const& object_name) { auto original = client.GetObjectMetadata(bucket_name, object_name); if (!original) throw std::move(original).status(); auto const until = std::chrono::system_clock::now() + std::chrono::hours(24); auto updated = client.PatchObject( bucket_name, object_name, gcs::ObjectMetadataPatchBuilder().SetRetention( gcs::ObjectRetention{gcs::ObjectRetentionUnlocked(), until}), gcs::OverrideUnlockedRetention(true), gcs::IfMetagenerationMatch(original->metageneration())); if (!updated) throw std::move(updated).status(); std::cout << "Successfully updated object retention configuration: " << *updated << "\n"; }</code></pre></devsite-code> </div> </section> <section> <h3 id="storage-set-object-retention-policy-csharp" track-metadata-position="storage-set-object-retention-policy" track-metadata-region-tag="storage-set-object-retention-policy" data-text="C#" tabindex="-1">C#</h3> For more information, see the <a href="https://cloud.google.com/dotnet/docs/reference/Google.Cloud.Storage.V1/latest" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="csharp" track-metadata-snippet-file-url="https://github.com/GoogleCloudPlatform/dotnet-docs-samples/blob//storage/api/Storage.Samples/SetObjectRetentionPolicy.cs" track-metadata-region-tag="storage-set-object-retention-policy">Cloud Storage C# API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="GoogleCloudPlatform/dotnet-docs-samples/storage/api/Storage.Samples/SetObjectRetentionPolicy.cs/HEAD/storage_set_object_retention_policy" data-code-snippet="true" data-github-includecode-link="https://github.com/GoogleCloudPlatform/dotnet-docs-samples/blob/HEAD/storage/api/Storage.Samples/SetObjectRetentionPolicy.cs" feedback-context="{"language": "csharp", "region_tag": "storage-set-object-retention-policy", "snippet_file_url": "https://github.com/GoogleCloudPlatform/dotnet-docs-samples/blob/HEAD/storage/api/Storage.Samples/SetObjectRetentionPolicy.cs"}" feedback-product="1634365" feedback-bucket="storage" language="csharp" data-github-path="GoogleCloudPlatform/dotnet-docs-samples/storage/api/Storage.Samples/SetObjectRetentionPolicy.cs" data-git-revision="HEAD" data-region-tag="storage_set_object_retention_policy" dir="ltr" is-upgraded syntax="C#"><code translate="no" dir="ltr"> using Google.Cloud.Storage.V1; using System; using Object = Google.Apis.Storage.v1.Data.Object; public class SetObjectRetentionPolicySample { public Google.Apis.Storage.v1.Data.Object SetObjectRetentionPolicy( string bucketName = "your-unique-bucket-name", // A bucket that has object retention enabled string objectName = "your-object-name") // An object that does not have a retention policy set { var storage = StorageClient.Create(); var file = storage.GetObject(bucketName, objectName); file.Retention = new Object.RetentionData { Mode = "Unlocked", RetainUntilTimeDateTimeOffset = DateTimeOffset.UtcNow.AddDays(10) }; file = storage.UpdateObject(file); Console.WriteLine($"The retention policy for object {objectName} was set to:"); Console.WriteLine("Mode: " + file.Retention.Mode); Console.WriteLine("RetainUntilTime: " + file.Retention.RetainUntilTimeDateTimeOffset.ToString()); // To modify an existing policy on an Unlocked object, pass in the override parameter file.Retention = new Object.RetentionData { Mode = "Unlocked", RetainUntilTimeDateTimeOffset = DateTimeOffset.UtcNow.AddDays(9) }; file = storage.UpdateObject(file, new UpdateObjectOptions { OverrideUnlockedRetention = true }); Console.WriteLine($"The retention policy for object {objectName} was updated to:"); Console.WriteLine("Mode: " + file.Retention.Mode); Console.WriteLine("RetainUntilTime: " + file.Retention.RetainUntilTimeDateTimeOffset.ToString()); return file; } }</code></pre></devsite-code> </div> </section> <section> <h3 id="storage-set-object-retention-policy-java" track-metadata-position="storage-set-object-retention-policy" track-metadata-region-tag="storage-set-object-retention-policy" data-text="Java" tabindex="-1">Java</h3> For more information, see the <a href="https://cloud.google.com/java/docs/reference/google-cloud-storage/latest/overview" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="java" track-metadata-snippet-file-url="https://github.com/googleapis/java-storage/blob//samples/snippets/src/main/java/com/example/storage/object/SetObjectRetentionPolicy.java" track-metadata-region-tag="storage-set-object-retention-policy">Cloud Storage Java API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="googleapis/java-storage/samples/snippets/src/main/java/com/example/storage/object/SetObjectRetentionPolicy.java/HEAD/storage_set_object_retention_policy" data-code-snippet="true" data-github-includecode-link="https://github.com/googleapis/java-storage/blob/HEAD/samples/snippets/src/main/java/com/example/storage/object/SetObjectRetentionPolicy.java" feedback-context="{"language": "java", "region_tag": "storage-set-object-retention-policy", "snippet_file_url": "https://github.com/googleapis/java-storage/blob/HEAD/samples/snippets/src/main/java/com/example/storage/object/SetObjectRetentionPolicy.java"}" feedback-product="1634365" feedback-bucket="storage" language="java" data-github-path="googleapis/java-storage/samples/snippets/src/main/java/com/example/storage/object/SetObjectRetentionPolicy.java" data-git-revision="HEAD" data-region-tag="storage_set_object_retention_policy" dir="ltr" is-upgraded syntax="Java"><code translate="no" dir="ltr"> import static java.time.OffsetDateTime.now; import com.google.cloud.storage.Blob; import com.google.cloud.storage.BlobId; import com.google.cloud.storage.BlobInfo.Retention; import com.google.cloud.storage.Storage; import com.google.cloud.storage.StorageException; import com.google.cloud.storage.StorageOptions; public class SetObjectRetentionPolicy { public static void setObjectRetentionPolicy( String projectId, String bucketName, String objectName) throws StorageException { // The ID of your GCP project // String projectId = "your-project-id"; // The ID of your GCS bucket that has object retention enabled // String bucketName = "your-unique-bucket-name"; // The ID of your GCS object // String objectName = "your-object-name"; Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService(); BlobId blobId = BlobId.of(bucketName, objectName); Blob blob = storage.get(blobId); if (blob == null) { System.out.println("The object " + objectName + " was not found in " + bucketName); return; } Blob updated = blob.toBuilder() .setRetention( Retention.newBuilder() .setMode(Retention.Mode.UNLOCKED) .setRetainUntilTime(now().plusDays(10)) .build()) .build() .update(); System.out.println("Retention policy for object " + objectName + " was set to:"); System.out.println(updated.getRetention().toString()); // To modify an existing policy on an Unlocked object, pass in the override parameter blob.toBuilder() .setRetention( updated.getRetention().toBuilder().setRetainUntilTime(now().plusDays(9)).build()) .build() .update(Storage.BlobTargetOption.overrideUnlockedRetention(true)); System.out.println("Retention policy for object " + objectName + " was updated to:"); System.out.println(storage.get(blobId).getRetention().toString()); } } </code></pre></devsite-code> </div> </section> <section> <h3 id="storage-set-object-retention-policy-nodejs" track-metadata-position="storage-set-object-retention-policy" track-metadata-region-tag="storage-set-object-retention-policy" data-text="Node.js" tabindex="-1">Node.js</h3> For more information, see the <a href="https://cloud.google.com/nodejs/docs/reference/storage/latest" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="nodejs" track-metadata-snippet-file-url="https://github.com/googleapis/nodejs-storage/blob//samples/setObjectRetentionPolicy.js" track-metadata-region-tag="storage-set-object-retention-policy">Cloud Storage Node.js API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="googleapis/nodejs-storage/samples/setObjectRetentionPolicy.js/HEAD/storage_set_object_retention_policy" data-code-snippet="true" data-github-includecode-link="https://github.com/googleapis/nodejs-storage/blob/HEAD/samples/setObjectRetentionPolicy.js" feedback-context="{"language": "nodejs", "region_tag": "storage-set-object-retention-policy", "snippet_file_url": "https://github.com/googleapis/nodejs-storage/blob/HEAD/samples/setObjectRetentionPolicy.js"}" feedback-product="1634365" feedback-bucket="storage" language="nodejs" data-github-path="googleapis/nodejs-storage/samples/setObjectRetentionPolicy.js" data-git-revision="HEAD" data-region-tag="storage_set_object_retention_policy" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">/** * TODO(developer): Uncomment the following lines before running the sample. */ // The ID of your GCS bucket // const bucketName = 'your-unique-bucket-name'; // The new ID for your GCS file // const destFileName = 'your-new-file-name'; // The content to be uploaded in the GCS file // const contents = 'your file content'; // Imports the Google Cloud client library const {Storage} = require('@google-cloud/storage'); // Creates a client // The bucket in the sample below will be created in the project associated with this client. // For more information, please see https://cloud.google.com/docs/authentication/production or https://googleapis.dev/nodejs/storage/latest/Storage.html const storage = new Storage(); async function setObjectRetentionPolicy() { // Get a reference to the bucket const myBucket = storage.bucket(bucketName); // Create a reference to a file object const file = myBucket.file(destFileName); // Save the file data await file.save(contents); // Set the retention policy for the file const retentionDate = new Date(); retentionDate.setDate(retentionDate.getDate() + 10); const [metadata] = await file.setMetadata({ retention: { mode: 'Unlocked', retainUntilTime: retentionDate.toISOString(), }, }); console.log( `Retention policy for file ${file.name} was set to: ${metadata.retention.mode}` ); // To modify an existing policy on an unlocked file object, pass in the override parameter const newRetentionDate = new Date(); retentionDate.setDate(retentionDate.getDate() + 9); [metdata] = await file.setMetadata({ retention: {retainUntilTime: newRetentionDate}, overrideUnlockedRetention: true, }); console.log( `Retention policy for file ${file.name} was updated to: ${metadata.retention.retainUntilTime}` ); } setObjectRetentionPolicy().catch(console.error);</code></pre></devsite-code> </div> </section> <section> <h3 id="storage-set-object-retention-policy-php" track-metadata-position="storage-set-object-retention-policy" track-metadata-region-tag="storage-set-object-retention-policy" data-text="PHP" tabindex="-1">PHP</h3> For more information, see the <a href="https://googleapis.github.io/google-cloud-php/#/docs/google-cloud/latest/storage/storageclient" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="php" track-metadata-snippet-file-url="https://github.com/GoogleCloudPlatform/php-docs-samples/blob//storage/src/set_object_retention_policy.php" track-metadata-region-tag="storage-set-object-retention-policy">Cloud Storage PHP API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="GoogleCloudPlatform/php-docs-samples/storage/src/set_object_retention_policy.php/HEAD/storage_set_object_retention_policy" data-code-snippet="true" data-github-includecode-link="https://github.com/GoogleCloudPlatform/php-docs-samples/blob/HEAD/storage/src/set_object_retention_policy.php" feedback-context="{"language": "php", "region_tag": "storage-set-object-retention-policy", "snippet_file_url": "https://github.com/GoogleCloudPlatform/php-docs-samples/blob/HEAD/storage/src/set_object_retention_policy.php"}" feedback-product="1634365" feedback-bucket="storage" language="php" data-github-path="GoogleCloudPlatform/php-docs-samples/storage/src/set_object_retention_policy.php" data-git-revision="HEAD" data-region-tag="storage_set_object_retention_policy" dir="ltr" is-upgraded syntax="PHP"><code translate="no" dir="ltr">use Google\Cloud\Storage\StorageClient; /** * Sets a bucket's retention policy. * * @param string $bucketName The name of your Cloud Storage bucket. * (e.g. 'my-bucket') * @param string $objectName The name of your Cloud Storage object. * (e.g. 'my-object') */ function set_object_retention_policy(string $bucketName, string $objectName): void { $storage = new StorageClient(); $bucket = $storage->bucket($bucketName); $object = $bucket->object($objectName); $expires = (new \DateTime)->add( \DateInterval::createFromDateString('+10 days') ); // To modify an existing policy on an Unlocked object, pass the override parameter $object->update([ 'retention' => [ 'mode' => 'Unlocked', 'retainUntilTime' => $expires->format(\DateTime::RFC3339) ], 'overrideUnlockedRetention' => true ]); printf( 'Retention policy for object %s was updated to: %s' . PHP_EOL, $objectName, $object->info()['retention']['retainUntilTime'] ); }</code></pre></devsite-code> </div> </section> <section> <h3 id="storage-set-object-retention-policy-python" track-metadata-position="storage-set-object-retention-policy" track-metadata-region-tag="storage-set-object-retention-policy" data-text="Python" tabindex="-1">Python</h3> For more information, see the <a href="https://cloud.google.com/python/docs/reference/storage/latest" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="python" track-metadata-snippet-file-url="https://github.com/googleapis/python-storage/blob//samples/snippets/storage_set_object_retention_policy.py" track-metadata-region-tag="storage-set-object-retention-policy">Cloud Storage Python API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="googleapis/python-storage/samples/snippets/storage_set_object_retention_policy.py/HEAD/storage_set_object_retention_policy" data-code-snippet="true" data-github-includecode-link="https://github.com/googleapis/python-storage/blob/HEAD/samples/snippets/storage_set_object_retention_policy.py" feedback-context="{"language": "python", "region_tag": "storage-set-object-retention-policy", "snippet_file_url": "https://github.com/googleapis/python-storage/blob/HEAD/samples/snippets/storage_set_object_retention_policy.py"}" feedback-product="1634365" feedback-bucket="storage" language="python" data-github-path="googleapis/python-storage/samples/snippets/storage_set_object_retention_policy.py" data-git-revision="HEAD" data-region-tag="storage_set_object_retention_policy" dir="ltr" is-upgraded syntax="Python"><code translate="no" dir="ltr">from google.cloud import storage def set_object_retention_policy(bucket_name, contents, destination_blob_name): """Set the object retention policy of a file.""" # The ID of your GCS bucket # bucket_name = "your-bucket-name" # The contents to upload to the file # contents = "these are my contents" # The ID of your GCS object # destination_blob_name = "storage-object-name" storage_client = storage.Client() bucket = storage_client.bucket(bucket_name) blob = bucket.blob(destination_blob_name) blob.upload_from_string(contents) # Set the retention policy for the file. blob.retention.mode = "Unlocked" retention_date = datetime.datetime.now(datetime.timezone.utc) + datetime.timedelta(days=10) blob.retention.retain_until_time = retention_date blob.patch() print( f"Retention policy for file {destination_blob_name} was set to: {blob.retention.mode}." ) # To modify an existing policy on an unlocked file object, pass in the override parameter. new_retention_date = datetime.datetime.now(datetime.timezone.utc) + datetime.timedelta(days=9) blob.retention.retain_until_time = new_retention_date blob.patch(override_unlocked_retention=True) print( f"Retention policy for file {destination_blob_name} was updated to: {blob.retention.retain_until_time}." ) </code></pre></devsite-code> </div> </section> </div> </section> </section> <section><h3 id="rest-apis_2" data-text="REST APIs" tabindex="-1">REST APIs</h3><div class="ds-selector-tabs" data-ds-scope="code-sample"> <section><h3 id="json-api_2" data-text="JSON API" tabindex="-1">JSON API</h3><ol> <li>Have gcloud CLI <a href="/sdk/docs/install">installed and initialized<a>, which lets you generate an access token for the <code translate="no" dir="ltr">Authorization</code> header.</li> <li>Create a JSON file that contains the following information: <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded syntax="JSON">{ "retention": { "mode": <var translate="no">STATE</var>, "retainUntilTime": "<var translate="no">DATETIME</var>" } }</pre></devsite-code> Where: <ul> <li><code translate="no" dir="ltr"><var translate="no">STATE</var></code> is either <code translate="no" dir="ltr">Locked</code> or <code translate="no" dir="ltr">Unlocked</code>.</li> <li><code translate="no" dir="ltr"><var translate="no">DATETIME</var></code> is the earliest date and time that the object can be deleted. For example, <code translate="no" dir="ltr">2028-02-15T05:30:00Z</code>.</li> </ul></li> <li>Use <a href="http://curl.haxx.se/" class="external"><code translate="no" dir="ltr">cURL</code></a> to call the JSON API with a <a href="/storage/docs/json_api/v1/objects/patch"><code translate="no" dir="ltr">PATCH</code> Object</a> request: <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded>curl -X PATCH --data-binary @<var translate="no">JSON_FILE_NAME</var> \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/<var translate="no">BUCKET_NAME</var>/o/<var translate="no">OBJECT_NAME</var>?overrideUnlockedRetention=<var translate="no">BOOLEAN</var>"</pre></devsite-code> Where: <ul> <li><code translate="no" dir="ltr"><var translate="no">JSON_FILE_NAME</var></code> is the path for the file that you created in Step 2.</li> <li><code translate="no" dir="ltr"><var translate="no">BUCKET_NAME</var></code> is the name of the relevant bucket. For example, <code translate="no" dir="ltr">my-bucket</code>.</li> <li><code translate="no" dir="ltr"><var translate="no">OBJECT_NAME</var></code> is the URL-encoded name of the relevant object. For example, <code translate="no" dir="ltr">pets/kitten.png</code>, URL-encoded as <code translate="no" dir="ltr">pets%2Fkitten.png</code>.</li> <li><code translate="no" dir="ltr"><var translate="no">BOOLEAN</var></code> must be <code translate="no" dir="ltr">true</code> if the request shortens, removes, or locks an existing retention configuration. Otherwise, the <code translate="no" dir="ltr">overrideUnlockedRetention</code> parameter can be excluded from the request entirely.</li> </ul></li> </ol> <aside class="note">Note: You can also set a retention configuration for an object at the time the object is written to the bucket. See request documentation, such as <a href="/storage/docs/json_api/v1/objects/insert">Objects: Insert</a> for more information.</aside></section> <section><h3 id="xml-api_2" data-text="XML API" tabindex="-1">XML API</h3><ol> <li>Have gcloud CLI <a href="/sdk/docs/install">installed and initialized<a>, which lets you generate an access token for the <code translate="no" dir="ltr">Authorization</code> header.</li> <li>Create an XML file that contains the following information: <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded><Retention> <Mode> <var translate="no">STATE</var> </Mode> <RetainUntilDate> <var translate="no">DATETIME</var> </RetainUntilDate> </Retention></pre></devsite-code> Where: <ul> <li><code translate="no" dir="ltr"><var translate="no">STATE</var></code> is either <code translate="no" dir="ltr">GOVERNANCE</code> or <code translate="no" dir="ltr">COMPLIANCE</code>.</li> <li><code translate="no" dir="ltr"><var translate="no">DATETIME</var></code> is the earliest date and time that the object can be deleted. For example, <code translate="no" dir="ltr">2028-02-15T05:30:00Z</code>.</li> </ul></li> <li>Use <a href="http://curl.haxx.se/" class="external"><code translate="no" dir="ltr">cURL</code></a> to call the XML API with a <a href="/storage/docs/xml-api/put-object-retention"><code translate="no" dir="ltr">PUT</code> Object</a> request scoped to <code translate="no" dir="ltr">?retention</code>: <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded>curl -X PUT --data-binary @<var translate="no">XML_FILE_NAME</var> \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "x-goog-bypass-governance-retention: <var translate="no">BOOLEAN</var>" \ "https://storage.googleapis.com/<var translate="no">BUCKET_NAME</var>/<var translate="no">OBJECT_NAME</var>?retention"</pre></devsite-code> Where: <ul> <li><code translate="no" dir="ltr"><var translate="no">XML_FILE_NAME</var></code> is the path for the XML file that you created in Step 2.</li> <li><code translate="no" dir="ltr"><var translate="no">BOOLEAN</var></code> must be <code translate="no" dir="ltr">true</code> if the request shortens, removes, or locks an existing retention configuration. Otherwise, the <code translate="no" dir="ltr">x-goog-bypass-governance-retention</code> header can be excluded from the request entirely.</li> <li><code translate="no" dir="ltr"><var translate="no">BUCKET_NAME</var></code> is the name of the relevant bucket. For example, <code translate="no" dir="ltr">my-bucket</code>.</li> <li><code translate="no" dir="ltr"><var translate="no">OBJECT_NAME</var></code> is the URL-encoded name of the relevant object. For example, <code translate="no" dir="ltr">pets/kitten.png</code>, URL-encoded as <code translate="no" dir="ltr">pets%2Fkitten.png</code>.</li> </ul></li> </ol> <aside class="note">Note: You can also set a retention configuration for an object at the time the object is written to the bucket. See request documentation, such as <a href="/storage/docs/xml-api/put-object-upload"><code translate="no" dir="ltr">PUT Object</code></a> for more information.</aside></section> </div></section> </div> <h2 id="view-object-config" data-text="View an object's retention configuration" tabindex="-1">View an object's retention configuration</h2> To view what, if any, retention configuration is set on an object: <div class="ds-selector-tabs" data-ds-scope="code-sample"> <section><h3 id="console_3" data-text="Console" tabindex="-1">Console</h3><ol> <li>In the Google Cloud console, go to the Cloud Storage Buckets page. <a class="button button-primary" href="https://console.cloud.google.com/storage/browser" target="console">Go to Buckets</a></li> <li>In the list of buckets, click the name of the bucket that contains the object whose retention configuration you want to view. The Bucket details page opens, with the Objects tab selected.</li> <li>Navigate to the object, which might be located in a folder.</li> <li>Click the name of the object. The Object details page opens, which displays object metadata. Information about any retention configuration the object has is shown in the Protection section.</li> </ol></section> <section><h3 id="command-line_3" data-text="Command line" tabindex="-1">Command line</h3>Use the <a href="/sdk/gcloud/reference/storage/objects/describe"><code translate="no" dir="ltr">gcloud storage objects describe</code></a> command with the <code translate="no" dir="ltr">--format</code> flag: <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded>gcloud storage objects describe gs://<var translate="no">BUCKET_NAME</var>/<var translate="no">OBJECT_NAME</var> --format="default(retention_settings)"</pre></devsite-code> Where: <ul> <li><code translate="no" dir="ltr"><var translate="no">BUCKET_NAME</var></code> is the name of the relevant bucket. For example, <code translate="no" dir="ltr">my-bucket</code>.</li> <li><code translate="no" dir="ltr"><var translate="no">OBJECT_NAME</var></code> is the name of the relevant object. For example, <code translate="no" dir="ltr">kitten.png</code>.</li> </ul> If successful and a retention configuration exists for the object, the response is similar to the following: <div></div><devsite-code><pre class="readonly" translate="no" dir="ltr" is-upgraded> retention_settings: mode: Unlocked retainUntilTime: '2028-11-30T14:11:14+00:00' </pre></devsite-code> If successful and a retention configuration does not exist for the object, the response is similar to the following: <div></div><devsite-code><pre class="readonly" translate="no" dir="ltr" is-upgraded>null</pre></devsite-code></section> <section><h3 id="client-libraries_3" data-text="Client libraries" tabindex="-1">Client libraries</h3> <section> <div id="storage-get-object-retention-code-sample" class="ds-selector-tabs" data-ds-scope="code-sample"> <section> <h3 id="storage-get-object-retention-cpp" track-metadata-position="storage-get-object-retention" track-metadata-region-tag="storage-get-object-retention" data-text="C++" tabindex="-1">C++</h3> For more information, see the <a href="/cpp/docs/reference/storage/latest" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="cpp" track-metadata-snippet-file-url="https://github.com/googleapis/google-cloud-cpp/blob//google/cloud/storage/examples/storage_object_samples.cc" track-metadata-region-tag="storage-get-object-retention">Cloud Storage C++ API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. To view an object's retention configuration, follow the instructions for displaying a object's metadata and look for the retention field in the response. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="googleapis/google-cloud-cpp/google/cloud/storage/examples/storage_object_samples.cc/HEAD/storage_get_metadata" data-code-snippet="true" data-github-includecode-link="https://github.com/googleapis/google-cloud-cpp/blob/HEAD/google/cloud/storage/examples/storage_object_samples.cc" feedback-context="{"language": "cpp", "region_tag": "storage-get-object-retention", "snippet_file_url": "https://github.com/googleapis/google-cloud-cpp/blob/HEAD/google/cloud/storage/examples/storage_object_samples.cc"}" feedback-product="1634365" feedback-bucket="storage" language="cpp" data-github-path="googleapis/google-cloud-cpp/google/cloud/storage/examples/storage_object_samples.cc" data-git-revision="HEAD" data-region-tag="storage_get_metadata" dir="ltr" is-upgraded syntax="C++"><code translate="no" dir="ltr">namespace gcs = ::google::cloud::storage; using ::google::cloud::StatusOr; [](gcs::Client client, std::string const& bucket_name, std::string const& object_name) { StatusOr<gcs::ObjectMetadata> object_metadata = client.GetObjectMetadata(bucket_name, object_name); if (!object_metadata) throw std::move(object_metadata).status(); std::cout << "The metadata for object " << object_metadata->name() << " in bucket " << object_metadata->bucket() << " is " << *object_metadata << "\n"; }</code></pre></devsite-code> </div> </section> <section> <h3 id="storage-get-object-retention-csharp" track-metadata-position="storage-get-object-retention" track-metadata-region-tag="storage-get-object-retention" data-text="C#" tabindex="-1">C#</h3> For more information, see the <a href="https://cloud.google.com/dotnet/docs/reference/Google.Cloud.Storage.V1/latest" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="csharp" track-metadata-snippet-file-url="https://github.com/GoogleCloudPlatform/dotnet-docs-samples/blob//storage/api/Storage.Samples/GetMetadata.cs" track-metadata-region-tag="storage-get-object-retention">Cloud Storage C# API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. To view an object's retention configuration, follow the instructions for displaying a object's metadata and look for the retention field in the response. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="GoogleCloudPlatform/dotnet-docs-samples/storage/api/Storage.Samples/GetMetadata.cs/HEAD/storage_get_metadata" data-code-snippet="true" data-github-includecode-link="https://github.com/GoogleCloudPlatform/dotnet-docs-samples/blob/HEAD/storage/api/Storage.Samples/GetMetadata.cs" feedback-context="{"language": "csharp", "region_tag": "storage-get-object-retention", "snippet_file_url": "https://github.com/GoogleCloudPlatform/dotnet-docs-samples/blob/HEAD/storage/api/Storage.Samples/GetMetadata.cs"}" feedback-product="1634365" feedback-bucket="storage" language="csharp" data-github-path="GoogleCloudPlatform/dotnet-docs-samples/storage/api/Storage.Samples/GetMetadata.cs" data-git-revision="HEAD" data-region-tag="storage_get_metadata" dir="ltr" is-upgraded syntax="C#"><code translate="no" dir="ltr"> using Google.Cloud.Storage.V1; using System; public class GetMetadataSample { public Google.Apis.Storage.v1.Data.Object GetMetadata( string bucketName = "your-unique-bucket-name", string objectName = "your-object-name") { var storage = StorageClient.Create(); var storageObject = storage.GetObject(bucketName, objectName, new GetObjectOptions { Projection = Projection.Full }); Console.WriteLine($"Bucket:\t{storageObject.Bucket}"); Console.WriteLine($"CacheControl:\t{storageObject.CacheControl}"); Console.WriteLine($"ComponentCount:\t{storageObject.ComponentCount}"); Console.WriteLine($"ContentDisposition:\t{storageObject.ContentDisposition}"); Console.WriteLine($"ContentEncoding:\t{storageObject.ContentEncoding}"); Console.WriteLine($"ContentLanguage:\t{storageObject.ContentLanguage}"); Console.WriteLine($"ContentType:\t{storageObject.ContentType}"); Console.WriteLine($"Crc32c:\t{storageObject.Crc32c}"); Console.WriteLine($"ETag:\t{storageObject.ETag}"); Console.WriteLine($"Generation:\t{storageObject.Generation}"); Console.WriteLine($"Id:\t{storageObject.Id}"); Console.WriteLine($"Kind:\t{storageObject.Kind}"); Console.WriteLine($"KmsKeyName:\t{storageObject.KmsKeyName}"); Console.WriteLine($"Md5Hash:\t{storageObject.Md5Hash}"); Console.WriteLine($"MediaLink:\t{storageObject.MediaLink}"); Console.WriteLine($"Metageneration:\t{storageObject.Metageneration}"); Console.WriteLine($"Name:\t{storageObject.Name}"); Console.WriteLine($"Retention:\t{storageObject.Retention}"); Console.WriteLine($"Size:\t{storageObject.Size}"); Console.WriteLine($"StorageClass:\t{storageObject.StorageClass}"); Console.WriteLine($"TimeCreated:\t{storageObject.TimeCreated}"); Console.WriteLine($"Updated:\t{storageObject.Updated}"); bool eventBasedHold = storageObject.EventBasedHold ?? false; Console.WriteLine("Event-based hold enabled? {0}", eventBasedHold); bool temporaryHold = storageObject.TemporaryHold ?? false; Console.WriteLine("Temporary hold enabled? {0}", temporaryHold); Console.WriteLine($"RetentionExpirationTime\t{storageObject.RetentionExpirationTime}"); if (storageObject.Metadata != null) { Console.WriteLine("Metadata: "); foreach (var metadata in storageObject.Metadata) { Console.WriteLine($"{metadata.Key}:\t{metadata.Value}"); } } Console.WriteLine($"CustomTime:\t{storageObject.CustomTime}"); return storageObject; } }</code></pre></devsite-code> </div> </section> <section> <h3 id="storage-get-object-retention-java" track-metadata-position="storage-get-object-retention" track-metadata-region-tag="storage-get-object-retention" data-text="Java" tabindex="-1">Java</h3> For more information, see the <a href="https://cloud.google.com/java/docs/reference/google-cloud-storage/latest/overview" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="java" track-metadata-snippet-file-url="https://github.com/googleapis/java-storage/blob//samples/snippets/src/main/java/com/example/storage/object/GetObjectMetadata.java" track-metadata-region-tag="storage-get-object-retention">Cloud Storage Java API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. To view an object's retention configuration, follow the instructions for displaying a object's metadata and look for the retention field in the response. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="googleapis/java-storage/samples/snippets/src/main/java/com/example/storage/object/GetObjectMetadata.java/HEAD/storage_get_metadata" data-code-snippet="true" data-github-includecode-link="https://github.com/googleapis/java-storage/blob/HEAD/samples/snippets/src/main/java/com/example/storage/object/GetObjectMetadata.java" feedback-context="{"language": "java", "region_tag": "storage-get-object-retention", "snippet_file_url": "https://github.com/googleapis/java-storage/blob/HEAD/samples/snippets/src/main/java/com/example/storage/object/GetObjectMetadata.java"}" feedback-product="1634365" feedback-bucket="storage" language="java" data-github-path="googleapis/java-storage/samples/snippets/src/main/java/com/example/storage/object/GetObjectMetadata.java" data-git-revision="HEAD" data-region-tag="storage_get_metadata" dir="ltr" is-upgraded syntax="Java"><code translate="no" dir="ltr"> import com.google.cloud.storage.Blob; import com.google.cloud.storage.Storage; import com.google.cloud.storage.StorageException; import com.google.cloud.storage.StorageOptions; import java.util.Date; import java.util.Map; public class GetObjectMetadata { public static void getObjectMetadata(String projectId, String bucketName, String blobName) throws StorageException { // The ID of your GCP project // String projectId = "your-project-id"; // The ID of your GCS bucket // String bucketName = "your-unique-bucket-name"; // The ID of your GCS object // String objectName = "your-object-name"; Storage storage = StorageOptions.newBuilder().setProjectId(projectId).build().getService(); // Select all fields // Fields can be selected individually e.g. Storage.BlobField.CACHE_CONTROL Blob blob = storage.get(bucketName, blobName, Storage.BlobGetOption.fields(Storage.BlobField.values())); // Print blob metadata System.out.println("Bucket: " + blob.getBucket()); System.out.println("CacheControl: " + blob.getCacheControl()); System.out.println("ComponentCount: " + blob.getComponentCount()); System.out.println("ContentDisposition: " + blob.getContentDisposition()); System.out.println("ContentEncoding: " + blob.getContentEncoding()); System.out.println("ContentLanguage: " + blob.getContentLanguage()); System.out.println("ContentType: " + blob.getContentType()); System.out.println("CustomTime: " + blob.getCustomTime()); System.out.println("Crc32c: " + blob.getCrc32c()); System.out.println("Crc32cHexString: " + blob.getCrc32cToHexString()); System.out.println("ETag: " + blob.getEtag()); System.out.println("Generation: " + blob.getGeneration()); System.out.println("Id: " + blob.getBlobId()); System.out.println("KmsKeyName: " + blob.getKmsKeyName()); System.out.println("Md5Hash: " + blob.getMd5()); System.out.println("Md5HexString: " + blob.getMd5ToHexString()); System.out.println("MediaLink: " + blob.getMediaLink()); System.out.println("Metageneration: " + blob.getMetageneration()); System.out.println("Name: " + blob.getName()); System.out.println("Size: " + blob.getSize()); System.out.println("StorageClass: " + blob.getStorageClass()); System.out.println("TimeCreated: " + new Date(blob.getCreateTime())); System.out.println("Last Metadata Update: " + new Date(blob.getUpdateTime())); System.out.println("Object Retention Policy: " + blob.getRetention()); Boolean temporaryHoldIsEnabled = (blob.getTemporaryHold() != null && blob.getTemporaryHold()); System.out.println("temporaryHold: " + (temporaryHoldIsEnabled ? "enabled" : "disabled")); Boolean eventBasedHoldIsEnabled = (blob.getEventBasedHold() != null && blob.getEventBasedHold()); System.out.println("eventBasedHold: " + (eventBasedHoldIsEnabled ? "enabled" : "disabled")); if (blob.getRetentionExpirationTime() != null) { System.out.println("retentionExpirationTime: " + new Date(blob.getRetentionExpirationTime())); } if (blob.getMetadata() != null) { System.out.println("\n\n\nUser metadata:"); for (Map.Entry<String, String> userMetadata : blob.getMetadata().entrySet()) { System.out.println(userMetadata.getKey() + "=" + userMetadata.getValue()); } } } }</code></pre></devsite-code> </div> </section> <section> <h3 id="storage-get-object-retention-nodejs" track-metadata-position="storage-get-object-retention" track-metadata-region-tag="storage-get-object-retention" data-text="Node.js" tabindex="-1">Node.js</h3> For more information, see the <a href="https://cloud.google.com/nodejs/docs/reference/storage/latest" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="nodejs" track-metadata-snippet-file-url="https://github.com/googleapis/nodejs-storage/blob//samples/getMetadata.js" track-metadata-region-tag="storage-get-object-retention">Cloud Storage Node.js API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. To view an object's retention configuration, follow the instructions for displaying a object's metadata and look for the retention field in the response. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="googleapis/nodejs-storage/samples/getMetadata.js/HEAD/storage_get_metadata" data-code-snippet="true" data-github-includecode-link="https://github.com/googleapis/nodejs-storage/blob/HEAD/samples/getMetadata.js" feedback-context="{"language": "nodejs", "region_tag": "storage-get-object-retention", "snippet_file_url": "https://github.com/googleapis/nodejs-storage/blob/HEAD/samples/getMetadata.js"}" feedback-product="1634365" feedback-bucket="storage" language="nodejs" data-github-path="googleapis/nodejs-storage/samples/getMetadata.js" data-git-revision="HEAD" data-region-tag="storage_get_metadata" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">/** * TODO(developer): Uncomment the following lines before running the sample. */ // The ID of your GCS bucket // const bucketName = 'your-unique-bucket-name'; // The ID of your GCS file // const fileName = 'your-file-name'; // Imports the Google Cloud client library const {Storage} = require('@google-cloud/storage'); // Creates a client const storage = new Storage(); async function getMetadata() { // Gets the metadata for the file const [metadata] = await storage .bucket(bucketName) .file(fileName) .getMetadata(); console.log(`Bucket: ${metadata.bucket}`); console.log(`CacheControl: ${metadata.cacheControl}`); console.log(`ComponentCount: ${metadata.componentCount}`); console.log(`ContentDisposition: ${metadata.contentDisposition}`); console.log(`ContentEncoding: ${metadata.contentEncoding}`); console.log(`ContentLanguage: ${metadata.contentLanguage}`); console.log(`ContentType: ${metadata.contentType}`); console.log(`CustomTime: ${metadata.customTime}`); console.log(`Crc32c: ${metadata.crc32c}`); console.log(`ETag: ${metadata.etag}`); console.log(`Generation: ${metadata.generation}`); console.log(`Id: ${metadata.id}`); console.log(`KmsKeyName: ${metadata.kmsKeyName}`); console.log(`Md5Hash: ${metadata.md5Hash}`); console.log(`MediaLink: ${metadata.mediaLink}`); console.log(`Metageneration: ${metadata.metageneration}`); console.log(`Name: ${metadata.name}`); console.log(`Size: ${metadata.size}`); console.log(`StorageClass: ${metadata.storageClass}`); console.log(`TimeCreated: ${new Date(metadata.timeCreated)}`); console.log(`Last Metadata Update: ${new Date(metadata.updated)}`); console.log(`TurboReplication: ${metadata.rpo}`); console.log( `temporaryHold: ${metadata.temporaryHold ? 'enabled' : 'disabled'}` ); console.log( `eventBasedHold: ${metadata.eventBasedHold ? 'enabled' : 'disabled'}` ); if (metadata.retentionExpirationTime) { console.log( `retentionExpirationTime: ${new Date(metadata.retentionExpirationTime)}` ); } if (metadata.metadata) { console.log('\n\n\nUser metadata:'); for (const key in metadata.metadata) { console.log(`${key}=${metadata.metadata[key]}`); } } } getMetadata().catch(console.error);</code></pre></devsite-code> </div> </section> <section> <h3 id="storage-get-object-retention-php" track-metadata-position="storage-get-object-retention" track-metadata-region-tag="storage-get-object-retention" data-text="PHP" tabindex="-1">PHP</h3> For more information, see the <a href="https://googleapis.github.io/google-cloud-php/#/docs/google-cloud/latest/storage/storageclient" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="php" track-metadata-snippet-file-url="https://github.com/GoogleCloudPlatform/php-docs-samples/blob//storage/src/object_metadata.php" track-metadata-region-tag="storage-get-object-retention">Cloud Storage PHP API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. To view an object's retention configuration, follow the instructions for displaying a object's metadata and look for the retention field in the response. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="GoogleCloudPlatform/php-docs-samples/storage/src/object_metadata.php/HEAD/storage_get_metadata" data-code-snippet="true" data-github-includecode-link="https://github.com/GoogleCloudPlatform/php-docs-samples/blob/HEAD/storage/src/object_metadata.php" feedback-context="{"language": "php", "region_tag": "storage-get-object-retention", "snippet_file_url": "https://github.com/GoogleCloudPlatform/php-docs-samples/blob/HEAD/storage/src/object_metadata.php"}" feedback-product="1634365" feedback-bucket="storage" language="php" data-github-path="GoogleCloudPlatform/php-docs-samples/storage/src/object_metadata.php" data-git-revision="HEAD" data-region-tag="storage_get_metadata" dir="ltr" is-upgraded syntax="PHP"><code translate="no" dir="ltr">use Google\Cloud\Storage\StorageClient; /** * List object metadata. * * @param string $bucketName The name of your Cloud Storage bucket. * (e.g. 'my-bucket') * @param string $objectName The name of your Cloud Storage object. * (e.g. 'my-object') */ function object_metadata(string $bucketName, string $objectName): void { $storage = new StorageClient(); $bucket = $storage->bucket($bucketName); $object = $bucket->object($objectName); $info = $object->info(); if (isset($info['name'])) { printf('Blob: %s' . PHP_EOL, $info['name']); } if (isset($info['bucket'])) { printf('Bucket: %s' . PHP_EOL, $info['bucket']); } if (isset($info['storageClass'])) { printf('Storage class: %s' . PHP_EOL, $info['storageClass']); } if (isset($info['id'])) { printf('ID: %s' . PHP_EOL, $info['id']); } if (isset($info['size'])) { printf('Size: %s' . PHP_EOL, $info['size']); } if (isset($info['updated'])) { printf('Updated: %s' . PHP_EOL, $info['updated']); } if (isset($info['generation'])) { printf('Generation: %s' . PHP_EOL, $info['generation']); } if (isset($info['metageneration'])) { printf('Metageneration: %s' . PHP_EOL, $info['metageneration']); } if (isset($info['etag'])) { printf('Etag: %s' . PHP_EOL, $info['etag']); } if (isset($info['crc32c'])) { printf('Crc32c: %s' . PHP_EOL, $info['crc32c']); } if (isset($info['md5Hash'])) { printf('MD5 Hash: %s' . PHP_EOL, $info['md5Hash']); } if (isset($info['contentType'])) { printf('Content-type: %s' . PHP_EOL, $info['contentType']); } if (isset($info['temporaryHold'])) { printf('Temporary hold: %s' . PHP_EOL, ($info['temporaryHold'] ? 'enabled' : 'disabled')); } if (isset($info['eventBasedHold'])) { printf('Event-based hold: %s' . PHP_EOL, ($info['eventBasedHold'] ? 'enabled' : 'disabled')); } if (isset($info['retentionExpirationTime'])) { printf('Retention Expiration Time: %s' . PHP_EOL, $info['retentionExpirationTime']); } if (isset($info['retention'])) { printf('Retention mode: %s' . PHP_EOL, $info['retention']['mode']); printf('Retain until time is: %s' . PHP_EOL, $info['retention']['retainUntilTime']); } if (isset($info['customTime'])) { printf('Custom Time: %s' . PHP_EOL, $info['customTime']); } if (isset($info['metadata'])) { printf('Metadata: %s' . PHP_EOL, print_r($info['metadata'], true)); } }</code></pre></devsite-code> </div> </section> <section> <h3 id="storage-get-object-retention-python" track-metadata-position="storage-get-object-retention" track-metadata-region-tag="storage-get-object-retention" data-text="Python" tabindex="-1">Python</h3> For more information, see the <a href="https://cloud.google.com/python/docs/reference/storage/latest" class="external" track-type="clientLibrariesUsage" track-name="clientLibrariesLink" track-metadata-lang="python" track-metadata-snippet-file-url="https://github.com/googleapis/python-storage/blob//samples/snippets/storage_get_metadata.py" track-metadata-region-tag="storage-get-object-retention">Cloud Storage Python API reference documentation</a>. To authenticate to Cloud Storage, set up Application Default Credentials. For more information, see <a href="/storage/docs/authentication#client-libs">Set up authentication for client libraries</a>. To view an object's retention configuration, follow the instructions for displaying a object's metadata and look for the retention field in the response. <div class="github-docwidget-gitinclude-code"> <div></div><devsite-code><pre suppresswarning="suppresswarning" translate="no" class="devsite-click-to-copy" track-metadata-position="googleapis/python-storage/samples/snippets/storage_get_metadata.py/HEAD/storage_get_metadata" data-code-snippet="true" data-github-includecode-link="https://github.com/googleapis/python-storage/blob/HEAD/samples/snippets/storage_get_metadata.py" feedback-context="{"language": "python", "region_tag": "storage-get-object-retention", "snippet_file_url": "https://github.com/googleapis/python-storage/blob/HEAD/samples/snippets/storage_get_metadata.py"}" feedback-product="1634365" feedback-bucket="storage" language="python" data-github-path="googleapis/python-storage/samples/snippets/storage_get_metadata.py" data-git-revision="HEAD" data-region-tag="storage_get_metadata" dir="ltr" is-upgraded syntax="Python"><code translate="no" dir="ltr">from google.cloud import storage def blob_metadata(bucket_name, blob_name): """Prints out a blob's metadata.""" # bucket_name = 'your-bucket-name' # blob_name = 'your-object-name' storage_client = storage.Client() bucket = storage_client.bucket(bucket_name) # Retrieve a blob, and its metadata, from Google Cloud Storage. # Note that `get_blob` differs from `Bucket.blob`, which does not # make an HTTP request. blob = bucket.get_blob(blob_name) print(f"Blob: {blob.name}") print(f"Bucket: {blob.bucket.name}") print(f"Storage class: {blob.storage_class}") print(f"ID: {blob.id}") print(f"Size: {blob.size} bytes") print(f"Updated: {blob.updated}") print(f"Generation: {blob.generation}") print(f"Metageneration: {blob.metageneration}") print(f"Etag: {blob.etag}") print(f"Owner: {blob.owner}") print(f"Component count: {blob.component_count}") print(f"Crc32c: {blob.crc32c}") print(f"md5_hash: {blob.md5_hash}") print(f"Cache-control: {blob.cache_control}") print(f"Content-type: {blob.content_type}") print(f"Content-disposition: {blob.content_disposition}") print(f"Content-encoding: {blob.content_encoding}") print(f"Content-language: {blob.content_language}") print(f"Metadata: {blob.metadata}") print(f"Medialink: {blob.media_link}") print(f"Custom Time: {blob.custom_time}") print("Temporary hold: ", "enabled" if blob.temporary_hold else "disabled") print( "Event based hold: ", "enabled" if blob.event_based_hold else "disabled", ) print(f"Retention mode: {blob.retention.mode}") print(f"Retention retain until time: {blob.retention.retain_until_time}") if blob.retention_expiration_time: print( f"retentionExpirationTime: {blob.retention_expiration_time}" ) </code></pre></devsite-code> </div> </section> </div> </section> </section> <section><h3 id="rest-apis_3" data-text="REST APIs" tabindex="-1">REST APIs</h3><div class="ds-selector-tabs" data-ds-scope="code-sample"> <section><h3 id="json-api_3" data-text="JSON API" tabindex="-1">JSON API</h3><ol> <li>Have gcloud CLI <a href="/sdk/docs/install">installed and initialized<a>, which lets you generate an access token for the <code translate="no" dir="ltr">Authorization</code> header.</li> <li>Use <a href="http://curl.haxx.se/" class="external"><code translate="no" dir="ltr">cURL</code></a> to call the JSON API with a <a href="/storage/docs/json_api/v1/objects/get"><code translate="no" dir="ltr">GET</code> Object</a> request that includes the <code translate="no" dir="ltr">retention</code> field: <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded>curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/<var translate="no">BUCKET_NAME</var>/<var translate="no">OBJECT_NAME</var>?fields=retention"</pre></devsite-code> Where: <ul> <li><code translate="no" dir="ltr"><var translate="no">BUCKET_NAME</var></code> is the name of the relevant bucket. For example, <code translate="no" dir="ltr">my-bucket</code>.</li> <li><code translate="no" dir="ltr"><var translate="no">OBJECT_NAME</var></code> is the name of the relevant object. For example, <code translate="no" dir="ltr">kitten.png</code>.</li> </ul></li> </ol></section> <section><h3 id="xml-api_3" data-text="XML API" tabindex="-1">XML API</h3><ol> <li>Have gcloud CLI <a href="/sdk/docs/install">installed and initialized<a>, which lets you generate an access token for the <code translate="no" dir="ltr">Authorization</code> header.</li> <li>Use <a href="http://curl.haxx.se/" class="external"><code translate="no" dir="ltr">cURL</code></a> to call the XML API with a <a href="/storage/docs/xml-api/get-object-retention"><code translate="no" dir="ltr">GET</code> Object</a> request scoped to <code translate="no" dir="ltr">?retention</code>: <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded>curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/<var translate="no">BUCKET_NAME</var>/<var translate="no">OBJECT_NAME</var>?retention"</pre></devsite-code> Where: <ul> <li><code translate="no" dir="ltr"><var translate="no">BUCKET_NAME</var></code> is the name of the relevant bucket. For example, <code translate="no" dir="ltr">my-bucket</code>.</li> <li><code translate="no" dir="ltr"><var translate="no">OBJECT_NAME</var></code> is the name of the relevant object. For example, <code translate="no" dir="ltr">kitten.png</code>.</li> </ul></li> </ol></section> </div></section> </div> <h2 id="whats_next" data-text="What's next" tabindex="-1">What's next</h2> <ul> <li>Learn more about <a href="/storage/docs/object-lock">retention configurations</a>.</li> <li>Learn about other <a href="/storage/docs/control-data-lifecycles">features that protect your Cloud Storage data</a>.</li> <li>Learn about <a href="/storage/docs/lifecycle">Object Lifecycle Management</a>, which can automatically delete files once they reach their retention period.</li> </ul> <devsite-hats-survey class="nocontent" hats-id="mwETRvWii0eU5NUYprb0Y9z5GVbc" listnr-id="83405"></devsite-hats-survey> </div> <devsite-thumb-rating position="footer"> </devsite-thumb-rating> <devsite-feedback position="footer" project-name="Cloud Storage" product-id="81864" bucket="documentation" context="" version="t-devsite-webserver-20241114-r00-rc02.464922260396498922" data-label="Send Feedback Button" track-type="feedback" track-name="sendFeedbackLink" track-metadata-position="footer" class="nocontent" project-feedback-url="https://issuetracker.google.com/issues/new?component=187243" project-icon="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/cloud/images/favicons/onecloud/super_cloud.png" project-support-url="https://cloud.google.com/support-hub" > <button> Send feedback </button> </devsite-feedback> <div class="devsite-floating-action-buttons"> </div> </article> <devsite-content-footer class="nocontent"> Except as otherwise noted, the content of this page is licensed under the <a href="https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 License</a>, and code samples are licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a>. For details, see the <a href="https://developers.google.com/site-policies">Google Developers Site Policies</a>. Java is a registered trademark of Oracle and/or its affiliates. Last updated 2024-11-22 UTC. </devsite-content-footer> <devsite-notification > </devsite-notification> <div class="devsite-content-data"> <template class="devsite-thumb-rating-feedback"> <devsite-feedback position="thumb-rating" project-name="Cloud Storage" product-id="81864" bucket="documentation" context="" version="t-devsite-webserver-20241114-r00-rc02.464922260396498922" data-label="Send Feedback Button" track-type="feedback" track-name="sendFeedbackLink" track-metadata-position="thumb-rating" class="nocontent" project-feedback-url="https://issuetracker.google.com/issues/new?component=187243" project-icon="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/cloud/images/favicons/onecloud/super_cloud.png" project-support-url="https://cloud.google.com/support-hub" > <button> Need to tell us more? </button> </devsite-feedback> </template> <template class="devsite-content-data-template"> [[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-11-22 UTC."],[],[]] </template> </div> </devsite-content> </main> <devsite-footer-promos class="devsite-footer"> </devsite-footer-promos> <devsite-footer-linkboxes class="devsite-footer"> <nav class="devsite-footer-linkboxes nocontent" aria-label="Footer links"> <ul class="devsite-footer-linkboxes-list"> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Why Google</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="/why-google-cloud/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" track-metadata-position="footer"track-metadata-eventDetail="cloud.google.com/why-google-cloud/"track-metadata-module="footer"track-type="footer link"track-metadata-child_headline="why google"track-name="choosing google cloud"> Choosing Google Cloud </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/trust-center/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" track-name="trust and security"track-metadata-module="footer"track-metadata-position="footer"track-type="footer link"track-metadata-eventDetail="cloud.google.com/security/"track-metadata-child_headline="why google"> Trust and security </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/solutions/modern-infrastructure/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" track-name="modern infrastructure cloud"track-metadata-child_headline="why google"track-metadata-position="footer"track-metadata-eventDetail="cloud.google.com/solutions/modern-infrastructure/"track-metadata-module="footer"track-type="footer link"> Modern Infrastructure Cloud </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/multicloud/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)" track-metadata-eventDetail="cloud.google.com/multicloud/"track-metadata-module="footer"track-name="multicloud"track-metadata-child_headline="why google"track-metadata-position="footer"track-type="footer link"> Multicloud </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/infrastructure/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 5)" track-type="footer link"track-metadata-module="footer"track-metadata-eventDetail="cloud.google.com/infrastructure/"track-metadata-position="footer"track-name="global infrastructure"track-metadata-child_headline="why google"> Global infrastructure </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/customers/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 6)" track-metadata-module="footer"track-type="footer link"track-name="customers and case studies"track-metadata-child_headline="why google"track-metadata-position="footer"track-metadata-eventDetail="cloud.google.com/customers/"> Customers and case studies </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/analyst-reports/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 7)" track-metadata-position="footer"track-type="footer link"track-metadata-child_headline="why google"track-metadata-module="footer"track-name="analyst reports"track-metadata-eventDetail="cloud.google.com/analyst-reports/"> Analyst reports </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/whitepapers/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 8)" track-type="footer link"track-metadata-child_headline="why google"track-metadata-module="footer"track-name="whitepapers"track-metadata-eventDetail="cloud.google.com/whitepapers/"track-metadata-position="footer"> Whitepapers </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//cloud.google.com/blog/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 9)" track-metadata-position="footer"track-metadata-module="footer"track-type="footer link"track-name="blog"track-metadata-eventDetail="cloud.google.com/blog/"track-metadata-child_headline="engage"> Blog </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Products and pricing</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="/pricing/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" track-metadata-eventDetail="cloud.google.com/pricing/"track-metadata-position="footer"track-metadata-child_headline="products and pricing"track-name="google cloud pricing"track-type="footer link"track-metadata-module="footer"> Google Cloud pricing </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//workspace.google.com/pricing.html" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" track-metadata-module="footer"track-metadata-eventDetail="workspace.google.com/pricing.html"track-name="google workspace pricing"track-metadata-child_headline="products and pricing"target="_blank"track-metadata-position="footer"track-type="footer link"> Google Workspace pricing </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/products/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" track-metadata-child_headline="products and pricing"track-metadata-module="footer"track-metadata-position="footer"track-type="footer link"track-metadata-eventDetail="cloud.google.com/products/"track-name="see all products"> See all products </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Solutions</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="/solutions/infrastructure-modernization/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" track-metadata-module="footer"track-metadata-position="footer"track-metadata-child_headline="solutions"track-type="footer link"track-metadata-eventDetail="cloud.google.com/solutions/infrastructure-modernization/"track-name="infrastructure modernization"> Infrastructure modernization </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/solutions/databases/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" track-metadata-position="footer"track-name="databases"track-metadata-eventDetail="cloud.google.com/solutions/databases"track-metadata-child_headline="solutions"track-type="footer link"track-metadata-module="footer"> Databases </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/solutions/application-modernization/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" track-metadata-child_headline="solutions"track-metadata-eventDetail="cloud.google.com/solutions/application-modernization/"track-metadata-position="footer"track-metadata-module="footer"track-type="footer link"track-name="application development"> Application modernization </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/solutions/smart-analytics/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)" track-metadata-child_headline="solutions"track-name="smart analytics"track-metadata-eventDetail="cloud.google.com/solutions/smart-analytics/"track-metadata-position="footer"track-type="footer link"track-metadata-module="footer"> Smart analytics </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/solutions/ai/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 5)" track-type="footer link"track-metadata-eventDetail="cloud.google.com/solutions/ai/"track-metadata-position="footer"track-metadata-module="footer"track-name="artificial intelligence"track-metadata-child_headline="solutions"> Artificial Intelligence </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/solutions/security/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 6)" track-metadata-eventDetail="cloud.google.com/solutions/security/"track-type="footer link"track-metadata-child_headline="solutions"track-name="security"track-metadata-position="footer"track-metadata-module="footer"> Security </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://workspace.google.com/enterprise/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 7)" track-type="footer link"target="_blank"track-name="productivity and work transformation"track-metadata-eventDetail="workspace.google.com/enterprise/"track-metadata-child_headline="solutions"track-metadata-position="footer"track-metadata-module="footer"> Productivity & work transformation </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/solutions/#industry-solutions" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 8)" track-metadata-position="footer"track-type="footer link"track-metadata-eventDetail="cloud.google.com/solutions/#industry-solutions"track-name="industry solutions"track-metadata-module="footer"track-metadata-child_headline="solutions"> Industry solutions </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/solutions/devops/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 9)" track-type="footer link"track-metadata-eventDetail="cloud.google.com/solutions/devops/"track-metadata-position="footer"track-metadata-child_headline="solutions"track-metadata-module="footer"track-name="devops solutions"> DevOps solutions </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/solutions/#section-14" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 10)" track-metadata-position="footer"track-metadata-eventDetail="cloud.google.com/solutions/#section-14"track-name="small business solutions"track-metadata-child_headline="solutions"track-metadata-module="footer"track-type="footer link"> Small business solutions </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/solutions/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 11)" track-name="see all solutions"track-metadata-child_headline="solutions"track-metadata-module="footer"track-metadata-position="footer"track-type="footer link"track-metadata-eventDetail="cloud.google.com/solutions/"> See all solutions </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Resources</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="/affiliate-program/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" track-metadata-position="footer"track-type="footer link"track-metadata-module="footer"track-name="google cloud affiliate program"track-metadata-child_headline="resources"track-metadata-eventDetail="cloud.google.com/affiliate-program/"> Google Cloud Affiliate Program </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/docs/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" track-metadata-child_headline="resources"track-metadata-position="footer"track-metadata-module="footer"track-name="google cloud documentation"track-metadata-eventDetail="cloud.google.com/docs/"track-type="footer link"> Google Cloud documentation </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/docs/get-started/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" track-metadata-child_headline="resources"track-metadata-eventDetail="cloud.google.com/docs/get-started/"track-metadata-module="footer"track-metadata-position="footer"track-type="footer link"track-name="google cloud quickstarts"> Google Cloud quickstarts </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/marketplace/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)" track-metadata-module="footer"track-name="google cloud marketplace"track-type="footer link"track-metadata-eventDetail="cloud.google.com/marketplace/"track-metadata-position="footer"track-metadata-child_headline="resources"> Google Cloud Marketplace </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/discover/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 5)" track-metadata-child_headline="resources"track-type="footer link"track-name="learn about cloud computing"track-metadata-position="footer"track-metadata-module="footer"track-metadata-eventDetail="learn/"> Learn about cloud computing </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/support-hub/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 6)" track-metadata-module="footer"track-type="footer link"track-metadata-child_headline="resources"track-metadata-position="footer"track-name="support"track-metadata-eventDetail="cloud.google.com/support-hub/"> Support </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/docs/samples" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 7)" track-metadata-position="footer"track-type="footer link"track-metadata-module="footer"track-name="code samples"track-metadata-eventDetail="cloud.google.com/docs/samples"track-metadata-child_headline="resources"> Code samples </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/architecture/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 8)" track-metadata-module="footer"track-type="footer link"track-metadata-eventDetail="cloud.google.com/architecture/"track-metadata-child_headline="resources"track-metadata-position="footer"track-name="cloud architecture center"> Cloud Architecture Center </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/learn/training/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 9)" track-name="training"track-metadata-module="footer"track-metadata-position="footer"track-type="footer link"track-metadata-eventDetail="cloud.google.com/training/"track-metadata-child_headline="resources"> Training </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/learn/certification/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 10)" track-metadata-child_headline="resources"track-metadata-module="footer"track-name="certifications"track-type="footer link"track-metadata-eventDetail="cloud.google.com/certification"track-metadata-position="footer"> Certifications </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//developers.google.com" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 11)" track-name="google developers"track-metadata-position="footer"track-metadata-eventDetail="developers.google.com"track-type="footer link"track-metadata-module="footer"target="_blank"track-metadata-child_headline="resources"> Google for Developers </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/startup/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 12)" track-type="footer link"track-name="google cloud for startups"track-metadata-child_headline="resources"track-metadata-position="footer"track-metadata-eventDetail="cloud.google.com/startup/"track-metadata-module="footer"> Google Cloud for Startups </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//status.cloud.google.com" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 13)" track-name="system status"target="_blank"track-metadata-child_headline="resources"track-metadata-position="footer"track-metadata-module="footer"track-metadata-eventDetail="status.cloud.google.com"track-type="footer link"> System status </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/release-notes" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 14)" track-name="release notes"track-metadata-eventDetail="cloud.google.com/release-notes/"track-metadata-module="footer"track-metadata-position="footer"track-type="footer link"track-metadata-child_headline="resources"> Release Notes </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Engage</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="/contact/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" track-metadata-eventDetail="cloud.google.com/contact/"track-metadata-child_headline="engage"track-name="contact sales"track-metadata-position="footer"track-type="footer link"track-metadata-module="footer"> Contact sales </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//cloud.google.com/find-a-partner" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" track-type="footer link"track-metadata-position="footer"track-metadata-child_headline="engage"track-metadata-eventDetail="cloud.google.com/find-a-partner"track-metadata-module="footer"track-name="find a partner"target="_blank"> Find a Partner </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/partners/become-a-partner/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" track-metadata-eventDetail="cloud.google.com/partners/become-a-partner/"track-metadata-child_headline="engage"track-metadata-module="footer"track-name="become a partner"track-metadata-position="footer"track-type="footer link"> Become a Partner </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/events/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)" track-metadata-child_headline="engage"track-name="events"track-type="footer link"track-metadata-module="footer"track-metadata-position="footer"track-metadata-eventDetail="cloud.withgoogle.com/events"> Events </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/podcasts/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 5)" rel="noopener"track-metadata-position="footer"track-metadata-module="footer"track-type="footer link"track-metadata-child_headline="engage"track-name="podcasts"track-metadata-eventDetail="cloud.google.com/podcasts/"target="_blank"> Podcasts </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/developers/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 6)" track-metadata-position="footer"track-name="developer center"track-metadata-eventDetail="cloud.google.com/developers/"track-type="footer link"track-metadata-child_headline="engage"track-metadata-module="footer"> Developer Center </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://www.googlecloudpresscorner.com/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 7)" track-metadata-child_headline="engage"track-type="footer link"track-metadata-module="footer"track-metadata-position="footer"target="_blank"rel="noopener"track-name="press corner"track-metadata-eventDetail="www.googlecloudpresscorner.com"> Press Corner </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//www.youtube.com/googlecloud" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 8)" track-metadata-child_headline="engage"track-metadata-module="footer"track-metadata-eventDetail="www.youtube.com/googlecloud"track-name="google cloud on youtube"target="_blank"track-type="footer link"track-metadata-position="footer"rel="noopener"> Google Cloud on YouTube </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//www.youtube.com/googlecloudplatform" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 9)" track-type="footer link"target="_blank"rel="noopener"track-metadata-position="footer"track-name="google cloud tech on youtube"track-metadata-module="footer"track-metadata-eventDetail="www.youtube.com/googlecloudplatform"track-metadata-child_headline="engage"> Google Cloud Tech on YouTube </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//x.com/googlecloud" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 10)" track-metadata-eventDetail="x.com/googlecloud"rel="noopener"track-metadata-child_headline="engage"track-metadata-position="footer"track-type="footer link"target="_blank"track-metadata-module="footer"track-name="follow on x"> Follow on X </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//userresearch.google.com/?reserved=1&utm_source=website&Q_Language=en&utm_medium=own_srch&utm_campaign=CloudWebFooter&utm_term=0&utm_content=0&productTag=clou&campaignDate=jul19&pType=devel&referral_code=jk212693" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 11)" track-metadata-module="footer"track-metadata-eventDetail="userresearch.google.com/?reserved=1&utm_source=website&Q_Language=en&utm_medium=own_srch&utm_campaign=CloudWebFooter&utm_term=0&utm_content=0&productTag=clou&campaignDate=jul19&pType=devel&referral_code=jk212693"track-type="footer link"track-metadata-child_headline="engage"target="_blank"track-metadata-position="footer"track-name="join user research"> Join User Research </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//careers.google.com/cloud" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 12)" track-type="footer link"track-metadata-eventDetail="careers.google.com/cloud"track-metadata-child_headline="engage"target="_blank"track-name="we are hiring join google cloud"track-metadata-module="footer"track-metadata-position="footer"> We're hiring. Join Google Cloud! </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://www.googlecloudcommunity.com/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 13)" track-metadata-child_headline="engage"track-metadata-position="footer"track-metadata-module="footer"track-type="footer link"track-name="google cloud community"track-metadata-eventDetail="www.googlecloudcommunity.com"target="_blank"rel="noopener"> Google Cloud Community </a> </li> </ul> </li> </ul> </nav> </devsite-footer-linkboxes> <devsite-footer-utility class="devsite-footer"> <div class="devsite-footer-utility nocontent"> <nav class="devsite-footer-utility-links" aria-label="Utility links"> <ul class="devsite-footer-utility-list"> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="//about.google/" data-category="Site-Wide Custom Events" data-label="Footer About Google link" track-metadata-module="utility footer" target="_blank" track-name="about google" track-metadata-position="footer" track-metadata-eventDetail="//about.google/" track-type="footer link" > About Google </a> </li> <li class="devsite-footer-utility-item devsite-footer-privacy-link"> <a class="devsite-footer-utility-link gc-analytics-event" href="//policies.google.com/privacy" data-category="Site-Wide Custom Events" data-label="Footer Privacy link" track-metadata-module="utility footer" track-metadata-position="footer" target="_blank" track-name="privacy" track-metadata-eventDetail="//policies.google.com/privacy" track-type="footer link" > Privacy </a> </li> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="//www.google.com/intl/en/policies/terms/regional.html" data-category="Site-Wide Custom Events" data-label="Footer Site terms link" target="_blank" track-metadata-module="utility footer" track-type="footer link" track-metadata-eventDetail="//www.google.com/intl/en/policies/terms/regional.html" track-metadata-position="footer" track-name="site terms" > Site terms </a> </li> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="/product-terms/" data-category="Site-Wide Custom Events" data-label="Footer Google Cloud terms link" track-metadata-eventDetail="/product-terms/" track-metadata-position="footer" track-metadata-module="utility footer" track-name="google cloud terms" track-type="footer link" > Google Cloud terms </a> </li> <li class="devsite-footer-utility-item glue-cookie-notification-bar-control"> <a class="devsite-footer-utility-link gc-analytics-event" href="#" data-category="Site-Wide Custom Events" data-label="Footer Manage cookies link" track-name="Manage cookies" track-metadata-eventDetail="#" track-type="footer link" track-metadata-module="utility footer" track-metadata-position="footer" aria-hidden="true" > Manage cookies </a> </li> <li class="devsite-footer-utility-item devsite-footer-carbon-button"> <a class="devsite-footer-utility-link gc-analytics-event" href="/sustainability" data-category="Site-Wide Custom Events" data-label="Footer Our third decade of climate action: join us link" track-metadata-module="utility footer" track-metadata-eventDetail="/sustainability/" track-metadata-position="footer" track-name="Our third decade of climate action: join us" track-type="footer link" > Our third decade of climate action: join us </a> </li> <li class="devsite-footer-utility-item devsite-footer-utility-button"> Sign up for the Google Cloud newsletter <a class="devsite-footer-utility-link gc-analytics-event" href="/newsletter/" data-category="Site-Wide Custom Events" data-label="Footer Subscribe link" track-type="footer link" track-metadata-position="footer" track-metadata-eventDetail="/newsletter/" track-metadata-module="utility footer" track-name="subscribe" > Subscribe </a> </li> </ul> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> </nav> </div> </devsite-footer-utility> <devsite-panel></devsite-panel> </section></section> <devsite-sitemask></devsite-sitemask> <devsite-snackbar></devsite-snackbar> <devsite-tooltip ></devsite-tooltip> <devsite-heading-link></devsite-heading-link> <devsite-analytics> <script type="application/json" analytics>[]</script> <script type="application/json" tag-management>{"at": "True", "ga4": [], "ga4p": [], "gtm": [{"id": "GTM-5CVQBG", "purpose": 1}], "parameters": {"internalUser": "False", "language": {"machineTranslated": "False", "requested": "en", "served": "en"}, "pageType": "article", "projectName": "Cloud Storage", "signedIn": "False", "tenant": "cloud", "recommendations": {"sourcePage": "", "sourceType": 0, "sourceRank": 0, "sourceIdenticalDescriptions": 0, "sourceTitleWords": 0, "sourceDescriptionWords": 0, "experiment": ""}, "experiment": {"ids": ""}}}</script> </devsite-analytics> <devsite-badger></devsite-badger> <cloudx-user></cloudx-user> <cloudx-free-trial-eligible-store freeTrialEligible='true'></cloudx-free-trial-eligible-store> <cloudx-pricing-socket></cloudx-pricing-socket> <cloudx-experiments type="TestAACodivertedExperiment" path="/virtual/TestAACodivertedExperiment/configureExperiment" location="SG" variant="variant2" ></cloudx-experiments> <cloudx-experiment-ids userCountry="SG" devsiteExperimentIdList="[39300012, 39300022, 39300118, 39300195, 39300251, 39300317, 39300320, 39300327, 39300345, 39300354, 39300363, 39300374, 39300412, 39300422, 39300436, 39300471, 39300487, 39300496, 39300498]"> </cloudx-experiment-ids> <script nonce="oh9H47nXf/lpf7BYQIzExGmjFl/fnG"> (function(d,e,v,s,i,t,E){d['GoogleDevelopersObject']=i; t=e.createElement(v);t.async=1;t.src=s;E=e.getElementsByTagName(v)[0]; E.parentNode.insertBefore(t,E);})(window, document, 'script', 'https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/cloud/js/app_loader.js', '[2,"en",null,"/js/devsite_app_module.js","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/cloud","https://cloud-dot-devsite-v2-prod.appspot.com",null,null,["/_pwa/cloud/manifest.json","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/images/video-placeholder.svg","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/cloud/images/favicons/onecloud/favicon.ico","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/cloud/images/cloud-logo.svg","https://fonts.googleapis.com/css?family=Google+Sans:400,500,700|Google+Sans+Text:400,400italic,500,500italic,700,700italic|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"],1,null,[1,6,8,12,14,17,21,25,50,52,63,70,75,76,80,87,91,92,93,97,98,100,101,102,103,104,105,107,108,109,110,112,113,116,117,118,120,122,124,125,126,127,129,130,131,132,133,134,135,136,138,140,141,147,148,149,151,152,156,157,158,159,161,163,164,168,169,170,179,180,182,183,186,191,193,196],"AIzaSyAP-jjEJBzmIyKR4F-3XITp8yM9T1gEEI8","AIzaSyB6xiKGDR5O3Ak2okS4rLkauxGUG7XP0hg","cloud.google.com","AIzaSyAQk0fBONSGUqCNznf6Krs82Ap1-NV6J4o","AIzaSyCCxcqdrZ_7QMeLCRY20bh_SXdAYqy70KY",null,null,null,["Profiles__enable_profile_collections","Profiles__enable_recognition_badges","Cloud__enable_cloud_shell_fte_user_flow","Search__enable_ai_search_summaries_restricted","Search__enable_page_map","Search__enable_suggestions_from_borg","Experiments__reqs_query_experiments","MiscFeatureFlags__enable_explain_this_code","Cloud__enable_cloud_facet_chat","Cloud__enable_cloud_shell","Profiles__require_profile_eligibility_for_signin","Search__enable_ai_search_summaries","MiscFeatureFlags__enable_variable_operator","MiscFeatureFlags__developers_footer_image","MiscFeatureFlags__emergency_css","Concierge__enable_concierge_restricted","Cloud__enable_cloudx_ping","Search__enable_dynamic_content_confidential_banner","EngEduTelemetry__enable_engedu_telemetry","Cloud__enable_cloudx_experiment_ids","Profiles__enable_developer_profiles_callout","Profiles__enable_release_notes_notifications","Concierge__enable_pushui","Profiles__enable_public_developer_profiles","Profiles__enable_page_saving","Profiles__enable_dashboard_curated_recommendations","Profiles__enable_awarding_url","Cloud__enable_free_trial_server_call","BookNav__enable_tenant_cache_key","Cloud__enable_llm_concierge_chat","CloudShell__cloud_code_overflow_menu","TpcFeatures__enable_mirror_tenant_redirects","CloudShell__cloud_shell_button","Profiles__enable_complete_playlist_endpoint","Search__enable_ai_eligibility_checks","TpcFeatures__enable_required_headers","MiscFeatureFlags__developers_footer_dark_image","Profiles__enable_completecodelab_endpoint","Search__scope_to_project_tenant","Cloud__enable_cloud_dlp_service","DevPro__enable_developer_subscriptions","Cloud__enable_legacy_calculator_redirect","MiscFeatureFlags__enable_firebase_utm","MiscFeatureFlags__enable_project_variables","Analytics__enable_clearcut_logging","MiscFeatureFlags__enable_view_transitions","DevPro__enable_cloud_innovators_plus"],null,null,"AIzaSyBLEMok-5suZ67qRPzx0qUtbnLmyT_kCVE","https://developerscontentserving-pa.clients6.google.com","AIzaSyCM4QpTRSqP5qI4Dvjt4OAScIN8sOUlO-k","https://developerscontentsearch-pa.clients6.google.com",1,4,1,"https://developerprofiles-pa.clients6.google.com",[2,"cloud","Google Cloud","cloud.google.com",null,"cloud-dot-devsite-v2-prod.appspot.com",null,null,[1,1,null,null,null,null,null,null,null,null,null,[1],null,null,null,null,null,1,[1],[null,null,null,[1,20],"/terms/recommendations"],[1],null,[1],[1,null,1],[1,1,null,null,1,null,["/vertex-ai/"]]],null,[22,null,null,null,null,null,"/images/cloud-logo.svg","/images/favicons/onecloud/apple-icon.png",null,null,null,null,1,1,1,[6,5],[],null,null,[[],[],[],[],[],[],[],[]],null,1,null,null,null,null,[]],[],null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,[6,1,14,15,22,23,29,37],null,[[null,null,null,null,null,null,[1,[["docType","Choose a content type",[["ApiReference",null,null,null,null,null,null,null,null,"API reference"],["Sample",null,null,null,null,null,null,null,null,"Code sample"],["ReferenceArchitecture",null,null,null,null,null,null,null,null,"Reference architecture"],["Tutorial",null,null,null,null,null,null,null,null,"Tutorial"]]],["category","Choose a topic",[["AiAndMachineLearning",null,null,null,null,null,null,null,null,"Artificial intelligence and machine learning (AI/ML)"],["ApplicationDevelopment",null,null,null,null,null,null,null,null,"Application development"],["BigDataAndAnalytics",null,null,null,null,null,null,null,null,"Big data and analytics"],["Compute",null,null,null,null,null,null,null,null,"Compute"],["Containers",null,null,null,null,null,null,null,null,"Containers"],["Databases",null,null,null,null,null,null,null,null,"Databases"],["HybridCloud",null,null,null,null,null,null,null,null,"Hybrid and multicloud"],["LoggingAndMonitoring",null,null,null,null,null,null,null,null,"Logging and monitoring"],["Migrations",null,null,null,null,null,null,null,null,"Migrations"],["Networking",null,null,null,null,null,null,null,null,"Networking"],["SecurityAndCompliance",null,null,null,null,null,null,null,null,"Security and compliance"],["Serverless",null,null,null,null,null,null,null,null,"Serverless"],["Storage",null,null,null,null,null,null,null,null,"Storage"]]]]]],[1],null,1],[[null,null,null,null,null,["GTM-5CVQBG"],null,null,null,null,null,[["GTM-5CVQBG",2]],1],null,null,null,null,null,1],"mwETRvWii0eU5NUYprb0Y9z5GVbc",4,null,null,null,null,null,null,null,null,null,null,null,null,null,"cloud.devsite.google"],null,"pk_live_5170syrHvgGVmSx9sBrnWtA5luvk9BwnVcvIi7HizpwauFG96WedXsuXh790rtij9AmGllqPtMLfhe2RSwD6Pn38V00uBCydV4m"]') </script> <devsite-a11y-announce></devsite-a11y-announce> </body> </html>

CINXE.COM

Enable and use object retention configurations | Cloud Storage | Google Cloud