PHphala
CVMs

Update CVM

Changed on

Unified PATCH endpoint for CVM updates. Only fields present in the request body are applied. Handles resource resize, compose configuration, visibility, environment, and OS image updates. For contract-owned KMS, compose-hash-affecting changes require two-phase flow with on-chain hash registration.

patch/api/v1/cvms/{cvm_id}

Request

Path parameters

cvm_idstring required

Headers

X-Compose-Hashstring nullable

Compose hash from Phase 1 response (Phase 2 only)

X-Transaction-Hashstring nullable

Transaction hash proving on-chain registration (Phase 2 only)

X-Prepare-Onlystring nullable

When 'true', generate a commit token for multisig workflows instead of expecting immediate on-chain registration

Request body

docker_compose_filestring nullable

Docker Compose YAML content

pre_launch_scriptstring nullable

Shell script executed before containers start

allowed_envsstring[] nullable

Allowed environment variable names (env_keys)

public_logsboolean nullable

Expose container logs publicly

public_sysinfoboolean nullable

Expose system info publicly

public_tcbinfoboolean nullable

Expose TCB attestation info publicly

init_scriptsstring[] nullable

Platform init scripts this CVM runs, replacing the current set. Enabling docker_cleanup requires confirm_data_wipe.

confirm_data_wipeboolean

Confirms turning on docker_cleanup or requirements.ephemeral_data_disk, which erase data on every boot.

encrypted_envstring nullable

Encrypted environment variables as hex string

user_configstring nullable

User configuration string

vcpuinteger nullable

Number of vCPUs

memoryinteger nullable

Memory in MB

disk_sizeinteger nullable

Disk size in GB

instance_typestring nullable

Instance type identifier (e.g. tdx.medium)

imagestring nullable

OS image name or slug from available-os-images

shutdown_timeoutinteger nullable

Timeout in seconds for graceful shutdown. null uses the platform default.

allow_force_stopboolean

When true, skips graceful shutdown and force stops the CVM immediately.

Response

Update initiated, track via correlation_id

unknown required

Changes

  • c71a8dc90391Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property