com.vmware.appliance.networking package

Submodules

com.vmware.appliance.networking.dns_client module

class com.vmware.appliance.networking.dns_client.Domains(config)

Bases: VapiInterface

Domains class provides methods DNS search domains.

Parameters:

config (vmware.vapi.bindings.stub.StubConfiguration) – Configuration to be used for creating the stub.

add(domain)

Add domain to DNS search domains.

Parameters:

domain (str) – Domain to add.

Raise:

com.vmware.vapi.std.errors_client.Error Generic error

list()

Get list of DNS search domains.

Return type:

list of str

Returns:

List of domains.

Raise:

com.vmware.vapi.std.errors_client.Error Generic error

set(domains)

Set DNS search domains.

Parameters:

domains (list of str) – List of domains.

Raise:

com.vmware.vapi.std.errors_client.Error Generic error

class com.vmware.appliance.networking.dns_client.Hostname(config)

Bases: VapiInterface

Hostname class provides methods Performs operations on Fully Qualified Doman Name.

Parameters:

config (vmware.vapi.bindings.stub.StubConfiguration) – Configuration to be used for creating the stub.

class Message(message=None, result=None)

Bases: VapiStruct

Hostname.Message class Test result and message

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:
class MessageStatus(string)

Bases: Enum

Hostname.MessageStatus class Individual test result

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters:

string (str) – String value for the MessageStatus instance.

failure = MessageStatus(string='failure')

message indicates the test failed.

success = MessageStatus(string='success')

message indicates that the test was successful.

class TestStatus(string)

Bases: Enum

Hostname.TestStatus class Health indicator

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters:

string (str) – String value for the TestStatus instance.

green = TestStatus(string='green')

All tests were successful for given data

orange = TestStatus(string='orange')

In case data has more than one test, this indicates not all tests were successful

red = TestStatus(string='red')

All tests failed for given data

class TestStatusInfo(status=None, messages=None)

Bases: VapiStruct

Hostname.TestStatusInfo class Overall test result

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:
get()

Get the Fully Qualified Doman Name.

Return type:

str

Returns:

FQDN.

Raise:

com.vmware.vapi.std.errors_client.Error Generic error

set(name)

Set the Fully Qualified Domain Name.

Parameters:

name (str) – FQDN.

Raise:

com.vmware.vapi.std.errors_client.Error Generic error

test(name)

Test the Fully Qualified Domain Name.

Parameters:

name (str) – FQDN.

Return type:

Hostname.TestStatusInfo

Returns:

FQDN status

Raise:

com.vmware.vapi.std.errors_client.Error Generic error

class com.vmware.appliance.networking.dns_client.Servers(config)

Bases: VapiInterface

Servers class provides methods DNS server configuration.

Parameters:

config (vmware.vapi.bindings.stub.StubConfiguration) – Configuration to be used for creating the stub.

class DNSServerConfig(mode=None, servers=None)

Bases: VapiStruct

Servers.DNSServerConfig class This structure represents the configuration state used to determine DNS servers.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:
  • mode (Servers.DNSServerMode) – Define how to determine the DNS servers. Leave the servers argument empty if the mode argument is “DHCP”. Set the servers argument to a comma-separated list of DNS servers if the mode argument is “static”. The DNS server are assigned from the specified list.

  • servers (list of str) – List of the currently used DNS servers.

class DNSServerMode(string)

Bases: Enum

Servers.DNSServerMode class Describes DNS Server source (DHCP,static)

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters:

string (str) – String value for the DNSServerMode instance.

dhcp = DNSServerMode(string='dhcp')

DNS address is automatically assigned by a DHCP server.

is_static = DNSServerMode(string='is_static')

DNS address is static.

class Message(message=None, result=None)

Bases: VapiStruct

Servers.Message class Test result and message

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:
class MessageStatus(string)

Bases: Enum

Servers.MessageStatus class Individual test result

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters:

string (str) – String value for the MessageStatus instance.

failure = MessageStatus(string='failure')

message indicates the test failed.

success = MessageStatus(string='success')

message indicates that the test was successful.

