deploy.apps.resource-activity

Read one node's last events and, for a container, its last log lines

GET /deploy/api/apps/{id}/resources/activityIAM deploy:DescribeAppRead

node is a key from the resources tree, e.g. machine:i-abc or container:i-abc:web. Log lines need monitoring:FilterLogEvents.

Request syntax

GET /deploy/api/apps/{id}/resources/activity

Path parameters

  • idRequired

    string

    Constraints: uuid

Query parameters

  • nodeRequired

    string

    Key of a node from the resources tree, e.g. machine:i-abc or container:i-abc:web

    Constraints: 1-300 chars

Response

200 with `data`: the `node`, its last 20 `events` (at, level, phase, source, message; oldest first), and for a container its last 100 `logs` lines — null otherwise, with `logsUnavailable` saying why. 404 when the node is not in the caller’s tree.

A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.

Fields of data

  • nodeAlways

    object

    The node, as the resources tree has it
  • node.​keyAlways

    string

    Unique key, e.g. machine:i-abc or container:i-abc:web
  • node.​parentAlways

    string, may be null

    Key of the parent node; null for the root
  • node.​kindAlways

    one of app, deployment, load-balancer, machine, container, domain, database, cache, broker

    What the node is
  • node.​serviceAlways

    string

    Service it belongs to
  • node.​nameAlways

    string

    Name
  • node.​detailAlways

    string, may be null

    One line: image, size, address or engine
  • node.​hrefAlways

    string, may be null

    Console path of its own page; null if none
  • node.​healthAlways

    object

    Health and why
  • node.​health.​healthAlways

    one of healthy, progressing, degraded, suspended, missing, unknown

    Health
  • node.​health.​reasonAlways

    string

    Why
  • node.​syncAlways

    object, may be null

    Sync of a machine or container; null for other nodes
  • node.​sync.​syncAlways

    one of in_sync, out_of_sync, unknown

    Whether it runs what it should
  • node.​sync.​reasonAlways

    string

    Why
  • node.​sync.​rollingOutAlways

    boolean

    Out of sync only because a rollout is in progress
  • node.​reportedAtAlways

    string, may be null

    When it last reported; null if never or not applicable
  • node.​eventsAlways

    array of object

    Where its events are read from (resource-activity reads them)
  • node.​events[].​resourceTypeAlways

    string

    Kind of resource the events are about
  • node.​events[].​resourceIdAlways

    string

    Its id
  • node.​logStreamAlways

    string, may be null

    Log stream prefix of a container; null otherwise
  • eventsAlways

    array of object

    Its last 20 events, oldest first
  • events[].​atAlways

    string

    When
  • events[].​levelAlways

    one of info, warn, error

    info, warn or error
  • events[].​phaseAlways

    string, may be null

    Stage; null if none
  • events[].​sourceAlways

    one of control_plane, machine

    control_plane or machine
  • events[].​messageAlways

    string

    What happened
  • logsAlways

    array of object, may be null

    A container’s last 100 log lines, oldest first; null otherwise
  • logs[].​atAlways

    string

    When the line was written
  • logs[].​streamAlways

    string

    Log stream
  • logs[].​messageAlways

    string

    The line
  • logsUnavailableAlways

    string, may be null

    Why logs is null for a container; null otherwise

Checked against the handlers: every route test validates their answers against this schema.

Errors

  • 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
  • 401No credentials, or an access key that is unknown, revoked or expired.
  • 403The caller's policies do not allow deploy:DescribeApp on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
  • 404The resource does not exist in your organization.

Examples

The required parameters only, with example values. Replace id and the other placeholders with your own.

dcloud deploy apps resource-activity id --node example

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_deploy_apps_resource-activity.