feat(compute): update the api

#### compute:alpha

The following keys were added:
- resources.advice.methods.capacity (Total Keys: 20)
- resources.regionBackendBuckets.methods.delete (Total Keys: 23)
- resources.regionBackendBuckets.methods.get (Total Keys: 41)
- resources.regionBackendBuckets.methods.insert (Total Keys: 18)
- resources.regionBackendBuckets.methods.list (Total Keys: 56)
- resources.regionBackendBuckets.methods.patch (Total Keys: 22)
- resources.regionBackendBuckets.methods.setIamPolicy (Total Keys: 20)
- resources.regionBackendBuckets.methods.testIamPermissions (Total Keys: 20)
- schemas.CapacityAdviceRequest (Total Keys: 27)
- schemas.CapacityAdviceResponse (Total Keys: 22)

#### compute:beta

The following keys were added:
- schemas.FirewallPolicyRuleMatcher.properties.destNetworkType.type (Total Keys: 1)
- schemas.FirewallPolicyRuleMatcher.properties.srcNetworkType.type (Total Keys: 1)
- schemas.InstanceGroupManager.properties.targetSizePolicy.$ref (Total Keys: 1)
- schemas.InstanceGroupManagerStatus.properties.bulkInstanceOperation.$ref (Total Keys: 1)
- schemas.InstanceGroupManagerStatusBulkInstanceOperation (Total Keys: 20)
- schemas.InstanceGroupManagerTargetSizePolicy (Total Keys: 3)
- schemas.NetworkInterface.properties.igmpQuery.type (Total Keys: 1)

#### compute:v1

The following keys were added:
- schemas.Firewall.properties.params.$ref (Total Keys: 1)
- schemas.FirewallParams (Total Keys: 4)
- schemas.Route.properties.params.$ref (Total Keys: 1)
- schemas.RouteParams (Total Keys: 4)

Author: yoshi-automation

docs/dyn/compute_alpha.advice.html

@@ -77,6 +77,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#calendarMode">calendarMode(project, region, body=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Advise how, where and when to create the requested amount of instances with specified accelerators, within the specified time and location limits. The method recommends creating future reservations for the requested resources.</p>
+<p class="toc_element">
+  <code><a href="#capacity">capacity(project, region, size, body=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Advice on making real-time decisions (such as choosing zone or machine types) during deployment to maximize your chances of obtaining capacity.</p>
 <p class="toc_element">
   <code><a href="#close">close()</a></code></p>
 <p class="firstline">Close httplib2 connections.</p>
@@ -162,6 +165,70 @@ <h3>Method Details</h3>
 }</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="capacity">capacity(project, region, size, body=None, x__xgafv=None)</code>
+  <pre>Advice on making real-time decisions (such as choosing zone or machine types) during deployment to maximize your chances of obtaining capacity.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, Name of the region for this request. (required)
+  size: integer, Size of requested capacity. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A request to provide Assistant Scores. These scores determine VM obtainability and preemption likelihood.
+  &quot;distributionPolicy&quot;: { # Policy specifying the distribution of instances across zones within the requested region.
+    &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges.
+    &quot;zones&quot;: [ # Zones where Capacity Advisor looks for capacity.
+      {
+        &quot;zone&quot;: &quot;A String&quot;, # The URL of the zone.
+      },
+    ],
+  },
+  &quot;instanceFlexibilityPolicy&quot;: { # Specification of alternative, flexible instance subsets. # Policy for instance selectors.
+    &quot;instanceSelections&quot;: { # Named instance selections configure properties. The key is an arbitrary, unique RFC1035 string that identifies the instance selection.
+      &quot;a_key&quot;: { # Machine specification.
+        &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
+          &quot;A String&quot;,
+        ],
+      },
+    },
+  },
+  &quot;instanceProperties&quot;: { # Instance provisining properties. # Instance properties for this request.
+    &quot;scheduling&quot;: { # Defines the instance scheduling options. # Specifies the scheduling options.
+      &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
+    },
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A response contains multiple scoring recommendations.
+  &quot;recommendations&quot;: [ # Initially the API will provide one recommendation which balances the individual scores according to Google&#x27;s preference.
+    {
+      &quot;scores&quot;: { # The Scores message groups information about a shard of capacity.
+        &quot;obtainability&quot;: 3.14, # The obtainability score indicates the likelihood of successfully obtaining (provisioning) the requested number of VMs. The score range is 0.0 through 1.0. Higher is better.
+        &quot;spotPreemption&quot;: 3.14, # The preemption score indicates the likelihood that your Spot VMs is preempted. For more information about the preemption process, see Preemption of Spot VMs. The score range is 0.0 through 1.0. Higher is better.
+      },
+      &quot;shards&quot;: [
+        { # Shards represent blocks of uniform capacity in recommendations. Each shard is for a single zone, single instance selection, and a single machine shape. Each shard defines a size expressed as the number of VMs.
+          &quot;instanceCount&quot;: 42,
+          &quot;machineType&quot;: &quot;A String&quot;, # The machine type corresponds to the instance selection in the request.
+          &quot;provisioningModel&quot;: &quot;A String&quot;, # Provisioning model of the recommended capacity.
+          &quot;zone&quot;: &quot;A String&quot;, # The zone name for this shard.
+        },
+      ],
+    },
+  ],
+}</pre>
+</div>
+
 <div class="method">
     <code class="details" id="close">close()</code>
   <pre>Close httplib2 connections.</pre>

docs/dyn/compute_alpha.backendServices.html

@@ -374,6 +374,11 @@ <h2>Instance Methods</h2>
 </p>
 <p class="firstline">Returns the regionAutoscalers Resource.</p>
 
+<p class="toc_element">
+  <code><a href="compute_alpha.regionBackendBuckets.html">regionBackendBuckets()</a></code>
+</p>
+<p class="firstline">Returns the regionBackendBuckets Resource.</p>
+
 <p class="toc_element">
   <code><a href="compute_alpha.regionBackendServices.html">regionBackendServices()</a></code>
 </p>