google-api-client 0.9.8 → 0.10.2

data/generated/google/apis/cloudtrace_v1.rb

@@ -18,26 +18,26 @@ require 'google/apis/cloudtrace_v1/representations.rb'
 
 module Google
   module Apis
-    # Google Cloud Trace API
+    # Stackdriver Trace API
     #
-    # Send and retrieve trace data from Google Cloud Trace. Data is generated and
+    # Send and retrieve trace data from Stackdriver Trace. Data is generated and
     # available by default for all App Engine applications. Data from other
-    # applications can be written to Cloud Trace for display, reporting, and
+    # applications can be written to Stackdriver Trace for display, reporting, and
     # analysis.
     #
-    # @see https://cloud.google.com/tools/cloud-trace
+    # @see https://cloud.google.com/trace
     module CloudtraceV1
       VERSION = 'V1'
-      REVISION = '20160518'
+      REVISION = '20170320'
 
-      # View and manage your data across Google Cloud Platform services
-      AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
+      # Read Trace data for a project or application
+      AUTH_TRACE_READONLY = 'https://www.googleapis.com/auth/trace.readonly'
 
       # Write Trace data for a project or application
       AUTH_TRACE_APPEND = 'https://www.googleapis.com/auth/trace.append'
 
-      # Read Trace data for a project or application
-      AUTH_TRACE_READONLY = 'https://www.googleapis.com/auth/trace.readonly'
+      # View and manage your data across Google Cloud Platform services
+      AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
     end
   end
 end

data/generated/google/apis/cloudtrace_v1/classes.rb

@@ -22,6 +22,75 @@ module Google
   module Apis
     module CloudtraceV1
       
+      # A span represents a single timed event within a trace. Spans can be nested
+      # and form a trace tree. Often, a trace contains a root span that describes the
+      # end-to-end latency of an operation and, optionally, one or more subspans for
+      # its suboperations. Spans do not need to be contiguous. There may be gaps
+      # between spans in a trace.
+      class TraceSpan
+        include Google::Apis::Core::Hashable
+      
+        # Identifier for the span. Must be a 64-bit integer other than 0 and
+        # unique within a trace.
+        # Corresponds to the JSON property `spanId`
+        # @return [String]
+        attr_accessor :span_id
+      
+        # ID of the parent span, if any. Optional.
+        # Corresponds to the JSON property `parentSpanId`
+        # @return [String]
+        attr_accessor :parent_span_id
+      
+        # End time of the span in nanoseconds from the UNIX epoch.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # Start time of the span in nanoseconds from the UNIX epoch.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        # Distinguishes between spans generated in a particular context. For example,
+        # two spans with the same name may be distinguished using `RPC_CLIENT`
+        # and `RPC_SERVER` to identify queueing latency associated with the span.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # Collection of labels associated with the span. Label keys must be less than
+        # 128 bytes. Label values must be less than 16 kilobytes.
+        # Corresponds to the JSON property `labels`
+        # @return [Hash<String,String>]
+        attr_accessor :labels
+      
+        # Name of the span. Must be less than 128 bytes. The span name is sanitized
+        # and displayed in the Stackdriver Trace tool in the
+        # `% dynamic print site_values.console_name %`.
+        # The name may be a method name or some other per-call site name.
+        # For the same executable and the same call point, a best practice is
+        # to use a consistent name, which makes it easier to correlate
+        # cross-trace spans.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @span_id = args[:span_id] if args.key?(:span_id)
+          @parent_span_id = args[:parent_span_id] if args.key?(:parent_span_id)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @start_time = args[:start_time] if args.key?(:start_time)
+          @kind = args[:kind] if args.key?(:kind)
+          @labels = args[:labels] if args.key?(:labels)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # The response message for the `ListTraces` method.
       class ListTracesResponse
         include Google::Apis::Core::Hashable
@@ -31,9 +100,9 @@ module Google
         # @return [Array<Google::Apis::CloudtraceV1::Trace>]
         attr_accessor :traces
       
