google-apis-compute_v1 0.20.0 → 0.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2434,7 +2434,10 @@ module Google
2434
2434
  execute_or_queue_command(command, &block)
2435
2435
  end
2436
2436
 
2437
- # Creates a snapshot of a specified persistent disk.
2437
+ # Creates a snapshot of a specified persistent disk. For regular snapshot
2438
+ # creation, consider using snapshots.insert instead, as that method supports
2439
+ # more features, such as creating snapshots in a project different from the
2440
+ # source disk project.
2438
2441
  # @param [String] project
2439
2442
  # Project ID for this request.
2440
2443
  # @param [String] zone
@@ -6280,8 +6283,7 @@ module Google
6280
6283
  # operation with the same request ID was received, and if so, will ignore the
6281
6284
  # second request. This prevents clients from accidentally creating duplicate
6282
6285
  # commitments. The request ID must be a valid UUID with the exception that zero
6283
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
6284
- # MixerMutationRequestBuilder
6286
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
6285
6287
  # @param [String] fields
6286
6288
  # Selector specifying which fields to include in a partial response.
6287
6289
  # @param [String] quota_user
@@ -6364,8 +6366,7 @@ module Google
6364
6366
  # operation with the same request ID was received, and if so, will ignore the
6365
6367
  # second request. This prevents clients from accidentally creating duplicate
6366
6368
  # commitments. The request ID must be a valid UUID with the exception that zero
6367
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
6368
- # MixerMutationRequestBuilder
6369
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
6369
6370
  # @param [String] fields
6370
6371
  # Selector specifying which fields to include in a partial response.
6371
6372
  # @param [String] quota_user
@@ -6493,8 +6494,7 @@ module Google
6493
6494
  # operation with the same request ID was received, and if so, will ignore the
6494
6495
  # second request. This prevents clients from accidentally creating duplicate
6495
6496
  # commitments. The request ID must be a valid UUID with the exception that zero
6496
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
6497
- # MixerMutationRequestBuilder
6497
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
6498
6498
  # @param [String] fields
6499
6499
  # Selector specifying which fields to include in a partial response.
6500
6500
  # @param [String] quota_user
@@ -11064,6 +11064,12 @@ module Google
11064
11064
  # an instance template: - https://www.googleapis.com/compute/v1/projects/project
11065
11065
  # /global/instanceTemplates/instanceTemplate - projects/project/global/
11066
11066
  # instanceTemplates/instanceTemplate - global/instanceTemplates/instanceTemplate
11067
+ # @param [String] source_machine_image
11068
+ # Specifies the machine image to use to create the instance. This field is
11069
+ # optional. It can be a full or partial URL. For example, the following are all
11070
+ # valid URLs to a machine image: - https://www.googleapis.com/compute/v1/
11071
+ # projects/project/global/global /machineImages/machineImage - projects/project/
11072
+ # global/global/machineImages/machineImage - global/machineImages/machineImage
11067
11073
  # @param [String] fields
11068
11074
  # Selector specifying which fields to include in a partial response.
11069
11075
  # @param [String] quota_user
@@ -11083,7 +11089,7 @@ module Google
11083
11089
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
11084
11090
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
11085
11091
  # @raise [Google::Apis::AuthorizationError] Authorization is required
