1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
|
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="clouddebugger_v2.html">Stackdriver Debugger API</a> . <a href="clouddebugger_v2.debugger.html">debugger</a> . <a href="clouddebugger_v2.debugger.debuggees.html">debuggees</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="clouddebugger_v2.debugger.debuggees.breakpoints.html">breakpoints()</a></code>
</p>
<p class="firstline">Returns the breakpoints Resource.</p>
<p class="toc_element">
<code><a href="#list">list(clientVersion=None, includeInactive=None, project=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists all the debuggees that the user has access to.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="list">list(clientVersion=None, includeInactive=None, project=None, x__xgafv=None)</code>
<pre>Lists all the debuggees that the user has access to.
Args:
clientVersion: string, The client version making the call.
Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
includeInactive: boolean, When set to `true`, the result includes all debuggees. Otherwise, the
result includes only debuggees that are active.
project: string, Project number of a Google Cloud project whose debuggees to list.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response for listing debuggees.
"debuggees": [ # List of debuggees accessible to the calling user.
# The fields `debuggee.id` and `description` are guaranteed to be set.
# The `description` field is a human readable field provided by agents and
# can be displayed to users.
{ # Represents the debugged application. The application may include one or more
# replicated processes executing the same code. Each of these processes is
# attached with a debugger agent, carrying out the debugging commands.
# Agents attached to the same debuggee identify themselves as such by using
# exactly the same Debuggee message value when registering.
"status": { # Represents a contextual status message. # Human readable message to be displayed to the user about this debuggee.
# Absence of this field indicates no status. The message can be either
# informational or an error status.
# The message can indicate an error or informational status, and refer to
# specific parts of the containing object.
# For example, the `Breakpoint.status` field can indicate an error referring
# to the `BREAKPOINT_SOURCE_LOCATION` with the message `Location not found`.
"isError": True or False, # Distinguishes errors from informational messages.
"refersTo": "A String", # Reference to which the message applies.
"description": { # Represents a message with parameters. # Status message text.
"parameters": [ # Optional parameters to be embedded into the message.
"A String",
],
"format": "A String", # Format template for the message. The `format` uses placeholders `$0`,
# `$1`, etc. to reference parameters. `$$` can be used to denote the `$`
# character.
#
# Examples:
#
# * `Failed to load '$0' which helps debug $1 the first time it
# is loaded. Again, $0 is very important.`
# * `Please pay $$10 to use $0 instead of $1.`
},
},
"description": "A String", # Human readable description of the debuggee.
# Including a human-readable project name, environment name and version
# information is recommended.
"isDisabled": True or False, # If set to `true`, indicates that the agent should disable itself and
# detach from the debuggee.
"labels": { # A set of custom debuggee properties, populated by the agent, to be
# displayed to the user.
"a_key": "A String",
},
"uniquifier": "A String", # Uniquifier to further distinguish the application.
# It is possible that different applications might have identical values in
# the debuggee message, thus, incorrectly identified as a single application
# by the Controller service. This field adds salt to further distinguish the
# application. Agents should consider seeding this field with value that
# identifies the code, binary, configuration and environment.
"project": "A String", # Project the debuggee is associated with.
# Use project number or id when registering a Google Cloud Platform project.
"sourceContexts": [ # References to the locations and revisions of the source code used in the
# deployed application.
{ # A SourceContext is a reference to a tree of files. A SourceContext together
# with a path point to a unique revision of a single file or directory.
"cloudWorkspace": { # A CloudWorkspaceSourceContext denotes a workspace at a particular snapshot. # A SourceContext referring to a snapshot in a cloud workspace.
"snapshotId": "A String", # The ID of the snapshot.
# An empty snapshot_id refers to the most recent snapshot.
"workspaceId": { # A CloudWorkspaceId is a unique identifier for a cloud workspace. # The ID of the workspace.
# A cloud workspace is a place associated with a repo where modified files
# can be stored before they are committed.
"name": "A String", # The unique name of the workspace within the repo. This is the name
# chosen by the client in the Source API's CreateWorkspace method.
"repoId": { # A unique identifier for a cloud repo. # The ID of the repo containing the workspace.
"uid": "A String", # A server-assigned, globally unique identifier.
"projectRepoId": { # Selects a repo using a Google Cloud Platform project ID # A combination of a project ID and a repo name.
# (e.g. winged-cargo-31) and a repo name within that project.
"projectId": "A String", # The ID of the project.
"repoName": "A String", # The name of the repo. Leave empty for the default repo.
},
},
},
},
"cloudRepo": { # A CloudRepoSourceContext denotes a particular revision in a cloud # A SourceContext referring to a revision in a cloud repo.
# repo (a repo hosted by the Google Cloud Platform).
"aliasContext": { # An alias to a repo revision. # An alias, which may be a branch or tag.
"kind": "A String", # The alias kind.
"name": "A String", # The alias name.
},
"revisionId": "A String", # A revision ID.
"aliasName": "A String", # The name of an alias (branch, tag, etc.).
"repoId": { # A unique identifier for a cloud repo. # The ID of the repo.
"uid": "A String", # A server-assigned, globally unique identifier.
"projectRepoId": { # Selects a repo using a Google Cloud Platform project ID # A combination of a project ID and a repo name.
# (e.g. winged-cargo-31) and a repo name within that project.
"projectId": "A String", # The ID of the project.
"repoName": "A String", # The name of the repo. Leave empty for the default repo.
},
},
},
"git": { # A GitSourceContext denotes a particular revision in a third party Git # A SourceContext referring to any third party Git repo (e.g. GitHub).
# repository (e.g. GitHub).
"url": "A String", # Git repository URL.
"revisionId": "A String", # Git commit hash.
# required.
},
"gerrit": { # A SourceContext referring to a Gerrit project. # A SourceContext referring to a Gerrit project.
"aliasContext": { # An alias to a repo revision. # An alias, which may be a branch or tag.
"kind": "A String", # The alias kind.
"name": "A String", # The alias name.
},
"revisionId": "A String", # A revision (commit) ID.
"gerritProject": "A String", # The full project name within the host. Projects may be nested, so
# "project/subproject" is a valid project name.
# The "repo name" is hostURI/project.
"hostUri": "A String", # The URI of a running Gerrit instance.
"aliasName": "A String", # The name of an alias (branch, tag, etc.).
},
},
],
"extSourceContexts": [ # References to the locations and revisions of the source code used in the
# deployed application.
{ # An ExtendedSourceContext is a SourceContext combined with additional
# details describing the context.
"labels": { # Labels with user defined metadata.
"a_key": "A String",
},
"context": { # A SourceContext is a reference to a tree of files. A SourceContext together # Any source context.
# with a path point to a unique revision of a single file or directory.
"cloudWorkspace": { # A CloudWorkspaceSourceContext denotes a workspace at a particular snapshot. # A SourceContext referring to a snapshot in a cloud workspace.
"snapshotId": "A String", # The ID of the snapshot.
# An empty snapshot_id refers to the most recent snapshot.
"workspaceId": { # A CloudWorkspaceId is a unique identifier for a cloud workspace. # The ID of the workspace.
# A cloud workspace is a place associated with a repo where modified files
# can be stored before they are committed.
"name": "A String", # The unique name of the workspace within the repo. This is the name
# chosen by the client in the Source API's CreateWorkspace method.
"repoId": { # A unique identifier for a cloud repo. # The ID of the repo containing the workspace.
"uid": "A String", # A server-assigned, globally unique identifier.
"projectRepoId": { # Selects a repo using a Google Cloud Platform project ID # A combination of a project ID and a repo name.
# (e.g. winged-cargo-31) and a repo name within that project.
"projectId": "A String", # The ID of the project.
"repoName": "A String", # The name of the repo. Leave empty for the default repo.
},
},
},
},
"cloudRepo": { # A CloudRepoSourceContext denotes a particular revision in a cloud # A SourceContext referring to a revision in a cloud repo.
# repo (a repo hosted by the Google Cloud Platform).
"aliasContext": { # An alias to a repo revision. # An alias, which may be a branch or tag.
"kind": "A String", # The alias kind.
"name": "A String", # The alias name.
},
"revisionId": "A String", # A revision ID.
"aliasName": "A String", # The name of an alias (branch, tag, etc.).
"repoId": { # A unique identifier for a cloud repo. # The ID of the repo.
"uid": "A String", # A server-assigned, globally unique identifier.
"projectRepoId": { # Selects a repo using a Google Cloud Platform project ID # A combination of a project ID and a repo name.
# (e.g. winged-cargo-31) and a repo name within that project.
"projectId": "A String", # The ID of the project.
"repoName": "A String", # The name of the repo. Leave empty for the default repo.
},
},
},
"git": { # A GitSourceContext denotes a particular revision in a third party Git # A SourceContext referring to any third party Git repo (e.g. GitHub).
# repository (e.g. GitHub).
"url": "A String", # Git repository URL.
"revisionId": "A String", # Git commit hash.
# required.
},
"gerrit": { # A SourceContext referring to a Gerrit project. # A SourceContext referring to a Gerrit project.
"aliasContext": { # An alias to a repo revision. # An alias, which may be a branch or tag.
"kind": "A String", # The alias kind.
"name": "A String", # The alias name.
},
"revisionId": "A String", # A revision (commit) ID.
"gerritProject": "A String", # The full project name within the host. Projects may be nested, so
# "project/subproject" is a valid project name.
# The "repo name" is hostURI/project.
"hostUri": "A String", # The URI of a running Gerrit instance.
"aliasName": "A String", # The name of an alias (branch, tag, etc.).
},
},
},
],
"agentVersion": "A String", # Version ID of the agent.
# Schema: `domain/language-platform/vmajor.minor` (for example
# `google.com/java-gcp/v1.1`).
"isInactive": True or False, # If set to `true`, indicates that Controller service does not detect any
# activity from the debuggee agents and the application is possibly stopped.
"id": "A String", # Unique identifier for the debuggee generated by the controller service.
},
],
}</pre>
</div>
</body></html>
|
