saltext.vmware.modules.vmc_networks#

Salt execution module for VMC Networks Provides methods to Create, Read, Update and Delete Networks/Segments.

saltext.vmware.modules.vmc_networks.get(hostname, refresh_key, authorization_host, org_id, sddc_id, verify_ssl=True, cert=None, sort_by=None, sort_ascending=None, page_size=None, cursor=None)[source]#

Retrieves networks/segments for Given SDDC

CLI Example:

salt vm_minion vmc_networks.get hostname=nsxt-manager.local...

hostname: The host name of NSX-T manager
refresh_key: API Token of the user which is used to get the Access Token required for VMC operations
authorization_host: Hostname of the VMC cloud console
org_id: The Id of organization to which the SDDC belongs to
sddc_id: The Id of SDDC for which the networks/segments should be retrieved
verify_ssl: (Optional) Option to enable/disable SSL verification. Enabled by default. If set to False, the certificate validation is skipped.
cert: (Optional) Path to the SSL client certificate file to connect to VMC Cloud Console. The certificate can be retrieved from browser.
sort_by: (Optional) Field by which records are sorted
sort_ascending: (Optional) Boolean value to sort result in ascending order. Enabled by default.
page_size: (Optional) Maximum number of results to return in this page. Default page size is 1000.
cursor: (Optional) Opaque cursor to be used for getting next page of records (supplied by current result page)

saltext.vmware.modules.vmc_networks.get_by_id(hostname, refresh_key, authorization_host, org_id, sddc_id, network_id, verify_ssl=True, cert=None)[source]#

Retrieves given network/segment from the given SDDC

CLI Example:

salt vm_minion vmc_networks.get_by_id hostname=nsxt-manager.local network_id=web-tier ...

hostname: The host name of NSX-T manager
refresh_key: API Token of the user which is used to get the Access Token required for VMC operations
authorization_host: Hostname of the VMC cloud console
org_id: The Id of organization to which the SDDC belongs to
sddc_id: The Id of SDDC for which the network/segment should be retrieved
network_id: Id of the network/segment to be retrieved from SDDC
verify_ssl: (Optional) Option to enable/disable SSL verification. Enabled by default. If set to False, the certificate validation is skipped.
cert: (Optional) Path to the SSL client certificate file to connect to VMC Cloud Console. The certificate can be retrieved from browser.

saltext.vmware.modules.vmc_networks.delete(hostname, refresh_key, authorization_host, org_id, sddc_id, network_id, verify_ssl=True, cert=None)[source]#

Deletes given network/segment from the given SDDC

CLI Example:

salt vm_minion vmc_networks.delete hostname=nsxt-manager.local network_id=web-tier ...

hostname: The host name of NSX-T manager
refresh_key: API Token of the user which is used to get the Access Token required for VMC operations
authorization_host: Hostname of the VMC cloud console
org_id: The Id of organization to which the SDDC belongs to
sddc_id: The Id of SDDC from which the network/segment should be deleted
network_id: Id of the network/segment to be deleted from SDDC
verify_ssl: (Optional) Option to enable/disable SSL verification. Enabled by default. If set to False, the certificate validation is skipped.
cert: (Optional) Path to the SSL client certificate file to connect to VMC Cloud Console. The certificate can be retrieved from browser.

saltext.vmware.modules.vmc_networks.create(hostname, refresh_key, authorization_host, org_id, sddc_id, network_id, verify_ssl=True, cert=None, subnets='USER_DEFINED_NONE', admin_state=None, description=None, domain_name=None, tags='USER_DEFINED_NONE', advanced_config=None, l2_extension='USER_DEFINED_NONE', dhcp_config_path=None)[source]#

Creates network/segment for the given SDDC

CLI Example:

salt vm_minion vmc_networks.create hostname=nsxt-manager.local network_id=web-tier ...

hostname

The host name of NSX-T manager

refresh_key

API Token of the user which is used to get the Access Token required for VMC operations

authorization_host

Hostname of the VMC cloud console

org_id

The Id of organization to which the SDDC belongs to

sddc_id

The Id of SDDC for which the network/segment should be added

network_id

Id of the network/segment to be added to given SDDC

verify_ssl

(Optional) Option to enable/disable SSL verification. Enabled by default. If set to False, the certificate validation is skipped.

cert

(Optional) Path to the SSL client certificate file to connect to VMC Cloud Console. The certificate can be retrieved from browser.

subnets

Subnet configuration required for ROUTED or DISCONNECTED segment/network. It is an array of SegmentSubnet. Can contain maximum 1 subnet.

SegmentSubnet can contain the below fields.

‘gateway_address’: (string)

Gateway IP address in CIDR format for both IPv4 and IPv6.

‘dhcp_ranges’: (optional)

DHCP address ranges are used for dynamic IP allocation. Supports address range and CIDR formats. First valid host address from the first value is assigned to DHCP server IP address. Existing values cannot be deleted or modified, but additional DHCP ranges can be added.

