google-apis-compute_v1 0.20.0 → 0.21.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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?
@@ -13779,6 +13786,341 @@ module Google
13779
13786
  execute_or_queue_command(command, &block)
13780
13787
  end
13781
13788
 
13789
+ # Deletes the specified machine image. Deleting a machine image is permanent and
13790
+ # cannot be undone.
13791
+ # @param [String] project
13792
+ # Project ID for this request.
13793
+ # @param [String] machine_image
13794
+ # The name of the machine image to delete.
13795
+ # @param [String] request_id
13796
+ # An optional request ID to identify requests. Specify a unique request ID so
13797
+ # that if you must retry your request, the server will know to ignore the
13798
+ # request if it has already been completed. For example, consider a situation
13799
+ # where you make an initial request and the request times out. If you make the
13800
+ # request again with the same request ID, the server can check if original
13801
+ # operation with the same request ID was received, and if so, will ignore the
13802
+ # second request. This prevents clients from accidentally creating duplicate
13803
+ # commitments. The request ID must be a valid UUID with the exception that zero
13804
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
13805
+ # @param [String] fields
13806
+ # Selector specifying which fields to include in a partial response.
13807
+ # @param [String] quota_user
13808
+ # Available to use for quota purposes for server-side applications. Can be any
13809
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
13810
+ # @param [String] user_ip
13811
+ # Legacy name for parameter that has been superseded by `quotaUser`.
13812
+ # @param [Google::Apis::RequestOptions] options
13813
+ # Request-specific options
13814
+ #
13815
+ # @yield [result, err] Result & error if block supplied
13816
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
13817
+ # @yieldparam err [StandardError] error object if request failed
13818
+ #
13819
+ # @return [Google::Apis::ComputeV1::Operation]
13820
+ #
13821
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
13822
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
13823
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
13824
+ def delete_machine_image(project, machine_image, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
13825
+ command = make_simple_command(:delete, 'projects/{project}/global/machineImages/{machineImage}', options)
13826
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
13827
+ command.response_class = Google::Apis::ComputeV1::Operation
13828
+ command.params['project'] = project unless project.nil?
13829
+ command.params['machineImage'] = machine_image unless machine_image.nil?
13830
+ command.query['requestId'] = request_id unless request_id.nil?
13831
+ command.query['fields'] = fields unless fields.nil?
13832
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
13833
+ command.query['userIp'] = user_ip unless user_ip.nil?
13834
+ execute_or_queue_command(command, &block)
13835
+ end
13836
+
13837
+ # Returns the specified machine image. Gets a list of available machine images
13838
+ # by making a list() request.
13839
+ # @param [String] project
13840
+ # Project ID for this request.
13841
+ # @param [String] machine_image
13842
+ # The name of the machine image.
13843
+ # @param [String] fields
13844
+ # Selector specifying which fields to include in a partial response.
13845
+ # @param [String] quota_user
13846
+ # Available to use for quota purposes for server-side applications. Can be any
13847
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
13848
+ # @param [String] user_ip
13849
+ # Legacy name for parameter that has been superseded by `quotaUser`.
13850
+ # @param [Google::Apis::RequestOptions] options
13851
+ # Request-specific options
13852
+ #
13853
+ # @yield [result, err] Result & error if block supplied
13854
+ # @yieldparam result [Google::Apis::ComputeV1::MachineImage] parsed result object
13855
+ # @yieldparam err [StandardError] error object if request failed
13856
+ #
13857
+ # @return [Google::Apis::ComputeV1::MachineImage]
13858
+ #
13859
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
13860
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
13861
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
13862
+ def get_machine_image(project, machine_image, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
13863
+ command = make_simple_command(:get, 'projects/{project}/global/machineImages/{machineImage}', options)
13864
+ command.response_representation = Google::Apis::ComputeV1::MachineImage::Representation
13865
+ command.response_class = Google::Apis::ComputeV1::MachineImage
13866
+ command.params['project'] = project unless project.nil?
13867
+ command.params['machineImage'] = machine_image unless machine_image.nil?
13868
+ command.query['fields'] = fields unless fields.nil?
13869
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
13870
+ command.query['userIp'] = user_ip unless user_ip.nil?
13871
+ execute_or_queue_command(command, &block)
13872
+ end
13873
+
13874
+ # Gets the access control policy for a resource. May be empty if no such policy
13875
+ # or resource exists.
13876
+ # @param [String] project
13877
+ # Project ID for this request.
13878
+ # @param [String] resource
13879
+ # Name or id of the resource for this request.
13880
+ # @param [Fixnum] options_requested_policy_version
13881
+ # Requested IAM Policy version.
13882
+ # @param [String] fields
13883
+ # Selector specifying which fields to include in a partial response.
13884
+ # @param [String] quota_user
13885
+ # Available to use for quota purposes for server-side applications. Can be any
13886
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
13887
+ # @param [String] user_ip
13888
+ # Legacy name for parameter that has been superseded by `quotaUser`.
13889
+ # @param [Google::Apis::RequestOptions] options
13890
+ # Request-specific options
13891
+ #
13892
+ # @yield [result, err] Result & error if block supplied
13893
+ # @yieldparam result [Google::Apis::ComputeV1::Policy] parsed result object
13894
+ # @yieldparam err [StandardError] error object if request failed
13895
+ #
13896
+ # @return [Google::Apis::ComputeV1::Policy]
13897
+ #
13898
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
13899
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
13900
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
13901
+ def get_machine_image_iam_policy(project, resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
13902
+ command = make_simple_command(:get, 'projects/{project}/global/machineImages/{resource}/getIamPolicy', options)
13903
+ command.response_representation = Google::Apis::ComputeV1::Policy::Representation
13904
+ command.response_class = Google::Apis::ComputeV1::Policy
13905
+ command.params['project'] = project unless project.nil?
13906
+ command.params['resource'] = resource unless resource.nil?
13907
+ command.query['optionsRequestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
13908
+ command.query['fields'] = fields unless fields.nil?
13909
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
13910
+ command.query['userIp'] = user_ip unless user_ip.nil?
13911
+ execute_or_queue_command(command, &block)
13912
+ end
13913
+
13914
+ # Creates a machine image in the specified project using the data that is
13915
+ # included in the request. If you are creating a new machine image to update an
13916
+ # existing instance, your new machine image should use the same network or, if
13917
+ # applicable, the same subnetwork as the original instance.
13918
+ # @param [String] project
13919
+ # Project ID for this request.
13920
+ # @param [Google::Apis::ComputeV1::MachineImage] machine_image_object
13921
+ # @param [String] request_id
13922
+ # An optional request ID to identify requests. Specify a unique request ID so
13923
+ # that if you must retry your request, the server will know to ignore the
13924
+ # request if it has already been completed. For example, consider a situation
13925
+ # where you make an initial request and the request times out. If you make the
13926
+ # request again with the same request ID, the server can check if original
13927
+ # operation with the same request ID was received, and if so, will ignore the
13928
+ # second request. This prevents clients from accidentally creating duplicate
13929
+ # commitments. The request ID must be a valid UUID with the exception that zero
13930
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
13931
+ # @param [String] source_instance
13932
+ # Required. Source instance that is used to create the machine image from.
13933
+ # @param [String] fields
13934
+ # Selector specifying which fields to include in a partial response.
13935
+ # @param [String] quota_user
13936
+ # Available to use for quota purposes for server-side applications. Can be any
13937
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
13938
+ # @param [String] user_ip
13939
+ # Legacy name for parameter that has been superseded by `quotaUser`.
13940
+ # @param [Google::Apis::RequestOptions] options
13941
+ # Request-specific options
13942
+ #
13943
+ # @yield [result, err] Result & error if block supplied
13944
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
13945
+ # @yieldparam err [StandardError] error object if request failed
13946
+ #
13947
+ # @return [Google::Apis::ComputeV1::Operation]
13948
+ #
13949
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
13950
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
13951
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
13952
+ 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)
13953
+ command = make_simple_command(:post, 'projects/{project}/global/machineImages', options)
13954
+ command.request_representation = Google::Apis::ComputeV1::MachineImage::Representation
13955
+ command.request_object = machine_image_object
13956
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
13957
+ command.response_class = Google::Apis::ComputeV1::Operation
13958
+ command.params['project'] = project unless project.nil?
13959
+ command.query['requestId'] = request_id unless request_id.nil?
13960
+ command.query['sourceInstance'] = source_instance unless source_instance.nil?
13961
+ command.query['fields'] = fields unless fields.nil?
13962
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
13963
+ command.query['userIp'] = user_ip unless user_ip.nil?
13964
+ execute_or_queue_command(command, &block)
13965
+ end
13966
+
13967
+ # Retrieves a list of machine images that are contained within the specified
13968
+ # project.
13969
+ # @param [String] project
13970
+ # Project ID for this request.
13971
+ # @param [String] filter
13972
+ # A filter expression that filters resources listed in the response. The
13973
+ # expression must specify the field name, an operator, and the value that you
13974
+ # want to use for filtering. The value must be a string, a number, or a boolean.
13975
+ # The operator must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. For
13976
+ # example, if you are filtering Compute Engine instances, you can exclude
13977
+ # instances named `example-instance` by specifying `name != example-instance`.
13978
+ # The `:` operator can be used with string fields to match substrings. For non-
13979
+ # string fields it is equivalent to the `=` operator. The `:*` comparison can be
13980
+ # used to test whether a key has been defined. For example, to find all objects
13981
+ # with `owner` label use: ``` labels.owner:* ``` You can also filter nested
13982
+ # fields. For example, you could specify `scheduling.automaticRestart = false`
13983
+ # to include instances only if they are not scheduled for automatic restarts.
13984
+ # You can use filtering on nested fields to filter based on resource labels. To
13985
+ # filter on multiple expressions, provide each separate expression within
13986
+ # parentheses. For example: ``` (scheduling.automaticRestart = true) (
13987
+ # cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND`
13988
+ # expression. However, you can include `AND` and `OR` expressions explicitly.
13989
+ # For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel
13990
+ # Broadwell") AND (scheduling.automaticRestart = true) ```
13991
+ # @param [Fixnum] max_results
13992
+ # The maximum number of results per page that should be returned. If the number
13993
+ # of available results is larger than `maxResults`, Compute Engine returns a `
13994
+ # nextPageToken` that can be used to get the next page of results in subsequent
13995
+ # list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
13996
+ # @param [String] order_by
13997
+ # Sorts list results by a certain order. By default, results are returned in
13998
+ # alphanumerical order based on the resource name. You can also sort results in
13999
+ # descending order based on the creation timestamp using `orderBy="
14000
+ # creationTimestamp desc"`. This sorts results based on the `creationTimestamp`
14001
+ # field in reverse chronological order (newest result first). Use this to sort
14002
+ # resources like operations so that the newest operation is returned first.
14003
+ # Currently, only sorting by `name` or `creationTimestamp desc` is supported.
14004
+ # @param [String] page_token
14005
+ # Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned
14006
+ # by a previous list request to get the next page of results.
14007
+ # @param [Boolean] return_partial_success
14008
+ # Opt-in for partial success behavior which provides partial results in case of
14009
+ # failure. The default value is false.
14010
+ # @param [String] fields
14011
+ # Selector specifying which fields to include in a partial response.
14012
+ # @param [String] quota_user
14013
+ # Available to use for quota purposes for server-side applications. Can be any
14014
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
14015
+ # @param [String] user_ip
14016
+ # Legacy name for parameter that has been superseded by `quotaUser`.
14017
+ # @param [Google::Apis::RequestOptions] options
14018
+ # Request-specific options
14019
+ #
14020
+ # @yield [result, err] Result & error if block supplied
14021
+ # @yieldparam result [Google::Apis::ComputeV1::MachineImageList] parsed result object
14022
+ # @yieldparam err [StandardError] error object if request failed
14023
+ #
14024
+ # @return [Google::Apis::ComputeV1::MachineImageList]
14025
+ #
14026
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
14027
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
14028
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
14029
+ 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)
14030
+ command = make_simple_command(:get, 'projects/{project}/global/machineImages', options)
14031
+ command.response_representation = Google::Apis::ComputeV1::MachineImageList::Representation
14032
+ command.response_class = Google::Apis::ComputeV1::MachineImageList
14033
+ command.params['project'] = project unless project.nil?
14034
+ command.query['filter'] = filter unless filter.nil?
14035
+ command.query['maxResults'] = max_results unless max_results.nil?
14036
+ command.query['orderBy'] = order_by unless order_by.nil?
14037
+ command.query['pageToken'] = page_token unless page_token.nil?
14038
+ command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
14039
+ command.query['fields'] = fields unless fields.nil?
14040
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
14041
+ command.query['userIp'] = user_ip unless user_ip.nil?
14042
+ execute_or_queue_command(command, &block)
14043
+ end
14044
+
14045
+ # Sets the access control policy on the specified resource. Replaces any
14046
+ # existing policy.
14047
+ # @param [String] project
14048
+ # Project ID for this request.
14049
+ # @param [String] resource
14050
+ # Name or id of the resource for this request.
14051
+ # @param [Google::Apis::ComputeV1::GlobalSetPolicyRequest] global_set_policy_request_object
14052
+ # @param [String] fields
14053
+ # Selector specifying which fields to include in a partial response.
14054
+ # @param [String] quota_user
14055
+ # Available to use for quota purposes for server-side applications. Can be any
14056
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
14057
+ # @param [String] user_ip
14058
+ # Legacy name for parameter that has been superseded by `quotaUser`.
14059
+ # @param [Google::Apis::RequestOptions] options
14060
+ # Request-specific options
14061
+ #
14062
+ # @yield [result, err] Result & error if block supplied
14063
+ # @yieldparam result [Google::Apis::ComputeV1::Policy] parsed result object
14064
+ # @yieldparam err [StandardError] error object if request failed
14065
+ #
14066
+ # @return [Google::Apis::ComputeV1::Policy]
14067
+ #
14068
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
14069
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
14070
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
14071
+ 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)
14072
+ command = make_simple_command(:post, 'projects/{project}/global/machineImages/{resource}/setIamPolicy', options)
14073
+ command.request_representation = Google::Apis::ComputeV1::GlobalSetPolicyRequest::Representation
14074
+ command.request_object = global_set_policy_request_object
14075
+ command.response_representation = Google::Apis::ComputeV1::Policy::Representation
14076
+ command.response_class = Google::Apis::ComputeV1::Policy
14077
+ command.params['project'] = project unless project.nil?
14078
+ command.params['resource'] = resource unless resource.nil?
14079
+ command.query['fields'] = fields unless fields.nil?
14080
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
14081
+ command.query['userIp'] = user_ip unless user_ip.nil?
14082
+ execute_or_queue_command(command, &block)
14083
+ end
14084
+
14085
+ # Returns permissions that a caller has on the specified resource.
14086
+ # @param [String] project
14087
+ # Project ID for this request.
14088
+ # @param [String] resource
14089
+ # Name or id of the resource for this request.
14090
+ # @param [Google::Apis::ComputeV1::TestPermissionsRequest] test_permissions_request_object
14091
+ # @param [String] fields
14092
+ # Selector specifying which fields to include in a partial response.
14093
+ # @param [String] quota_user
14094
+ # Available to use for quota purposes for server-side applications. Can be any
14095
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
14096
+ # @param [String] user_ip
14097
+ # Legacy name for parameter that has been superseded by `quotaUser`.
14098
+ # @param [Google::Apis::RequestOptions] options
14099
+ # Request-specific options
14100
+ #
14101
+ # @yield [result, err] Result & error if block supplied
14102
+ # @yieldparam result [Google::Apis::ComputeV1::TestPermissionsResponse] parsed result object
14103
+ # @yieldparam err [StandardError] error object if request failed
14104
+ #
14105
+ # @return [Google::Apis::ComputeV1::TestPermissionsResponse]
14106
+ #
14107
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
14108
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
14109
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
14110
+ def test_machine_image_iam_permissions(project, resource, test_permissions_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
14111
+ command = make_simple_command(:post, 'projects/{project}/global/machineImages/{resource}/testIamPermissions', options)
14112
+ command.request_representation = Google::Apis::ComputeV1::TestPermissionsRequest::Representation
14113
+ command.request_object = test_permissions_request_object
14114
+ command.response_representation = Google::Apis::ComputeV1::TestPermissionsResponse::Representation
14115
+ command.response_class = Google::Apis::ComputeV1::TestPermissionsResponse
14116
+ command.params['project'] = project unless project.nil?
14117
+ command.params['resource'] = resource unless resource.nil?
14118
+ command.query['fields'] = fields unless fields.nil?
14119
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
14120
+ command.query['userIp'] = user_ip unless user_ip.nil?
14121
+ execute_or_queue_command(command, &block)
14122
+ end
14123
+
13782
14124
  # Retrieves an aggregated list of machine types.
13783
14125
  # @param [String] project
13784
14126
  # Project ID for this request.
@@ -17085,7 +17427,13 @@ module Google
17085
17427
  execute_or_queue_command(command, &block)
17086
17428
  end
17087
17429
 
17088
- # Returns the specified Project resource.
17430
+ # Returns the specified Project resource. To decrease latency for this method,
17431
+ # you can optionally omit any unneeded information from the response by using a
17432
+ # field mask. This practice is especially recommended for unused quota
17433
+ # information (the `quotas` field). To exclude one or more fields, set your
17434
+ # request's `fields` query parameter to only include the fields you need. For
17435
+ # example, to only include the `id` and `selfLink` fields, add the query
17436
+ # parameter `?fields=id,selfLink` to your request.
17089
17437
  # @param [String] project
17090
17438
  # Project ID for this request.
17091
17439
  # @param [String] fields
@@ -17357,7 +17705,12 @@ module Google
17357
17705
  execute_or_queue_command(command, &block)
17358
17706
  end
17359
17707
 
17360
- # Moves an instance and its attached persistent disks from one zone to another.
17708
+ # Moves an instance and its attached persistent disks from one zone to another. *
17709
+ # Note*: Moving VMs or disks by using this method might cause unexpected
17710
+ # behavior. For more information, see the [known issue](/compute/docs/
17711
+ # troubleshooting/known-issues#
17712
+ # ving_vms_or_disks_using_the_moveinstance_api_or_the_causes_unexpected_behavior)
17713
+ # .
17361
17714
  # @param [String] project
17362
17715
  # Project ID for this request.
17363
17716
  # @param [Google::Apis::ComputeV1::MoveInstanceRequest] move_instance_request_object
@@ -19135,6 +19488,66 @@ module Google
19135
19488
  execute_or_queue_command(command, &block)
19136
19489
  end
19137
19490
 
19491
+ # Updates the specified commitment with the data included in the request. Update
19492
+ # is performed only on selected fields included as part of update-mask. Only the
19493
+ # following fields can be modified: auto_renew.
19494
+ # @param [String] project
19495
+ # Project ID for this request.
19496
+ # @param [String] region
19497
+ # Name of the region for this request.
19498
+ # @param [String] commitment
19499
+ # Name of the commitment for which auto renew is being updated.
19500
+ # @param [Google::Apis::ComputeV1::Commitment] commitment_object
19501
+ # @param [Array<String>, String] paths
19502
+ # @param [String] request_id
19503
+ # An optional request ID to identify requests. Specify a unique request ID so
19504
+ # that if you must retry your request, the server will know to ignore the
19505
+ # request if it has already been completed. For example, consider a situation
19506
+ # where you make an initial request and the request times out. If you make the
19507
+ # request again with the same request ID, the server can check if original
19508
+ # operation with the same request ID was received, and if so, will ignore the
19509
+ # second request. This prevents clients from accidentally creating duplicate
19510
+ # commitments. The request ID must be a valid UUID with the exception that zero
19511
+ # UUID is not supported ( 00000000-0000-0000-0000-000000000000).
19512
+ # @param [String] update_mask
19513
+ # update_mask indicates fields to be updated as part of this request.
19514
+ # @param [String] fields
19515
+ # Selector specifying which fields to include in a partial response.
19516
+ # @param [String] quota_user
19517
+ # Available to use for quota purposes for server-side applications. Can be any
19518
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
19519
+ # @param [String] user_ip
19520
+ # Legacy name for parameter that has been superseded by `quotaUser`.
19521
+ # @param [Google::Apis::RequestOptions] options
19522
+ # Request-specific options
19523
+ #
19524
+ # @yield [result, err] Result & error if block supplied
19525
+ # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
19526
+ # @yieldparam err [StandardError] error object if request failed
19527
+ #
19528
+ # @return [Google::Apis::ComputeV1::Operation]
19529
+ #
19530
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
19531
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
19532
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
19533
+ 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)
19534
+ command = make_simple_command(:patch, 'projects/{project}/regions/{region}/commitments/{commitment}', options)
19535
+ command.request_representation = Google::Apis::ComputeV1::Commitment::Representation
19536
+ command.request_object = commitment_object
19537
+ command.response_representation = Google::Apis::ComputeV1::Operation::Representation
19538
+ command.response_class = Google::Apis::ComputeV1::Operation
19539
+ command.params['project'] = project unless project.nil?
19540
+ command.params['region'] = region unless region.nil?
19541
+ command.params['commitment'] = commitment unless commitment.nil?
19542
+ command.query['paths'] = paths unless paths.nil?
19543
+ command.query['requestId'] = request_id unless request_id.nil?
19544
+ command.query['updateMask'] = update_mask unless update_mask.nil?
19545
+ command.query['fields'] = fields unless fields.nil?
19546
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
19547
+ command.query['userIp'] = user_ip unless user_ip.nil?
19548
+ execute_or_queue_command(command, &block)
19549
+ end
19550
+
19138
19551
  # Returns the specified regional disk type. Gets a list of available disk types
19139
19552
  # by making a list() request.
19140
19553
  # @param [String] project
@@ -23778,7 +24191,13 @@ module Google
23778
24191
  end
23779
24192
 
23780
24193
  # Returns the specified Region resource. Gets a list of available regions by
23781
- # making a list() request.
24194
+ # making a list() request. To decrease latency for this method, you can
24195
+ # optionally omit any unneeded information from the response by using a field
24196
+ # mask. This practice is especially recommended for unused quota information (
24197
+ # the `quotas` field). To exclude one or more fields, set your request's `fields`
24198
+ # query parameter to only include the fields you need. For example, to only
24199
+ # include the `id` and `selfLink` fields, add the query parameter `?fields=id,
24200
+ # selfLink` to your request.
23782
24201
  # @param [String] project
23783
24202
  # Project ID for this request.
23784
24203
  # @param [String] region
@@ -23814,7 +24233,14 @@ module Google
23814
24233
  execute_or_queue_command(command, &block)
23815
24234
  end
23816
24235
 
23817
- # Retrieves the list of region resources available to the specified project.
24236
+ # Retrieves the list of region resources available to the specified project. To
24237
+ # decrease latency for this method, you can optionally omit any unneeded
24238
+ # information from the response by using a field mask. This practice is
24239
+ # especially recommended for unused quota information (the `items.quotas` field).
24240
+ # To exclude one or more fields, set your request's `fields` query parameter to
24241
+ # only include the fields you need. For example, to only include the `id` and `
24242
+ # selfLink` fields, add the query parameter `?fields=id,selfLink` to your
24243
+ # request.
23818
24244
  # @param [String] project
23819
24245
  # Project ID for this request.
23820
24246
  # @param [String] filter
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-compute_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.20.0
4
+ version: 0.21.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-11-15 00:00:00.000000000 Z
11
+ date: 2021-12-06 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-compute_v1/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-compute_v1/v0.20.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-compute_v1/v0.21.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-compute_v1
63
63
  post_install_message:
64
64
  rdoc_options: []