google-api-client 0.10.2 → 0.10.3

data/generated/google/apis/tracing_v1/representations.rb

@@ -0,0 +1,279 @@
+# 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 'date'
+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 TracingV1
+      
+      class Trace
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Module
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Status
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Empty
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ListTracesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Span
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AttributeValue
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class BatchUpdateSpansRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class StackTrace
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class TimeEvent
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class NetworkEvent
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ListSpansResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class SpanUpdates
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class StackFrame
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Link
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Annotation
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class Trace
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
+        end
+      end
+      
+      class Module
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :build_id, as: 'buildId'
+          property :module, as: 'module'
+        end
+      end
+      
+      class Status
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :code, as: 'code'
+          property :message, as: 'message'
+          collection :details, as: 'details'
+        end
+      end
+      
+      class Empty
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class ListTracesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :traces, as: 'traces', class: Google::Apis::TracingV1::Trace, decorator: Google::Apis::TracingV1::Trace::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
+      class Span
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :local_end_time, as: 'localEndTime'
+          property :parent_id, as: 'parentId'
+          collection :time_events, as: 'timeEvents', class: Google::Apis::TracingV1::TimeEvent, decorator: Google::Apis::TracingV1::TimeEvent::Representation
+      
+          property :status, as: 'status', class: Google::Apis::TracingV1::Status, decorator: Google::Apis::TracingV1::Status::Representation
+      
+          property :name, as: 'name'
+          property :stack_trace, as: 'stackTrace', class: Google::Apis::TracingV1::StackTrace, decorator: Google::Apis::TracingV1::StackTrace::Representation
+      
+          collection :links, as: 'links', class: Google::Apis::TracingV1::Link, decorator: Google::Apis::TracingV1::Link::Representation
+      
+          hash :attributes, as: 'attributes', class: Google::Apis::TracingV1::AttributeValue, decorator: Google::Apis::TracingV1::AttributeValue::Representation
+      
+          property :id, as: 'id'
+          property :local_start_time, as: 'localStartTime'
+          property :has_remote_parent, as: 'hasRemoteParent'
+        end
+      end
+      
+      class AttributeValue
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :string_value, as: 'stringValue'
+          property :bool_value, as: 'boolValue'
+          property :int_value, as: 'intValue'
+        end
+      end
+      
+      class BatchUpdateSpansRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :span_updates, as: 'spanUpdates', class: Google::Apis::TracingV1::SpanUpdates, decorator: Google::Apis::TracingV1::SpanUpdates::Representation
+      
+        end
+      end
+      
+      class StackTrace
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :stack_frame, as: 'stackFrame', class: Google::Apis::TracingV1::StackFrame, decorator: Google::Apis::TracingV1::StackFrame::Representation
+      
+          property :stack_trace_hash_id, as: 'stackTraceHashId'
+        end
+      end
+      
+      class TimeEvent
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :network_event, as: 'networkEvent', class: Google::Apis::TracingV1::NetworkEvent, decorator: Google::Apis::TracingV1::NetworkEvent::Representation
+      
+          property :annotation, as: 'annotation', class: Google::Apis::TracingV1::Annotation, decorator: Google::Apis::TracingV1::Annotation::Representation
+      
+          property :local_time, as: 'localTime'
+        end
+      end
+      
+      class NetworkEvent
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :message_size, as: 'messageSize'
+          property :kernel_time, as: 'kernelTime'
+          property :type, as: 'type'
+          property :message_id, as: 'messageId'
+        end
+      end
+      
+      class ListSpansResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :spans, as: 'spans', class: Google::Apis::TracingV1::Span, decorator: Google::Apis::TracingV1::Span::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+        end
+      end
+      
+      class SpanUpdates
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :spans, as: 'spans', class: Google::Apis::TracingV1::Span, decorator: Google::Apis::TracingV1::Span::Representation
+      
+        end
+      end
+      
+      class StackFrame
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :file_name, as: 'fileName'
+          property :source_version, as: 'sourceVersion'
+          property :original_function_name, as: 'originalFunctionName'
+          property :function_name, as: 'functionName'
+          property :line_number, as: 'lineNumber'
+          property :load_module, as: 'loadModule', class: Google::Apis::TracingV1::Module, decorator: Google::Apis::TracingV1::Module::Representation
+      
+          property :column_number, as: 'columnNumber'
+        end
+      end
+      
+      class Link
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :type, as: 'type'
+          property :trace_id, as: 'traceId'
+          property :span_id, as: 'spanId'
+        end
+      end
+      
+      class Annotation
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :description, as: 'description'
+          hash :attributes, as: 'attributes', class: Google::Apis::TracingV1::AttributeValue, decorator: Google::Apis::TracingV1::AttributeValue::Representation
+      
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,225 @@
+# 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 TracingV1
+      # Google Tracing API
+      #
+      # Send and retrieve trace data from Google Stackdriver Trace.
+      #
+      # @example
+      #    require 'google/apis/tracing_v1'
+      #
+      #    Tracing = Google::Apis::TracingV1 # Alias the module
+      #    service = Tracing::TracingService.new
+      #
+      # @see https://cloud.google.com/trace
+      class TracingService < 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://tracing.googleapis.com/', '')
+        end
+        
+        # Returns a list of spans within a trace.
+        # @param [String] name
+        #   ID of the trace for which to list child spans. Format is
+        #   `projects/PROJECT_ID/traces/TRACE_ID`.
+        # @param [String] page_token
+        #   Token identifying the page of results to return. If provided, use the
+        #   value of the `nextPageToken` field from a previous request. Optional.
+        # @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::TracingV1::ListSpansResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::TracingV1::ListSpansResponse]
+        #
+        # @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_project_trace_spans(name, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/{+name}:listSpans', options)
+          command.response_representation = Google::Apis::TracingV1::ListSpansResponse::Representation
+          command.response_class = Google::Apis::TracingV1::ListSpansResponse
+          command.params['name'] = name unless name.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?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns of a list of traces that match the specified filter conditions.
+        # @param [String] parent
+        #   ID of the Cloud project where the trace data is stored.
+        # @param [String] filter
+        #   An optional filter for the request.
+        #   Example:
+        #   `version_label_key:a some_label:some_label_key`
+        #   returns traces from version `a` and has `some_label` with `some_label_key`.
+        # @param [String] end_time
+        #   End of the time interval (inclusive) during which the trace data was
+        #   collected from the application.
+        # @param [String] page_token
+        #   Token identifying the page of results to return. If provided, use the
+        #   value of the `next_page_token` field from a previous request. Optional.
+        # @param [String] start_time
+        #   Start of the time interval (inclusive) during which the trace data was
+        #   collected from the application.
+        # @param [Fixnum] page_size
+        #   Maximum number of traces to return. If not specified or <= 0, the
+        #   implementation selects a reasonable value. The implementation may
+        #   return fewer traces than the requested page size. Optional.
+        # @param [String] order_by
+        #   Field used to sort the returned traces. Optional.
+        #   Can be one of the following:
+        #   *   `trace_id`
+        #   *   `name` (`name` field of root span in the trace)
+        #   *   `duration` (difference between `end_time` and `start_time` fields of
+        #   the root span)
+        #   *   `start` (`start_time` field of the root span)
+        #   Descending order can be specified by appending `desc` to the sort field
+        #   (for example, `name desc`).
+        #   Only one sort field is permitted.
+        # @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::TracingV1::ListTracesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::TracingV1::ListTracesResponse]
+        #
+        # @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_project_traces(parent, filter: nil, end_time: nil, page_token: nil, start_time: nil, page_size: nil, order_by: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/{+parent}/traces', options)
+          command.response_representation = Google::Apis::TracingV1::ListTracesResponse::Representation
+          command.response_class = Google::Apis::TracingV1::ListTracesResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['endTime'] = end_time unless end_time.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['startTime'] = start_time unless start_time.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['orderBy'] = order_by unless order_by.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns a specific trace.
+        # @param [String] name
+        #   ID of the trace. Format is `projects/PROJECT_ID/traces/TRACE_ID`.
+        # @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::TracingV1::Trace] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::TracingV1::Trace]
+        #
+        # @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_project_trace(name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::TracingV1::Trace::Representation
+          command.response_class = Google::Apis::TracingV1::Trace
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Sends new spans to Stackdriver Trace or updates existing spans. If the
+        # name of a trace that you send matches that of an existing trace, any fields
+        # in the existing trace and its spans are overwritten by the provided values,
+        # and any new fields provided are merged with the existing trace data. If the
+        # name does not match, a new trace is created with given set of spans.
+        # @param [String] parent
+        #   ID of the Cloud project where the trace data is stored.
+        # @param [Google::Apis::TracingV1::BatchUpdateSpansRequest] batch_update_spans_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::TracingV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::TracingV1::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 batch_trace_update_spans(parent, batch_update_spans_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+parent}/traces:batchUpdate', options)
+          command.request_representation = Google::Apis::TracingV1::BatchUpdateSpansRequest::Representation
+          command.request_object = batch_update_spans_request_object
+          command.response_representation = Google::Apis::TracingV1::Empty::Representation
+          command.response_class = Google::Apis::TracingV1::Empty
+          command.params['parent'] = parent unless parent.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