REST API - get

appliance networking interfaces ipv6: get

Get IPv6 network configuration for specific interface. This operation was added in vSphere API 6.7.

Request:

HTTP request

GET https://{server}/rest/appliance/networking/interfaces/{interface_name}/ipv6

Path Parameters

Name	Type	Description
Required
interface_name	string	Network interface to query, for example, "nic0".

Response:

HTTP Status Code: 200

Representation:

{
    "value" : {
        "default_gateway" : "string",
        "addresses" : [
            {
                "address" : "string",
                "prefix" : 1,
                "origin" : "DHCP",
                "status" : "TENTATIVE"
            },
            {
                "address" : "string",
                "prefix" : 1,
                "origin" : "DHCP",
                "status" : "TENTATIVE"
            }
        ],
        "autoconf" : true,
        "dhcp" : true,
        "configurable" : true
    }
}

Response Type:

Name	Type	Description
bold = required
value	info	IPv6 configuration.
value.dhcp	boolean	DHCP is on. This attribute was added in vSphere API 6.7.
value.autoconf	boolean	Stateless Address Autoconfiguration (SLAAC) is on. This attribute was added in vSphere API 6.7.
value.addresses	address_info[]	List of addresses with their origins and statuses. This attribute was added in vSphere API 6.7.
value.addresses[].origin	string	The Origin of the IPv6 address. For more information, see RFC 4293. This attribute was added in vSphere API 6.7. Defines IPv6 address origin values. This enumeration was added in vSphere API 6.7. Value is one of: DHCP: The IPv6 address is assigned by a DHCP server. See RFC 4293. This constant was added in vSphere API 6.7. RANDOM: The IPv6 address is assigned randomly by the system. See RFC 4293. This constant was added in vSphere API 6.7. MANUAL: The IPv6 address was manually configured to a specified address, for example, by user configuration. See RFC 4293. This constant was added in vSphere API 6.7. LINKLAYER: The IPv6 address is assigned by IPv6 Stateless Address Auto-configuration (SLAAC). See RFC 4293. This constant was added in vSphere API 6.7. OTHER: The IPv6 address is assigned by a mechanism other than manual, DHCP, SLAAC, or random. See RFC 4293. This constant was added in vSphere API 6.7.
value.addresses[].status	string	The Status of the IPv6 address. For more information, see RFC 4293. This attribute was added in vSphere API 6.7. Defines IPv6 address status values. See RFC 4293. This enumeration was added in vSphere API 6.7. Value is one of: TENTATIVE: The IPv6 address is in the process of being verified as unique. An address in this state cannot be used for general communication. It can be used to determine the uniqueness of the address. This constant was added in vSphere API 6.7. UNKNOWN: The status of this address cannot be determined. This constant was added in vSphere API 6.7. INACCESSIBLE: The IPv6 address is inaccessible because the interface to which this address is assigned is not operational. This constant was added in vSphere API 6.7. INVALID: The IPv6 address is not a valid address. It should not appear as the destination or source address of a packet. This constant was added in vSphere API 6.7. DUPLICATE: The IPv6 address is not unique on the link and cannot be used. This constant was added in vSphere API 6.7. PREFERRED: This is a valid IPv6 address that can appear as the destination or source address of a packet. This constant was added in vSphere API 6.7. DEPRECATED: The is a valid but deprecated IPv6 address. This address cannot be used as a source address in new communications, although packets addressed to such an address are processed as expected. This constant was added in vSphere API 6.7. OPTIMISTIC: The IPv6 address is available for use, subject to restrictions, while its uniqueness on a link is being verified. This constant was added in vSphere API 6.7.
value.addresses[].address	string	The IPv6 address, for example, fc00:10:20:83:20c:29ff:fe94:bb5a. This attribute was added in vSphere API 6.7.
value.addresses[].prefix	long	The IPv6 CIDR prefix, for example, 64. This attribute was added in vSphere API 6.7.
value.default_gateway	string	The default gateway for static IP address assignment. This configures the global IPv6 default gateway on the appliance with the specified gateway address and interface. This gateway replaces the existing default gateway configured on the appliance. However, if the gateway address is link-local, then it is added for that interface. This does not support configuration of multiple global default gateways through different interfaces. This attribute was added in vSphere API 6.7.
value.configurable	boolean	Is NIC configurable or not. This attribute was added in vSphere API 6.7.

Errors:

HTTP Status Code	Type	Description
404	not_found	if the specified NIC is not found.
500	error	Generic error.