google-apis-compute_v1 0.20.0 → 0.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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: []