generated/google/apis/compute_beta/service.rb in google-api-client-0.25.0 vs generated/google/apis/compute_beta/service.rb in google-api-client-0.26.0
- old
+ new
@@ -527,11 +527,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::RegionSetLabelsRequest] region_set_labels_request_object
# @param [String] request_id
# An optional request ID to identify requests. Specify a unique request ID so
# that if you must retry your request, the server will know to ignore the
# request if it has already been completed.
@@ -581,11 +581,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -617,10 +617,422 @@
command.query['quotaUser'] = quota_user unless quota_user.nil?
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
+ # Retrieves an aggregated list of allocations.
+ # @param [String] project
+ # Project ID for this request.
+ # @param [String] filter
+ # A filter expression that filters resources listed in the response. The
+ # expression must specify the field name, a comparison operator, and the value
+ # that you want to use for filtering. The value must be a string, a number, or a
+ # boolean. The comparison operator must be either =, !=, >, or <.
+ # For example, if you are filtering Compute Engine instances, you can exclude
+ # instances named example-instance by specifying name != example-instance.
+ # You can also filter nested fields. For example, you could specify scheduling.
+ # automaticRestart = false to include instances only if they are not scheduled
+ # for automatic restarts. You can use filtering on nested fields to filter based
+ # on resource labels.
+ # To filter on multiple expressions, provide each separate expression within
+ # parentheses. For example, (scheduling.automaticRestart = true) (cpuPlatform = "
+ # Intel Skylake"). By default, each expression is an AND expression. However,
+ # you can include AND and OR expressions explicitly. For example, (cpuPlatform =
+ # "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.
+ # automaticRestart = true).
+ # @param [Fixnum] max_results
+ # The maximum number of results per page that should be returned. If the number
+ # of available results is larger than maxResults, Compute Engine returns a
+ # nextPageToken that can be used to get the next page of results in subsequent
+ # list requests. Acceptable values are 0 to 500, inclusive. (Default: 500)
+ # @param [String] order_by
+ # Sorts list results by a certain order. By default, results are returned in
+ # alphanumerical order based on the resource name.
+ # You can also sort results in descending order based on the creation timestamp
+ # using orderBy="creationTimestamp desc". This sorts results based on the
+ # creationTimestamp field in reverse chronological order (newest result first).
+ # Use this to sort resources like operations so that the newest operation is
+ # returned first.
+ # Currently, only sorting by name or creationTimestamp desc is supported.
+ # @param [String] page_token
+ # Specifies a page token to use. Set pageToken to the nextPageToken returned by
+ # a previous list request to get the next page of results.
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
+ # characters.
+ # @param [String] user_ip
+ # Deprecated. Please use quotaUser instead.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::ComputeBeta::AllocationAggregatedList] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::ComputeBeta::AllocationAggregatedList]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def aggregated_allocation_list(project, filter: nil, max_results: nil, order_by: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+ command = make_simple_command(:get, '{project}/aggregated/allocations', options)
+ command.response_representation = Google::Apis::ComputeBeta::AllocationAggregatedList::Representation
+ command.response_class = Google::Apis::ComputeBeta::AllocationAggregatedList
+ command.params['project'] = project unless project.nil?
+ command.query['filter'] = filter unless filter.nil?
+ command.query['maxResults'] = max_results unless max_results.nil?
+ command.query['orderBy'] = order_by unless order_by.nil?
+ command.query['pageToken'] = page_token unless page_token.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ command.query['userIp'] = user_ip unless user_ip.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # Deletes the specified allocation.
+ # @param [String] project
+ # Project ID for this request.
+ # @param [String] zone
+ # Name of the zone for this request.
+ # @param [String] allocation
+ # Name of the allocation to delete.
+ # @param [String] request_id
+ # An optional request ID to identify requests. Specify a unique request ID so
+ # that if you must retry your request, the server will know to ignore the
+ # request if it has already been completed.
+ # For example, consider a situation where you make an initial request and the
+ # request times out. If you make the request again with the same request ID, the
+ # server can check if original operation with the same request ID was received,
+ # and if so, will ignore the second request. This prevents clients from
+ # accidentally creating duplicate commitments.
+ # The request ID must be a valid UUID with the exception that zero UUID is not
+ # supported (00000000-0000-0000-0000-000000000000).
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
+ # characters.
+ # @param [String] user_ip
+ # Deprecated. Please use quotaUser instead.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::ComputeBeta::Operation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def delete_allocation(project, zone, allocation, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+ command = make_simple_command(:delete, '{project}/zones/{zone}/allocations/{allocation}', options)
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
+ command.response_class = Google::Apis::ComputeBeta::Operation
+ command.params['project'] = project unless project.nil?
+ command.params['zone'] = zone unless zone.nil?
+ command.params['allocation'] = allocation unless allocation.nil?
+ command.query['requestId'] = request_id unless request_id.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ command.query['userIp'] = user_ip unless user_ip.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # Retrieves all information of the specified allocation.
+ # @param [String] project
+ # Project ID for this request.
+ # @param [String] zone
+ # Name of the zone for this request.
+ # @param [String] allocation
+ # Name of the allocation to retrieve.
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
+ # characters.
+ # @param [String] user_ip
+ # Deprecated. Please use quotaUser instead.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::ComputeBeta::Allocation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::ComputeBeta::Allocation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def get_allocation(project, zone, allocation, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+ command = make_simple_command(:get, '{project}/zones/{zone}/allocations/{allocation}', options)
+ command.response_representation = Google::Apis::ComputeBeta::Allocation::Representation
+ command.response_class = Google::Apis::ComputeBeta::Allocation
+ command.params['project'] = project unless project.nil?
+ command.params['zone'] = zone unless zone.nil?
+ command.params['allocation'] = allocation unless allocation.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ command.query['userIp'] = user_ip unless user_ip.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # Gets the access control policy for a resource. May be empty if no such policy
+ # or resource exists.
+ # @param [String] project
+ # Project ID for this request.
+ # @param [String] zone
+ # The name of the zone for this request.
+ # @param [String] resource
+ # Name or id of the resource for this request.
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
+ # characters.
+ # @param [String] user_ip
+ # Deprecated. Please use quotaUser instead.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::ComputeBeta::Policy] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::ComputeBeta::Policy]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def get_allocation_iam_policy(project, zone, resource, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+ command = make_simple_command(:get, '{project}/zones/{zone}/allocations/{resource}/getIamPolicy', options)
+ command.response_representation = Google::Apis::ComputeBeta::Policy::Representation
+ command.response_class = Google::Apis::ComputeBeta::Policy
+ command.params['project'] = project unless project.nil?
+ command.params['zone'] = zone unless zone.nil?
+ command.params['resource'] = resource unless resource.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ command.query['userIp'] = user_ip unless user_ip.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # Creates a new allocation.
+ # @param [String] project
+ # Project ID for this request.
+ # @param [String] zone
+ # Name of the zone for this request.
+ # @param [Google::Apis::ComputeBeta::Allocation] allocation_object
+ # @param [String] request_id
+ # An optional request ID to identify requests. Specify a unique request ID so
+ # that if you must retry your request, the server will know to ignore the
+ # request if it has already been completed.
+ # For example, consider a situation where you make an initial request and the
+ # request times out. If you make the request again with the same request ID, the
+ # server can check if original operation with the same request ID was received,
+ # and if so, will ignore the second request. This prevents clients from
+ # accidentally creating duplicate commitments.
+ # The request ID must be a valid UUID with the exception that zero UUID is not
+ # supported (00000000-0000-0000-0000-000000000000).
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
+ # characters.
+ # @param [String] user_ip
+ # Deprecated. Please use quotaUser instead.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::ComputeBeta::Operation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def insert_allocation(project, zone, allocation_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+ command = make_simple_command(:post, '{project}/zones/{zone}/allocations', options)
+ command.request_representation = Google::Apis::ComputeBeta::Allocation::Representation
+ command.request_object = allocation_object
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
+ command.response_class = Google::Apis::ComputeBeta::Operation
+ command.params['project'] = project unless project.nil?
+ command.params['zone'] = zone unless zone.nil?
+ command.query['requestId'] = request_id unless request_id.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ command.query['userIp'] = user_ip unless user_ip.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # A list all the allocations that have been configured for the specified project
+ # in specified zone.
+ # @param [String] project
+ # Project ID for this request.
+ # @param [String] zone
+ # Name of the zone for this request.
+ # @param [String] filter
+ # A filter expression that filters resources listed in the response. The
+ # expression must specify the field name, a comparison operator, and the value
+ # that you want to use for filtering. The value must be a string, a number, or a
+ # boolean. The comparison operator must be either =, !=, >, or <.
+ # For example, if you are filtering Compute Engine instances, you can exclude
+ # instances named example-instance by specifying name != example-instance.
+ # You can also filter nested fields. For example, you could specify scheduling.
+ # automaticRestart = false to include instances only if they are not scheduled
+ # for automatic restarts. You can use filtering on nested fields to filter based
+ # on resource labels.
+ # To filter on multiple expressions, provide each separate expression within
+ # parentheses. For example, (scheduling.automaticRestart = true) (cpuPlatform = "
+ # Intel Skylake"). By default, each expression is an AND expression. However,
+ # you can include AND and OR expressions explicitly. For example, (cpuPlatform =
+ # "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.
+ # automaticRestart = true).
+ # @param [Fixnum] max_results
+ # The maximum number of results per page that should be returned. If the number
+ # of available results is larger than maxResults, Compute Engine returns a
+ # nextPageToken that can be used to get the next page of results in subsequent
+ # list requests. Acceptable values are 0 to 500, inclusive. (Default: 500)
+ # @param [String] order_by
+ # Sorts list results by a certain order. By default, results are returned in
+ # alphanumerical order based on the resource name.
+ # You can also sort results in descending order based on the creation timestamp
+ # using orderBy="creationTimestamp desc". This sorts results based on the
+ # creationTimestamp field in reverse chronological order (newest result first).
+ # Use this to sort resources like operations so that the newest operation is
+ # returned first.
+ # Currently, only sorting by name or creationTimestamp desc is supported.
+ # @param [String] page_token
+ # Specifies a page token to use. Set pageToken to the nextPageToken returned by
+ # a previous list request to get the next page of results.
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
+ # characters.
+ # @param [String] user_ip
+ # Deprecated. Please use quotaUser instead.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::ComputeBeta::AllocationList] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::ComputeBeta::AllocationList]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def list_allocations(project, zone, filter: nil, max_results: nil, order_by: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+ command = make_simple_command(:get, '{project}/zones/{zone}/allocations', options)
+ command.response_representation = Google::Apis::ComputeBeta::AllocationList::Representation
+ command.response_class = Google::Apis::ComputeBeta::AllocationList
+ command.params['project'] = project unless project.nil?
+ command.params['zone'] = zone unless zone.nil?
+ command.query['filter'] = filter unless filter.nil?
+ command.query['maxResults'] = max_results unless max_results.nil?
+ command.query['orderBy'] = order_by unless order_by.nil?
+ command.query['pageToken'] = page_token unless page_token.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ command.query['userIp'] = user_ip unless user_ip.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # Sets the access control policy on the specified resource. Replaces any
+ # existing policy.
+ # @param [String] project
+ # Project ID for this request.
+ # @param [String] zone
+ # The name of the zone for this request.
+ # @param [String] resource
+ # Name or id of the resource for this request.
+ # @param [Google::Apis::ComputeBeta::ZoneSetPolicyRequest] zone_set_policy_request_object
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
+ # characters.
+ # @param [String] user_ip
+ # Deprecated. Please use quotaUser instead.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::ComputeBeta::Policy] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::ComputeBeta::Policy]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def set_allocation_iam_policy(project, zone, resource, zone_set_policy_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+ command = make_simple_command(:post, '{project}/zones/{zone}/allocations/{resource}/setIamPolicy', options)
+ command.request_representation = Google::Apis::ComputeBeta::ZoneSetPolicyRequest::Representation
+ command.request_object = zone_set_policy_request_object
+ command.response_representation = Google::Apis::ComputeBeta::Policy::Representation
+ command.response_class = Google::Apis::ComputeBeta::Policy
+ command.params['project'] = project unless project.nil?
+ command.params['zone'] = zone unless zone.nil?
+ command.params['resource'] = resource unless resource.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ command.query['userIp'] = user_ip unless user_ip.nil?
+ execute_or_queue_command(command, &block)
+ end
+
+ # Returns permissions that a caller has on the specified resource.
+ # @param [String] project
+ # Project ID for this request.
+ # @param [String] zone
+ # The name of the zone for this request.
+ # @param [String] resource
+ # Name or id of the resource for this request.
+ # @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
+ # characters.
+ # @param [String] user_ip
+ # Deprecated. Please use quotaUser instead.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::ComputeBeta::TestPermissionsResponse] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::ComputeBeta::TestPermissionsResponse]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def test_allocation_iam_permissions(project, zone, resource, test_permissions_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+ command = make_simple_command(:post, '{project}/zones/{zone}/allocations/{resource}/testIamPermissions', options)
+ command.request_representation = Google::Apis::ComputeBeta::TestPermissionsRequest::Representation
+ command.request_object = test_permissions_request_object
+ command.response_representation = Google::Apis::ComputeBeta::TestPermissionsResponse::Representation
+ command.response_class = Google::Apis::ComputeBeta::TestPermissionsResponse
+ command.params['project'] = project unless project.nil?
+ command.params['zone'] = zone unless zone.nil?
+ command.params['resource'] = resource unless resource.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ command.query['userIp'] = user_ip unless user_ip.nil?
+ execute_or_queue_command(command, &block)
+ end
+
# Retrieves an aggregated list of autoscalers.
# @param [String] project
# Project ID for this request.
# @param [String] filter
# A filter expression that filters resources listed in the response. The
@@ -967,11 +1379,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -1699,11 +2111,11 @@
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
# Returns the specified BackendService resource. Gets a list of available
- # backend services by making a list() request.
+ # backend services.
# @param [String] project
# Project ID for this request.
# @param [String] backend_service
# Name of the BackendService resource to return.
# @param [String] fields
@@ -2007,11 +2419,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -2563,11 +2975,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
# characters.
@@ -2843,11 +3255,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::ZoneSetPolicyRequest] zone_set_policy_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -2886,11 +3298,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::ZoneSetLabelsRequest] zone_set_labels_request_object
# @param [String] request_id
# An optional request ID to identify requests. Specify a unique request ID so
# that if you must retry your request, the server will know to ignore the
# request if it has already been completed.
@@ -2940,11 +3352,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -3237,11 +3649,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -3620,11 +4032,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::RegionSetLabelsRequest] region_set_labels_request_object
# @param [String] request_id
# An optional request ID to identify requests. Specify a unique request ID so
# that if you must retry your request, the server will know to ignore the
# request if it has already been completed.
@@ -3729,11 +4141,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -3975,11 +4387,11 @@
# Sets the labels on a GlobalAddress. To learn more about labels, read the
# Labeling Resources documentation.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::GlobalSetLabelsRequest] global_set_labels_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -4014,11 +4426,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -4260,11 +4672,11 @@
# Sets the labels on the specified resource. To learn more about labels, read
# the Labeling Resources documentation.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::GlobalSetLabelsRequest] global_set_labels_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -4351,11 +4763,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -4861,11 +5273,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -5211,11 +5623,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -5561,11 +5973,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -5826,11 +6238,11 @@
# Gets the access control policy for a resource. May be empty if no such policy
# or resource exists.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
# characters.
@@ -5991,11 +6403,11 @@
# Sets the access control policy on the specified resource. Replaces any
# existing policy.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::GlobalSetPolicyRequest] global_set_policy_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -6031,11 +6443,11 @@
# Sets the labels on an image. To learn more about labels, read the Labeling
# Resources documentation.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::GlobalSetLabelsRequest] global_set_labels_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -6070,11 +6482,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -6105,18 +6517,18 @@
command.query['quotaUser'] = quota_user unless quota_user.nil?
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
- # Schedules a group action to remove the specified instances from the managed
- # instance group. Abandoning an instance does not delete the instance, but it
- # does remove the instance from any target pools that are applied by the managed
- # instance group. This method reduces the targetSize of the managed instance
- # group by the number of instances that you abandon. This operation is marked as
- # DONE when the action is scheduled even if the instances have not yet been
- # removed from the group. You must separately verify the status of the
- # abandoning action with the listmanagedinstances method.
+ # Flags the specified instances to be removed from the managed instance group.
+ # Abandoning an instance does not delete the instance, but it does remove the
+ # instance from any target pools that are applied by the managed instance group.
+ # This method reduces the targetSize of the managed instance group by the number
+ # of instances that you abandon. This operation is marked as DONE when the
+ # action is scheduled even if the instances have not yet been removed from the
+ # group. You must separately verify the status of the abandoning action with the
+ # listmanagedinstances method.
# If the group is part of a backend service that has enabled connection draining,
# it can take up to 60 seconds after the connection draining duration has
# elapsed before the VM instance is removed or deleted.
# You can specify a maximum of 1000 instances with this method per request.
# @param [String] project
@@ -6294,13 +6706,13 @@
command.query['quotaUser'] = quota_user unless quota_user.nil?
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
- # Schedules a group action to delete the specified instances in the managed
- # instance group. The instances are also removed from any target pools of which
- # they were a member. This method reduces the targetSize of the managed instance
+ # Flags the specified instances in the managed instance group for immediate
+ # deletion. The instances are also removed from any target pools of which they
+ # were a member. This method reduces the targetSize of the managed instance
# group by the number of instances that you delete. This operation is marked as
# DONE when the action is scheduled even if the instances are still being
# deleted. You must separately verify the status of the deleting action with the
# listmanagedinstances method.
# If the group is part of a backend service that has enabled connection draining,
@@ -6399,15 +6811,15 @@
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
# Creates a managed instance group using the information that you specify in the
- # request. After the group is created, it schedules an action to create
- # instances in the group using the specified instance template. This operation
- # is marked as DONE when the group is created even if the instances in the group
- # have not yet been created. You must separately verify the status of the
- # individual instances with the listmanagedinstances method.
+ # request. After the group is created, instances in the group are created using
+ # the specified instance template. This operation is marked as DONE when the
+ # group is created even if the instances in the group have not yet been created.
+ # You must separately verify the status of the individual instances with the
+ # listmanagedinstances method.
# A managed instance group can have up to 1000 VM instances per group. Please
# contact Cloud Support if you need an increase in this limit.
# @param [String] project
# Project ID for this request.
# @param [String] zone
@@ -6671,16 +7083,16 @@
command.query['quotaUser'] = quota_user unless quota_user.nil?
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
- # Schedules a group action to recreate the specified instances in the managed
- # instance group. The instances are deleted and recreated using the current
- # instance template for the managed instance group. This operation is marked as
- # DONE when the action is scheduled even if the instances have not yet been
- # recreated. You must separately verify the status of the recreating action with
- # the listmanagedinstances method.
+ # Flags the specified instances in the managed instance group to be immediately
+ # recreated. The instances are deleted and recreated using the current instance
+ # template for the managed instance group. This operation is marked as DONE when
+ # the flag is set even if the instances have not yet been recreated. You must
+ # separately verify the status of the recreating action with the
+ # listmanagedinstances method.
# If the group is part of a backend service that has enabled connection draining,
# it can take up to 60 seconds after the connection draining duration has
# elapsed before the VM instance is removed or deleted.
# You can specify a maximum of 1000 instances with this method per request.
# @param [String] project
@@ -6740,10 +7152,17 @@
# creates new instances using the current instance template. If you decrease the
# size, the group deletes instances. The resize operation is marked DONE when
# the resize actions are scheduled even if the group has not yet added or
# deleted any instances. You must separately verify the status of the creating
# or deleting actions with the listmanagedinstances method.
+ # When resizing down, the instance group arbitrarily chooses the order in which
+ # VMs are deleted. The group takes into account some VM attributes when making
+ # the selection including:
+ # + The status of the VM instance. + The health of the VM instance. + The
+ # instance template version the VM is based on. + For regional managed instance
+ # groups, the location of the VM instance.
+ # This list is subject to change.
# If the group is part of a backend service that has enabled connection draining,
# it can take up to 60 seconds after the connection draining duration has
# elapsed before the VM instance is removed or deleted.
# @param [String] project
# Project ID for this request.
@@ -6863,11 +7282,12 @@
command.query['quotaUser'] = quota_user unless quota_user.nil?
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
- # Modifies the autohealing policies.
+ # Modifies the autohealing policies. [Deprecated] This method is deprecated.
+ # Please use Patch instead.
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone where the managed instance group is located.
# @param [String] instance_group_manager
@@ -7038,11 +7458,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -7678,11 +8098,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -7806,11 +8226,11 @@
# Gets the access control policy for a resource. May be empty if no such policy
# or resource exists.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
# characters.
@@ -7966,11 +8386,11 @@
# Sets the access control policy on the specified resource. Replaces any
# existing policy.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::GlobalSetPolicyRequest] global_set_policy_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -8005,11 +8425,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -8345,13 +8765,14 @@
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] instance
- # Instance name.
+ # Instance name for this request.
# @param [String] device_name
- # Disk device name to detach.
+ # The device name of the disk to detach. Make a get() request on the instance to
+ # view currently attached disks and device names.
# @param [String] request_id
# An optional request ID to identify requests. Specify a unique request ID so
# that if you must retry your request, the server will know to ignore the
# request if it has already been completed.
# For example, consider a situation where you make an initial request and the
@@ -8485,11 +8906,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
# characters.
@@ -8741,11 +9162,11 @@
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
# Retrieves the list of referrers to instances contained within the specified
- # zone.
+ # zone. For more information, read Viewing Referrers to VM Instances.
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] instance
@@ -8871,17 +9292,71 @@
command.query['quotaUser'] = quota_user unless quota_user.nil?
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
+ # Resumes an instance that was suspended using the instances().suspend method.
+ # @param [String] project
+ # Project ID for this request.
+ # @param [String] zone
+ # The name of the zone for this request.
+ # @param [String] instance
+ # Name of the instance resource to resume.
+ # @param [Google::Apis::ComputeBeta::InstancesResumeRequest] instances_resume_request_object
+ # @param [String] request_id
+ # An optional request ID to identify requests. Specify a unique request ID so
+ # that if you must retry your request, the server will know to ignore the
+ # request if it has already been completed.
+ # For example, consider a situation where you make an initial request and the
+ # request times out. If you make the request again with the same request ID, the
+ # server can check if original operation with the same request ID was received,
+ # and if so, will ignore the second request. This prevents clients from
+ # accidentally creating duplicate commitments.
+ # The request ID must be a valid UUID with the exception that zero UUID is not
+ # supported (00000000-0000-0000-0000-000000000000).
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
+ # characters.
+ # @param [String] user_ip
+ # Deprecated. Please use quotaUser instead.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::ComputeBeta::Operation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def resume_instance(project, zone, instance, instances_resume_request_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+ command = make_simple_command(:post, '{project}/zones/{zone}/instances/{instance}/resume', options)
+ command.request_representation = Google::Apis::ComputeBeta::InstancesResumeRequest::Representation
+ command.request_object = instances_resume_request_object
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
+ command.response_class = Google::Apis::ComputeBeta::Operation
+ command.params['project'] = project unless project.nil?
+ command.params['zone'] = zone unless zone.nil?
+ command.params['instance'] = instance unless instance.nil?
+ command.query['requestId'] = request_id unless request_id.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ command.query['userIp'] = user_ip unless user_ip.nil?
+ execute_or_queue_command(command, &block)
+ end
+
# Sets deletion protection on the instance.
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Boolean] deletion_protection
# Whether the resource should be protected against deletion.
# @param [String] request_id
# An optional request ID to identify requests. Specify a unique request ID so
# that if you must retry your request, the server will know to ignore the
@@ -8931,15 +9406,16 @@
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] instance
- # The instance name.
+ # The instance name for this request.
# @param [Boolean] auto_delete
# Whether to auto-delete the disk when the instance is deleted.
# @param [String] device_name
- # The device name of the disk to modify.
+ # The device name of the disk to modify. Make a get() request on the instance to
+ # view currently attached disks and device names.
# @param [String] request_id
# An optional request ID to identify requests. Specify a unique request ID so
# that if you must retry your request, the server will know to ignore the
# request if it has already been completed.
# For example, consider a situation where you make an initial request and the
@@ -8989,11 +9465,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::ZoneSetPolicyRequest] zone_set_policy_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -9306,11 +9782,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] instance
- # Instance name.
+ # Instance name for this request.
# @param [Google::Apis::ComputeBeta::Scheduling] scheduling_object
# @param [String] request_id
# An optional request ID to identify requests. Specify a unique request ID so
# that if you must retry your request, the server will know to ignore the
# request if it has already been completed.
@@ -9465,11 +9941,12 @@
command.query['quotaUser'] = quota_user unless quota_user.nil?
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
- # Sets tags for the specified instance to the data included in the request.
+ # Sets network tags for the specified instance to the data included in the
+ # request.
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] instance
@@ -9720,17 +10197,77 @@
command.query['quotaUser'] = quota_user unless quota_user.nil?
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
+ # This method suspends a running instance, saving its state to persistent
+ # storage, and allows you to resume the instance at a later time. Suspended
+ # instances incur reduced per-minute, virtual machine usage charges while they
+ # are suspended. Any resources the virtual machine is using, such as persistent
+ # disks and static IP addresses, will continue to be charged until they are
+ # deleted.
+ # @param [String] project
+ # Project ID for this request.
+ # @param [String] zone
+ # The name of the zone for this request.
+ # @param [String] instance
+ # Name of the instance resource to suspend.
+ # @param [Boolean] discard_local_ssd
+ # If true, discard the contents of any attached localSSD partitions. Default
+ # value is false (== preserve localSSD data).
+ # @param [String] request_id
+ # An optional request ID to identify requests. Specify a unique request ID so
+ # that if you must retry your request, the server will know to ignore the
+ # request if it has already been completed.
+ # For example, consider a situation where you make an initial request and the
+ # request times out. If you make the request again with the same request ID, the
+ # server can check if original operation with the same request ID was received,
+ # and if so, will ignore the second request. This prevents clients from
+ # accidentally creating duplicate commitments.
+ # The request ID must be a valid UUID with the exception that zero UUID is not
+ # supported (00000000-0000-0000-0000-000000000000).
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
+ # characters.
+ # @param [String] user_ip
+ # Deprecated. Please use quotaUser instead.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::ComputeBeta::Operation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def suspend_instance(project, zone, instance, discard_local_ssd: nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+ command = make_simple_command(:post, '{project}/zones/{zone}/instances/{instance}/suspend', options)
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
+ command.response_class = Google::Apis::ComputeBeta::Operation
+ command.params['project'] = project unless project.nil?
+ command.params['zone'] = zone unless zone.nil?
+ command.params['instance'] = instance unless instance.nil?
+ command.query['discardLocalSsd'] = discard_local_ssd unless discard_local_ssd.nil?
+ command.query['requestId'] = request_id unless request_id.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ command.query['userIp'] = user_ip unless user_ip.nil?
+ execute_or_queue_command(command, &block)
+ end
+
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -9821,10 +10358,66 @@
command.query['quotaUser'] = quota_user unless quota_user.nil?
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
+ # Updates the Display config for a VM instance. You can only use this method on
+ # a stopped VM instance. This method supports PATCH semantics and uses the JSON
+ # merge patch format and processing rules.
+ # @param [String] project
+ # Project ID for this request.
+ # @param [String] zone
+ # The name of the zone for this request.
+ # @param [String] instance
+ # Name of the instance scoping this request.
+ # @param [Google::Apis::ComputeBeta::DisplayDevice] display_device_object
+ # @param [String] request_id
+ # An optional request ID to identify requests. Specify a unique request ID so
+ # that if you must retry your request, the server will know to ignore the
+ # request if it has already been completed.
+ # For example, consider a situation where you make an initial request and the
+ # request times out. If you make the request again with the same request ID, the
+ # server can check if original operation with the same request ID was received,
+ # and if so, will ignore the second request. This prevents clients from
+ # accidentally creating duplicate commitments.
+ # The request ID must be a valid UUID with the exception that zero UUID is not
+ # supported (00000000-0000-0000-0000-000000000000).
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
+ # characters.
+ # @param [String] user_ip
+ # Deprecated. Please use quotaUser instead.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::ComputeBeta::Operation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def update_instance_display_device(project, zone, instance, display_device_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+ command = make_simple_command(:patch, '{project}/zones/{zone}/instances/{instance}/updateDisplayDevice', options)
+ command.request_representation = Google::Apis::ComputeBeta::DisplayDevice::Representation
+ command.request_object = display_device_object
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
+ command.response_class = Google::Apis::ComputeBeta::Operation
+ command.params['project'] = project unless project.nil?
+ command.params['zone'] = zone unless zone.nil?
+ command.params['instance'] = instance unless instance.nil?
+ command.query['requestId'] = request_id unless request_id.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ command.query['userIp'] = user_ip unless user_ip.nil?
+ execute_or_queue_command(command, &block)
+ end
+
# Updates an instance's network interface. This method follows PATCH semantics.
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
@@ -10285,11 +10878,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::RegionSetLabelsRequest] region_set_labels_request_object
# @param [String] request_id
# An optional request ID to identify requests. Specify a unique request ID so
# that if you must retry your request, the server will know to ignore the
# request if it has already been completed.
@@ -10339,11 +10932,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -10783,11 +11376,11 @@
# Sets the labels on an Interconnect. To learn more about labels, read the
# Labeling Resources documentation.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::GlobalSetLabelsRequest] global_set_labels_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -10822,11 +11415,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -11101,10 +11694,50 @@
command.query['quotaUser'] = quota_user unless quota_user.nil?
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
+ # Sets the access control policy on the specified resource. Replaces any
+ # existing policy.
+ # @param [String] project
+ # Project ID for this request.
+ # @param [String] resource
+ # Name or id of the resource for this request.
+ # @param [Google::Apis::ComputeBeta::GlobalSetPolicyRequest] global_set_policy_request_object
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
+ # characters.
+ # @param [String] user_ip
+ # Deprecated. Please use quotaUser instead.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::ComputeBeta::Policy] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::ComputeBeta::Policy]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def set_license_iam_policy(project, resource, global_set_policy_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+ command = make_simple_command(:post, '{project}/global/licenses/{resource}/setIamPolicy', options)
+ command.request_representation = Google::Apis::ComputeBeta::GlobalSetPolicyRequest::Representation
+ command.request_object = global_set_policy_request_object
+ command.response_representation = Google::Apis::ComputeBeta::Policy::Representation
+ command.response_class = Google::Apis::ComputeBeta::Policy
+ command.params['project'] = project unless project.nil?
+ command.params['resource'] = resource unless resource.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ command.query['userIp'] = user_ip unless user_ip.nil?
+ execute_or_queue_command(command, &block)
+ end
+
# Retrieves an aggregated list of machine types.
# @param [String] project
# Project ID for this request.
# @param [String] filter
# A filter expression that filters resources listed in the response. The
@@ -11783,11 +12416,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -12075,10 +12708,94 @@
command.query['quotaUser'] = quota_user unless quota_user.nil?
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
+ # Lists the peering routes exchanged over peering connection.
+ # @param [String] project
+ # Project ID for this request.
+ # @param [String] network
+ # Name of the network for this request.
+ # @param [String] direction
+ # The direction of the exchanged routes.
+ # @param [String] filter
+ # A filter expression that filters resources listed in the response. The
+ # expression must specify the field name, a comparison operator, and the value
+ # that you want to use for filtering. The value must be a string, a number, or a
+ # boolean. The comparison operator must be either =, !=, >, or <.
+ # For example, if you are filtering Compute Engine instances, you can exclude
+ # instances named example-instance by specifying name != example-instance.
+ # You can also filter nested fields. For example, you could specify scheduling.
+ # automaticRestart = false to include instances only if they are not scheduled
+ # for automatic restarts. You can use filtering on nested fields to filter based
+ # on resource labels.
+ # To filter on multiple expressions, provide each separate expression within
+ # parentheses. For example, (scheduling.automaticRestart = true) (cpuPlatform = "
+ # Intel Skylake"). By default, each expression is an AND expression. However,
+ # you can include AND and OR expressions explicitly. For example, (cpuPlatform =
+ # "Intel Skylake") OR (cpuPlatform = "Intel Broadwell") AND (scheduling.
+ # automaticRestart = true).
+ # @param [Fixnum] max_results
+ # The maximum number of results per page that should be returned. If the number
+ # of available results is larger than maxResults, Compute Engine returns a
+ # nextPageToken that can be used to get the next page of results in subsequent
+ # list requests. Acceptable values are 0 to 500, inclusive. (Default: 500)
+ # @param [String] order_by
+ # Sorts list results by a certain order. By default, results are returned in
+ # alphanumerical order based on the resource name.
+ # You can also sort results in descending order based on the creation timestamp
+ # using orderBy="creationTimestamp desc". This sorts results based on the
+ # creationTimestamp field in reverse chronological order (newest result first).
+ # Use this to sort resources like operations so that the newest operation is
+ # returned first.
+ # Currently, only sorting by name or creationTimestamp desc is supported.
+ # @param [String] page_token
+ # Specifies a page token to use. Set pageToken to the nextPageToken returned by
+ # a previous list request to get the next page of results.
+ # @param [String] peering_name
+ # The response will show routes exchanged over the given peering connection.
+ # @param [String] region
+ # The region of the request. The response will include all subnet routes, static
+ # routes and dynamic routes in the region.
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
+ # characters.
+ # @param [String] user_ip
+ # Deprecated. Please use quotaUser instead.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::ComputeBeta::ExchangedPeeringRoutesList] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::ComputeBeta::ExchangedPeeringRoutesList]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def list_network_peering_routes(project, network, direction: nil, filter: nil, max_results: nil, order_by: nil, page_token: nil, peering_name: nil, region: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+ command = make_simple_command(:get, '{project}/global/networks/{network}/listPeeringRoutes', options)
+ command.response_representation = Google::Apis::ComputeBeta::ExchangedPeeringRoutesList::Representation
+ command.response_class = Google::Apis::ComputeBeta::ExchangedPeeringRoutesList
+ command.params['project'] = project unless project.nil?
+ command.params['network'] = network unless network.nil?
+ command.query['direction'] = direction unless direction.nil?
+ command.query['filter'] = filter unless filter.nil?
+ command.query['maxResults'] = max_results unless max_results.nil?
+ command.query['orderBy'] = order_by unless order_by.nil?
+ command.query['pageToken'] = page_token unless page_token.nil?
+ command.query['peeringName'] = peering_name unless peering_name.nil?
+ command.query['region'] = region unless region.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ command.query['userIp'] = user_ip unless user_ip.nil?
+ execute_or_queue_command(command, &block)
+ end
+
# Patches the specified network with the data included in the request. Only the
# following fields can be modified: routingConfig.routingMode.
# @param [String] project
# Project ID for this request.
# @param [String] network
@@ -12230,11 +12947,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -12265,17 +12982,70 @@
command.query['quotaUser'] = quota_user unless quota_user.nil?
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
+ # Updates the specified network peering with the data included in the request
+ # Only the following fields can be modified: NetworkPeering.export_custom_routes,
+ # and NetworkPeering.import_custom_routes
+ # @param [String] project
+ # Project ID for this request.
+ # @param [String] network
+ # Name of the network resource which the updated peering is belonging to.
+ # @param [Google::Apis::ComputeBeta::NetworksUpdatePeeringRequest] networks_update_peering_request_object
+ # @param [String] request_id
+ # An optional request ID to identify requests. Specify a unique request ID so
+ # that if you must retry your request, the server will know to ignore the
+ # request if it has already been completed.
+ # For example, consider a situation where you make an initial request and the
+ # request times out. If you make the request again with the same request ID, the
+ # server can check if original operation with the same request ID was received,
+ # and if so, will ignore the second request. This prevents clients from
+ # accidentally creating duplicate commitments.
+ # The request ID must be a valid UUID with the exception that zero UUID is not
+ # supported (00000000-0000-0000-0000-000000000000).
+ # @param [String] fields
+ # Selector specifying which fields to include in a partial response.
+ # @param [String] quota_user
+ # An opaque string that represents a user for quota purposes. Must not exceed 40
+ # characters.
+ # @param [String] user_ip
+ # Deprecated. Please use quotaUser instead.
+ # @param [Google::Apis::RequestOptions] options
+ # Request-specific options
+ #
+ # @yield [result, err] Result & error if block supplied
+ # @yieldparam result [Google::Apis::ComputeBeta::Operation] parsed result object
+ # @yieldparam err [StandardError] error object if request failed
+ #
+ # @return [Google::Apis::ComputeBeta::Operation]
+ #
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
+ def update_network_peering(project, network, networks_update_peering_request_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+ command = make_simple_command(:patch, '{project}/global/networks/{network}/updatePeering', options)
+ command.request_representation = Google::Apis::ComputeBeta::NetworksUpdatePeeringRequest::Representation
+ command.request_object = networks_update_peering_request_object
+ command.response_representation = Google::Apis::ComputeBeta::Operation::Representation
+ command.response_class = Google::Apis::ComputeBeta::Operation
+ command.params['project'] = project unless project.nil?
+ command.params['network'] = network unless network.nil?
+ command.query['requestId'] = request_id unless request_id.nil?
+ command.query['fields'] = fields unless fields.nil?
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
+ command.query['userIp'] = user_ip unless user_ip.nil?
+ execute_or_queue_command(command, &block)
+ end
+
# Adds specified number of nodes to the node group.
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] node_group
- # Name of the NodeGroup resource to delete.
+ # Name of the NodeGroup resource.
# @param [Google::Apis::ComputeBeta::NodeGroupsAddNodesRequest] node_groups_add_nodes_request_object
# @param [String] request_id
# An optional request ID to identify requests. Specify a unique request ID so
# that if you must retry your request, the server will know to ignore the
# request if it has already been completed.
@@ -12544,11 +13314,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
# characters.
@@ -12791,11 +13561,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::ZoneSetPolicyRequest] zone_set_policy_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -12887,11 +13657,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -13092,11 +13862,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
# characters.
@@ -13258,11 +14028,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::RegionSetPolicyRequest] region_set_policy_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -13300,11 +14070,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -14445,11 +15215,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -14860,11 +15630,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -15749,11 +16519,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::RegionSetLabelsRequest] region_set_labels_request_object
# @param [String] request_id
# An optional request ID to identify requests. Specify a unique request ID so
# that if you must retry your request, the server will know to ignore the
# request if it has already been completed.
@@ -15803,11 +16573,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -15839,11 +16609,11 @@
command.query['quotaUser'] = quota_user unless quota_user.nil?
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
- # Schedules a group action to remove the specified instances from the managed
+ # Flags the specified instances to be immediately removed from the managed
# instance group. Abandoning an instance does not delete the instance, but it
# does remove the instance from any target pools that are applied by the managed
# instance group. This method reduces the targetSize of the managed instance
# group by the number of instances that you abandon. This operation is marked as
# DONE when the action is scheduled even if the instances have not yet been
@@ -15956,17 +16726,17 @@
command.query['quotaUser'] = quota_user unless quota_user.nil?
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
- # Schedules a group action to delete the specified instances in the managed
- # instance group. The instances are also removed from any target pools of which
- # they were a member. This method reduces the targetSize of the managed instance
- # group by the number of instances that you delete. This operation is marked as
- # DONE when the action is scheduled even if the instances are still being
- # deleted. You must separately verify the status of the deleting action with the
- # listmanagedinstances method.
+ # Flags the specified instances in the managed instance group to be immediately
+ # deleted. The instances are also removed from any target pools of which they
+ # were a member. This method reduces the targetSize of the managed instance
+ # group by the number of instances that you delete. The deleteInstances
+ # operation is marked DONE if the deleteInstances request is successful. The
+ # underlying actions take additional time. You must separately verify the status
+ # of the deleting action with the listmanagedinstances method.
# If the group is part of a backend service that has enabled connection draining,
# it can take up to 60 seconds after the connection draining duration has
# elapsed before the VM instance is removed or deleted.
# You can specify a maximum of 1000 instances with this method per request.
# @param [String] project
@@ -16060,15 +16830,15 @@
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
# Creates a managed instance group using the information that you specify in the
- # request. After the group is created, it schedules an action to create
- # instances in the group using the specified instance template. This operation
- # is marked as DONE when the group is created even if the instances in the group
- # have not yet been created. You must separately verify the status of the
- # individual instances with the listmanagedinstances method.
+ # request. After the group is created, instances in the group are created using
+ # the specified instance template. This operation is marked as DONE when the
+ # group is created even if the instances in the group have not yet been created.
+ # You must separately verify the status of the individual instances with the
+ # listmanagedinstances method.
# A regional managed instance group can contain up to 2000 instances.
# @param [String] project
# Project ID for this request.
# @param [String] region
# Name of the region scoping this request.
@@ -16329,16 +17099,16 @@
command.query['quotaUser'] = quota_user unless quota_user.nil?
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
- # Schedules a group action to recreate the specified instances in the managed
- # instance group. The instances are deleted and recreated using the current
- # instance template for the managed instance group. This operation is marked as
- # DONE when the action is scheduled even if the instances have not yet been
- # recreated. You must separately verify the status of the recreating action with
- # the listmanagedinstances method.
+ # Flags the specified instances in the managed instance group to be immediately
+ # recreated. The instances are deleted and recreated using the current instance
+ # template for the managed instance group. This operation is marked as DONE when
+ # the flag is set even if the instances have not yet been recreated. You must
+ # separately verify the status of the recreating action with the
+ # listmanagedinstances method.
# If the group is part of a backend service that has enabled connection draining,
# it can take up to 60 seconds after the connection draining duration has
# elapsed before the VM instance is removed or deleted.
# You can specify a maximum of 1000 instances with this method per request.
# @param [String] project
@@ -16392,17 +17162,16 @@
command.query['quotaUser'] = quota_user unless quota_user.nil?
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
- # Changes the intended size for the managed instance group. If you increase the
- # size, the group schedules actions to create new instances using the current
- # instance template. If you decrease the size, the group schedules delete
- # actions on one or more instances. The resize operation is marked DONE when the
- # resize actions are scheduled even if the group has not yet added or deleted
- # any instances. You must separately verify the status of the creating or
- # deleting actions with the listmanagedinstances method.
+ # Changes the intended size of the managed instance group. If you increase the
+ # size, the group creates new instances using the current instance template. If
+ # you decrease the size, the group deletes one or more instances.
+ # The resize operation is marked DONE if the resize request is successful. The
+ # underlying actions take additional time. You must separately verify the status
+ # of the creating or deleting actions with the listmanagedinstances method.
# If the group is part of a backend service that has enabled connection draining,
# it can take up to 60 seconds after the connection draining duration has
# elapsed before the VM instance is removed or deleted.
# @param [String] project
# Project ID for this request.
@@ -16456,11 +17225,11 @@
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
# Modifies the autohealing policy for the instances in this managed instance
- # group.
+ # group. [Deprecated] This method is deprecated. Please use Patch instead.
# @param [String] project
# Project ID for this request.
# @param [String] region
# Name of the region scoping this request.
# @param [String] instance_group_manager
@@ -16626,11 +17395,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -16976,11 +17745,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -17563,11 +18332,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -18109,11 +18878,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -18408,11 +19177,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -18943,11 +19712,11 @@
# Sets the labels on a security policy. To learn more about labels, read the
# Labeling Resources documentation.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::GlobalSetLabelsRequest] global_set_labels_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -18982,11 +19751,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -19021,11 +19790,11 @@
# Deletes the specified Snapshot resource. Keep in mind that deleting a single
# snapshot might not necessarily delete all the data on that snapshot. If any
# data on the snapshot that is marked for deletion is needed for subsequent
# snapshots, the data will be moved to the next corresponding snapshot.
- # For more information, see Deleting snaphots.
+ # For more information, see Deleting snapshots.
# @param [String] project
# Project ID for this request.
# @param [String] snapshot
# Name of the Snapshot resource to delete.
# @param [String] request_id
@@ -19111,11 +19880,11 @@
# Gets the access control policy for a resource. May be empty if no such policy
# or resource exists.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
# characters.
@@ -19220,11 +19989,11 @@
# Sets the access control policy on the specified resource. Replaces any
# existing policy.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::GlobalSetPolicyRequest] global_set_policy_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -19260,11 +20029,11 @@
# Sets the labels on a snapshot. To learn more about labels, read the Labeling
# Resources documentation.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::GlobalSetLabelsRequest] global_set_labels_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -19299,11 +20068,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -19544,11 +20313,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -19914,11 +20683,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -20172,11 +20941,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
# characters.
@@ -20403,14 +21172,13 @@
command.query['userIp'] = user_ip unless user_ip.nil?
execute_or_queue_command(command, &block)
end
# Patches the specified subnetwork with the data included in the request. Only
- # the following fields within the subnetwork resource can be specified in the
- # request: secondary_ip_range, allow_subnet_cidr_routes_overlap and role. It is
- # also mandatory to specify the current fingeprint of the subnetwork resource
- # being patched.
+ # certain fields can up updated with a patch request as indicated in the field
+ # descriptions. You must specify the current fingeprint of the subnetwork
+ # resource being patched.
# @param [String] project
# Project ID for this request.
# @param [String] region
# Name of the region scoping this request.
# @param [String] subnetwork
@@ -20467,11 +21235,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::RegionSetPolicyRequest] region_set_policy_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -20564,11 +21332,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -20861,11 +21629,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -21315,11 +22083,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -21645,11 +22413,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] zone
# The name of the zone for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -22291,11 +23059,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -22745,11 +23513,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -23384,11 +24152,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::RegionSetLabelsRequest] region_set_labels_request_object
# @param [String] request_id
# An optional request ID to identify requests. Specify a unique request ID so
# that if you must retry your request, the server will know to ignore the
# request if it has already been completed.
@@ -23438,11 +24206,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -23788,11 +24556,11 @@
# Returns permissions that a caller has on the specified resource.
# @param [String] project
# Project ID for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40
@@ -24210,11 +24978,11 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::RegionSetLabelsRequest] region_set_labels_request_object
# @param [String] request_id
# An optional request ID to identify requests. Specify a unique request ID so
# that if you must retry your request, the server will know to ignore the
# request if it has already been completed.
@@ -24264,10 +25032,10 @@
# @param [String] project
# Project ID for this request.
# @param [String] region
# The name of the region for this request.
# @param [String] resource
- # Name of the resource for this request.
+ # Name or id of the resource for this request.
# @param [Google::Apis::ComputeBeta::TestPermissionsRequest] test_permissions_request_object
# @param [String] fields
# Selector specifying which fields to include in a partial response.
# @param [String] quota_user
# An opaque string that represents a user for quota purposes. Must not exceed 40