SiteConfig Class

Configuration of an App Service app.

Constructor

SiteConfig(*args: Any, **kwargs: Any)

Variables

Name Description
number_of_workers
int

Number of workers.

default_documents

Default documents.

net_framework_version
str

.NET Framework version.

php_version
str

Version of PHP.

python_version
str

Version of Python.

node_version
str

Version of Node.js.

power_shell_version
str

Version of PowerShell.

linux_fx_version
str

Linux App Framework and version.

windows_fx_version
str

Xenon App Framework and version.

request_tracing_enabled

true if request tracing is enabled; otherwise, false.

request_tracing_expiration_time

Request tracing expiration time.

remote_debugging_enabled

true if remote debugging is enabled; otherwise, false.

remote_debugging_version
str

Remote debugging version.

http_logging_enabled

true if HTTP logging is enabled; otherwise, false.

acr_use_managed_identity_creds

Flag to use Managed Identity Creds for ACR pull.

acr_user_managed_identity_id
str

If using user managed identity, the user managed identity ClientId.

logs_directory_size_limit
int

HTTP logs directory size limit.

detailed_error_logging_enabled

true if detailed error logging is enabled; otherwise, false.

publishing_username
str

Publishing user name.

app_settings

Application settings. This property is not returned in response to normal create and read requests since it may contain sensitive information.

metadata

Application metadata. This property cannot be retrieved, since it may contain secrets.

connection_strings

Connection strings. This property is not returned in response to normal create and read requests since it may contain sensitive information.

machine_key

Site MachineKey.

handler_mappings

Handler mappings.

document_root
str

Document root.

scm_type

SCM type. Known values are: "None", "Dropbox", "Tfs", "LocalGit", "GitHub", "CodePlexGit", "CodePlexHg", "BitbucketGit", "BitbucketHg", "ExternalGit", "ExternalHg", "OneDrive", "VSO", and "VSTSRM".

use32_bit_worker_process

true to use 32-bit worker process; otherwise, false.

web_sockets_enabled

true if WebSocket is enabled; otherwise, false.

always_on

true if Always On is enabled; otherwise, false.

java_version
str

Java version.

java_container
str

Java container.

java_container_version
str

Java container version.

app_command_line
str

App command line to launch.

managed_pipeline_mode

Managed pipeline mode. Known values are: "Integrated" and "Classic".

virtual_applications

Virtual applications.

load_balancing

Site load balancing. Known values are: "WeightedRoundRobin", "LeastRequests", "LeastResponseTime", "WeightedTotalTraffic", "RequestHash", "PerSiteRoundRobin", and "LeastRequestsWithTieBreaker".

experiments

This is work around for polymorphic types.

limits

Site limits.

auto_heal_enabled

true if Auto Heal is enabled; otherwise, false.

auto_heal_rules

Auto Heal rules.

tracing_options
str

Tracing options.

vnet_name
str

Virtual Network name.

vnet_route_all_enabled

Virtual Network Route All enabled. This causes all outbound traffic to have Virtual Network Security Groups and User Defined Routes applied.

vnet_private_ports_count
int

The number of private ports assigned to this app. These will be assigned dynamically on runtime.

cors

Cross-Origin Resource Sharing (CORS) settings.

push

Push endpoint settings.

api_definition

Information about the formal API definition for the app.

api_management_config

Azure API management settings linked to the app.

auto_swap_slot_name
str

Auto-swap slot name.

local_my_sql_enabled

true to enable local MySQL; otherwise, false.

managed_service_identity_id
int

Managed Service Identity Id.

x_managed_service_identity_id
int

Explicit Managed Service Identity Id.

key_vault_reference_identity
str

Identity to use for Key Vault Reference authentication.

ip_security_restrictions

IP security restrictions for main.

ip_security_restrictions_default_action

Default action for main access restriction if no rules are matched. Known values are: "Allow" and "Deny".

scm_ip_security_restrictions

IP security restrictions for scm.

scm_ip_security_restrictions_default_action

Default action for scm access restriction if no rules are matched. Known values are: "Allow" and "Deny".

