Skip to content

Check Ip

The CHECK_IP function verifies whether the device has obtained an IP address after an APN or network configuration. It can check that any IP address exists, or it can validate the detected address against an exact IPv4/IPv6 value or a wildcard pattern.

Parameters

Parameter Name Description Example Values Required Default Value
IP_ADDRESS Expected IP address or wildcard pattern. Use an exact IPv4/IPv6 address for an exact match, or use * as a wildcard for IPv4 octets or IPv6 groups. Use *.*.*.* when the test only needs to verify that an IP address exists. *.*.*.*, 10.*.*.*, 10.204.*.*, 10.204.12.8, 2001:db8::1, 2001:db8:*:*:*:*:*:* No *.*.*.*
Expect The expected result of the IP address check. Use SUCCESS when the IP check should pass, or FAILURE when it should fail. SUCCESS, FAILURE Yes SUCCESS

Matching Rules

  • *.*.*.* only checks whether the device has any IP address.
  • 10.*.*.* passes when the detected IPv4 address starts with 10..
  • 10.204.*.* passes when the detected IPv4 address starts with 10.204..
  • 10.204.12.8 passes only when the detected IPv4 address is exactly 10.204.12.8.
  • IPv6 addresses can be checked with an exact value, such as 2001:db8::1.
  • IPv6 wildcard matching is group-based. Use * for any group, for example 2001:db8:*:*:*:*:*:*.