Web Apps - Get Configuration Snapshot

Service:

App Service

API Version:

2024-04-01

Description for Gets a snapshot of the configuration of an app at a previous point in time.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/config/web/snapshots/{snapshotId}?api-version=2024-04-01

URI Parameters

Name	In	Required	Type	Description
name	path	True	string	Name of the app.
resourceGroupName	path	True	string	Name of the resource group to which the resource belongs. Regex pattern: ^[-\w\._\(\)]+[^\.]$
snapshotId	path	True	string	The ID of the snapshot to read.
subscriptionId	path	True	string	Your Azure subscription ID. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000).
api-version	query	True	string	API Version

Responses

Name	Type	Description
200 OK	SiteConfigResource	OK
Other Status Codes	DefaultErrorResponse	App Service error response.

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Definitions

Name	Description
ApiDefinitionInfo	Information about the formal API definition for the app.
ApiManagementConfig	Azure API management (APIM) configuration linked to the app.
AutoHealActions	Actions which to take by the auto-heal module when a rule is triggered.
AutoHealActionType	Predefined action to be taken.
AutoHealCustomAction	Custom action to be executed when an auto heal rule is triggered.
AutoHealRules	Rules that can be defined for auto-heal.
AutoHealTriggers	Triggers for auto-heal.
AzureStorageInfoValue	Azure Files or Blob Storage access information value for dictionary storage.
AzureStorageProtocol	Mounting protocol to use for the storage account.
AzureStorageState	State of the storage account.
AzureStorageType	Type of storage.
ConnectionStringType	Type of database.
ConnStringInfo	Database connection string information.
CorsSettings	Cross-Origin Resource Sharing (CORS) settings for the app.
DefaultAction	Default action for main access restriction if no rules are matched.
DefaultErrorResponse	App Service error response.
Details
Error	Error model.
Experiments	Routing rules in production experiments.
FtpsState	State of FTP / FTPS service
HandlerMapping	The IIS handler mappings used to define which handler processes HTTP requests with certain extension. For example, it is used to configure php-cgi.exe process to handle all HTTP requests with *.php extension.
IpFilterTag	Defines what this IP filter will be used for. This is to support IP filtering on proxies.
IpSecurityRestriction	IP security restriction on an app.
ManagedPipelineMode	Managed pipeline mode.
NameValuePair	Name value pair.
PushSettings	Push settings for the App.
RampUpRule	Routing rules for ramp up testing. This rule allows to redirect static traffic % to a slot or to gradually change routing % based on performance.
RequestsBasedTrigger	Trigger based on total requests.
ScmType	SCM type.
SiteConfigResource	Web app configuration ARM resource.
SiteLimits	Metric limits set on an app.
SiteLoadBalancing	Site load balancing.
SiteMachineKey	MachineKey of an app.
SlowRequestsBasedTrigger	Trigger based on request execution time.
StatusCodesBasedTrigger	Trigger based on status code.
StatusCodesRangeBasedTrigger	Trigger based on range of status codes.
SupportedTlsVersions	MinTlsVersion: configures the minimum version of TLS required for SSL requests
TlsCipherSuites	The minimum strength TLS cipher suite allowed for an application
VirtualApplication	Virtual application in an app.
VirtualDirectory	Directory for virtual application.

ApiDefinitionInfo

Information about the formal API definition for the app.

Name	Type	Description
url	string	The URL of the API definition.

ApiManagementConfig

Azure API management (APIM) configuration linked to the app.

Name	Type	Description
id	string	APIM-Api Identifier.

AutoHealActions

Actions which to take by the auto-heal module when a rule is triggered.

Name	Type	Description
actionType	AutoHealActionType	Predefined action to be taken.
customAction	AutoHealCustomAction	Custom action to be taken.
minProcessExecutionTime	string	Minimum time the process must execute before taking the action

AutoHealActionType

Predefined action to be taken.

Name	Type	Description
CustomAction	string
LogEvent	string
Recycle	string

AutoHealCustomAction

Custom action to be executed when an auto heal rule is triggered.

Name	Type	Description
exe	string	Executable to be run.
parameters	string	Parameters for the executable.

AutoHealRules

Rules that can be defined for auto-heal.

Name	Type	Description
actions	AutoHealActions	Actions to be executed when a rule is triggered.
triggers	AutoHealTriggers	Conditions that describe when to execute the auto-heal actions.

