GetIpSubnetMappings
This method returns an array of the IP subnet mappings for this IP Subnet
Mapper.
Synopsis
IPSubnetMapping[] getIpSubnetMappings();
IPSubnetMapping
represents an association between a mapped
network on the primary site with an IPMapping describing IP parameter translation
during IP Subnet based customization. It has the following fields:Field | Description |
|---|---|
primaryObject
| Network on the primary (protected) site |
secondaryObject
| Network on the secondary (recovery) site |
IPMapping ipMapping
| IPMapping to apply to the destination network
during IP customization |
IPMapping defines the rule(s) used to
translate VM's IP settings between protection and recovery sites. IPMapping can be
associated with a protected site's
vim.Network
mapped to a
recovery site's vim.Network
with
InventoryMapping.addNetworkMapping
method. This allows IP
settings for the recovered VMs be deduced based on the IP subnet parameters without
a need to configure IP settings for each protected VM individually. It has the
following fields:Field | Description |
|---|---|
name
| Name of the IP mapping. |
@optional SubnetRule[]
rules
| A set of network rules to evaluate/apply during
recovery. The rules are evaluated in the order they are specified.
SRM applies the first matched rule. |
SubnetRule
describes
the mapping between protection site IP parameters to recovery site ones for a single
IP subnet. It has the following fields:
Field | Description |
|---|---|
name | Name of the Rule. |
recoverySiteSubnet | CIDR specifying the recovery site
subnet. |
protectedSiteSubnet | CIDR specifying the protected site
subnet. |
@optional IPSettings
recoverySiteIPSettings | IP settings to be applied for all matched
network adapters on the recovery site when executing Test and
Failover workflows. |
dnsSuffixes[] | DNS Suffixes to be applied to all matched
network adapters. |
IPSettings is the IP customization info
for a specific network adapter. It has the following fields:
Field | Description |
|---|---|
ipV4Gateways | List of IPv4 gateways in the order of
preference. |
ipV6Gateways | List of IPv6 gateways in the order of
preference. |
dnsServerList | List of server IP addresses to use for DNS
lookup. |
In Windows, these settings are
adapter-specific. In Linux they are used to build a global list of DNS servers for
all adapters. Specify these servers in order of preference. If set in case of DHCP,
the explicit DNS server list overrides the default DNS configuration acquired
through DHCP protocol.
WindowsIPSettings is an extension for
IPSettings. It is used for setting Windows specific IP customization information for
a specific network adapter.
Field | Description |
|---|---|
domainName
| A connection-specific DNS domain name. |
wins
| The IP addresses of the primary and secondary WINS
servers. The first element in this array is always the address of
the primary WINS server and if a second element exists, it is the
address of the secondary WINS server. |
netBios
| NetBIOS setting. Possible values are the constants
defined by NetBiosMode enum. |
NetBiosMode
is used
for configuring NetBIOS on Windows systems. The values correspond directly to
Microsoft constants for NetBIOS mode. It enumerates the following:Value | Description |
|---|---|
enableNetBiosViaDhcp
| Enables the DHCP server to decide whether or not
to use NetBIOS. |
enableNetBios
| Explicitly enables NetBIOS. |
disableNetBios
| Explicitly disables NetBIOS. |
Faults
- RuntimeFault
For information about the faults that
Site
Recovery Manager
throws, see Faults in Site Recovery Manager API.