class TestStatus(string)

Bases: Enum

Servers.TestStatus class Health indicator

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters:

string (str) – String value for the TestStatus instance.

green = TestStatus(string='green')

All tests were successful for given data

orange = TestStatus(string='orange')

In case data has more than one test, this indicates not all tests were successful

red = TestStatus(string='red')

All tests failed for given data

class TestStatusInfo(status=None, messages=None)

Bases: VapiStruct

Servers.TestStatusInfo class Overall test result

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:
add(server)

Add a DNS server. This method fails if mode argument is “dhcp”

Parameters:

server (str) – DNS server.

Raise:

com.vmware.vapi.std.errors_client.Error Generic error

get()

Get DNS server configuration.

Return type:

Servers.DNSServerConfig

Returns:

DNS server configuration.

Raise:

com.vmware.vapi.std.errors_client.Error Generic error

set(config)

Set the DNS server configuration. If you set the mode argument to “DHCP”, a DHCP refresh is forced.

Parameters:

config (Servers.DNSServerConfig) – DNS server configuration.

Raise:

com.vmware.vapi.std.errors_client.Error Generic error

test(servers)

Test if dns servers are reachable.

Parameters:

servers (list of str) – DNS servers.

Return type:

Servers.TestStatusInfo

Returns:

DNS reacable status

Raise:

com.vmware.vapi.std.errors_client.Error Generic error

class com.vmware.appliance.networking.dns_client.StubFactory(stub_config)

Bases: StubFactoryBase

Initialize StubFactoryBase

Parameters:

stub_config (vmware.vapi.bindings.stub.StubConfiguration) – Stub config instance

com.vmware.appliance.networking.firewall_client module

class com.vmware.appliance.networking.firewall_client.Inbound(config)

Bases: VapiInterface

The Inbound class provides methods to manage inbound firewall rules. This class was added in vSphere API 6.7.1.

Parameters:

config (vmware.vapi.bindings.stub.StubConfiguration) – Configuration to be used for creating the stub.

class Policy(string)

Bases: Enum

Inbound.Policy class Defines firewall rule policies. This enumeration was added in vSphere API 6.7.1.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters:

string (str) – String value for the Policy instance.

ACCEPT = Policy(string='ACCEPT')

Allow packet with corresponding address. This class attribute was added in vSphere API 6.7.1.

IGNORE = Policy(string='IGNORE')

Drop packet with correpsonding address. This class attribute was added in vSphere API 6.7.1.

REJECT = Policy(string='REJECT')

Drop packet with corresponding address sending destination is not reachable. This class attribute was added in vSphere API 6.7.1.

RETURN = Policy(string='RETURN')

Apply default or port-specific rules to packet with corresponding address. This class attribute was added in vSphere API 6.7.1.

class Rule(address=None, prefix=None, policy=None, interface_name=None)

Bases: VapiStruct

Inbound.Rule class Structure that defines a single address-based firewall rule. This class was added in vSphere API 6.7.1.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:
  • address (str) – IPv4 or IPv6 address. This attribute was added in vSphere API 6.7.1.

  • prefix (long) – CIDR prefix used to mask address. For example, an IPv4 prefix of 24 ignores the low-order 8 bits of address. This attribute was added in vSphere API 6.7.1.

  • policy (Inbound.Policy) – The allow or deny policy of this rule. This attribute was added in vSphere API 6.7.1.

  • interface_name (str or None) – The interface to which this rule applies. An empty string indicates that the rule applies to all interfaces. This attribute was added in vSphere API 6.7.1.

get()

Get the ordered list of firewall rules. Within the list of traffic rules, rules are processed in order of appearance, from top to bottom. When a connection matches a firewall rule, further processing for the connection stops, and the appliance ignores any additional firewall rules you have set. This method was added in vSphere API 6.7.1.

Return type:

list of Inbound.Rule

Returns:

List of address-based firewall rules.

Raise:

com.vmware.vapi.std.errors_client.Error Generic error

set(rules)

