blob: bce7aee3c6d472deaa8daa76c92df2530a8ea409 [file] [log] [blame]
Takashi Matsuo06694102015-09-11 13:55:40 -07001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
Dan O'Mearadd494642020-05-01 07:42:23 -070075<h1><a href="clouddebugger_v2.html">Cloud Debugger API</a> . <a href="clouddebugger_v2.debugger.html">debugger</a> . <a href="clouddebugger_v2.debugger.debuggees.html">debuggees</a></h1>
Takashi Matsuo06694102015-09-11 13:55:40 -070076<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="clouddebugger_v2.debugger.debuggees.breakpoints.html">breakpoints()</a></code>
79</p>
80<p class="firstline">Returns the breakpoints Resource.</p>
81
82<p class="toc_element">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070083 <code><a href="#close">close()</a></code></p>
84<p class="firstline">Close httplib2 connections.</p>
85<p class="toc_element">
Yoshi Automation Botb6971b02020-11-26 17:16:03 -080086 <code><a href="#list">list(includeInactive=None, project=None, clientVersion=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070087<p class="firstline">Lists all the debuggees that the user has access to.</p>
Takashi Matsuo06694102015-09-11 13:55:40 -070088<h3>Method Details</h3>
89<div class="method">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070090 <code class="details" id="close">close()</code>
91 <pre>Close httplib2 connections.</pre>
92</div>
93
94<div class="method">
Yoshi Automation Botb6971b02020-11-26 17:16:03 -080095 <code class="details" id="list">list(includeInactive=None, project=None, clientVersion=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070096 <pre>Lists all the debuggees that the user has access to.
Takashi Matsuo06694102015-09-11 13:55:40 -070097
98Args:
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070099 includeInactive: boolean, When set to `true`, the result includes all debuggees. Otherwise, the result includes only debuggees that are active.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800100 project: string, Required. Project number of a Google Cloud project whose debuggees to list.
101 clientVersion: string, Required. The client version making the call. Schema: `domain/type/version` (e.g., `google.com/intellij/v1`).
Takashi Matsuo06694102015-09-11 13:55:40 -0700102 x__xgafv: string, V1 error format.
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -0400103 Allowed values
104 1 - v1 error format
105 2 - v2 error format
Takashi Matsuo06694102015-09-11 13:55:40 -0700106
107Returns:
108 An object of the form:
109
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800110 { # Response for listing debuggees.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700111 &quot;debuggees&quot;: [ # 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.
112 { # 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.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800113 &quot;description&quot;: &quot;A String&quot;, # Human readable description of the debuggee. Including a human-readable project name, environment name and version information is recommended.
114 &quot;isInactive&quot;: 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.
115 &quot;labels&quot;: { # A set of custom debuggee properties, populated by the agent, to be displayed to the user.
116 &quot;a_key&quot;: &quot;A String&quot;,
117 },
118 &quot;canaryMode&quot;: &quot;A String&quot;, # Used when setting breakpoint canary for this debuggee.
119 &quot;isDisabled&quot;: True or False, # If set to `true`, indicates that the agent should disable itself and detach from the debuggee.
120 &quot;uniquifier&quot;: &quot;A String&quot;, # 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.
121 &quot;sourceContexts&quot;: [ # References to the locations and revisions of the source code used in the deployed application.
122 { # 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.
123 &quot;git&quot;: { # A GitSourceContext denotes a particular revision in a third party Git repository (e.g. GitHub). # A SourceContext referring to any third party Git repo (e.g. GitHub).
124 &quot;revisionId&quot;: &quot;A String&quot;, # Git commit hash. required.
125 &quot;url&quot;: &quot;A String&quot;, # Git repository URL.
126 },
127 &quot;gerrit&quot;: { # A SourceContext referring to a Gerrit project. # A SourceContext referring to a Gerrit project.
128 &quot;revisionId&quot;: &quot;A String&quot;, # A revision (commit) ID.
129 &quot;aliasName&quot;: &quot;A String&quot;, # The name of an alias (branch, tag, etc.).
130 &quot;aliasContext&quot;: { # An alias to a repo revision. # An alias, which may be a branch or tag.
131 &quot;name&quot;: &quot;A String&quot;, # The alias name.
132 &quot;kind&quot;: &quot;A String&quot;, # The alias kind.
133 },
134 &quot;hostUri&quot;: &quot;A String&quot;, # The URI of a running Gerrit instance.
135 &quot;gerritProject&quot;: &quot;A String&quot;, # The full project name within the host. Projects may be nested, so &quot;project/subproject&quot; is a valid project name. The &quot;repo name&quot; is hostURI/project.
136 },
137 &quot;cloudWorkspace&quot;: { # A CloudWorkspaceSourceContext denotes a workspace at a particular snapshot. # A SourceContext referring to a snapshot in a cloud workspace.
138 &quot;workspaceId&quot;: { # A CloudWorkspaceId is a unique identifier for a cloud workspace. A cloud workspace is a place associated with a repo where modified files can be stored before they are committed. # The ID of the workspace.
139 &quot;name&quot;: &quot;A String&quot;, # The unique name of the workspace within the repo. This is the name chosen by the client in the Source API&#x27;s CreateWorkspace method.
140 &quot;repoId&quot;: { # A unique identifier for a cloud repo. # The ID of the repo containing the workspace.
141 &quot;projectRepoId&quot;: { # Selects a repo using a Google Cloud Platform project ID (e.g. winged-cargo-31) and a repo name within that project. # A combination of a project ID and a repo name.
142 &quot;repoName&quot;: &quot;A String&quot;, # The name of the repo. Leave empty for the default repo.
143 &quot;projectId&quot;: &quot;A String&quot;, # The ID of the project.
144 },
145 &quot;uid&quot;: &quot;A String&quot;, # A server-assigned, globally unique identifier.
146 },
147 },
148 &quot;snapshotId&quot;: &quot;A String&quot;, # The ID of the snapshot. An empty snapshot_id refers to the most recent snapshot.
149 },
150 &quot;cloudRepo&quot;: { # A CloudRepoSourceContext denotes a particular revision in a cloud repo (a repo hosted by the Google Cloud Platform). # A SourceContext referring to a revision in a cloud repo.
151 &quot;aliasName&quot;: &quot;A String&quot;, # The name of an alias (branch, tag, etc.).
152 &quot;aliasContext&quot;: { # An alias to a repo revision. # An alias, which may be a branch or tag.
153 &quot;name&quot;: &quot;A String&quot;, # The alias name.
154 &quot;kind&quot;: &quot;A String&quot;, # The alias kind.
155 },
156 &quot;revisionId&quot;: &quot;A String&quot;, # A revision ID.
157 &quot;repoId&quot;: { # A unique identifier for a cloud repo. # The ID of the repo.
158 &quot;projectRepoId&quot;: { # Selects a repo using a Google Cloud Platform project ID (e.g. winged-cargo-31) and a repo name within that project. # A combination of a project ID and a repo name.
159 &quot;repoName&quot;: &quot;A String&quot;, # The name of the repo. Leave empty for the default repo.
160 &quot;projectId&quot;: &quot;A String&quot;, # The ID of the project.
161 },
162 &quot;uid&quot;: &quot;A String&quot;, # A server-assigned, globally unique identifier.
163 },
164 },
165 },
166 ],
167 &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the debuggee generated by the controller service.
168 &quot;extSourceContexts&quot;: [ # References to the locations and revisions of the source code used in the deployed application.
169 { # An ExtendedSourceContext is a SourceContext combined with additional details describing the context.
170 &quot;context&quot;: { # 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. # Any source context.
171 &quot;git&quot;: { # A GitSourceContext denotes a particular revision in a third party Git repository (e.g. GitHub). # A SourceContext referring to any third party Git repo (e.g. GitHub).
172 &quot;revisionId&quot;: &quot;A String&quot;, # Git commit hash. required.
173 &quot;url&quot;: &quot;A String&quot;, # Git repository URL.
174 },
175 &quot;gerrit&quot;: { # A SourceContext referring to a Gerrit project. # A SourceContext referring to a Gerrit project.
176 &quot;revisionId&quot;: &quot;A String&quot;, # A revision (commit) ID.
177 &quot;aliasName&quot;: &quot;A String&quot;, # The name of an alias (branch, tag, etc.).
178 &quot;aliasContext&quot;: { # An alias to a repo revision. # An alias, which may be a branch or tag.
179 &quot;name&quot;: &quot;A String&quot;, # The alias name.
180 &quot;kind&quot;: &quot;A String&quot;, # The alias kind.
181 },
182 &quot;hostUri&quot;: &quot;A String&quot;, # The URI of a running Gerrit instance.
183 &quot;gerritProject&quot;: &quot;A String&quot;, # The full project name within the host. Projects may be nested, so &quot;project/subproject&quot; is a valid project name. The &quot;repo name&quot; is hostURI/project.
184 },
185 &quot;cloudWorkspace&quot;: { # A CloudWorkspaceSourceContext denotes a workspace at a particular snapshot. # A SourceContext referring to a snapshot in a cloud workspace.
186 &quot;workspaceId&quot;: { # A CloudWorkspaceId is a unique identifier for a cloud workspace. A cloud workspace is a place associated with a repo where modified files can be stored before they are committed. # The ID of the workspace.
187 &quot;name&quot;: &quot;A String&quot;, # The unique name of the workspace within the repo. This is the name chosen by the client in the Source API&#x27;s CreateWorkspace method.
188 &quot;repoId&quot;: { # A unique identifier for a cloud repo. # The ID of the repo containing the workspace.
189 &quot;projectRepoId&quot;: { # Selects a repo using a Google Cloud Platform project ID (e.g. winged-cargo-31) and a repo name within that project. # A combination of a project ID and a repo name.
190 &quot;repoName&quot;: &quot;A String&quot;, # The name of the repo. Leave empty for the default repo.
191 &quot;projectId&quot;: &quot;A String&quot;, # The ID of the project.
192 },
193 &quot;uid&quot;: &quot;A String&quot;, # A server-assigned, globally unique identifier.
194 },
195 },
196 &quot;snapshotId&quot;: &quot;A String&quot;, # The ID of the snapshot. An empty snapshot_id refers to the most recent snapshot.
197 },
198 &quot;cloudRepo&quot;: { # A CloudRepoSourceContext denotes a particular revision in a cloud repo (a repo hosted by the Google Cloud Platform). # A SourceContext referring to a revision in a cloud repo.
199 &quot;aliasName&quot;: &quot;A String&quot;, # The name of an alias (branch, tag, etc.).
200 &quot;aliasContext&quot;: { # An alias to a repo revision. # An alias, which may be a branch or tag.
201 &quot;name&quot;: &quot;A String&quot;, # The alias name.
202 &quot;kind&quot;: &quot;A String&quot;, # The alias kind.
203 },
204 &quot;revisionId&quot;: &quot;A String&quot;, # A revision ID.
205 &quot;repoId&quot;: { # A unique identifier for a cloud repo. # The ID of the repo.
206 &quot;projectRepoId&quot;: { # Selects a repo using a Google Cloud Platform project ID (e.g. winged-cargo-31) and a repo name within that project. # A combination of a project ID and a repo name.
207 &quot;repoName&quot;: &quot;A String&quot;, # The name of the repo. Leave empty for the default repo.
208 &quot;projectId&quot;: &quot;A String&quot;, # The ID of the project.
209 },
210 &quot;uid&quot;: &quot;A String&quot;, # A server-assigned, globally unique identifier.
211 },
212 },
213 },
214 &quot;labels&quot;: { # Labels with user defined metadata.
215 &quot;a_key&quot;: &quot;A String&quot;,
216 },
217 },
218 ],
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800219 &quot;agentVersion&quot;: &quot;A String&quot;, # Version ID of the agent. Schema: `domain/language-platform/vmajor.minor` (for example `google.com/java-gcp/v1.1`).
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700220 &quot;status&quot;: { # Represents a contextual status message. 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`. # 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.
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800221 &quot;refersTo&quot;: &quot;A String&quot;, # Reference to which the message applies.
222 &quot;isError&quot;: True or False, # Distinguishes errors from informational messages.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700223 &quot;description&quot;: { # Represents a message with parameters. # Status message text.
224 &quot;format&quot;: &quot;A String&quot;, # 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 &#x27;$0&#x27; which helps debug $1 the first time it is loaded. Again, $0 is very important.` * `Please pay $$10 to use $0 instead of $1.`
225 &quot;parameters&quot;: [ # Optional parameters to be embedded into the message.
226 &quot;A String&quot;,
227 ],
228 },
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700229 },
230 &quot;project&quot;: &quot;A String&quot;, # Project the debuggee is associated with. Use project number or id when registering a Google Cloud Platform project.
Takashi Matsuo06694102015-09-11 13:55:40 -0700231 },
232 ],
233 }</pre>
234</div>
235
236</body></html>