google-apis-compute_v1 0.20.0 → 0.24.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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