google-api-client 0.8.3 → 0.9

data/generated/google/apis/clouddebugger_v2/service.rb

@@ -0,0 +1,370 @@
+# 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
+      # Google Cloud Debugger API
+      #
+      # Lets you examine the stack and variables of your running application without
+      #  stopping or slowing it down.
+      #
+      # @example
+      #    require 'google/apis/clouddebugger_v2'
+      #
+      #    Clouddebugger = Google::Apis::ClouddebuggerV2 # Alias the module
+      #    service = Clouddebugger::ClouddebuggerService.new
+      #
+      # @see https://cloud.google.com/tools/cloud-debugger
+      class ClouddebuggerService < Google::Apis::Core::BaseService
+        # @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
+        
+        # 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
+        # @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
+        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?
+          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.
+        # @param [String] debuggee_id
+        #   Identifies the debuggee.
+        # @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).
+        # @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::ListActiveBreakpointsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ClouddebuggerV2::ListActiveBreakpointsResponse]
+        #
+        # @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_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
+          command.params['debuggeeId'] = debuggee_id unless debuggee_id.nil?
+          command.query['waitToken'] = wait_token unless wait_token.nil?
+          command.query['successOnTimeout'] = success_on_timeout unless success_on_timeout.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          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.
+        # @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
+        # @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::UpdateActiveBreakpointResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ClouddebuggerV2::UpdateActiveBreakpointResponse]
+        #
+        # @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_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
+          command.params['debuggeeId'] = debuggee_id unless debuggee_id.nil?
+          command.params['id'] = id unless id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists all the debuggees that the user can set breakpoints to.
+        # @param [String] project
+        #   Project number of a Google Cloud project whose debuggees to list.
+        # @param [Boolean] include_inactive
+        #   When set to `true`, the result includes all debuggees. Otherwise, the result
+        #   includes only debuggees that are active.
+        # @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::ListDebuggeesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ClouddebuggerV2::ListDebuggeesResponse]
+        #
+        # @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_debugger_debuggees(project: nil, include_inactive: 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['project'] = project unless project.nil?
+          command.query['includeInactive'] = include_inactive unless include_inactive.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Sets the breakpoint to the debuggee.
+        # @param [String] debuggee_id
+        #   ID of the debuggee where the breakpoint is to be set.
+        # @param [Google::Apis::ClouddebuggerV2::Breakpoint] breakpoint_object
+        # @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::SetBreakpointResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ClouddebuggerV2::SetBreakpointResponse]
+        #
+        # @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_debugger_debuggee_breakpoint(debuggee_id, breakpoint_object = 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
+          command.params['debuggeeId'] = debuggee_id unless debuggee_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets breakpoint information.
+        # @param [String] debuggee_id
+        #   ID of the debuggee whose breakpoint to get.
+        # @param [String] breakpoint_id
+        #   ID of the breakpoint to get.
+        # @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::GetBreakpointResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ClouddebuggerV2::GetBreakpointResponse]
+        #
+        # @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_debugger_debuggee_breakpoint(debuggee_id, breakpoint_id, fields: nil, quota_user: nil, options: nil, &block)
+          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
+          command.params['debuggeeId'] = debuggee_id unless debuggee_id.nil?
+          command.params['breakpointId'] = breakpoint_id unless breakpoint_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes the breakpoint from the debuggee.
+        # @param [String] debuggee_id
+        #   ID of the debuggee whose breakpoint to delete.
+        # @param [String] breakpoint_id
+        #   ID of the breakpoint to delete.
+        # @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::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ClouddebuggerV2::Empty]
+        #
+        # @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_debugger_debuggee_breakpoint(debuggee_id, breakpoint_id, 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?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists all breakpoints for the debuggee.
+        # @param [String] debuggee_id
+        #   ID of the debuggee whose breakpoints to list.
+        # @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] include_inactive
+        #   When set to `true`, the response includes active and inactive breakpoints.
+        #   Otherwise, it includes only active breakpoints.
+        # @param [String] action_value
+        #   Only breakpoints with the specified action will pass the filter.
+        # @param [Boolean] strip_results
+        #   When set to `true`, the response breakpoints are stripped of the results
+        #   fields: `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] 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::ListBreakpointsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ClouddebuggerV2::ListBreakpointsResponse]
+        #
+        # @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_debugger_debuggee_breakpoints(debuggee_id, include_all_users: nil, include_inactive: nil, action_value: nil, strip_results: nil, wait_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          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
+          command.params['debuggeeId'] = debuggee_id unless debuggee_id.nil?
+          command.query['includeAllUsers'] = include_all_users unless include_all_users.nil?
+          command.query['includeInactive'] = include_inactive unless include_inactive.nil?
+          command.query['action.value'] = action_value unless action_value.nil?
+          command.query['stripResults'] = strip_results unless strip_results.nil?
+          command.query['waitToken'] = wait_token unless wait_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          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

data/generated/google/apis/clouddebugger_v2.rb

@@ -0,0 +1,41 @@
+# 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/clouddebugger_v2/service.rb'
+require 'google/apis/clouddebugger_v2/classes.rb'
+require 'google/apis/clouddebugger_v2/representations.rb'
+
+module Google
+  module Apis
+    # Google Cloud Debugger API
+    #
+    # Lets you examine the stack and variables of your running application without
+    # stopping or slowing it down.
+    #
+    # @see https://cloud.google.com/tools/cloud-debugger
+    module ClouddebuggerV2
+      VERSION = 'V2'
+      REVISION = '20151123'
+
+      # View and manage your data across Google Cloud Platform services
+      AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
+
+      # Manage cloud debugger
+      AUTH_CLOUD_DEBUGGER = 'https://www.googleapis.com/auth/cloud_debugger'
+
+      # Manage active breakpoints in cloud debugger
+      AUTH_CLOUD_DEBUGLETCONTROLLER = 'https://www.googleapis.com/auth/cloud_debugletcontroller'
+    end
+  end
+end