Skip to content

Commit 7735bb1

Browse files
feat(compute): update the api
#### compute:alpha The following keys were deleted: - resources.rollouts.methods.startNextWave (Total Keys: 17) The following keys were added: - resources.haControllers.methods.delete.parameters.force (Total Keys: 2) - resources.imageViews.methods.get (Total Keys: 19) - resources.imageViews.methods.list (Total Keys: 28) - resources.instanceGroupManagers.methods.delete.parameters.noGracefulShutdown (Total Keys: 3) - resources.instanceGroupManagers.methods.deleteInstances.parameters.noGracefulShutdown (Total Keys: 3) - resources.instanceGroupManagers.methods.recreateInstances.parameters.noGracefulShutdown (Total Keys: 3) - resources.instanceGroupManagers.methods.stopInstances.parameters.noGracefulShutdown (Total Keys: 3) - resources.projectViews.methods.get (Total Keys: 15) - resources.regionInstanceGroupManagers.methods.delete.parameters.noGracefulShutdown (Total Keys: 3) - resources.regionInstanceGroupManagers.methods.deleteInstances.parameters.noGracefulShutdown (Total Keys: 3) - resources.regionInstanceGroupManagers.methods.recreateInstances.parameters.noGracefulShutdown (Total Keys: 3) - resources.regionInstanceGroupManagers.methods.stopInstances.parameters.noGracefulShutdown (Total Keys: 3) - resources.rollouts.methods.advance (Total Keys: 17) - schemas.ImageView (Total Keys: 24) - schemas.ManagedInstance.properties.shutdownDetails (Total Keys: 2) - schemas.ManagedInstanceScheduling.properties.gracefulShutdownTimestamp (Total Keys: 3) - schemas.ManagedInstanceShutdownDetails (Total Keys: 7) - schemas.NetworkInterface.properties.dns64Eligible.type (Total Keys: 1) - schemas.NetworkInterface.properties.nat64Eligible.type (Total Keys: 1) - schemas.ProjectView (Total Keys: 3) - schemas.StoragePool.properties.shareSettings.$ref (Total Keys: 1) - schemas.StoragePoolShareSettings (Total Keys: 7) #### compute:beta The following keys were added: - resources.advice.methods.capacity (Total Keys: 32) - resources.forwardingRules.methods.get.parameters.view (Total Keys: 2) - resources.globalForwardingRules.methods.get.parameters.view (Total Keys: 2) - resources.instanceGroupManagers.methods.delete.parameters.noGracefulShutdown (Total Keys: 3) - resources.instanceGroupManagers.methods.deleteInstances.parameters.noGracefulShutdown (Total Keys: 3) - resources.instanceGroupManagers.methods.recreateInstances.parameters.noGracefulShutdown (Total Keys: 3) - resources.instanceGroupManagers.methods.stopInstances.parameters.noGracefulShutdown (Total Keys: 3) - resources.licenseCodes.methods.getIamPolicy (Total Keys: 18) - resources.licenseCodes.methods.setIamPolicy (Total Keys: 16) - resources.regionInstanceGroupManagers.methods.delete.parameters.noGracefulShutdown (Total Keys: 3) - resources.regionInstanceGroupManagers.methods.deleteInstances.parameters.noGracefulShutdown (Total Keys: 3) - resources.regionInstanceGroupManagers.methods.recreateInstances.parameters.noGracefulShutdown (Total Keys: 3) - resources.regionInstanceGroupManagers.methods.stopInstances.parameters.noGracefulShutdown (Total Keys: 3) - schemas.AutoscalingPolicy.properties.stabilizationPeriodSec (Total Keys: 2) - schemas.CapacityAdviceRequest (Total Keys: 36) - schemas.CapacityAdviceResponse (Total Keys: 23) - schemas.CapacityHistoryRequest (Total Keys: 16) - schemas.CapacityHistoryResponse (Total Keys: 18) - schemas.ForwardingRule.properties.IPAddresses (Total Keys: 2) - schemas.ForwardingRule.properties.attachedExtensions (Total Keys: 3) - schemas.ForwardingRule.properties.availabilityGroup.type (Total Keys: 1) - schemas.ForwardingRule.properties.childForwardingRules (Total Keys: 3) - schemas.ForwardingRule.properties.parentForwardingRule (Total Keys: 2) - schemas.ForwardingRuleAttachedExtension (Total Keys: 4) - schemas.Interval (Total Keys: 6) - schemas.LicenseCode.properties.allowedReplacementLicenses (Total Keys: 2) - schemas.LicenseCode.properties.appendableToDisk.type (Total Keys: 1) - schemas.LicenseCode.properties.incompatibleLicenses (Total Keys: 2) - schemas.LicenseCode.properties.minimumRetention.$ref (Total Keys: 1) - schemas.LicenseCode.properties.multiTenantOnly.type (Total Keys: 1) - schemas.LicenseCode.properties.osLicense.type (Total Keys: 1) - schemas.LicenseCode.properties.removableFromDisk.type (Total Keys: 1) - schemas.LicenseCode.properties.requiredCoattachedLicenses (Total Keys: 2) - schemas.LicenseCode.properties.soleTenantOnly.type (Total Keys: 1) - schemas.LicenseCode.properties.updateTimestamp (Total Keys: 2) - schemas.ManagedInstance.properties.shutdownDetails (Total Keys: 2) - schemas.ManagedInstanceScheduling.properties.gracefulShutdownTimestamp (Total Keys: 3) - schemas.ManagedInstanceShutdownDetails (Total Keys: 7) - schemas.Money (Total Keys: 7) - schemas.NetworkInterface.properties.aliasIpv6Ranges (Total Keys: 2) - schemas.PublicDelegatedPrefix.properties.purpose.type (Total Keys: 1) - schemas.PublicDelegatedPrefixPublicDelegatedSubPrefix.properties.purpose (Total Keys: 2) - schemas.RolloutWaveDetailsOrchestratedWaveDetails.properties.estimatedCompletionTime (Total Keys: 2) - schemas.SslPolicy.properties.postQuantumKeyExchange.type (Total Keys: 1) - schemas.SubnetworkSecondaryRange.properties.ipCollection.type (Total Keys: 1) - schemas.SubnetworkSecondaryRange.properties.ipVersion.type (Total Keys: 1) #### compute:v1 The following keys were added: - resources.globalVmExtensionPolicies.methods.aggregatedList (Total Keys: 29) - resources.globalVmExtensionPolicies.methods.delete (Total Keys: 17) - resources.globalVmExtensionPolicies.methods.get (Total Keys: 15) - resources.globalVmExtensionPolicies.methods.insert (Total Keys: 14) - resources.globalVmExtensionPolicies.methods.list (Total Keys: 24) - resources.globalVmExtensionPolicies.methods.update (Total Keys: 17) - resources.licenseCodes.methods.getIamPolicy (Total Keys: 18) - resources.licenseCodes.methods.setIamPolicy (Total Keys: 16) - resources.networks.methods.cancelRequestRemovePeering (Total Keys: 18) - resources.rolloutPlans.methods.delete (Total Keys: 17) - resources.rolloutPlans.methods.get (Total Keys: 15) - resources.rolloutPlans.methods.insert (Total Keys: 14) - resources.rolloutPlans.methods.list (Total Keys: 24) - resources.rollouts.methods.cancel (Total Keys: 19) - resources.rollouts.methods.delete (Total Keys: 17) - resources.rollouts.methods.get (Total Keys: 15) - resources.rollouts.methods.list (Total Keys: 24) - schemas.AutoscalingPolicy.properties.stabilizationPeriodSec (Total Keys: 2) - schemas.GlobalVmExtensionPolicy (Total Keys: 92) - schemas.LicenseCode.properties.allowedReplacementLicenses (Total Keys: 2) - schemas.LicenseCode.properties.appendableToDisk.type (Total Keys: 1) - schemas.LicenseCode.properties.incompatibleLicenses (Total Keys: 2) - schemas.LicenseCode.properties.minimumRetention.$ref (Total Keys: 1) - schemas.LicenseCode.properties.multiTenantOnly.type (Total Keys: 1) - schemas.LicenseCode.properties.osLicense.type (Total Keys: 1) - schemas.LicenseCode.properties.removableFromDisk.type (Total Keys: 1) - schemas.LicenseCode.properties.requiredCoattachedLicenses (Total Keys: 2) - schemas.LicenseCode.properties.soleTenantOnly.type (Total Keys: 1) - schemas.LicenseCode.properties.updateTimestamp (Total Keys: 2) - schemas.NetworksCancelRequestRemovePeeringRequest (Total Keys: 3) - schemas.Rollout (Total Keys: 168) - schemas.SslPolicy.properties.postQuantumKeyExchange.type (Total Keys: 1) - schemas.VmExtensionPoliciesScopedList (Total Keys: 11) - schemas.VmExtensionPolicyAggregatedListResponse (Total Keys: 21)
1 parent 7f7bad6 commit 7735bb1

