generated/google/apis/compute_beta/service.rb in google-api-client-0.11.1 vs generated/google/apis/compute_beta/service.rb in google-api-client-0.11.2

- old
+ new

@@ -863,13 +863,13 @@ # request. This method supports patch semantics. # @param [String] project # Project ID for this request. # @param [String] zone # Name of the zone for this request. - # @param [String] autoscaler - # Name of the autoscaler to update. # @param [Google::Apis::ComputeBeta::Autoscaler] autoscaler_object + # @param [String] autoscaler + # Name of the autoscaler to patch. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user # Available to use for quota purposes for server-side applications. Can be any # arbitrary string assigned to a user, but should not exceed 40 characters. @@ -887,11 +887,11 @@ # @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 patch_autoscaler(project, zone, autoscaler, autoscaler_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) + def patch_autoscaler(project, zone, autoscaler_object = nil, autoscaler: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) command = make_simple_command(:patch, '{project}/zones/{zone}/autoscalers', options) command.request_representation = Google::Apis::ComputeBeta::Autoscaler::Representation command.request_object = autoscaler_object command.response_representation = Google::Apis::ComputeBeta::Operation::Representation command.response_class = Google::Apis::ComputeBeta::Operation @@ -1712,87 +1712,10 @@ 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 commitments. - # @param [String] project - # Project ID for this request. - # @param [String] filter - # Sets a filter expression for filtering listed resources, in the form filter=` - # expression`. Your `expression` must be in the format: field_name - # comparison_string literal_string. - # The field_name is the name of the field you want to compare. Only atomic field - # types are supported (string, number, boolean). The comparison_string must be - # either eq (equals) or ne (not equals). The literal_string is the string value - # to filter to. The literal value must be valid for the type of field you are - # filtering by (string, number, boolean). For string fields, the literal value - # is interpreted as a regular expression using RE2 syntax. The literal value - # must match the entire field. - # For example, to filter for instances that do not have a name of example- - # instance, you would use filter=name ne example-instance. - # You can filter on nested fields. For example, you could filter on instances - # that have set the scheduling.automaticRestart field to true. Use filtering on - # nested fields to take advantage of labels to organize and search for results - # based on label values. - # To filter on multiple expressions, provide each separate expression within - # parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us- - # central1-f). Multiple expressions are treated as AND expressions, meaning that - # resources must match all expressions to pass the filters. - # @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 - # Available to use for quota purposes for server-side applications. Can be any - # arbitrary string assigned to a user, but should not exceed 40 characters. - # Overrides userIp if both are provided. - # @param [String] user_ip - # IP address of the site where the request originates. Use this if you want to - # enforce per-user limits. - # @param [Google::Apis::RequestOptions] options - # Request-specific options - # - # @yield [result, err] Result & error if block supplied - # @yieldparam result [Google::Apis::ComputeBeta::CommitmentAggregatedList] parsed result object - # @yieldparam err [StandardError] error object if request failed - # - # @return [Google::Apis::ComputeBeta::CommitmentAggregatedList] - # - # @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_commitment_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/commitments', options) - command.response_representation = Google::Apis::ComputeBeta::CommitmentAggregatedList::Representation - command.response_class = Google::Apis::ComputeBeta::CommitmentAggregatedList - 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 - # Retrieves an aggregated list of disk types. # @param [String] project # Project ID for this request. # @param [String] filter # Sets a filter expression for filtering listed resources, in the form filter=` @@ -2732,10 +2655,12 @@ command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Updates the specified firewall rule with the data included in the request. + # Using PUT method, can only update following fields of firewall rule: allowed, + # description, sourceRanges, sourceTags, targetTags. # @param [String] project # Project ID for this request. # @param [String] firewall # Name of the firewall rule to update. # @param [Google::Apis::ComputeBeta::Firewall] firewall_object @@ -3377,11 +3302,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 - # Deletes the specified ForwardingRule resource. + # Deletes the specified GlobalForwardingRule resource. # @param [String] project # Project ID for this request. # @param [String] forwarding_rule # Name of the ForwardingRule resource to delete. # @param [String] fields @@ -3415,11 +3340,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 - # Returns the specified ForwardingRule resource. Get a list of available + # Returns the specified GlobalForwardingRule resource. Get a list of available # forwarding rules by making a list() request. # @param [String] project # Project ID for this request. # @param [String] forwarding_rule # Name of the ForwardingRule resource to return. @@ -3454,12 +3379,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 - # Creates a ForwardingRule resource in the specified project and region using - # the data included in the request. + # Creates a GlobalForwardingRule resource in the specified project using the + # data included in the request. # @param [String] project # Project ID for this request. # @param [Google::Apis::ComputeBeta::ForwardingRule] forwarding_rule_object # @param [String] fields # Selector specifying which fields to include in a partial response. @@ -3493,11 +3418,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 - # Retrieves a list of ForwardingRule resources available to the specified + # Retrieves a list of GlobalForwardingRule resources available to the specified # project. # @param [String] project # Project ID for this request. # @param [String] filter # Sets a filter expression for filtering listed resources, in the form filter=` @@ -3571,12 +3496,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 - # Changes target URL for forwarding rule. The new target should be of the same - # type as the old target. + # Changes target URL for the GlobalForwardingRule resource. The new target + # should be of the same type as the old target. # @param [String] project # Project ID for this request. # @param [String] forwarding_rule # Name of the ForwardingRule resource in which target is to be set. # @param [Google::Apis::ComputeBeta::TargetReference] target_reference_object @@ -5208,10 +5133,11 @@ # 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. + # You can specify a maximum of 1000 instances with this method per request. # @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 @@ -5378,10 +5304,11 @@ # 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. + # You can specify a maximum of 1000 instances with this method per request. # @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 @@ -5469,10 +5396,11 @@ # 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. + # A managed instance group can have up to 1000 VM instances per group. # @param [String] project # Project ID for this request. # @param [String] zone # The name of the zone where you want to create the managed instance group. # @param [Google::Apis::ComputeBeta::InstanceGroupManager] instance_group_manager_object @@ -5644,14 +5572,14 @@ command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Updates a managed instance group using the information that you specify in the - # request. This operation is marked as DONE when the group is updated even if - # the instances in the group have not yet been updated. You must separately - # verify the status of the individual instances with the listmanagedinstances - # method. This method supports patch semantics. + # request. This operation is marked as DONE when the group is patched even if + # the instances in the group are still in the process of being patched. You must + # separately verify the status of the individual instances with the + # listManagedInstances method. This method supports patch semantics. # @param [String] project # Project ID for this request. # @param [String] zone # The name of the zone where you want to create the managed instance group. # @param [String] instance_group_manager @@ -5697,10 +5625,11 @@ # 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. + # You can specify a maximum of 1000 instances with this method per request. # @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 @@ -6029,11 +5958,11 @@ end # Updates a managed instance group using the information that you specify in the # request. This operation is marked as DONE when the group is updated even if # the instances in the group have not yet been updated. You must separately - # verify the status of the individual instances with the listmanagedinstances + # verify the status of the individual instances with the listManagedInstances # method. # @param [String] project # Project ID for this request. # @param [String] zone # The name of the zone where you want to create the managed instance group. @@ -7380,16 +7309,102 @@ 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 - # Performs a hard reset on the instance. + # Retrieves the list of referrers to instances contained within the specified + # zone. # @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 target instance scoping this request, or '-' if the request should + # span over all instances in the container. + # @param [String] filter + # Sets a filter expression for filtering listed resources, in the form filter=` + # expression`. Your `expression` must be in the format: field_name + # comparison_string literal_string. + # The field_name is the name of the field you want to compare. Only atomic field + # types are supported (string, number, boolean). The comparison_string must be + # either eq (equals) or ne (not equals). The literal_string is the string value + # to filter to. The literal value must be valid for the type of field you are + # filtering by (string, number, boolean). For string fields, the literal value + # is interpreted as a regular expression using RE2 syntax. The literal value + # must match the entire field. + # For example, to filter for instances that do not have a name of example- + # instance, you would use filter=name ne example-instance. + # You can filter on nested fields. For example, you could filter on instances + # that have set the scheduling.automaticRestart field to true. Use filtering on + # nested fields to take advantage of labels to organize and search for results + # based on label values. + # To filter on multiple expressions, provide each separate expression within + # parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us- + # central1-f). Multiple expressions are treated as AND expressions, meaning that + # resources must match all expressions to pass the filters. + # @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 + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. + # Overrides userIp if both are provided. + # @param [String] user_ip + # IP address of the site where the request originates. Use this if you want to + # enforce per-user limits. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::ComputeBeta::InstanceListReferrers] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::ComputeBeta::InstanceListReferrers] + # + # @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_instance_referrers(project, zone, instance, 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}/instances/{instance}/referrers', options) + command.response_representation = Google::Apis::ComputeBeta::InstanceListReferrers::Representation + command.response_class = Google::Apis::ComputeBeta::InstanceListReferrers + command.params['project'] = project unless project.nil? + command.params['zone'] = zone unless zone.nil? + command.params['instance'] = instance unless instance.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 + + # Performs a reset on the instance. For more information, see Resetting an + # instance. + # @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 [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user # Available to use for quota purposes for server-side applications. Can be any @@ -9222,13 +9237,13 @@ # request. This method supports patch semantics. # @param [String] project # Project ID for this request. # @param [String] region # Name of the region scoping this request. - # @param [String] autoscaler - # Name of the autoscaler to update. # @param [Google::Apis::ComputeBeta::Autoscaler] autoscaler_object + # @param [String] autoscaler + # Name of the autoscaler to patch. # @param [String] fields # Selector specifying which fields to include in a partial response. # @param [String] quota_user # Available to use for quota purposes for server-side applications. Can be any # arbitrary string assigned to a user, but should not exceed 40 characters. @@ -9246,11 +9261,11 @@ # @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 patch_region_autoscaler(project, region, autoscaler, autoscaler_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) + def patch_region_autoscaler(project, region, autoscaler_object = nil, autoscaler: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block) command = make_simple_command(:patch, '{project}/regions/{region}/autoscalers', options) command.request_representation = Google::Apis::ComputeBeta::Autoscaler::Representation command.request_object = autoscaler_object command.response_representation = Google::Apis::ComputeBeta::Operation::Representation command.response_class = Google::Apis::ComputeBeta::Operation @@ -9738,10 +9753,87 @@ 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 commitments. + # @param [String] project + # Project ID for this request. + # @param [String] filter + # Sets a filter expression for filtering listed resources, in the form filter=` + # expression`. Your `expression` must be in the format: field_name + # comparison_string literal_string. + # The field_name is the name of the field you want to compare. Only atomic field + # types are supported (string, number, boolean). The comparison_string must be + # either eq (equals) or ne (not equals). The literal_string is the string value + # to filter to. The literal value must be valid for the type of field you are + # filtering by (string, number, boolean). For string fields, the literal value + # is interpreted as a regular expression using RE2 syntax. The literal value + # must match the entire field. + # For example, to filter for instances that do not have a name of example- + # instance, you would use filter=name ne example-instance. + # You can filter on nested fields. For example, you could filter on instances + # that have set the scheduling.automaticRestart field to true. Use filtering on + # nested fields to take advantage of labels to organize and search for results + # based on label values. + # To filter on multiple expressions, provide each separate expression within + # parentheses. For example, (scheduling.automaticRestart eq true) (zone eq us- + # central1-f). Multiple expressions are treated as AND expressions, meaning that + # resources must match all expressions to pass the filters. + # @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 + # Available to use for quota purposes for server-side applications. Can be any + # arbitrary string assigned to a user, but should not exceed 40 characters. + # Overrides userIp if both are provided. + # @param [String] user_ip + # IP address of the site where the request originates. Use this if you want to + # enforce per-user limits. + # @param [Google::Apis::RequestOptions] options + # Request-specific options + # + # @yield [result, err] Result & error if block supplied + # @yieldparam result [Google::Apis::ComputeBeta::CommitmentAggregatedList] parsed result object + # @yieldparam err [StandardError] error object if request failed + # + # @return [Google::Apis::ComputeBeta::CommitmentAggregatedList] + # + # @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_region_commitment_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/commitments', options) + command.response_representation = Google::Apis::ComputeBeta::CommitmentAggregatedList::Representation + command.response_class = Google::Apis::ComputeBeta::CommitmentAggregatedList + 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 + # Returns the specified commitment resource. Get a list of available commitments # by making a list() request. # @param [String] project # Project ID for this request. # @param [String] region @@ -9910,10 +10002,11 @@ # 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. + # You can specify a maximum of 1000 instances with this method per request. # @param [String] project # Project ID for this request. # @param [String] region # Name of the region scoping this request. # @param [String] instance_group_manager @@ -10002,10 +10095,11 @@ # 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. + # You can specify a maximum of 1000 instances with this method per request. # @param [String] project # Project ID for this request. # @param [String] region # Name of the region scoping this request. # @param [String] instance_group_manager @@ -10092,10 +10186,11 @@ # 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. + # 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. # @param [Google::Apis::ComputeBeta::InstanceGroupManager] instance_group_manager_object @@ -10265,14 +10360,14 @@ command.query['userIp'] = user_ip unless user_ip.nil? execute_or_queue_command(command, &block) end # Updates a managed instance group using the information that you specify in the - # request. This operation is marked as DONE when the group is updated even if - # the instances in the group have not yet been updated. You must separately - # verify the status of the individual instances with the listmanagedinstances - # method. This method supports patch semantics. + # request. This operation is marked as DONE when the group is patched even if + # the instances in the group are still in the process of being patched. You must + # separately verify the status of the individual instances with the + # listmanagedinstances method. This method supports patch semantics. # @param [String] project # Project ID for this request. # @param [String] region # Name of the region scoping this request. # @param [String] instance_group_manager @@ -10318,9 +10413,10 @@ # 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. + # You can specify a maximum of 1000 instances with this method per request. # @param [String] project # Project ID for this request. # @param [String] region # Name of the region scoping this request. # @param [String] instance_group_manager