Compartir a través de


Microsoft.Web sites/slots 2016-08-01

Definición de recursos de Bicep

El tipo de recurso sites/slots se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Web/sites/slots, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Web/sites/slots@2016-08-01' = {
  parent: resourceSymbolicName
  identity: {
    type: 'string'
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    clientAffinityEnabled: bool
    clientCertEnabled: bool
    cloningInfo: {
      appSettingsOverrides: {
        {customized property}: 'string'
      }
      cloneCustomHostNames: bool
      cloneSourceControl: bool
      configureLoadBalancing: bool
      correlationId: 'string'
      hostingEnvironment: 'string'
      ignoreQuotas: bool
      overwrite: bool
      sourceWebAppId: 'string'
      trafficManagerProfileId: 'string'
      trafficManagerProfileName: 'string'
    }
    containerSize: int
    dailyMemoryTimeQuota: int
    enabled: bool
    hostingEnvironmentProfile: {
      id: 'string'
    }
    hostNamesDisabled: bool
    hostNameSslStates: [
      {
        hostType: 'string'
        name: 'string'
        sslState: 'string'
        thumbprint: 'string'
        toUpdate: bool
        virtualIP: 'string'
      }
    ]
    httpsOnly: bool
    reserved: bool
    scmSiteAlsoStopped: bool
    serverFarmId: 'string'
    siteConfig: {
      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'
        }
      ]
      http20Enabled: bool
      httpLoggingEnabled: bool
      ipSecurityRestrictions: [
        {
          ipAddress: 'string'
          subnetMask: 'string'
        }
      ]
      javaContainer: 'string'
      javaContainerVersion: 'string'
      javaVersion: 'string'
      limits: {
        maxDiskSizeInMb: int
        maxMemoryInMb: int
        maxPercentageCpu: int
      }
      linuxFxVersion: 'string'
      loadBalancing: 'string'
      localMySqlEnabled: bool
      logsDirectorySizeLimit: int
      managedPipelineMode: 'string'
      minTlsVersion: 'string'
      netFrameworkVersion: 'string'
      nodeVersion: 'string'
      numberOfWorkers: int
      phpVersion: 'string'
      publishingUsername: 'string'
      push: {
        kind: 'string'
        properties: {
          dynamicTagsJson: 'string'
          isPushEnabled: bool
          tagsRequiringAuth: 'string'
          tagWhitelistJson: '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
    }
    snapshotInfo: {
      kind: 'string'
      properties: {
        ignoreConflictingHostNames: bool
        overwrite: bool
        recoverConfiguration: bool
        recoveryTarget: {
          id: 'string'
          location: 'string'
        }
        snapshotTime: 'string'
      }
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propiedad

ApiDefinitionInfo

Nombre Descripción Valor
URL Dirección URL de la definición de API. cuerda

AutoHealActions

Nombre Descripción Valor
actionType Acción predefinida que se va a realizar. 'CustomAction'
'LogEvent'
'Reciclaje'
customAction Acción personalizada que se va a realizar. AutoHealCustomAction
minProcessExecutionTime Tiempo mínimo que el proceso debe ejecutar
antes de realizar la acción
cuerda

AutoHealCustomAction

Nombre Descripción Valor
exe Ejecutable que se va a ejecutar. cuerda
Parámetros Parámetros para el archivo ejecutable. cuerda

AutoHealRules

Nombre Descripción Valor
Acciones Acciones que se ejecutarán cuando se desencadene una regla. AutoHealActions
desencadenantes Condiciones que describen cuándo ejecutar las acciones de recuperación automática. AutoHealTriggers

AutoHealTriggers

Nombre Descripción Valor
privateBytesInKB Una regla basada en bytes privados. Int
Solicitudes Una regla basada en el total de solicitudes. RequestsBasedTrigger
slowRequests Una regla basada en el tiempo de ejecución de la solicitud. SlowRequestsBasedTrigger
statusCodes Regla basada en códigos de estado. StatusCodesBasedTrigger []

CloneInfo

Nombre Descripción Valor
appSettingsOverrides La configuración de la aplicación invalida la aplicación clonada. Si se especifica, esta configuración invalida la configuración clonada.
desde la aplicación de origen. De lo contrario, se conserva la configuración de la aplicación de origen.
CloneInfoAppSettingsOverrides
cloneCustomHostNames <código>true</code> para clonar nombres de host personalizados de la aplicación de origen; De lo contrario, <código>false</code>. Bool
cloneSourceControl <código>true</code> para clonar el control de código fuente de la aplicación de origen; De lo contrario, <código>false</code>. Bool
configureLoadBalancing <código>true</code> para configurar el equilibrio de carga para la aplicación de origen y destino. Bool
correlationId Id. de correlación de la operación de clonación. Este identificador vincula varias operaciones de clonación.
juntos para usar la misma instantánea.
cuerda

Restricciones:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
hostingEnvironment App Service Environment. cuerda
ignoreQuotas <código>true</code> si se deben omitir las cuotas; De lo contrario, <código>false</code>. Bool
sobrescribir <código>true</code> para sobrescribir la aplicación de destino; De lo contrario, <código>false</code>. Bool
sourceWebAppId Identificador de recurso de ARM de la aplicación de origen. El identificador de recurso de la aplicación tiene el formato
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName} para ranuras de producción y
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/slots/{slotName} para otras ranuras.
string (obligatorio)
trafficManagerProfileId Identificador de recurso de ARM del perfil de Traffic Manager que se va a usar, si existe. El identificador de recurso de Traffic Manager tiene el formato
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{profileName}.
cuerda
trafficManagerProfileName Nombre del perfil de Traffic Manager que se va a crear. Esto solo es necesario si el perfil de Traffic Manager aún no existe. cuerda

CloneInfoAppSettingsOverrides

Nombre Descripción Valor

ConnStringInfo

Nombre Descripción Valor
connectionString Valor de cadena de conexión. cuerda
nombre Nombre de la cadena de conexión. cuerda
tipo Tipo de base de datos. 'ApiHub'
'Personalizado'
'DocDb'
'EventHub'
'MySql'
'NotificationHub'
'PostgreSQL'
"RedisCache"
'ServiceBus'
"SQLAzure"
'SQLServer'

CorsSettings

Nombre Descripción Valor
allowedOrigins Obtiene o establece la lista de orígenes que se deben permitir para crear orígenes cruzados.
llamadas (por ejemplo: http://example.com:12345). Use "*" para permitir todo.
string[]

Experimentos

Nombre Descripción Valor
rampUpRules Lista de reglas de rampa. rampUpRule[]

HandlerMapping

Nombre Descripción Valor
Argumentos Argumentos de línea de comandos que se van a pasar al procesador de scripts. cuerda
extensión Las solicitudes con esta extensión se controlarán mediante la aplicación FastCGI especificada. cuerda
scriptProcessor Ruta de acceso absoluta a la aplicación FastCGI. cuerda

HostingEnvironmentProfile

Nombre Descripción Valor
identificación Identificador de recurso de App Service Environment. cuerda

HostNameSslState

Nombre Descripción Valor
hostType Indica si el nombre de host es un nombre de host estándar o de repositorio. 'Repositorio'
'Estándar'
nombre Nombre de host. cuerda
sslState Tipo SSL. 'Deshabilitado'
'IpBasedEnabled'
'SniEnabled'
Huella digital Huella digital del certificado SSL. cuerda
toUpdate Establezca en <código>true</code> para actualizar el nombre de host existente. Bool
virtualIP Dirección IP virtual asignada al nombre de host si está habilitado SSL basado en IP. cuerda

IpSecurityRestriction

Nombre Descripción Valor
ipAddress Dirección IP para la que es válida la restricción de seguridad. string (obligatorio)
subnetMask Máscara de subred para el intervalo de direcciones IP para la que es válida la restricción. cuerda

ManagedServiceIdentity

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada. 'SystemAssigned'

Microsoft.Web/sites/slots

Nombre Descripción Valor
identidad Identidad de servicio administrada. managedServiceIdentity
amable Tipo de recurso. cuerda
ubicación Ubicación del recurso. string (obligatorio)
nombre El nombre del recurso string (obligatorio)
padre En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para obtener más información, consulte recurso secundario fuera del recurso primario.
Nombre simbólico del recurso de tipo: sitios
Propiedades Propiedades específicas del recurso de sitio SiteProperties de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

NameValuePair

Nombre Descripción Valor
nombre Nombre del par. cuerda
valor Valor del par. cuerda

PushSettings

Nombre Descripción Valor
amable Tipo de recurso. cuerda
Propiedades Propiedades específicas del recurso PushSettings PushSettingsProperties

PushSettingsProperties

Nombre Descripción Valor
dynamicTagsJson Obtiene o establece una cadena JSON que contiene una lista de etiquetas dinámicas que se evaluarán a partir de notificaciones de usuario en el punto de conexión de registro de inserción. cuerda
isPushEnabled Obtiene o establece una marca que indica si el punto de conexión push está habilitado. bool (obligatorio)
tagsRequiringAuth Obtiene o establece una cadena JSON que contiene una lista de etiquetas que requieren que se use la autenticación de usuario en el punto de conexión de registro de inserción.
Las etiquetas pueden constar de caracteres alfanuméricos y lo siguiente:
'_', '@', '#', '.', ':', '-'.
La validación debe realizarse en PushRequestHandler.
cuerda
tagWhitelistJson Obtiene o establece una cadena JSON que contiene una lista de etiquetas que se encuentran en la lista permitida para su uso por el punto de conexión de registro de inserción. cuerda

RampUpRule

Nombre Descripción Valor
actionHostName Nombre de host de una ranura a la que se redirigirá el tráfico si se decide. Por ejemplo, myapp-stage.azurewebsites.net. cuerda
changeDecisionCallbackUrl El algoritmo de decisión personalizado se puede proporcionar en la extensión de sitio TiPCallback que se puede especificar la dirección URL. Consulte La extensión del sitio TiPCallback para obtener scaffolding y contratos.
https://www.siteextensions.net/packages/TiPCallback/
cuerda
changeIntervalInMinutes Especifica el intervalo en minutos para volver a evaluar ReroutePercentage. Int
changeStep En el escenario de aumento automático, este es el paso para agregar o quitar del código de <>ReroutePercentage</code> hasta que llegue a
<código>MinReroutePercentage</code> o código <>MaxReroutePercentage</code>. Las métricas del sitio se comprueban cada N minutos especificados en <código>ChangeIntervalInMinutes</code>.
El algoritmo de decisión personalizado se puede proporcionar en la extensión de sitio TiPCallback que se puede especificar en <código>ChangeDecisionCallbackUrl</code>.
Int
maxReroutePercentage Especifica el límite superior por debajo del cual se mantendrá ReroutePercentage. Int
minReroutePercentage Especifica el límite inferior por encima del cual se mantendrá ReroutePercentage. Int
nombre Nombre de la regla de enrutamiento. El nombre recomendado sería apuntar a la ranura que recibirá el tráfico en el experimento. cuerda
reroutePercentage Porcentaje del tráfico que se redirigirá a <código>ActionHostName</code>. Int

RequestsBasedTrigger

Nombre Descripción Valor
contar Recuento de solicitudes. Int
timeInterval Intervalo de tiempo. cuerda

ResourceTags

Nombre Descripción Valor

SiteConfig

Nombre Descripción Valor
alwaysOn <código>true</code> si AlwaysOn está habilitado; De lo contrario, <código>false</code>. Bool
apiDefinition Información sobre la definición de API formal para la aplicación. ApiDefinitionInfo
appCommandLine Línea de comandos de la aplicación que se va a iniciar. cuerda
appSettings Configuración de la aplicación. NameValuePair[]
autoHealEnabled <código>true</code> si la recuperación automática está habilitada; De lo contrario, <código>false</code>. Bool
autoHealRules Reglas de recuperación automática. AutoHealRules
autoSwapSlotName Nombre de ranura de intercambio automático. cuerda
connectionStrings Cadenas de conexión. ConnStringInfo[]
cors Configuración de uso compartido de recursos entre orígenes (CORS). corsSettings
defaultDocuments Documentos predeterminados. string[]
detailedErrorLoggingEnabled <código>true</code> si está habilitado el registro de errores detallado; De lo contrario, <código>false</code>. Bool
documentRoot Raíz del documento. cuerda
Experimentos Esto es una solución alternativa para los tipos polimórficos. experimentos
handlerMappings Asignaciones de controladores. handlerMapping[]
http20Enabled Http20Enabled: configura un sitio web para permitir que los clientes se conecten a través de http2.0 Bool
httpLoggingEnabled <código>true</code> si está habilitado el registro HTTP; De lo contrario, <código>false</code>. Bool
ipSecurityRestrictions Restricciones de seguridad de IP. ipSecurityRestriction []
javaContainer Contenedor de Java. cuerda
javaContainerVersion Versión del contenedor de Java. cuerda
javaVersion Versión de Java. cuerda
Límites Límites del sitio. SiteLimits
linuxFxVersion Linux App Framework y versión cuerda
loadBalancing Equilibrio de carga del sitio. 'LeastRequests'
'LeastResponseTime'
'RequestHash'
'WeightedRoundRobin'
'WeightedTotalTraffic'
localMySqlEnabled <código>true</code> para habilitar MySQL local; De lo contrario, <código>false</code>. Bool
logsDirectorySizeLimit Límite de tamaño del directorio de registros HTTP. Int
managedPipelineMode Modo de canalización administrada. 'Clásico'
"Integrado"
minTlsVersion MinTlsVersion: configura la versión mínima de TLS necesaria para las solicitudes SSL. '1.0'
'1.1'
'1.2'
netFrameworkVersion Versión de .NET Framework. cuerda
nodeVersion Versión de Node.js. cuerda
numberOfWorkers Número de trabajadores. Int
phpVersion Versión de PHP. cuerda
publishingUsername Publicar el nombre de usuario. cuerda
empujar Configuración del punto de conexión de inserción. pushSettings
pythonVersion Versión de Python. cuerda
remoteDebuggingEnabled <código>true</code> si la depuración remota está habilitada; De lo contrario, <código>false</code>. Bool
remoteDebuggingVersion Versión de depuración remota. cuerda
requestTracingEnabled <código>true</code> si está habilitado el seguimiento de solicitudes; De lo contrario, <código>false</code>. Bool
requestTracingExpirationTime Tiempo de expiración del seguimiento de solicitudes. cuerda
scmType Tipo SCM. 'BitbucketGit'
"BitbucketHg"
'CodePlexGit'
'CodePlexHg'
'Dropbox'
'ExternalGit'
'ExternalHg'
'GitHub'
'LocalGit'
'Ninguno'
"OneDrive"
'Tfs'
'VSO'
tracingOptions Opciones de seguimiento. cuerda
use32BitWorkerProcess <código>true</code> para usar el proceso de trabajo de 32 bits; De lo contrario, <código>false</code>. Bool
virtualApplications Aplicaciones virtuales. VirtualApplication []
vnetName Nombre de red virtual. cuerda
webSocketsEnabled <código>true</code> si WebSocket está habilitado; De lo contrario, <código>false</code>. Bool

SiteLimits

Nombre Descripción Valor
maxDiskSizeInMb Uso máximo permitido del tamaño del disco en MB. Int
maxMemoryInMb Uso máximo permitido de memoria en MB. Int
maxPercentageCpu Porcentaje máximo permitido de uso de CPU. Int

SiteProperties

Nombre Descripción Valor
clientAffinityEnabled <código>true</code> para habilitar la afinidad de cliente; <código>false</code> para dejar de enviar cookies de afinidad de sesión, que enrutan las solicitudes de cliente en la misma sesión a la misma instancia. El valor predeterminado es <código>true</code>. Bool
clientCertEnabled <código>verdadero</code> para habilitar la autenticación de certificados de cliente (autenticación mutua TLS); De lo contrario, <código>false</code>. El valor predeterminado es <código>false</code>. Bool
cloneInfo Si se especifica durante la creación de la aplicación, la aplicación se clona desde una aplicación de origen. CloneInfo de
containerSize Tamaño del contenedor de funciones. Int
dailyMemoryTimeQuota Cuota de tiempo de memoria diaria máxima permitida (aplicable solo en aplicaciones dinámicas). Int
Habilitado <código>true</code> si la aplicación está habilitada; De lo contrario, <código>false</code>. Al establecer este valor en false, se deshabilita la aplicación (se desconecta la aplicación). Bool
hostingEnvironmentProfile App Service Environment que se va a usar para la aplicación. hostingEnvironmentProfile
hostNamesDisabled <código>true</code> para deshabilitar los nombres de host públicos de la aplicación; De lo contrario, <código>false</code>.
Si <código>true</code>, la aplicación solo es accesible a través del proceso de API Management.
Bool
hostNameSslStates Los estados SSL de nombre de host se usan para administrar los enlaces SSL para los nombres de host de la aplicación. hostNameSslState[]
httpsOnly HttpsOnly: configura un sitio web para aceptar solo solicitudes https. Redireccionamiento de problemas para
solicitudes http
Bool
reservado <código>true</code> si está reservado; De lo contrario, <código>false</code>. Bool
scmSiteAlsoStopped <código>true</code> para detener el sitio de SCM (KUDU) cuando se detiene la aplicación; De lo contrario, <código>false</code>. El valor predeterminado es <código>false</code>. Bool
serverFarmId Identificador de recurso del plan de App Service asociado, con el formato "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}". cuerda
siteConfig Configuración de la aplicación. SiteConfig
snapshotInfo Si se especifica durante la creación de la aplicación, la aplicación se crea a partir de una instantánea anterior. SnapshotRecoveryRequest

SlowRequestsBasedTrigger

Nombre Descripción Valor
contar Recuento de solicitudes. Int
timeInterval Intervalo de tiempo. cuerda
timeTaken Tiempo necesario. cuerda

SnapshotRecoveryRequest

Nombre Descripción Valor
amable Tipo de recurso. cuerda
Propiedades Propiedades específicas del recurso SnapshotRecoveryRequest SnapshotRecoveryRequestProperties

SnapshotRecoveryRequestProperties

Nombre Descripción Valor
ignoreConflictingHostNames Si es true, se omitirán los conflictos de nombres de host personalizados al recuperarse en una aplicación web de destino.
Esta configuración solo es necesaria cuando Se habilita RecoverConfiguration.
Bool
sobrescribir Si <código>true</code> la operación de recuperación puede sobrescribir la aplicación de origen; De lo contrario, <código>false</code>. bool (obligatorio)
recoverConfiguration Si es true, se revertirá la configuración del sitio, además del contenido. Bool
recoveryTarget Especifica la aplicación web en la que se escribirá el contenido de la instantánea. snapshotRecoveryTarget
snapshotTime Un momento dado en el que se debe intentar la recuperación de la aplicación, con formato de cadena DateTime. cuerda

SnapshotRecoveryTarget

Nombre Descripción Valor
identificación Identificador de recurso de ARM de la aplicación de destino.
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName} para ranuras de producción y
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/slots/{slotName} para otras ranuras.
cuerda
ubicación Ubicación geográfica de la aplicación web de destino, por ejemplo, SouthEastAsia, SouthCentralUS cuerda

StatusCodesBasedTrigger

Nombre Descripción Valor
contar Recuento de solicitudes. Int
estado Código de estado HTTP. Int
subStatus Solicitar subestado. Int
timeInterval Intervalo de tiempo. cuerda
win32Status Código de error win32. Int

VirtualApplication

Nombre Descripción Valor
physicalPath Ruta de acceso física. cuerda
preloadEnabled <código>true</code> si la precarga está habilitada; De lo contrario, <código>false</code>. Bool
virtualDirectories Directorios virtuales para la aplicación virtual. virtualDirectory[]
virtualPath Ruta de acceso virtual. cuerda

VirtualDirectory

Nombre Descripción Valor
physicalPath Ruta de acceso física. cuerda
virtualPath Ruta de acceso a la aplicación virtual. cuerda

Ejemplos de inicio rápido

En los ejemplos de inicio rápido siguientes se implementa este tipo de recurso.

Archivo de Bicep Descripción
aplicación de funciones de Azure con una ranura de implementación Esta plantilla aprovisiona una aplicación de funciones en un plan Premium con ranura de producción y una ranura de implementación adicional.
aplicación web de varias regiones de alta disponibilidad Esta plantilla le permite crear una solución de un extremo a otro seguro, de alta disponibilidad y de varias regiones con dos aplicaciones web en regiones diferentes detrás de Azure Front Door.
función Provision Consumption plan with a Deployment Slot Esta plantilla aprovisiona una aplicación de funciones en un plan de consumo, que es un plan de hospedaje dinámico. La aplicación se ejecuta a petición y se le factura por ejecución, sin compromiso de recursos permanentes. Hay otras plantillas disponibles para el aprovisionamiento en un plan de hospedaje dedicado.
secure N-tier Web App Esta plantilla le permite crear una solución de un extremo a otro seguro con dos aplicaciones web con ranuras de ensayo, front-end y back-end, el front-end consumirá de forma segura el back a través de la inyección de red virtual y el punto de conexión privado.

Definición de recursos de plantilla de ARM

El tipo de recurso sites/slots se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Web/sites/slots, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Web/sites/slots",
  "apiVersion": "2016-08-01",
  "name": "string",
  "identity": {
    "type": "string"
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "clientAffinityEnabled": "bool",
    "clientCertEnabled": "bool",
    "cloningInfo": {
      "appSettingsOverrides": {
        "{customized property}": "string"
      },
      "cloneCustomHostNames": "bool",
      "cloneSourceControl": "bool",
      "configureLoadBalancing": "bool",
      "correlationId": "string",
      "hostingEnvironment": "string",
      "ignoreQuotas": "bool",
      "overwrite": "bool",
      "sourceWebAppId": "string",
      "trafficManagerProfileId": "string",
      "trafficManagerProfileName": "string"
    },
    "containerSize": "int",
    "dailyMemoryTimeQuota": "int",
    "enabled": "bool",
    "hostingEnvironmentProfile": {
      "id": "string"
    },
    "hostNamesDisabled": "bool",
    "hostNameSslStates": [
      {
        "hostType": "string",
        "name": "string",
        "sslState": "string",
        "thumbprint": "string",
        "toUpdate": "bool",
        "virtualIP": "string"
      }
    ],
    "httpsOnly": "bool",
    "reserved": "bool",
    "scmSiteAlsoStopped": "bool",
    "serverFarmId": "string",
    "siteConfig": {
      "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"
        }
      ],
      "http20Enabled": "bool",
      "httpLoggingEnabled": "bool",
      "ipSecurityRestrictions": [
        {
          "ipAddress": "string",
          "subnetMask": "string"
        }
      ],
      "javaContainer": "string",
      "javaContainerVersion": "string",
      "javaVersion": "string",
      "limits": {
        "maxDiskSizeInMb": "int",
        "maxMemoryInMb": "int",
        "maxPercentageCpu": "int"
      },
      "linuxFxVersion": "string",
      "loadBalancing": "string",
      "localMySqlEnabled": "bool",
      "logsDirectorySizeLimit": "int",
      "managedPipelineMode": "string",
      "minTlsVersion": "string",
      "netFrameworkVersion": "string",
      "nodeVersion": "string",
      "numberOfWorkers": "int",
      "phpVersion": "string",
      "publishingUsername": "string",
      "push": {
        "kind": "string",
        "properties": {
          "dynamicTagsJson": "string",
          "isPushEnabled": "bool",
          "tagsRequiringAuth": "string",
          "tagWhitelistJson": "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"
    },
    "snapshotInfo": {
      "kind": "string",
      "properties": {
        "ignoreConflictingHostNames": "bool",
        "overwrite": "bool",
        "recoverConfiguration": "bool",
        "recoveryTarget": {
          "id": "string",
          "location": "string"
        },
        "snapshotTime": "string"
      }
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propiedad

ApiDefinitionInfo

Nombre Descripción Valor
URL Dirección URL de la definición de API. cuerda

AutoHealActions

Nombre Descripción Valor
actionType Acción predefinida que se va a realizar. 'CustomAction'
'LogEvent'
'Reciclaje'
customAction Acción personalizada que se va a realizar. AutoHealCustomAction
minProcessExecutionTime Tiempo mínimo que el proceso debe ejecutar
antes de realizar la acción
cuerda

AutoHealCustomAction

Nombre Descripción Valor
exe Ejecutable que se va a ejecutar. cuerda
Parámetros Parámetros para el archivo ejecutable. cuerda

AutoHealRules

Nombre Descripción Valor
Acciones Acciones que se ejecutarán cuando se desencadene una regla. AutoHealActions
desencadenantes Condiciones que describen cuándo ejecutar las acciones de recuperación automática. AutoHealTriggers

AutoHealTriggers

Nombre Descripción Valor
privateBytesInKB Una regla basada en bytes privados. Int
Solicitudes Una regla basada en el total de solicitudes. RequestsBasedTrigger
slowRequests Una regla basada en el tiempo de ejecución de la solicitud. SlowRequestsBasedTrigger
statusCodes Regla basada en códigos de estado. StatusCodesBasedTrigger []

CloneInfo

Nombre Descripción Valor
appSettingsOverrides La configuración de la aplicación invalida la aplicación clonada. Si se especifica, esta configuración invalida la configuración clonada.
desde la aplicación de origen. De lo contrario, se conserva la configuración de la aplicación de origen.
CloneInfoAppSettingsOverrides
cloneCustomHostNames <código>true</code> para clonar nombres de host personalizados de la aplicación de origen; De lo contrario, <código>false</code>. Bool
cloneSourceControl <código>true</code> para clonar el control de código fuente de la aplicación de origen; De lo contrario, <código>false</code>. Bool
configureLoadBalancing <código>true</code> para configurar el equilibrio de carga para la aplicación de origen y destino. Bool
correlationId Id. de correlación de la operación de clonación. Este identificador vincula varias operaciones de clonación.
juntos para usar la misma instantánea.
cuerda

Restricciones:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
hostingEnvironment App Service Environment. cuerda
ignoreQuotas <código>true</code> si se deben omitir las cuotas; De lo contrario, <código>false</code>. Bool
sobrescribir <código>true</code> para sobrescribir la aplicación de destino; De lo contrario, <código>false</code>. Bool
sourceWebAppId Identificador de recurso de ARM de la aplicación de origen. El identificador de recurso de la aplicación tiene el formato
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName} para ranuras de producción y
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/slots/{slotName} para otras ranuras.
string (obligatorio)
trafficManagerProfileId Identificador de recurso de ARM del perfil de Traffic Manager que se va a usar, si existe. El identificador de recurso de Traffic Manager tiene el formato
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{profileName}.
cuerda
trafficManagerProfileName Nombre del perfil de Traffic Manager que se va a crear. Esto solo es necesario si el perfil de Traffic Manager aún no existe. cuerda

CloneInfoAppSettingsOverrides

Nombre Descripción Valor

ConnStringInfo

Nombre Descripción Valor
connectionString Valor de cadena de conexión. cuerda
nombre Nombre de la cadena de conexión. cuerda
tipo Tipo de base de datos. 'ApiHub'
'Personalizado'
'DocDb'
'EventHub'
'MySql'
'NotificationHub'
'PostgreSQL'
"RedisCache"
'ServiceBus'
"SQLAzure"
'SQLServer'

CorsSettings

Nombre Descripción Valor
allowedOrigins Obtiene o establece la lista de orígenes que se deben permitir para crear orígenes cruzados.
llamadas (por ejemplo: http://example.com:12345). Use "*" para permitir todo.
string[]

Experimentos

Nombre Descripción Valor
rampUpRules Lista de reglas de rampa. rampUpRule[]

HandlerMapping

Nombre Descripción Valor
Argumentos Argumentos de línea de comandos que se van a pasar al procesador de scripts. cuerda
extensión Las solicitudes con esta extensión se controlarán mediante la aplicación FastCGI especificada. cuerda
scriptProcessor Ruta de acceso absoluta a la aplicación FastCGI. cuerda

HostingEnvironmentProfile

Nombre Descripción Valor
identificación Identificador de recurso de App Service Environment. cuerda

HostNameSslState

Nombre Descripción Valor
hostType Indica si el nombre de host es un nombre de host estándar o de repositorio. 'Repositorio'
'Estándar'
nombre Nombre de host. cuerda
sslState Tipo SSL. 'Deshabilitado'
'IpBasedEnabled'
'SniEnabled'
Huella digital Huella digital del certificado SSL. cuerda
toUpdate Establezca en <código>true</code> para actualizar el nombre de host existente. Bool
virtualIP Dirección IP virtual asignada al nombre de host si está habilitado SSL basado en IP. cuerda

IpSecurityRestriction

Nombre Descripción Valor
ipAddress Dirección IP para la que es válida la restricción de seguridad. string (obligatorio)
subnetMask Máscara de subred para el intervalo de direcciones IP para la que es válida la restricción. cuerda

ManagedServiceIdentity

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada. 'SystemAssigned'

Microsoft.Web/sites/slots

Nombre Descripción Valor
apiVersion La versión de api '2016-08-01'
identidad Identidad de servicio administrada. managedServiceIdentity
amable Tipo de recurso. cuerda
ubicación Ubicación del recurso. string (obligatorio)
nombre El nombre del recurso string (obligatorio)
Propiedades Propiedades específicas del recurso de sitio SiteProperties de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo El tipo de recurso "Microsoft.Web/sites/slots"

NameValuePair

Nombre Descripción Valor
nombre Nombre del par. cuerda
valor Valor del par. cuerda

PushSettings

Nombre Descripción Valor
amable Tipo de recurso. cuerda
Propiedades Propiedades específicas del recurso PushSettings PushSettingsProperties

PushSettingsProperties

Nombre Descripción Valor
dynamicTagsJson Obtiene o establece una cadena JSON que contiene una lista de etiquetas dinámicas que se evaluarán a partir de notificaciones de usuario en el punto de conexión de registro de inserción. cuerda
isPushEnabled Obtiene o establece una marca que indica si el punto de conexión push está habilitado. bool (obligatorio)
tagsRequiringAuth Obtiene o establece una cadena JSON que contiene una lista de etiquetas que requieren que se use la autenticación de usuario en el punto de conexión de registro de inserción.
Las etiquetas pueden constar de caracteres alfanuméricos y lo siguiente:
'_', '@', '#', '.', ':', '-'.
La validación debe realizarse en PushRequestHandler.
cuerda
tagWhitelistJson Obtiene o establece una cadena JSON que contiene una lista de etiquetas que se encuentran en la lista permitida para su uso por el punto de conexión de registro de inserción. cuerda

RampUpRule

Nombre Descripción Valor
actionHostName Nombre de host de una ranura a la que se redirigirá el tráfico si se decide. Por ejemplo, myapp-stage.azurewebsites.net. cuerda
changeDecisionCallbackUrl El algoritmo de decisión personalizado se puede proporcionar en la extensión de sitio TiPCallback que se puede especificar la dirección URL. Consulte La extensión del sitio TiPCallback para obtener scaffolding y contratos.
https://www.siteextensions.net/packages/TiPCallback/
cuerda
changeIntervalInMinutes Especifica el intervalo en minutos para volver a evaluar ReroutePercentage. Int
changeStep En el escenario de aumento automático, este es el paso para agregar o quitar del código de <>ReroutePercentage</code> hasta que llegue a
<código>MinReroutePercentage</code> o código <>MaxReroutePercentage</code>. Las métricas del sitio se comprueban cada N minutos especificados en <código>ChangeIntervalInMinutes</code>.
El algoritmo de decisión personalizado se puede proporcionar en la extensión de sitio TiPCallback que se puede especificar en <código>ChangeDecisionCallbackUrl</code>.
Int
maxReroutePercentage Especifica el límite superior por debajo del cual se mantendrá ReroutePercentage. Int
minReroutePercentage Especifica el límite inferior por encima del cual se mantendrá ReroutePercentage. Int
nombre Nombre de la regla de enrutamiento. El nombre recomendado sería apuntar a la ranura que recibirá el tráfico en el experimento. cuerda
reroutePercentage Porcentaje del tráfico que se redirigirá a <código>ActionHostName</code>. Int

RequestsBasedTrigger

Nombre Descripción Valor
contar Recuento de solicitudes. Int
timeInterval Intervalo de tiempo. cuerda

ResourceTags

Nombre Descripción Valor

SiteConfig

Nombre Descripción Valor
alwaysOn <código>true</code> si AlwaysOn está habilitado; De lo contrario, <código>false</code>. Bool
apiDefinition Información sobre la definición de API formal para la aplicación. ApiDefinitionInfo
appCommandLine Línea de comandos de la aplicación que se va a iniciar. cuerda
appSettings Configuración de la aplicación. NameValuePair[]
autoHealEnabled <código>true</code> si la recuperación automática está habilitada; De lo contrario, <código>false</code>. Bool
autoHealRules Reglas de recuperación automática. AutoHealRules
autoSwapSlotName Nombre de ranura de intercambio automático. cuerda
connectionStrings Cadenas de conexión. ConnStringInfo[]
cors Configuración de uso compartido de recursos entre orígenes (CORS). corsSettings
defaultDocuments Documentos predeterminados. string[]
detailedErrorLoggingEnabled <código>true</code> si está habilitado el registro de errores detallado; De lo contrario, <código>false</code>. Bool
documentRoot Raíz del documento. cuerda
Experimentos Esto es una solución alternativa para los tipos polimórficos. experimentos
handlerMappings Asignaciones de controladores. handlerMapping[]
http20Enabled Http20Enabled: configura un sitio web para permitir que los clientes se conecten a través de http2.0 Bool
httpLoggingEnabled <código>true</code> si está habilitado el registro HTTP; De lo contrario, <código>false</code>. Bool
ipSecurityRestrictions Restricciones de seguridad de IP. ipSecurityRestriction []
javaContainer Contenedor de Java. cuerda
javaContainerVersion Versión del contenedor de Java. cuerda
javaVersion Versión de Java. cuerda
Límites Límites del sitio. SiteLimits
linuxFxVersion Linux App Framework y versión cuerda
loadBalancing Equilibrio de carga del sitio. 'LeastRequests'
'LeastResponseTime'
'RequestHash'
'WeightedRoundRobin'
'WeightedTotalTraffic'
localMySqlEnabled <código>true</code> para habilitar MySQL local; De lo contrario, <código>false</code>. Bool
logsDirectorySizeLimit Límite de tamaño del directorio de registros HTTP. Int
managedPipelineMode Modo de canalización administrada. 'Clásico'
"Integrado"
minTlsVersion MinTlsVersion: configura la versión mínima de TLS necesaria para las solicitudes SSL. '1.0'
'1.1'
'1.2'
netFrameworkVersion Versión de .NET Framework. cuerda
nodeVersion Versión de Node.js. cuerda
numberOfWorkers Número de trabajadores. Int
phpVersion Versión de PHP. cuerda
publishingUsername Publicar el nombre de usuario. cuerda
empujar Configuración del punto de conexión de inserción. pushSettings
pythonVersion Versión de Python. cuerda
remoteDebuggingEnabled <código>true</code> si la depuración remota está habilitada; De lo contrario, <código>false</code>. Bool
remoteDebuggingVersion Versión de depuración remota. cuerda
requestTracingEnabled <código>true</code> si está habilitado el seguimiento de solicitudes; De lo contrario, <código>false</code>. Bool
requestTracingExpirationTime Tiempo de expiración del seguimiento de solicitudes. cuerda
scmType Tipo SCM. 'BitbucketGit'
"BitbucketHg"
'CodePlexGit'
'CodePlexHg'
'Dropbox'
'ExternalGit'
'ExternalHg'
'GitHub'
'LocalGit'
'Ninguno'
"OneDrive"
'Tfs'
'VSO'
tracingOptions Opciones de seguimiento. cuerda
use32BitWorkerProcess <código>true</code> para usar el proceso de trabajo de 32 bits; De lo contrario, <código>false</code>. Bool
virtualApplications Aplicaciones virtuales. VirtualApplication []
vnetName Nombre de red virtual. cuerda
webSocketsEnabled <código>true</code> si WebSocket está habilitado; De lo contrario, <código>false</code>. Bool

SiteLimits

Nombre Descripción Valor
maxDiskSizeInMb Uso máximo permitido del tamaño del disco en MB. Int
maxMemoryInMb Uso máximo permitido de memoria en MB. Int
maxPercentageCpu Porcentaje máximo permitido de uso de CPU. Int

SiteProperties

Nombre Descripción Valor
clientAffinityEnabled <código>true</code> para habilitar la afinidad de cliente; <código>false</code> para dejar de enviar cookies de afinidad de sesión, que enrutan las solicitudes de cliente en la misma sesión a la misma instancia. El valor predeterminado es <código>true</code>. Bool
clientCertEnabled <código>verdadero</code> para habilitar la autenticación de certificados de cliente (autenticación mutua TLS); De lo contrario, <código>false</code>. El valor predeterminado es <código>false</code>. Bool
cloneInfo Si se especifica durante la creación de la aplicación, la aplicación se clona desde una aplicación de origen. CloneInfo de
containerSize Tamaño del contenedor de funciones. Int
dailyMemoryTimeQuota Cuota de tiempo de memoria diaria máxima permitida (aplicable solo en aplicaciones dinámicas). Int
Habilitado <código>true</code> si la aplicación está habilitada; De lo contrario, <código>false</code>. Al establecer este valor en false, se deshabilita la aplicación (se desconecta la aplicación). Bool
hostingEnvironmentProfile App Service Environment que se va a usar para la aplicación. hostingEnvironmentProfile
hostNamesDisabled <código>true</code> para deshabilitar los nombres de host públicos de la aplicación; De lo contrario, <código>false</code>.
Si <código>true</code>, la aplicación solo es accesible a través del proceso de API Management.
Bool
hostNameSslStates Los estados SSL de nombre de host se usan para administrar los enlaces SSL para los nombres de host de la aplicación. hostNameSslState[]
httpsOnly HttpsOnly: configura un sitio web para aceptar solo solicitudes https. Redireccionamiento de problemas para
solicitudes http
Bool
reservado <código>true</code> si está reservado; De lo contrario, <código>false</code>. Bool
scmSiteAlsoStopped <código>true</code> para detener el sitio de SCM (KUDU) cuando se detiene la aplicación; De lo contrario, <código>false</code>. El valor predeterminado es <código>false</code>. Bool
serverFarmId Identificador de recurso del plan de App Service asociado, con el formato "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}". cuerda
siteConfig Configuración de la aplicación. SiteConfig
snapshotInfo Si se especifica durante la creación de la aplicación, la aplicación se crea a partir de una instantánea anterior. SnapshotRecoveryRequest

SlowRequestsBasedTrigger

Nombre Descripción Valor
contar Recuento de solicitudes. Int
timeInterval Intervalo de tiempo. cuerda
timeTaken Tiempo necesario. cuerda

SnapshotRecoveryRequest

Nombre Descripción Valor
amable Tipo de recurso. cuerda
Propiedades Propiedades específicas del recurso SnapshotRecoveryRequest SnapshotRecoveryRequestProperties

SnapshotRecoveryRequestProperties

Nombre Descripción Valor
ignoreConflictingHostNames Si es true, se omitirán los conflictos de nombres de host personalizados al recuperarse en una aplicación web de destino.
Esta configuración solo es necesaria cuando Se habilita RecoverConfiguration.
Bool
sobrescribir Si <código>true</code> la operación de recuperación puede sobrescribir la aplicación de origen; De lo contrario, <código>false</code>. bool (obligatorio)
recoverConfiguration Si es true, se revertirá la configuración del sitio, además del contenido. Bool
recoveryTarget Especifica la aplicación web en la que se escribirá el contenido de la instantánea. snapshotRecoveryTarget
snapshotTime Un momento dado en el que se debe intentar la recuperación de la aplicación, con formato de cadena DateTime. cuerda

SnapshotRecoveryTarget

Nombre Descripción Valor
identificación Identificador de recurso de ARM de la aplicación de destino.
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName} para ranuras de producción y
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/slots/{slotName} para otras ranuras.
cuerda
ubicación Ubicación geográfica de la aplicación web de destino, por ejemplo, SouthEastAsia, SouthCentralUS cuerda

StatusCodesBasedTrigger

Nombre Descripción Valor
contar Recuento de solicitudes. Int
estado Código de estado HTTP. Int
subStatus Solicitar subestado. Int
timeInterval Intervalo de tiempo. cuerda
win32Status Código de error win32. Int

VirtualApplication

Nombre Descripción Valor
physicalPath Ruta de acceso física. cuerda
preloadEnabled <código>true</code> si la precarga está habilitada; De lo contrario, <código>false</code>. Bool
virtualDirectories Directorios virtuales para la aplicación virtual. virtualDirectory[]
virtualPath Ruta de acceso virtual. cuerda

VirtualDirectory

Nombre Descripción Valor
physicalPath Ruta de acceso física. cuerda
virtualPath Ruta de acceso a la aplicación virtual. cuerda

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
aplicación de funciones de Azure con una ranura de implementación

Implementación en Azure
Esta plantilla aprovisiona una aplicación de funciones en un plan Premium con ranura de producción y una ranura de implementación adicional.
aplicación web de varias regiones de alta disponibilidad

Implementación en Azure
Esta plantilla le permite crear una solución de un extremo a otro seguro, de alta disponibilidad y de varias regiones con dos aplicaciones web en regiones diferentes detrás de Azure Front Door.
función Provision Consumption plan with a Deployment Slot

Implementación en Azure
Esta plantilla aprovisiona una aplicación de funciones en un plan de consumo, que es un plan de hospedaje dinámico. La aplicación se ejecuta a petición y se le factura por ejecución, sin compromiso de recursos permanentes. Hay otras plantillas disponibles para el aprovisionamiento en un plan de hospedaje dedicado.
secure N-tier Web App

Implementación en Azure
Esta plantilla le permite crear una solución de un extremo a otro seguro con dos aplicaciones web con ranuras de ensayo, front-end y back-end, el front-end consumirá de forma segura el back a través de la inyección de red virtual y el punto de conexión privado.
Aplicación web con ranuras de implementación personalizadas

Implementación en Azure
Esta plantilla proporciona una manera sencilla de implementar una aplicación web con ranuras de implementación personalizadas en Azure Web Apps.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso sites/slots se puede implementar con operaciones que tienen como destino:

  • grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Web/sites/slots, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Web/sites/slots@2016-08-01"
  name = "string"
  identity = {
    type = "string"
  }
  kind = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      clientAffinityEnabled = bool
      clientCertEnabled = bool
      cloningInfo = {
        appSettingsOverrides = {
          {customized property} = "string"
        }
        cloneCustomHostNames = bool
        cloneSourceControl = bool
        configureLoadBalancing = bool
        correlationId = "string"
        hostingEnvironment = "string"
        ignoreQuotas = bool
        overwrite = bool
        sourceWebAppId = "string"
        trafficManagerProfileId = "string"
        trafficManagerProfileName = "string"
      }
      containerSize = int
      dailyMemoryTimeQuota = int
      enabled = bool
      hostingEnvironmentProfile = {
        id = "string"
      }
      hostNamesDisabled = bool
      hostNameSslStates = [
        {
          hostType = "string"
          name = "string"
          sslState = "string"
          thumbprint = "string"
          toUpdate = bool
          virtualIP = "string"
        }
      ]
      httpsOnly = bool
      reserved = bool
      scmSiteAlsoStopped = bool
      serverFarmId = "string"
      siteConfig = {
        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"
          }
        ]
        http20Enabled = bool
        httpLoggingEnabled = bool
        ipSecurityRestrictions = [
          {
            ipAddress = "string"
            subnetMask = "string"
          }
        ]
        javaContainer = "string"
        javaContainerVersion = "string"
        javaVersion = "string"
        limits = {
          maxDiskSizeInMb = int
          maxMemoryInMb = int
          maxPercentageCpu = int
        }
        linuxFxVersion = "string"
        loadBalancing = "string"
        localMySqlEnabled = bool
        logsDirectorySizeLimit = int
        managedPipelineMode = "string"
        minTlsVersion = "string"
        netFrameworkVersion = "string"
        nodeVersion = "string"
        numberOfWorkers = int
        phpVersion = "string"
        publishingUsername = "string"
        push = {
          kind = "string"
          properties = {
            dynamicTagsJson = "string"
            isPushEnabled = bool
            tagsRequiringAuth = "string"
            tagWhitelistJson = "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
      }
      snapshotInfo = {
        kind = "string"
        properties = {
          ignoreConflictingHostNames = bool
          overwrite = bool
          recoverConfiguration = bool
          recoveryTarget = {
            id = "string"
            location = "string"
          }
          snapshotTime = "string"
        }
      }
    }
  })
}

