Skip to content
StratumStratum Docs

The exact node.yaml the install would write.

GET
/v1/installer/config.yaml
Code sample: Shell / cURL
curl --request GET \
  --url https://192.0.2.10:9443/v1/installer/config.yaml \
  --header 'Authorization: <Authorization>'

Byte for byte the file POST /v1/installer/install writes to /etc/stratum/node.yaml, rendered from the current draft whether or not it validates.

Authorizations

Section titled “Authorizations”

Responses

Section titled “Responses”

200

Section titled “200”

The node.yaml.

Media typeapplication/yaml
string

401

Section titled “401”

No install code, or the wrong one.

Media typeapplication/problem+json

RFC 7807 problem details, the control plane’s shape.

object
type
required
string
title
required
string
status
required
integer
>= 400 <= 599
detail
string
code
required
string
requestId
required
string
errors

Field errors, for INVALID_CONFIG.

Array<object>
object
field
required

The structured field (network.floatingIpCidrs[1]); empty for the whole config. For a raw YAML draft, the node.yaml key.

string
message
required
string

Example generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "requestId": "example",
  "errors": [
    {
      "field": "example",
      "message": "example"
    }
  ]
}

429

Section titled “429”

Too many wrong install codes; wait for Retry-After.

Media typeapplication/problem+json

RFC 7807 problem details, the control plane’s shape.

object
type
required
string
title
required
string
status
required
integer
>= 400 <= 599
detail
string
code
required
string
requestId
required
string
errors

Field errors, for INVALID_CONFIG.

Array<object>
object
field
required

The structured field (network.floatingIpCidrs[1]); empty for the whole config. For a raw YAML draft, the node.yaml key.

string
message
required
string

Example generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "requestId": "example",
  "errors": [
    {
      "field": "example",
      "message": "example"
    }
  ]
}

Headers

Section titled “Headers”
Retry-After
integer

Seconds until the next attempt is considered.

500

Section titled “500”

The installer failed to answer.

Media typeapplication/problem+json

RFC 7807 problem details, the control plane’s shape.

object
type
required
string
title
required
string
status
required
integer
>= 400 <= 599
detail
string
code
required
string
requestId
required
string
errors

Field errors, for INVALID_CONFIG.

Array<object>
object
field
required

The structured field (network.floatingIpCidrs[1]); empty for the whole config. For a raw YAML draft, the node.yaml key.

string
message
required
string

Example generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "requestId": "example",
  "errors": [
    {
      "field": "example",
      "message": "example"
    }
  ]
}