Files
google-apis-rs/google_logging2_cli/projects_locations-buckets-patch/index.html
2022-03-08 15:36:16 +08:00

1242 lines
47 KiB
HTML

<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Locations Buckets Patch - Logging v3.0.0+20220225</title>
<link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'>
<link rel="stylesheet" href="../css/theme.css" type="text/css" />
<link rel="stylesheet" href="../css/theme_extra.css" type="text/css" />
<link rel="stylesheet" href="../css/highlight.css">
<script src="//cdnjs.cloudflare.com/ajax/libs/jquery/2.1.1/jquery.min.js"></script>
<script src="//cdnjs.cloudflare.com/ajax/libs/modernizr/2.8.3/modernizr.min.js"></script>
<script type="text/javascript" src="../js/highlight.pack.js"></script>
<script src="../js/theme.js"></script>
<style>
body {font-size: 90%;}
pre, code {font-size: 100%;}
h3, h4, h5, h6 {color: #2980b9; font-weight: 300}
</style>
</head>
<body class="wy-body-for-nav" role="document">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
<div class="wy-side-nav-search">
<a href=".." class="icon icon-home"> Logging v3.0.0+20220225</a>
</div>
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
<ul class="current">
<span>Billing Accounts</span>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_buckets-get">Buckets Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_buckets-views-get">Buckets Views Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_exclusions-create">Exclusions Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_exclusions-delete">Exclusions Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_exclusions-get">Exclusions Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_exclusions-list">Exclusions List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_exclusions-patch">Exclusions Patch</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_get-cmek-settings">Get Cmek Settings</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_get-settings">Get Settings</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_locations-buckets-create">Locations Buckets Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_locations-buckets-delete">Locations Buckets Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_locations-buckets-list">Locations Buckets List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_locations-buckets-patch">Locations Buckets Patch</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_locations-buckets-undelete">Locations Buckets Undelete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_locations-buckets-views-create">Locations Buckets Views Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_locations-buckets-views-delete">Locations Buckets Views Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_locations-buckets-views-list">Locations Buckets Views List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_locations-buckets-views-patch">Locations Buckets Views Patch</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_locations-get">Locations Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_locations-list">Locations List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_locations-operations-cancel">Locations Operations Cancel</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_locations-operations-list">Locations Operations List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_logs-delete">Logs Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_logs-list">Logs List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_operations-get">Operations Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_sinks-create">Sinks Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_sinks-delete">Sinks Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_sinks-get">Sinks Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_sinks-list">Sinks List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_sinks-patch">Sinks Patch</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../billing-accounts_sinks-update">Sinks Update</a>
</li>
<span>Entries</span>
<li class="toctree-l1 ">
<a class="" href="../entries_copy">Copy</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../entries_list">List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../entries_tail">Tail</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../entries_write">Write</a>
</li>
<span>Exclusions</span>
<li class="toctree-l1 ">
<a class="" href="../exclusions_create">Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../exclusions_delete">Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../exclusions_get">Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../exclusions_list">List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../exclusions_patch">Patch</a>
</li>
<span>Folders</span>
<li class="toctree-l1 ">
<a class="" href="../folders_exclusions-create">Exclusions Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_exclusions-delete">Exclusions Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_exclusions-get">Exclusions Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_exclusions-list">Exclusions List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_exclusions-patch">Exclusions Patch</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_get-cmek-settings">Get Cmek Settings</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_get-settings">Get Settings</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_locations-buckets-create">Locations Buckets Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_locations-buckets-delete">Locations Buckets Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_locations-buckets-get">Locations Buckets Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_locations-buckets-list">Locations Buckets List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_locations-buckets-patch">Locations Buckets Patch</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_locations-buckets-undelete">Locations Buckets Undelete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_locations-buckets-views-create">Locations Buckets Views Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_locations-buckets-views-delete">Locations Buckets Views Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_locations-buckets-views-get">Locations Buckets Views Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_locations-buckets-views-list">Locations Buckets Views List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_locations-buckets-views-patch">Locations Buckets Views Patch</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_locations-get">Locations Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_locations-list">Locations List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_locations-operations-cancel">Locations Operations Cancel</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_locations-operations-get">Locations Operations Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_locations-operations-list">Locations Operations List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_logs-delete">Logs Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_logs-list">Logs List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_sinks-create">Sinks Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_sinks-delete">Sinks Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_sinks-get">Sinks Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_sinks-list">Sinks List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_sinks-patch">Sinks Patch</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_sinks-update">Sinks Update</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../folders_update-settings">Update Settings</a>
</li>
<span>Locations</span>
<li class="toctree-l1 ">
<a class="" href="../locations_buckets-create">Buckets Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../locations_buckets-delete">Buckets Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../locations_buckets-get">Buckets Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../locations_buckets-list">Buckets List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../locations_buckets-patch">Buckets Patch</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../locations_buckets-undelete">Buckets Undelete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../locations_buckets-views-create">Buckets Views Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../locations_buckets-views-delete">Buckets Views Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../locations_buckets-views-get">Buckets Views Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../locations_buckets-views-list">Buckets Views List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../locations_buckets-views-patch">Buckets Views Patch</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../locations_get">Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../locations_list">List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../locations_operations-cancel">Operations Cancel</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../locations_operations-get">Operations Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../locations_operations-list">Operations List</a>
</li>
<span>Logs</span>
<li class="toctree-l1 ">
<a class="" href="../logs_delete">Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../logs_list">List</a>
</li>
<span>Methods</span>
<li class="toctree-l1 ">
<a class="" href="../methods_get-cmek-settings">Get Cmek Settings</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../methods_get-settings">Get Settings</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../methods_update-cmek-settings">Update Cmek Settings</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../methods_update-settings">Update Settings</a>
</li>
<span>Monitored Resource Descriptors</span>
<li class="toctree-l1 ">
<a class="" href="../monitored-resource-descriptors_list">List</a>
</li>
<span>Organizations</span>
<li class="toctree-l1 ">
<a class="" href="../organizations_exclusions-create">Exclusions Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_exclusions-delete">Exclusions Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_exclusions-get">Exclusions Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_exclusions-list">Exclusions List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_exclusions-patch">Exclusions Patch</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_get-cmek-settings">Get Cmek Settings</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_get-settings">Get Settings</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_locations-buckets-create">Locations Buckets Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_locations-buckets-delete">Locations Buckets Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_locations-buckets-get">Locations Buckets Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_locations-buckets-list">Locations Buckets List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_locations-buckets-patch">Locations Buckets Patch</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_locations-buckets-undelete">Locations Buckets Undelete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_locations-buckets-views-create">Locations Buckets Views Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_locations-buckets-views-delete">Locations Buckets Views Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_locations-buckets-views-get">Locations Buckets Views Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_locations-buckets-views-list">Locations Buckets Views List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_locations-buckets-views-patch">Locations Buckets Views Patch</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_locations-get">Locations Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_locations-list">Locations List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_locations-operations-cancel">Locations Operations Cancel</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_locations-operations-get">Locations Operations Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_locations-operations-list">Locations Operations List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_logs-delete">Logs Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_logs-list">Logs List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_sinks-create">Sinks Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_sinks-delete">Sinks Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_sinks-get">Sinks Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_sinks-list">Sinks List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_sinks-patch">Sinks Patch</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_sinks-update">Sinks Update</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_update-cmek-settings">Update Cmek Settings</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../organizations_update-settings">Update Settings</a>
</li>
<span>Projects</span>
<li class="toctree-l1 ">
<a class="" href="../projects_exclusions-create">Exclusions Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_exclusions-delete">Exclusions Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_exclusions-get">Exclusions Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_exclusions-list">Exclusions List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_exclusions-patch">Exclusions Patch</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_get-cmek-settings">Get Cmek Settings</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_get-settings">Get Settings</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_locations-buckets-create">Locations Buckets Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_locations-buckets-delete">Locations Buckets Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_locations-buckets-get">Locations Buckets Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_locations-buckets-list">Locations Buckets List</a>
</li>
<li class="toctree-l1 current">
<a class="current" href=".">Locations Buckets Patch</a>
<ul>
<li class="toctree-l2"><a href="#scopes">Scopes</a></li>
<li class="toctree-l2"><a href="#required-scalar-argument">Required Scalar Argument</a></li>
<li class="toctree-l2"><a href="#required-request-value">Required Request Value</a></li>
<li><a class="toctree-l3" href="#about-cursors">About Cursors</a></li>
<li class="toctree-l2"><a href="#optional-output-flags">Optional Output Flags</a></li>
<li class="toctree-l2"><a href="#optional-method-properties">Optional Method Properties</a></li>
<li class="toctree-l2"><a href="#optional-general-properties">Optional General Properties</a></li>
</ul>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_locations-buckets-undelete">Locations Buckets Undelete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_locations-buckets-views-create">Locations Buckets Views Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_locations-buckets-views-delete">Locations Buckets Views Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_locations-buckets-views-get">Locations Buckets Views Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_locations-buckets-views-list">Locations Buckets Views List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_locations-buckets-views-patch">Locations Buckets Views Patch</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_locations-get">Locations Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_locations-list">Locations List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_locations-operations-cancel">Locations Operations Cancel</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_locations-operations-get">Locations Operations Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_locations-operations-list">Locations Operations List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_logs-delete">Logs Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_logs-list">Logs List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_metrics-create">Metrics Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_metrics-delete">Metrics Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_metrics-get">Metrics Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_metrics-list">Metrics List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_metrics-update">Metrics Update</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_sinks-create">Sinks Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_sinks-delete">Sinks Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_sinks-get">Sinks Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_sinks-list">Sinks List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_sinks-patch">Sinks Patch</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../projects_sinks-update">Sinks Update</a>
</li>
<span>Sinks</span>
<li class="toctree-l1 ">
<a class="" href="../sinks_create">Create</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../sinks_delete">Delete</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../sinks_get">Get</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../sinks_list">List</a>
</li>
<li class="toctree-l1 ">
<a class="" href="../sinks_update">Update</a>
</li>
</ul>
</div>
&nbsp;
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
<i data-toggle="wy-nav-top" class="icon icon-reorder"></i>
<a href=".."></a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
<li><a href="..">Docs</a> &raquo;</li>
<li>Locations Buckets Patch</li>
<li class="wy-breadcrumbs-aside">
<a href="https://github.com/Byron/google-apis-rs/tree/main/gen/logging2-cli" class="icon icon-github"> Edit on GitHub</a>
</li>
</ul>
<hr/>
</div>
<div role="main">
<div class="section">
<p>Updates a log bucket. This method replaces the following fields in the existing bucket with values from the new bucket: retention_periodIf the retention period is decreased and the bucket is locked, FAILED_PRECONDITION will be returned.If the bucket has a lifecycle_state of DELETE_REQUESTED, then FAILED_PRECONDITION will be returned.After a bucket has been created, the bucket&#39;s location cannot be changed.</p>
<h1 id="scopes">Scopes</h1>
<p>You will need authorization for at least one of the following scopes to make a valid call:</p>
<ul>
<li><em>https://www.googleapis.com/auth/cloud-platform</em></li>
<li><em>https://www.googleapis.com/auth/logging.admin</em></li>
</ul>
<p>If unset, the scope for this method defaults to <em>https://www.googleapis.com/auth/cloud-platform</em>.
You can set the scope for this method like this: <code>logging2 --scope &lt;scope&gt; projects locations-buckets-patch ...</code></p>
<h1 id="required-scalar-argument">Required Scalar Argument</h1>
<ul>
<li><strong>&lt;name&gt;</strong> <em>(string)</em><ul>
<li>Required. The full resource name of the bucket to update. &#34;projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]&#34; &#34;organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]&#34; &#34;billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]&#34; &#34;folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]&#34; For example:&#34;projects/my-project/locations/global/buckets/my-bucket&#34;</li>
</ul>
</li>
</ul>
<h1 id="required-request-value">Required Request Value</h1>
<p>The request value is a data-structure with various fields. Each field may be a simple scalar or another data-structure.
In the latter case it is advised to set the field-cursor to the data-structure's field to specify values more concisely.</p>
<p>For example, a structure like this:</p>
<pre><code>LogBucket:
cmek-settings:
kms-key-name: string
name: string
service-account-id: string
create-time: string
description: string
lifecycle-state: string
locked: boolean
name: string
restricted-fields: [string]
retention-days: integer
update-time: string
</code></pre>
<p>can be set completely with the following arguments which are assumed to be executed in the given order. Note how the cursor position is adjusted to the respective structures, allowing simple field names to be used most of the time.</p>
<ul>
<li><code>-r .cmek-settings kms-key-name=erat</code><ul>
<li>The resource name for the configured Cloud KMS key.KMS key name format: &#34;projects/[PROJECT_ID]/locations/[LOCATION]/keyRings/[KEYRING]/cryptoKeys/[KEY]&#34; For example:&#34;projects/my-project/locations/us-central1/keyRings/my-ring/cryptoKeys/my-key&#34;To enable CMEK for the Log Router, set this field to a valid kms_key_name for which the associated service account has the required cloudkms.cryptoKeyEncrypterDecrypter roles assigned for the key.The Cloud KMS key used by the Log Router can be updated by changing the kms_key_name to a new valid key name or disabled by setting the key name to an empty string. Encryption operations that are in progress will be completed with the key that was in use when they started. Decryption operations will be completed using the key that was used at the time of encryption unless access to that key has been revoked.To disable CMEK for the Log Router, set this field to an empty string.See Enabling CMEK for Log Router (https://cloud.google.com/logging/docs/routing/managed-encryption) for more information.</li>
</ul>
</li>
<li><code>name=sit</code><ul>
<li>Output only. The resource name of the CMEK settings.</li>
</ul>
</li>
<li>
<p><code>service-account-id=accusam</code></p>
<ul>
<li>Output only. The service account that will be used by the Log Router to access your Cloud KMS key.Before enabling CMEK for Log Router, you must first assign the cloudkms.cryptoKeyEncrypterDecrypter role to the service account that the Log Router will use to access your Cloud KMS key. Use GetCmekSettings to obtain the service account ID.See Enabling CMEK for Log Router (https://cloud.google.com/logging/docs/routing/managed-encryption) for more information.</li>
</ul>
</li>
<li>
<p><code>.. create-time=et</code></p>
<ul>
<li>Output only. The creation timestamp of the bucket. This is not set for any of the default buckets.</li>
</ul>
</li>
<li><code>description=nonumy</code><ul>
<li>Describes this bucket.</li>
</ul>
</li>
<li><code>lifecycle-state=accusam</code><ul>
<li>Output only. The bucket lifecycle state.</li>
</ul>
</li>
<li><code>locked=false</code><ul>
<li>Whether the bucket is locked.The retention period on a locked bucket cannot be changed. Locked buckets may only be deleted if they are empty.</li>
</ul>
</li>
<li><code>name=consetetur</code><ul>
<li>Output only. The resource name of the bucket.For example:projects/my-project/locations/global/buckets/my-bucketFor a list of supported locations, see Supported Regions (https://cloud.google.com/logging/docs/region-support)For the location of global it is unspecified where log entries are actually stored.After a bucket has been created, the location cannot be changed.</li>
</ul>
</li>
<li><code>restricted-fields=dolor</code><ul>
<li>Log entry field paths that are denied access in this bucket.The following fields and their children are eligible: textPayload, jsonPayload, protoPayload, httpRequest, labels, sourceLocation.Restricting a repeated field will restrict all values. Adding a parent will block all child fields. (e.g. foo.bar will block foo.bar.baz)</li>
<li>Each invocation of this argument appends the given value to the array.</li>
</ul>
</li>
<li><code>retention-days=54</code><ul>
<li>Logs will be retained by default for this amount of time, after which they will automatically be deleted. The minimum retention period is 1 day. If this value is set to zero at bucket creation time, the default time of 30 days will be used.</li>
</ul>
</li>
<li><code>update-time=et</code><ul>
<li>Output only. The last update timestamp of the bucket.</li>
</ul>
</li>
</ul>
<h3 id="about-cursors">About Cursors</h3>
<p>The cursor position is key to comfortably set complex nested structures. The following rules apply:</p>
<ul>
<li>The cursor position is always set relative to the current one, unless the field name starts with the <code>.</code> character. Fields can be nested such as in <code>-r f.s.o</code> .</li>
<li>The cursor position is set relative to the top-level structure if it starts with <code>.</code>, e.g. <code>-r .s.s</code></li>
<li>You can also set nested fields without setting the cursor explicitly. For example, to set a value relative to the current cursor position, you would specify <code>-r struct.sub_struct=bar</code>.</li>
<li>You can move the cursor one level up by using <code>..</code>. Each additional <code>.</code> moves it up one additional level. E.g. <code>...</code> would go three levels up.</li>
</ul>
<h1 id="optional-output-flags">Optional Output Flags</h1>
<p>The method's return value a JSON encoded structure, which will be written to standard output by default.</p>
<ul>
<li><strong>-o out</strong><ul>
<li><em>out</em> specifies the <em>destination</em> to which to write the server's result to.
It will be a JSON-encoded structure.
The <em>destination</em> may be <code>-</code> to indicate standard output, or a filepath that is to contain the received bytes.
If unset, it defaults to standard output.</li>
</ul>
</li>
</ul>
<h1 id="optional-method-properties">Optional Method Properties</h1>
<p>You may set the following properties to further configure the call. Please note that <code>-p</code> is followed by one
or more key-value-pairs, and is called like this <code>-p k1=v1 k2=v2</code> even though the listing below repeats the
<code>-p</code> for completeness.</p>
<ul>
<li><strong>-p update-mask=string</strong><ul>
<li>Required. Field mask that specifies the fields in bucket that need an update. A bucket field will be overwritten if, and only if, it is in the update mask. name and output only fields cannot be updated.For a detailed FieldMask definition, see: https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=retention_days</li>
</ul>
</li>
</ul>
<h1 id="optional-general-properties">Optional General Properties</h1>
<p>The following properties can configure any call, and are not specific to this method.</p>
<ul>
<li>
<p><strong>-p $-xgafv=string</strong></p>
<ul>
<li>V1 error format.</li>
</ul>
</li>
<li>
<p><strong>-p access-token=string</strong></p>
<ul>
<li>OAuth access token.</li>
</ul>
</li>
<li>
<p><strong>-p alt=string</strong></p>
<ul>
<li>Data format for response.</li>
</ul>
</li>
<li>
<p><strong>-p callback=string</strong></p>
<ul>
<li>JSONP</li>
</ul>
</li>
<li>
<p><strong>-p fields=string</strong></p>
<ul>
<li>Selector specifying which fields to include in a partial response.</li>
</ul>
</li>
<li>
<p><strong>-p key=string</strong></p>
<ul>
<li>API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.</li>
</ul>
</li>
<li>
<p><strong>-p oauth-token=string</strong></p>
<ul>
<li>OAuth 2.0 token for the current user.</li>
</ul>
</li>
<li>
<p><strong>-p pretty-print=boolean</strong></p>
<ul>
<li>Returns response with indentations and line breaks.</li>
</ul>
</li>
<li>
<p><strong>-p quota-user=string</strong></p>
<ul>
<li>Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.</li>
</ul>
</li>
<li>
<p><strong>-p upload-type=string</strong></p>
<ul>
<li>Legacy upload protocol for media (e.g. &#34;media&#34;, &#34;multipart&#34;).</li>
</ul>
</li>
<li>
<p><strong>-p upload-protocol=string</strong></p>
<ul>
<li>Upload protocol for media (e.g. &#34;raw&#34;, &#34;multipart&#34;).</li>
</ul>
</li>
</ul>
</div>
</div>
<footer>
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
<a href="../projects_locations-buckets-undelete" class="btn btn-neutral float-right" title="Locations Buckets Undelete"/>Next <span class="icon icon-circle-arrow-right"></span></a>
<a href="../projects_locations-buckets-list" class="btn btn-neutral" title="Locations Buckets List"><span class="icon icon-circle-arrow-left"></span> Previous</a>
</div>
<hr/>
<div role="contentinfo">
<p>
<!-- Copyright etc -->
</p>
</div>
Built with <a href="http://www.mkdocs.org">MkDocs</a>, using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<div class="rst-versions" role="note" style="cursor: pointer">
<span class="rst-current-version" data-toggle="rst-current-version">
<a class="icon icon-github" style="float: left; color: #fcfcfc"> GitHub</a>
<span><a href="../projects_locations-buckets-list" style="color: #fcfcfc;">&laquo; Previous</a></span>
<span style="margin-left: 15px"><a href="../projects_locations-buckets-undelete" style="color: #fcfcfc">Next &raquo;</a></span>
</span>
</div>
</body>
</html>