Set the ordered list of firewall rules to allow or deny traffic from one or more incoming IP addresses. This overwrites the existing firewall rules and creates a new rule list. Within the list of traffic rules, rules are processed in order of appearance, from top to bottom. For example, the list of rules can be as follows:

Address

Prefix

Interface Name

Policy

10.112.0.1

0

*

REJECT

10.112.0.1

0

nic0

ACCEPT

In the above example, the first rule drops all packets originating from 10.112.0.1 and the second rule accepts all packets originating from 10.112.0.1 only on nic0. In effect, the second rule is always ignored which is not desired, hence the order has to be swapped. When a connection matches a firewall rule, further processing for the connection stops, and the appliance ignores any additional firewall rules you have set. This method was added in vSphere API 6.7.1.

Parameters:

rules (list of Inbound.Rule) – List of address-based firewall rules.

Raise:

com.vmware.vapi.std.errors_client.Error Generic error

class com.vmware.appliance.networking.firewall_client.StubFactory(stub_config)

Bases: StubFactoryBase

Initialize StubFactoryBase

Parameters:

stub_config (vmware.vapi.bindings.stub.StubConfiguration) – Stub config instance

com.vmware.appliance.networking.interfaces_client module

class com.vmware.appliance.networking.interfaces_client.Ipv4(config)

Bases: VapiInterface

The Ipv4 class provides methods to perform IPv4 network configuration for interfaces. This class was added in vSphere API 6.7.

Parameters:

config (vmware.vapi.bindings.stub.StubConfiguration) – Configuration to be used for creating the stub.

class Config(mode=None, address=None, prefix=None, default_gateway=None)

Bases: VapiStruct

The Ipv4.Config class provides defines the IPv4 configuration of a network interface. This class was added in vSphere API 6.7.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:
  • mode (Ipv4.Mode) – The Address assignment mode. This attribute was added in vSphere API 6.7.

  • address (str) – The IPv4 address, for example, “10.20.80.191”. This attribute was added in vSphere API 6.7. This attribute is optional and it is only relevant when the value of mode is Ipv4.Mode.STATIC.

  • 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 6.7. This attribute is optional and it is only relevant when the value of mode is Ipv4.Mode.STATIC.

  • default_gateway (str or None) – The IPv4 address of the default gateway. This configures the global 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. If None, the defaultGateway was never set.

class Info(configurable=None, mode=None, address=None, prefix=None, default_gateway=None)

Bases: VapiStruct

The Ipv4.Info class defines current IPv4 configuration state of a network interface. This class was added in vSphere API 6.7.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:
  • configurable (bool) – The specified network interface is configurable or not. This attribute was added in vSphere API 6.7.

  • mode (Ipv4.Mode) – The Address assignment mode. This attribute was added in vSphere API 6.7.

  • address (str) – The IPv4 address, for example, “10.20.80.191”. This attribute was added in vSphere API 6.7. This attribute is optional and it is only relevant when the value of mode is one of Ipv4.Mode.STATIC or Ipv4.Mode.DHCP.

  • 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 6.7. This attribute is optional and it is only relevant when the value of mode is one of Ipv4.Mode.STATIC or Ipv4.Mode.DHCP.

  • default_gateway (str) – The IPv4 address of the default gateway. This configures the global 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. This attribute is optional and it is only relevant when the value of mode is one of Ipv4.Mode.STATIC or Ipv4.Mode.DHCP.

class Mode(string)

Bases: Enum

The Ipv4.Mode class defines different IPv4 address assignment modes. This enumeration was added in vSphere API 6.7.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters:

string (str) – String value for the Mode instance.

DHCP = Mode(string='DHCP')

The IPv4 address is automatically assigned by a DHCP server. This class attribute was added in vSphere API 6.7.

STATIC = Mode(string='STATIC')

The IPv4 address is static. This class attribute was added in vSphere API 6.7.

UNCONFIGURED = Mode(string='UNCONFIGURED')

The IPv4 protocol is not configured. This class attribute was added in vSphere API 6.7.

get(interface_name)

Get IPv4 network configuration for specific NIC. This method was added in vSphere API 6.7.

