REST API - adapter

vcenter guest: adapter mapping

The adapter_mapping structure specifies the association between a virtual network adapter and its IP settings. This structure was added in vSphere API 7.0.0.0.

Representation:

JSON

{
    "adapter" : {
        "ipv4" : {
            "gateways" : [
                "string",
                "string"
            ],
            "prefix" : 1,
            "ip_address" : "string",
            "type" : "DHCP"
        },
        "ipv6" : {
            "gateways" : [
                "string",
                "string"
            ],
            "ipv6" : [
                {
                    "prefix" : 1,
                    "ip_address" : "string"
                },
                {
                    "prefix" : 1,
                    "ip_address" : "string"
                }
            ],
            "type" : "DHCP"
        },
        "windows" : {
            "dns_domain" : "string",
            "wins_servers" : [
                "string",
                "string"
            ],
            "net_BIOS_mode" : "USE_DHCP",
            "dns_servers" : [
                "string",
                "string"
            ]
        }
    },
    "mac_address" : "string"
}

Attributes:

Name	Type	Description
Required
adapter	IP_settings	The IP settings for the associated virtual network adapter. This attribute was added in vSphere API 7.0.0.0.
adapter.ipv4.type	string	The type of the IPv4 configuration. This attribute was added in vSphere API 7.0.0.0. Specifies different types of the IPv4 configuration. This enumeration was added in vSphere API 7.0.0.0. Value is one of: DHCP: DHCP configuration. This constant was added in vSphere API 7.0.0.0. STATIC: Static configuration. This constant was added in vSphere API 7.0.0.0. USER_INPUT_REQUIRED: Indicates that the IPv4 settings are not specified in advance. The user must provide a valid value when the actual customization spec is applied to a virtual machine. This constant was added in vSphere API 7.0.0.0.
adapter.ipv6.type	string	The IPv6 configuration type. This attribute was added in vSphere API 7.0.0.0. Specifies different types of the IPv6 configuration. This enumeration was added in vSphere API 7.0.0.0. Value is one of: DHCP: DHCP IPv6 configuration. This constant was added in vSphere API 7.0.0.0. STATIC: Static IPv6 configuration. This constant was added in vSphere API 7.0.0.0. USER_INPUT_REQUIRED: Indicates that the IPv6 settings are not specified in advance. The user must provide a valid value when the actual customization spec is applied to a virtual machine. This constant was added in vSphere API 7.0.0.0.
Optional
mac_address	string	The MAC address of a network adapter being customized. This attribute was added in vSphere API 7.0.0.0. Optional. If unset, the customization process maps the the settings from the list of AdapterMappings.IPSettings in the vcenter.guest.customization_spec.interfaces to the virtual machine's network adapters, in PCI slot order. The first virtual network adapter on the PCI bus is assigned interfaces[0].IPSettings, the second adapter is assigned interfaces[1].IPSettings, and so on.
adapter.ipv4	ipv4	Specification to configure IPv4 address, subnet mask and gateway info for this virtual network adapter. This attribute was added in vSphere API 7.0.0.0. Optional. If unset, no IPv4 addresses are set.
adapter.ipv4.ip_address	string	The static IPv4 address. This attribute was added in vSphere API 7.0.0.0. Optional. It is only relevant when type has value STATIC. This field is optional and it is only relevant when the value of `type` is STATIC.
adapter.ipv4.prefix	long	The IPv4 CIDR prefix, for example, 24. See http://www.oav.net/mirrors/cidr.html for netmask-to-prefix conversion. This attribute was added in vSphere API 7.0.0.0. Optional. It is only relevant when type has value STATIC. This field is optional and it is only relevant when the value of `type` is STATIC.
adapter.ipv4.gateways	string[]	Gateways for the IPv4 address. This attribute was added in vSphere API 7.0.0.0. Optional. If unset, no gateways are set.
adapter.ipv6	ipv6	Specification to configure IPv6 address, subnet mask and gateway info for this virtual network adapter. This attribute was added in vSphere API 7.0.0.0. Optional. If unset, no IPv6 addresses are set.
adapter.ipv6.ipv6	ipv6_address[]	IPv6 address. This attribute was added in vSphere API 7.0.0.0. Optional. It is only relevant when type has value STATIC. This field is optional and it is only relevant when the value of `type` is STATIC.
adapter.ipv6.gateways	string[]	gateways for the IPv6 address. This attribute was added in vSphere API 7.0.0.0. Optional. If unset, no gateways are set.
adapter.windows	windows_network_adapter_settings	Windows settings to be configured for this specific virtual Network adapter. This is valid only for Windows guest operating systems. This attribute was added in vSphere API 7.0.0.0. Optional. If unset, no specific Windows settings are set.
adapter.windows.dns_servers	string[]	A list of server IP addresses to use for DNS lookup in a Windows guest operating system. These servers should be specified in the order of preference. If this list is not empty, and if a DHCP IP address is used, then these settings override the DHCP settings. . This attribute was added in vSphere API 7.0.0.0. Optional. If unset, no DNS servers are set.
adapter.windows.dns_domain	string	A DNS domain suffix such as vmware.com. This attribute was added in vSphere API 7.0.0.0. Optional. If unset, no DNS domain is set.
adapter.windows.wins_servers	string[]	List of WINS Servers to set for the Windows guest operating system. A Maximum of two IP addresses can be specified in this list. The first IP address will be set as the primary WINS server. The second IP address will be set as the secondary WINS server. This attribute was added in vSphere API 7.0.0.0. Optional. If unset, no WINS Servers are set.
adapter.windows.net_BIOS_mode	string	NetBIOS setting for Windows. This attribute was added in vSphere API 7.0.0.0. Optional. If unset, existing NetBIOS mode will be retained.