Valores de propiedad

ApiDefinitionInfo

Nombre Descripción Valor
URL Dirección URL de la definición de API. cuerda

AutoHealActions

Nombre Descripción Valor
actionType Acción predefinida que se va a realizar. 'CustomAction'
'LogEvent'
'Reciclaje'
customAction Acción personalizada que se va a realizar. AutoHealCustomAction
minProcessExecutionTime Tiempo mínimo que el proceso debe ejecutar
antes de realizar la acción
cuerda

AutoHealCustomAction

Nombre Descripción Valor
exe Ejecutable que se va a ejecutar. cuerda
Parámetros Parámetros para el archivo ejecutable. cuerda

AutoHealRules

Nombre Descripción Valor
Acciones Acciones que se ejecutarán cuando se desencadene una regla. AutoHealActions
desencadenantes Condiciones que describen cuándo ejecutar las acciones de recuperación automática. AutoHealTriggers

AutoHealTriggers

Nombre Descripción Valor
privateBytesInKB Una regla basada en bytes privados. Int
Solicitudes Una regla basada en el total de solicitudes. RequestsBasedTrigger
slowRequests Una regla basada en el tiempo de ejecución de la solicitud. SlowRequestsBasedTrigger
statusCodes Regla basada en códigos de estado. StatusCodesBasedTrigger []

