Microsoft.Web sites/slots/config 'web' 2015-08-01

  • مقالة
  • قراءة خلال 7 دقائق

The sites/slots/config resource type can be deployed to: Resource groups.

To learn about resource group deployments, see Bicep or ARM template.

Options for name property

The sites/slots/config resource accepts different properties based on the value of the name property. This article shows the properties that are available when you set name: 'web'.

For other options, see:

Template format

To create a Microsoft.Web/sites/slots/config resource, add the following Bicep or JSON to your template.

resource symbolicname 'Microsoft.Web/sites/slots/config@2015-08-01' = {
  name: 'web'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  kind: 'string'
  parent: resourceSymbolicName
  properties: {
    alwaysOn: bool
    apiDefinition: {
      url: 'string'
    }
    appCommandLine: 'string'
    appSettings: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    autoHealEnabled: bool
    autoHealRules: {
      actions: {
        actionType: 'string'
        customAction: {
          exe: 'string'
          parameters: 'string'
        }
        minProcessExecutionTime: 'string'
      }
      triggers: {
        privateBytesInKB: int
        requests: {
          count: int
          timeInterval: 'string'
        }
        slowRequests: {
          count: int
          timeInterval: 'string'
          timeTaken: 'string'
        }
        statusCodes: [
          {
            count: int
            status: int
            subStatus: int
            timeInterval: 'string'
            win32Status: int
          }
        ]
      }
    }
    autoSwapSlotName: 'string'
    connectionStrings: [
      {
        connectionString: 'string'
        name: 'string'
        type: 'string'
      }
    ]
    cors: {
      allowedOrigins: [
        'string'
      ]
    }
    defaultDocuments: [
      'string'
    ]
    detailedErrorLoggingEnabled: bool
    documentRoot: 'string'
    experiments: {
      rampUpRules: [
        {
          actionHostName: 'string'
          changeDecisionCallbackUrl: 'string'
          changeIntervalInMinutes: int
          changeStep: int
          maxReroutePercentage: int
          minReroutePercentage: int
          name: 'string'
          reroutePercentage: int
        }
      ]
    }
    handlerMappings: [
      {
        arguments: 'string'
        extension: 'string'
        scriptProcessor: 'string'
      }
    ]
    httpLoggingEnabled: bool
    ipSecurityRestrictions: [
      {
        ipAddress: 'string'
        subnetMask: 'string'
      }
    ]
    javaContainer: 'string'
    javaContainerVersion: 'string'
    javaVersion: 'string'
    limits: {
      maxDiskSizeInMb: int
      maxMemoryInMb: int
      maxPercentageCpu: int
    }
    loadBalancing: 'string'
    localMySqlEnabled: bool
    logsDirectorySizeLimit: int
    managedPipelineMode: 'string'
    metadata: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    netFrameworkVersion: 'string'
    nodeVersion: 'string'
    numberOfWorkers: int
    phpVersion: 'string'
    publishingPassword: 'string'
    publishingUsername: 'string'
    pythonVersion: 'string'
    remoteDebuggingEnabled: bool
    remoteDebuggingVersion: 'string'
    requestTracingEnabled: bool
    requestTracingExpirationTime: 'string'
    scmType: 'string'
    tracingOptions: 'string'
    use32BitWorkerProcess: bool
    virtualApplications: [
      {
        physicalPath: 'string'
        preloadEnabled: bool
        virtualDirectories: [
          {
            physicalPath: 'string'
            virtualPath: 'string'
          }
        ]
        virtualPath: 'string'
      }
    ]
    vnetName: 'string'
    webSocketsEnabled: bool
  }
}

Property values

sites/slots/config-web

Name Description Value
type The resource type

For Bicep, set this value in the resource declaration.		 'Microsoft.Web/sites/slots/config'
apiVersion The resource api version

For Bicep, set this value in the resource declaration.		 '2015-08-01'
name The resource name

See how to set names and types for child resources in Bicep or JSON ARM templates.		 'web'
location Resource Location string (required)
tags Resource tags Dictionary of tag names and values. See Tags in templates
kind Kind of resource string
parent In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource.

For more information, see Child resource outside parent resource.		 Symbolic name for resource of type: slots
properties SiteConfigProperties

SiteConfigProperties

