External Dynamic Lists¶

The ExternalDynamicLists service manages External Dynamic Lists (EDLs) in Strata Cloud Manager, supporting IP, Domain, URL, IMSI, and IMEI list types with configurable update intervals.

Class Overview¶

The ExternalDynamicLists class provides CRUD operations for EDL objects. It is accessed through the client.external_dynamic_list attribute on an initialized ScmClient instance.

from scm.client import ScmClient

client = ScmClient(
    client_id="your_client_id",
    client_secret="your_client_secret",
    tsg_id="your_tsg_id"
)

# Access the ExternalDynamicLists service
edls = client.external_dynamic_list

Key Attributes¶

Attribute	Type	Required	Description
`name`	`str`	Yes	Name of EDL (max 63 chars)
`id`	`UUID`	Yes*	Unique identifier (*response only)
`type`	`TypeUnion`	Yes	EDL type configuration
`url`	`str`	Yes	Source URL for EDL content
`description`	`str`	No	Description (max 255 chars)
`exception_list`	`List[str]`	No	List of exceptions
`auth`	`AuthModel`	No	Authentication credentials
`recurring`	`RecurringUnion`	Yes	Update schedule configuration
`folder`	`str`	Yes**	Folder location (**one container required)
`snippet`	`str`	Yes**	Snippet location (**one container required)
`device`	`str`	Yes**	Device location (**one container required)

* Exactly one of folder, snippet, or device is required.

Methods¶

List External Dynamic Lists¶

Retrieves a list of EDL objects with optional filtering.

edls = client.external_dynamic_list.list(
    folder="Texas",
    types=["ip", "domain"]
)

for edl in edls:
    print(f"Name: {edl.name}")

Fetch an External Dynamic List¶

Retrieves a single EDL by name and container.

edl = client.external_dynamic_list.fetch(
    name="malicious-ips",
    folder="Texas"
)
print(f"Found EDL: {edl.name}")

Create an External Dynamic List¶

Creates a new EDL object.

ip_edl = client.external_dynamic_list.create({
    "name": "malicious-ips",
    "folder": "Texas",
    "type": {
        "ip": {
            "url": "https://threatfeeds.example.com/ips.txt",
            "description": "Known malicious IPs",
            "recurring": {"daily": {"at": "03"}},
            "auth": {
                "username": "user123",
                "password": "pass123"
            }
        }
    }
})

Update an External Dynamic List¶

Updates an existing EDL object.

existing = client.external_dynamic_list.fetch(
    name="malicious-ips",
    folder="Texas"
)
existing.type.ip.recurring = {"five_minute": {}}

updated = client.external_dynamic_list.update(existing)

Delete an External Dynamic List¶

Deletes an EDL by ID.

client.external_dynamic_list.delete("123e4567-e89b-12d3-a456-426655440000")

Use Cases¶

Creating Different EDL Types¶

Set up IP and domain-based EDLs for threat intelligence feeds.

from scm.client import ScmClient

client = ScmClient(
    client_id="your_client_id",
    client_secret="your_client_secret",
    tsg_id="your_tsg_id"
)

# IP-based EDL with daily updates
client.external_dynamic_list.create({
    "name": "malicious-ips",
    "folder": "Texas",
    "type": {
        "ip": {
            "url": "https://threatfeeds.example.com/ips.txt",
            "description": "Known malicious IPs",
            "recurring": {"daily": {"at": "03"}}
        }
    }
})

# Domain-based EDL with hourly updates
client.external_dynamic_list.create({
    "name": "blocked-domains",
    "folder": "Texas",
    "type": {
        "domain": {
            "url": "https://threatfeeds.example.com/domains.txt",
            "description": "Blocked domains list",
            "recurring": {"hourly": {}},
            "expand_domain": True
        }
    }
})

Filtering EDLs¶

Use advanced filtering to find specific EDLs.

# Exact match with exclusions
filtered = client.external_dynamic_list.list(
    folder="Texas",
    exact_match=True,
    exclude_folders=["All"],
    exclude_snippets=["default"]
)

for edl in filtered:
    print(f"EDL: {edl.name} in {edl.folder}")

Error Handling¶

from scm.client import ScmClient
from scm.exceptions import (
    InvalidObjectError,
    MissingQueryParameterError,
    NameNotUniqueError,
    ObjectNotPresentError,
    ReferenceNotZeroError
)

client = ScmClient(
    client_id="your_client_id",
    client_secret="your_client_secret",
    tsg_id="your_tsg_id"
)

try:
    new_edl = client.external_dynamic_list.create({
        "name": "test-edl",
        "folder": "Texas",
        "type": {
            "ip": {
                "url": "https://example.com/ips.txt",
                "description": "Test IP list",
                "recurring": {"daily": {"at": "03"}}
            }
        }
    })
except InvalidObjectError as e:
    print(f"Invalid EDL data: {e.message}")
except NameNotUniqueError as e:
    print(f"EDL name already exists: {e.message}")
except ObjectNotPresentError as e:
    print(f"EDL not found: {e.message}")
except ReferenceNotZeroError as e:
    print(f"EDL still in use: {e.message}")
except MissingQueryParameterError as e:
    print(f"Missing parameter: {e.message}")

External Dynamic Lists Models