---
title: "Read cloud execution setup"
method: GET
path: "/v1/cloud-connections/{id}/execution"
tags: ["Cloud observation"]
---

# Read cloud execution setup

`GET /v1/cloud-connections/{id}/execution`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/cloud-connections/{id}/execution`
- Auth: HTTP bearer

Returns explicit execution authorization and administrator-declared host associations. A read-only cloud connection starts disabled without an execution pool. This response does not establish host readiness. Unavailable deployments and disconnected or foreign connections return 404.

## Path parameters

- `id` string, required

## Response `200`

Read cloud execution setup

- CloudExecution
  - `connection_id` string, required: Nodus cloud connection identity.
  - `pool_id` string: Dedicated Nodus pool identity, present after execution has first been enabled.
  - `enabled` boolean, required: Explicit authorization for future private workload routing. Host enrollment, health and available capacity are checked separately.
  - `hosts` CloudExecutionHost[], required
    - `host_id` string, required: Nodus host identity in the dedicated pool.
    - `resource_id` string, required: Customer-owned AWS EC2 instance ID or Google Compute Engine numeric instance ID recorded by the administrator.
    - `region` string, required: Cloud region containing the observed instance.
    - `bound_at` string, date-time, required
    - `execution_configured` boolean, required: The enrolled host has declared the required Nodus execution configuration. Health, cloud authorization and available capacity are checked separately. This is not a physical host attestation.
    - `zone` string: Google Compute Engine zone containing the instance. Omitted for AWS associations.

## Other responses

- `default`: Authentication, administrator access, invalid input, missing records, conflicts, rate limits, credential storage, and transient failures are returned using the stable error and message fields.

## Changes

- **2026-10-01** `ba84c74aeec8`: 1 info
  - added the optional property `hosts/items/zone` to the response with the `200` status
- **2026-10-01** `544fef290a54`: 1 warning
  - removed the optional property `hosts/items/zone` from the response with the `200` status
- **2026-09-28** `621fe4052ff9`: 1 info
  - added the optional property `hosts/items/zone` to the response with the `200` status
- **2026-09-28** `5b5ed315c2a4`: 1 warning
  - removed the optional property `hosts/items/zone` from the response with the `200` status
- **2026-09-27** `ed6520461760`: 1 info
  - added the optional property `hosts/items/zone` to the response with the `200` status

[Operation history](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/changes/v1/cloud-connections/:id/execution/get.md)

---

[API](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api.md) - [All operations](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/revisions/a59210899d95?raw)