App Service Plans - List Web Apps
Description for Get all apps associated with an App Service plan.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/serverfarms/{name}/sites?api-version=2024-04-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/serverfarms/{name}/sites?api-version=2024-04-01&$skipToken={$skipToken}&$filter={$filter}&$top={$top}
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
name
|
path | True |
string |
Name of the App Service plan. |
resource
|
path | True |
string |
Name of the resource group to which the resource belongs. Regex pattern: |
subscription
|
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 |
$filter
|
query |
string |
Supported filter: $filter=state eq running. Returns only web apps that are currently running |
|
$skip
|
query |
string |
Skip to a web app in the list of webapps associated with app service plan. If specified, the resulting list will contain web apps starting from (including) the skipToken. Otherwise, the resulting list contains web apps from the start of the list |
|
$top
|
query |
string |
List page size. If specified, results are paged. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
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 |
---|---|
Api |
Information about the formal API definition for the app. |
Api |
Azure API management (APIM) configuration linked to the app. |
Authentication |
Authentication method to access the storage account for deployment. |
Authentication |
Property to select authentication type to access the selected storage account. Available options: SystemAssignedIdentity, UserAssignedIdentity, StorageAccountConnectionString. |
auto |
Specifies the scope of uniqueness for the default hostname during resource creation |
Auto |
Actions which to take by the auto-heal module when a rule is triggered. |
Auto |
Predefined action to be taken. |
Auto |
Custom action to be executed when an auto heal rule is triggered. |
Auto |
Rules that can be defined for auto-heal. |
Auto |
Triggers for auto-heal. |
Azure |
Azure Files or Blob Storage access information value for dictionary storage. |
Azure |
Mounting protocol to use for the storage account. |
Azure |
State of the storage account. |
Azure |
Type of storage. |
Client |
This composes with ClientCertEnabled setting.
|
Cloning |
Information needed for cloning operation. |
Connection |
Type of database. |
Conn |
Database connection string information. |
Cors |
Cross-Origin Resource Sharing (CORS) settings for the app. |
Dapr |
App Dapr configuration. |
dapr |
Sets the log level for the Dapr sidecar. Allowed values are debug, info, warn, error. Default is info. |
Default |
Default action for main access restriction if no rules are matched. |
Default |
App Service error response. |
Details | |
Error |
Error model. |
Experiments |
Routing rules in production experiments. |
Extended |
Extended Location. |
Ftps |
State of FTP / FTPS service |
Function |
Function app configuration. |
Functions |
Sets the number of 'Always Ready' instances for a function group or a specific function. |
Functions |
Configuration section for the function app deployment. |
Functions |
Property to select Azure Storage type. Available options: blobContainer. |
Functions |
Function app runtime name and version. |
Functions |
Scale and concurrency settings for the function app. |
Handler |
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. |
Hosting |
Specification for an App Service Environment to use for this resource. |
Host |
SSL-enabled hostname. |
Host |
Indicates whether the hostname is a standard or repository hostname. |
Http |
Scale and concurrency settings for the HTTP trigger. |
Ip |
Defines what this IP filter will be used for. This is to support IP filtering on proxies. |
IPMode |
Specifies the IP mode of the app. |
Ip |
IP security restriction on an app. |
Managed |
Managed pipeline mode. |
Managed |
Managed service identity. |
Managed |
Type of managed service identity. |
Name |
Name value pair. |
Push |
Push settings for the App. |
Ramp |
Routing rules for ramp up testing. This rule allows to redirect static traffic % to a slot or to gradually change routing % based on performance. |
Redundancy |
Site redundancy mode |
Requests |
Trigger based on total requests. |
Resource |
Function app resource requirements. |
Runtime |
Function app runtime name. Available options: dotnet-isolated, node, java, powershell, python, custom |
Scm |
SCM type. |
Site |
A web app, a mobile app backend, or an API app. |
Site |
Management information availability state for the app. |
Site |
Configuration of an App Service app. |
Site |
|
Site |
Metric limits set on an app. |
Site |
Site load balancing. |
Site |
MachineKey of an app. |
Slot |
The status of the last successful slot swap operation. |
Slow |
Trigger based on request execution time. |
Ssl |
SSL type. |
Status |
Trigger based on status code. |
Status |
Trigger based on range of status codes. |
Storage |
Storage for deployed package used by the function app. |
Supported |
MinTlsVersion: configures the minimum version of TLS required for SSL requests |
Tls |
The minimum strength TLS cipher suite allowed for an application |
Triggers |
Scale and concurrency settings for the function app triggers. |
Usage |
State indicating whether the app has exceeded its quota usage. Read-only. |
user |
User Assigned identity. |
Virtual |
Virtual application in an app. |
Virtual |
Directory for virtual application. |
Web |
Collection of App Service apps. |
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. |
Authentication
Authentication method to access the storage account for deployment.
Name | Type | Description |
---|---|---|
storageAccountConnectionStringName |
string |
Use this property for StorageAccountConnectionString. Set the name of the app setting that has the storage account connection string. Do not set a value for this property when using other authentication type. |
type |
Property to select authentication type to access the selected storage account. Available options: SystemAssignedIdentity, UserAssignedIdentity, StorageAccountConnectionString. |
|
userAssignedIdentityResourceId |
string |
Use this property for UserAssignedIdentity. Set the resource ID of the identity. Do not set a value for this property when using other authentication type. |
AuthenticationType
Property to select authentication type to access the selected storage account. Available options: SystemAssignedIdentity, UserAssignedIdentity, StorageAccountConnectionString.
Name | Type | Description |
---|---|---|
StorageAccountConnectionString |
string |
|
SystemAssignedIdentity |
string |
|
UserAssignedIdentity |
string |
autoGeneratedDomainNameLabelScope
Specifies the scope of uniqueness for the default hostname during resource creation
Name | Type | Description |
---|---|---|
NoReuse |
string |
|
ResourceGroupReuse |
string |
|
SubscriptionReuse |
string |
|
TenantReuse |
string |
AutoHealActions
Actions which to take by the auto-heal module when a rule is triggered.
Name | Type | Description |
---|---|---|
actionType |
Predefined action to be taken. |
|
customAction |
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 |
Actions to be executed when a rule is triggered. |
|
triggers |
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 |
A rule based on total requests. |
|
slowRequests |
A rule based on request execution time. |
|
slowRequestsWithPath |
A rule based on multiple Slow Requests Rule with path |
|
statusCodes |
A rule based on status codes. |
|
statusCodesRange |
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 |
Mounting protocol to use for the storage account. |
|
shareName |
string |
Name of the file share (container name, for Blob storage). |
state |
State of the storage account. |
|
type |
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 |
ClientCertMode
This composes with ClientCertEnabled setting.
- ClientCertEnabled: false means ClientCert is ignored.
- ClientCertEnabled: true and ClientCertMode: Required means ClientCert is required.
- ClientCertEnabled: true and ClientCertMode: Optional means ClientCert is optional or accepted.
Name | Type | Description |
---|---|---|
Optional |
string |
|
OptionalInteractiveUser |
string |
|
Required |
string |
CloningInfo
Information needed for cloning operation.
Name | Type | Description |
---|---|---|
appSettingsOverrides |
object |
Application setting overrides for cloned app. If specified, these settings override the settings cloned from source app. Otherwise, application settings from source app are retained. |
cloneCustomHostNames |
boolean |
|
cloneSourceControl |
boolean |
|
configureLoadBalancing |
boolean |
|
correlationId |
string |
Correlation ID of cloning operation. This ID ties multiple cloning operations together to use the same snapshot. |
hostingEnvironment |
string |
App Service Environment. |
overwrite |
boolean |
|
sourceWebAppId |
string |
ARM resource ID of the source app. App resource ID is of the form /subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName} for production slots and /subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/slots/{slotName} for other slots. |
sourceWebAppLocation |
string |
Location of source app ex: West US or North Europe |
trafficManagerProfileId |
string |
ARM resource ID of the Traffic Manager profile to use, if it exists. Traffic Manager resource ID is of the form /subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{profileName}. |
trafficManagerProfileName |
string |
Name of Traffic Manager profile to create. This is only needed if Traffic Manager profile does not already exist. |
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 |
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. |
DaprConfig
App Dapr configuration.
Name | Type | Default value | Description |
---|---|---|---|
appId |
string |
Dapr application identifier |
|
appPort |
integer |
Tells Dapr which port your application is listening on |
|
enableApiLogging |
boolean |
Enables API logging for the Dapr sidecar |
|
enabled |
boolean |
False |
Boolean indicating if the Dapr side car is enabled |
httpMaxRequestSize |
integer |
Increasing max size of request body http servers parameter in MB to handle uploading of big files. Default is 4 MB. |
|
httpReadBufferSize |
integer |
Dapr max size of http header read buffer in KB to handle when sending multi-KB headers. Default is 65KB. |
|
logLevel |
Sets the log level for the Dapr sidecar. Allowed values are debug, info, warn, error. Default is info. |
daprLogLevel
Sets the log level for the Dapr sidecar. Allowed values are debug, info, warn, error. Default is info.
Name | Type | Description |
---|---|---|
debug |
string |
|
error |
string |
|
info |
string |
|
warn |
string |
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 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 |
List of ramp-up rules. |
ExtendedLocation
Extended Location.
Name | Type | Description |
---|---|---|
name |
string |
Name of extended location. |
type |
string |
Type of extended location. |
FtpsState
State of FTP / FTPS service
Name | Type | Description |
---|---|---|
AllAllowed |
string |
|
Disabled |
string |
|
FtpsOnly |
string |
FunctionAppConfig
Function app configuration.
Name | Type | Description |
---|---|---|
deployment |
Function app deployment configuration. |
|
runtime |
Function app runtime settings. |
|
scaleAndConcurrency |
Function app scale and concurrency settings. |
FunctionsAlwaysReadyConfig
Sets the number of 'Always Ready' instances for a function group or a specific function.
Name | Type | Description |
---|---|---|
instanceCount |
integer |
Sets the number of 'Always Ready' instances for a given function group or a specific function. For additional information see https://aka.ms/flexconsumption/alwaysready. |
name |
string |
Either a function group or a function name is required. For additional information see https://aka.ms/flexconsumption/alwaysready. |
FunctionsDeployment
Configuration section for the function app deployment.
Name | Type | Description |
---|---|---|
storage |
Storage for deployed package used by the function app. |
FunctionsDeploymentStorageType
Property to select Azure Storage type. Available options: blobContainer.
Name | Type | Description |
---|---|---|
blobContainer |
string |
FunctionsRuntime
Function app runtime name and version.
Name | Type | Description |
---|---|---|
name |
Function app runtime name. Available options: dotnet-isolated, node, java, powershell, python, custom |
|
version |
string |
Function app runtime version. Example: 8 (for dotnet-isolated) |
FunctionsScaleAndConcurrency
Scale and concurrency settings for the function app.
Name | Type | Description |
---|---|---|
alwaysReady |
'Always Ready' configuration for the function app. |
|
instanceMemoryMB |
integer |
Set the amount of memory allocated to each instance of the function app in MB. CPU and network bandwidth are allocated proportionally. |
maximumInstanceCount |
integer |
The maximum number of instances for the function app. |
triggers |
Scale and concurrency settings for the function app triggers. |
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. |
HostingEnvironmentProfile
Specification for an App Service Environment to use for this resource.
Name | Type | Description |
---|---|---|
id |
string |
Resource ID of the App Service Environment. |
name |
string |
Name of the App Service Environment. |
type |
string |
Resource type of the App Service Environment. |
HostNameSslState
SSL-enabled hostname.
Name | Type | Description |
---|---|---|
hostType |
Indicates whether the hostname is a standard or repository hostname. |
|
name |
string |
Hostname. |
sslState |
SSL type. |
|
thumbprint |
string |
SSL certificate thumbprint. |
toUpdate |
boolean |
Set to |
virtualIP |
string |
Virtual IP address assigned to the hostname if IP based SSL is enabled. |
HostType
Indicates whether the hostname is a standard or repository hostname.
Name | Type | Description |
---|---|---|
Repository |
string |
|
Standard |
string |
Http
Scale and concurrency settings for the HTTP trigger.
Name | Type | Description |
---|---|---|
perInstanceConcurrency |
integer |
The maximum number of concurrent HTTP trigger invocations per instance. |
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 |
IPMode
Specifies the IP mode of the app.
Name | Type | Description |
---|---|---|
IPv4 |
string |
|
IPv4AndIPv6 |
string |
|
IPv6 |
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 ..
X-Forwarded-For (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-For#Examples). The matching logic is ..
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 |
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 |
ManagedServiceIdentity
Managed service identity.
Name | Type | Description |
---|---|---|
principalId |
string |
Principal Id of managed service identity. |
tenantId |
string |
Tenant of managed service identity. |
type |
Type of managed service identity. |
|
userAssignedIdentities |
<string,
user |
The list of user assigned identities associated with the resource. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} |
ManagedServiceIdentityType
Type of managed service identity.
Name | Type | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
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 |
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 |
RedundancyMode
Site redundancy mode
Name | Type | Description |
---|---|---|
ActiveActive |
string |
|
Failover |
string |
|
GeoRedundant |
string |
|
Manual |
string |
|
None |
string |
RequestsBasedTrigger
Trigger based on total requests.
Name | Type | Description |
---|---|---|
count |
integer |
Request Count. |
timeInterval |
string |
Time interval. |
ResourceConfig
Function app resource requirements.
Name | Type | Description |
---|---|---|
cpu |
number |
Required CPU in cores, e.g. 0.5 |
memory |
string |
Required memory, e.g. "1Gi" |
RuntimeName
Function app runtime name. Available options: dotnet-isolated, node, java, powershell, python, custom
Name | Type | Description |
---|---|---|
custom |
string |
|
dotnet-isolated |
string |
|
java |
string |
|
node |
string |
|
powershell |
string |
|
python |
string |
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 |
Site
A web app, a mobile app backend, or an API app.
Name | Type | Default value | Description |
---|---|---|---|
extendedLocation |
Extended Location. |
||
id |
string |
Resource Id. |
|
identity |
Managed service identity. |
||
kind |
string |
Kind of resource. If the resource is an app, you can refer to https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference for details supported values for kind. |
|
location |
string |
Resource Location. |
|
name |
string |
Resource Name. |
|
properties.autoGeneratedDomainNameLabelScope |
Specifies the scope of uniqueness for the default hostname during resource creation |
||
properties.availabilityState |
Management information availability state for the app. |
||
properties.clientAffinityEnabled |
boolean |
|
|
properties.clientCertEnabled |
boolean |
|
|
properties.clientCertExclusionPaths |
string |
client certificate authentication comma-separated exclusion paths |
|
properties.clientCertMode |
This composes with ClientCertEnabled setting.
|
||
properties.cloningInfo |
If specified during app creation, the app is cloned from a source app. |
||
properties.containerSize |
integer |
Size of the function container. |
|
properties.customDomainVerificationId |
string |
Unique identifier that verifies the custom domains assigned to the app. Customer will add this id to a txt record for verification. |
|
properties.dailyMemoryTimeQuota |
integer |
Maximum allowed daily memory-time quota (applicable on dynamic apps only). |
|
properties.daprConfig |
Dapr configuration of the app. |
||
properties.defaultHostName |
string |
Default hostname of the app. Read-only. |
|
properties.dnsConfiguration |
Property to configure various DNS related settings for a site. |
||
properties.enabled |
boolean |
|
|
properties.enabledHostNames |
string[] |
Enabled hostnames for the app.Hostnames need to be assigned (see HostNames) AND enabled. Otherwise, the app is not served on those hostnames. |
|
properties.endToEndEncryptionEnabled |
boolean |
Whether to use end to end encryption between the FrontEnd and the Worker |
|
properties.functionAppConfig |
Configuration specific of the Azure Function app. |
||
properties.hostNameSslStates |
Hostname SSL states are used to manage the SSL bindings for app's hostnames. |
||
properties.hostNames |
string[] |
Hostnames associated with the app. |
|
properties.hostNamesDisabled |
boolean |
|
|
properties.hostingEnvironmentProfile |
App Service Environment to use for the app. |
||
properties.httpsOnly |
boolean |
HttpsOnly: configures a web site to accept only https requests. Issues redirect for http requests |
|
properties.hyperV |
boolean |
False |
Hyper-V sandbox. |
properties.inProgressOperationId |
string |
Specifies an operation id if this site has a pending operation. |
|
properties.ipMode |
Specifies the IP mode of the app. |
||
properties.isDefaultContainer |
boolean |
|
|
properties.isXenon |
boolean |
False |
Obsolete: Hyper-V sandbox. |
properties.keyVaultReferenceIdentity |
string |
Identity to use for Key Vault Reference authentication. |
|
properties.lastModifiedTimeUtc |
string |
Last time the app was modified, in UTC. Read-only. |
|
properties.managedEnvironmentId |
string |
Azure Resource Manager ID of the customer's selected Managed Environment on which to host this app. This must be of the form /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.App/managedEnvironments/{managedEnvironmentName} |
|
properties.maxNumberOfWorkers |
integer |
Maximum number of workers. This only applies to Functions container. |
|
properties.outboundIpAddresses |
string |
List of IP addresses that the app uses for outbound connections (e.g. database access). Includes VIPs from tenants that site can be hosted with current settings. Read-only. |
|
properties.possibleOutboundIpAddresses |
string |
List of IP addresses that the app uses for outbound connections (e.g. database access). Includes VIPs from all tenants except dataComponent. Read-only. |
|
properties.publicNetworkAccess |
string |
Property to allow or block all public traffic. Allowed Values: 'Enabled', 'Disabled' or an empty string. |
|
properties.redundancyMode |
Site redundancy mode |
||
properties.repositorySiteName |
string |
Name of the repository site. |
|
properties.reserved |
boolean |
False |
|
properties.resourceConfig |
Function app resource requirements. |
||
properties.resourceGroup |
string |
Name of the resource group the app belongs to. Read-only. |
|
properties.scmSiteAlsoStopped |
boolean |
False |
|
properties.serverFarmId |
string |
Resource ID of the associated App Service plan, formatted as: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}". |
|
properties.siteConfig |
Configuration of the app. |
||
properties.sku |
string |
Current SKU of application based on associated App Service Plan. Some valid SKU values are Free, Shared, Basic, Dynamic, FlexConsumption, Standard, Premium, PremiumV2, PremiumV3, Isolated, IsolatedV2 |
|
properties.slotSwapStatus |
Status of the last deployment slot swap operation. |
||
properties.state |
string |
Current state of the app. |
|
properties.storageAccountRequired |
boolean |
Checks if Customer provided storage account is required |
|
properties.suspendedTill |
string |
App suspended till in case memory-time quota is exceeded. |
|
properties.targetSwapSlot |
string |
Specifies which deployment slot this app will swap into. Read-only. |
|
properties.trafficManagerHostNames |
string[] |
Azure Traffic Manager hostnames associated with the app. Read-only. |
|
properties.usageState |
State indicating whether the app has exceeded its quota usage. Read-only. |
||
properties.virtualNetworkSubnetId |
string |
Azure Resource Manager ID of the Virtual network and subnet to be joined by Regional VNET Integration. This must be of the form /subscriptions/{subscriptionName}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName} |
|
properties.vnetBackupRestoreEnabled |
boolean |
To enable Backup and Restore operations over virtual network |
|
properties.vnetContentShareEnabled |
boolean |
To enable accessing content over virtual network |
|
properties.vnetImagePullEnabled |
boolean |
To enable pulling image over Virtual Network |
|
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.workloadProfileName |
string |
Workload profile name for function app to execute on. |
|
tags |
object |
Resource tags. |
|
type |
string |
Resource type. |
SiteAvailabilityState
Management information availability state for the app.
Name | Type | Description |
---|---|---|
DisasterRecoveryMode |
string |
|
Limited |
string |
|
Normal |
string |
SiteConfig
Configuration of an App Service app.
Name | Type | Default value | Description |
---|---|---|---|
acrUseManagedIdentityCreds |
boolean |
Flag to use Managed Identity Creds for ACR pull |
|
acrUserManagedIdentityID |
string |
If using user managed identity, the user managed identity ClientId |
|
alwaysOn |
boolean |
|
|
apiDefinition |
Information about the formal API definition for the app. |
||
apiManagementConfig |
Azure API management settings linked to the app. |
||
appCommandLine |
string |
App command line to launch. |
|
appSettings |
Application settings. |
||
autoHealEnabled |
boolean |
|
|
autoHealRules |
Auto Heal rules. |
||
autoSwapSlotName |
string |
Auto-swap slot name. |
|
azureStorageAccounts |
<string,
Azure |
List of Azure Storage Accounts. |
|
connectionStrings |
Connection strings. |
||
cors |
Cross-Origin Resource Sharing (CORS) settings. |
||
defaultDocuments |
string[] |
Default documents. |
|
detailedErrorLoggingEnabled |
boolean |
|
|
documentRoot |
string |
Document root. |
|
elasticWebAppScaleLimit |
integer |
Maximum number of workers that a site can scale out to.
This setting only applies to apps in plans where ElasticScaleEnabled is |
|
experiments |
This is work around for polymorphic types. |
||
ftpsState |
State of FTP / FTPS service |
||
functionAppScaleLimit |
integer |
Maximum number of workers that a site can scale out to. This setting only applies to the Consumption and Elastic Premium Plans |
|
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. |
|
handlerMappings |
Handler mappings. |
||
healthCheckPath |
string |
Health check path |
|
http20Enabled |
boolean |
True |
Http20Enabled: configures a web site to allow clients to connect over http2.0 |
httpLoggingEnabled |
boolean |
|
|
ipSecurityRestrictions |
IP security restrictions for main. |
||
ipSecurityRestrictionsDefaultAction |
Default action for main access restriction if no rules are matched. |
||
javaContainer |
string |
Java container. |
|
javaContainerVersion |
string |
Java container version. |
|
javaVersion |
string |
Java version. |
|
keyVaultReferenceIdentity |
string |
Identity to use for Key Vault Reference authentication. |
|
limits |
Site limits. |
||
linuxFxVersion |
string |
Linux App Framework and version |
|
loadBalancing |
Site load balancing. |
||
localMySqlEnabled |
boolean |
False |
|
logsDirectorySizeLimit |
integer |
HTTP logs directory size limit. |
|
machineKey |
Site MachineKey. |
||
managedPipelineMode |
Managed pipeline mode. |
||
managedServiceIdentityId |
integer |
Managed Service Identity Id |
|
metadata |
Application metadata. This property cannot be retrieved, since it may contain secrets. |
||
minTlsCipherSuite |
The minimum strength TLS cipher suite allowed for an application |
||
minTlsVersion |
MinTlsVersion: configures the minimum version of TLS required for SSL requests |
||
minimumElasticInstanceCount |
integer |
Number of minimum instance count for a site This setting only applies to the Elastic Plans |
|
netFrameworkVersion |
string |
v4.6 |
.NET Framework version. |
nodeVersion |
string |
Version of Node.js. |
|
numberOfWorkers |
integer |
Number of workers. |
|
phpVersion |
string |
Version of PHP. |
|
powerShellVersion |
string |
Version of PowerShell. |
|
preWarmedInstanceCount |
integer |
Number of preWarmed instances. This setting only applies to the Consumption and Elastic Plans |
|
publicNetworkAccess |
string |
Property to allow or block all public traffic. |
|
publishingUsername |
string |
Publishing user name. |
|
push |
Push endpoint settings. |
||
pythonVersion |
string |
Version of Python. |
|
remoteDebuggingEnabled |
boolean |
|
|
remoteDebuggingVersion |
string |
Remote debugging version. |
|
requestTracingEnabled |
boolean |
|
|
requestTracingExpirationTime |
string |
Request tracing expiration time. |
|
scmIpSecurityRestrictions |
IP security restrictions for scm. |
||
scmIpSecurityRestrictionsDefaultAction |
Default action for scm access restriction if no rules are matched. |
||
scmIpSecurityRestrictionsUseMain |
boolean |
IP security restrictions for scm to use main. |
|
scmMinTlsVersion |
ScmMinTlsVersion: configures the minimum version of TLS required for SSL requests for SCM site |
||
scmType |
SCM type. |
||
tracingOptions |
string |
Tracing options. |
|
use32BitWorkerProcess |
boolean |
|
|
virtualApplications |
Virtual applications. |
||
vnetName |
string |
Virtual Network name. |
|
vnetPrivatePortsCount |
integer |
The number of private ports assigned to this app. These will be assigned dynamically on runtime. |
|
vnetRouteAllEnabled |
boolean |
Virtual Network Route All enabled. This causes all outbound traffic to have Virtual Network Security Groups and User Defined Routes applied. |
|
webSocketsEnabled |
boolean |
|
|
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 |
|
windowsFxVersion |
string |
Xenon App Framework and version |
|
xManagedServiceIdentityId |
integer |
Explicit Managed Service Identity Id |
SiteDnsConfig
Name | Type | Description |
---|---|---|
dnsAltServer |
string |
Alternate DNS server to be used by apps. This property replicates the WEBSITE_DNS_ALT_SERVER app setting. |
dnsLegacySortOrder |
boolean |
Indicates that sites using Virtual network custom DNS servers are still sorting the list of DNS servers. Read-Only. |
dnsMaxCacheTimeout |
integer |
Custom time for DNS to be cached in seconds. Allowed range: 0-60. Default is 30 seconds. 0 means caching disabled. |
dnsRetryAttemptCount |
integer |
Total number of retries for dns lookup. Allowed range: 1-5. Default is 3. |
dnsRetryAttemptTimeout |
integer |
Timeout for a single dns lookup in seconds. Allowed range: 1-30. Default is 3. |
dnsServers |
string[] |
List of custom DNS servers to be used by an app for lookups. Maximum 5 dns servers can be set. |
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. |
SlotSwapStatus
The status of the last successful slot swap operation.
Name | Type | Description |
---|---|---|
destinationSlotName |
string |
The destination slot of the last swap operation. |
sourceSlotName |
string |
The source slot of the last swap operation. |
timestampUtc |
string |
The time the last successful slot swap completed. |
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. |
SslState
SSL type.
Name | Type | Description |
---|---|---|
Disabled |
string |
|
IpBasedEnabled |
string |
|
SniEnabled |
string |
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. |
Storage
Storage for deployed package used by the function app.
Name | Type | Description |
---|---|---|
authentication |
Authentication method to access the storage account for deployment. |
|
type |
Property to select Azure Storage type. Available options: blobContainer. |
|
value |
string |
Property to set the URL for the selected Azure Storage type. Example: For blobContainer, the value could be https://.blob.core.windows.net/. |
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 |
Triggers
Scale and concurrency settings for the function app triggers.
Name | Type | Description |
---|---|---|
http |
Scale and concurrency settings for the HTTP trigger. |
UsageState
State indicating whether the app has exceeded its quota usage. Read-only.
Name | Type | Description |
---|---|---|
Exceeded |
string |
|
Normal |
string |
userAssignedIdentity
User Assigned identity.
Name | Type | Description |
---|---|---|
clientId |
string |
Client Id of user assigned identity |
principalId |
string |
Principal Id of user assigned identity |
VirtualApplication
Virtual application in an app.
Name | Type | Description |
---|---|---|
physicalPath |
string |
Physical path. |
preloadEnabled |
boolean |
|
virtualDirectories |
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. |
WebAppCollection
Collection of App Service apps.
Name | Type | Description |
---|---|---|
nextLink |
string |
Link to next page of resources. |
value |
Site[] |
Collection of resources. |