Skip to content

Save Host Interface L3 Configuration

PUT
/network/interface/{name}/l3
curl --request PUT \
--url https://sylve.lan:8181/api/network/interface/example/l3 \
--header 'Authorization: <Authorization>' \
--header 'Content-Type: application/json' \
--data '{ "addresses": [ { "address": "example" } ], "expectedRevision": 1, "ipv6Mode": "inherit", "metric": 1, "mtu": 1 }'

Stage a Host IP change; the response carries the pending id and the 60-second confirmation deadline

name
required
string

Interface name

Desired Host IP state

Media typeapplication/json
object
addresses
Array<object>
object
address
required
string
expectedRevision
integer
ipv6Mode
string
Allowed values: inherit enabled disabled
metric
integer
mtu
integer

Applied, awaiting confirmation

Media typeapplication/json
object
data
object
deadline
string
id
string
interface
string
kind
string
phase
string
error
string
message
string
status
string
Examplegenerated
{
"data": {
"deadline": "example",
"id": "example",
"interface": "example",
"kind": "example",
"phase": "example"
},
"error": "example",
"message": "example",
"status": "example"
}

Invalid request

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
"data": "example",
"error": "example",
"message": "example",
"status": "example"
}

Revision, pending or interface conflict

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
"data": "example",
"error": "example",
"message": "example",
"status": "example"
}

Internal Server Error

Media typeapplication/json
object
data
error
string
message
string
status
string
Examplegenerated
{
"data": "example",
"error": "example",
"message": "example",
"status": "example"
}