Updates the breakpoint state or mutable fields. The entire Breakpoint message must be sent back to the controller service.
Updates to active breakpoint fields are only allowed if the new value does not change the breakpoint specification. Updates to the location
, condition
and expressions
fields should not alter the breakpoint semantics. These may only make changes such as canonicalizing a value or snapping the location to the correct line of code.
HTTP request
PUT https://clouddebugger.googleapis.com/v2/controller/debuggees/{debuggeeId}/breakpoints/{breakpoint.id}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
debuggeeId |
Required. Identifies the debuggee being debugged. |
breakpoint.id |
Breakpoint identifier, unique in the scope of the debuggee. |
Request body
The request body contains data with the following structure:
JSON representation |
---|
{ "breakpoint": { "id": string, "action": enum ( |
Fields | |
---|---|
breakpoint.action |
Action that the agent should perform when the code at the breakpoint location is hit. |
breakpoint.location |
Breakpoint source location. |
breakpoint.condition |
Condition that triggers the breakpoint. The condition is a compound boolean expression composed using expressions in a programming language at the source location. |
breakpoint.expressions[] |
List of read-only expressions to evaluate at the breakpoint location. The expressions are composed using expressions in the programming language at the source location. If the breakpoint action is |
breakpoint.logMessageFormat |
Only relevant when action is Example: |
breakpoint.logLevel |
Indicates the severity of the log. Only relevant when action is |
breakpoint.isFinalState |
When true, indicates that this is a final result and the breakpoint state will not change from here on. |
breakpoint.createTime |
Time this breakpoint was created by the server in seconds resolution. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
breakpoint.finalTime |
Time this breakpoint was finalized as seen by the server in seconds resolution. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
breakpoint.userEmail |
E-mail address of the user that created this breakpoint |
breakpoint.status |
Breakpoint status. The status includes an error flag and a human readable message. This field is usually unset. The message can be either informational or an error message. Regardless, clients should always display the text message back to the user. Error status indicates complete failure of the breakpoint. Example (non-final state): Examples (final state):
|
breakpoint.stackFrames[] |
The stack at breakpoint time, where stackFrames[0] represents the most recently entered function. |
breakpoint.evaluatedExpressions[] |
Values of evaluated expressions at breakpoint time. The evaluated expressions appear in exactly the same order they are listed in the |
breakpoint.variableTable[] |
The The variable |
breakpoint.labels |
A set of custom breakpoint properties, populated by the agent, to be displayed to the user. An object containing a list of |
breakpoint.canaryExpireTime |
The deadline for the breakpoint to stay in CANARY_ACTIVE state. The value is meaningless when the breakpoint is not in CANARY_ACTIVE state. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
breakpoint.state |
The current state of the breakpoint. |
Response body
If successful, the response body is empty.
Authorization Scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/cloud_debugger
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.