Cloud observation

Associate an enrolled host with observed AWS or Google Cloud capacity

Changed on

Requires an API key owned by a user who is currently a team administrator. The console uses the same service with its authenticated session. Requires execution setup to be enabled and the Nodus host to belong to its dedicated pool. Checks the exact running GPU instance and region against ready account or project inventory collected within the last two hours. Google Cloud requires zone and matches its server-generated numeric instance ID in the connected project. The administrator declares where the host was installed. This does not attest physical host identity or enable execution credentials. Existing associations are immutable, with exact retries returning the same record. Missing hosts return 404. Unavailable inventory and conflicting associations return 409.

post/v1/cloud-connections/{id}/execution/hosts

Request

  • Base URL
    / (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    HTTP bearer

Path parameters

idstring required

Tenant-owned Nodus cloud connection identity.

Request body

host_idstring required
resource_idstring required

AWS EC2 instance ID or Google Compute Engine server-generated uint64 instance ID, supplied as a decimal string. IDs and regions must match the connection provider.

regionstring required
zonestring

Required for Google Cloud and must belong to the supplied region. Omit for AWS.

Response

Associate an enrolled host with observed AWS or Google Cloud capacity

host_idstring required

Nodus host identity in the dedicated pool.

resource_idstring required

Customer-owned AWS EC2 instance ID or Google Compute Engine numeric instance ID recorded by the administrator.

regionstring required

Cloud region containing the observed instance.

bound_atstring date-time required
execution_configuredboolean 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.

zonestring

Google Compute Engine zone containing the instance. Omitted for AWS associations.

Changes

    • warning

      changed the pattern of the request property from ^[a-z]{2}(?:-[a-z]+)+-[0-9]+$ to ^(?:[a-z]{2}(?:-[a-z]+)+-[0-9]+|[a-z]+(?:-[a-z]+)+[0-9]+)$

    • warning

      changed the pattern of the request property from ^i-(?:[a-f0-9]{8}|[a-f0-9]{17})$ to ^(?:i-(?:[a-f0-9]{8}|[a-f0-9]{17})|[1-9][0-9]{0,19})$

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • warning

      changed the pattern of the request property from ^(?:[a-z]{2}(?:-[a-z]+)+-[0-9]+|[a-z]+(?:-[a-z]+)+[0-9]+)$ to ^[a-z]{2}(?:-[a-z]+)+-[0-9]+$

    • warning

      changed the pattern of the request property from ^(?:i-(?:[a-f0-9]{8}|[a-f0-9]{17})|[1-9][0-9]{0,19})$ to ^i-(?:[a-f0-9]{8}|[a-f0-9]{17})$

    • warning

      removed the request property

    • warning

      removed the optional property from the response with the status