docs: update generated docs (#981)
diff --git a/docs/dyn/cloudtrace_v1.projects.traces.html b/docs/dyn/cloudtrace_v1.projects.traces.html
index da109a9..5854fd4 100644
--- a/docs/dyn/cloudtrace_v1.projects.traces.html
+++ b/docs/dyn/cloudtrace_v1.projects.traces.html
@@ -78,7 +78,7 @@
<code><a href="#get">get(projectId, traceId, x__xgafv=None)</a></code></p>
<p class="firstline">Gets a single trace by its ID.</p>
<p class="toc_element">
- <code><a href="#list">list(projectId, startTime=None, pageToken=None, pageSize=None, view=None, orderBy=None, filter=None, endTime=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(projectId, endTime=None, orderBy=None, view=None, pageToken=None, pageSize=None, startTime=None, filter=None, x__xgafv=None)</a></code></p>
<p class="firstline">Returns of a list of traces that match the specified filter conditions.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -87,8 +87,6 @@
<div class="method">
<code class="details" id="get">get(projectId, traceId, x__xgafv=None)</code>
<pre>Gets a single trace by its ID.
-In this case, getting for traces is considered an active developer method,
-even though it is technically a read-only method.
Args:
projectId: string, Required. ID of the Cloud project where the trace data is stored. (required)
@@ -105,12 +103,29 @@
# operation. It consists of a set of spans, each of which represent a single
# timed event within the operation.
"projectId": "A String", # Project ID of the Cloud project where the trace data is stored.
+ "traceId": "A String", # 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.
"spans": [ # Collection of spans in the 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.
+ "spanId": "A String", # Identifier for the span. Must be a 64-bit integer other than 0 and
+ # unique within a trace. For example, `2205310701640571284`.
+ "kind": "A String", # 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.
+ "startTime": "A String", # Start time of the span in nanoseconds from the UNIX epoch.
+ "name": "A String", # 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.
+ "endTime": "A String", # End time of the span in nanoseconds from the UNIX epoch.
+ "parentSpanId": "A String", # Optional. ID of the parent span, if any.
"labels": { # 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).
@@ -148,46 +163,19 @@
# * `/tid`
"a_key": "A String",
},
- "name": "A String", # Name of the span. Must be less than 128 bytes. The span name is sanitized
- # and displayed in the Stackdriver 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.
- "spanId": "A String", # Identifier for the span. Must be a 64-bit integer other than 0 and
- # unique within a trace. For example, `2205310701640571284`.
- "parentSpanId": "A String", # Optional. ID of the parent span, if any.
- "endTime": "A String", # End time of the span in nanoseconds from the UNIX epoch.
- "startTime": "A String", # Start time of the span in nanoseconds from the UNIX epoch.
- "kind": "A String", # 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.
},
],
- "traceId": "A String", # Globally unique identifier for the trace. This identifier is a 128-bit
- # numeric value formatted as a 32-byte hex string. For example,
- # `382d4f4c6b7bb2f4a972559d9085001d`.
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(projectId, startTime=None, pageToken=None, pageSize=None, view=None, orderBy=None, filter=None, endTime=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(projectId, endTime=None, orderBy=None, view=None, pageToken=None, pageSize=None, startTime=None, filter=None, x__xgafv=None)</code>
<pre>Returns of a list of traces that match the specified filter conditions.
-In this case, listing for traces is considered an active developer method,
-even though it is technically a read-only method.
Args:
projectId: string, Required. ID of the Cloud project where the trace data is stored. (required)
- startTime: string, Start of the time interval (inclusive) during which the trace data was
+ endTime: string, End of the time interval (inclusive) during which the trace data was
collected from the application.
- pageToken: string, Token identifying the page of results to return. If provided, use the
-value of the `next_page_token` field from a previous request.
- pageSize: integer, 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.
- view: string, Optional. Type of data returned for traces in the list. Default is
-`MINIMAL`.
orderBy: string, Optional. Field used to sort the returned traces.
Can be one of the following:
@@ -201,6 +189,15 @@
(for example, `name desc`).
Only one sort field is permitted.
+ view: string, Optional. Type of data returned for traces in the list. Default is
+`MINIMAL`.
+ pageToken: string, Token identifying the page of results to return. If provided, use the
+value of the `next_page_token` field from a previous request.
+ pageSize: integer, 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.
+ startTime: string, Start of the time interval (inclusive) during which the trace data was
+collected from the application.
filter: string, Optional. A filter against labels for the request.
By default, searches use prefix matching. To specify exact match, prepend
@@ -231,8 +228,6 @@
specified.
* `method:VALUE`: Equivalent to `/http/method:VALUE`.
* `url:VALUE`: Equivalent to `/http/url:VALUE`.
- endTime: string, End of the time interval (inclusive) during which the trace data was
-collected from the application.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -242,17 +237,37 @@
An object of the form:
{ # The response message for the `ListTraces` method.
+ "nextPageToken": "A String", # 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.
"traces": [ # List of trace records as specified by the view parameter.
{ # 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.
"projectId": "A String", # Project ID of the Cloud project where the trace data is stored.
+ "traceId": "A String", # 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.
"spans": [ # Collection of spans in the 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.
+ "spanId": "A String", # Identifier for the span. Must be a 64-bit integer other than 0 and
+ # unique within a trace. For example, `2205310701640571284`.
+ "kind": "A String", # 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.
+ "startTime": "A String", # Start time of the span in nanoseconds from the UNIX epoch.
+ "name": "A String", # 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.
+ "endTime": "A String", # End time of the span in nanoseconds from the UNIX epoch.
+ "parentSpanId": "A String", # Optional. ID of the parent span, if any.
"labels": { # 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).
@@ -290,31 +305,10 @@
# * `/tid`
"a_key": "A String",
},
- "name": "A String", # Name of the span. Must be less than 128 bytes. The span name is sanitized
- # and displayed in the Stackdriver 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.
- "spanId": "A String", # Identifier for the span. Must be a 64-bit integer other than 0 and
- # unique within a trace. For example, `2205310701640571284`.
- "parentSpanId": "A String", # Optional. ID of the parent span, if any.
- "endTime": "A String", # End time of the span in nanoseconds from the UNIX epoch.
- "startTime": "A String", # Start time of the span in nanoseconds from the UNIX epoch.
- "kind": "A String", # 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.
},
],
- "traceId": "A String", # Globally unique identifier for the trace. This identifier is a 128-bit
- # numeric value formatted as a 32-byte hex string. For example,
- # `382d4f4c6b7bb2f4a972559d9085001d`.
},
],
- "nextPageToken": "A String", # 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.
}</pre>
</div>