Skip to main content
POST
Add one managed Node through native provider control

授权

Authorization
string
header
必填

OIDC/JWKS bearer token. Self-hosted defaults to Pocket ID; SaaS uses Auth0 through the edge. PocketBase JWT is legacy migration compatibility only.

请求头

Idempotency-Key
string
必填

One opaque, case-sensitive Add-Server attempt key. Supply exactly one value without leading/trailing whitespace, comma separators, or control characters. Maximum 256 UTF-8 bytes.

Required string length: 1 - 256

路径参数

id
string
必填

Stack ID

请求体

application/json
provider_id
enum<string>
必填

Canonical executable provider identifier; historical display aliases are rejected.

可用选项:
centron,
ionos
provider_region
string

Provider region. For IONOS this is normalized to the canonical datacenter identifier.

Maximum string length: 128
ionos_datacenter
string

IONOS datacenter alias for provider_region; ignored for other canonical providers.

Maximum string length: 128
node_role
enum<string>
默认值:worker
可用选项:
foundation,
worker,
storage
runtime_offering_id
string

Canonical managed-runtime offering. Omission uses the stack's snapshotted effective default.

stackkit
string

StackKit foundation requested for this server.

services
string[]

Service keys; duplicates and order are semantically insignificant.

Maximum array length: 128
Required string length: 1 - 128
Pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$

响应

Native managed-runtime admission accepted or safely replayed; provisioning remains pending.

data
object
必填
meta
object
必填