AutoHealTriggers

Triggers for auto-heal.

Name	Type	Description
privateBytesInKB	integer	A rule based on private bytes.
requests	RequestsBasedTrigger	A rule based on total requests.
slowRequests	SlowRequestsBasedTrigger	A rule based on request execution time.
slowRequestsWithPath	SlowRequestsBasedTrigger[]	A rule based on multiple Slow Requests Rule with path
statusCodes	StatusCodesBasedTrigger[]	A rule based on status codes.
statusCodesRange	StatusCodesRangeBasedTrigger[]	A rule based on status codes ranges.

AzureStorageInfoValue

Azure Files or Blob Storage access information value for dictionary storage.

Name	Type	Description
accessKey	string	Access key for the storage account.
accountName	string	Name of the storage account.
mountPath	string	Path to mount the storage within the site's runtime environment.
protocol	AzureStorageProtocol	Mounting protocol to use for the storage account.
shareName	string	Name of the file share (container name, for Blob storage).
state	AzureStorageState	State of the storage account.
type	AzureStorageType	Type of storage.

AzureStorageProtocol

Mounting protocol to use for the storage account.

Name	Type	Description
Http	string
Nfs	string
Smb	string

AzureStorageState

State of the storage account.

Name	Type	Description
InvalidCredentials	string
InvalidShare	string
NotValidated	string
Ok	string

AzureStorageType

Type of storage.

Name	Type	Description
AzureBlob	string
AzureFiles	string

ConnectionStringType

Type of database.

Name	Type	Description
ApiHub	string
Custom	string
DocDb	string
EventHub	string
MySql	string
NotificationHub	string
PostgreSQL	string
RedisCache	string
SQLAzure	string
SQLServer	string
ServiceBus	string

ConnStringInfo

Database connection string information.

Name	Type	Description
connectionString	string	Connection string value.
name	string	Name of connection string.
type	ConnectionStringType	Type of database.

CorsSettings

Cross-Origin Resource Sharing (CORS) settings for the app.

