Provision a new compute node.

  • Published on Apr 4, 2026
  • 1 minute(s) read
Prev Next
Post
/v1/nodes

Provision a new compute node.

Body parameters

Request to provision a compute node.

Expand All
object
name
string Required

Name of the compute node.

description
string

Description of the compute node.

ipaddress
string Required

IP Address of the compute node.

sys_info
object (NodeSysInfo)

System Related details of a compute node.

epc_size
integer (int64) Required

Size of EPC of the compute node in bytes.

num_cpu_cores
integer (int32) Required

Number of CPU cores of the compute node.

total_memory
integer (int64)

Total available memory of the compute node in bytes. Populated for TDX nodes; null for SGX and other node types.

sgx_version
string Required

Version of the Intel SGX Platform Software running on the compute node.

attestation_request
object (AttestationRequest)
ias_quote
string (binary)

IAS (EPID/DCAP) Quote report bytes.

csr
string Required

Certificate Signing Request bytes.

attestation_type
string

Node Attestation type (DCAP, NITRO_ENCLAVE, AMD_SEV_SNP, BAREMETAL_AMD_SEV_SNP or BAREMETAL_TDX).

error_report
object (NodeErrorReport)
message
string Required

Error message containing the reason why node agent failed.

name
string Required

Node agent attestation error type.

Valid values[ "AESMD_FAILURE", "QUOTE_GENERATION_ERROR", "QUOTE_VERIFICATION_ERROR", "GROUP_OUT_OF_DATE", "SIGRL_VERSION_MISMATCH", "CONFIGURATION_NEEDED", "QUOTE_REVOKED", "SIGNATURE_INVALID", "DCAP_ERROR", "CPUSVN_OUT_OF_DATE", "PSW_OUT_OF_DATE", "BAD_PSW", "BAD DATA" ]
Responses
200

Compute node creation task.

Expand All
object
task_id
string (uuid)

Task Id

certificate_id
string (uuid)

Certificate Id in case of certificate issuance task.

node_id
string (uuid)

Compute Node Id.

task_type
string

The types of tasks supported.

Valid values[ "NODE_ATTESTATION", "CERTIFICATE_ISSUANCE", "BUILD_WHITELIST", "DOMAIN_WHITELIST" ]
task_status
object (TaskStatus)

Status info for a task.

created_at
integer (int64)

Task creation time

status_updated_at
integer (int64)

Time since the status change.

status
string

Status string for a task.

Valid values[ "INPROGRESS", "FAILED", "SUCCESS", "DENIED" ]
build_id
string (uuid)

Build Id.