scm_ip_security_restrictions_use_main

IP security restrictions for scm to use main.

http20_enabled

Http20Enabled: configures a web site to allow clients to connect over http2.0.

http20_proxy_flag
int

Http20ProxyFlag: Configures a website to allow http2.0 to pass be proxied all the way to the app. 0 = disabled, 1 = pass through all http2 traffic, 2 = pass through gRPC only.

min_tls_version

MinTlsVersion: configures the minimum version of TLS required for SSL requests. Known values are: "1.0", "1.1", "1.2", and "1.3".

min_tls_cipher_suite

The minimum strength TLS cipher suite allowed for an application. Known values are: "TLS_AES_256_GCM_SHA384", "TLS_AES_128_GCM_SHA256", "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384", "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256", "TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256", "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384", "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256", "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384", "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256", "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA", "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA", "TLS_RSA_WITH_AES_256_GCM_SHA384", "TLS_RSA_WITH_AES_128_GCM_SHA256", "TLS_RSA_WITH_AES_256_CBC_SHA256", "TLS_RSA_WITH_AES_128_CBC_SHA256", "TLS_RSA_WITH_AES_256_CBC_SHA", and "TLS_RSA_WITH_AES_128_CBC_SHA".

scm_min_tls_version

ScmMinTlsVersion: configures the minimum version of TLS required for SSL requests for SCM site. Known values are: "1.0", "1.1", "1.2", and "1.3".

ftps_state

State of FTP / FTPS service. Known values are: "AllAllowed", "FtpsOnly", and "Disabled".

pre_warmed_instance_count
int

Number of preWarmed instances. This setting only applies to the Consumption and Elastic Plans.

function_app_scale_limit
int

Maximum number of workers that a site can scale out to. This setting only applies to the Consumption and Elastic Premium Plans.

elastic_web_app_scale_limit
int

Maximum number of workers that a site can scale out to. This setting only applies to apps in plans where ElasticScaleEnabled is true.

health_check_path
str

Health check path.

functions_runtime_scale_monitoring_enabled

Gets or sets a value indicating whether functions runtime scale monitoring is enabled. When enabled, the ScaleController will not monitor event sources directly, but will instead call to the runtime to get scale status.

website_time_zone
str

Sets the time zone a site uses for generating timestamps. Compatible with Linux and Windows App Service. Setting the WEBSITE_TIME_ZONE app setting takes precedence over this config. For Linux, expects tz database values https://www.iana.org/time-zones (for a quick reference see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). For Windows, expects one of the time zones listed under HKEY_LOCAL_MACHINESOFTWAREMicrosoftWindows NTCurrentVersionTime Zones.

minimum_elastic_instance_count
int

Number of minimum instance count for a site This setting only applies to the Elastic Plans.

azure_storage_accounts

List of Azure Storage Accounts.

public_network_access
str

Property to allow or block all public traffic.

Attributes

acr_use_managed_identity_creds

Flag to use Managed Identity Creds for ACR pull.

acr_use_managed_identity_creds: bool | None

acr_user_managed_identity_id

If using user managed identity, the user managed identity ClientId.

acr_user_managed_identity_id: str | None

always_on

true if Always On is enabled; otherwise, false.

always_on: bool | None

api_definition

Information about the formal API definition for the app.

api_definition: _models.ApiDefinitionInfo | None

api_management_config

Azure API management settings linked to the app.

api_management_config: _models.ApiManagementConfig | None

app_command_line

App command line to launch.

app_command_line: str | None

app_settings

Application settings. This property is not returned in response to normal create and read requests since it may contain sensitive information.

app_settings: list['_models.NameValuePair'] | None

auto_heal_enabled

true if Auto Heal is enabled; otherwise, false.

auto_heal_enabled: bool | None

auto_heal_rules

Auto Heal rules.

auto_heal_rules: _models.AutoHealRules | None

auto_swap_slot_name

Auto-swap slot name.

auto_swap_slot_name: str | None

azure_storage_accounts

List of Azure Storage Accounts.

azure_storage_accounts: dict[str, '_models.AzureStorageInfoValue'] | None