It is an array of IPElement (which can be a single IP address, IP address range or a Subnet. Its type can be of IPv4 or IPv6).

‘dhcp_config’: (optional)

Additional DHCP configuration for current subnet. It is of type SegmentDhcpConfig which can contain the below fields.

‘resource_type’:: can be either SegmentDhcpV4Config or SegmentDhcpV6Config.
‘lease_time’:: DHCP lease time in seconds. When specified, this property overwrites lease time configured DHCP server config. Minimum is 60, Maximum is 4294967295 and Default is 86400.
‘server_address’:: IP address of the DHCP server in CIDR format. The server_address is mandatory in case this segment has provided a dhcp_config_path and it represents a DHCP server config. If the resource_type is a SegmentDhcpV4Config, the address must be an IPv4 address. If the resource_type is a SegmentDhcpV6Config, the address must be an IPv6 address. This address must not overlap the ip-ranges of the subnet, or the gateway address of the subnet, or the DHCP static-binding addresses of this segment.
‘dns_servers’:: IP address of DNS servers for subnet. DNS server IP address must belong to the same address family as segment gateway_address property. Maximum items: 2

For ex:

"subnets": [
    {
        "gateway_address": "100.1.1.1/16",
        "dhcp_ranges": [
            "10.22.12.2/24"
        ],
        "dhcp_config": {
            "resource_type": "SegmentDhcpV4Config",
            "lease_time": "8000",
            "server_address": "100.1.0.0/16",
            "dns_servers": [
                "10.22.12.0"
            ]
        }
    }
]

admin_state

(Optional) Represents Desired state of the Segment. Possible values: UP, DOWN If this value is not passed, then the vmc-nsx server assigns “UP” as default value.

description

(Optional) Description of this resource

domain_name

(Optional) DNS domain name.

tags

(Optional) Opaque identifiers meaningful to the user.

tags='[
    {
        "tag": "<tag-key-1>"
        "scope": "<tag-value-1>"
    },
    {
        "tag": "<tag-key-2>"
        "scope": "<tag-value-2>"
    }
]'

advanced_config

(Optional) Advanced configuration for Segment. It is a json object which can contain the below fields.

‘connectivity’: (String) (optional)

configuration to manually connect (ON) or disconnect (OFF) a Tier1 segment from corresponding Tier1 gateway. Only valid for Tier1 Segments. This property is ignored for L2 VPN extended segments when subnets property is not specified. Possible values: ON, OFF. If not specified, default will be “ON”

Note: To create a network/segment of type DISCONNECTED, or to disconnect a ROUTED Segment specify the connectivity value as “OFF”

‘address_pool_paths’: (array of string) (optional)

Policy path to IP address pools. Maximum items it can contain is 1.

For ex:

"advanced_config": {
    "address_pool_paths": [],
    "connectivity": "ON"
}

l2_extension

Configuration for extending Segment through L2 VPN. This field is mandatory for EXTENDED segment/network. It is a json object which can contain the below fields.

‘l2vpn_paths’: (array of string): Policy paths corresponding to the associated L2 VPN sessions
‘tunnel_id’: (int): Tunnel ID. Minimum value is 1 and Maximum value is 4093

For ex:

"l2_extension": {
    "l2vpn_paths": [
        "/infra/tier-0s/vmc/locale-services/default/l2vpn-services/default/sessions/c1373cd0-b2f0-11eb
        -80f4-d1a84667de41"
    ],
    "tunnel_id": "10"
}

dhcp_config_path

(Optional) Policy path to DHCP configuration. Policy path to DHCP server or relay configuration to use for all IPv4 & IPv6 subnets configured on this segment.

Example values:

{
    "subnets": [
        {
            "gateway_address": "40.1.1.1/16",
            "dhcp_ranges": [ "40.1.2.0/24" ]
        }
    ],
    "admin_state": "UP",
    "description": "network segment",
    "domain_name": "net.eng.vmware.com",
    "tags": [
        {
            "tag": "tag1",
            "scope": "scope1"
        }
    ],
    "advanced_config": {
        "address_pool_paths": [],
        "connectivity": "ON"
    },
    "l2_extension": null,
    "dhcp_config_path": "/infra/dhcp-server-configs/default"
}

saltext.vmware.modules.vmc_networks.update(hostname, refresh_key, authorization_host, org_id, sddc_id, network_id, verify_ssl=True, cert=None, subnets='USER_DEFINED_NONE', admin_state=None, description=None, domain_name=None, tags='USER_DEFINED_NONE', advanced_config=None, l2_extension='USER_DEFINED_NONE', dhcp_config_path=None, display_name=None)[source]#

Updates network/segment for the given SDDC

CLI Example:

salt vm_minion vmc_networks.update hostname=nsxt-manager.local network_id=web-tier ...

hostname

The host name of NSX-T manager

refresh_key

