Address Models

Overview

The Address models provide a structured way to manage network addresses in Palo Alto Networks' Strata Cloud Manager. These models support IP addresses (with CIDR notation), IP ranges, IP wildcards, and FQDNs. The models handle validation of inputs and outputs when interacting with the SCM API.

Attributes

Attribute	Type	Required	Default	Description
name	str	Yes	None	Name of the address. Max length: 63 chars. Must match pattern: ^[a-zA-Z0-9_ .-]+$
description	str	No	None	Description of the address. Max length: 1023 chars
tag	List[str]	No	None	List of tags. Each tag max length: 64 chars
ip_netmask	str	No*	None	IP address with optional CIDR notation (e.g. "192.168.80.0/24")
ip_range	str	No*	None	IP address range (e.g. "10.0.0.1-10.0.0.4")
ip_wildcard	str	No*	None	IP wildcard mask (e.g. "10.20.1.0/0.0.248.255")
fqdn	str	No*	None	Fully qualified domain name. Max length: 255 chars
folder	str	No**	None	Folder where address is defined. Max length: 64 chars
snippet	str	No**	None	Snippet where address is defined. Max length: 64 chars
device	str	No**	None	Device where address is defined. Max length: 64 chars
id	UUID	Yes***	None	UUID of the address (response only)

* Exactly one address type (ip_netmask/ip_range/ip_wildcard/fqdn) must be provided * Exactly one container type (folder/snippet/device) must be provided for create operations ** Only required for response model

Exceptions

The Address models can raise the following exceptions during validation:

• ValueError: Raised in several scenarios:
  • When no address type or multiple address types are provided
  • When multiple container types (folder/snippet/device) are specified for create operations
  • When no container type is specified for create operations
  • When tag values are not unique in a list
  • When tag input is neither a string nor a list
  • When FQDN pattern validation fails
  • When name pattern validation fails

Model Validators

Address Type Validation

The models enforce that exactly one address type must be specified:

# This will raise a validation errorfrom scm.models.objects import AddressCreateModel
# Error: multiple address types providedtry:
address = AddressCreateModel(
name="invalid-address",
ip_netmask="192.168.1.0/24",
fqdn="example.com",
folder="Texas"
)
except ValueError as e:
print(e) # "Exactly one of 'ip_netmask', 'ip_range', 'ip_wildcard', or 'fqdn' must be provided."
# Error: no address type providedtry:
address = AddressCreateModel(
name="invalid-address",
folder="Texas"
)
except ValueError as e:
print(e) # "Value error, Exactly one of 'ip_netmask', 'ip_range', 'ip_wildcard', or 'fqdn' must be provided."

Container Type Validation

For create operations, exactly one container type must be specified:

# This will raise a validation errortry:
address = AddressCreateModel(
name="invalid-address",
ip_netmask="192.168.1.0/24",
folder="Texas",
device="fw01" # Can't specify both folder and device
)
except ValueError as e:
print(e) # "Exactly one of 'folder', 'snippet', or 'device' must be provided."

Tag Validation

Tags must be unique and properly formatted:

# This will raise a validation error for duplicate tagstry:
address = AddressCreateModel(
name="invalid-address",
ip_netmask="192.168.1.0/24",
folder="Texas",
tag=["web", "web"] # Duplicate tags not allowed
)
except ValueError as e:
print(e) # "List items must be unique"
# This will convert a single string tag to a listaddress = AddressCreateModel(
name="valid-address",
ip_netmask="192.168.1.0/24",
folder="Texas",
tag="web" # Will be converted to ["web"]
)

Usage Examples

Creating an Address Object

# Using dictionaryfrom scm.config.objects import Address

address_dict = {
"name": "web-server",
"description": "Primary web server",
"ip_netmask": "192.168.1.100/32",
"folder": "Texas",
"tag": ["web", "production"]
}

address = Address(api_client)
response = address.create(address_dict)
# Using model directlyfrom scm.models.objects import AddressCreateModel

address_obj = AddressCreateModel(
name="web-server",
description="Primary web server",
ip_netmask="192.168.1.100/32",
folder="Texas",
tag=["web", "production"]
)

payload = address_obj.model_dump(exclude_unset=True)
response = address.create(payload)

Creating an FQDN Address

# Using dictionaryfqdn_dict = {
"name": "example-domain",
"description": "Example domain address",
"fqdn": "www.example.com",
"folder": "Texas",
"tag": ["web", "domain"]
}

response = address.create(fqdn_dict)
# Using model directlyfrom scm.models.objects import AddressCreateModel

fqdn_address = AddressCreateModel(
name="example-domain",
description="Example domain address",
fqdn="www.example.com",
folder="Texas",
tag=["web", "domain"]
)

payload = fqdn_address.model_dump(exclude_unset=True)
response = address.create(payload)

Updating an Address

# Using dictionaryupdate_dict = {
"id": "123e4567-e89b-12d3-a456-426655440000",
"name": "web-server-updated",
"description": "Updated web server",
"ip_netmask": "192.168.1.101/32",
"tag": ["web", "production", "updated"]
}

response = address.update(update_dict)
# Using model directlyfrom scm.models.objects import AddressUpdateModel

update_address = AddressUpdateModel(
id="123e4567-e89b-12d3-a456-426655440000",
name="web-server-updated",
description="Updated web server",
ip_netmask="192.168.1.101/32",
tag=["web", "production", "updated"]
)

payload = update_address.model_dump(exclude_unset=True)
response = address.update(payload)