CloneInfo

Nombre Descripción Valor
appSettingsOverrides La configuración de la aplicación invalida la aplicación clonada. Si se especifica, esta configuración invalida la configuración clonada.
desde la aplicación de origen. De lo contrario, se conserva la configuración de la aplicación de origen.
CloneInfoAppSettingsOverrides
cloneCustomHostNames <código>true</code> para clonar nombres de host personalizados de la aplicación de origen; De lo contrario, <código>false</code>. Bool
cloneSourceControl <código>true</code> para clonar el control de código fuente de la aplicación de origen; De lo contrario, <código>false</code>. Bool
configureLoadBalancing <código>true</code> para configurar el equilibrio de carga para la aplicación de origen y destino. Bool
correlationId Id. de correlación de la operación de clonación. Este identificador vincula varias operaciones de clonación.
juntos para usar la misma instantánea.
cuerda

Restricciones:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
hostingEnvironment App Service Environment. cuerda
ignoreQuotas <código>true</code> si se deben omitir las cuotas; De lo contrario, <código>false</code>. Bool
sobrescribir <código>true</code> para sobrescribir la aplicación de destino; De lo contrario, <código>false</code>. Bool
sourceWebAppId Identificador de recurso de ARM de la aplicación de origen. El identificador de recurso de la aplicación tiene el formato
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName} para ranuras de producción y
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/slots/{slotName} para otras ranuras.
string (obligatorio)
trafficManagerProfileId Identificador de recurso de ARM del perfil de Traffic Manager que se va a usar, si existe. El identificador de recurso de Traffic Manager tiene el formato
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{profileName}.
cuerda
trafficManagerProfileName Nombre del perfil de Traffic Manager que se va a crear. Esto solo es necesario si el perfil de Traffic Manager aún no existe. cuerda