-        # If defined, indicates that there are more traces that match the request and
-        # that this value should be passed to the next request to continue retrieving
-        # additional traces.
+        # If defined, indicates that there are more traces that match the request
+        # and that this value should be passed to the next request to continue
+        # retrieving additional traces.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -49,88 +118,46 @@ module Google
         end
       end
       
-      # A trace describes how long it takes for an application to perform an operation.
-      # It consists of a set of spans, each of which represent a single timed event
-      # within the operation.
-      class Trace
+      # A generic empty message that you can re-use to avoid defining duplicated
+      # empty messages in your APIs. A typical example is to use it as the request
+      # or the response type of an API method. For instance:
+      # service Foo `
+      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # `
+      # The JSON representation for `Empty` is empty JSON object ````.
+      class Empty
         include Google::Apis::Core::Hashable
       
-        # Project ID of the Cloud project where the trace data is stored.
-        # Corresponds to the JSON property `projectId`
-        # @return [String]
-        attr_accessor :project_id
-      
-        # Globally unique identifier for the trace. This identifier is a 128-bit numeric
-        # value formatted as a 32-byte hex string.
-        # Corresponds to the JSON property `traceId`
-        # @return [String]
-        attr_accessor :trace_id
-      
-        # Collection of spans in the trace.
-        # Corresponds to the JSON property `spans`
-        # @return [Array<Google::Apis::CloudtraceV1::TraceSpan>]
-        attr_accessor :spans
-      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
-          @project_id = args[:project_id] if args.key?(:project_id)
-          @trace_id = args[:trace_id] if args.key?(:trace_id)
-          @spans = args[:spans] if args.key?(:spans)
         end
       end
       
-      # A span represents a single timed event within a trace. Spans can be nested and
-      # form a trace tree. Often, a trace contains a root span that describes the end-
-      # to-end latency of an operation and, optionally, one or more subspans for its
-      # suboperations. Spans do not need to be contiguous. There may be gaps between
-      # spans in a trace.
-      class TraceSpan
+      # A trace describes how long it takes for an application to perform an
+      # operation. It consists of a set of spans, each of which represent a single
+      # timed event within the operation.
+      class Trace
         include Google::Apis::Core::Hashable
       
-        # Identifier for the span. This identifier must be unique within a trace.
-        # Corresponds to the JSON property `spanId`
-        # @return [String]
-        attr_accessor :span_id
-      
-        # Distinguishes between spans generated in a particular context. For example,
-        # two spans with the same name may be distinguished using `RPC_CLIENT` and `
-        # RPC_SERVER` to identify queueing latency associated with the span.
-        # Corresponds to the JSON property `kind`
-        # @return [String]
-        attr_accessor :kind
-      
-        # Name of the trace. The trace name is sanitized and displayed in the
-        # Stackdriver Trace tool in the `% dynamic print site_values.console_name %`.
-        # The name may be a method name or some other per-call site name. For the same
-        # executable and the same call point, a best practice is to use a consistent
-        # name, which makes it easier to correlate cross-trace spans.
-        # Corresponds to the JSON property `name`
-        # @return [String]
-        attr_accessor :name
-      
-        # Start time of the span in nanoseconds from the UNIX epoch.
-        # Corresponds to the JSON property `startTime`
+        # Project ID of the Cloud project where the trace data is stored.
+        # Corresponds to the JSON property `projectId`
         # @return [String]
-        attr_accessor :start_time
+        attr_accessor :project_id
       
-        # End time of the span in nanoseconds from the UNIX epoch.
-        # Corresponds to the JSON property `endTime`
-        # @return [String]
-        attr_accessor :end_time
+        # Collection of spans in the trace.
+        # Corresponds to the JSON property `spans`
+        # @return [Array<Google::Apis::CloudtraceV1::TraceSpan>]
+        attr_accessor :spans
       
