google-api-ruby-client/generated/google/apis/clouddebugger_v2/service.rb

397 lines
24 KiB
Ruby
Raw Normal View History

2015-12-03 01:10:07 +00:00
# Copyright 2015 Google Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
require 'google/apis/core/base_service'
require 'google/apis/core/json_representation'
require 'google/apis/core/hashable'
require 'google/apis/errors'
module Google
module Apis
module ClouddebuggerV2
2016-08-15 17:54:44 +00:00
# Stackdriver Debugger API
2015-12-03 01:10:07 +00:00
#
2016-03-11 22:41:20 +00:00
# Examines the call stack and variables of a running application without
2015-12-03 01:10:07 +00:00
# stopping or slowing it down.
#
# @example
# require 'google/apis/clouddebugger_v2'
#
# Clouddebugger = Google::Apis::ClouddebuggerV2 # Alias the module
2016-06-09 20:22:21 +00:00
# service = Clouddebugger::CloudDebuggerService.new
2015-12-03 01:10:07 +00:00
#
2016-08-15 17:54:44 +00:00
# @see http://cloud.google.com/debugger
2016-06-09 20:22:21 +00:00
class CloudDebuggerService < Google::Apis::Core::BaseService
2015-12-03 01:10:07 +00:00
# @return [String]
# API key. Your API key identifies your project and provides you with API access,
# quota, and reports. Required unless you provide an OAuth 2.0 token.
attr_accessor :key
# @return [String]
# 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.
attr_accessor :quota_user
def initialize
super('https://clouddebugger.googleapis.com/', '')
end
# Lists all the debuggees that the user can set breakpoints to.
# @param [Boolean] include_inactive
# When set to `true`, the result includes all debuggees. Otherwise, the
# result includes only debuggees that are active.
# @param [String] project
# Project number of a Google Cloud project whose debuggees to list.
2017-02-13 23:28:52 +00:00
# @param [String] client_version
# The client version making the call.
# Following: `domain/type/version` (e.g., `google.com/intellij/v1`).
# @param [String] fields
# Selector specifying which fields to include in a partial response.
2015-12-03 01:10:07 +00:00
# @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.
# @param [Google::Apis::RequestOptions] options
# Request-specific options
#
# @yield [result, err] Result & error if block supplied
# @yieldparam result [Google::Apis::ClouddebuggerV2::ListDebuggeesResponse] parsed result object
2015-12-03 01:10:07 +00:00
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::ClouddebuggerV2::ListDebuggeesResponse]
2015-12-03 01:10:07 +00:00
#
# @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
2017-02-13 23:28:52 +00:00
def list_debugger_debuggees(include_inactive: nil, project: nil, client_version: nil, fields: nil, quota_user: nil, options: nil, &block)
command = make_simple_command(:get, 'v2/debugger/debuggees', options)
command.response_representation = Google::Apis::ClouddebuggerV2::ListDebuggeesResponse::Representation
command.response_class = Google::Apis::ClouddebuggerV2::ListDebuggeesResponse
command.query['includeInactive'] = include_inactive unless include_inactive.nil?
command.query['project'] = project unless project.nil?
2017-02-13 23:28:52 +00:00
command.query['clientVersion'] = client_version unless client_version.nil?
2017-01-13 23:04:35 +00:00
command.query['fields'] = fields unless fields.nil?
2017-02-13 23:28:52 +00:00
command.query['quotaUser'] = quota_user unless quota_user.nil?
2015-12-03 01:10:07 +00:00
execute_or_queue_command(command, &block)
end
# Sets the breakpoint to the debuggee.
2015-12-03 01:10:07 +00:00
# @param [String] debuggee_id
# ID of the debuggee where the breakpoint is to be set.
# @param [Google::Apis::ClouddebuggerV2::Breakpoint] breakpoint_object
# @param [String] client_version
# The client version making the call.
# Following: `domain/type/version` (e.g., `google.com/intellij/v1`).
2017-02-13 23:28:52 +00:00
# @param [String] fields
# Selector specifying which fields to include in a partial response.
2015-12-03 01:10:07 +00:00
# @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.
# @param [Google::Apis::RequestOptions] options
# Request-specific options
#
# @yield [result, err] Result & error if block supplied
# @yieldparam result [Google::Apis::ClouddebuggerV2::SetBreakpointResponse] parsed result object
2015-12-03 01:10:07 +00:00
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::ClouddebuggerV2::SetBreakpointResponse]
2015-12-03 01:10:07 +00:00
#
# @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
2017-02-13 23:28:52 +00:00
def set_debugger_debuggee_breakpoint(debuggee_id, breakpoint_object = nil, client_version: nil, fields: nil, quota_user: nil, options: nil, &block)
command = make_simple_command(:post, 'v2/debugger/debuggees/{debuggeeId}/breakpoints/set', options)
command.request_representation = Google::Apis::ClouddebuggerV2::Breakpoint::Representation
command.request_object = breakpoint_object
command.response_representation = Google::Apis::ClouddebuggerV2::SetBreakpointResponse::Representation
command.response_class = Google::Apis::ClouddebuggerV2::SetBreakpointResponse
2015-12-03 01:10:07 +00:00
command.params['debuggeeId'] = debuggee_id unless debuggee_id.nil?
command.query['clientVersion'] = client_version unless client_version.nil?
2017-01-13 23:04:35 +00:00
command.query['fields'] = fields unless fields.nil?
2017-02-13 23:28:52 +00:00
command.query['quotaUser'] = quota_user unless quota_user.nil?
2015-12-03 01:10:07 +00:00
execute_or_queue_command(command, &block)
end
# Deletes the breakpoint from the debuggee.
2015-12-03 01:10:07 +00:00
# @param [String] debuggee_id
# ID of the debuggee whose breakpoint to delete.
# @param [String] breakpoint_id
# ID of the breakpoint to delete.
2016-03-11 22:41:20 +00:00
# @param [String] client_version
2017-01-13 23:04:35 +00:00
# The client version making the call.
# Following: `domain/type/version` (e.g., `google.com/intellij/v1`).
2017-02-13 23:28:52 +00:00
# @param [String] fields
# Selector specifying which fields to include in a partial response.
2015-12-03 01:10:07 +00:00
# @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.
# @param [Google::Apis::RequestOptions] options
# Request-specific options
#
# @yield [result, err] Result & error if block supplied
# @yieldparam result [Google::Apis::ClouddebuggerV2::Empty] parsed result object
2015-12-03 01:10:07 +00:00
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::ClouddebuggerV2::Empty]
2015-12-03 01:10:07 +00:00
#
# @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
2017-02-13 23:28:52 +00:00
def delete_debugger_debuggee_breakpoint(debuggee_id, breakpoint_id, client_version: nil, fields: nil, quota_user: nil, options: nil, &block)
command = make_simple_command(:delete, 'v2/debugger/debuggees/{debuggeeId}/breakpoints/{breakpointId}', options)
command.response_representation = Google::Apis::ClouddebuggerV2::Empty::Representation
command.response_class = Google::Apis::ClouddebuggerV2::Empty
command.params['debuggeeId'] = debuggee_id unless debuggee_id.nil?
command.params['breakpointId'] = breakpoint_id unless breakpoint_id.nil?
2016-03-11 22:41:20 +00:00
command.query['clientVersion'] = client_version unless client_version.nil?
2017-01-13 23:04:35 +00:00
command.query['fields'] = fields unless fields.nil?
2017-02-13 23:28:52 +00:00
command.query['quotaUser'] = quota_user unless quota_user.nil?
2015-12-03 01:10:07 +00:00
execute_or_queue_command(command, &block)
end
2017-01-13 23:04:35 +00:00
# Gets breakpoint information.
2015-12-03 01:10:07 +00:00
# @param [String] debuggee_id
2017-01-13 23:04:35 +00:00
# ID of the debuggee whose breakpoint to get.
# @param [String] breakpoint_id
# ID of the breakpoint to get.
2016-03-11 22:41:20 +00:00
# @param [String] client_version
2017-01-13 23:04:35 +00:00
# The client version making the call.
# Following: `domain/type/version` (e.g., `google.com/intellij/v1`).
2017-02-13 23:28:52 +00:00
# @param [String] fields
# Selector specifying which fields to include in a partial response.
2015-12-03 01:10:07 +00:00
# @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.
# @param [Google::Apis::RequestOptions] options
# Request-specific options
#
# @yield [result, err] Result & error if block supplied
2017-01-13 23:04:35 +00:00
# @yieldparam result [Google::Apis::ClouddebuggerV2::GetBreakpointResponse] parsed result object
2015-12-03 01:10:07 +00:00
# @yieldparam err [StandardError] error object if request failed
#
2017-01-13 23:04:35 +00:00
# @return [Google::Apis::ClouddebuggerV2::GetBreakpointResponse]
2015-12-03 01:10:07 +00:00
#
# @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
2017-02-13 23:28:52 +00:00
def get_debugger_debuggee_breakpoint(debuggee_id, breakpoint_id, client_version: nil, fields: nil, quota_user: nil, options: nil, &block)
2017-01-13 23:04:35 +00:00
command = make_simple_command(:get, 'v2/debugger/debuggees/{debuggeeId}/breakpoints/{breakpointId}', options)
command.response_representation = Google::Apis::ClouddebuggerV2::GetBreakpointResponse::Representation
command.response_class = Google::Apis::ClouddebuggerV2::GetBreakpointResponse
2015-12-03 01:10:07 +00:00
command.params['debuggeeId'] = debuggee_id unless debuggee_id.nil?
2017-01-13 23:04:35 +00:00
command.params['breakpointId'] = breakpoint_id unless breakpoint_id.nil?
2016-03-11 22:41:20 +00:00
command.query['clientVersion'] = client_version unless client_version.nil?
2017-01-13 23:04:35 +00:00
command.query['fields'] = fields unless fields.nil?
2017-02-13 23:28:52 +00:00
command.query['quotaUser'] = quota_user unless quota_user.nil?
2015-12-03 01:10:07 +00:00
execute_or_queue_command(command, &block)
end
2017-01-13 23:04:35 +00:00
# Lists all breakpoints for the debuggee.
2015-12-03 01:10:07 +00:00
# @param [String] debuggee_id
2017-01-13 23:04:35 +00:00
# ID of the debuggee whose breakpoints to list.
# @param [Boolean] include_inactive
# When set to `true`, the response includes active and inactive
# breakpoints. Otherwise, it includes only active breakpoints.
2017-01-13 23:04:35 +00:00
# @param [Boolean] include_all_users
# When set to `true`, the response includes the list of breakpoints set by
# any user. Otherwise, it includes only breakpoints set by the caller.
# @param [Boolean] strip_results
# This field is deprecated. The following fields are always stripped out of
# the result: `stack_frames`, `evaluated_expressions` and `variable_table`.
# @param [String] wait_token
# A wait token that, if specified, blocks the call until the breakpoints
# list has changed, or a server selected timeout has expired. The value
# should be set from the last response. The error code
# `google.rpc.Code.ABORTED` (RPC) is returned on wait timeout, which
# should be called again with the same `wait_token`.
# @param [String] client_version
# The client version making the call.
# Following: `domain/type/version` (e.g., `google.com/intellij/v1`).
# @param [String] action_value
# Only breakpoints with the specified action will pass the filter.
2017-02-13 23:28:52 +00:00
# @param [String] fields
# Selector specifying which fields to include in a partial response.
2015-12-03 01:10:07 +00:00
# @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.
# @param [Google::Apis::RequestOptions] options
# Request-specific options
#
# @yield [result, err] Result & error if block supplied
2017-01-13 23:04:35 +00:00
# @yieldparam result [Google::Apis::ClouddebuggerV2::ListBreakpointsResponse] parsed result object
2015-12-03 01:10:07 +00:00
# @yieldparam err [StandardError] error object if request failed
#
2017-01-13 23:04:35 +00:00
# @return [Google::Apis::ClouddebuggerV2::ListBreakpointsResponse]
2015-12-03 01:10:07 +00:00
#
# @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
2017-02-13 23:28:52 +00:00
def list_debugger_debuggee_breakpoints(debuggee_id, include_inactive: nil, include_all_users: nil, strip_results: nil, wait_token: nil, client_version: nil, action_value: nil, fields: nil, quota_user: nil, options: nil, &block)
2017-01-13 23:04:35 +00:00
command = make_simple_command(:get, 'v2/debugger/debuggees/{debuggeeId}/breakpoints', options)
command.response_representation = Google::Apis::ClouddebuggerV2::ListBreakpointsResponse::Representation
command.response_class = Google::Apis::ClouddebuggerV2::ListBreakpointsResponse
2015-12-03 01:10:07 +00:00
command.params['debuggeeId'] = debuggee_id unless debuggee_id.nil?
command.query['includeInactive'] = include_inactive unless include_inactive.nil?
2017-01-13 23:04:35 +00:00
command.query['includeAllUsers'] = include_all_users unless include_all_users.nil?
command.query['stripResults'] = strip_results unless strip_results.nil?
command.query['waitToken'] = wait_token unless wait_token.nil?
command.query['clientVersion'] = client_version unless client_version.nil?
command.query['action.value'] = action_value unless action_value.nil?
2017-01-13 23:04:35 +00:00
command.query['fields'] = fields unless fields.nil?
2017-02-13 23:28:52 +00:00
command.query['quotaUser'] = quota_user unless quota_user.nil?
2015-12-03 01:10:07 +00:00
execute_or_queue_command(command, &block)
end
# Registers the debuggee with the controller service.
# All agents attached to the same application should call this method with
# the same request content to get back the same stable `debuggee_id`. Agents
# should call this method again whenever `google.rpc.Code.NOT_FOUND` is
# returned from any controller method.
# This allows the controller service to disable the agent or recover from any
# data loss. If the debuggee is disabled by the server, the response will
# have `is_disabled` set to `true`.
# @param [Google::Apis::ClouddebuggerV2::RegisterDebuggeeRequest] register_debuggee_request_object
2017-02-13 23:28:52 +00:00
# @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.
# @param [Google::Apis::RequestOptions] options
# Request-specific options
#
# @yield [result, err] Result & error if block supplied
# @yieldparam result [Google::Apis::ClouddebuggerV2::RegisterDebuggeeResponse] parsed result object
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::ClouddebuggerV2::RegisterDebuggeeResponse]
#
# @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
2017-02-13 23:28:52 +00:00
def register_debuggee(register_debuggee_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
command = make_simple_command(:post, 'v2/controller/debuggees/register', options)
command.request_representation = Google::Apis::ClouddebuggerV2::RegisterDebuggeeRequest::Representation
command.request_object = register_debuggee_request_object
command.response_representation = Google::Apis::ClouddebuggerV2::RegisterDebuggeeResponse::Representation
command.response_class = Google::Apis::ClouddebuggerV2::RegisterDebuggeeResponse
command.query['fields'] = fields unless fields.nil?
2017-02-13 23:28:52 +00:00
command.query['quotaUser'] = quota_user unless quota_user.nil?
execute_or_queue_command(command, &block)
end
# Returns the list of all active breakpoints for the debuggee.
# The breakpoint specification (location, condition, and expression
# fields) is semantically immutable, although the field values may
# change. For example, an agent may update the location line number
# to reflect the actual line where the breakpoint was set, but this
# doesn't change the breakpoint semantics.
# This means that an agent does not need to check if a breakpoint has changed
# when it encounters the same breakpoint on a successive call.
# Moreover, an agent should remember the breakpoints that are completed
# until the controller removes them from the active list to avoid
# setting those breakpoints again.
2015-12-03 01:10:07 +00:00
# @param [String] debuggee_id
# Identifies the debuggee.
2017-02-13 23:28:52 +00:00
# @param [String] wait_token
# A wait token that, if specified, blocks the method call until the list
# of active breakpoints has changed, or a server selected timeout has
# expired. The value should be set from the last returned response.
# @param [Boolean] success_on_timeout
# If set to `true`, returns `google.rpc.Code.OK` status and sets the
# `wait_expired` response field to `true` when the server-selected timeout
# has expired (recommended).
# If set to `false`, returns `google.rpc.Code.ABORTED` status when the
# server-selected timeout has expired (deprecated).
2017-02-13 23:28:52 +00:00
# @param [String] fields
# Selector specifying which fields to include in a partial response.
2015-12-03 01:10:07 +00:00
# @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.
# @param [Google::Apis::RequestOptions] options
# Request-specific options
#
# @yield [result, err] Result & error if block supplied
# @yieldparam result [Google::Apis::ClouddebuggerV2::ListActiveBreakpointsResponse] parsed result object
2015-12-03 01:10:07 +00:00
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::ClouddebuggerV2::ListActiveBreakpointsResponse]
2015-12-03 01:10:07 +00:00
#
# @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
2017-02-13 23:28:52 +00:00
def list_controller_debuggee_breakpoints(debuggee_id, wait_token: nil, success_on_timeout: nil, fields: nil, quota_user: nil, options: nil, &block)
command = make_simple_command(:get, 'v2/controller/debuggees/{debuggeeId}/breakpoints', options)
command.response_representation = Google::Apis::ClouddebuggerV2::ListActiveBreakpointsResponse::Representation
command.response_class = Google::Apis::ClouddebuggerV2::ListActiveBreakpointsResponse
2015-12-03 01:10:07 +00:00
command.params['debuggeeId'] = debuggee_id unless debuggee_id.nil?
command.query['waitToken'] = wait_token unless wait_token.nil?
2017-02-13 23:28:52 +00:00
command.query['successOnTimeout'] = success_on_timeout unless success_on_timeout.nil?
2017-01-13 23:04:35 +00:00
command.query['fields'] = fields unless fields.nil?
2017-02-13 23:28:52 +00:00
command.query['quotaUser'] = quota_user unless quota_user.nil?
2015-12-03 01:10:07 +00:00
execute_or_queue_command(command, &block)
end
# Updates the breakpoint state or mutable fields.
# The entire Breakpoint message must be sent back to the controller
# service.
# Updates to active breakpoint fields are only allowed if the new value
# does not change the breakpoint specification. Updates to the `location`,
# `condition` and `expression` fields should not alter the breakpoint
# semantics. These may only make changes such as canonicalizing a value
# or snapping the location to the correct line of code.
2015-12-03 01:10:07 +00:00
# @param [String] debuggee_id
# Identifies the debuggee being debugged.
# @param [String] id
# Breakpoint identifier, unique in the scope of the debuggee.
# @param [Google::Apis::ClouddebuggerV2::UpdateActiveBreakpointRequest] update_active_breakpoint_request_object
2017-02-13 23:28:52 +00:00
# @param [String] fields
# Selector specifying which fields to include in a partial response.
2015-12-03 01:10:07 +00:00
# @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.
# @param [Google::Apis::RequestOptions] options
# Request-specific options
#
# @yield [result, err] Result & error if block supplied
# @yieldparam result [Google::Apis::ClouddebuggerV2::UpdateActiveBreakpointResponse] parsed result object
2015-12-03 01:10:07 +00:00
# @yieldparam err [StandardError] error object if request failed
#
# @return [Google::Apis::ClouddebuggerV2::UpdateActiveBreakpointResponse]
2015-12-03 01:10:07 +00:00
#
# @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
2017-02-13 23:28:52 +00:00
def update_active_breakpoint(debuggee_id, id, update_active_breakpoint_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
command = make_simple_command(:put, 'v2/controller/debuggees/{debuggeeId}/breakpoints/{id}', options)
command.request_representation = Google::Apis::ClouddebuggerV2::UpdateActiveBreakpointRequest::Representation
command.request_object = update_active_breakpoint_request_object
command.response_representation = Google::Apis::ClouddebuggerV2::UpdateActiveBreakpointResponse::Representation
command.response_class = Google::Apis::ClouddebuggerV2::UpdateActiveBreakpointResponse
2015-12-03 01:10:07 +00:00
command.params['debuggeeId'] = debuggee_id unless debuggee_id.nil?
command.params['id'] = id unless id.nil?
2017-01-13 23:04:35 +00:00
command.query['fields'] = fields unless fields.nil?
2017-02-13 23:28:52 +00:00
command.query['quotaUser'] = quota_user unless quota_user.nil?
2015-12-03 01:10:07 +00:00
execute_or_queue_command(command, &block)
end
protected
def apply_command_defaults(command)
command.query['key'] = key unless key.nil?
command.query['quotaUser'] = quota_user unless quota_user.nil?
end
end
end
end
end