11086
- def insert_instance(project, zone, instance_object = nil, request_id: nil, source_instance_template: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
11092
+ def insert_instance(project, zone, instance_object = nil, request_id: nil, source_instance_template: nil, source_machine_image: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
11087
11093
  command = make_simple_command(:post, 'projects/{project}/zones/{zone}/instances', options)
11088
11094
  command.request_representation = Google::Apis::ComputeV1::Instance::Representation
11089
11095
  command.request_object = instance_object
@@ -11093,6 +11099,7 @@ module Google
11093
11099
  command.params['zone'] = zone unless zone.nil?
11094
11100
  command.query['requestId'] = request_id unless request_id.nil?
11095
11101
  command.query['sourceInstanceTemplate'] = source_instance_template unless source_instance_template.nil?
11102
+ command.query['sourceMachineImage'] = source_machine_image unless source_machine_image.nil?
11096
11103
  command.query['fields'] = fields unless fields.nil?
11097
11104
  command.query['quotaUser'] = quota_user unless quota_user.nil?
11098
11105
  command.query['userIp'] = user_ip unless user_ip.nil?
@@ -11370,6 +11377,56 @@ module Google
11370
11377
  execute_or_queue_command(command, &block)
11371
11378
  end
11372
11379
 
11380
+ # Resumes an instance that was suspended using the instances().suspend method.
11381
+ # @param [String] project
11382
+ # Project ID for this request.
11383
+ # @param [String] zone
11384
+ # The name of the zone for this request.
11385
+ # @param [String] instance
11386
+ # Name of the instance resource to resume.
11387
+ # @param [String] request_id
11388
+ # An optional request ID to identify requests. Specify a unique request ID so
11389
+ # that if you must retry your request, the server will know to ignore the
11390
+ # request if it has already been completed. For example, consider a situation
11391
+ # where you make an initial request and the request times out. If you make the
11392
+ # request again with the same request ID, the server can check if original
11393
+ # operation with the same request ID was received, and if so, will ignore the
11394
+ # second request. This prevents clients from accidentally creating duplicate
11395
+ # commitments. The request ID must be a valid UUID with the exception that zero
11396
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
11397
+ # @param [String] fields
11398
+ # Selector specifying which fields to include in a partial response.
11399
+ # @param [String] quota_user
11400
+ # Available to use for quota purposes for server-side applications. Can be any
11401
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
11402
+ # @param [String] user_ip
11403
+ # Legacy name for parameter that has been superseded by `quotaUser`.
11404
+ # @param [Google::Apis::RequestOptions] options
11405
+ # Request-specific options
11406
+ #
11407
+ # @yield [result, err] Result & error if block supplied
11408
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
11409
+ # @yieldparam err [StandardError] error object if request failed
11410
+ #
11411
+ # @return [Google::Apis::ComputeV1::Operation]
11412
+ #
11413
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
11414
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
11415
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
11416
+ def resume_instance(project, zone, instance, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
11417
+ command = make_simple_command(:post, 'projects/{project}/zones/{zone}/instances/{instance}/resume', options)
11418
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
11419
+ command.response_class = Google::Apis::ComputeV1::Operation
11420
+ command.params['project'] = project unless project.nil?
11421
+ command.params['zone'] = zone unless zone.nil?
11422
+ command.params['instance'] = instance unless instance.nil?
11423
+ command.query['requestId'] = request_id unless request_id.nil?
11424
+ command.query['fields'] = fields unless fields.nil?
11425
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
11426
+ command.query['userIp'] = user_ip unless user_ip.nil?
11427
+ execute_or_queue_command(command, &block)
11428
+ end
11429
+
11373
11430
  # Sends diagnostic interrupt to the instance.
11374
11431
  # @param [String] project
11375
11432
  # Project ID for this request.
@@ -11832,7 +11889,9 @@ module Google
11832
11889
 
11833
11890
  # Sets an instance's scheduling options. You can only call this method on a
11834
11891
  # stopped instance, that is, a VM instance that is in a `TERMINATED` state. See
11835
- # Instance Life Cycle for more information on the possible instance states.
11892
+ # Instance Life Cycle for more information on the possible instance states. For
11893
+ # more information about setting scheduling options for a VM, see Set VM
11894
+ # availability policies.
11836
11895
  # @param [String] project
11837
11896
  # Project ID for this request.
11838
11897
  # @param [String] zone
@@ -12048,7 +12107,8 @@ module Google
12048
12107
  execute_or_queue_command(command, &block)
12049
12108
  end
12050
12109
 
12051
- # Simulates a maintenance event on the instance.
12110
+ # Simulates a host maintenance event on a VM. For more information, see Simulate
12111
+ # a host maintenance event.
12052
12112
  # @param [String] project
12053
12113
  # Project ID for this request.
12054
12114
  # @param [String] zone
@@ -12246,6 +12306,62 @@ module Google
12246
12306
  execute_or_queue_command(command, &block)
12247
12307
  end
12248
12308
 
12309
+ # This method suspends a running instance, saving its state to persistent
12310
+ # storage, and allows you to resume the instance at a later time. Suspended
12311
+ # instances have no compute costs (cores or RAM), and incur only storage charges
12312
+ # for the saved VM memory and localSSD data. Any charged resources the virtual
12313
+ # machine was using, such as persistent disks and static IP addresses, will
12314
+ # continue to be charged while the instance is suspended. For more information,
12315
+ # see Suspending and resuming an instance.
12316
+ # @param [String] project
12317
+ # Project ID for this request.
12318
+ # @param [String] zone
12319
+ # The name of the zone for this request.
12320
+ # @param [String] instance
12321
+ # Name of the instance resource to suspend.
12322
+ # @param [String] request_id
12323
+ # An optional request ID to identify requests. Specify a unique request ID so
12324
+ # that if you must retry your request, the server will know to ignore the
12325
+ # request if it has already been completed. For example, consider a situation
12326
+ # where you make an initial request and the request times out. If you make the
12327
+ # request again with the same request ID, the server can check if original
12328
+ # operation with the same request ID was received, and if so, will ignore the
12329
+ # second request. This prevents clients from accidentally creating duplicate
12330
+ # commitments. The request ID must be a valid UUID with the exception that zero
12331
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
12332
+ # @param [String] fields
12333
+ # Selector specifying which fields to include in a partial response.
12334
+ # @param [String] quota_user
12335
+ # Available to use for quota purposes for server-side applications. Can be any
12336
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
12337
+ # @param [String] user_ip
12338
+ # Legacy name for parameter that has been superseded by `quotaUser`.
12339
+ # @param [Google::Apis::RequestOptions] options
12340
+ # Request-specific options
12341
+ #
12342
+ # @yield [result, err] Result & error if block supplied
12343
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
12344
+ # @yieldparam err [StandardError] error object if request failed
12345
+ #
12346
+ # @return [Google::Apis::ComputeV1::Operation]
12347
+ #
12348
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
12349
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
12350
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
12351
+ def suspend_instance(project, zone, instance, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
12352
+ command = make_simple_command(:post, 'projects/{project}/zones/{zone}/instances/{instance}/suspend', options)
12353
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
12354
+ command.response_class = Google::Apis::ComputeV1::Operation
12355
+ command.params['project'] = project unless project.nil?
12356
+ command.params['zone'] = zone unless zone.nil?
12357
+ command.params['instance'] = instance unless instance.nil?
12358
+ command.query['requestId'] = request_id unless request_id.nil?
12359
+ command.query['fields'] = fields unless fields.nil?
12360
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
12361
+ command.query['userIp'] = user_ip unless user_ip.nil?
12362
+ execute_or_queue_command(command, &block)
12363
+ end
12364
+
12249
12365
  # Returns permissions that a caller has on the specified resource.
12250
12366
  # @param [String] project
12251
12367
  # Project ID for this request.
@@ -13779,6 +13895,341 @@ module Google
13779
13895
  execute_or_queue_command(command, &block)
13780
13896
  end
13781
13897
 
13898
+ # Deletes the specified machine image. Deleting a machine image is permanent and
13899
+ # cannot be undone.
13900
+ # @param [String] project
13901
+ # Project ID for this request.
13902
+ # @param [String] machine_image
13903
+ # The name of the machine image to delete.
13904
+ # @param [String] request_id
13905
+ # An optional request ID to identify requests. Specify a unique request ID so
13906
+ # that if you must retry your request, the server will know to ignore the
13907
+ # request if it has already been completed. For example, consider a situation
13908
+ # where you make an initial request and the request times out. If you make the
13909
+ # request again with the same request ID, the server can check if original
13910
+ # operation with the same request ID was received, and if so, will ignore the
13911
+ # second request. This prevents clients from accidentally creating duplicate
13912
+ # commitments. The request ID must be a valid UUID with the exception that zero
13913
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
13914
+ # @param [String] fields
13915
+ # Selector specifying which fields to include in a partial response.
13916
+ # @param [String] quota_user
13917
+ # Available to use for quota purposes for server-side applications. Can be any
13918
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
13919
+ # @param [String] user_ip
13920
+ # Legacy name for parameter that has been superseded by `quotaUser`.
13921
+ # @param [Google::Apis::RequestOptions] options
13922
+ # Request-specific options
13923
+ #
13924
+ # @yield [result, err] Result & error if block supplied
13925
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
13926
+ # @yieldparam err [StandardError] error object if request failed
13927
+ #
13928
+ # @return [Google::Apis::ComputeV1::Operation]
13929
+ #
13930
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
13931
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
13932
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
13933
+ def delete_machine_image(project, machine_image, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
13934
+ command = make_simple_command(:delete, 'projects/{project}/global/machineImages/{machineImage}', options)
13935
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
13936
+ command.response_class = Google::Apis::ComputeV1::Operation
13937
+ command.params['project'] = project unless project.nil?
13938
+ command.params['machineImage'] = machine_image unless machine_image.nil?
13939
+ command.query['requestId'] = request_id unless request_id.nil?
13940
+ command.query['fields'] = fields unless fields.nil?
13941
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
13942
+ command.query['userIp'] = user_ip unless user_ip.nil?
13943
+ execute_or_queue_command(command, &block)
13944
+ end
13945
+
13946
+ # Returns the specified machine image. Gets a list of available machine images
13947
+ # by making a list() request.
13948
+ # @param [String] project
13949
+ # Project ID for this request.
13950
+ # @param [String] machine_image
13951
+ # The name of the machine image.
13952
+ # @param [String] fields
13953
+ # Selector specifying which fields to include in a partial response.
13954
+ # @param [String] quota_user
13955
+ # Available to use for quota purposes for server-side applications. Can be any
13956
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
13957
+ # @param [String] user_ip
13958
+ # Legacy name for parameter that has been superseded by `quotaUser`.
13959
+ # @param [Google::Apis::RequestOptions] options
13960
+ # Request-specific options
13961
+ #
13962
+ # @yield [result, err] Result & error if block supplied
13963
+ # @yieldparam result [Google::Apis::ComputeV1::MachineImage] parsed result object
13964
+ # @yieldparam err [StandardError] error object if request failed
13965
+ #
13966
+ # @return [Google::Apis::ComputeV1::MachineImage]
13967
+ #
13968
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
13969
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
13970
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
13971
+ def get_machine_image(project, machine_image, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
13972
+ command = make_simple_command(:get, 'projects/{project}/global/machineImages/{machineImage}', options)
13973
+ command.response_representation = Google::Apis::ComputeV1::MachineImage::Representation
13974
+ command.response_class = Google::Apis::ComputeV1::MachineImage
13975
+ command.params['project'] = project unless project.nil?
13976
+ command.params['machineImage'] = machine_image unless machine_image.nil?
13977
+ command.query['fields'] = fields unless fields.nil?
13978
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
13979
+ command.query['userIp'] = user_ip unless user_ip.nil?
13980
+ execute_or_queue_command(command, &block)
13981
+ end
13982
+
13983
+ # Gets the access control policy for a resource. May be empty if no such policy
13984
+ # or resource exists.
13985
+ # @param [String] project
13986
+ # Project ID for this request.
13987
+ # @param [String] resource
13988
+ # Name or id of the resource for this request.
13989
+ # @param [Fixnum] options_requested_policy_version
13990
+ # Requested IAM Policy version.
13991
+ # @param [String] fields
13992
+ # Selector specifying which fields to include in a partial response.
13993
+ # @param [String] quota_user
13994
+ # Available to use for quota purposes for server-side applications. Can be any
13995
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
13996
+ # @param [String] user_ip
13997
+ # Legacy name for parameter that has been superseded by `quotaUser`.
13998
+ # @param [Google::Apis::RequestOptions] options
13999
+ # Request-specific options
14000
+ #
14001
+ # @yield [result, err] Result & error if block supplied
14002
+ # @yieldparam result [Google::Apis::ComputeV1::Policy] parsed result object
14003
+ # @yieldparam err [StandardError] error object if request failed
14004
+ #
14005
+ # @return [Google::Apis::ComputeV1::Policy]
14006
+ #
14007
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
14008
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
14009
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
14010
+ def get_machine_image_iam_policy(project, resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
14011
+ command = make_simple_command(:get, 'projects/{project}/global/machineImages/{resource}/getIamPolicy', options)
14012
+ command.response_representation = Google::Apis::ComputeV1::Policy::Representation
14013
+ command.response_class = Google::Apis::ComputeV1::Policy
14014
+ command.params['project'] = project unless project.nil?
14015
+ command.params['resource'] = resource unless resource.nil?
14016
+ command.query['optionsRequestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
14017
+ command.query['fields'] = fields unless fields.nil?
14018
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
14019
+ command.query['userIp'] = user_ip unless user_ip.nil?
14020
+ execute_or_queue_command(command, &block)
14021
+ end
14022
+
14023
+ # Creates a machine image in the specified project using the data that is
14024
+ # included in the request. If you are creating a new machine image to update an
14025
+ # existing instance, your new machine image should use the same network or, if
14026
+ # applicable, the same subnetwork as the original instance.
14027
+ # @param [String] project
14028
+ # Project ID for this request.
14029
+ # @param [Google::Apis::ComputeV1::MachineImage] machine_image_object
14030
+ # @param [String] request_id
14031
+ # An optional request ID to identify requests. Specify a unique request ID so
14032
+ # that if you must retry your request, the server will know to ignore the
14033
+ # request if it has already been completed. For example, consider a situation
14034
+ # where you make an initial request and the request times out. If you make the
14035
+ # request again with the same request ID, the server can check if original
14036
+ # operation with the same request ID was received, and if so, will ignore the
14037
+ # second request. This prevents clients from accidentally creating duplicate
14038
+ # commitments. The request ID must be a valid UUID with the exception that zero
14039
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
14040
+ # @param [String] source_instance
14041
+ # Required. Source instance that is used to create the machine image from.
14042
+ # @param [String] fields
14043
+ # Selector specifying which fields to include in a partial response.
14044
+ # @param [String] quota_user
14045
+ # Available to use for quota purposes for server-side applications. Can be any
14046
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
14047
+ # @param [String] user_ip
14048
+ # Legacy name for parameter that has been superseded by `quotaUser`.
14049
+ # @param [Google::Apis::RequestOptions] options
14050
+ # Request-specific options
14051
+ #
14052
+ # @yield [result, err] Result & error if block supplied
14053
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
14054
+ # @yieldparam err [StandardError] error object if request failed
14055
+ #
14056
+ # @return [Google::Apis::ComputeV1::Operation]
14057
+ #
14058
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
14059
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
14060
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
14061
+ def insert_machine_image(project, machine_image_object = nil, request_id: nil, source_instance: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
14062
+ command = make_simple_command(:post, 'projects/{project}/global/machineImages', options)
14063
+ command.request_representation = Google::Apis::ComputeV1::MachineImage::Representation
14064
+ command.request_object = machine_image_object
14065
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
14066
+ command.response_class = Google::Apis::ComputeV1::Operation
14067
+ command.params['project'] = project unless project.nil?
14068
+ command.query['requestId'] = request_id unless request_id.nil?
14069
+ command.query['sourceInstance'] = source_instance unless source_instance.nil?
14070
+ command.query['fields'] = fields unless fields.nil?
14071
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
14072
+ command.query['userIp'] = user_ip unless user_ip.nil?
14073
+ execute_or_queue_command(command, &block)
14074
+ end
14075
+
14076
+ # Retrieves a list of machine images that are contained within the specified
14077
+ # project.
14078
+ # @param [String] project
14079
+ # Project ID for this request.
14080
+ # @param [String] filter
14081
+ # A filter expression that filters resources listed in the response. The
14082
+ # expression must specify the field name, an operator, and the value that you
14083
+ # want to use for filtering. The value must be a string, a number, or a boolean.
14084
+ # The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For
14085
+ # example, if you are filtering Compute Engine instances, you can exclude
14086
+ # instances named `example-instance` by specifying `name != example-instance`.
14087
+ # The `:` operator can be used with string fields to match substrings. For non-
14088
+ # string fields it is equivalent to the `=` operator. The `:*` comparison can be
14089
+ # used to test whether a key has been defined. For example, to find all objects
14090
+ # with `owner` label use: ``` labels.owner:* ``` You can also filter nested
14091
+ # fields. For example, you could specify `scheduling.automaticRestart = false`
14092
+ # to include instances only if they are not scheduled for automatic restarts.
14093
+ # You can use filtering on nested fields to filter based on resource labels. To
14094
+ # filter on multiple expressions, provide each separate expression within
14095
+ # parentheses. For example: ``` (scheduling.automaticRestart = true) (
14096
+ # cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND`
14097
+ # expression. However, you can include `AND` and `OR` expressions explicitly.
14098
+ # For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel
14099
+ # Broadwell") AND (scheduling.automaticRestart = true) ```
14100
+ # @param [Fixnum] max_results
14101
+ # The maximum number of results per page that should be returned. If the number
14102
+ # of available results is larger than `maxResults`, Compute Engine returns a `
14103
+ # nextPageToken` that can be used to get the next page of results in subsequent
14104
+ # list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
14105
+ # @param [String] order_by
14106
+ # Sorts list results by a certain order. By default, results are returned in
14107
+ # alphanumerical order based on the resource name. You can also sort results in
14108
+ # descending order based on the creation timestamp using `orderBy="
14109
+ # creationTimestamp desc"`. This sorts results based on the `creationTimestamp`
14110
+ # field in reverse chronological order (newest result first). Use this to sort
14111
+ # resources like operations so that the newest operation is returned first.
14112
+ # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
14113
+ # @param [String] page_token
14114
+ # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned
14115
+ # by a previous list request to get the next page of results.
14116
+ # @param [Boolean] return_partial_success
14117
+ # Opt-in for partial success behavior which provides partial results in case of
14118
+ # failure. The default value is false.
14119
+ # @param [String] fields
14120
+ # Selector specifying which fields to include in a partial response.
14121
+ # @param [String] quota_user
14122
+ # Available to use for quota purposes for server-side applications. Can be any
14123
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
14124
+ # @param [String] user_ip
14125
+ # Legacy name for parameter that has been superseded by `quotaUser`.
14126
+ # @param [Google::Apis::RequestOptions] options
14127
+ # Request-specific options
14128
+ #
14129
+ # @yield [result, err] Result & error if block supplied
14130
+ # @yieldparam result [Google::Apis::ComputeV1::MachineImageList] parsed result object
14131
+ # @yieldparam err [StandardError] error object if request failed
14132
+ #
14133
+ # @return [Google::Apis::ComputeV1::MachineImageList]
14134
+ #
14135
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
14136
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
14137
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
14138
+ def list_machine_images(project, filter: nil, max_results: nil, order_by: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
14139
+ command = make_simple_command(:get, 'projects/{project}/global/machineImages', options)
14140
+ command.response_representation = Google::Apis::ComputeV1::MachineImageList::Representation
14141
+ command.response_class = Google::Apis::ComputeV1::MachineImageList
14142
+ command.params['project'] = project unless project.nil?
14143
+ command.query['filter'] = filter unless filter.nil?
14144
+ command.query['maxResults'] = max_results unless max_results.nil?
14145
+ command.query['orderBy'] = order_by unless order_by.nil?
14146
+ command.query['pageToken'] = page_token unless page_token.nil?
14147
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
14148
+ command.query['fields'] = fields unless fields.nil?
14149
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
14150
+ command.query['userIp'] = user_ip unless user_ip.nil?
14151
+ execute_or_queue_command(command, &block)
14152
+ end
14153
+
14154
+ # Sets the access control policy on the specified resource. Replaces any
14155
+ # existing policy.
14156
+ # @param [String] project
14157
+ # Project ID for this request.
14158
+ # @param [String] resource
14159
+ # Name or id of the resource for this request.
14160
+ # @param [Google::Apis::ComputeV1::GlobalSetPolicyRequest] global_set_policy_request_object
14161
+ # @param [String] fields
14162
+ # Selector specifying which fields to include in a partial response.
14163
+ # @param [String] quota_user
14164
+ # Available to use for quota purposes for server-side applications. Can be any
14165
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
14166
+ # @param [String] user_ip
14167
+ # Legacy name for parameter that has been superseded by `quotaUser`.
14168
+ # @param [Google::Apis::RequestOptions] options
14169
+ # Request-specific options
14170
+ #
14171
+ # @yield [result, err] Result & error if block supplied
14172
+ # @yieldparam result [Google::Apis::ComputeV1::Policy] parsed result object
14173
+ # @yieldparam err [StandardError] error object if request failed
14174
+ #
14175
+ # @return [Google::Apis::ComputeV1::Policy]
14176
+ #
14177
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
14178
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
14179
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
14180
+ def set_machine_image_iam_policy(project, resource, global_set_policy_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
14181
+ command = make_simple_command(:post, 'projects/{project}/global/machineImages/{resource}/setIamPolicy', options)
14182
+ command.request_representation = Google::Apis::ComputeV1::GlobalSetPolicyRequest::Representation
14183
+ command.request_object = global_set_policy_request_object
14184
+ command.response_representation = Google::Apis::ComputeV1::Policy::Representation
14185
+ command.response_class = Google::Apis::ComputeV1::Policy
14186
+ command.params['project'] = project unless project.nil?
14187
+ command.params['resource'] = resource unless resource.nil?
14188
+ command.query['fields'] = fields unless fields.nil?
14189
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
14190
+ command.query['userIp'] = user_ip unless user_ip.nil?
14191
+ execute_or_queue_command(command, &block)
14192
+ end
14193
+
14194
+ # Returns permissions that a caller has on the specified resource.
14195
+ # @param [String] project
14196
+ # Project ID for this request.
14197
+ # @param [String] resource
14198
+ # Name or id of the resource for this request.
14199
+ # @param [Google::Apis::ComputeV1::TestPermissionsRequest] test_permissions_request_object
14200
+ # @param [String] fields
14201
+ # Selector specifying which fields to include in a partial response.
14202
+ # @param [String] quota_user
14203
+ # Available to use for quota purposes for server-side applications. Can be any
14204
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
14205
+ # @param [String] user_ip
14206
+ # Legacy name for parameter that has been superseded by `quotaUser`.
14207
+ # @param [Google::Apis::RequestOptions] options
14208
+ # Request-specific options
14209
+ #
14210
+ # @yield [result, err] Result & error if block supplied
14211
+ # @yieldparam result [Google::Apis::ComputeV1::TestPermissionsResponse] parsed result object
14212
+ # @yieldparam err [StandardError] error object if request failed
14213
+ #
14214
+ # @return [Google::Apis::ComputeV1::TestPermissionsResponse]
14215
+ #
14216
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
14217
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
14218
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
14219
+ def test_machine_image_iam_permissions(project, resource, test_permissions_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
14220
+ command = make_simple_command(:post, 'projects/{project}/global/machineImages/{resource}/testIamPermissions', options)
14221
+ command.request_representation = Google::Apis::ComputeV1::TestPermissionsRequest::Representation
14222
+ command.request_object = test_permissions_request_object
14223
+ command.response_representation = Google::Apis::ComputeV1::TestPermissionsResponse::Representation
14224
+ command.response_class = Google::Apis::ComputeV1::TestPermissionsResponse
14225
+ command.params['project'] = project unless project.nil?
14226
+ command.params['resource'] = resource unless resource.nil?
14227
+ command.query['fields'] = fields unless fields.nil?
14228
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
14229
+ command.query['userIp'] = user_ip unless user_ip.nil?
14230
+ execute_or_queue_command(command, &block)
14231
+ end
14232
+
13782
14233
  # Retrieves an aggregated list of machine types.
13783
14234
  # @param [String] project
13784
14235
  # Project ID for this request.
@@ -17085,7 +17536,13 @@ module Google
17085
17536
  execute_or_queue_command(command, &block)
17086
17537
  end
17087
17538
 
17088
- # Returns the specified Project resource.
17539
+ # Returns the specified Project resource. To decrease latency for this method,
17540
+ # you can optionally omit any unneeded information from the response by using a
17541
+ # field mask. This practice is especially recommended for unused quota
17542
+ # information (the `quotas` field). To exclude one or more fields, set your
17543
+ # request's `fields` query parameter to only include the fields you need. For
17544
+ # example, to only include the `id` and `selfLink` fields, add the query
17545
+ # parameter `?fields=id,selfLink` to your request.
17089
17546
  # @param [String] project
17090
17547
  # Project ID for this request.
17091
17548
  # @param [String] fields
@@ -17357,7 +17814,12 @@ module Google
17357
17814
  execute_or_queue_command(command, &block)
17358
17815
  end
17359
17816
 
17360
- # Moves an instance and its attached persistent disks from one zone to another.
17817
+ # Moves an instance and its attached persistent disks from one zone to another. *
17818
+ # Note*: Moving VMs or disks by using this method might cause unexpected
17819
+ # behavior. For more information, see the [known issue](/compute/docs/
17820
+ # troubleshooting/known-issues#
17821
+ # ving_vms_or_disks_using_the_moveinstance_api_or_the_causes_unexpected_behavior)
17822
+ # .
17361
17823
  # @param [String] project
17362
17824
  # Project ID for this request.
17363
17825
  # @param [Google::Apis::ComputeV1::MoveInstanceRequest] move_instance_request_object
@@ -17564,8 +18026,7 @@ module Google
17564
18026
  # operation with the same request ID was received, and if so, will ignore the
17565
18027
  # second request. This prevents clients from accidentally creating duplicate
17566
18028
  # commitments. The request ID must be a valid UUID with the exception that zero
17567
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
17568
- # MixerMutationRequestBuilder
18029
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
17569
18030
  # @param [String] fields
17570
18031
  # Selector specifying which fields to include in a partial response.
17571
18032
  # @param [String] quota_user
@@ -17648,8 +18109,7 @@ module Google
17648
18109
  # operation with the same request ID was received, and if so, will ignore the
17649
18110
  # second request. This prevents clients from accidentally creating duplicate
17650
18111
  # commitments. The request ID must be a valid UUID with the exception that zero
17651
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
17652
- # MixerMutationRequestBuilder
18112
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
17653
18113
  # @param [String] fields
17654
18114
  # Selector specifying which fields to include in a partial response.
17655
18115
  # @param [String] quota_user
@@ -17777,8 +18237,7 @@ module Google
17777
18237
  # operation with the same request ID was received, and if so, will ignore the
17778
18238
  # second request. This prevents clients from accidentally creating duplicate
17779
18239
  # commitments. The request ID must be a valid UUID with the exception that zero
17780
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
17781
- # MixerMutationRequestBuilder
18240
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
17782
18241
  # @param [String] fields
17783
18242
  # Selector specifying which fields to include in a partial response.
17784
18243
  # @param [String] quota_user
@@ -17915,8 +18374,7 @@ module Google
17915
18374
  # operation with the same request ID was received, and if so, will ignore the
17916
18375
  # second request. This prevents clients from accidentally creating duplicate
17917
18376
  # commitments. The request ID must be a valid UUID with the exception that zero
17918
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
17919
- # MixerMutationRequestBuilder
18377
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
17920
18378
  # @param [String] fields
17921
18379
  # Selector specifying which fields to include in a partial response.
17922
18380
  # @param [String] quota_user
@@ -18005,8 +18463,7 @@ module Google
18005
18463
  # operation with the same request ID was received, and if so, will ignore the
18006
18464
  # second request. This prevents clients from accidentally creating duplicate
18007
18465
  # commitments. The request ID must be a valid UUID with the exception that zero
18008
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
18009
- # MixerMutationRequestBuilder
18466
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
18010
18467
  # @param [String] fields
18011
18468
  # Selector specifying which fields to include in a partial response.
18012
18469
  # @param [String] quota_user
@@ -18140,8 +18597,7 @@ module Google
18140
18597
  # operation with the same request ID was received, and if so, will ignore the
18141
18598
  # second request. This prevents clients from accidentally creating duplicate
18142
18599
  # commitments. The request ID must be a valid UUID with the exception that zero
18143
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
18144
- # MixerMutationRequestBuilder
18600
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
18145
18601
  # @param [String] fields
18146
18602
  # Selector specifying which fields to include in a partial response.
18147
18603
  # @param [String] quota_user
@@ -19135,6 +19591,66 @@ module Google
19135
19591
  execute_or_queue_command(command, &block)
19136
19592
  end
19137
19593
 
19594
+ # Updates the specified commitment with the data included in the request. Update
19595
+ # is performed only on selected fields included as part of update-mask. Only the
19596
+ # following fields can be modified: auto_renew.
19597
+ # @param [String] project
19598
+ # Project ID for this request.
19599
+ # @param [String] region
19600
+ # Name of the region for this request.
19601
+ # @param [String] commitment
19602
+ # Name of the commitment for which auto renew is being updated.
19603
+ # @param [Google::Apis::ComputeV1::Commitment] commitment_object
19604
+ # @param [Array<String>, String] paths
19605
+ # @param [String] request_id
19606
+ # An optional request ID to identify requests. Specify a unique request ID so
19607
+ # that if you must retry your request, the server will know to ignore the
19608
+ # request if it has already been completed. For example, consider a situation
19609
+ # where you make an initial request and the request times out. If you make the
19610
+ # request again with the same request ID, the server can check if original
19611
+ # operation with the same request ID was received, and if so, will ignore the
19612
+ # second request. This prevents clients from accidentally creating duplicate
19613
+ # commitments. The request ID must be a valid UUID with the exception that zero
19614
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
19615
+ # @param [String] update_mask
19616
+ # update_mask indicates fields to be updated as part of this request.
19617
+ # @param [String] fields
19618
+ # Selector specifying which fields to include in a partial response.
19619
+ # @param [String] quota_user
19620
+ # Available to use for quota purposes for server-side applications. Can be any
19621
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
19622
+ # @param [String] user_ip
19623
+ # Legacy name for parameter that has been superseded by `quotaUser`.
19624
+ # @param [Google::Apis::RequestOptions] options
19625
+ # Request-specific options
19626
+ #
19627
+ # @yield [result, err] Result & error if block supplied
19628
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
19629
+ # @yieldparam err [StandardError] error object if request failed
19630
+ #
19631
+ # @return [Google::Apis::ComputeV1::Operation]
19632
+ #
19633
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
19634
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
19635
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
19636
+ def update_region_commitment(project, region, commitment, commitment_object = nil, paths: nil, request_id: nil, update_mask: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
19637
+ command = make_simple_command(:patch, 'projects/{project}/regions/{region}/commitments/{commitment}', options)
19638
+ command.request_representation = Google::Apis::ComputeV1::Commitment::Representation
19639
+ command.request_object = commitment_object
19640
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
19641
+ command.response_class = Google::Apis::ComputeV1::Operation
19642
+ command.params['project'] = project unless project.nil?
19643
+ command.params['region'] = region unless region.nil?
19644
+ command.params['commitment'] = commitment unless commitment.nil?
19645
+ command.query['paths'] = paths unless paths.nil?
19646
+ command.query['requestId'] = request_id unless request_id.nil?
19647
+ command.query['updateMask'] = update_mask unless update_mask.nil?
19648
+ command.query['fields'] = fields unless fields.nil?
19649
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
19650
+ command.query['userIp'] = user_ip unless user_ip.nil?
19651
+ execute_or_queue_command(command, &block)
19652
+ end
19653
+
19138
19654
  # Returns the specified regional disk type. Gets a list of available disk types
19139
19655
  # by making a list() request.
19140
19656
  # @param [String] project
@@ -19309,7 +19825,10 @@ module Google
19309
19825
  execute_or_queue_command(command, &block)
19310
19826
  end
19311
19827
 
19312
- # Creates a snapshot of this regional disk.
19828
+ # Creates a snapshot of a specified persistent disk. For regular snapshot
19829
+ # creation, consider using snapshots.insert instead, as that method supports
19830
+ # more features, such as creating snapshots in a project different from the
19831
+ # source disk project.
19313
19832
  # @param [String] project
19314
19833
  # Project ID for this request.
19315
19834
  # @param [String] region
@@ -22195,8 +22714,7 @@ module Google
22195
22714
  # operation with the same request ID was received, and if so, will ignore the
22196
22715
  # second request. This prevents clients from accidentally creating duplicate
22197
22716
  # commitments. The request ID must be a valid UUID with the exception that zero
22198
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
22199
- # MixerMutationRequestBuilder
22717
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
22200
22718
  # @param [String] fields
22201
22719
  # Selector specifying which fields to include in a partial response.
22202
22720
  # @param [String] quota_user
@@ -22285,8 +22803,7 @@ module Google
22285
22803
  # operation with the same request ID was received, and if so, will ignore the
22286
22804
  # second request. This prevents clients from accidentally creating duplicate
22287
22805
  # commitments. The request ID must be a valid UUID with the exception that zero
22288
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
22289
- # MixerMutationRequestBuilder
22806
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
22290
22807
  # @param [String] fields
22291
22808
  # Selector specifying which fields to include in a partial response.
22292
22809
  # @param [String] quota_user
@@ -22621,8 +23138,7 @@ module Google
22621
23138
  # operation with the same request ID was received, and if so, will ignore the
22622
23139
  # second request. This prevents clients from accidentally creating duplicate
22623
23140
  # commitments. The request ID must be a valid UUID with the exception that zero
22624
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
22625
- # MixerMutationRequestBuilder
23141
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
22626
23142
  # @param [String] fields
22627
23143
  # Selector specifying which fields to include in a partial response.
22628
23144
  # @param [String] quota_user
@@ -22712,8 +23228,7 @@ module Google
22712
23228
  # operation with the same request ID was received, and if so, will ignore the
22713
23229
  # second request. This prevents clients from accidentally creating duplicate
22714
23230
  # commitments. The request ID must be a valid UUID with the exception that zero
22715
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
22716
- # MixerMutationRequestBuilder
23231
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
22717
23232
  # @param [String] fields
22718
23233
  # Selector specifying which fields to include in a partial response.
22719
23234
  # @param [String] quota_user
@@ -23120,8 +23635,7 @@ module Google
23120
23635
  # operation with the same request ID was received, and if so, will ignore the
23121
23636
  # second request. This prevents clients from accidentally creating duplicate
23122
23637
  # commitments. The request ID must be a valid UUID with the exception that zero
23123
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
23124
- # MixerMutationRequestBuilder
23638
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
23125
23639
  # @param [String] fields
23126
23640
  # Selector specifying which fields to include in a partial response.
23127
23641
  # @param [String] quota_user
@@ -23211,8 +23725,7 @@ module Google
23211
23725
  # operation with the same request ID was received, and if so, will ignore the
23212
23726
  # second request. This prevents clients from accidentally creating duplicate
23213
23727
  # commitments. The request ID must be a valid UUID with the exception that zero
23214
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
23215
- # MixerMutationRequestBuilder
23728
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
23216
23729
  # @param [String] fields
23217
23730
  # Selector specifying which fields to include in a partial response.
23218
23731
  # @param [String] quota_user
@@ -23345,8 +23858,7 @@ module Google
23345
23858
  # operation with the same request ID was received, and if so, will ignore the
23346
23859
  # second request. This prevents clients from accidentally creating duplicate
23347
23860
  # commitments. The request ID must be a valid UUID with the exception that zero
23348
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
23349
- # MixerMutationRequestBuilder
23861
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
23350
23862
  # @param [String] fields
23351
23863
  # Selector specifying which fields to include in a partial response.
23352
23864
  # @param [String] quota_user
@@ -23399,8 +23911,7 @@ module Google
23399
23911
  # operation with the same request ID was received, and if so, will ignore the
23400
23912
  # second request. This prevents clients from accidentally creating duplicate
23401
23913
  # commitments. The request ID must be a valid UUID with the exception that zero
23402
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
23403
- # MixerMutationRequestBuilder
23914
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
23404
23915
  # @param [String] fields
23405
23916
  # Selector specifying which fields to include in a partial response.
23406
23917
  # @param [String] quota_user
@@ -23778,7 +24289,13 @@ module Google
23778
24289
  end
23779
24290
 
23780
24291
  # Returns the specified Region resource. Gets a list of available regions by
23781
- # making a list() request.
24292
+ # making a list() request. To decrease latency for this method, you can
24293
+ # optionally omit any unneeded information from the response by using a field
24294
+ # mask. This practice is especially recommended for unused quota information (
24295
+ # the `quotas` field). To exclude one or more fields, set your request's `fields`
24296
+ # query parameter to only include the fields you need. For example, to only
24297
+ # include the `id` and `selfLink` fields, add the query parameter `?fields=id,
24298
+ # selfLink` to your request.
23782
24299
  # @param [String] project
23783
24300
  # Project ID for this request.
23784
24301
  # @param [String] region
@@ -23814,7 +24331,14 @@ module Google
23814
24331
  execute_or_queue_command(command, &block)
23815
24332
  end
23816
24333
 
23817
- # Retrieves the list of region resources available to the specified project.
24334
+ # Retrieves the list of region resources available to the specified project. To
24335
+ # decrease latency for this method, you can optionally omit any unneeded
24336
+ # information from the response by using a field mask. This practice is
24337
+ # especially recommended for unused quota information (the `items.quotas` field).
24338
+ # To exclude one or more fields, set your request's `fields` query parameter to
24339
+ # only include the fields you need. For example, to only include the `id` and `
24340
+ # selfLink` fields, add the query parameter `?fields=id,selfLink` to your
24341
+ # request.
23818
24342
  # @param [String] project
23819
24343
  # Project ID for this request.
23820
24344
  # @param [String] filter
@@ -26261,8 +26785,7 @@ module Google
26261
26785
  # operation with the same request ID was received, and if so, will ignore the
26262
26786
  # second request. This prevents clients from accidentally creating duplicate
26263
26787
  # commitments. The request ID must be a valid UUID with the exception that zero
26264
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
26265
- # MixerMutationRequestBuilder
26788
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
26266
26789
  # @param [String] fields
26267
26790
  # Selector specifying which fields to include in a partial response.
26268
26791
  # @param [String] quota_user
@@ -26394,8 +26917,7 @@ module Google
26394
26917
  # operation with the same request ID was received, and if so, will ignore the
26395
26918
  # second request. This prevents clients from accidentally creating duplicate
26396
26919
  # commitments. The request ID must be a valid UUID with the exception that zero
26397
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
26398
- # MixerMutationRequestBuilder
26920
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
26399
26921
  # @param [String] fields
26400
26922
  # Selector specifying which fields to include in a partial response.
26401
26923
  # @param [String] quota_user
@@ -26530,8 +27052,7 @@ module Google
26530
27052
  # operation with the same request ID was received, and if so, will ignore the
26531
27053
  # second request. This prevents clients from accidentally creating duplicate
26532
27054
  # commitments. The request ID must be a valid UUID with the exception that zero
26533
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
26534
- # MixerMutationRequestBuilder
27055
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
26535
27056
  # @param [String] fields
26536
27057
  # Selector specifying which fields to include in a partial response.
26537
27058
  # @param [String] quota_user
@@ -26781,7 +27302,9 @@ module Google
26781
27302
  end
26782
27303
 
26783
27304
  # Creates a snapshot in the specified project using the data included in the
26784
- # request.
27305
+ # request. For regular snapshot creation, consider using this method instead of
27306
+ # disks.createSnapshot, as this method supports more features, such as creating
27307
+ # snapshots in a project different from the source disk project.
26785
27308
  # @param [String] project
26786
27309
  # Project ID for this request.
26787
27310
  # @param [Google::Apis::ComputeV1::Snapshot] snapshot_object
@@ -27125,8 +27648,7 @@ module Google
27125
27648
  # operation with the same request ID was received, and if so, will ignore the
27126
27649
  # second request. This prevents clients from accidentally creating duplicate
27127
27650
  # commitments. The request ID must be a valid UUID with the exception that zero
27128
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
27129
- # MixerMutationRequestBuilder
27651
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
27130
27652
  # @param [String] fields
27131
27653
  # Selector specifying which fields to include in a partial response.
27132
27654
  # @param [String] quota_user
@@ -27210,8 +27732,7 @@ module Google
27210
27732
  # operation with the same request ID was received, and if so, will ignore the
27211
27733
  # second request. This prevents clients from accidentally creating duplicate
27212
27734
  # commitments. The request ID must be a valid UUID with the exception that zero
27213
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
27214
- # MixerMutationRequestBuilder
27735
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
27215
27736
  # @param [String] fields
27216
27737
  # Selector specifying which fields to include in a partial response.
27217
27738
  # @param [String] quota_user
@@ -28360,8 +28881,7 @@ module Google
28360
28881
  # operation with the same request ID was received, and if so, will ignore the
28361
28882
  # second request. This prevents clients from accidentally creating duplicate
28362
28883
  # commitments. The request ID must be a valid UUID with the exception that zero
28363
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
28364
- # MixerMutationRequestBuilder
28884
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
28365
28885
  # @param [String] fields
28366
28886
  # Selector specifying which fields to include in a partial response.
28367
28887
  # @param [String] quota_user
@@ -28444,8 +28964,7 @@ module Google
28444
28964
  # operation with the same request ID was received, and if so, will ignore the
28445
28965
  # second request. This prevents clients from accidentally creating duplicate
28446
28966
  # commitments. The request ID must be a valid UUID with the exception that zero
28447
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
28448
- # MixerMutationRequestBuilder
28967
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
28449
28968
  # @param [String] fields
28450
28969
  # Selector specifying which fields to include in a partial response.
28451
28970
  # @param [String] quota_user
@@ -28573,8 +29092,7 @@ module Google
28573
29092
  # operation with the same request ID was received, and if so, will ignore the
28574
29093
  # second request. This prevents clients from accidentally creating duplicate
28575
29094
  # commitments. The request ID must be a valid UUID with the exception that zero
28576
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
28577
- # MixerMutationRequestBuilder
29095
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
28578
29096
  # @param [String] fields
28579
29097
  # Selector specifying which fields to include in a partial response.
28580
29098
  # @param [String] quota_user
@@ -28922,8 +29440,7 @@ module Google
28922
29440
  # operation with the same request ID was received, and if so, will ignore the
28923
29441
  # second request. This prevents clients from accidentally creating duplicate
28924
29442
  # commitments. The request ID must be a valid UUID with the exception that zero
28925
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
28926
- # MixerMutationRequestBuilder
29443
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
28927
29444
  # @param [String] fields
28928
29445
  # Selector specifying which fields to include in a partial response.
28929
29446
  # @param [String] quota_user
@@ -29321,8 +29838,7 @@ module Google
29321
29838
  # operation with the same request ID was received, and if so, will ignore the
29322
29839
  # second request. This prevents clients from accidentally creating duplicate
29323
29840
  # commitments. The request ID must be a valid UUID with the exception that zero
29324
- # UUID is not supported ( 00000000-0000-0000-0000-000000000000). end_interface:
29325
- # MixerMutationRequestBuilder
29841
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
29326
29842
  # @param [String] fields
29327
29843
  # Selector specifying which fields to include in a partial response.
29328
29844
  # @param [String] quota_user