Address Range#

This class is used to manage Address Range

class AddressRange#
add(name, ip_address_first=None, ipv4_address_first=None, ipv6_address_first=None, ip_address_last=None, ipv4_address_last=None, ipv6_address_last=None, nat_settings=None, tags=None, **kw)#

Create new object.

Parameters

  • name (str) – Object name. Must be unique in the domain.

  • ip_address_first (str, optional) – First IP address in the range. If both IPv4 and IPv6 address ranges are required , use the ipv4-address-first and the ipv6-address-first fields instead. Mandatory if “ipv4_address_first” or “ipv6_address_first” is not set

  • ipv4_address_first (str, optional) – First IPv4 address in the range. Mandatory if “ip_address_first” or “ipv6_address_first” is not set

  • ipv6_address_first (str, optional) – First IPv6 address in the range. Mandatory if “ip_address_first” or “ipv4_address_first” is not set

  • ip_address_last (str, optional) – Last IP address in the range. If both IPv4 and IPv6 address ranges are required, use the ipv4-address-last and the ipv6-address-last fields instead. Mandatory if “ipv4_address_last” or “ipv6_address_last” is not set

  • ipv4_address_last (str, optional) – Last IPv4 address in the range. Mandatory if “ip_address_last” or “ipv6_address_last” is not set

  • ipv6_address_last (str, optional) – Last IPv6 address in the range. Mandatory if “ip_address_last” or “ipv4_address_last” is not set

  • nat_settings (dict, optional) – NAT settings.

  • tags (Union(str,List[str]), optional) – Collection of tag identifiers.

Keyword Arguments

  • **set-if-exists (bool, optional) – If another object with the same identifier already exists, it will be updated. The command behaviour will be the same as if originally a set command was called. Pay attention that original object’s fields will be overwritten by the fields provided in the request payload!

  • **color (Color, optional) – Color of the object. Should be one of existing colors.

  • **comments (str, optional) – Comments string.

  • **details-level (str, optional) – The level of detail for some of the fields in the response can vary from showing only the UID value of the object to a fully detailed representation of the object.

  • **groups (Union(str,List[str]), optional) – Collection of group identifiers.

  • **ignore-warnings (bool, optional) – Apply changes ignoring warnings. Defaults to False

  • **ignore-errors (bool, optional) – Apply changes ignoring errors. You won’t be able to publish such a changes. If ignore-warnings flag was omitted - warnings will also be ignored. Defaults to False

Returns

The response from the server

Return type

Box

Examples

>>> firewall.network_objects.address_range.add(name="New Address Range 1",

ip_address_first=”192.0.2.1”, ip_address_last=”192.0.2.10”,)

delete(uid=None, name=None, **kw)#

Delete existing object using object name or uid.

Parameters

  • uid (str, optional) – Object unique identifier.

  • name (str, optional) – Object name.

Keyword Arguments

  • **details-level (str, optional) – The level of detail for some of the fields in the response can vary from showing only the UID value of the object to a fully detailed representation of the object.

  • **ignore-warnings (bool, optional) – Apply changes ignoring warnings. Defaults to False

  • **ignore-errors (bool, optional) – Apply changes ignoring errors. You won’t be able to publish such a changes. If ignore-warnings flag was omitted - warnings will also be ignored. Defaults to False

Returns

The response from the server

Return type

Box

Examples

>>> firewall.network_objects.address_range.delete(uid="196e93a9-b90b-4ab1-baa6-124e7289aa20")
set(uid=None, name=None, ip_address_first=None, ipv4_address_first=None, ipv6_address_first=None, ip_address_last=None, ipv4_address_last=None, ipv6_address_last=None, new_name=None, nat_settings=None, tags=None, **kw)#

Create new object.

Parameters

  • name (str, optional) – Object name. Must be unique in the domain.

  • ip_address_first (str, optional) – First IP address in the range. If both IPv4 and IPv6 address ranges are required ,use the ipv4-address-first and the ipv6-address-first fields instead. Mandatory if “ipv4_address_first” or “ipv6_address_first” is not set

  • ipv4_address_first (str, optional) – First IPv4 address in the range. Mandatory if “ip_address_first” or “ipv6_address_first” is not set

  • ipv6_address_first (str, optional) – First IPv6 address in the range. Mandatory if “ip_address_first” or “ipv4_address_first” is not set

  • ip_address_last (str, optional) – Last IP address in the range. If both IPv4 and IPv6 address ranges are required, use the ipv4-address-last and the ipv6-address-last fields instead. Mandatory if “ipv4_address_last” or “ipv6_address_last” is not set

  • ipv4_address_last (str, optional) – Last IPv4 address in the range. Mandatory if “ip_address_last” or “ipv6_address_last” is not set

  • ipv6_address_last (str, optional) – Last IPv6 address in the range. Mandatory if “ip_address_last” or “ipv4_address_last” is not set

  • new_name (str, optional) – New name of the object.

  • nat_settings (dict, optional) – NAT settings.

  • tags (Union(str,List[str]), optional) – Collection of tag identifiers.

Keyword Arguments

  • **color (Color, optional) – Color of the object. Should be one of existing colors.

  • **comments (str, optional) – Comments string.

  • **details-level (str, optional) – The level of detail for some of the fields in the response can vary from showing only the UID value of the object to a fully detailed representation of the object.

  • **groups (Union(str,List[str]), optional) – Collection of group identifiers.

  • **ignore-warnings (bool, optional) – Apply changes ignoring warnings. Defaults to False

  • **ignore-errors (bool, optional) – Apply changes ignoring errors. You won’t be able to publish such a changes. If ignore-warnings flag was omitted - warnings will also be ignored. Defaults to False

Returns

The response from the server

Return type

Box

Examples

>>> firewall.network_objects.address_range.set(uid="196e93a9-b90b-4ab1-baa6-124e7289aa20",
... new_name="New Address Range 1",color=Color.GREEN,ip_address_first="192.0.2.1",ip_address_last="192.0.2.10",
... nroups="New Group 1")
show(uid=None, name=None, **kw)#

Retrieve existing object using object name or uid.

Parameters

  • uid (str, optional) – Object unique identifier.

  • name (str, optional) – Object name.

Keyword Arguments

**details-level (str, optional) – The level of detail for some of the fields in the response can vary from showing only the UID value of the object to a fully detailed representation of the object.

Returns

The response from the server

Return type

Box

Examples

>>> firewall.network_objects.address_range.show(uid="196e93a9-b90b-4ab1-baa6-124e7289aa20")
show_address_ranges(filter_results=None, limit=50, offset=0, order=None, **kw)#

Retrieve all objects.

Parameters

  • filter_results (str, optional) – Search expression to filter objects by. The provided text should be exactly the same as it would be given in SmartConsole Object Explorer. The logical operators in the expression (‘AND’, ‘OR’) should be provided in capital letters. he search involves both a IP search and a textual search in name, comment, tags etc.

  • limit (int, optional) – The maximal number of returned results. Defaults to 50 (between 1 and 500)

  • offset (int, optional) – Number of the results to initially skip. Defaults to 0

  • order (List[dict], optional) – Sorts results by the given field. By default the results are sorted in the descending order by the session publish time.

Returns

The response from the server

Return type

Box

Examples

>>> firewall.network_objects.network.shows_address_ranges()