Name Description Value
alwaysOn Always On bool
apiDefinition Information about the formal API definition for the web app. ApiDefinitionInfo
appCommandLine App Command Line to launch string
appSettings Application Settings NameValuePair[]
autoHealEnabled Auto heal enabled bool
autoHealRules AutoHealRules - describes the rules which can be defined for auto-heal AutoHealRules
autoSwapSlotName Auto swap slot name string
connectionStrings Connection strings ConnStringInfo[]
cors Cross-Origin Resource Sharing (CORS) settings for the web app. CorsSettings
defaultDocuments Default documents string[]
detailedErrorLoggingEnabled Detailed error logging enabled bool
documentRoot Document root string
experiments Class containing Routing in production experiments Experiments
handlerMappings Handler mappings HandlerMapping[]
httpLoggingEnabled HTTP logging Enabled bool
ipSecurityRestrictions Ip Security restrictions IpSecurityRestriction[]
javaContainer Java container string
javaContainerVersion Java container version string
javaVersion Java version string
limits Represents metric limits set on a web app. SiteLimits
loadBalancing Site load balancing 'LeastRequests'
'LeastResponseTime'
'RequestHash'
'WeightedRoundRobin'
'WeightedTotalTraffic'
localMySqlEnabled Local mysql enabled bool
logsDirectorySizeLimit HTTP Logs Directory size limit int
managedPipelineMode Managed pipeline mode 'Classic'
'Integrated'
metadata Site Metadata NameValuePair[]
netFrameworkVersion Net Framework Version string
nodeVersion Version of Node string
numberOfWorkers Number of workers int
phpVersion Version of PHP string
publishingPassword Publishing password string
publishingUsername Publishing user name string
pythonVersion Version of Python string
remoteDebuggingEnabled Remote Debugging Enabled bool
remoteDebuggingVersion Remote Debugging Version string
requestTracingEnabled Enable request tracing bool
requestTracingExpirationTime Request tracing expiration time string
scmType SCM type string
tracingOptions Tracing options string
use32BitWorkerProcess Use 32 bit worker process bool
virtualApplications Virtual applications VirtualApplication[]
vnetName Vnet name string
webSocketsEnabled Web socket enabled. bool

ApiDefinitionInfo

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

NameValuePair

Name Description Value
name Pair name string
value Pair value string

AutoHealRules

Name Description Value
actions AutoHealActions - Describes the actions which can be
taken by the auto-heal module when a rule is triggered.		 AutoHealActions
triggers AutoHealTriggers - describes the triggers for auto-heal. AutoHealTriggers

AutoHealActions

Name Description Value
actionType ActionType - predefined action to be taken 'CustomAction'
'LogEvent'
'Recycle'
customAction AutoHealCustomAction - Describes the custom action to be executed
when an auto heal rule is triggered.		 AutoHealCustomAction
minProcessExecutionTime MinProcessExecutionTime - minimum time the process must execute
before taking the action
 string

AutoHealCustomAction

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

AutoHealTriggers

Name Description Value
privateBytesInKB PrivateBytesInKB - Defines a rule based on private bytes int
requests RequestsBasedTrigger RequestsBasedTrigger
slowRequests SlowRequestsBasedTrigger SlowRequestsBasedTrigger
statusCodes StatusCodes - Defines a rule based on status codes StatusCodesBasedTrigger[]

RequestsBasedTrigger

Name Description Value
count Count int
timeInterval TimeInterval string

SlowRequestsBasedTrigger

Name Description Value
count Count int
timeInterval TimeInterval string
timeTaken TimeTaken string

StatusCodesBasedTrigger

Name Description Value
count Count int
status HTTP status code int
subStatus SubStatus int
timeInterval TimeInterval string
win32Status Win32 error code int

ConnStringInfo

Name Description Value
connectionString Connection string value string
name Name of connection string string
type Type of database 'Custom'
'MySql'
'SQLAzure'
'SQLServer'

CorsSettings

Name Description Value
allowedOrigins 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.
 string[]

Experiments

Name Description Value
rampUpRules List of {Microsoft.Web.Hosting.Administration.RampUpRule} objects. RampUpRule[]

RampUpRule

Name Description Value
actionHostName Hostname of a slot to which the traffic will be redirected if decided to. E.g. mysite-stage.azurewebsites.net string
changeDecisionCallbackUrl 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/		 string
changeIntervalInMinutes [Optional] Specifies interval in minutes to reevaluate ReroutePercentage int
changeStep [Optional] In auto ramp up scenario this is the step to add/remove from {Microsoft.Web.Hosting.Administration.RampUpRule.ReroutePercentage} until it reaches
{Microsoft.Web.Hosting.Administration.RampUpRule.MinReroutePercentage} or {Microsoft.Web.Hosting.Administration.RampUpRule.MaxReroutePercentage}. Site metrics are checked every N minutes specified in {Microsoft.Web.Hosting.Administration.RampUpRule.ChangeIntervalInMinutes}.
Custom decision algorithm can be provided in TiPCallback site extension which Url can be specified in {Microsoft.Web.Hosting.Administration.RampUpRule.ChangeDecisionCallbackUrl}		 int
maxReroutePercentage [Optional] Specifies upper boundary below which ReroutePercentage will stay. int
minReroutePercentage [Optional] Specifies lower boundary above which ReroutePercentage will stay. int
name Name of the routing rule. The recommended name would be to point to the slot which will receive the traffic in the experiment. string
reroutePercentage Percentage of the traffic which will be redirected to {Microsoft.Web.Hosting.Administration.RampUpRule.ActionHostName} int

HandlerMapping

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

IpSecurityRestriction

Name Description Value
ipAddress IP address the security restriction is valid for string
subnetMask Subnet mask for the range of IP addresses the restriction is valid for string

SiteLimits

Name Description Value
maxDiskSizeInMb Maximum allowed disk size usage in MB int
maxMemoryInMb Maximum allowed memory usage in MB int
maxPercentageCpu Maximum allowed CPU usage percentage int

VirtualApplication

Name Description Value
physicalPath string
preloadEnabled bool
virtualDirectories Array of VirtualDirectory VirtualDirectory[]
virtualPath string

VirtualDirectory

Name Description Value
physicalPath string
virtualPath string