Name	Type	Description
allowedOrigins	string[]	Gets or sets the list of origins that should be allowed to make cross-origin calls (for example: http://example.com:12345). Use "*" to allow all.
supportCredentials	boolean	Gets or sets whether CORS requests with credentials are allowed. See https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#Requests_with_credentials for more details.

DefaultAction

Default action for main access restriction if no rules are matched.

Name	Type	Description
Allow	string
Deny	string

DefaultErrorResponse

App Service error response.

Name	Type	Description
error	Error	Error model.

Details

Name	Type	Description
code	string	Standardized string to programmatically identify the error.
message	string	Detailed error description and debugging information.
target	string	Detailed error description and debugging information.

Error

Error model.

Name	Type	Description
code	string	Standardized string to programmatically identify the error.
details	Details[]	Detailed errors.
innererror	string	More information to debug error.
message	string	Detailed error description and debugging information.
target	string	Detailed error description and debugging information.

Experiments

Routing rules in production experiments.

Name	Type	Description
rampUpRules	RampUpRule[]	List of ramp-up rules.

FtpsState

State of FTP / FTPS service

Name	Type	Description
AllAllowed	string
Disabled	string
FtpsOnly	string

HandlerMapping

The IIS handler mappings used to define which handler processes HTTP requests with certain extension. For example, it is used to configure php-cgi.exe process to handle all HTTP requests with *.php extension.

Name	Type	Description
arguments	string	Command-line arguments to be passed to the script processor.
extension	string	Requests with this extension will be handled using the specified FastCGI application.
scriptProcessor	string	The absolute path to the FastCGI application.

IpFilterTag

Defines what this IP filter will be used for. This is to support IP filtering on proxies.

Name	Type	Description
Default	string
ServiceTag	string
XffProxy	string

IpSecurityRestriction

IP security restriction on an app.

Name	Type	Description
action	string	Allow or Deny access for this IP range.
description	string	IP restriction rule description.
headers	object	IP restriction rule headers. X-Forwarded-Host (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-Host#Examples). The matching logic is .. If the property is null or empty (default), all hosts(or lack of) are allowed. A value is compared using ordinal-ignore-case (excluding port number). Subdomain wildcards are permitted but don't match the root domain. For example, *.contoso.com matches the subdomain foo.contoso.com but not the root domain contoso.com or multi-level foo.bar.contoso.com Unicode host names are allowed but are converted to Punycode for matching. X-Forwarded-For (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-For#Examples). The matching logic is .. If the property is null or empty (default), any forwarded-for chains (or lack of) are allowed. If any address (excluding port number) in the chain (comma separated) matches the CIDR defined by the property. X-Azure-FDID and X-FD-HealthProbe. The matching logic is exact match.
ipAddress	string	IP address the security restriction is valid for. It can be in form of pure ipv4 address (required SubnetMask property) or CIDR notation such as ipv4/mask (leading bit match). For CIDR, SubnetMask property must not be specified.
name	string	IP restriction rule name.
priority	integer	Priority of IP restriction rule.
subnetMask	string	Subnet mask for the range of IP addresses the restriction is valid for.
subnetTrafficTag	integer	(internal) Subnet traffic tag
tag	IpFilterTag	Defines what this IP filter will be used for. This is to support IP filtering on proxies.
vnetSubnetResourceId	string	Virtual network resource id
vnetTrafficTag	integer	(internal) Vnet traffic tag

ManagedPipelineMode

Managed pipeline mode.

Name	Type	Description
Classic	string
Integrated	string

NameValuePair

Name value pair.

Name	Type	Description
name	string	Pair name.
value	string	Pair value.

PushSettings

Push settings for the App.

Name	Type	Description
id	string	Resource Id.
kind	string	Kind of resource.
name	string	Resource Name.
properties.dynamicTagsJson	string	Gets or sets a JSON string containing a list of dynamic tags that will be evaluated from user claims in the push registration endpoint.
properties.isPushEnabled	boolean	Gets or sets a flag indicating whether the Push endpoint is enabled.
properties.tagWhitelistJson	string	Gets or sets a JSON string containing a list of tags that are whitelisted for use by the push registration endpoint.
properties.tagsRequiringAuth	string	Gets or sets a JSON string containing a list of tags that require user authentication to be used in the push registration endpoint. Tags can consist of alphanumeric characters and the following: '_', '@', '#', '.', ':', '-'. Validation should be performed at the PushRequestHandler.
type	string	Resource type.

RampUpRule

Routing rules for ramp up testing. This rule allows to redirect static traffic % to a slot or to gradually change routing % based on performance.

Name	Type	Description
actionHostName	string	Hostname of a slot to which the traffic will be redirected if decided to. E.g. myapp-stage.azurewebsites.net.
changeDecisionCallbackUrl	string	Custom decision algorithm can be provided in TiPCallback site extension which URL can be specified. See TiPCallback site extension for the scaffold and contracts. https://www.siteextensions.net/packages/TiPCallback/
changeIntervalInMinutes	integer	Specifies interval in minutes to reevaluate ReroutePercentage.
changeStep	number	In auto ramp up scenario this is the step to add/remove from ReroutePercentage until it reaches \nMinReroutePercentage or MaxReroutePercentage. Site metrics are checked every N minutes specified in ChangeIntervalInMinutes.\nCustom decision algorithm can be provided in TiPCallback site extension which URL can be specified in ChangeDecisionCallbackUrl.
maxReroutePercentage	number	Specifies upper boundary below which ReroutePercentage will stay.
minReroutePercentage	number	Specifies lower boundary above which ReroutePercentage will stay.
name	string	Name of the routing rule. The recommended name would be to point to the slot which will receive the traffic in the experiment.
reroutePercentage	number	Percentage of the traffic which will be redirected to ActionHostName.

RequestsBasedTrigger

Trigger based on total requests.

Name	Type	Description
count	integer	Request Count.
timeInterval	string	Time interval.

ScmType

SCM type.

Name	Type	Description
BitbucketGit	string
BitbucketHg	string
CodePlexGit	string
CodePlexHg	string
Dropbox	string
ExternalGit	string
ExternalHg	string
GitHub	string
LocalGit	string
None	string
OneDrive	string
Tfs	string
VSO	string
VSTSRM	string

SiteConfigResource

Web app configuration ARM resource.

Name	Type	Default value	Description
id	string		Resource Id.
kind	string		Kind of resource.
name	string		Resource Name.
properties.acrUseManagedIdentityCreds	boolean		Flag to use Managed Identity Creds for ACR pull
properties.acrUserManagedIdentityID	string		If using user managed identity, the user managed identity ClientId
properties.alwaysOn	boolean		true if Always On is enabled; otherwise, false.
properties.apiDefinition	ApiDefinitionInfo		Information about the formal API definition for the app.
properties.apiManagementConfig	ApiManagementConfig		Azure API management settings linked to the app.
properties.appCommandLine	string		App command line to launch.
properties.appSettings	NameValuePair[]		Application settings.
properties.autoHealEnabled	boolean		true if Auto Heal is enabled; otherwise, false.
properties.autoHealRules	AutoHealRules		Auto Heal rules.
properties.autoSwapSlotName	string		Auto-swap slot name.
properties.azureStorageAccounts	<string,  AzureStorageInfoValue>		List of Azure Storage Accounts.
properties.connectionStrings	ConnStringInfo[]		Connection strings.
properties.cors	CorsSettings		Cross-Origin Resource Sharing (CORS) settings.
properties.defaultDocuments	string[]		Default documents.
properties.detailedErrorLoggingEnabled	boolean		true if detailed error logging is enabled; otherwise, false.
properties.documentRoot	string		Document root.
properties.elasticWebAppScaleLimit	integer		Maximum number of workers that a site can scale out to. This setting only applies to apps in plans where ElasticScaleEnabled is true
properties.experiments	Experiments		This is work around for polymorphic types.
properties.ftpsState	FtpsState		State of FTP / FTPS service
properties.functionAppScaleLimit	integer		Maximum number of workers that a site can scale out to. This setting only applies to the Consumption and Elastic Premium Plans
properties.functionsRuntimeScaleMonitoringEnabled	boolean		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.
properties.handlerMappings	HandlerMapping[]		Handler mappings.
properties.healthCheckPath	string		Health check path
properties.http20Enabled	boolean	True	Http20Enabled: configures a web site to allow clients to connect over http2.0
properties.httpLoggingEnabled	boolean		true if HTTP logging is enabled; otherwise, false.
properties.ipSecurityRestrictions	IpSecurityRestriction[]		IP security restrictions for main.
properties.ipSecurityRestrictionsDefaultAction	DefaultAction		Default action for main access restriction if no rules are matched.
properties.javaContainer	string		Java container.
properties.javaContainerVersion	string		Java container version.
properties.javaVersion	string		Java version.
properties.keyVaultReferenceIdentity	string		Identity to use for Key Vault Reference authentication.
properties.limits	SiteLimits		Site limits.
properties.linuxFxVersion	string		Linux App Framework and version
properties.loadBalancing	SiteLoadBalancing		Site load balancing.
properties.localMySqlEnabled	boolean	False	true to enable local MySQL; otherwise, false.
properties.logsDirectorySizeLimit	integer		HTTP logs directory size limit.
properties.machineKey	SiteMachineKey		Site MachineKey.
properties.managedPipelineMode	ManagedPipelineMode		Managed pipeline mode.
properties.managedServiceIdentityId	integer		Managed Service Identity Id
properties.metadata	NameValuePair[]		Application metadata. This property cannot be retrieved, since it may contain secrets.
properties.minTlsCipherSuite	TlsCipherSuites		The minimum strength TLS cipher suite allowed for an application
properties.minTlsVersion	SupportedTlsVersions		MinTlsVersion: configures the minimum version of TLS required for SSL requests
properties.minimumElasticInstanceCount	integer		Number of minimum instance count for a site This setting only applies to the Elastic Plans
properties.netFrameworkVersion	string	v4.6	.NET Framework version.
properties.nodeVersion	string		Version of Node.js.
properties.numberOfWorkers	integer		Number of workers.
properties.phpVersion	string		Version of PHP.
properties.powerShellVersion	string		Version of PowerShell.
properties.preWarmedInstanceCount	integer		Number of preWarmed instances. This setting only applies to the Consumption and Elastic Plans
properties.publicNetworkAccess	string		Property to allow or block all public traffic.
properties.publishingUsername	string		Publishing user name.
properties.push	PushSettings		Push endpoint settings.
properties.pythonVersion	string		Version of Python.
properties.remoteDebuggingEnabled	boolean		true if remote debugging is enabled; otherwise, false.
properties.remoteDebuggingVersion	string		Remote debugging version.
properties.requestTracingEnabled	boolean		true if request tracing is enabled; otherwise, false.
properties.requestTracingExpirationTime	string		Request tracing expiration time.
properties.scmIpSecurityRestrictions	IpSecurityRestriction[]		IP security restrictions for scm.
properties.scmIpSecurityRestrictionsDefaultAction	DefaultAction		Default action for scm access restriction if no rules are matched.
properties.scmIpSecurityRestrictionsUseMain	boolean		IP security restrictions for scm to use main.
properties.scmMinTlsVersion	SupportedTlsVersions		ScmMinTlsVersion: configures the minimum version of TLS required for SSL requests for SCM site
properties.scmType	ScmType		SCM type.
properties.tracingOptions	string		Tracing options.
properties.use32BitWorkerProcess	boolean		true to use 32-bit worker process; otherwise, false.
properties.virtualApplications	VirtualApplication[]		Virtual applications.
properties.vnetName	string		Virtual Network name.
properties.vnetPrivatePortsCount	integer		The number of private ports assigned to this app. These will be assigned dynamically on runtime.
properties.vnetRouteAllEnabled	boolean		Virtual Network Route All enabled. This causes all outbound traffic to have Virtual Network Security Groups and User Defined Routes applied.
properties.webSocketsEnabled	boolean		true if WebSocket is enabled; otherwise, false.
properties.websiteTimeZone	string		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_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones
properties.windowsFxVersion	string		Xenon App Framework and version
properties.xManagedServiceIdentityId	integer		Explicit Managed Service Identity Id
type	string		Resource type.

SiteLimits

Metric limits set on an app.

Name	Type	Description
maxDiskSizeInMb	integer	Maximum allowed disk size usage in MB.
maxMemoryInMb	integer	Maximum allowed memory usage in MB.
maxPercentageCpu	number	Maximum allowed CPU usage percentage.

SiteLoadBalancing

Site load balancing.

Name	Type	Description
LeastRequests	string
LeastRequestsWithTieBreaker	string
LeastResponseTime	string
PerSiteRoundRobin	string
RequestHash	string
WeightedRoundRobin	string
WeightedTotalTraffic	string

SiteMachineKey

MachineKey of an app.

Name	Type	Description
decryption	string	Algorithm used for decryption.
decryptionKey	string	Decryption key.
validation	string	MachineKey validation.
validationKey	string	Validation key.

SlowRequestsBasedTrigger

Trigger based on request execution time.

Name	Type	Description
count	integer	Request Count.
path	string	Request Path.
timeInterval	string	Time interval.
timeTaken	string	Time taken.

StatusCodesBasedTrigger

Trigger based on status code.

Name	Type	Description
count	integer	Request Count.
path	string	Request Path
status	integer	HTTP status code.
subStatus	integer	Request Sub Status.
timeInterval	string	Time interval.
win32Status	integer	Win32 error code.

StatusCodesRangeBasedTrigger

Trigger based on range of status codes.

Name	Type	Description
count	integer	Request Count.
path	string
statusCodes	string	HTTP status code.
timeInterval	string	Time interval.

SupportedTlsVersions

MinTlsVersion: configures the minimum version of TLS required for SSL requests

Name	Type	Description
1.0	string
1.1	string
1.2	string
1.3	string

TlsCipherSuites

The minimum strength TLS cipher suite allowed for an application

Name	Type	Description
TLS_AES_128_GCM_SHA256	string
TLS_AES_256_GCM_SHA384	string
TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256	string
TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256	string
TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384	string
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA	string
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256	string
TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256	string
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA	string
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384	string
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384	string
TLS_RSA_WITH_AES_128_CBC_SHA	string
TLS_RSA_WITH_AES_128_CBC_SHA256	string
TLS_RSA_WITH_AES_128_GCM_SHA256	string
TLS_RSA_WITH_AES_256_CBC_SHA	string
TLS_RSA_WITH_AES_256_CBC_SHA256	string
TLS_RSA_WITH_AES_256_GCM_SHA384	string

VirtualApplication

Virtual application in an app.

Name	Type	Description
physicalPath	string	Physical path.
preloadEnabled	boolean	true if preloading is enabled; otherwise, false.
virtualDirectories	VirtualDirectory[]	Virtual directories for virtual application.
virtualPath	string	Virtual path.

VirtualDirectory

Directory for virtual application.

Name	Type	Description
physicalPath	string	Physical path.
virtualPath	string	Path to virtual application.