ec2.sessions.listTerminal sessions: who opened which instance, when, for how long
Request syntax
GET /ec2/api/sessionsQuery parameters
instanceIdOptionalstring
Only sessions on this instance (i-…); omitted: every instance
Constraints: /^i-[0-9a-f]{6,32}$/
openOptionalenum
true: only sessions not yet ended; omitted or false: all
One of:
true,falselimitOptionalnumber
At most this many, newest first (default 50)
Constraints: integer, 1-200
Default:
50
Response
200: `data` is a list of sessions, newest first: id, instanceId, iamUsername, loginUser, status, endReason, clientIp, bytesIn, bytesOut, createdAt, startedAt, lastActivityAt, endedAt.
A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.
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 ec2:DescribeSessions 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 ec2 sessions listcurl -X GET "https://console.platform-development.deutschecloud.app/ec2/api/sessions" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY"Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_ec2_sessions_list.