Regen all docs. (#700)
* Stop recursing if discovery == {}
* Generate docs with 'make docs'.
diff --git a/docs/dyn/clouddebugger_v2.debugger.debuggees.html b/docs/dyn/clouddebugger_v2.debugger.debuggees.html
index f048b0d..a5efc61 100644
--- a/docs/dyn/clouddebugger_v2.debugger.debuggees.html
+++ b/docs/dyn/clouddebugger_v2.debugger.debuggees.html
@@ -81,15 +81,15 @@
<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 can set breakpoints to.</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 can set breakpoints to.
+ <pre>Lists all the debuggees that the user has access to.
Args:
clientVersion: string, The client version making the call.
-Following: `domain/type/version` (e.g., `google.com/intellij/v1`).
+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.
@@ -103,15 +103,14 @@
{ # Response for listing debuggees.
"debuggees": [ # List of debuggees accessible to the calling user.
- # Note that the `description` field is the only human readable field
- # that should be displayed to the user.
- # The fields `debuggee.id` and `description` fields are guaranteed to be
- # set on each debuggee.
- { # Represents the application to debug. The application may include one or more
+ # 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.
- # The agents attached to the same debuggee are identified by using exactly the
- # same field values when registering.
+ # 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.
@@ -145,17 +144,16 @@
# displayed to the user.
"a_key": "A String",
},
- "uniquifier": "A String", # Debuggee uniquifier within the project.
- # Any string that identifies the application within the project can be used.
- # Including environment and version or build IDs is recommended.
+ "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 the project number when registering a Google Cloud Platform project.
+ # 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.
- #
- # NOTE: This field is deprecated. Consumers should use
- # `ext_source_contexts` if it is not empty. Debug agents should populate
- # both this field and `ext_source_contexts`.
{ # 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.
@@ -167,12 +165,12 @@
"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.
},
- "uid": "A String", # A server-assigned, globally unique identifier.
},
},
},
@@ -185,12 +183,12 @@
"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.
},
- "uid": "A String", # A server-assigned, globally unique identifier.
},
},
"git": { # A GitSourceContext denotes a particular revision in a third party Git # A SourceContext referring to any third party Git repo (e.g. GitHub).
@@ -205,20 +203,16 @@
"name": "A String", # The alias name.
},
"revisionId": "A String", # A revision (commit) ID.
- "hostUri": "A String", # The URI of a running Gerrit instance.
- "aliasName": "A String", # The name of an alias (branch, tag, etc.).
"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.
- #
- # Contexts describing a remote repo related to the source code
- # have a `category` label of `remote_repo`. Source snapshot source
- # contexts have a `category` of `snapshot`.
{ # An ExtendedSourceContext is a SourceContext combined with additional
# details describing the context.
"labels": { # Labels with user defined metadata.
@@ -235,12 +229,12 @@
"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.
},
- "uid": "A String", # A server-assigned, globally unique identifier.
},
},
},
@@ -253,12 +247,12 @@
"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.
},
- "uid": "A String", # A server-assigned, globally unique identifier.
},
},
"git": { # A GitSourceContext denotes a particular revision in a third party Git # A SourceContext referring to any third party Git repo (e.g. GitHub).
@@ -273,20 +267,20 @@
"name": "A String", # The alias name.
},
"revisionId": "A String", # A revision (commit) ID.
- "hostUri": "A String", # The URI of a running Gerrit instance.
- "aliasName": "A String", # The name of an alias (branch, tag, etc.).
"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 release. The version ID is structured as
- # following: `domain/type/vmajor.minor` (for example
- # `google.com/gcp-java/v1.1`).
- "isInactive": True or False, # If set to `true`, indicates that the debuggee is considered as inactive by
- # the Controller service.
+ "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.
},
],