connection_strings

Connection strings. This property is not returned in response to normal create and read requests since it may contain sensitive information.

connection_strings: list['_models.ConnStringInfo'] | None

cors

Cross-Origin Resource Sharing (CORS) settings.

cors: _models.CorsSettings | None

default_documents

Default documents.

default_documents: list[str] | None

detailed_error_logging_enabled

true if detailed error logging is enabled; otherwise, false.

detailed_error_logging_enabled: bool | None

document_root

Document root.

document_root: str | None

elastic_web_app_scale_limit

Maximum number of workers that a site can scale out to. This setting only applies to apps in plans where ElasticScaleEnabled is true.

elastic_web_app_scale_limit: int | None

experiments

This is work around for polymorphic types.

experiments: _models.Experiments | None

ftps_state

"AllAllowed", "FtpsOnly", and "Disabled".

ftps_state: str | _models.FtpsState | None

function_app_scale_limit

Maximum number of workers that a site can scale out to. This setting only applies to the Consumption and Elastic Premium Plans.

function_app_scale_limit: int | None

functions_runtime_scale_monitoring_enabled

Gets or sets a value indicating whether functions runtime scale monitoring is enabled. When enabled, the ScaleController will not monitor event sources directly, but will instead call to the runtime to get scale status.

functions_runtime_scale_monitoring_enabled: bool | None

handler_mappings

Handler mappings.

handler_mappings: list['_models.HandlerMapping'] | None

health_check_path

Health check path.

health_check_path: str | None

http20_enabled

configures a web site to allow clients to connect over http2.0.

http20_enabled: bool | None

http20_proxy_flag

Configures a website to allow http2.0 to pass be proxied all the way to the app. 0 = disabled, 1 = pass through all http2 traffic, 2 = pass through gRPC only.

http20_proxy_flag: int | None

http_logging_enabled

true if HTTP logging is enabled; otherwise, false.

http_logging_enabled: bool | None

ip_security_restrictions

IP security restrictions for main.

ip_security_restrictions: list['_models.IpSecurityRestriction'] | None

ip_security_restrictions_default_action

"Allow" and "Deny".

ip_security_restrictions_default_action: str | _models.DefaultAction | None

java_container

Java container.

java_container: str | None

java_container_version

Java container version.

java_container_version: str | None

java_version

Java version.

java_version: str | None

key_vault_reference_identity

Identity to use for Key Vault Reference authentication.

key_vault_reference_identity: str | None

limits

Site limits.

limits: _models.SiteLimits | None

linux_fx_version

Linux App Framework and version.

linux_fx_version: str | None

load_balancing

"WeightedRoundRobin", "LeastRequests", "LeastResponseTime", "WeightedTotalTraffic", "RequestHash", "PerSiteRoundRobin", and "LeastRequestsWithTieBreaker".

load_balancing: str | _models.SiteLoadBalancing | None

local_my_sql_enabled

true to enable local MySQL; otherwise, false.

local_my_sql_enabled: bool | None

logs_directory_size_limit

HTTP logs directory size limit.

logs_directory_size_limit: int | None

machine_key

Site MachineKey.

machine_key: _models.SiteMachineKey | None

managed_pipeline_mode

"Integrated" and "Classic".

managed_pipeline_mode: str | _models.ManagedPipelineMode | None

managed_service_identity_id

Managed Service Identity Id.

managed_service_identity_id: int | None

metadata

Application metadata. This property cannot be retrieved, since it may contain secrets.

metadata: list['_models.NameValuePair'] | None

min_tls_cipher_suite

The minimum strength TLS cipher suite allowed for an application. Known values are: "TLS_AES_256_GCM_SHA384", "TLS_AES_128_GCM_SHA256", "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384", "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256", "TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256", "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384", "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256", "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384", "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256", "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA", "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA", "TLS_RSA_WITH_AES_256_GCM_SHA384", "TLS_RSA_WITH_AES_128_GCM_SHA256", "TLS_RSA_WITH_AES_256_CBC_SHA256", "TLS_RSA_WITH_AES_128_CBC_SHA256", "TLS_RSA_WITH_AES_256_CBC_SHA", and "TLS_RSA_WITH_AES_128_CBC_SHA".

