DDILConfig
D D I L Config resource for Zscaler Private Access V1.
This resource supports the following standard methods: create(), load(), update(), delete(). They operate on the instance state — set properties with dot notation, then call the method with no arguments. Any other action listed below is a custom action that takes explicit keyword arguments and returns a value.
Quick Start
import zssdk
import logging
# Enable debug logging for DDILConfig
logging.getLogger('zssdk.zpa').setLevel(logging.DEBUG)
logging.basicConfig(level=logging.DEBUG)
session = zssdk.Session(
vanity_domain="your-vanity-domain",
client_id="your-client-id",
client_secret="your-client-secret",
)
# Get a specific DDILConfig
resource = session.zpa.DDILConfig(id="your-resource-id")
resource.load()
print(resource)
# Debug output shows HTTP request/response details
Identifiers
| Name | Type | Description |
|---|---|---|
id | string | Unique identifier |
Actions
create()
Creates a new DDILConfig. Set properties on the resource instance, then call create() — this method takes no arguments.
Properties for creation:
| Name | Type | Required | Description |
|---|---|---|---|
customer_id | long | Yes | - |
offline_domain | string | No | - |
meta_data | ServiceProvider | No | - |
new_user_support | boolean | No | - |
sitec_preferred | boolean | No | - |
max_allowed_down_time | long | No | - |
max_allowed_down_time_unit | string | No | - |
max_allowed_switch_time | long | No | - |
max_allowed_switch_time_unit | string | No | - |
idp_login_url | string | No | - |
idp_cert | string | No | - |
idp_entity_id | string | No | - |
switch_time_enabled | boolean | No | - |
use_existing_idp | boolean | No | - |
restriction_type | string | No | - |
backup_enabled | boolean | No | - |
backup_basedir | string | No | - |
backup_schedule_type | string | No | - |
backup_schedule_value | string | No | - |
backup_max_allowed_num | integer | No | - |
site_SP_cert_id | string | No | - |
ba_auth_domain_cert_id | string | No | - |
encrypt_saml_response | boolean | No | - |
read_only | boolean | No | - |
zscaler_managed | boolean | No | - |
Returns: DDILConfig
Example:
resource = session.zpa.DDILConfig()
resource.customer_id = "resource-id"
resource.create()
print(f"Created with ID: {resource.id}")
delete()
Deletes a DDILConfig by id. Only the id identifier is required; delete() takes no other arguments.
Example:
resource = session.zpa.DDILConfig(id="your-resource-id")
resource.delete()
download_meta_data()
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
customer_id | long | Yes | - |
Example:
resource = session.zpa.DDILConfig()
result = resource.download_meta_data(customer_id=3600)
print(result)
download_SP_certificate()
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
customer_id | long | Yes | - |
Example:
resource = session.zpa.DDILConfig()
result = resource.download_SP_certificate(customer_id=3600)
print(result)
get_all_ddil_config()
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
customer_id | long | Yes | - |
Returns: DDILConfig
Example:
resource = session.zpa.DDILConfig()
result = resource.get_all_ddil_config(customer_id=3600)
print(result)
load()
Fetches an existing DDILConfig by id. Only the id identifier is required; load() takes no other arguments.
Returns: DDILConfig
Example:
resource = session.zpa.DDILConfig(id="your-resource-id")
resource.load()
print(resource.modified_by)
update()
Updates an existing DDILConfig. Call load() first, modify properties, then call update() — this method takes no arguments.
Properties for update:
| Name | Type | Required | Description |
|---|---|---|---|
customer_id | long | Yes | - |
offline_domain | string | No | - |
meta_data | ServiceProvider | No | - |
new_user_support | boolean | No | - |
sitec_preferred | boolean | No | - |
max_allowed_down_time | long | No | - |
max_allowed_down_time_unit | string | No | - |
max_allowed_switch_time | long | No | - |
max_allowed_switch_time_unit | string | No | - |
idp_login_url | string | No | - |
idp_cert | string | No | - |
idp_entity_id | string | No | - |
switch_time_enabled | boolean | No | - |
use_existing_idp | boolean | No | - |
restriction_type | string | No | - |
backup_enabled | boolean | No | - |
backup_basedir | string | No | - |
backup_schedule_type | string | No | - |
backup_schedule_value | string | No | - |
backup_max_allowed_num | integer | No | - |
site_SP_cert_id | string | No | - |
ba_auth_domain_cert_id | string | No | - |
encrypt_saml_response | boolean | No | - |
read_only | boolean | No | - |
zscaler_managed | boolean | No | - |
Returns: DDILConfig
Example:
resource = session.zpa.DDILConfig(id="your-resource-id")
resource.load()
resource.modified_by = "Updated value"
resource.update()
Attributes
| Name | Type | Required | Description |
|---|---|---|---|
modified_time | integer | No | - |
creation_time | integer | No | - |
modified_by | string | No | - |
id | string | No | - |
offline_domain | string | No | - |
sitesp_signing_certificate | string | No | - |
sitesp_signing_private_key | string | No | - |
sitesp_certificate | string | No | - |
sitesp_private_key | string | No | - |
sitesp_CA_certificate | string | No | - |
sitesp_CA_private_key | string | No | - |
meta_data | ServiceProvider | No | - |
user_idps_meta_data | ServiceProviderWrapperCollection | No | - |
new_user_support | boolean | No | - |
sitec_preferred | boolean | No | - |
max_allowed_down_time | long | No | - |
max_allowed_down_time_unit | string | No | - |
max_allowed_switch_time | long | No | - |
max_allowed_switch_time_unit | string | No | - |
idp_login_url | string | No | - |
idp_cert | string | No | - |
idp_entity_id | string | No | - |
switch_time_enabled | boolean | No | - |
use_existing_idp | boolean | No | - |
restriction_type | string | No | - |
backup_enabled | boolean | No | - |
backup_basedir | string | No | - |
backup_schedule_type | string | No | - |
backup_schedule_value | string | No | - |
backup_max_allowed_num | integer | No | - |
site_SP_cert_id | string | No | - |
site_SP_cert_name | string | No | - |
ba_auth_domain_cert_id | string | No | - |
ba_auth_domain_cert_name | string | No | - |
encrypt_saml_response | boolean | No | - |
sitesp_encryption_certificate | string | No | - |
read_only | boolean | No | - |
zscaler_managed | boolean | No | - |
Related
- DDILConfig - Data structure definition
- Logging guide - enable verbose logs while debugging this resource