API Token of the user which is used to get the Access Token required for VMC operations

authorization_host

Hostname of the VMC cloud console

org_id

The Id of organization to which the SDDC belongs to

sddc_id

The Id of SDDC for which the network/segment belongs to

network_id

Id of the network/segment to be updated for given SDDC

verify_ssl

(Optional) Option to enable/disable SSL verification. Enabled by default. If set to False, the certificate validation is skipped.

cert

(Optional) Path to the SSL client certificate file to connect to VMC Cloud Console. The certificate can be retrieved from browser.

subnets

Subnet configuration required for ROUTED or DISCONNECTED segment/network. It is an array of SegmentSubnet. Can contain maximum 1 subnet. SegmentSubnet can contain the below fields.

‘gateway_address’: (string)

Gateway IP address in CIDR format for both IPv4 and IPv6.

‘dhcp_ranges’: (optional)

It is an array of IPElement (which can be a single IP address, IP address range or a Subnet. Its type can be of IPv4 or IPv6).

‘dhcp_config’: (optional)

Additional DHCP configuration for current subnet. It is of type SegmentDhcpConfig which can contain the below fields.

‘resource_type’:: can be either SegmentDhcpV4Config or SegmentDhcpV6Config.
‘lease_time’:: DHCP lease time in seconds. When specified, this property overwrites lease time configured DHCP server config. Minimum is 60, Maximum is 4294967295 and Default is 86400.
‘server_address’:: IP address of the DHCP server in CIDR format. The server_address is mandatory in case this segment has provided a dhcp_config_path and it represents a DHCP server config. If the resource_type is a SegmentDhcpV4Config, the address must be an IPv4 address. If the resource_type is a SegmentDhcpV6Config, the address must be an IPv6 address. This address must not overlap the ip-ranges of the subnet, or the gateway address of the subnet, or the DHCP static-binding addresses of this segment.
‘dns_servers’:: IP address of DNS servers for subnet. DNS server IP address must belong to the same address family as segment gateway_address property. Maximum items: 2

For ex:

"subnets": [
    {
        "gateway_address": "100.1.1.1/16",
        "dhcp_ranges": [
            "10.22.12.2/24"
        ],
        "dhcp_config": {
            "resource_type": "SegmentDhcpV4Config",
            "lease_time": "8000",
            "server_address": "100.1.0.0/16",
            "dns_servers": [
                "10.22.12.0"
            ]
        }
    }
]

admin_state

(Optional) Represents Desired state of the Segment. Possible values: UP, DOWN If this value is not passed, then the vmc-nsx server assigns “UP” as default value.

description

(Optional) Description of this resource

domain_name

(Optional) DNS domain name.

tags

(Optional) Opaque identifiers meaningful to the user.

tags='[
    {
        "tag": "<tag-key-1>"
        "scope": "<tag-value-1>"
    },
    {
        "tag": "<tag-key-2>"
        "scope": "<tag-value-2>"
    }
]'

advanced_config

(Optional) Advanced configuration for Segment. It is a json object which can contain the below fields.

‘connectivity’: (String) (optional)

Note: To create a network/segment of type DISCONNECTED, or to disconnect a ROUTED Segment specify the connectivity value as “OFF”

‘address_pool_paths’: (array of string) (optional)

Policy path to IP address pools. Maximum items it can contain is 1.

For ex:

"advanced_config": {
    "address_pool_paths": [],
    "connectivity": "ON"
}

l2_extension

Configuration for extending Segment through L2 VPN. This field is mandatory for EXTENDED segment/network. It is a json object which can contain the below fields.

‘l2vpn_paths’: (array of string): Policy paths corresponding to the associated L2 VPN sessions
‘tunnel_id’: (int): Tunnel ID. Minimum value is 1 and Maximum value is 4093

For ex:

"l2_extension": {
    "l2vpn_paths": [
        "/infra/tier-0s/vmc/locale-services/default/l2vpn-services/default/sessions/c1373cd0-b2f0-11eb
        -80f4-d1a84667de41"
    ],
    "tunnel_id": "10"
}

dhcp_config_path

(Optional) Policy path to DHCP configuration. Policy path to DHCP server or relay configuration to use for all IPv4 & IPv6 subnets configured on this segment.

display_name

Identifier to use when displaying entity in logs or GUI.

Example values:

{
    "display_name":"web-tier",
    "subnets": [
        {
            "gateway_address": "40.1.1.1/16",
            "dhcp_ranges": [ "40.1.2.0/24" ]
        }
    ],
    "admin_state": "UP",
    "description": "network segment",
    "domain_name": "net.eng.vmware.com",
    "tags": [
        {
            "tag": "tag1",
            "scope": "scope1"
        }
    ],
    "advanced_config": {
        "address_pool_paths": [],
        "connectivity": "ON"
    },
    "l2_extension": null,
    "dhcp_config_path": "/infra/dhcp-server-configs/default"
}