chore: regens API reference docs (#889)
diff --git a/docs/dyn/cloudtrace_v1.projects.traces.html b/docs/dyn/cloudtrace_v1.projects.traces.html
index 1afb0f5..13df879 100644
--- a/docs/dyn/cloudtrace_v1.projects.traces.html
+++ b/docs/dyn/cloudtrace_v1.projects.traces.html
@@ -72,7 +72,7 @@
</style>
-<h1><a href="cloudtrace_v1.html">Stackdriver Trace API</a> . <a href="cloudtrace_v1.projects.html">projects</a> . <a href="cloudtrace_v1.projects.traces.html">traces</a></h1>
+<h1><a href="cloudtrace_v1.html">Cloud Trace API</a> . <a href="cloudtrace_v1.projects.html">projects</a> . <a href="cloudtrace_v1.projects.traces.html">traces</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#get">get(projectId, traceId, x__xgafv=None)</a></code></p>
@@ -87,10 +87,12 @@
<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, ID of the Cloud project where the trace data is stored. (required)
- traceId: string, ID of the trace to return. (required)
+ projectId: string, Required. ID of the Cloud project where the trace data is stored. (required)
+ traceId: string, Required. ID of the trace to return. (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -159,7 +161,7 @@
# * `/tid`
"a_key": "A String",
},
- "parentSpanId": "A String", # ID of the parent span, if any. Optional.
+ "parentSpanId": "A String", # Optional. ID of the parent span, if any.
"startTime": "A String", # Start time of the span in nanoseconds from the UNIX epoch.
"spanId": "A String", # Identifier for the span. Must be a 64-bit integer other than 0 and
# unique within a trace. For example, `2205310701640571284`.
@@ -172,10 +174,12 @@
<div class="method">
<code class="details" id="list">list(projectId, orderBy=None, startTime=None, pageSize=None, x__xgafv=None, pageToken=None, filter=None, endTime=None, view=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, ID of the Cloud project where the trace data is stored. (required)
- orderBy: string, Field used to sort the returned traces. Optional.
+ projectId: string, Required. ID of the Cloud project where the trace data is stored. (required)
+ orderBy: string, Optional. Field used to sort the returned traces.
Can be one of the following:
* `trace_id`
@@ -190,16 +194,16 @@
Only one sort field is permitted.
startTime: string, Start of the time interval (inclusive) during which the trace data was
collected from the application.
- pageSize: integer, Maximum number of traces to return. If not specified or <= 0, the
+ 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. Optional.
+return fewer traces than the requested page size.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
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. Optional.
- filter: string, An optional filter against labels for the request.
+value of the `next_page_token` field from a previous request.
+ filter: string, 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.
@@ -231,7 +235,7 @@
* `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.
- view: string, Type of data returned for traces in the list. Optional. Default is
+ view: string, Optional. Type of data returned for traces in the list. Default is
`MINIMAL`.
Returns:
@@ -302,7 +306,7 @@
# * `/tid`
"a_key": "A String",
},
- "parentSpanId": "A String", # ID of the parent span, if any. Optional.
+ "parentSpanId": "A String", # Optional. ID of the parent span, if any.
"startTime": "A String", # Start time of the span in nanoseconds from the UNIX epoch.
"spanId": "A String", # Identifier for the span. Must be a 64-bit integer other than 0 and
# unique within a trace. For example, `2205310701640571284`.