min_tls_cipher_suite: str | _models.TlsCipherSuites | None

min_tls_version

configures the minimum version of TLS required for SSL requests. Known values are: "1.0", "1.1", "1.2", and "1.3".

min_tls_version: str | _models.SupportedTlsVersions | None

minimum_elastic_instance_count

Number of minimum instance count for a site This setting only applies to the Elastic Plans.

minimum_elastic_instance_count: int | None

net_framework_version

.NET Framework version.

net_framework_version: str | None

node_version

Version of Node.js.

node_version: str | None

number_of_workers

Number of workers.

number_of_workers: int | None

php_version

Version of PHP.

php_version: str | None

power_shell_version

Version of PowerShell.

power_shell_version: str | None

pre_warmed_instance_count

Number of preWarmed instances. This setting only applies to the Consumption and Elastic Plans.

pre_warmed_instance_count: int | None

public_network_access

Property to allow or block all public traffic.

public_network_access: str | None

publishing_username

Publishing user name.

publishing_username: str | None

push

Push endpoint settings.

push: _models.PushSettings | None

python_version

Version of Python.

python_version: str | None

remote_debugging_enabled

true if remote debugging is enabled; otherwise, false.

remote_debugging_enabled: bool | None

remote_debugging_version

Remote debugging version.

remote_debugging_version: str | None

request_tracing_enabled

true if request tracing is enabled; otherwise, false.

request_tracing_enabled: bool | None

request_tracing_expiration_time

Request tracing expiration time.

request_tracing_expiration_time: datetime | None

scm_ip_security_restrictions

IP security restrictions for scm.

scm_ip_security_restrictions: list['_models.IpSecurityRestriction'] | None

scm_ip_security_restrictions_default_action

"Allow" and "Deny".

scm_ip_security_restrictions_default_action: str | _models.DefaultAction | None

scm_ip_security_restrictions_use_main

IP security restrictions for scm to use main.

scm_ip_security_restrictions_use_main: bool | None

scm_min_tls_version

configures the minimum version of TLS required for SSL requests for SCM site. Known values are: "1.0", "1.1", "1.2", and "1.3".

scm_min_tls_version: str | _models.SupportedTlsVersions | None

scm_type

"None", "Dropbox", "Tfs", "LocalGit", "GitHub", "CodePlexGit", "CodePlexHg", "BitbucketGit", "BitbucketHg", "ExternalGit", "ExternalHg", "OneDrive", "VSO", and "VSTSRM".

scm_type: str | _models.ScmType | None

tracing_options

Tracing options.

tracing_options: str | None

use32_bit_worker_process

true to use 32-bit worker process; otherwise, false.

use32_bit_worker_process: bool | None

virtual_applications

Virtual applications.

virtual_applications: list['_models.VirtualApplication'] | None

vnet_name

Virtual Network name.

vnet_name: str | None

vnet_private_ports_count

The number of private ports assigned to this app. These will be assigned dynamically on runtime.

vnet_private_ports_count: int | None

vnet_route_all_enabled

Virtual Network Route All enabled. This causes all outbound traffic to have Virtual Network Security Groups and User Defined Routes applied.

vnet_route_all_enabled: bool | None

web_sockets_enabled

true if WebSocket is enabled; otherwise, false.

web_sockets_enabled: bool | None

website_time_zone

Sets the time zone a site uses for generating timestamps. Compatible with Linux and Windows App Service. Setting the WEBSITE_TIME_ZONE app setting takes precedence over this config. For Linux, expects tz database values https://www.iana.org/time-zones (for a quick reference see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). For Windows, expects one of the time zones listed under HKEY_LOCAL_MACHINESOFTWAREMicrosoftWindows NTCurrentVersionTime Zones.

website_time_zone: str | None

windows_fx_version

Xenon App Framework and version.

windows_fx_version: str | None

x_managed_service_identity_id

Explicit Managed Service Identity Id.

x_managed_service_identity_id: int | None