chore: regens API reference docs (#889)
diff --git a/docs/dyn/clouddebugger_v2.controller.debuggees.breakpoints.html b/docs/dyn/clouddebugger_v2.controller.debuggees.breakpoints.html
index 56ecd66..2411149 100644
--- a/docs/dyn/clouddebugger_v2.controller.debuggees.breakpoints.html
+++ b/docs/dyn/clouddebugger_v2.controller.debuggees.breakpoints.html
@@ -72,17 +72,17 @@
</style>
-<h1><a href="clouddebugger_v2.html">Stackdriver Debugger API</a> . <a href="clouddebugger_v2.controller.html">controller</a> . <a href="clouddebugger_v2.controller.debuggees.html">debuggees</a> . <a href="clouddebugger_v2.controller.debuggees.breakpoints.html">breakpoints</a></h1>
+<h1><a href="clouddebugger_v2.html">Cloud Debugger API</a> . <a href="clouddebugger_v2.controller.html">controller</a> . <a href="clouddebugger_v2.controller.debuggees.html">debuggees</a> . <a href="clouddebugger_v2.controller.debuggees.breakpoints.html">breakpoints</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
- <code><a href="#list">list(debuggeeId, waitToken=None, successOnTimeout=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(debuggeeId, agentId=None, waitToken=None, successOnTimeout=None, x__xgafv=None)</a></code></p>
<p class="firstline">Returns the list of all active breakpoints for the debuggee.</p>
<p class="toc_element">
- <code><a href="#update">update(debuggeeId, id, body, x__xgafv=None)</a></code></p>
+ <code><a href="#update">update(debuggeeId, id, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Updates the breakpoint state or mutable fields.</p>
<h3>Method Details</h3>
<div class="method">
- <code class="details" id="list">list(debuggeeId, waitToken=None, successOnTimeout=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(debuggeeId, agentId=None, waitToken=None, successOnTimeout=None, x__xgafv=None)</code>
<pre>Returns the list of all active breakpoints for the debuggee.
The breakpoint specification (`location`, `condition`, and `expressions`
@@ -98,7 +98,9 @@
setting those breakpoints again.
Args:
- debuggeeId: string, Identifies the debuggee. (required)
+ debuggeeId: string, Required. Identifies the debuggee. (required)
+ agentId: string, Identifies the agent.
+This is the ID returned in the RegisterDebuggee response.
waitToken: string, A token that, if specified, blocks the method call until the list
of active breakpoints has changed, or a server-selected timeout has
expired. The value should be set from the `next_wait_token` field in
@@ -125,7 +127,10 @@
# the list of breakpoints changes.
"breakpoints": [ # List of all active breakpoints.
# The fields `id` and `location` are guaranteed to be set on each breakpoint.
- { # Represents the breakpoint specification, status and results.
+ { # ------------------------------------------------------------------------------
+ # ## Breakpoint (the resource)
+ #
+ # Represents the breakpoint specification, status and results.
"status": { # Represents a contextual status message. # Breakpoint status.
#
# The status includes an error flag and a human readable message.
@@ -201,7 +206,7 @@
# 3) A pointer where the pointee was captured:
#
# T x = { 3, 7 };
- # T* p = &x;
+ # T* p = &x;
#
# { // Captured variable
# name: "p",
@@ -223,7 +228,7 @@
# }
#
# The status should describe the reason for the missing value,
- # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+ # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
#
# Note that a null pointer should not have members.
#
@@ -240,7 +245,7 @@
# 6) An unnamed pointer where the pointee was not captured:
#
# int* p = new int(7);
- # int** pp = &p;
+ # int** pp = &p;
#
# { // Captured variable
# name: "pp",
@@ -266,12 +271,12 @@
# When using the shared variable table, the following variables:
#
# T x = { 3, 7 };
- # T* p = &x;
- # T& r = x;
+ # T* p = &x;
+ # T& r = x;
#
# { name: "x", var_table_index: 3, type: "T" } // Captured variables
# { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
- # { name: "r", type="T&", var_table_index: 3 }
+ # { name: "r", type="T&", var_table_index: 3 }
#
# { // Shared variable table entry #3:
# members { name: "m1", value: "3", type: "int" },
@@ -346,6 +351,7 @@
#
# Example: `Message received, id = $0, count = $1` with
# `expressions` = `[ message.id, message.count ]`.
+ "state": "A String", # The current state of the breakpoint.
"logLevel": "A String", # Indicates the severity of the log. Only relevant when action is `LOG`.
"labels": { # A set of custom breakpoint properties, populated by the agent, to be
# displayed to the user.
@@ -384,7 +390,7 @@
# 3) A pointer where the pointee was captured:
#
# T x = { 3, 7 };
- # T* p = &x;
+ # T* p = &x;
#
# { // Captured variable
# name: "p",
@@ -406,7 +412,7 @@
# }
#
# The status should describe the reason for the missing value,
- # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+ # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
#
# Note that a null pointer should not have members.
#
@@ -423,7 +429,7 @@
# 6) An unnamed pointer where the pointee was not captured:
#
# int* p = new int(7);
- # int** pp = &p;
+ # int** pp = &p;
#
# { // Captured variable
# name: "pp",
@@ -449,12 +455,12 @@
# When using the shared variable table, the following variables:
#
# T x = { 3, 7 };
- # T* p = &x;
- # T& r = x;
+ # T* p = &x;
+ # T& r = x;
#
# { name: "x", var_table_index: 3, type: "T" } // Captured variables
# { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
- # { name: "r", type="T&", var_table_index: 3 }
+ # { name: "r", type="T&", var_table_index: 3 }
#
# { // Shared variable table entry #3:
# members { name: "m1", value: "3", type: "int" },
@@ -549,7 +555,7 @@
# 3) A pointer where the pointee was captured:
#
# T x = { 3, 7 };
- # T* p = &x;
+ # T* p = &x;
#
# { // Captured variable
# name: "p",
@@ -571,7 +577,7 @@
# }
#
# The status should describe the reason for the missing value,
- # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+ # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
#
# Note that a null pointer should not have members.
#
@@ -588,7 +594,7 @@
# 6) An unnamed pointer where the pointee was not captured:
#
# int* p = new int(7);
- # int** pp = &p;
+ # int** pp = &p;
#
# { // Captured variable
# name: "pp",
@@ -614,12 +620,12 @@
# When using the shared variable table, the following variables:
#
# T x = { 3, 7 };
- # T* p = &x;
- # T& r = x;
+ # T* p = &x;
+ # T& r = x;
#
# { name: "x", var_table_index: 3, type: "T" } // Captured variables
# { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
- # { name: "r", type="T&", var_table_index: 3 }
+ # { name: "r", type="T&", var_table_index: 3 }
#
# { // Shared variable table entry #3:
# members { name: "m1", value: "3", type: "int" },
@@ -695,6 +701,8 @@
},
],
"createTime": "A String", # Time this breakpoint was created by the server in seconds resolution.
+ "canaryExpireTime": "A String", # The deadline for the breakpoint to stay in CANARY_ACTIVE state. The value
+ # is meaningless when the breakpoint is not in CANARY_ACTIVE state.
"location": { # Represents a location in the source code. # Breakpoint source location.
"column": 42, # Column within a line. The first column in a line as the value `1`.
# Agents that do not support setting breakpoints on specific columns ignore
@@ -748,7 +756,7 @@
# 3) A pointer where the pointee was captured:
#
# T x = { 3, 7 };
- # T* p = &x;
+ # T* p = &x;
#
# { // Captured variable
# name: "p",
@@ -770,7 +778,7 @@
# }
#
# The status should describe the reason for the missing value,
- # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+ # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
#
# Note that a null pointer should not have members.
#
@@ -787,7 +795,7 @@
# 6) An unnamed pointer where the pointee was not captured:
#
# int* p = new int(7);
- # int** pp = &p;
+ # int** pp = &p;
#
# { // Captured variable
# name: "pp",
@@ -813,12 +821,12 @@
# When using the shared variable table, the following variables:
#
# T x = { 3, 7 };
- # T* p = &x;
- # T& r = x;
+ # T* p = &x;
+ # T& r = x;
#
# { name: "x", var_table_index: 3, type: "T" } // Captured variables
# { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
- # { name: "r", type="T&", var_table_index: 3 }
+ # { name: "r", type="T&", var_table_index: 3 }
#
# { // Shared variable table entry #3:
# members { name: "m1", value: "3", type: "int" },
@@ -894,7 +902,7 @@
</div>
<div class="method">
- <code class="details" id="update">update(debuggeeId, id, body, x__xgafv=None)</code>
+ <code class="details" id="update">update(debuggeeId, id, body=None, x__xgafv=None)</code>
<pre>Updates the breakpoint state or mutable fields.
The entire Breakpoint message must be sent back to the controller service.
@@ -905,15 +913,18 @@
or snapping the location to the correct line of code.
Args:
- debuggeeId: string, Identifies the debuggee being debugged. (required)
+ debuggeeId: string, Required. Identifies the debuggee being debugged. (required)
id: string, Breakpoint identifier, unique in the scope of the debuggee. (required)
- body: object, The request body. (required)
+ body: object, The request body.
The object takes the form of:
{ # Request to update an active breakpoint.
- "breakpoint": { # Represents the breakpoint specification, status and results. # Updated breakpoint information.
+ "breakpoint": { # ------------------------------------------------------------------------------ # Required. Updated breakpoint information.
# The field `id` must be set.
# The agent must echo all Breakpoint specification fields in the update.
+ # ## Breakpoint (the resource)
+ #
+ # Represents the breakpoint specification, status and results.
"status": { # Represents a contextual status message. # Breakpoint status.
#
# The status includes an error flag and a human readable message.
@@ -989,7 +1000,7 @@
# 3) A pointer where the pointee was captured:
#
# T x = { 3, 7 };
- # T* p = &x;
+ # T* p = &x;
#
# { // Captured variable
# name: "p",
@@ -1011,7 +1022,7 @@
# }
#
# The status should describe the reason for the missing value,
- # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+ # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
#
# Note that a null pointer should not have members.
#
@@ -1028,7 +1039,7 @@
# 6) An unnamed pointer where the pointee was not captured:
#
# int* p = new int(7);
- # int** pp = &p;
+ # int** pp = &p;
#
# { // Captured variable
# name: "pp",
@@ -1054,12 +1065,12 @@
# When using the shared variable table, the following variables:
#
# T x = { 3, 7 };
- # T* p = &x;
- # T& r = x;
+ # T* p = &x;
+ # T& r = x;
#
# { name: "x", var_table_index: 3, type: "T" } // Captured variables
# { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
- # { name: "r", type="T&", var_table_index: 3 }
+ # { name: "r", type="T&", var_table_index: 3 }
#
# { // Shared variable table entry #3:
# members { name: "m1", value: "3", type: "int" },
@@ -1134,6 +1145,7 @@
#
# Example: `Message received, id = $0, count = $1` with
# `expressions` = `[ message.id, message.count ]`.
+ "state": "A String", # The current state of the breakpoint.
"logLevel": "A String", # Indicates the severity of the log. Only relevant when action is `LOG`.
"labels": { # A set of custom breakpoint properties, populated by the agent, to be
# displayed to the user.
@@ -1172,7 +1184,7 @@
# 3) A pointer where the pointee was captured:
#
# T x = { 3, 7 };
- # T* p = &x;
+ # T* p = &x;
#
# { // Captured variable
# name: "p",
@@ -1194,7 +1206,7 @@
# }
#
# The status should describe the reason for the missing value,
- # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+ # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
#
# Note that a null pointer should not have members.
#
@@ -1211,7 +1223,7 @@
# 6) An unnamed pointer where the pointee was not captured:
#
# int* p = new int(7);
- # int** pp = &p;
+ # int** pp = &p;
#
# { // Captured variable
# name: "pp",
@@ -1237,12 +1249,12 @@
# When using the shared variable table, the following variables:
#
# T x = { 3, 7 };
- # T* p = &x;
- # T& r = x;
+ # T* p = &x;
+ # T& r = x;
#
# { name: "x", var_table_index: 3, type: "T" } // Captured variables
# { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
- # { name: "r", type="T&", var_table_index: 3 }
+ # { name: "r", type="T&", var_table_index: 3 }
#
# { // Shared variable table entry #3:
# members { name: "m1", value: "3", type: "int" },
@@ -1337,7 +1349,7 @@
# 3) A pointer where the pointee was captured:
#
# T x = { 3, 7 };
- # T* p = &x;
+ # T* p = &x;
#
# { // Captured variable
# name: "p",
@@ -1359,7 +1371,7 @@
# }
#
# The status should describe the reason for the missing value,
- # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+ # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
#
# Note that a null pointer should not have members.
#
@@ -1376,7 +1388,7 @@
# 6) An unnamed pointer where the pointee was not captured:
#
# int* p = new int(7);
- # int** pp = &p;
+ # int** pp = &p;
#
# { // Captured variable
# name: "pp",
@@ -1402,12 +1414,12 @@
# When using the shared variable table, the following variables:
#
# T x = { 3, 7 };
- # T* p = &x;
- # T& r = x;
+ # T* p = &x;
+ # T& r = x;
#
# { name: "x", var_table_index: 3, type: "T" } // Captured variables
# { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
- # { name: "r", type="T&", var_table_index: 3 }
+ # { name: "r", type="T&", var_table_index: 3 }
#
# { // Shared variable table entry #3:
# members { name: "m1", value: "3", type: "int" },
@@ -1483,6 +1495,8 @@
},
],
"createTime": "A String", # Time this breakpoint was created by the server in seconds resolution.
+ "canaryExpireTime": "A String", # The deadline for the breakpoint to stay in CANARY_ACTIVE state. The value
+ # is meaningless when the breakpoint is not in CANARY_ACTIVE state.
"location": { # Represents a location in the source code. # Breakpoint source location.
"column": 42, # Column within a line. The first column in a line as the value `1`.
# Agents that do not support setting breakpoints on specific columns ignore
@@ -1536,7 +1550,7 @@
# 3) A pointer where the pointee was captured:
#
# T x = { 3, 7 };
- # T* p = &x;
+ # T* p = &x;
#
# { // Captured variable
# name: "p",
@@ -1558,7 +1572,7 @@
# }
#
# The status should describe the reason for the missing value,
- # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
+ # such as `<optimized out>`, `<inaccessible>`, `<pointers limit reached>`.
#
# Note that a null pointer should not have members.
#
@@ -1575,7 +1589,7 @@
# 6) An unnamed pointer where the pointee was not captured:
#
# int* p = new int(7);
- # int** pp = &p;
+ # int** pp = &p;
#
# { // Captured variable
# name: "pp",
@@ -1601,12 +1615,12 @@
# When using the shared variable table, the following variables:
#
# T x = { 3, 7 };
- # T* p = &x;
- # T& r = x;
+ # T* p = &x;
+ # T& r = x;
#
# { name: "x", var_table_index: 3, type: "T" } // Captured variables
# { name: "p", value "0x00500500", type="T*", var_table_index: 3 }
- # { name: "r", type="T&", var_table_index: 3 }
+ # { name: "r", type="T&", var_table_index: 3 }
#
# { // Shared variable table entry #3:
# members { name: "m1", value: "3", type: "int" },