Parameters:

interface_name (str) – The Network interface to query, for example, “nic0”. The parameter must be an identifier for the resource type: com.vmware.appliance.networking.interfaces.

Return type:

Ipv4.Info

Returns:

The IPv4 configuration for the queried NIC.

Raise:

com.vmware.vapi.std.errors_client.NotFound if the specified NIC is not found.

Raise:

com.vmware.vapi.std.errors_client.Error Generic error.

set(interface_name, config)

Set IPv4 network configuration for specific network interface. This method was added in vSphere API 6.7.

Parameters:
  • interface_name (str) – Network interface to update, for example, “nic0”. The parameter must be an identifier for the resource type: com.vmware.appliance.networking.interfaces.

  • config (Ipv4.Config) – The IPv4 Network configuration to set.

Raise:

com.vmware.vapi.std.errors_client.NotFound if the specified NIC is not found.

Raise:

com.vmware.vapi.std.errors_client.NotAllowedInCurrentState if the IP is used as PNID

Raise:

com.vmware.vapi.std.errors_client.ResourceBusy if the specified NIC is busy.

Raise:

com.vmware.vapi.std.errors_client.Error Generic error.

class com.vmware.appliance.networking.interfaces_client.Ipv6(config)

Bases: VapiInterface

The Ipv6 class provides methods to perform IPv6 network configuration for interfaces. This class was added in vSphere API 6.7.

Parameters:

config (vmware.vapi.bindings.stub.StubConfiguration) – Configuration to be used for creating the stub.

class Address(address=None, prefix=None)

Bases: VapiStruct

The Ipv6.Address class provides the structure used to name an IPv6 address. This class was added in vSphere API 6.7.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:
  • address (str) – The IPv6 address, for example, fc00:10:20:83:20c:29ff:fe94:bb5a. This attribute was added in vSphere API 6.7.

  • prefix (long) – The IPv6 CIDR prefix, for example, 64. This attribute was added in vSphere API 6.7.

class AddressInfo(origin=None, status=None, address=None, prefix=None)

Bases: VapiStruct

The Ipv6.AddressInfo class provides the structure that you can use to get information about an IPv6 address along with its origin and status. This class was added in vSphere API 6.7.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:
  • origin (Ipv6.Origin) – The Origin of the IPv6 address. For more information, see RFC 4293. This attribute was added in vSphere API 6.7.

  • status (Ipv6.Status) – The Status of the IPv6 address. For more information, see RFC 4293. This attribute was added in vSphere API 6.7.

  • address (str) – The IPv6 address, for example, fc00:10:20:83:20c:29ff:fe94:bb5a. This attribute was added in vSphere API 6.7.

  • prefix (long) – The IPv6 CIDR prefix, for example, 64. This attribute was added in vSphere API 6.7.

class Config(dhcp=None, autoconf=None, addresses=None, default_gateway=None)

Bases: VapiStruct

The Ipv6.Config class provides the structure that you can use to configure IPv6 on a particular interface. Addresses can be assigned by DHCP, SLAAC or STATIC, as IPv6 permits multiple addresses per interface. This class was added in vSphere API 6.7.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:
  • dhcp (bool) – An address will be assigned by a DHCP server. This attribute was added in vSphere API 6.7.

  • autoconf (bool) – An address will be assigned by Stateless Address Autoconfiguration (SLAAC). This attribute was added in vSphere API 6.7.

  • addresses (list of Ipv6.Address) – The list of addresses to be statically assigned. This attribute was added in vSphere API 6.7.

  • default_gateway (str) – 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.

class Info(dhcp=None, autoconf=None, addresses=None, default_gateway=None, configurable=None)

Bases: VapiStruct

The Ipv6.Info class provides the structure that defines an existing IPv6 configuration on a particular interface. This structure is read only. This class was added in vSphere API 6.7.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:
  • dhcp (bool) – DHCP is on. This attribute was added in vSphere API 6.7.

  • autoconf (bool) – Stateless Address Autoconfiguration (SLAAC) is on. This attribute was added in vSphere API 6.7.

  • addresses (list of Ipv6.AddressInfo) – List of addresses with their origins and statuses. This attribute was added in vSphere API 6.7.

  • default_gateway (str) – 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.

  • configurable (bool) – Is NIC configurable or not. This attribute was added in vSphere API 6.7.

