Update Network Interface Settings

Update Network Interface Settings

Update network interface settings. Changing the appliance IP address disconnects the current REST API connection.

Request
URI
POST
https://{api_host}/appliance/settings/network/interfaces/{interface_name}
COPY
Path Parameters
string
interface_name
Required

The name of the network interface.


Request Body

The network interface settings to be updated.

UpdateNetworkInterfaceInfoSpec of type(s) application/json
Optional
{
    "ipv4": {
        "address": "10.20.80.191",
        "default_gateway": "string",
        "assignment_mode": "string",
        "prefix": 0
    },
    "ipv6": {
        "autoconfigure": false,
        "dhcp": false,
        "default_gateway": "string",
        "addresses": [
            {
                "address": "fc00:10:20:83:20c:29ff:fe94:bb5a",
                "prefix": 64
            }
        ]
    }
}
object
ipv4
Optional

IPv4 settings.

object
ipv6
Optional

IPv6 settings.

Authentication
This operation uses the following authentication methods.
Responses
204

Network interface settings updated.

Operation doesn't return any data structure

400

Bad request - the server could not understand the request due to invalid syntax or invalid request body content

Returns ResponseError of type(s) application/json
"ResponseError Object"
string
error_code
Optional

The code of the error.

string
message
Optional

The message of the error.

string As uuid As uuid
op_id
Optional

The ID of the operation.


401

Unauthorized - the client must authenticate itself to get the requested response

Operation doesn't return any data structure

403

Forbidden - not sufficient access rights to fulfill the request

Returns ResponseError of type(s) application/json
"ResponseError Object"
string
error_code
Optional

The code of the error.

string
message
Optional

The message of the error.

string As uuid As uuid
op_id
Optional

The ID of the operation.


404

Not Found - server cannot find the requested in URL resource

Operation doesn't return any data structure

500

Internal server error - unexpected condition prevents fulfilling the request

Returns ResponseError of type(s) application/json
"ResponseError Object"
string
error_code
Optional

The code of the error.

string
message
Optional

The message of the error.

string As uuid As uuid
op_id
Optional

The ID of the operation.


Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{}' https://{api_host}/appliance/settings/network/interfaces/{interface_name}