Compute

Create a VM

Create a VM directly. Pass ssh_key or ssh_key_ids for SSH access — or attach a key later with attachVmSshKey (never recreate a VM just to add a key). Use size, or override vcpu/ram/disk individually.

post/agent/compute/vms

Request

  • Base URL: https://edge.network
  • URL: https://edge.network/agent/compute/vms
  • Auth: HTTP bearer

Headers

X-Dry-Run'true' | 'false'

Set to "true" to preview the operation (validation, cost, plan) without making changes.

Idempotency-Keystring

Unique key for safe retries. Repeating a request with the same key returns the original response instead of re-executing.

Request body

namestring required
osstring

OS template id from listOsTemplates.

size'nano' | 'small' | 'medium' | 'large' | 'xlarge'
vcpunumber

Override vCPU count.

ramnumber

Override RAM in GB.

disknumber

Override disk in GB.

regionstring

Region id from listRegions.

ssh_keystring

SSH public key string. Auto-saved and attached.

ssh_key_idsstring[]
scriptstring

Startup script id from listComputeScripts.

script_paramsobject
setup_scriptstring

Inline bash for first boot. Mutually exclusive with script.

security_group_idsstring[]

Response

VM created. Poll getVm until status is "running" before SSHing.

tell_userstring

Human-readable summary of what happened, for the agent to relay to its operator.

Changes

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