364 files changed

Lines changed: 22921 additions & 9183 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

docs/dyn/compute_alpha.addresses.html

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -585,12 +585,12 @@ <h3>Method Details</h3>
585585
},
586586
&quot;getVersionOperationMetadata&quot;: {
587587
&quot;inlineSbomInfo&quot;: {
588-
&quot;currentComponentVersions&quot;: { # SBOM versions currently applied to the resource. The key is the component
589-
# name and the value is the version.
588+
&quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
589+
# appropriate identifiers.
590590
&quot;a_key&quot;: &quot;A String&quot;,
591591
},
592-
&quot;targetComponentVersions&quot;: { # SBOM versions scheduled for the next maintenance. The key is the
593-
# component name and the value is the version.
592+
&quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
593+
# identifiers.
594594
&quot;a_key&quot;: &quot;A String&quot;,
595595
},
596596
},
@@ -1125,12 +1125,12 @@ <h3>Method Details</h3>
11251125
},
11261126
&quot;getVersionOperationMetadata&quot;: {
11271127
&quot;inlineSbomInfo&quot;: {
1128-
&quot;currentComponentVersions&quot;: { # SBOM versions currently applied to the resource. The key is the component
1129-
# name and the value is the version.
1128+
&quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1129+
# appropriate identifiers.
11301130
&quot;a_key&quot;: &quot;A String&quot;,
11311131
},
1132-
&quot;targetComponentVersions&quot;: { # SBOM versions scheduled for the next maintenance. The key is the
1133-
# component name and the value is the version.
1132+
&quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1133+
# identifiers.
11341134
&quot;a_key&quot;: &quot;A String&quot;,
11351135
},
11361136
},
@@ -1700,12 +1700,12 @@ <h3>Method Details</h3>
17001700
},
17011701
&quot;getVersionOperationMetadata&quot;: {
17021702
&quot;inlineSbomInfo&quot;: {
1703-
&quot;currentComponentVersions&quot;: { # SBOM versions currently applied to the resource. The key is the component
1704-
# name and the value is the version.
1703+
&quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1704+
# appropriate identifiers.
17051705
&quot;a_key&quot;: &quot;A String&quot;,
17061706
},
1707-
&quot;targetComponentVersions&quot;: { # SBOM versions scheduled for the next maintenance. The key is the
1708-
# component name and the value is the version.
1707+
&quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1708+
# identifiers.
17091709
&quot;a_key&quot;: &quot;A String&quot;,
17101710
},
17111711
},
@@ -2010,12 +2010,12 @@ <h3>Method Details</h3>
20102010
},
20112011
&quot;getVersionOperationMetadata&quot;: {
20122012
&quot;inlineSbomInfo&quot;: {
2013-
&quot;currentComponentVersions&quot;: { # SBOM versions currently applied to the resource. The key is the component
2014-
# name and the value is the version.
2013+
&quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
2014+
# appropriate identifiers.
20152015
&quot;a_key&quot;: &quot;A String&quot;,
20162016
},
2017-
&quot;targetComponentVersions&quot;: { # SBOM versions scheduled for the next maintenance. The key is the
2018-
# component name and the value is the version.
2017+
&quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
2018+
# identifiers.
20192019
&quot;a_key&quot;: &quot;A String&quot;,
20202020
},
20212021
},

docs/dyn/compute_alpha.advice.html

Lines changed: 26 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,7 @@ <h2>Instance Methods</h2>
8282
<p class="firstline">Advice on making real-time decisions (such as choosing zone or</p>
8383
<p class="toc_element">
8484
<code><a href="#capacityHistory">capacityHistory(project, region, body=None, x__xgafv=None)</a></code></p>
85-
<p class="firstline">Gets the capacity history for Spot VMs.</p>
85+
<p class="firstline">Gets the capacity history.</p>
8686
<p class="toc_element">
8787
<code><a href="#close">close()</a></code></p>
8888
<p class="firstline">Close httplib2 connections.</p>
@@ -223,12 +223,11 @@ <h3>Method Details</h3>
223223

224224
{ # A request to provide Assistant Scores. These scores determine VM
225225
# obtainability and preemption likelihood.
226-
&quot;distributionPolicy&quot;: { # Policy specifying the distribution of instances across
226+
&quot;distributionPolicy&quot;: { # Distribution policy. # Policy specifying the distribution of instances across
227227
# zones within the requested region.
228-
&quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges.
229-
# You can only specify the following values: ANY,ANY_SINGLE_ZONE,BALANCED.
228+
&quot;targetShape&quot;: &quot;A String&quot;, # Target distribution shape. You can specify the following values:ANY, ANY_SINGLE_ZONE, or BALANCED.
230229
&quot;zones&quot;: [ # Zones where Capacity Advisor looks for capacity.
231-
{
230+
{ # Zone configuration for the distribution policy.
232231
&quot;zone&quot;: &quot;A String&quot;, # The URL of the zone. It can be a
233232
# partial or full URL. For example, the following are valid values:
234233
#
@@ -239,13 +238,13 @@ <h3>Method Details</h3>
239238
},
240239
],
241240
},
242-
&quot;instanceFlexibilityPolicy&quot;: { # Specification of alternative, flexible instance subsets. # Policy for instance selectors.
243-
&quot;instanceSelections&quot;: { # Named instance selections configure properties.
241+
&quot;instanceFlexibilityPolicy&quot;: { # Specification of alternative, flexible instance configurations. # Policy for instance selectors.
242+
&quot;instanceSelections&quot;: { # Named instance selections to configure properties.
244243
# The key is an arbitrary, unique RFC1035 string that identifies the
245244
# instance selection.
246245
&quot;a_key&quot;: { # Machine specification.
247246
&quot;disks&quot;: [ # Local SSDs.
248-
{
247+
{ # Attached disk configuration.
249248
&quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk.
250249
# This field must be set to SCRATCH.
251250
},
@@ -268,17 +267,17 @@ <h3>Method Details</h3>
268267
},
269268
},
270269
},
271-
&quot;instanceProperties&quot;: { # Instance provisining properties. # Instance properties for this request.
270+
&quot;instanceProperties&quot;: { # Instance provisioning properties. # Instance properties for this request.
272271
&quot;acceleratorTopology&quot;: &quot;A String&quot;, # Input only. Specifies the topology required to create a partition for
273272
# VMs that have interconnected GPUs or TPUs.
274273
# Example values: 2x2 for ct5l-hightpu-4t.
275274
&quot;scheduling&quot;: { # Defines the instance scheduling options. # Specifies the scheduling options.
276275
&quot;maxRunDuration&quot;: &quot;A String&quot;, # The maximum time that instances can run before Compute Engine
277276
# terminates them.
278-
&quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
277+
&quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model.
279278
},
280279
},
281-
&quot;size&quot;: 42, # Size of requested capacity.
280+
&quot;size&quot;: 42, # The number of VM instances to request.
282281
}
283282

284283
x__xgafv: string, V1 error format.
@@ -289,14 +288,14 @@ <h3>Method Details</h3>
289288
Returns:
290289
An object of the form:
291290

292-
{ # A response contains multiple scoring recommendations.
291+
{ # A response contains scoring recommendations.
293292
&quot;recommendations&quot;: [ # Initially the API will provide one recommendation which balances the
294-
# individual scores according to service provider&#x27;s preference.
295-
{
296-
&quot;scores&quot;: { # The Scores message groups information about a shard of capacity.
293+
# individual scores according to the service provider&#x27;s preference.
294+
{ # Recommendation.
295+
&quot;scores&quot;: { # Groups information about a shard of capacity. # Scores for the recommendation.
297296
&quot;estimatedUptime&quot;: &quot;A String&quot;, # The estimated run time of the majority of Spot VMs in the request
298297
# before preemption. The estimate is best-effort only. It is based on
299-
# history data and current conditions.
298+
# historical data and current conditions.
300299
&quot;estimatedWaitDuration&quot;: &quot;A String&quot;, # Output only. The likely maximum time that you will have to wait until
301300
# Compute Engine provisions your instances.
302301
&quot;obtainability&quot;: 3.14, # The obtainability score indicates the likelihood of successfully
@@ -308,18 +307,13 @@ <h3>Method Details</h3>
308307
# of Spot VMs.
309308
# The score range is 0.0 through 1.0. Higher is better.
310309
},
311-
&quot;shards&quot;: [
310+
&quot;shards&quot;: [ # Shards represent blocks of uniform capacity in recommendations.
312311
{ # Shards represent blocks of uniform capacity in recommendations.
313-
# Each shard is for a single zone, single instance selection, and
314-
# a single machine shape. Each shard defines a size expressed as the
315-
# number of VMs.
316-
&quot;instanceCount&quot;: 42,
312+
# Each shard is for a single zone and a single machine shape. Each shard
313+
# defines a size expressed as the number of VMs.
314+
&quot;instanceCount&quot;: 42, # The number of instances.
317315
&quot;machineType&quot;: &quot;A String&quot;, # The machine type corresponds to the instance selection in the request.
318316
&quot;provisioningModel&quot;: &quot;A String&quot;, # The provisioning model that you want to view recommendations for.
319-
# Set to: SPOT.
320-
#
321-
# For more information, see
322-
# Compute Engine instances provisioning models.
323317
&quot;zone&quot;: &quot;A String&quot;, # Output only. The zone name for this shard.
324318
},
325319
],
@@ -330,26 +324,26 @@ <h3>Method Details</h3>
330324

331325
<div class="method">
332326
<code class="details" id="capacityHistory">capacityHistory(project, region, body=None, x__xgafv=None)</code>
333-
<pre>Gets the capacity history for Spot VMs.
327+
<pre>Gets the capacity history.
334328

335329
Args:
336330
project: string, Project ID for this request. (required)
337331
region: string, Name of the region for this request. (required)
338332
body: object, The request body.
339333
The object takes the form of:
340334

341-
{ # A request to get the capacity history for Spot VMs.
342-
&quot;instanceProperties&quot;: {
335+
{ # A request to get the capacity history.
336+
&quot;instanceProperties&quot;: { # Instance properties for this request. # Instance properties for this request.
343337
&quot;machineType&quot;: &quot;A String&quot;, # The machine type for the VM, such as `n2-standard-4`.
344-
&quot;scheduling&quot;: {
338+
&quot;scheduling&quot;: { # Scheduling options. # Specifies the scheduling options.
345339
&quot;provisioningModel&quot;: &quot;A String&quot;, # The provisioning model to get capacity history for.
346340
# This field must be set to SPOT.
347341
#
348342
# For more information, see
349343
# Compute Engine instances provisioning models.
350344
},
351345
},
352-
&quot;locationPolicy&quot;: {
346+
&quot;locationPolicy&quot;: { # Location policy for this request. # Location policy for this request.
353347
&quot;location&quot;: &quot;A String&quot;, # The region or zone to get capacity history for.
354348
#
355349
# It can be a partial or full URL. For example, the following are valid
@@ -364,7 +358,7 @@ <h3>Method Details</h3>
364358
#
365359
# This field is optional.
366360
},
367-
&quot;types&quot;: [
361+
&quot;types&quot;: [ # List of history types to get capacity history for.
368362
&quot;A String&quot;,
369363
],
370364
}
@@ -377,7 +371,7 @@ <h3>Method Details</h3>
377371
Returns:
378372
An object of the form:
379373

380-
{ # Contains the capacity history for Spot VMs.
374+
{ # Contains the capacity history.
381375
&quot;location&quot;: &quot;A String&quot;,
382376
&quot;machineType&quot;: &quot;A String&quot;,
383377
&quot;preemptionHistory&quot;: [

0 commit comments

Comments
 (0)