google-api-client 0.43.0 → 0.48.0

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

@@ -22,13 +22,11 @@ module Google
   module Apis
     module CloudtraceV1
       
-      # 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 ````.
+      # 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
       
@@ -45,9 +43,9 @@ module Google
       class ListTracesResponse
         include Google::Apis::Core::Hashable
       
-        # 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
@@ -68,9 +66,9 @@ 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.
+      # 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
       
@@ -84,9 +82,9 @@ module Google
         # @return [Array<Google::Apis::CloudtraceV1::TraceSpan>]
         attr_accessor :spans
       
-        # Globally unique identifier for the trace. This identifier is a 128-bit
-        # numeric value formatted as a 32-byte hex string. For example,
-        # `382d4f4c6b7bb2f4a972559d9085001d`. The numeric value should not be zero.
+        # Globally unique identifier for the trace. This identifier is a 128-bit numeric
+        # value formatted as a 32-byte hex string. For example, `
+        # 382d4f4c6b7bb2f4a972559d9085001d`. The numeric value should not be zero.
         # Corresponds to the JSON property `traceId`
         # @return [String]
         attr_accessor :trace_id
@@ -103,11 +101,11 @@ module Google
         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.
+      # 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
       
@@ -117,53 +115,33 @@ module Google
         attr_accessor :end_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.
+        # 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 (10MB for
-        # `/stacktrace` values).
-        # Some predefined label keys exist, or you may create your own. When creating
-        # your own, we recommend the following formats:
-        # * `/category/product/key` for agents of well-known products (e.g.
-        # `/db/mongodb/read_size`).
-        # * `short_host/path/key` for domain-specific keys (e.g.
-        # `foo.com/myproduct/bar`)
-        # Predefined labels include:
-        # *   `/agent`
-        # *   `/component`
-        # *   `/error/message`
-        # *   `/error/name`
-        # *   `/http/client_city`
-        # *   `/http/client_country`
-        # *   `/http/client_protocol`
-        # *   `/http/client_region`
-        # *   `/http/host`
-        # *   `/http/method`
-        # *   `/http/path`
-        # *   `/http/redirected_url`
-        # *   `/http/request/size`
-        # *   `/http/response/size`
-        # *   `/http/route`
-        # *   `/http/status_code`
-        # *   `/http/url`
-        # *   `/http/user_agent`
-        # *   `/pid`
-        # *   `/stacktrace`
-        # *   `/tid`
+        # 128 bytes. Label values must be less than 16 kilobytes (10MB for `/stacktrace`
+        # values). Some predefined label keys exist, or you may create your own. When
+        # creating your own, we recommend the following formats: * `/category/product/
+        # key` for agents of well-known products (e.g. `/db/mongodb/read_size`). * `
+        # short_host/path/key` for domain-specific keys (e.g. `foo.com/myproduct/bar`)
+        # Predefined labels include: * `/agent` * `/component` * `/error/message` * `/
+        # error/name` * `/http/client_city` * `/http/client_country` * `/http/
+        # client_protocol` * `/http/client_region` * `/http/host` * `/http/method` * `/
+        # http/path` * `/http/redirected_url` * `/http/request/size` * `/http/response/
+        # size` * `/http/route` * `/http/status_code` * `/http/url` * `/http/user_agent`
+        # * `/pid` * `/stacktrace` * `/tid`
         # 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 Trace tool in the Google Cloud Platform Console.
-        # 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.
+        # Name of the span. Must be less than 128 bytes. The span name is sanitized and
+        # displayed in the Trace tool in the Google Cloud Platform Console. 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
@@ -173,8 +151,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :parent_span_id
       
-        # Identifier for the span. Must be a 64-bit integer other than 0 and
-        # unique within a trace. For example, `2205310701640571284`.
+        # Identifier for the span. Must be a 64-bit integer other than 0 and unique
+        # within a trace. For example, `2205310701640571284`.
         # Corresponds to the JSON property `spanId`
         # @return [Fixnum]
         attr_accessor :span_id

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

@@ -51,11 +51,11 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Sends new traces to Cloud 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 Cloud 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
         #   Required. ID of the Cloud project where the trace data is stored.
         # @param [Google::Apis::CloudtraceV1::Traces] traces_object
@@ -125,61 +125,47 @@ module Google
         # @param [String] project_id
         #   Required. ID of the Cloud project where the trace data is stored.
         # @param [String] end_time
-        #   End of the time interval (inclusive) during which the trace data was
-        #   collected from the application.
+        #   End of the time interval (inclusive) during which the trace data was collected
+        #   from the application.
         # @param [String] filter
