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"{
        "addresses"[
            {
                "address""string",
                "origin""DHCP",
                "prefix"1,
                "status""TENTATIVE"
            },
            {
                "address""string",
                "origin""DHCP",
                "prefix"1,
                "status""TENTATIVE"
            }
        ],
        "autoconf"true,
        "configurable"true,
        "default_gateway""string",
        "dhcp"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.