class Origin(string)

Bases: Enum

The Ipv6.Origin class defines IPv6 address origin values. This enumeration was added in vSphere API 6.7.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters:

string (str) – String value for the Origin instance.

DHCP = Origin(string='DHCP')

The IPv6 address is assigned by a DHCP server. See RFC 4293. This class attribute was added in vSphere API 6.7.

LINKLAYER = Origin(string='LINKLAYER')

The IPv6 address is assigned by IPv6 Stateless Address Auto-configuration (SLAAC). See RFC 4293. This class attribute was added in vSphere API 6.7.

MANUAL = Origin(string='MANUAL')

The IPv6 address was manually configured to a specified address, for example, by user configuration. See RFC 4293. This class attribute was added in vSphere API 6.7.

OTHER = Origin(string='OTHER')

The IPv6 address is assigned by a mechanism other than manual, DHCP, SLAAC, or random. See RFC 4293. This class attribute was added in vSphere API 6.7.

RANDOM = Origin(string='RANDOM')

The IPv6 address is assigned randomly by the system. See RFC 4293. This class attribute was added in vSphere API 6.7.

class Status(string)

Bases: Enum

The Ipv6.Status class defines IPv6 address status values. See RFC 4293. This enumeration was added in vSphere API 6.7.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters:

string (str) – String value for the Status instance.

DEPRECATED = Status(string='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 class attribute was added in vSphere API 6.7.

DUPLICATE = Status(string='DUPLICATE')

The IPv6 address is not unique on the link and cannot be used. This class attribute was added in vSphere API 6.7.

INACCESSIBLE = Status(string='INACCESSIBLE')

The IPv6 address is inaccessible because the interface to which this address is assigned is not operational. This class attribute was added in vSphere API 6.7.

INVALID = Status(string='INVALID')

The IPv6 address is not a valid address. It should not appear as the destination or source address of a packet. This class attribute was added in vSphere API 6.7.

OPTIMISTIC = Status(string='OPTIMISTIC')

The IPv6 address is available for use, subject to restrictions, while its uniqueness on a link is being verified. This class attribute was added in vSphere API 6.7.

PREFERRED = Status(string='PREFERRED')

This is a valid IPv6 address that can appear as the destination or source address of a packet. This class attribute was added in vSphere API 6.7.

TENTATIVE = Status(string='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 class attribute was added in vSphere API 6.7.

UNKNOWN = Status(string='UNKNOWN')

The status of this address cannot be determined. This class attribute was added in vSphere API 6.7.

get(interface_name)

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

Parameters:

interface_name (str) – Network interface to query, for example, “nic0”. The parameter must be an identifier for the resource type: com.vmware.appliance.networking.interfaces.

Return type:

Ipv6.Info

Returns:

IPv6 configuration.

Raise:

com.vmware.vapi.std.errors_client.NotFound if the specified NIC is not found.

Raise:

com.vmware.vapi.std.errors_client.Error Generic error.

set(interface_name, config)

Set IPv6 network configuration for specific interface. This method was added in vSphere API 6.7.

Parameters:
  • interface_name (str) – Network interface to update, for example, “nic0”. The parameter must be an identifier for the resource type: com.vmware.appliance.networking.interfaces.

  • config (Ipv6.Config) – The IPv6 configuration.

Raise:

com.vmware.vapi.std.errors_client.ResourceBusy The specified NIC is busy.

Raise:

com.vmware.vapi.std.errors_client.NotFound The specified NIC is not found.

Raise:

com.vmware.vapi.std.errors_client.Error Generic error.

class com.vmware.appliance.networking.interfaces_client.StubFactory(stub_config)

Bases: StubFactoryBase

Initialize StubFactoryBase

Parameters:

stub_config (vmware.vapi.bindings.stub.StubConfiguration) – Stub config instance