-        #   Optional. A filter against labels for the request.
-        #   By default, searches use prefix matching. To specify exact match, prepend
-        #   a plus symbol (`+`) to the search term.
-        #   Multiple terms are ANDed. Syntax:
-        #   *   `root:NAME_PREFIX` or `NAME_PREFIX`: Return traces where any root
-        #   span starts with `NAME_PREFIX`.
-        #   *   `+root:NAME` or `+NAME`: Return traces where any root span's name is
-        #   exactly `NAME`.
-        #   *   `span:NAME_PREFIX`: Return traces where any span starts with
-        #   `NAME_PREFIX`.
-        #   *   `+span:NAME`: Return traces where any span's name is exactly
-        #   `NAME`.
-        #   *   `latency:DURATION`: Return traces whose overall latency is
-        #   greater or equal to than `DURATION`. Accepted units are nanoseconds
-        #   (`ns`), milliseconds (`ms`), and seconds (`s`). Default is `ms`. For
-        #   example, `latency:24ms` returns traces whose overall latency
-        #   is greater than or equal to 24 milliseconds.
-        #   *   `label:LABEL_KEY`: Return all traces containing the specified
-        #   label key (exact match, case-sensitive) regardless of the key:value
-        #   pair's value (including empty values).
-        #   *   `LABEL_KEY:VALUE_PREFIX`: Return all traces containing the specified
-        #   label key (exact match, case-sensitive) whose value starts with
-        #   `VALUE_PREFIX`. Both a key and a value must be specified.
-        #   *   `+LABEL_KEY:VALUE`: Return all traces containing a key:value pair
-        #   exactly matching the specified text. Both a key and a value must be
-        #   specified.
-        #   *   `method:VALUE`: Equivalent to `/http/method:VALUE`.
-        #   *   `url:VALUE`: Equivalent to `/http/url:VALUE`.
+        #   Optional. A filter against labels for the request. By default, searches use
+        #   prefix matching. To specify exact match, prepend a plus symbol (`+`) to the
+        #   search term. Multiple terms are ANDed. Syntax: * `root:NAME_PREFIX` or `
+        #   NAME_PREFIX`: Return traces where any root span starts with `NAME_PREFIX`. * `+
+        #   root:NAME` or `+NAME`: Return traces where any root span's name is exactly `
+        #   NAME`. * `span:NAME_PREFIX`: Return traces where any span starts with `
+        #   NAME_PREFIX`. * `+span:NAME`: Return traces where any span's name is exactly `
+        #   NAME`. * `latency:DURATION`: Return traces whose overall latency is greater or
+        #   equal to than `DURATION`. Accepted units are nanoseconds (`ns`), milliseconds (
+        #   `ms`), and seconds (`s`). Default is `ms`. For example, `latency:24ms` returns
+        #   traces whose overall latency is greater than or equal to 24 milliseconds. * `
+        #   label:LABEL_KEY`: Return all traces containing the specified label key (exact
+        #   match, case-sensitive) regardless of the key:value pair's value (including
+        #   empty values). * `LABEL_KEY:VALUE_PREFIX`: Return all traces containing the
+        #   specified label key (exact match, case-sensitive) whose value starts with `
+        #   VALUE_PREFIX`. Both a key and a value must be specified. * `+LABEL_KEY:VALUE`:
+        #   Return all traces containing a key:value pair exactly matching the specified
+        #   text. Both a key and a value must be specified. * `method:VALUE`: Equivalent
+        #   to `/http/method:VALUE`. * `url:VALUE`: Equivalent to `/http/url:VALUE`.
         # @param [String] order_by
-        #   Optional. Field used to sort the returned traces.
-        #   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.
+        #   Optional. Field used to sort the returned traces. 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 [Fixnum] page_size
         #   Optional. 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.
+        #   implementation selects a reasonable value. The implementation may return fewer
+        #   traces than the requested page size.
         # @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.
+        #   Token identifying the page of results to return. If provided, use the value of
+        #   the `next_page_token` field from a previous request.
         # @param [String] start_time
         #   Start of the time interval (inclusive) during which the trace data was
         #   collected from the application.
         # @param [String] view
-        #   Optional. Type of data returned for traces in the list. Default is
-        #   `MINIMAL`.
+        #   Optional. Type of data returned for traces in the list. Default is `MINIMAL`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

data/generated/google/apis/cloudtrace_v1.rb

@@ -29,7 +29,7 @@ module Google
     # @see https://cloud.google.com/trace
     module CloudtraceV1
       VERSION = 'V1'
-      REVISION = '20200713'
+      REVISION = '20200805'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'