-        # ID of the parent span, if any. Optional.
-        # Corresponds to the JSON property `parentSpanId`
+        # Globally unique identifier for the trace. This identifier is a 128-bit
+        # numeric value formatted as a 32-byte hex string.
+        # Corresponds to the JSON property `traceId`
         # @return [String]
-        attr_accessor :parent_span_id
-      
-        # Collection of labels associated with the span.
-        # Corresponds to the JSON property `labels`
-        # @return [Hash<String,String>]
-        attr_accessor :labels
+        attr_accessor :trace_id
       
         def initialize(**args)
            update!(**args)
@@ -138,13 +165,9 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @span_id = args[:span_id] if args.key?(:span_id)
-          @kind = args[:kind] if args.key?(:kind)
-          @name = args[:name] if args.key?(:name)
-          @start_time = args[:start_time] if args.key?(:start_time)
-          @end_time = args[:end_time] if args.key?(:end_time)
-          @parent_span_id = args[:parent_span_id] if args.key?(:parent_span_id)
-          @labels = args[:labels] if args.key?(:labels)
+          @project_id = args[:project_id] if args.key?(:project_id)
+          @spans = args[:spans] if args.key?(:spans)
+          @trace_id = args[:trace_id] if args.key?(:trace_id)
         end
       end
       
@@ -166,23 +189,6 @@ module Google
           @traces = args[:traces] if args.key?(:traces)
         end
       end
-      
-      # A generic empty message that you can re-use to avoid defining duplicated empty
-      # messages in your APIs. A typical example is to use it as the request or the
-      # response type of an API method. For instance: service Foo ` rpc Bar(google.
-      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
-      # `Empty` is empty JSON object ````.
-      class Empty
-        include Google::Apis::Core::Hashable
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-        end
-      end
     end
   end
 end

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

@@ -22,79 +22,79 @@ module Google
   module Apis
     module CloudtraceV1
       
-      class ListTracesResponse
+      class TraceSpan
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class Trace
+      class ListTracesResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class TraceSpan
+      class Empty
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class Traces
+      class Trace
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class Empty
+      class Traces
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class ListTracesResponse
+      class TraceSpan
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          collection :traces, as: 'traces', class: Google::Apis::CloudtraceV1::Trace, decorator: Google::Apis::CloudtraceV1::Trace::Representation
-      
-          property :next_page_token, as: 'nextPageToken'
+          property :span_id, as: 'spanId'
+          property :parent_span_id, as: 'parentSpanId'
+          property :end_time, as: 'endTime'
+          property :start_time, as: 'startTime'
+          property :kind, as: 'kind'
+          hash :labels, as: 'labels'
+          property :name, as: 'name'
         end
       end
       
-      class Trace
+      class ListTracesResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          property :project_id, as: 'projectId'
-          property :trace_id, as: 'traceId'
-          collection :spans, as: 'spans', class: Google::Apis::CloudtraceV1::TraceSpan, decorator: Google::Apis::CloudtraceV1::TraceSpan::Representation
+          collection :traces, as: 'traces', class: Google::Apis::CloudtraceV1::Trace, decorator: Google::Apis::CloudtraceV1::Trace::Representation
       
+          property :next_page_token, as: 'nextPageToken'
         end
       end
       
-      class TraceSpan
+      class Empty
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          property :span_id, as: 'spanId'
-          property :kind, as: 'kind'
-          property :name, as: 'name'
-          property :start_time, as: 'startTime'
-          property :end_time, as: 'endTime'
-          property :parent_span_id, as: 'parentSpanId'
-          hash :labels, as: 'labels'
         end
       end
       
-      class Traces
+      class Trace
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          collection :traces, as: 'traces', class: Google::Apis::CloudtraceV1::Trace, decorator: Google::Apis::CloudtraceV1::Trace::Representation
+          property :project_id, as: 'projectId'
+          collection :spans, as: 'spans', class: Google::Apis::CloudtraceV1::TraceSpan, decorator: Google::Apis::CloudtraceV1::TraceSpan::Representation
       
