CVMs

Batch refresh CVM instance IDs

Resolves and persists missing instance_id values. Admin can pass cross-workspace CVM IDs.

patch/api/v1/cvms/instance-ids

Request

Base URL
https://cloud-api.phala.com
Auth
none declared
TypeScript
https://skmtc.dev/phala/apis/phala-cloud-api/docs/api/v1/cvms/instance-ids/patch.ts
A function with typed inputs. Its response is checked against the schema.

cvm_idsstring[] nullable

Optional CVM identifiers. Admin can pass cross-workspace IDs.

running_onlyboolean

Only process CVMs with status=running

missing_onlyboolean

Only process CVMs with missing instance_id

overwriteboolean

Overwrite existing instance_id when different

limitinteger

Max CVMs to process in one request

dry_runboolean

Preview changes without persisting

Successful Response

{
  "items": [
    {
      "cvm_id": "cvm_0123abcd"
    }
  ]
}