Machines

Return the data needed to render a machine's install command

Mints a fresh single-use install secret for an es-python machine (JSON body) and returns the /install.sh URL, the machine's os_type (auto when its build is detected at install) and expires_in, the seconds the secret has left (it lasts 10 minutes). Requires attested=true (authorized-use attestation; 422 otherwise). You must hold the machine's product (403 otherwise). Needs os_type set (else 422). If the machine is installed, mid-install or failed it is reset to 'created' first (a re-install); the live credential is not rotated until the new install actually starts. With renew=true that reset never happens: a machine that is not 'created' is a 409 and is left alone. Cookie callers must pass CSRF.

This is a write: a read-only API key is refused with 403.

post/api/get_eyalsec_install_script_data/

Request

  • Base URL: https://eyalsec.com
  • URL: https://eyalsec.com/api/get_eyalsec_install_script_data/
  • Auth: one of:
    • API key in header X-API-Key
    • API key in cookie __Host-es2session

Request body

public_idstring required

The machine's public id.

attestedboolean required

Must be true: attests authorized use before a token is issued.

renewboolean

true: only replace an expiring command; 409 (and no reset) if the machine has started installing.

Response

OK.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.