+          property :trace_id, as: 'traceId'
         end
       end
       
-      class Empty
+      class Traces
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          collection :traces, as: 'traces', class: Google::Apis::CloudtraceV1::Trace, decorator: Google::Apis::CloudtraceV1::Trace::Representation
+      
         end
       end
     end

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

@@ -20,11 +20,11 @@ require 'google/apis/errors'
 module Google
   module Apis
     module CloudtraceV1
-      # Google Cloud Trace API
+      # Stackdriver Trace API
       #
-      # Send and retrieve trace data from Google Cloud Trace. Data is generated and
+      # Send and retrieve trace data from Stackdriver Trace. Data is generated and
       #  available by default for all App Engine applications. Data from other
-      #  applications can be written to Cloud Trace for display, reporting, and
+      #  applications can be written to Stackdriver Trace for display, reporting, and
       #  analysis.
       #
       # @example
@@ -33,7 +33,7 @@ module Google
       #    Cloudtrace = Google::Apis::CloudtraceV1 # Alias the module
       #    service = Cloudtrace::CloudTraceService.new
       #
-      # @see https://cloud.google.com/tools/cloud-trace
+      # @see https://cloud.google.com/trace
       class CloudTraceService < Google::Apis::Core::BaseService
         # @return [String]
         #  API key. Your API key identifies your project and provides you with API access,
@@ -49,11 +49,11 @@ module Google
           super('https://cloudtrace.googleapis.com/', '')
         end
         
-        # Sends new traces to Stackdriver Trace or updates existing traces. If the ID 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 ID does
-        # not match, a new trace is created.
+        # Sends new traces to Stackdriver Trace or updates existing traces. If the ID
+        # 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
+        # ID does not match, a new trace is created.
         # @param [String] project_id
         #   ID of the Cloud project where the trace data is stored.
         # @param [Google::Apis::CloudtraceV1::Traces] traces_object
@@ -89,30 +89,35 @@ module Google
         # Returns of a list of traces that match the specified filter conditions.
         # @param [String] project_id
         #   ID of the Cloud project where the trace data is stored.
-        # @param [String] view
-        #   Type of data returned for traces in the list. Optional. Default is `MINIMAL`.
-        # @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] 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
-        #   End of the time interval (inclusive) during which the trace data was collected
-        #   from the application.
+        # @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] filter
+        #   An optional filter for the request.
         # @param [String] end_time
         #   Start of the time interval (inclusive) during which the trace data was
         #   collected from the application.
-        # @param [String] filter
-        #   An optional filter for the request.
-        # @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] start_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 [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] view
+        #   Type of data returned for traces in the list. Optional. Default is
+        #   `MINIMAL`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -130,18 +135,18 @@ module Google
         # @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(project_id, view: nil, page_size: nil, page_token: nil, start_time: nil, end_time: nil, filter: nil, order_by: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_project_traces(project_id, order_by: nil, filter: nil, end_time: nil, start_time: nil, page_token: nil, page_size: nil, view: nil, fields: nil, quota_user: nil, options: nil, &block)
           command =  make_simple_command(:get, 'v1/projects/{projectId}/traces', options)
           command.response_representation = Google::Apis::CloudtraceV1::ListTracesResponse::Representation
           command.response_class = Google::Apis::CloudtraceV1::ListTracesResponse
           command.params['projectId'] = project_id unless project_id.nil?
-          command.query['view'] = view unless view.nil?
-          command.query['pageSize'] = page_size unless page_size.nil?
-          command.query['pageToken'] = page_token unless page_token.nil?
-          command.query['startTime'] = start_time unless start_time.nil?
-          command.query['endTime'] = end_time unless end_time.nil?
-          command.query['filter'] = filter unless filter.nil?
           command.query['orderBy'] = order_by unless order_by.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['endTime'] = end_time unless end_time.nil?
+          command.query['startTime'] = start_time unless start_time.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['view'] = view unless view.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)