docs: update generated docs (#981)
diff --git a/docs/dyn/clouddebugger_v2.controller.debuggees.html b/docs/dyn/clouddebugger_v2.controller.debuggees.html
index ec5f36e..404fd4b 100644
--- a/docs/dyn/clouddebugger_v2.controller.debuggees.html
+++ b/docs/dyn/clouddebugger_v2.controller.debuggees.html
@@ -108,147 +108,6 @@
# 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.
- "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.
- "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).
- "revisionId": "A String", # Git commit hash.
- # required.
- "url": "A String", # Git repository URL.
- },
- "gerrit": { # A SourceContext referring to a Gerrit project. # A SourceContext referring to a Gerrit project.
- "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.
- "aliasContext": { # An alias to a repo revision. # An alias, which may be a branch or tag.
- "name": "A String", # The alias name.
- "kind": "A String", # The alias kind.
- },
- "hostUri": "A String", # The URI of a running Gerrit instance.
- "revisionId": "A String", # A revision (commit) ID.
- "aliasName": "A String", # The name of an alias (branch, tag, etc.).
- },
- "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).
- "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.
- "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.
- },
- "aliasContext": { # An alias to a repo revision. # An alias, which may be a branch or tag.
- "name": "A String", # The alias name.
- "kind": "A String", # The alias kind.
- },
- },
- "cloudWorkspace": { # A CloudWorkspaceSourceContext denotes a workspace at a particular snapshot. # A SourceContext referring to a snapshot in a cloud workspace.
- "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.
- "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.
- },
- },
- "snapshotId": "A String", # The ID of the snapshot.
- # An empty snapshot_id refers to the most recent snapshot.
- },
- },
- ],
- "labels": { # A set of custom debuggee properties, populated by the agent, to be
- # displayed to the user.
- "a_key": "A String",
- },
- "project": "A String", # Project the debuggee is associated with.
- # Use project number or id when registering a Google Cloud Platform project.
- "isDisabled": True or False, # If set to `true`, indicates that the agent should disable itself and
- # detach from the debuggee.
- "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.
- "description": "A String", # Human readable description of the debuggee.
- # Including a human-readable project name, environment name and version
- # information is recommended.
- "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.
- "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.
- "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).
- "revisionId": "A String", # Git commit hash.
- # required.
- "url": "A String", # Git repository URL.
- },
- "gerrit": { # A SourceContext referring to a Gerrit project. # A SourceContext referring to a Gerrit project.
- "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.
- "aliasContext": { # An alias to a repo revision. # An alias, which may be a branch or tag.
- "name": "A String", # The alias name.
- "kind": "A String", # The alias kind.
- },
- "hostUri": "A String", # The URI of a running Gerrit instance.
- "revisionId": "A String", # A revision (commit) ID.
- "aliasName": "A String", # The name of an alias (branch, tag, etc.).
- },
- "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).
- "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.
- "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.
- },
- "aliasContext": { # An alias to a repo revision. # An alias, which may be a branch or tag.
- "name": "A String", # The alias name.
- "kind": "A String", # The alias kind.
- },
- },
- "cloudWorkspace": { # A CloudWorkspaceSourceContext denotes a workspace at a particular snapshot. # A SourceContext referring to a snapshot in a cloud workspace.
- "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.
- "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.
- },
- },
- "snapshotId": "A String", # The ID of the snapshot.
- # An empty snapshot_id refers to the most recent snapshot.
- },
- },
- "labels": { # Labels with user defined metadata.
- "a_key": "A String",
- },
- },
- ],
"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.
@@ -273,13 +132,154 @@
},
"refersTo": "A String", # Reference to which the message applies.
},
+ "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.
+ "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.
+ "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).
+ "aliasName": "A String", # The name of an alias (branch, tag, etc.).
+ "revisionId": "A String", # A revision ID.
+ "aliasContext": { # An alias to a repo revision. # An alias, which may be a branch or tag.
+ "name": "A String", # The alias name.
+ "kind": "A String", # The alias kind.
+ },
+ "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.
+ "repoName": "A String", # The name of the repo. Leave empty for the default repo.
+ "projectId": "A String", # The ID of the project.
+ },
+ },
+ },
+ "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).
+ "revisionId": "A String", # Git commit hash.
+ # required.
+ "url": "A String", # Git repository URL.
+ },
+ "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.
+ "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.
+ "repoName": "A String", # The name of the repo. Leave empty for the default repo.
+ "projectId": "A String", # The ID of the project.
+ },
+ },
+ "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.
+ },
+ },
+ "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.
+ "name": "A String", # The alias name.
+ "kind": "A String", # The alias kind.
+ },
+ "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.
+ "aliasName": "A String", # The name of an alias (branch, tag, etc.).
+ "hostUri": "A String", # The URI of a running Gerrit instance.
+ },
+ },
+ "labels": { # Labels with user defined metadata.
+ "a_key": "A String",
+ },
+ },
+ ],
+ "canaryMode": "A String", # Used when setting breakpoint canary for this debuggee.
+ "isDisabled": True or False, # If set to `true`, indicates that the agent should disable itself and
+ # detach from the debuggee.
"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.
- "canaryMode": "A String", # Used when setting breakpoint canary for this debuggee.
"id": "A String", # Unique identifier for the debuggee generated by the controller service.
+ "project": "A String", # Project the debuggee is associated with.
+ # Use project number or id when registering a Google Cloud Platform project.
+ "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.
+ "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.
+ "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).
+ "aliasName": "A String", # The name of an alias (branch, tag, etc.).
+ "revisionId": "A String", # A revision ID.
+ "aliasContext": { # An alias to a repo revision. # An alias, which may be a branch or tag.
+ "name": "A String", # The alias name.
+ "kind": "A String", # The alias kind.
+ },
+ "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.
+ "repoName": "A String", # The name of the repo. Leave empty for the default repo.
+ "projectId": "A String", # The ID of the project.
+ },
+ },
+ },
+ "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).
+ "revisionId": "A String", # Git commit hash.
+ # required.
+ "url": "A String", # Git repository URL.
+ },
+ "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.
+ "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.
+ "repoName": "A String", # The name of the repo. Leave empty for the default repo.
+ "projectId": "A String", # The ID of the project.
+ },
+ },
+ "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.
+ },
+ },
+ "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.
+ "name": "A String", # The alias name.
+ "kind": "A String", # The alias kind.
+ },
+ "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.
+ "aliasName": "A String", # The name of an alias (branch, tag, etc.).
+ "hostUri": "A String", # The URI of a running Gerrit instance.
+ },
+ },
+ ],
"agentVersion": "A String", # Version ID of the agent.
# Schema: `domain/language-platform/vmajor.minor` (for example
# `google.com/java-gcp/v1.1`).
+ "description": "A String", # Human readable description of the debuggee.
+ # Including a human-readable project name, environment name and version
+ # information is recommended.
+ "labels": { # A set of custom debuggee properties, populated by the agent, to be
+ # displayed to the user.
+ "a_key": "A String",
+ },
},
}
@@ -292,6 +292,8 @@
An object of the form:
{ # Response for registering a debuggee.
+ "agentId": "A String", # A unique ID generated for the agent.
+ # Each RegisterDebuggee request will generate a new agent ID.
"debuggee": { # Represents the debugged application. The application may include one or more # Debuggee resource.
# The field `id` is guaranteed to be set (in addition to the echoed fields).
# If the field `is_disabled` is set to `true`, the agent should disable
@@ -301,147 +303,6 @@
# 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.
- "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.
- "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).
- "revisionId": "A String", # Git commit hash.
- # required.
- "url": "A String", # Git repository URL.
- },
- "gerrit": { # A SourceContext referring to a Gerrit project. # A SourceContext referring to a Gerrit project.
- "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.
- "aliasContext": { # An alias to a repo revision. # An alias, which may be a branch or tag.
- "name": "A String", # The alias name.
- "kind": "A String", # The alias kind.
- },
- "hostUri": "A String", # The URI of a running Gerrit instance.
- "revisionId": "A String", # A revision (commit) ID.
- "aliasName": "A String", # The name of an alias (branch, tag, etc.).
- },
- "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).
- "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.
- "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.
- },
- "aliasContext": { # An alias to a repo revision. # An alias, which may be a branch or tag.
- "name": "A String", # The alias name.
- "kind": "A String", # The alias kind.
- },
- },
- "cloudWorkspace": { # A CloudWorkspaceSourceContext denotes a workspace at a particular snapshot. # A SourceContext referring to a snapshot in a cloud workspace.
- "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.
- "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.
- },
- },
- "snapshotId": "A String", # The ID of the snapshot.
- # An empty snapshot_id refers to the most recent snapshot.
- },
- },
- ],
- "labels": { # A set of custom debuggee properties, populated by the agent, to be
- # displayed to the user.
- "a_key": "A String",
- },
- "project": "A String", # Project the debuggee is associated with.
- # Use project number or id when registering a Google Cloud Platform project.
- "isDisabled": True or False, # If set to `true`, indicates that the agent should disable itself and
- # detach from the debuggee.
- "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.
- "description": "A String", # Human readable description of the debuggee.
- # Including a human-readable project name, environment name and version
- # information is recommended.
- "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.
- "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.
- "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).
- "revisionId": "A String", # Git commit hash.
- # required.
- "url": "A String", # Git repository URL.
- },
- "gerrit": { # A SourceContext referring to a Gerrit project. # A SourceContext referring to a Gerrit project.
- "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.
- "aliasContext": { # An alias to a repo revision. # An alias, which may be a branch or tag.
- "name": "A String", # The alias name.
- "kind": "A String", # The alias kind.
- },
- "hostUri": "A String", # The URI of a running Gerrit instance.
- "revisionId": "A String", # A revision (commit) ID.
- "aliasName": "A String", # The name of an alias (branch, tag, etc.).
- },
- "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).
- "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.
- "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.
- },
- "aliasContext": { # An alias to a repo revision. # An alias, which may be a branch or tag.
- "name": "A String", # The alias name.
- "kind": "A String", # The alias kind.
- },
- },
- "cloudWorkspace": { # A CloudWorkspaceSourceContext denotes a workspace at a particular snapshot. # A SourceContext referring to a snapshot in a cloud workspace.
- "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.
- "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.
- },
- },
- "snapshotId": "A String", # The ID of the snapshot.
- # An empty snapshot_id refers to the most recent snapshot.
- },
- },
- "labels": { # Labels with user defined metadata.
- "a_key": "A String",
- },
- },
- ],
"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.
@@ -466,16 +327,155 @@
},
"refersTo": "A String", # Reference to which the message applies.
},
+ "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.
+ "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.
+ "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).
+ "aliasName": "A String", # The name of an alias (branch, tag, etc.).
+ "revisionId": "A String", # A revision ID.
+ "aliasContext": { # An alias to a repo revision. # An alias, which may be a branch or tag.
+ "name": "A String", # The alias name.
+ "kind": "A String", # The alias kind.
+ },
+ "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.
+ "repoName": "A String", # The name of the repo. Leave empty for the default repo.
+ "projectId": "A String", # The ID of the project.
+ },
+ },
+ },
+ "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).
+ "revisionId": "A String", # Git commit hash.
+ # required.
+ "url": "A String", # Git repository URL.
+ },
+ "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.
+ "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.
+ "repoName": "A String", # The name of the repo. Leave empty for the default repo.
+ "projectId": "A String", # The ID of the project.
+ },
+ },
+ "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.
+ },
+ },
+ "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.
+ "name": "A String", # The alias name.
+ "kind": "A String", # The alias kind.
+ },
+ "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.
+ "aliasName": "A String", # The name of an alias (branch, tag, etc.).
+ "hostUri": "A String", # The URI of a running Gerrit instance.
+ },
+ },
+ "labels": { # Labels with user defined metadata.
+ "a_key": "A String",
+ },
+ },
+ ],
+ "canaryMode": "A String", # Used when setting breakpoint canary for this debuggee.
+ "isDisabled": True or False, # If set to `true`, indicates that the agent should disable itself and
+ # detach from the debuggee.
"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.
- "canaryMode": "A String", # Used when setting breakpoint canary for this debuggee.
"id": "A String", # Unique identifier for the debuggee generated by the controller service.
+ "project": "A String", # Project the debuggee is associated with.
+ # Use project number or id when registering a Google Cloud Platform project.
+ "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.
+ "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.
+ "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).
+ "aliasName": "A String", # The name of an alias (branch, tag, etc.).
+ "revisionId": "A String", # A revision ID.
+ "aliasContext": { # An alias to a repo revision. # An alias, which may be a branch or tag.
+ "name": "A String", # The alias name.
+ "kind": "A String", # The alias kind.
+ },
+ "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.
+ "repoName": "A String", # The name of the repo. Leave empty for the default repo.
+ "projectId": "A String", # The ID of the project.
+ },
+ },
+ },
+ "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).
+ "revisionId": "A String", # Git commit hash.
+ # required.
+ "url": "A String", # Git repository URL.
+ },
+ "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.
+ "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.
+ "repoName": "A String", # The name of the repo. Leave empty for the default repo.
+ "projectId": "A String", # The ID of the project.
+ },
+ },
+ "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.
+ },
+ },
+ "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.
+ "name": "A String", # The alias name.
+ "kind": "A String", # The alias kind.
+ },
+ "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.
+ "aliasName": "A String", # The name of an alias (branch, tag, etc.).
+ "hostUri": "A String", # The URI of a running Gerrit instance.
+ },
+ },
+ ],
"agentVersion": "A String", # Version ID of the agent.
# Schema: `domain/language-platform/vmajor.minor` (for example
# `google.com/java-gcp/v1.1`).
+ "description": "A String", # Human readable description of the debuggee.
+ # Including a human-readable project name, environment name and version
+ # information is recommended.
+ "labels": { # A set of custom debuggee properties, populated by the agent, to be
+ # displayed to the user.
+ "a_key": "A String",
+ },
},
- "agentId": "A String", # A unique ID generated for the agent.
- # Each RegisterDebuggee request will generate a new agent ID.
}</pre>
</div>