CloneInfoAppSettingsOverrides

Nombre Descripción Valor

ConnStringInfo

Nombre Descripción Valor
connectionString Valor de cadena de conexión. cuerda
nombre Nombre de la cadena de conexión. cuerda
tipo Tipo de base de datos. 'ApiHub'
'Personalizado'
'DocDb'
'EventHub'
'MySql'
'NotificationHub'
'PostgreSQL'
"RedisCache"
'ServiceBus'
"SQLAzure"
'SQLServer'

CorsSettings

Nombre Descripción Valor
allowedOrigins Obtiene o establece la lista de orígenes que se deben permitir para crear orígenes cruzados.
llamadas (por ejemplo: http://example.com:12345). Use "*" para permitir todo.
string[]

Experimentos

Nombre Descripción Valor
rampUpRules Lista de reglas de rampa. rampUpRule[]

HandlerMapping

Nombre Descripción Valor
Argumentos Argumentos de línea de comandos que se van a pasar al procesador de scripts. cuerda
extensión Las solicitudes con esta extensión se controlarán mediante la aplicación FastCGI especificada. cuerda
scriptProcessor Ruta de acceso absoluta a la aplicación FastCGI. cuerda

HostingEnvironmentProfile

Nombre Descripción Valor
identificación Identificador de recurso de App Service Environment. cuerda

HostNameSslState

Nombre Descripción Valor
hostType Indica si el nombre de host es un nombre de host estándar o de repositorio. 'Repositorio'
'Estándar'
nombre Nombre de host. cuerda
sslState Tipo SSL. 'Deshabilitado'
'IpBasedEnabled'
'SniEnabled'
Huella digital Huella digital del certificado SSL. cuerda
toUpdate Establezca en <código>true</code> para actualizar el nombre de host existente. Bool
virtualIP Dirección IP virtual asignada al nombre de host si está habilitado SSL basado en IP. cuerda

IpSecurityRestriction

Nombre Descripción Valor
ipAddress Dirección IP para la que es válida la restricción de seguridad. string (obligatorio)
subnetMask Máscara de subred para el intervalo de direcciones IP para la que es válida la restricción. cuerda

ManagedServiceIdentity

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada. 'SystemAssigned'

Microsoft.Web/sites/slots

Nombre Descripción Valor
identidad Identidad de servicio administrada. managedServiceIdentity
amable Tipo de recurso. cuerda
ubicación Ubicación del recurso. string (obligatorio)
nombre El nombre del recurso string (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: sitios
Propiedades Propiedades específicas del recurso de sitio SiteProperties de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
tipo El tipo de recurso "Microsoft.Web/sites/slots@2016-08-01"

NameValuePair

Nombre Descripción Valor
nombre Nombre del par. cuerda
valor Valor del par. cuerda

PushSettings

Nombre Descripción Valor
amable Tipo de recurso. cuerda
Propiedades Propiedades específicas del recurso PushSettings PushSettingsProperties

PushSettingsProperties

Nombre Descripción Valor
dynamicTagsJson Obtiene o establece una cadena JSON que contiene una lista de etiquetas dinámicas que se evaluarán a partir de notificaciones de usuario en el punto de conexión de registro de inserción. cuerda
isPushEnabled Obtiene o establece una marca que indica si el punto de conexión push está habilitado. bool (obligatorio)
tagsRequiringAuth Obtiene o establece una cadena JSON que contiene una lista de etiquetas que requieren que se use la autenticación de usuario en el punto de conexión de registro de inserción.
Las etiquetas pueden constar de caracteres alfanuméricos y lo siguiente:
'_', '@', '#', '.', ':', '-'.
La validación debe realizarse en PushRequestHandler.
cuerda
tagWhitelistJson Obtiene o establece una cadena JSON que contiene una lista de etiquetas que se encuentran en la lista permitida para su uso por el punto de conexión de registro de inserción. cuerda

RampUpRule

Nombre Descripción Valor
actionHostName Nombre de host de una ranura a la que se redirigirá el tráfico si se decide. Por ejemplo, myapp-stage.azurewebsites.net. cuerda
changeDecisionCallbackUrl El algoritmo de decisión personalizado se puede proporcionar en la extensión de sitio TiPCallback que se puede especificar la dirección URL. Consulte La extensión del sitio TiPCallback para obtener scaffolding y contratos.
https://www.siteextensions.net/packages/TiPCallback/
cuerda
changeIntervalInMinutes Especifica el intervalo en minutos para volver a evaluar ReroutePercentage. Int
changeStep En el escenario de aumento automático, este es el paso para agregar o quitar del código de <>ReroutePercentage</code> hasta que llegue a
<código>MinReroutePercentage</code> o código <>MaxReroutePercentage</code>. Las métricas del sitio se comprueban cada N minutos especificados en <código>ChangeIntervalInMinutes</code>.
El algoritmo de decisión personalizado se puede proporcionar en la extensión de sitio TiPCallback que se puede especificar en <código>ChangeDecisionCallbackUrl</code>.
Int
maxReroutePercentage Especifica el límite superior por debajo del cual se mantendrá ReroutePercentage. Int
minReroutePercentage Especifica el límite inferior por encima del cual se mantendrá ReroutePercentage. Int
nombre Nombre de la regla de enrutamiento. El nombre recomendado sería apuntar a la ranura que recibirá el tráfico en el experimento. cuerda
reroutePercentage Porcentaje del tráfico que se redirigirá a <código>ActionHostName</code>. Int

RequestsBasedTrigger

Nombre Descripción Valor
contar Recuento de solicitudes. Int
timeInterval Intervalo de tiempo. cuerda

ResourceTags

Nombre Descripción Valor

SiteConfig

Nombre Descripción Valor
alwaysOn <código>true</code> si AlwaysOn está habilitado; De lo contrario, <código>false</code>. Bool
apiDefinition Información sobre la definición de API formal para la aplicación. ApiDefinitionInfo
appCommandLine Línea de comandos de la aplicación que se va a iniciar. cuerda
appSettings Configuración de la aplicación. NameValuePair[]
autoHealEnabled <código>true</code> si la recuperación automática está habilitada; De lo contrario, <código>false</code>. Bool
autoHealRules Reglas de recuperación automática. AutoHealRules
autoSwapSlotName Nombre de ranura de intercambio automático. cuerda
connectionStrings Cadenas de conexión. ConnStringInfo[]
cors Configuración de uso compartido de recursos entre orígenes (CORS). corsSettings
defaultDocuments Documentos predeterminados. string[]
detailedErrorLoggingEnabled <código>true</code> si está habilitado el registro de errores detallado; De lo contrario, <código>false</code>. Bool
documentRoot Raíz del documento. cuerda
Experimentos Esto es una solución alternativa para los tipos polimórficos. experimentos
handlerMappings Asignaciones de controladores. handlerMapping[]
http20Enabled Http20Enabled: configura un sitio web para permitir que los clientes se conecten a través de http2.0 Bool
httpLoggingEnabled <código>true</code> si está habilitado el registro HTTP; De lo contrario, <código>false</code>. Bool
ipSecurityRestrictions Restricciones de seguridad de IP. ipSecurityRestriction []
javaContainer Contenedor de Java. cuerda
javaContainerVersion Versión del contenedor de Java. cuerda
javaVersion Versión de Java. cuerda
Límites Límites del sitio. SiteLimits
linuxFxVersion Linux App Framework y versión cuerda
loadBalancing Equilibrio de carga del sitio. 'LeastRequests'
'LeastResponseTime'
'RequestHash'
'WeightedRoundRobin'
'WeightedTotalTraffic'
localMySqlEnabled <código>true</code> para habilitar MySQL local; De lo contrario, <código>false</code>. Bool
logsDirectorySizeLimit Límite de tamaño del directorio de registros HTTP. Int
managedPipelineMode Modo de canalización administrada. 'Clásico'
"Integrado"
minTlsVersion MinTlsVersion: configura la versión mínima de TLS necesaria para las solicitudes SSL. '1.0'
'1.1'
'1.2'
netFrameworkVersion Versión de .NET Framework. cuerda
nodeVersion Versión de Node.js. cuerda
numberOfWorkers Número de trabajadores. Int
phpVersion Versión de PHP. cuerda
publishingUsername Publicar el nombre de usuario. cuerda
empujar Configuración del punto de conexión de inserción. pushSettings
pythonVersion Versión de Python. cuerda
remoteDebuggingEnabled <código>true</code> si la depuración remota está habilitada; De lo contrario, <código>false</code>. Bool
remoteDebuggingVersion Versión de depuración remota. cuerda
requestTracingEnabled <código>true</code> si está habilitado el seguimiento de solicitudes; De lo contrario, <código>false</code>. Bool
requestTracingExpirationTime Tiempo de expiración del seguimiento de solicitudes. cuerda
scmType Tipo SCM. 'BitbucketGit'
"BitbucketHg"
'CodePlexGit'
'CodePlexHg'
'Dropbox'
'ExternalGit'
'ExternalHg'
'GitHub'
'LocalGit'
'Ninguno'
"OneDrive"
'Tfs'
'VSO'
tracingOptions Opciones de seguimiento. cuerda
use32BitWorkerProcess <código>true</code> para usar el proceso de trabajo de 32 bits; De lo contrario, <código>false</code>. Bool
virtualApplications Aplicaciones virtuales. VirtualApplication []
vnetName Nombre de red virtual. cuerda
webSocketsEnabled <código>true</code> si WebSocket está habilitado; De lo contrario, <código>false</code>. Bool

SiteLimits

Nombre Descripción Valor
maxDiskSizeInMb Uso máximo permitido del tamaño del disco en MB. Int
maxMemoryInMb Uso máximo permitido de memoria en MB. Int
maxPercentageCpu Porcentaje máximo permitido de uso de CPU. Int

SiteProperties

Nombre Descripción Valor
clientAffinityEnabled <código>true</code> para habilitar la afinidad de cliente; <código>false</code> para dejar de enviar cookies de afinidad de sesión, que enrutan las solicitudes de cliente en la misma sesión a la misma instancia. El valor predeterminado es <código>true</code>. Bool
clientCertEnabled <código>verdadero</code> para habilitar la autenticación de certificados de cliente (autenticación mutua TLS); De lo contrario, <código>false</code>. El valor predeterminado es <código>false</code>. Bool
cloneInfo Si se especifica durante la creación de la aplicación, la aplicación se clona desde una aplicación de origen. CloneInfo de
containerSize Tamaño del contenedor de funciones. Int
dailyMemoryTimeQuota Cuota de tiempo de memoria diaria máxima permitida (aplicable solo en aplicaciones dinámicas). Int
Habilitado <código>true</code> si la aplicación está habilitada; De lo contrario, <código>false</code>. Al establecer este valor en false, se deshabilita la aplicación (se desconecta la aplicación). Bool
hostingEnvironmentProfile App Service Environment que se va a usar para la aplicación. hostingEnvironmentProfile
hostNamesDisabled <código>true</code> para deshabilitar los nombres de host públicos de la aplicación; De lo contrario, <código>false</code>.
Si <código>true</code>, la aplicación solo es accesible a través del proceso de API Management.
Bool
hostNameSslStates Los estados SSL de nombre de host se usan para administrar los enlaces SSL para los nombres de host de la aplicación. hostNameSslState[]
httpsOnly HttpsOnly: configura un sitio web para aceptar solo solicitudes https. Redireccionamiento de problemas para
solicitudes http
Bool
reservado <código>true</code> si está reservado; De lo contrario, <código>false</code>. Bool
scmSiteAlsoStopped <código>true</code> para detener el sitio de SCM (KUDU) cuando se detiene la aplicación; De lo contrario, <código>false</code>. El valor predeterminado es <código>false</code>. Bool
serverFarmId Identificador de recurso del plan de App Service asociado, con el formato "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}". cuerda
siteConfig Configuración de la aplicación. SiteConfig
snapshotInfo Si se especifica durante la creación de la aplicación, la aplicación se crea a partir de una instantánea anterior. SnapshotRecoveryRequest

SlowRequestsBasedTrigger

Nombre Descripción Valor
contar Recuento de solicitudes. Int
timeInterval Intervalo de tiempo. cuerda
timeTaken Tiempo necesario. cuerda

SnapshotRecoveryRequest

Nombre Descripción Valor
amable Tipo de recurso. cuerda
Propiedades Propiedades específicas del recurso SnapshotRecoveryRequest SnapshotRecoveryRequestProperties

SnapshotRecoveryRequestProperties

Nombre Descripción Valor
ignoreConflictingHostNames Si es true, se omitirán los conflictos de nombres de host personalizados al recuperarse en una aplicación web de destino.
Esta configuración solo es necesaria cuando Se habilita RecoverConfiguration.
Bool
sobrescribir Si <código>true</code> la operación de recuperación puede sobrescribir la aplicación de origen; De lo contrario, <código>false</code>. bool (obligatorio)
recoverConfiguration Si es true, se revertirá la configuración del sitio, además del contenido. Bool
recoveryTarget Especifica la aplicación web en la que se escribirá el contenido de la instantánea. snapshotRecoveryTarget
snapshotTime Un momento dado en el que se debe intentar la recuperación de la aplicación, con formato de cadena DateTime. cuerda

SnapshotRecoveryTarget

Nombre Descripción Valor
identificación Identificador de recurso de ARM de la aplicación de destino.
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName} para ranuras de producción y
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/slots/{slotName} para otras ranuras.
cuerda
ubicación Ubicación geográfica de la aplicación web de destino, por ejemplo, SouthEastAsia, SouthCentralUS cuerda

StatusCodesBasedTrigger

Nombre Descripción Valor
contar Recuento de solicitudes. Int
estado Código de estado HTTP. Int
subStatus Solicitar subestado. Int
timeInterval Intervalo de tiempo. cuerda
win32Status Código de error win32. Int

VirtualApplication

Nombre Descripción Valor
physicalPath Ruta de acceso física. cuerda
preloadEnabled <código>true</code> si la precarga está habilitada; De lo contrario, <código>false</code>. Bool
virtualDirectories Directorios virtuales para la aplicación virtual. virtualDirectory[]
virtualPath Ruta de acceso virtual. cuerda

VirtualDirectory

Nombre Descripción Valor
physicalPath Ruta de acceso física. cuerda
virtualPath Ruta de acceso a la aplicación virtual. cuerda