Web Apps - Create Or Update

Servicio:

App Service

Versión de la API:

2024-11-01

Descripción para Crea una nueva aplicación web, móvil o api en un grupo de recursos existente o actualiza una aplicación existente.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}?api-version=2024-11-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
name	path	True	string	Nombre único de la aplicación para crear o actualizar. Para crear o actualizar una ranura de implementación, use el parámetro {slot}.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._\(\)]+[^\.]$	Nombre del grupo de recursos al que pertenece el recurso.
subscriptionId	path	True	string	Su identificador de suscripción de Azure. Se trata de una cadena con formato GUID (por ejemplo, 000000000-00000-0000-0000-00000000000000).
api-version	query	True	string	Versión de la API

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
location	True	string	Ubicación del recurso.
extendedLocation		ExtendedLocation	Ubicación extendida.
identity		ManagedServiceIdentity	Identidad de servicio administrada.
kind		string	Tipo de recurso. Si el recurso es una aplicación, puede consultar https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference para obtener más información sobre los valores admitidos para el tipo.
properties.autoGeneratedDomainNameLabelScope		autoGeneratedDomainNameLabelScope	Especifica el ámbito de unicidad del nombre de host predeterminado durante la creación de recursos.
properties.clientAffinityEnabled		boolean	true para habilitar la afinidad de cliente; false 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 true.
properties.clientAffinityPartitioningEnabled		boolean	true para habilitar la partición de afinidad del cliente mediante cookies CHIPS, esto agregará la partitioned propiedad a las cookies de afinidad; false para dejar de enviar cookies de afinidad particionadas. El valor predeterminado es false.
properties.clientAffinityProxyEnabled		boolean	true para anular el dominio de cookie de afinidad del cliente con el encabezado de solicitud X-Forwarded-Host. false para usar el dominio predeterminado. El valor predeterminado es false.
properties.clientCertEnabled		boolean	true para habilitar la autenticación de certificados de cliente (autenticación mutua tls); de lo contrario, false. El valor predeterminado es false.
properties.clientCertExclusionPaths		string	rutas de exclusión separadas por comas de autenticación de certificados de cliente
properties.clientCertMode		ClientCertMode	Esto se compone con la configuración ClientCertEnabled. ClientCertEnabled: false significa que Se omite ClientCert. ClientCertEnabled: true y ClientCertMode: Obligatorio significa que se requiere ClientCert. ClientCertEnabled: true y ClientCertMode: opcional significa que ClientCert es opcional o se acepta.
properties.cloningInfo		CloningInfo	Si se especifica durante la creación de la aplicación, la aplicación se clona desde una aplicación de origen.
properties.containerSize		integer (int32)	Tamaño del contenedor de funciones.
properties.customDomainVerificationId		string	Identificador único que comprueba los dominios personalizados asignados a la aplicación. El cliente agregará este identificador a un registro txt para su comprobación.
properties.dailyMemoryTimeQuota		integer (int32)	Cuota de tiempo de memoria diaria máxima permitida (aplicable solo en aplicaciones dinámicas).
properties.daprConfig		DaprConfig	Configuración de Dapr de la aplicación.
properties.dnsConfiguration		SiteDnsConfig	Propiedad para configurar varias opciones relacionadas con DNS para un sitio.
properties.enabled		boolean	true si la aplicación está habilitada; de lo contrario, false. Al establecer este valor en false, se deshabilita la aplicación (se desconecta la aplicación).
properties.endToEndEncryptionEnabled		boolean	Si se va a usar el cifrado de un extremo a otro entre front-end y el trabajo
properties.functionAppConfig		FunctionAppConfig	Configuración específica de la aplicación de funciones de Azure.
properties.hostNameSslStates		HostNameSslState[]	Los estados SSL de nombre de host se usan para administrar los enlaces SSL para los nombres de host de la aplicación.
properties.hostNamesDisabled		boolean	true deshabilitar los nombres de host públicos de la aplicación; de lo contrario, false. Si true, la aplicación solo es accesible a través del proceso de API Management.
properties.hostingEnvironmentProfile		HostingEnvironmentProfile	App Service Environment que se va a usar para la aplicación.
properties.httpsOnly		boolean	HttpsOnly: configura un sitio web para aceptar solo solicitudes https. Problemas de redirección de solicitudes HTTP
properties.hyperV		boolean	Hyper-V espacio aislado.
properties.ipMode		IPMode	Especifica el modo IP de la aplicación.
properties.isXenon		boolean	Obsoleto: Hyper-V espacio aislado.
properties.keyVaultReferenceIdentity		string	Identidad que se va a usar para la autenticación de referencia de Key Vault.
properties.managedEnvironmentId		string	Identificador de Azure Resource Manager del entorno administrado seleccionado del cliente en el que hospedar esta aplicación. Debe tener el formato /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.App/managedEnvironments/{managedEnvironmentName}
properties.outboundVnetRouting		OutboundVnetRouting	Propiedad para configurar varias opciones de enrutamiento de tráfico saliente a través de la red virtual para un sitio
properties.publicNetworkAccess		string	Propiedad para permitir o bloquear todo el tráfico público. Valores permitidos: 'Enabled', 'Disabled' o una cadena vacía.
properties.redundancyMode		RedundancyMode	Modo de redundancia del sitio
properties.reserved		boolean	true si están reservados; de lo contrario, false.
properties.resourceConfig		ResourceConfig	Requisitos de recursos de la aplicación de funciones.
properties.scmSiteAlsoStopped		boolean	true para detener el sitio de SCM (KUDU) cuando se detiene la aplicación; de lo contrario, false. El valor predeterminado es false.
properties.serverFarmId		string	Identificador de recurso del plan de App Service asociado, con el formato "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}".
properties.siteConfig		SiteConfig	Configuración de una aplicación de App Service. Esta propiedad no se devuelve en respuesta a las solicitudes normales de creación y lectura, ya que puede contener información confidencial.
properties.sshEnabled		boolean	Si se habilita el acceso ssh.
properties.storageAccountRequired		boolean	Comprueba si se requiere la cuenta de almacenamiento proporcionada por el cliente.
properties.virtualNetworkSubnetId		string	Identificador de Azure Resource Manager de la red virtual y la subred que se van a unir mediante la integración con red virtual regional. Debe tener el formato /subscriptions/{subscriptionName}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}
properties.workloadProfileName		string	Nombre del perfil de carga de trabajo para que se ejecute la aplicación de funciones.
tags		object	Etiquetas de recursos.

Respuestas

Nombre	Tipo	Description
200 OK	Site	De acuerdo.
202 Accepted	Site	Operación asincrónica en curso.
Other Status Codes	DefaultErrorResponse	Respuesta de error de App Service.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

Clone web app

Create or Update Flex Consumption function app

Create or Update Flex Consumption function app with details

Create or Update web app

Clone web app

Solicitud de ejemplo

HTTP

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141?api-version=2024-11-01

{
  "kind": "app",
  "location": "East US",
  "properties": {
    "cloningInfo": {
      "cloneCustomHostNames": true,
      "cloneSourceControl": true,
      "sourceWebAppId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg456/providers/Microsoft.Web/sites/srcsiteg478",
      "sourceWebAppLocation": "West Europe",
      "hostingEnvironment": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg456/providers/Microsoft.Web/hostingenvironments/aseforsites",
      "appSettingsOverrides": {
        "Setting1": "NewValue1",
        "Setting3": "NewValue5"
      },
      "configureLoadBalancing": false,
      "overwrite": false
    }
  }
}

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.AppService.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.AppService;

// Generated from example definition: specification/web/resource-manager/Microsoft.Web/stable/2024-11-01/examples/CloneWebApp.json
// this example is just showing the usage of "WebApps_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345";
string resourceGroupName = "testrg123";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this WebSiteResource
WebSiteCollection collection = resourceGroupResource.GetWebSites();

// invoke the operation
string name = "sitef6141";
WebSiteData data = new WebSiteData(new AzureLocation("East US"))
{
    CloningInfo = new CloningInfo(new ResourceIdentifier("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg456/providers/Microsoft.Web/sites/srcsiteg478"))
    {
        CanOverwrite = false,
        CloneCustomHostNames = true,
        CloneSourceControl = true,
        SourceWebAppLocation = new AzureLocation("West Europe"),
        HostingEnvironment = "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg456/providers/Microsoft.Web/hostingenvironments/aseforsites",
        AppSettingsOverrides =
        {
        ["Setting1"] = "NewValue1",
        ["Setting3"] = "NewValue5"
        },
        ConfigureLoadBalancing = false,
    },
    Kind = "app",
};
ArmOperation<WebSiteResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, name, data);
WebSiteResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
WebSiteData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:

200

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141",
  "name": "sitef6141",
  "type": "Microsoft.Web/sites",
  "kind": "app",
  "location": "East US",
  "properties": {
    "state": "Running",
    "hostNames": [
      "sitef6141.azurewebsites.net"
    ],
    "repositorySiteName": "sitef6141",
    "usageState": "Normal",
    "enabled": true,
    "enabledHostNames": [
      "sitef6141.azurewebsites.net",
      "sitef6141.scm.azurewebsites.net"
    ],
    "availabilityState": "Normal",
    "hostNameSslStates": [
      {
        "name": "sitef6141.azurewebsites.net",
        "sslState": "Disabled",
        "hostType": "Standard"
      },
      {
        "name": "sitef6141.scm.azurewebsites.net",
        "sslState": "Disabled",
        "hostType": "Repository"
      }
    ],
    "serverFarmId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/DefaultAsp",
    "reserved": false,
    "isXenon": false,
    "hyperV": false,
    "lastModifiedTimeUtc": "2020-03-04T17:33:11.641Z",
    "outboundVnetRouting": {
      "allTraffic": false,
      "applicationTraffic": false,
      "contentShareTraffic": false,
      "imagePullTraffic": false,
      "backupRestoreTraffic": false
    },
    "siteConfig": {
      "numberOfWorkers": 1,
      "defaultDocuments": [
        "Default.htm",
        "Default.html",
        "Default.asp",
        "index.htm",
        "index.html",
        "iisstart.htm",
        "default.aspx",
        "index.php",
        "hostingstart.html"
      ],
      "netFrameworkVersion": "v4.0",
      "phpVersion": "5.6",
      "pythonVersion": "",
      "nodeVersion": "",
      "powerShellVersion": "",
      "linuxFxVersion": "",
      "requestTracingEnabled": false,
      "remoteDebuggingEnabled": false,
      "httpLoggingEnabled": false,
      "acrUseManagedIdentityCreds": false,
      "logsDirectorySizeLimit": 35,
      "detailedErrorLoggingEnabled": false,
      "use32BitWorkerProcess": true,
      "webSocketsEnabled": false,
      "alwaysOn": false,
      "appCommandLine": "",
      "managedPipelineMode": "Integrated",
      "virtualApplications": [
        {
          "virtualPath": "/",
          "physicalPath": "site\\wwwroot",
          "preloadEnabled": false
        }
      ],
      "loadBalancing": "LeastRequests",
      "autoHealEnabled": false,
      "vnetName": "",
      "vnetRouteAllEnabled": false,
      "vnetPrivatePortsCount": 0,
      "http20Enabled": false,
      "minTlsVersion": "1.2",
      "scmMinTlsVersion": "1.2",
      "ftpsState": "AllAllowed",
      "functionAppScaleLimit": 0,
      "functionsRuntimeScaleMonitoringEnabled": false,
      "minimumElasticInstanceCount": 0,
      "azureStorageAccounts": {}
    },
    "scmSiteAlsoStopped": false,
    "clientAffinityEnabled": true,
    "clientCertEnabled": false,
    "clientCertMode": "Required",
    "hostNamesDisabled": false,
    "customDomainVerificationId": "7F3BB652450EF7AD0B6AA33064586E4A9CE823A46DF0B2EC6443A68086E84153",
    "outboundIpAddresses": "70.37.102.201,20.225.43.144",
    "possibleOutboundIpAddresses": "70.37.102.201,20.225.43.144,20.225.184.122,20.225.184.188",
    "containerSize": 0,
    "dailyMemoryTimeQuota": 0,
    "resourceGroup": "testrg123",
    "defaultHostName": "sitef6141.azurewebsites.net",
    "httpsOnly": false,
    "redundancyMode": "None",
    "storageAccountRequired": false,
    "keyVaultReferenceIdentity": "SystemAssigned"
  }
}

status code:

202

azure-asyncoperation: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.Web/sites/sitef6141/operationResults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2024-11-01

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141",
  "name": "sitef6141",
  "type": "Microsoft.Web/sites",
  "kind": "app",
  "location": "East US",
  "properties": {
    "state": "Running",
    "hostNames": [
      "sitef6141.azurewebsites.net"
    ],
    "repositorySiteName": "sitef6141",
    "usageState": "Normal",
    "enabled": true,
    "enabledHostNames": [
      "sitef6141.azurewebsites.net",
      "sitef6141.scm.azurewebsites.net"
    ],
    "availabilityState": "Normal",
    "hostNameSslStates": [
      {
        "name": "sitef6141.azurewebsites.net",
        "sslState": "Disabled",
        "hostType": "Standard"
      },
      {
        "name": "sitef6141.scm.azurewebsites.net",
        "sslState": "Disabled",
        "hostType": "Repository"
      }
    ],
    "serverFarmId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/DefaultAsp",
    "reserved": false,
    "isXenon": false,
    "hyperV": false,
    "lastModifiedTimeUtc": "2020-03-04T17:33:11.641Z",
    "outboundVnetRouting": {
      "allTraffic": false,
      "applicationTraffic": false,
      "contentShareTraffic": false,
      "imagePullTraffic": false,
      "backupRestoreTraffic": false
    },
    "siteConfig": {
      "numberOfWorkers": 1,
      "defaultDocuments": [
        "Default.htm",
        "Default.html",
        "Default.asp",
        "index.htm",
        "index.html",
        "iisstart.htm",
        "default.aspx",
        "index.php",
        "hostingstart.html"
      ],
      "netFrameworkVersion": "v4.0",
      "phpVersion": "5.6",
      "pythonVersion": "",
      "nodeVersion": "",
      "powerShellVersion": "",
      "linuxFxVersion": "",
      "requestTracingEnabled": false,
      "remoteDebuggingEnabled": false,
      "httpLoggingEnabled": false,
      "acrUseManagedIdentityCreds": false,
      "logsDirectorySizeLimit": 35,
      "detailedErrorLoggingEnabled": false,
      "use32BitWorkerProcess": true,
      "webSocketsEnabled": false,
      "alwaysOn": false,
      "appCommandLine": "",
      "managedPipelineMode": "Integrated",
      "virtualApplications": [
        {
          "virtualPath": "/",
          "physicalPath": "site\\wwwroot",
          "preloadEnabled": false
        }
      ],
      "loadBalancing": "LeastRequests",
      "autoHealEnabled": false,
      "vnetName": "",
      "vnetRouteAllEnabled": false,
      "vnetPrivatePortsCount": 0,
      "http20Enabled": false,
      "minTlsVersion": "1.2",
      "scmMinTlsVersion": "1.2",
      "ftpsState": "AllAllowed",
      "functionAppScaleLimit": 0,
      "functionsRuntimeScaleMonitoringEnabled": false,
      "minimumElasticInstanceCount": 0,
      "azureStorageAccounts": {}
    },
    "scmSiteAlsoStopped": false,
    "clientAffinityEnabled": true,
    "clientCertEnabled": false,
    "clientCertMode": "Required",
    "hostNamesDisabled": false,
    "customDomainVerificationId": "7F3BB652450EF7AD0B6AA33064586E4A9CE823A46DF0B2EC6443A68086E84153",
    "outboundIpAddresses": "70.37.102.201,20.225.43.144",
    "possibleOutboundIpAddresses": "70.37.102.201,20.225.43.144,20.225.184.122,20.225.184.188",
    "containerSize": 0,
    "dailyMemoryTimeQuota": 0,
    "resourceGroup": "testrg123",
    "defaultHostName": "sitef6141.azurewebsites.net",
    "httpsOnly": false,
    "redundancyMode": "None",
    "storageAccountRequired": false,
    "keyVaultReferenceIdentity": "SystemAssigned"
  }
}

Create or Update Flex Consumption function app

Solicitud de ejemplo

HTTP

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141?api-version=2024-11-01

{
  "location": "East US",
  "kind": "functionapp,linux",
  "properties": {
    "siteConfig": {
      "appSettings": [
        {
          "name": "AzureWebJobsStorage",
          "value": "DefaultEndpointsProtocol=https;AccountName=StorageAccountName;AccountKey=Sanitized;EndpointSuffix=core.windows.net"
        },
        {
          "name": "APPLICATIONINSIGHTS_CONNECTION_STRING",
          "value": "InstrumentationKey=Sanitized;IngestionEndpoint=Sanitized;LiveEndpoint=Sanitized"
        }
      ]
    },
    "functionAppConfig": {
      "deployment": {
        "storage": {
          "type": "blobContainer",
          "value": "https://storageAccountName.blob.core.windows.net/containername",
          "authentication": {
            "type": "StorageAccountConnectionString",
            "storageAccountConnectionStringName": "TheAppSettingName"
          }
        }
      },
      "runtime": {
        "name": "python",
        "version": "3.11"
      },
      "scaleAndConcurrency": {
        "maximumInstanceCount": 100,
        "instanceMemoryMB": 2048
      }
    }
  }
}

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.AppService.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.AppService;

// Generated from example definition: specification/web/resource-manager/Microsoft.Web/stable/2024-11-01/examples/CreateOrUpdateFunctionAppFlexConsumption.json
// this example is just showing the usage of "WebApps_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345";
string resourceGroupName = "testrg123";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this WebSiteResource
WebSiteCollection collection = resourceGroupResource.GetWebSites();

// invoke the operation
string name = "sitef6141";
WebSiteData data = new WebSiteData(new AzureLocation("East US"))
{
    SiteConfig = new SiteConfigProperties
    {
        AppSettings = {new AppServiceNameValuePair
        {
        Name = "AzureWebJobsStorage",
        Value = "DefaultEndpointsProtocol=https;AccountName=StorageAccountName;AccountKey=Sanitized;EndpointSuffix=core.windows.net",
        }, new AppServiceNameValuePair
        {
        Name = "APPLICATIONINSIGHTS_CONNECTION_STRING",
        Value = "InstrumentationKey=Sanitized;IngestionEndpoint=Sanitized;LiveEndpoint=Sanitized",
        }},
    },
    FunctionAppConfig = new FunctionAppConfig
    {
        DeploymentStorage = new FunctionAppStorage
        {
            StorageType = FunctionAppStorageType.BlobContainer,
            Value = new Uri("https://storageAccountName.blob.core.windows.net/containername"),
            Authentication = new FunctionAppStorageAuthentication
            {
                AuthenticationType = FunctionAppStorageAccountAuthenticationType.StorageAccountConnectionString,
                StorageAccountConnectionStringName = "TheAppSettingName",
            },
        },
        Runtime = new FunctionAppRuntime
        {
            Name = FunctionAppRuntimeName.Python,
            Version = "3.11",
        },
        ScaleAndConcurrency = new FunctionAppScaleAndConcurrency
        {
            FunctionAppMaximumInstanceCount = 100,
            FunctionAppInstanceMemoryMB = 2048,
        },
    },
    Kind = "functionapp,linux",
};
ArmOperation<WebSiteResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, name, data);
WebSiteResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
WebSiteData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:

200

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141",
  "name": "sitef6141",
  "type": "Microsoft.Web/sites",
  "location": "East US",
  "properties": {
    "state": "Running",
    "hostNames": [
      "sitef6141.azurewebsites.net"
    ],
    "repositorySiteName": "sitef6141",
    "usageState": "Normal",
    "enabled": true,
    "enabledHostNames": [
      "sitef6141.azurewebsites.net",
      "sitef6141.scm.azurewebsites.net"
    ],
    "availabilityState": "Normal",
    "hostNameSslStates": [
      {
        "name": "sitef6141.azurewebsites.net",
        "sslState": "Disabled",
        "hostType": "Standard"
      },
      {
        "name": "sitef6141.scm.azurewebsites.net",
        "sslState": "Disabled",
        "hostType": "Repository"
      }
    ],
    "serverFarmId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/DefaultAsp",
    "reserved": null,
    "isXenon": false,
    "hyperV": false,
    "lastModifiedTimeUtc": "2024-01-09T00:24:54.8",
    "outboundVnetRouting": {
      "allTraffic": false,
      "applicationTraffic": false,
      "contentShareTraffic": false,
      "imagePullTraffic": false,
      "backupRestoreTraffic": false
    },
    "siteConfig": {
      "numberOfWorkers": 1,
      "netFrameworkVersion": "",
      "phpVersion": "",
      "pythonVersion": "",
      "nodeVersion": "",
      "powerShellVersion": "",
      "linuxFxVersion": "",
      "requestTracingEnabled": false,
      "remoteDebuggingEnabled": false,
      "httpLoggingEnabled": false,
      "acrUseManagedIdentityCreds": false,
      "logsDirectorySizeLimit": 35,
      "detailedErrorLoggingEnabled": false,
      "use32BitWorkerProcess": false,
      "webSocketsEnabled": false,
      "alwaysOn": false,
      "appCommandLine": "",
      "managedPipelineMode": "Integrated",
      "virtualApplications": [
        {
          "virtualPath": "/",
          "physicalPath": "site\\wwwroot",
          "preloadEnabled": false
        }
      ],
      "loadBalancing": "LeastRequests",
      "autoHealEnabled": false,
      "vnetName": "",
      "vnetRouteAllEnabled": false,
      "vnetPrivatePortsCount": 0,
      "keyVaultReferenceIdentity": "",
      "ipSecurityRestrictions": [
        {
          "ipAddress": "Any",
          "action": "Allow",
          "priority": 2147483647,
          "name": "Allow all",
          "description": "Allow all access"
        }
      ],
      "scmIpSecurityRestrictions": [
        {
          "ipAddress": "Any",
          "action": "Allow",
          "priority": 2147483647,
          "name": "Allow all",
          "description": "Allow all access"
        }
      ],
      "http20Enabled": false,
      "minTlsVersion": "1.2",
      "scmMinTlsVersion": "1.2",
      "ftpsState": "AllAllowed",
      "functionAppScaleLimit": 0,
      "functionsRuntimeScaleMonitoringEnabled": false,
      "minimumElasticInstanceCount": 0,
      "azureStorageAccounts": {}
    },
    "functionAppConfig": {
      "deployment": {
        "storage": {
          "type": "blobContainer",
          "value": "https://storageAccountName.blob.core.windows.net/containername",
          "authentication": {
            "type": "StorageAccountConnectionString",
            "storageAccountConnectionStringName": "TheAppSettingName"
          }
        }
      },
      "runtime": {
        "name": "python",
        "version": "3.11"
      },
      "scaleAndConcurrency": {
        "alwaysReady": null,
        "maximumInstanceCount": 100,
        "instanceMemoryMB": 2048,
        "triggers": null
      }
    },
    "scmSiteAlsoStopped": false,
    "clientAffinityEnabled": false,
    "clientCertEnabled": false,
    "resourceConfig": {
      "cpu": 1,
      "memory": "2.0Gi"
    },
    "outboundIpAddresses": "70.37.102.201,20.225.43.144",
    "possibleOutboundIpAddresses": "70.37.102.201,20.225.43.144,20.225.184.122,20.225.184.188",
    "containerSize": 2048,
    "dailyMemoryTimeQuota": 0,
    "resourceGroup": "testrg123",
    "defaultHostName": "sitef6141.azurewebsites.net",
    "httpsOnly": true,
    "redundancyMode": "None",
    "publicNetworkAccess": "Enabled",
    "storageAccountRequired": false
  }
}

status code:

202

azure-asyncoperation: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.Web/sites/sitef6141/operationResults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2024-11-01

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141",
  "name": "sitef6141",
  "type": "Microsoft.Web/sites",
  "location": "East US",
  "properties": {
    "state": "Running",
    "hostNames": [
      "sitef6141.azurewebsites.net"
    ],
    "repositorySiteName": "sitef6141",
    "usageState": "Normal",
    "enabled": true,
    "enabledHostNames": [
      "sitef6141.azurewebsites.net",
      "sitef6141.scm.azurewebsites.net"
    ],
    "availabilityState": "Normal",
    "hostNameSslStates": [
      {
        "name": "sitef6141.azurewebsites.net",
        "sslState": "Disabled",
        "hostType": "Standard"
      },
      {
        "name": "sitef6141.scm.azurewebsites.net",
        "sslState": "Disabled",
        "hostType": "Repository"
      }
    ],
    "serverFarmId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/DefaultAsp",
    "reserved": null,
    "isXenon": false,
    "hyperV": false,
    "lastModifiedTimeUtc": "2024-01-09T00:24:54.8",
    "outboundVnetRouting": {
      "allTraffic": false,
      "applicationTraffic": false,
      "contentShareTraffic": false,
      "imagePullTraffic": false,
      "backupRestoreTraffic": false
    },
    "siteConfig": {
      "numberOfWorkers": 1,
      "netFrameworkVersion": "",
      "phpVersion": "",
      "pythonVersion": "",
      "nodeVersion": "",
      "powerShellVersion": "",
      "linuxFxVersion": "",
      "requestTracingEnabled": false,
      "remoteDebuggingEnabled": false,
      "httpLoggingEnabled": false,
      "acrUseManagedIdentityCreds": false,
      "logsDirectorySizeLimit": 35,
      "detailedErrorLoggingEnabled": false,
      "use32BitWorkerProcess": false,
      "webSocketsEnabled": false,
      "alwaysOn": false,
      "appCommandLine": "",
      "managedPipelineMode": "Integrated",
      "virtualApplications": [
        {
          "virtualPath": "/",
          "physicalPath": "site\\wwwroot",
          "preloadEnabled": false
        }
      ],
      "loadBalancing": "LeastRequests",
      "autoHealEnabled": false,
      "vnetName": "",
      "vnetRouteAllEnabled": false,
      "vnetPrivatePortsCount": 0,
      "keyVaultReferenceIdentity": "",
      "ipSecurityRestrictions": [
        {
          "ipAddress": "Any",
          "action": "Allow",
          "priority": 2147483647,
          "name": "Allow all",
          "description": "Allow all access"
        }
      ],
      "scmIpSecurityRestrictions": [
        {
          "ipAddress": "Any",
          "action": "Allow",
          "priority": 2147483647,
          "name": "Allow all",
          "description": "Allow all access"
        }
      ],
      "http20Enabled": false,
      "minTlsVersion": "1.2",
      "scmMinTlsVersion": "1.2",
      "ftpsState": "AllAllowed",
      "functionAppScaleLimit": 0,
      "functionsRuntimeScaleMonitoringEnabled": false,
      "minimumElasticInstanceCount": 0,
      "azureStorageAccounts": {}
    },
    "functionAppConfig": {
      "deployment": {
        "storage": {
          "type": "blobContainer",
          "value": "https://storageAccountName.blob.core.windows.net/containername",
          "authentication": {
            "type": "StorageAccountConnectionString",
            "storageAccountConnectionStringName": "TheAppSettingName"
          }
        }
      },
      "runtime": {
        "name": "python",
        "version": "3.11"
      },
      "scaleAndConcurrency": {
        "alwaysReady": null,
        "maximumInstanceCount": 100,
        "instanceMemoryMB": 2048,
        "triggers": null
      }
    },
    "scmSiteAlsoStopped": false,
    "clientAffinityEnabled": false,
    "clientCertEnabled": false,
    "resourceConfig": {
      "cpu": 1,
      "memory": "2.0Gi"
    },
    "outboundIpAddresses": "70.37.102.201,20.225.43.144",
    "possibleOutboundIpAddresses": "70.37.102.201,20.225.43.144,20.225.184.122,20.225.184.188",
    "containerSize": 2048,
    "dailyMemoryTimeQuota": 0,
    "resourceGroup": "testrg123",
    "defaultHostName": "sitef6141.azurewebsites.net",
    "httpsOnly": true,
    "redundancyMode": "None",
    "publicNetworkAccess": "Enabled",
    "storageAccountRequired": false
  }
}

Create or Update Flex Consumption function app with details

Solicitud de ejemplo

HTTP

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141?api-version=2024-11-01

{
  "location": "East US",
  "kind": "functionapp,linux",
  "properties": {
    "siteConfig": {
      "appSettings": [
        {
          "name": "AzureWebJobsStorage",
          "value": "DefaultEndpointsProtocol=https;AccountName=StorageAccountName;AccountKey=Sanitized;EndpointSuffix=core.windows.net"
        },
        {
          "name": "APPLICATIONINSIGHTS_CONNECTION_STRING",
          "value": "InstrumentationKey=Sanitized;IngestionEndpoint=Sanitized;LiveEndpoint=Sanitized"
        }
      ]
    },
    "functionAppConfig": {
      "deployment": {
        "storage": {
          "type": "blobContainer",
          "value": "https://storageAccountName.blob.core.windows.net/containername",
          "authentication": {
            "type": "StorageAccountConnectionString",
            "storageAccountConnectionStringName": "TheAppSettingName"
          }
        }
      },
      "runtime": {
        "name": "python",
        "version": "3.11"
      },
      "scaleAndConcurrency": {
        "alwaysReady": [
          {
            "name": "http",
            "instanceCount": 2
          }
        ],
        "maximumInstanceCount": 100,
        "instanceMemoryMB": 2048,
        "triggers": {
          "http": {
            "perInstanceConcurrency": 16
          }
        }
      }
    }
  }
}

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.AppService.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.AppService;

// Generated from example definition: specification/web/resource-manager/Microsoft.Web/stable/2024-11-01/examples/CreateOrUpdateFunctionAppFlexConsumptionWithDetails.json
// this example is just showing the usage of "WebApps_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345";
string resourceGroupName = "testrg123";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this WebSiteResource
WebSiteCollection collection = resourceGroupResource.GetWebSites();

// invoke the operation
string name = "sitef6141";
WebSiteData data = new WebSiteData(new AzureLocation("East US"))
{
    SiteConfig = new SiteConfigProperties
    {
        AppSettings = {new AppServiceNameValuePair
        {
        Name = "AzureWebJobsStorage",
        Value = "DefaultEndpointsProtocol=https;AccountName=StorageAccountName;AccountKey=Sanitized;EndpointSuffix=core.windows.net",
        }, new AppServiceNameValuePair
        {
        Name = "APPLICATIONINSIGHTS_CONNECTION_STRING",
        Value = "InstrumentationKey=Sanitized;IngestionEndpoint=Sanitized;LiveEndpoint=Sanitized",
        }},
    },
    FunctionAppConfig = new FunctionAppConfig
    {
        DeploymentStorage = new FunctionAppStorage
        {
            StorageType = FunctionAppStorageType.BlobContainer,
            Value = new Uri("https://storageAccountName.blob.core.windows.net/containername"),
            Authentication = new FunctionAppStorageAuthentication
            {
                AuthenticationType = FunctionAppStorageAccountAuthenticationType.StorageAccountConnectionString,
                StorageAccountConnectionStringName = "TheAppSettingName",
            },
        },
        Runtime = new FunctionAppRuntime
        {
            Name = FunctionAppRuntimeName.Python,
            Version = "3.11",
        },
        ScaleAndConcurrency = new FunctionAppScaleAndConcurrency
        {
            AlwaysReady = {new FunctionAppAlwaysReadyConfig
            {
            Name = "http",
            AlwaysReadyInstanceCount = 2,
            }},
            FunctionAppMaximumInstanceCount = 100,
            FunctionAppInstanceMemoryMB = 2048,
            ConcurrentHttpPerInstanceConcurrency = 16,
        },
    },
    Kind = "functionapp,linux",
};
ArmOperation<WebSiteResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, name, data);
WebSiteResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
WebSiteData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:

200

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141",
  "name": "sitef6141",
  "type": "Microsoft.Web/sites",
  "location": "East US",
  "properties": {
    "state": "Running",
    "hostNames": [
      "sitef6141.azurewebsites.net"
    ],
    "repositorySiteName": "sitef6141",
    "usageState": "Normal",
    "enabled": true,
    "enabledHostNames": [
      "sitef6141.azurewebsites.net",
      "sitef6141.scm.azurewebsites.net"
    ],
    "availabilityState": "Normal",
    "hostNameSslStates": [
      {
        "name": "sitef6141.azurewebsites.net",
        "sslState": "Disabled",
        "hostType": "Standard"
      },
      {
        "name": "sitef6141.scm.azurewebsites.net",
        "sslState": "Disabled",
        "hostType": "Repository"
      }
    ],
    "serverFarmId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/DefaultAsp",
    "reserved": null,
    "isXenon": false,
    "hyperV": false,
    "lastModifiedTimeUtc": "2024-01-09T00:24:54.8",
    "outboundVnetRouting": {
      "allTraffic": false,
      "applicationTraffic": false,
      "contentShareTraffic": false,
      "imagePullTraffic": false,
      "backupRestoreTraffic": false
    },
    "siteConfig": {
      "numberOfWorkers": 1,
      "netFrameworkVersion": "",
      "phpVersion": "",
      "pythonVersion": "",
      "nodeVersion": "",
      "powerShellVersion": "",
      "linuxFxVersion": "",
      "requestTracingEnabled": false,
      "remoteDebuggingEnabled": false,
      "httpLoggingEnabled": false,
      "acrUseManagedIdentityCreds": false,
      "logsDirectorySizeLimit": 35,
      "detailedErrorLoggingEnabled": false,
      "use32BitWorkerProcess": false,
      "webSocketsEnabled": false,
      "alwaysOn": false,
      "appCommandLine": "",
      "managedPipelineMode": "Integrated",
      "virtualApplications": [
        {
          "virtualPath": "/",
          "physicalPath": "site\\wwwroot",
          "preloadEnabled": false
        }
      ],
      "loadBalancing": "LeastRequests",
      "autoHealEnabled": false,
      "vnetName": "",
      "vnetRouteAllEnabled": false,
      "vnetPrivatePortsCount": 0,
      "keyVaultReferenceIdentity": "",
      "ipSecurityRestrictions": [
        {
          "ipAddress": "Any",
          "action": "Allow",
          "priority": 2147483647,
          "name": "Allow all",
          "description": "Allow all access"
        }
      ],
      "scmIpSecurityRestrictions": [
        {
          "ipAddress": "Any",
          "action": "Allow",
          "priority": 2147483647,
          "name": "Allow all",
          "description": "Allow all access"
        }
      ],
      "http20Enabled": false,
      "minTlsVersion": "1.2",
      "scmMinTlsVersion": "1.2",
      "ftpsState": "AllAllowed",
      "functionAppScaleLimit": 0,
      "functionsRuntimeScaleMonitoringEnabled": false,
      "minimumElasticInstanceCount": 0,
      "azureStorageAccounts": {}
    },
    "functionAppConfig": {
      "deployment": {
        "storage": {
          "type": "blobContainer",
          "value": "https://storageAccountName.blob.core.windows.net/containername",
          "authentication": {
            "type": "StorageAccountConnectionString",
            "storageAccountConnectionStringName": "TheAppSettingName"
          }
        }
      },
      "runtime": {
        "name": "python",
        "version": "3.11"
      },
      "scaleAndConcurrency": {
        "alwaysReady": [
          {
            "name": "http",
            "instanceCount": 2
          }
        ],
        "maximumInstanceCount": 100,
        "instanceMemoryMB": 2048,
        "triggers": {
          "http": {
            "perInstanceConcurrency": 16
          }
        }
      }
    },
    "scmSiteAlsoStopped": false,
    "clientAffinityEnabled": false,
    "clientCertEnabled": false,
    "resourceConfig": {
      "cpu": 1,
      "memory": "2.0Gi"
    },
    "outboundIpAddresses": "70.37.102.201,20.225.43.144",
    "possibleOutboundIpAddresses": "70.37.102.201,20.225.43.144,20.225.184.122,20.225.184.188",
    "containerSize": 2048,
    "dailyMemoryTimeQuota": 0,
    "resourceGroup": "testrg123",
    "defaultHostName": "sitef6141.azurewebsites.net",
    "httpsOnly": true,
    "redundancyMode": "None",
    "publicNetworkAccess": "Enabled",
    "storageAccountRequired": false
  }
}

status code:

202

azure-asyncoperation: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.Web/sites/sitef6141/operationResults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2024-11-01

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141",
  "name": "sitef6141",
  "type": "Microsoft.Web/sites",
  "location": "East US",
  "properties": {
    "state": "Running",
    "hostNames": [
      "sitef6141.azurewebsites.net"
    ],
    "repositorySiteName": "sitef6141",
    "usageState": "Normal",
    "enabled": true,
    "enabledHostNames": [
      "sitef6141.azurewebsites.net",
      "sitef6141.scm.azurewebsites.net"
    ],
    "availabilityState": "Normal",
    "hostNameSslStates": [
      {
        "name": "sitef6141.azurewebsites.net",
        "sslState": "Disabled",
        "hostType": "Standard"
      },
      {
        "name": "sitef6141.scm.azurewebsites.net",
        "sslState": "Disabled",
        "hostType": "Repository"
      }
    ],
    "serverFarmId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/DefaultAsp",
    "reserved": null,
    "isXenon": false,
    "hyperV": false,
    "lastModifiedTimeUtc": "2024-01-09T00:24:54.8",
    "outboundVnetRouting": {
      "allTraffic": false,
      "applicationTraffic": false,
      "contentShareTraffic": false,
      "imagePullTraffic": false,
      "backupRestoreTraffic": false
    },
    "siteConfig": {
      "numberOfWorkers": 1,
      "netFrameworkVersion": "",
      "phpVersion": "",
      "pythonVersion": "",
      "nodeVersion": "",
      "powerShellVersion": "",
      "linuxFxVersion": "",
      "requestTracingEnabled": false,
      "remoteDebuggingEnabled": false,
      "httpLoggingEnabled": false,
      "acrUseManagedIdentityCreds": false,
      "logsDirectorySizeLimit": 35,
      "detailedErrorLoggingEnabled": false,
      "use32BitWorkerProcess": false,
      "webSocketsEnabled": false,
      "alwaysOn": false,
      "appCommandLine": "",
      "managedPipelineMode": "Integrated",
      "virtualApplications": [
        {
          "virtualPath": "/",
          "physicalPath": "site\\wwwroot",
          "preloadEnabled": false
        }
      ],
      "loadBalancing": "LeastRequests",
      "autoHealEnabled": false,
      "vnetName": "",
      "vnetRouteAllEnabled": false,
      "vnetPrivatePortsCount": 0,
      "keyVaultReferenceIdentity": "",
      "ipSecurityRestrictions": [
        {
          "ipAddress": "Any",
          "action": "Allow",
          "priority": 2147483647,
          "name": "Allow all",
          "description": "Allow all access"
        }
      ],
      "scmIpSecurityRestrictions": [
        {
          "ipAddress": "Any",
          "action": "Allow",
          "priority": 2147483647,
          "name": "Allow all",
          "description": "Allow all access"
        }
      ],
      "http20Enabled": false,
      "minTlsVersion": "1.2",
      "scmMinTlsVersion": "1.2",
      "ftpsState": "AllAllowed",
      "functionAppScaleLimit": 0,
      "functionsRuntimeScaleMonitoringEnabled": false,
      "minimumElasticInstanceCount": 0,
      "azureStorageAccounts": {}
    },
    "functionAppConfig": {
      "deployment": {
        "storage": {
          "type": "blobContainer",
          "value": "https://storageAccountName.blob.core.windows.net/containername",
          "authentication": {
            "type": "StorageAccountConnectionString",
            "storageAccountConnectionStringName": "TheAppSettingName"
          }
        }
      },
      "runtime": {
        "name": "python",
        "version": "3.11"
      },
      "scaleAndConcurrency": {
        "alwaysReady": [
          {
            "name": "http",
            "instanceCount": 2
          }
        ],
        "maximumInstanceCount": 100,
        "instanceMemoryMB": 2048,
        "triggers": {
          "http": {
            "perInstanceConcurrency": 16
          }
        }
      }
    },
    "scmSiteAlsoStopped": false,
    "clientAffinityEnabled": false,
    "clientCertEnabled": false,
    "resourceConfig": {
      "cpu": 1,
      "memory": "2.0Gi"
    },
    "outboundIpAddresses": "70.37.102.201,20.225.43.144",
    "possibleOutboundIpAddresses": "70.37.102.201,20.225.43.144,20.225.184.122,20.225.184.188",
    "containerSize": 2048,
    "dailyMemoryTimeQuota": 0,
    "resourceGroup": "testrg123",
    "defaultHostName": "sitef6141.azurewebsites.net",
    "httpsOnly": true,
    "redundancyMode": "None",
    "publicNetworkAccess": "Enabled",
    "storageAccountRequired": false
  }
}

Create or Update web app

Solicitud de ejemplo

HTTP

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141?api-version=2024-11-01

{
  "kind": "app",
  "location": "East US",
  "properties": {
    "serverFarmId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/DefaultAsp"
  }
}

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.AppService.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.AppService;

// Generated from example definition: specification/web/resource-manager/Microsoft.Web/stable/2024-11-01/examples/CreateOrUpdateWebApp.json
// this example is just showing the usage of "WebApps_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345";
string resourceGroupName = "testrg123";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this WebSiteResource
WebSiteCollection collection = resourceGroupResource.GetWebSites();

// invoke the operation
string name = "sitef6141";
WebSiteData data = new WebSiteData(new AzureLocation("East US"))
{
    AppServicePlanId = new ResourceIdentifier("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/DefaultAsp"),
    Kind = "app",
};
ArmOperation<WebSiteResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, name, data);
WebSiteResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
WebSiteData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respuesta de muestra

status code:

200

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141",
  "name": "sitef6141",
  "type": "Microsoft.Web/sites",
  "kind": "app",
  "location": "East US",
  "properties": {
    "state": "Running",
    "hostNames": [
      "sitef6141.azurewebsites.net"
    ],
    "repositorySiteName": "sitef6141",
    "usageState": "Normal",
    "enabled": true,
    "enabledHostNames": [
      "sitef6141.azurewebsites.net",
      "sitef6141.scm.azurewebsites.net"
    ],
    "availabilityState": "Normal",
    "hostNameSslStates": [
      {
        "name": "sitef6141.azurewebsites.net",
        "sslState": "Disabled",
        "hostType": "Standard"
      },
      {
        "name": "sitef6141.scm.azurewebsites.net",
        "sslState": "Disabled",
        "hostType": "Repository"
      }
    ],
    "serverFarmId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/DefaultAsp",
    "reserved": false,
    "isXenon": false,
    "hyperV": false,
    "lastModifiedTimeUtc": "2020-03-04T17:33:11.641Z",
    "outboundVnetRouting": {
      "allTraffic": false,
      "applicationTraffic": false,
      "contentShareTraffic": false,
      "imagePullTraffic": false,
      "backupRestoreTraffic": false
    },
    "siteConfig": {
      "numberOfWorkers": 1,
      "defaultDocuments": [
        "Default.htm",
        "Default.html",
        "Default.asp",
        "index.htm",
        "index.html",
        "iisstart.htm",
        "default.aspx",
        "index.php",
        "hostingstart.html"
      ],
      "netFrameworkVersion": "v4.0",
      "phpVersion": "5.6",
      "pythonVersion": "",
      "nodeVersion": "",
      "powerShellVersion": "",
      "linuxFxVersion": "",
      "requestTracingEnabled": false,
      "remoteDebuggingEnabled": false,
      "httpLoggingEnabled": false,
      "acrUseManagedIdentityCreds": false,
      "logsDirectorySizeLimit": 35,
      "detailedErrorLoggingEnabled": false,
      "use32BitWorkerProcess": true,
      "webSocketsEnabled": false,
      "alwaysOn": false,
      "appCommandLine": "",
      "managedPipelineMode": "Integrated",
      "virtualApplications": [
        {
          "virtualPath": "/",
          "physicalPath": "site\\wwwroot",
          "preloadEnabled": false
        }
      ],
      "loadBalancing": "LeastRequests",
      "autoHealEnabled": false,
      "vnetName": "",
      "vnetRouteAllEnabled": false,
      "vnetPrivatePortsCount": 0,
      "http20Enabled": false,
      "minTlsVersion": "1.2",
      "scmMinTlsVersion": "1.2",
      "ftpsState": "AllAllowed",
      "functionAppScaleLimit": 0,
      "functionsRuntimeScaleMonitoringEnabled": false,
      "minimumElasticInstanceCount": 0,
      "azureStorageAccounts": {}
    },
    "scmSiteAlsoStopped": false,
    "clientAffinityEnabled": true,
    "clientAffinityProxyEnabled": true,
    "clientCertEnabled": false,
    "clientCertMode": "Required",
    "hostNamesDisabled": false,
    "customDomainVerificationId": "7F3BB652450EF7AD0B6AA33064586E4A9CE823A46DF0B2EC6443A68086E84153",
    "outboundIpAddresses": "70.37.102.201,20.225.43.144",
    "possibleOutboundIpAddresses": "70.37.102.201,20.225.43.144,20.225.184.122,20.225.184.188",
    "containerSize": 0,
    "dailyMemoryTimeQuota": 0,
    "resourceGroup": "testrg123",
    "defaultHostName": "sitef6141.azurewebsites.net",
    "httpsOnly": false,
    "redundancyMode": "None",
    "storageAccountRequired": false,
    "keyVaultReferenceIdentity": "SystemAssigned",
    "workloadProfileName": "myd4wp",
    "resourceConfig": {
      "cpu": 1,
      "memory": "2.0Gi"
    }
  }
}

status code:

202

azure-asyncoperation: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.Web/sites/sitef6141/operationResults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2024-11-01

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/sites/sitef6141",
  "name": "sitef6141",
  "type": "Microsoft.Web/sites",
  "kind": "app",
  "location": "East US",
  "properties": {
    "state": "Running",
    "hostNames": [
      "sitef6141.azurewebsites.net"
    ],
    "repositorySiteName": "sitef6141",
    "usageState": "Normal",
    "enabled": true,
    "enabledHostNames": [
      "sitef6141.azurewebsites.net",
      "sitef6141.scm.azurewebsites.net"
    ],
    "availabilityState": "Normal",
    "hostNameSslStates": [
      {
        "name": "sitef6141.azurewebsites.net",
        "sslState": "Disabled",
        "hostType": "Standard"
      },
      {
        "name": "sitef6141.scm.azurewebsites.net",
        "sslState": "Disabled",
        "hostType": "Repository"
      }
    ],
    "serverFarmId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/DefaultAsp",
    "reserved": false,
    "isXenon": false,
    "hyperV": false,
    "lastModifiedTimeUtc": "2020-03-04T17:33:11.641Z",
    "outboundVnetRouting": {
      "allTraffic": false,
      "applicationTraffic": false,
      "contentShareTraffic": false,
      "imagePullTraffic": false,
      "backupRestoreTraffic": false
    },
    "siteConfig": {
      "numberOfWorkers": 1,
      "defaultDocuments": [
        "Default.htm",
        "Default.html",
        "Default.asp",
        "index.htm",
        "index.html",
        "iisstart.htm",
        "default.aspx",
        "index.php",
        "hostingstart.html"
      ],
      "netFrameworkVersion": "v4.0",
      "phpVersion": "5.6",
      "pythonVersion": "",
      "nodeVersion": "",
      "powerShellVersion": "",
      "linuxFxVersion": "",
      "requestTracingEnabled": false,
      "remoteDebuggingEnabled": false,
      "httpLoggingEnabled": false,
      "acrUseManagedIdentityCreds": false,
      "logsDirectorySizeLimit": 35,
      "detailedErrorLoggingEnabled": false,
      "use32BitWorkerProcess": true,
      "webSocketsEnabled": false,
      "alwaysOn": false,
      "appCommandLine": "",
      "managedPipelineMode": "Integrated",
      "virtualApplications": [
        {
          "virtualPath": "/",
          "physicalPath": "site\\wwwroot",
          "preloadEnabled": false
        }
      ],
      "loadBalancing": "LeastRequests",
      "autoHealEnabled": false,
      "vnetName": "",
      "vnetRouteAllEnabled": false,
      "vnetPrivatePortsCount": 0,
      "http20Enabled": false,
      "minTlsVersion": "1.2",
      "scmMinTlsVersion": "1.2",
      "ftpsState": "AllAllowed",
      "functionAppScaleLimit": 0,
      "functionsRuntimeScaleMonitoringEnabled": false,
      "minimumElasticInstanceCount": 0,
      "azureStorageAccounts": {}
    },
    "scmSiteAlsoStopped": false,
    "clientAffinityEnabled": true,
    "clientCertEnabled": false,
    "clientCertMode": "Required",
    "hostNamesDisabled": false,
    "customDomainVerificationId": "7F3BB652450EF7AD0B6AA33064586E4A9CE823A46DF0B2EC6443A68086E84153",
    "outboundIpAddresses": "70.37.102.201,20.225.43.144",
    "possibleOutboundIpAddresses": "70.37.102.201,20.225.43.144,20.225.184.122,20.225.184.188",
    "containerSize": 0,
    "dailyMemoryTimeQuota": 0,
    "resourceGroup": "testrg123",
    "defaultHostName": "sitef6141.azurewebsites.net",
    "httpsOnly": false,
    "redundancyMode": "None",
    "storageAccountRequired": false,
    "keyVaultReferenceIdentity": "SystemAssigned",
    "workloadProfileName": "myd4wp",
    "resourceConfig": {
      "cpu": 1,
      "memory": "2.0Gi"
    }
  }
}

Definiciones

Nombre	Description
ApiDefinitionInfo	Información sobre la definición de API formal para la aplicación.
ApiManagementConfig	Configuración de Azure API Management (APIM) vinculada a la aplicación.
Authentication	Método de autenticación para acceder a la cuenta de almacenamiento para la implementación.
AuthenticationType	Propiedad para seleccionar el tipo de autenticación para acceder a la cuenta de almacenamiento seleccionada. Opciones disponibles: SystemAssignedIdentity, UserAssignedIdentity, StorageAccountConnectionString.
autoGeneratedDomainNameLabelScope	Especifica el ámbito de unicidad del nombre de host predeterminado durante la creación de recursos.
AutoHealActions	Acciones que debe realizar el módulo de recuperación automática cuando se desencadena una regla.
AutoHealActionType	Acción predefinida que se va a realizar.
AutoHealCustomAction	Acción personalizada que se va a ejecutar cuando se desencadena una regla de recuperación automática.
AutoHealRules	Reglas que se pueden definir para la recuperación automática.
AutoHealTriggers	Desencadenadores para la recuperación automática.
AzureStorageInfoValue	Valor de información de acceso de Azure Files o Blob Storage para el almacenamiento de diccionarios.
AzureStorageProtocol	Protocolo de montaje que se va a usar para la cuenta de almacenamiento.
AzureStorageState	Estado de la cuenta de almacenamiento.
AzureStorageType	Tipo de almacenamiento.
ClientCertMode	Esto se compone con la configuración ClientCertEnabled. ClientCertEnabled: false significa que Se omite ClientCert. ClientCertEnabled: true y ClientCertMode: Obligatorio significa que se requiere ClientCert. ClientCertEnabled: true y ClientCertMode: opcional significa que ClientCert es opcional o se acepta.
CloningInfo	Información necesaria para la operación de clonación.
ConnectionStringType	Tipo de base de datos.
ConnStringInfo	Información de la cadena de conexión de base de datos.
CorsSettings	Configuración de uso compartido de recursos entre orígenes (CORS) para la aplicación.
DaprConfig	Configuración de Dapr de la aplicación.
daprLogLevel	Establece el nivel de registro del sidecar de Dapr. Los valores permitidos son debug, info, warn, error. El valor predeterminado es info.
DefaultAction	Acción predeterminada para la restricción de acceso principal si no hay ninguna regla coincidente.
DefaultErrorResponse	Respuesta de error de App Service.
Details
Error	Modelo de error.
Experiments	Reglas de enrutamiento en experimentos de producción.
ExtendedLocation	Ubicación extendida.
FtpsState	Estado del servicio FTP/FTPS
FunctionAppConfig	Configuración de la aplicación de funciones.
FunctionsAlwaysReadyConfig	Establece el número de instancias de "Always Ready" para un grupo de funciones o una función específica.
FunctionsDeployment	Sección de configuración de la implementación de la aplicación de funciones.
FunctionsDeploymentStorageType	Propiedad para seleccionar el tipo de Azure Storage. Opciones disponibles: blobContainer.
FunctionsRuntime	Nombre y versión del entorno de ejecución de la aplicación de funciones.
FunctionsScaleAndConcurrency	Configuración de escalado y simultaneidad para la aplicación de funciones.
HandlerMapping	Las asignaciones de controladores de IIS usadas para definir qué controlador procesa las solicitudes HTTP con cierta extensión. Por ejemplo, se usa para configurar php-cgi.exe proceso para controlar todas las solicitudes HTTP con la extensión *.php.
HostingEnvironmentProfile	Especificación de un entorno de App Service que se va a usar para este recurso.
HostNameSslState	Nombre de host habilitado para SSL.
HostType	Indica si el nombre de host es un nombre de host estándar o de repositorio.
Http	Configuración de escalado y simultaneidad para el desencadenador HTTP.
IpFilterTag	Define para qué se usará este filtro IP. Esto es para admitir el filtrado de IP en servidores proxy.
IPMode	Especifica el modo IP de la aplicación.
IpSecurityRestriction	Restricción de seguridad de IP en una aplicación.
ManagedPipelineMode	Modo de canalización administrada.
ManagedServiceIdentity	Identidad de servicio administrada.
ManagedServiceIdentityType	Tipo de identidad de servicio administrada.
NameValuePair	Par nombre de valor.
OutboundVnetRouting	Opciones de tráfico saliente a través de la red virtual.
PushSettings	Inserte la configuración de la aplicación.
RampUpRule	Reglas de enrutamiento para aumentar las pruebas. Esta regla permite redirigir el tráfico estático % a una ranura o cambiar gradualmente el enrutamiento % en función del rendimiento.
RedundancyMode	Modo de redundancia del sitio
RequestsBasedTrigger	Desencadenador basado en el total de solicitudes.
ResourceConfig	Requisitos de recursos de la aplicación de funciones.
RuntimeName	Nombre del entorno de ejecución de la aplicación de funciones. Opciones disponibles: dotnet-isolated, node, java, powershell, python, custom
ScmType	Tipo SCM.
Site	Una aplicación web, un back-end de aplicación móvil o una aplicación de API.
SiteAvailabilityState	Estado de disponibilidad de la información de administración para la aplicación.
SiteConfig	Configuración de una aplicación de App Service.
SiteDnsConfig
SiteLimits	Límites de métricas establecidos en una aplicación.
SiteLoadBalancing	Equilibrio de carga del sitio.
SiteMachineKey	MachineKey de una aplicación.
SlotSwapStatus	Estado de la última operación de intercambio de ranura correcta.
SlowRequestsBasedTrigger	Desencadenador basado en el tiempo de ejecución de la solicitud.
SslState	Tipo SSL
StatusCodesBasedTrigger	Desencadenador basado en el código de estado.
StatusCodesRangeBasedTrigger	Desencadenador basado en el intervalo de códigos de estado.
Storage	Almacenamiento para el paquete implementado usado por la aplicación de funciones.
SupportedTlsVersions	MinTlsVersion: configura la versión mínima de TLS necesaria para las solicitudes SSL.
TlsCipherSuites	Conjunto de cifrado TLS de intensidad mínima permitido para una aplicación
Triggers	Configuración de escalado y simultaneidad para los desencadenadores de la aplicación de funciones.
UsageState	Estado que indica si la aplicación ha superado su uso de cuota. Solo lectura.
userAssignedIdentity	Identidad asignada por el usuario.
VirtualApplication	Aplicación virtual en una aplicación.
VirtualDirectory	Directorio de la aplicación virtual.

ApiDefinitionInfo

Object

Información sobre la definición de API formal para la aplicación.

Nombre	Tipo	Description
url	string	Dirección URL de la definición de API.

ApiManagementConfig

Object

Configuración de Azure API Management (APIM) vinculada a la aplicación.

Nombre	Tipo	Description
id	string	identificador de APIM-Api.

Authentication

Object

Método de autenticación para acceder a la cuenta de almacenamiento para la implementación.

Nombre	Tipo	Description
storageAccountConnectionStringName	string	Use esta propiedad para StorageAccountConnectionString. Establezca el nombre de la configuración de la aplicación que tiene la cadena de conexión de la cuenta de almacenamiento. No establezca un valor para esta propiedad al usar otro tipo de autenticación.
type	AuthenticationType	Propiedad para seleccionar el tipo de autenticación para acceder a la cuenta de almacenamiento seleccionada. Opciones disponibles: SystemAssignedIdentity, UserAssignedIdentity, StorageAccountConnectionString.
userAssignedIdentityResourceId	string	Use esta propiedad para UserAssignedIdentity. Establezca el identificador de recurso de la identidad. No establezca un valor para esta propiedad al usar otro tipo de autenticación.

AuthenticationType

Enumeración

Propiedad para seleccionar el tipo de autenticación para acceder a la cuenta de almacenamiento seleccionada. Opciones disponibles: SystemAssignedIdentity, UserAssignedIdentity, StorageAccountConnectionString.

Valor	Description
StorageAccountConnectionString
SystemAssignedIdentity
UserAssignedIdentity

autoGeneratedDomainNameLabelScope

Enumeración

Especifica el ámbito de unicidad del nombre de host predeterminado durante la creación de recursos.

Valor	Description
NoReuse
ResourceGroupReuse
SubscriptionReuse
TenantReuse

AutoHealActions

Object

Acciones que debe realizar el módulo de recuperación automática cuando se desencadena una regla.

Nombre	Tipo	Description
actionType	AutoHealActionType	Acción predefinida que se va a realizar.
customAction	AutoHealCustomAction	Acción personalizada que se va a realizar.
minProcessExecutionTime	string	Tiempo mínimo que el proceso debe ejecutarse antes de realizar la acción

AutoHealActionType

Enumeración

Acción predefinida que se va a realizar.

Valor	Description
CustomAction
LogEvent
Recycle

AutoHealCustomAction

Object

Acción personalizada que se va a ejecutar cuando se desencadena una regla de recuperación automática.

Nombre	Tipo	Description
exe	string	Ejecutable que se va a ejecutar.
parameters	string	Parámetros para el archivo ejecutable.

AutoHealRules

Object

Reglas que se pueden definir para la recuperación automática.

Nombre	Tipo	Description
actions	AutoHealActions	Acciones que se ejecutarán cuando se desencadene una regla.
triggers	AutoHealTriggers	Condiciones que describen cuándo ejecutar las acciones de recuperación automática.

AutoHealTriggers

Object

Desencadenadores para la recuperación automática.

Nombre	Tipo	Description
privateBytesInKB	integer (int32)	Una regla basada en bytes privados.
requests	RequestsBasedTrigger	Una regla basada en el total de solicitudes.
slowRequests	SlowRequestsBasedTrigger	Una regla basada en el tiempo de ejecución de la solicitud.
slowRequestsWithPath	SlowRequestsBasedTrigger[]	Una regla basada en varias reglas de solicitudes lentas con ruta de acceso
statusCodes	StatusCodesBasedTrigger[]	Regla basada en códigos de estado.
statusCodesRange	StatusCodesRangeBasedTrigger[]	Regla basada en intervalos de códigos de estado.

AzureStorageInfoValue

Object

Valor de información de acceso de Azure Files o Blob Storage para el almacenamiento de diccionarios.

Nombre	Tipo	Description
accessKey	string	Clave de acceso para la cuenta de almacenamiento.
accountName	string	Nombre de la cuenta de almacenamiento.
mountPath	string	Ruta de acceso para montar el almacenamiento en el entorno en tiempo de ejecución del sitio.
protocol	AzureStorageProtocol	Protocolo de montaje que se va a usar para la cuenta de almacenamiento.
shareName	string	Nombre del recurso compartido de archivos (nombre del contenedor, para Blob Storage).
state	AzureStorageState	Estado de la cuenta de almacenamiento.
type	AzureStorageType	Tipo de almacenamiento.

AzureStorageProtocol

Enumeración

Protocolo de montaje que se va a usar para la cuenta de almacenamiento.

Valor	Description
Http
Nfs
Smb

AzureStorageState

Enumeración

Estado de la cuenta de almacenamiento.

Valor	Description
InvalidCredentials
InvalidShare
NotValidated
Ok

AzureStorageType

Enumeración

Tipo de almacenamiento.

Valor	Description
AzureBlob
AzureFiles

ClientCertMode

Enumeración

Esto se compone con la configuración ClientCertEnabled.

• ClientCertEnabled: false significa que Se omite ClientCert.
• ClientCertEnabled: true y ClientCertMode: Obligatorio significa que se requiere ClientCert.
• ClientCertEnabled: true y ClientCertMode: opcional significa que ClientCert es opcional o se acepta.

Valor	Description
Optional
OptionalInteractiveUser
Required

CloningInfo

Object

Información necesaria para la operación de clonación.

Nombre	Tipo	Description
appSettingsOverrides	object	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.
cloneCustomHostNames	boolean	true clonar nombres de host personalizados de la aplicación de origen; de lo contrario, false.
cloneSourceControl	boolean	true clonar el control de código fuente de la aplicación de origen; de lo contrario, false.
configureLoadBalancing	boolean	true configurar el equilibrio de carga para la aplicación de origen y destino.
correlationId	string (uuid)	Id. de correlación de la operación de clonación. Este identificador vincula varias operaciones de clonación para usar la misma instantánea.
hostingEnvironment	string	Entorno del Servicio de aplicaciones.
overwrite	boolean	true sobrescribir la aplicación de destino; de lo contrario, false.
sourceWebAppId	string	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.
sourceWebAppLocation	string	Ubicación de la aplicación de origen, por ejemplo: Oeste de EE. UU. o Norte de Europa
trafficManagerProfileId	string	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}.
trafficManagerProfileName	string	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.

ConnectionStringType

Enumeración

Tipo de base de datos.

Valor	Description
ApiHub
Custom
DocDb
EventHub
MySql
NotificationHub
PostgreSQL
RedisCache
SQLAzure
SQLServer
ServiceBus

ConnStringInfo

Object

Información de la cadena de conexión de base de datos.

Nombre	Tipo	Description
connectionString	string	Valor de cadena de conexión.
name	string	Nombre de la cadena de conexión.
type	ConnectionStringType	Tipo de base de datos.

CorsSettings

Object

Configuración de uso compartido de recursos entre orígenes (CORS) para la aplicación.

Nombre	Tipo	Description
allowedOrigins	string[]	Obtiene o establece la lista de orígenes que se deben permitir para realizar llamadas entre orígenes (por ejemplo: http://example.com:12345). Use "*" para permitir todo.
supportCredentials	boolean	Obtiene o establece si se permiten solicitudes CORS con credenciales. Consulte https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#Requests_with_credentials para obtener más detalles.

DaprConfig

Object

Configuración de Dapr de la aplicación.

Nombre	Tipo	Valor predeterminado	Description
appId	string		Identificador de aplicación dapr
appPort	integer (int32)		Indica a Dapr en qué puerto escucha la aplicación.
enableApiLogging	boolean		Habilita el registro de API para el sidecar de Dapr
enabled	boolean	False	Boolean que indica si el coche lateral dapr está habilitado
httpMaxRequestSize	integer (int32)		Aumento del tamaño máximo del parámetro de servidores HTTP del cuerpo de la solicitud en MB para controlar la carga de archivos grandes. El valor predeterminado es de 4 MB.
httpReadBufferSize	integer (int32)		Tamaño máximo de dapr del búfer de lectura de encabezado http en KB para controlar al enviar encabezados de varios KB. El valor predeterminado es 65 KB.
logLevel	daprLogLevel		Establece el nivel de registro del sidecar de Dapr. Los valores permitidos son debug, info, warn, error. El valor predeterminado es info.

daprLogLevel

Enumeración

Establece el nivel de registro del sidecar de Dapr. Los valores permitidos son debug, info, warn, error. El valor predeterminado es info.

Valor	Description
debug
error
info
warn

DefaultAction

Enumeración

Acción predeterminada para la restricción de acceso principal si no hay ninguna regla coincidente.

Valor	Description
Allow
Deny

DefaultErrorResponse

Object

Respuesta de error de App Service.

Nombre	Tipo	Description
error	Error	Modelo de error.

Details

Object

Nombre	Tipo	Description
code	string	Cadena estandarizada para identificar mediante programación el error.
message	string	Descripción detallada del error e información de depuración.
target	string	Descripción detallada del error e información de depuración.

Error

Object

Modelo de error.

Nombre	Tipo	Description
code	string	Cadena estandarizada para identificar mediante programación el error.
details	Details[]	Errores detallados.
innererror	string	Más información para depurar el error.
message	string	Descripción detallada del error e información de depuración.
target	string	Descripción detallada del error e información de depuración.

Experiments

Object

Reglas de enrutamiento en experimentos de producción.

Nombre	Tipo	Description
rampUpRules	RampUpRule[]	Lista de reglas de rampa.

ExtendedLocation

Object

Ubicación extendida.

Nombre	Tipo	Description
name	string	Nombre de la ubicación extendida.
type	string	Tipo de ubicación extendida.

FtpsState

Enumeración

Estado del servicio FTP/FTPS

Valor	Description
AllAllowed
Disabled
FtpsOnly

FunctionAppConfig

Object

Configuración de la aplicación de funciones.

Nombre	Tipo	Description
deployment	FunctionsDeployment	Configuración de implementación de la aplicación de funciones.
runtime	FunctionsRuntime	Configuración del entorno de ejecución de la aplicación de funciones.
scaleAndConcurrency	FunctionsScaleAndConcurrency	Configuración de escala y simultaneidad de la aplicación de funciones.

FunctionsAlwaysReadyConfig

Object

Establece el número de instancias de "Always Ready" para un grupo de funciones o una función específica.

Nombre	Tipo	Description
instanceCount	integer (int32)	Establece el número de instancias de "Always Ready" para un grupo de funciones determinado o una función específica. Para obtener más información, consulte https://aka.ms/flexconsumption/alwaysready.
name	string	Se requiere un grupo de funciones o un nombre de función. Para obtener más información, consulte https://aka.ms/flexconsumption/alwaysready.

FunctionsDeployment

Object

Sección de configuración de la implementación de la aplicación de funciones.

Nombre	Tipo	Description
storage	Storage	Almacenamiento para el paquete implementado usado por la aplicación de funciones.

FunctionsDeploymentStorageType

Enumeración

Propiedad para seleccionar el tipo de Azure Storage. Opciones disponibles: blobContainer.

Valor	Description
blobContainer

FunctionsRuntime

Object

Nombre y versión del entorno de ejecución de la aplicación de funciones.

Nombre	Tipo	Description
name	RuntimeName	Nombre del entorno de ejecución de la aplicación de funciones. Opciones disponibles: dotnet-isolated, node, java, powershell, python, custom
version	string	Versión del entorno de ejecución de la aplicación de funciones. Ejemplo: 8 (para dotnet-isolated)

FunctionsScaleAndConcurrency

Object

Configuración de escalado y simultaneidad para la aplicación de funciones.

Nombre	Tipo	Description
alwaysReady	FunctionsAlwaysReadyConfig[]	Configuración de "Always Ready" para la aplicación de funciones.
instanceMemoryMB	integer (int32)	Establezca la cantidad de memoria asignada a cada instancia de la aplicación de funciones en MB. El ancho de banda de la CPU y la red se asignan proporcionalmente.
maximumInstanceCount	integer (int32)	Número máximo de instancias de la aplicación de funciones.
triggers	Triggers	Configuración de escalado y simultaneidad para los desencadenadores de la aplicación de funciones.

HandlerMapping

Object

Las asignaciones de controladores de IIS usadas para definir qué controlador procesa las solicitudes HTTP con cierta extensión. Por ejemplo, se usa para configurar php-cgi.exe proceso para controlar todas las solicitudes HTTP con la extensión *.php.

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

HostingEnvironmentProfile

Object

Especificación de un entorno de App Service que se va a usar para este recurso.

Nombre	Tipo	Description
id	string	Identificador de recurso de App Service Environment.
name	string	Nombre de App Service Environment.
type	string	Tipo de recurso de App Service Environment.

HostNameSslState

Object

Nombre de host habilitado para SSL.

Nombre	Tipo	Description
hostType	HostType	Indica si el nombre de host es un nombre de host estándar o de repositorio.
name	string	Nombre de host.
sslState	SslState	Tipo SSL.
thumbprint	string	Huella digital del certificado SSL.
toUpdate	boolean	Establezca en true para actualizar el nombre de host existente.
virtualIP	string	Dirección IP virtual asignada al nombre de host si está habilitado SSL basado en IP.

HostType

Enumeración

Indica si el nombre de host es un nombre de host estándar o de repositorio.

Valor	Description
Repository
Standard

Http

Object

Configuración de escalado y simultaneidad para el desencadenador HTTP.

Nombre	Tipo	Description
perInstanceConcurrency	integer (int32)	Número máximo de invocaciones simultáneas de desencadenador HTTP por instancia.

IpFilterTag

Enumeración

Define para qué se usará este filtro IP. Esto es para admitir el filtrado de IP en servidores proxy.

Valor	Description
Default
ServiceTag
XffProxy

IPMode

Enumeración

Especifica el modo IP de la aplicación.

Valor	Description
IPv4
IPv4AndIPv6
IPv6

IpSecurityRestriction

Object

Restricción de seguridad de IP en una aplicación.

Nombre	Tipo	Description
action	string	Permitir o denegar el acceso para este intervalo IP.
description	string	Descripción de la regla de restricción de IP.
headers	object	Encabezados de regla de restricción de IP. X-Forwarded-Host (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-Host#Examples). La lógica coincidente es .. Si la propiedad es null o está vacía (valor predeterminado), se permiten todos los hosts (o falta de). Se compara un valor mediante ordinal-ignore-case (excepto el número de puerto). Se permiten caracteres comodín de subdominio, pero no coinciden con el dominio raíz. Por ejemplo, *.contoso.com coincide con el foo.contoso.com de subdominio, pero no el dominio raíz contoso.com o foo.bar.contoso.com de varios niveles Se permiten nombres de host Unicode, pero se convierten en Punycode para buscar coincidencias. X-Forwarded-For (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-For#Examples). La lógica coincidente es .. Si la propiedad es nula o vacía (valor predeterminado), se permiten cadenas reenviadas (o falta de). Si alguna dirección (excepto el número de puerto) de la cadena (separada por comas) coincide con el CIDR definido por la propiedad . X-Azure-FDID y X-FD-HealthProbe. La lógica coincidente es exacta.
ipAddress	string	Dirección IP para la que es válida la restricción de seguridad. Puede estar en forma de dirección ipv4 pura (propiedad SubnetMask obligatoria) o notación CIDR, como ipv4/mask (coincidencia de bits inicial). Para CIDR, no se debe especificar la propiedad SubnetMask.
name	string	Nombre de la regla de restricción de IP.
priority	integer (int32)	Prioridad de la regla de restricción de IP.
subnetMask	string	Máscara de subred para el intervalo de direcciones IP para la que es válida la restricción.
subnetTrafficTag	integer (int32)	(interno) Etiqueta de tráfico de subred
tag	IpFilterTag	Define para qué se usará este filtro IP. Esto es para admitir el filtrado de IP en servidores proxy.
vnetSubnetResourceId	string	Identificador de recurso de red virtual
vnetTrafficTag	integer (int32)	(interno) Etiqueta de tráfico de red virtual

ManagedPipelineMode

Enumeración

Modo de canalización administrada.

Valor	Description
Classic
Integrated

ManagedServiceIdentity

Object

Identidad de servicio administrada.

Nombre	Tipo	Description
principalId	string	Identificador de entidad de seguridad de la identidad de servicio administrada.
tenantId	string	Inquilino de la identidad de servicio administrada.
type	ManagedServiceIdentityType	Tipo de identidad de servicio administrada.
userAssignedIdentities	<string,  userAssignedIdentity>	Lista de identidades asignadas por el usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recurso de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}

ManagedServiceIdentityType

Enumeración

Tipo de identidad de servicio administrada.

Valor	Description
None
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned

NameValuePair

Object

Par nombre de valor.

Nombre	Tipo	Description
name	string	Nombre del par.
value	string	Valor del par.

OutboundVnetRouting

Object

Opciones de tráfico saliente a través de la red virtual.

Nombre	Tipo	Description
allTraffic	boolean	Habilita todas las demás opciones de enrutamiento definidas en OutboundVnetRouting si esta configuración está establecida en true.
applicationTraffic	boolean	Esto hace que todo el tráfico saliente tenga aplicados grupos de seguridad de red virtual y rutas definidas por el usuario. Anteriormente se llamaba VnetRouteAllEnabled.
backupRestoreTraffic	boolean	Habilita las operaciones de copia de seguridad y restauración a través de la red virtual. Anteriormente se llamaba VnetBackupRestoreEnabled
contentShareTraffic	boolean	Permite el acceso al contenido a través de la red virtual. Anteriormente se llamaba VnetContentShareEnabled
imagePullTraffic	boolean	Habilita la extracción de imágenes a través de la red virtual. Anteriormente se llamaba VnetImagePullEnabled.

PushSettings

Object

Inserte la configuración de la aplicación.

Nombre	Tipo	Description
id	string	Identificador de recurso.
kind	string	Tipo de recurso.
name	string	Nombre del recurso.
properties.dynamicTagsJson	string	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.
properties.isPushEnabled	boolean	Obtiene o establece una marca que indica si el punto de conexión push está habilitado.
properties.tagWhitelistJson	string	Obtiene o establece una cadena JSON que contiene una lista de etiquetas que están en la lista blanca para su uso por el punto de conexión de registro de inserción.
properties.tagsRequiringAuth	string	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 los siguientes: '_', '@', '#', '.', ':', '-'. La validación debe realizarse en PushRequestHandler.
type	string	Tipo de recurso.

RampUpRule

Object

Reglas de enrutamiento para aumentar las pruebas. Esta regla permite redirigir el tráfico estático % a una ranura o cambiar gradualmente el enrutamiento % en función del rendimiento.

Nombre	Tipo	Description
actionHostName	string	Nombre de host de una ranura a la que se redirigirá el tráfico si se decide. Por ejemplo, myapp-stage.azurewebsites.net.
changeDecisionCallbackUrl	string	El algoritmo de decisión personalizado se puede proporcionar en la extensión de sitio TiPCallback que se puede especificar la dirección URL.
changeIntervalInMinutes	integer (int32)	Especifica el intervalo en minutos para volver a evaluar ReroutePercentage.
changeStep	number (double)	En el escenario de aumento automático, este es el paso para agregar o quitar de ReroutePercentage hasta que alcance \nMinReroutePercentage o MaxReroutePercentage. Las métricas del sitio se comprueban cada N minutos especificados en ChangeIntervalInMinutes.\nalgoritmo de decisión personalizado se puede proporcionar en la extensión de sitio TiPCallback que se puede especificar en ChangeDecisionCallbackUrl.
maxReroutePercentage	number (double)	Especifica el límite superior por debajo del cual se mantendrá ReroutePercentage.
minReroutePercentage	number (double)	Especifica el límite inferior por encima del cual se mantendrá ReroutePercentage.
name	string	Nombre de la regla de enrutamiento. El nombre recomendado sería apuntar a la ranura que recibirá el tráfico en el experimento.
reroutePercentage	number (double)	Porcentaje del tráfico al que se redirigirá a ActionHostName.

RedundancyMode

Enumeración

Modo de redundancia del sitio

Valor	Description
ActiveActive
Failover
GeoRedundant
Manual
None

RequestsBasedTrigger

Object

Desencadenador basado en el total de solicitudes.

Nombre	Tipo	Description
count	integer (int32)	Recuento de solicitudes.
timeInterval	string	Intervalo de tiempo.

ResourceConfig

Object

Requisitos de recursos de la aplicación de funciones.

Nombre	Tipo	Description
cpu	number (double)	CPU necesaria en núcleos, por ejemplo, 0,5
memory	string	Memoria necesaria, por ejemplo, "1Gi"

RuntimeName

Enumeración

Nombre del entorno de ejecución de la aplicación de funciones. Opciones disponibles: dotnet-isolated, node, java, powershell, python, custom

Valor	Description
custom
dotnet-isolated
java
node
powershell
python

ScmType

Enumeración

Tipo SCM.

Valor	Description
BitbucketGit
BitbucketHg
CodePlexGit
CodePlexHg
Dropbox
ExternalGit
ExternalHg
GitHub
LocalGit
None
OneDrive
Tfs
VSO
VSTSRM

Site

Object

Una aplicación web, un back-end de aplicación móvil o una aplicación de API.

Nombre	Tipo	Valor predeterminado	Description
extendedLocation	ExtendedLocation		Ubicación extendida.
id	string		Identificador de recurso.
identity	ManagedServiceIdentity		Identidad de servicio administrada.
kind	string		Tipo de recurso. Si el recurso es una aplicación, puede consultar https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference para obtener más información sobre los valores admitidos para el tipo.
location	string		Ubicación del recurso.
name	string		Nombre del recurso.
properties.autoGeneratedDomainNameLabelScope	autoGeneratedDomainNameLabelScope		Especifica el ámbito de unicidad del nombre de host predeterminado durante la creación de recursos.
properties.availabilityState	SiteAvailabilityState		Estado de disponibilidad de la información de administración para la aplicación.
properties.clientAffinityEnabled	boolean		true para habilitar la afinidad de cliente; false 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 true.
properties.clientAffinityPartitioningEnabled	boolean		true para habilitar la partición de afinidad del cliente mediante cookies CHIPS, esto agregará la partitioned propiedad a las cookies de afinidad; false para dejar de enviar cookies de afinidad particionadas. El valor predeterminado es false.
properties.clientAffinityProxyEnabled	boolean		true para anular el dominio de cookie de afinidad del cliente con el encabezado de solicitud X-Forwarded-Host. false para usar el dominio predeterminado. El valor predeterminado es false.
properties.clientCertEnabled	boolean		true para habilitar la autenticación de certificados de cliente (autenticación mutua tls); de lo contrario, false. El valor predeterminado es false.
properties.clientCertExclusionPaths	string		rutas de exclusión separadas por comas de autenticación de certificados de cliente
properties.clientCertMode	ClientCertMode		Esto se compone con la configuración ClientCertEnabled. ClientCertEnabled: false significa que Se omite ClientCert. ClientCertEnabled: true y ClientCertMode: Obligatorio significa que se requiere ClientCert. ClientCertEnabled: true y ClientCertMode: opcional significa que ClientCert es opcional o se acepta.
properties.cloningInfo	CloningInfo		Si se especifica durante la creación de la aplicación, la aplicación se clona desde una aplicación de origen.
properties.containerSize	integer (int32)		Tamaño del contenedor de funciones.
properties.customDomainVerificationId	string		Identificador único que comprueba los dominios personalizados asignados a la aplicación. El cliente agregará este identificador a un registro txt para su comprobación.
properties.dailyMemoryTimeQuota	integer (int32)		Cuota de tiempo de memoria diaria máxima permitida (aplicable solo en aplicaciones dinámicas).
properties.daprConfig	DaprConfig		Configuración de Dapr de la aplicación.
properties.defaultHostName	string		Nombre de host predeterminado de la aplicación. Solo lectura.
properties.dnsConfiguration	SiteDnsConfig		Propiedad para configurar varias opciones relacionadas con DNS para un sitio.
properties.enabled	boolean		true si la aplicación está habilitada; de lo contrario, false. Al establecer este valor en false, se deshabilita la aplicación (se desconecta la aplicación).
properties.enabledHostNames	string[]		Nombres de host habilitados para la aplicación. Es necesario asignar nombres de host (consulte Nombres de host) Y habilitados. De lo contrario, la aplicación no se sirve en esos nombres de host.
properties.endToEndEncryptionEnabled	boolean		Si se va a usar el cifrado de un extremo a otro entre front-end y el trabajo
properties.functionAppConfig	FunctionAppConfig		Configuración específica de la aplicación de funciones de Azure.
properties.hostNameSslStates	HostNameSslState[]		Los estados SSL de nombre de host se usan para administrar los enlaces SSL para los nombres de host de la aplicación.
properties.hostNames	string[]		Nombres de host asociados a la aplicación.
properties.hostNamesDisabled	boolean		true deshabilitar los nombres de host públicos de la aplicación; de lo contrario, false. Si true, la aplicación solo es accesible a través del proceso de API Management.
properties.hostingEnvironmentProfile	HostingEnvironmentProfile		App Service Environment que se va a usar para la aplicación.
properties.httpsOnly	boolean		HttpsOnly: configura un sitio web para aceptar solo solicitudes https. Problemas de redirección de solicitudes HTTP
properties.hyperV	boolean	False	Hyper-V espacio aislado.
properties.inProgressOperationId	string (uuid)		Especifica un identificador de operación si este sitio tiene una operación pendiente.
properties.ipMode	IPMode		Especifica el modo IP de la aplicación.
properties.isDefaultContainer	boolean		true si la aplicación es un contenedor predeterminado; de lo contrario, false.
properties.isXenon	boolean	False	Obsoleto: Hyper-V espacio aislado.
properties.keyVaultReferenceIdentity	string		Identidad que se va a usar para la autenticación de referencia de Key Vault.
properties.lastModifiedTimeUtc	string (date-time)		Última vez que se modificó la aplicación, en UTC. Solo lectura.
properties.managedEnvironmentId	string		Identificador de Azure Resource Manager del entorno administrado seleccionado del cliente en el que hospedar esta aplicación. Debe tener el formato /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.App/managedEnvironments/{managedEnvironmentName}
properties.maxNumberOfWorkers	integer (int32)		Número máximo de trabajadores. Esto solo se aplica al contenedor de Functions.
properties.outboundIpAddresses	string		Lista de direcciones IP que usa la aplicación para las conexiones salientes (por ejemplo, acceso a la base de datos). Incluye VIP de inquilinos que se pueden hospedar con la configuración actual. Solo lectura.
properties.outboundVnetRouting	OutboundVnetRouting		Propiedad para configurar varias opciones de enrutamiento de tráfico saliente a través de la red virtual para un sitio
properties.possibleOutboundIpAddresses	string		Lista de direcciones IP que usa la aplicación para las conexiones salientes (por ejemplo, acceso a la base de datos). Incluye VIP de todos los inquilinos, excepto dataComponent. Solo lectura.
properties.publicNetworkAccess	string		Propiedad para permitir o bloquear todo el tráfico público. Valores permitidos: 'Enabled', 'Disabled' o una cadena vacía.
properties.redundancyMode	RedundancyMode		Modo de redundancia del sitio
properties.repositorySiteName	string		Nombre del sitio del repositorio.
properties.reserved	boolean	False	true si están reservados; de lo contrario, false.
properties.resourceConfig	ResourceConfig		Requisitos de recursos de la aplicación de funciones.
properties.resourceGroup	string		Nombre del grupo de recursos al que pertenece la aplicación. Solo lectura.
properties.scmSiteAlsoStopped	boolean	False	true para detener el sitio de SCM (KUDU) cuando se detiene la aplicación; de lo contrario, false. El valor predeterminado es false.
properties.serverFarmId	string		Identificador de recurso del plan de App Service asociado, con el formato "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}".
properties.siteConfig	SiteConfig		Configuración de una aplicación de App Service. Esta propiedad no se devuelve en respuesta a las solicitudes normales de creación y lectura, ya que puede contener información confidencial.
properties.sku	string		SKU actual de la aplicación basada en el plan de App Service asociado. Algunos valores de SKU válidos son Free, Shared, Basic, Dynamic, FlexConsumption, Standard, Premium, PremiumV2, PremiumV3, Isolated, IsolatedV2
properties.slotSwapStatus	SlotSwapStatus		Estado de la última operación de intercambio de ranuras de implementación.
properties.sshEnabled	boolean		Si se habilita el acceso ssh.
properties.state	string		Estado actual de la aplicación.
properties.storageAccountRequired	boolean		Comprueba si se requiere la cuenta de almacenamiento proporcionada por el cliente.
properties.suspendedTill	string (date-time)		La aplicación se suspende hasta que, en caso de que se supere la cuota de tiempo de memoria.
properties.targetSwapSlot	string		Especifica en qué ranura de implementación se intercambiará esta aplicación. Solo lectura.
properties.trafficManagerHostNames	string[]		Nombres de host de Azure Traffic Manager asociados a la aplicación. Solo lectura.
properties.usageState	UsageState		Estado que indica si la aplicación ha superado su uso de cuota. Solo lectura.
properties.virtualNetworkSubnetId	string		Identificador de Azure Resource Manager de la red virtual y la subred que se van a unir mediante la integración con red virtual regional. Debe tener el formato /subscriptions/{subscriptionName}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}
properties.workloadProfileName	string		Nombre del perfil de carga de trabajo para que se ejecute la aplicación de funciones.
tags	object		Etiquetas de recursos.
type	string		Tipo de recurso.

SiteAvailabilityState

Enumeración

Estado de disponibilidad de la información de administración para la aplicación.

Valor	Description
DisasterRecoveryMode
Limited
Normal

SiteConfig

Object

Configuración de una aplicación de App Service.

Nombre	Tipo	Valor predeterminado	Description
acrUseManagedIdentityCreds	boolean		Marca para usar Managed Identity Creds para la extracción de ACR
acrUserManagedIdentityID	string		Si usa la identidad administrada por el usuario, clientId de identidad administrada por el usuario
alwaysOn	boolean		true si AlwaysOn está habilitado; de lo contrario, false.
apiDefinition	ApiDefinitionInfo		Información sobre la definición de API formal para la aplicación.
apiManagementConfig	ApiManagementConfig		Configuración de Azure API Management vinculada a la aplicación.
appCommandLine	string		Línea de comandos de la aplicación que se va a iniciar.
appSettings	NameValuePair[]		Configuración de la aplicación. Esta propiedad no se devuelve en respuesta a las solicitudes normales de creación y lectura, ya que puede contener información confidencial.
autoHealEnabled	boolean		true si la recuperación automática está habilitada; de lo contrario, false.
autoHealRules	AutoHealRules		Reglas de recuperación automática.
autoSwapSlotName	string		Nombre de ranura de intercambio automático.
azureStorageAccounts	<string,  AzureStorageInfoValue>		Lista de cuentas de Azure Storage.
connectionStrings	ConnStringInfo[]		Cadenas de conexión. Esta propiedad no se devuelve en respuesta a las solicitudes normales de creación y lectura, ya que puede contener información confidencial.
cors	CorsSettings		Configuración de uso compartido de recursos entre orígenes (CORS).
defaultDocuments	string[]		Documentos predeterminados.
detailedErrorLoggingEnabled	boolean		true si está habilitado el registro detallado de errores; de lo contrario, false.
documentRoot	string		Raíz del documento.
elasticWebAppScaleLimit	integer (int32) minimum: 0		Número máximo de trabajos a los que un sitio puede escalar horizontalmente. Esta configuración solo se aplica a las aplicaciones de los planes en los que ElasticScaleEnabled está true
experiments	Experiments		Esto es una solución alternativa para los tipos polimórficos.
ftpsState	FtpsState		Estado del servicio FTP/FTPS
functionAppScaleLimit	integer (int32) minimum: 0		Número máximo de trabajos a los que un sitio puede escalar horizontalmente. Esta configuración solo se aplica a los planes de Consumo y Elastic Premium
functionsRuntimeScaleMonitoringEnabled	boolean		Obtiene o establece un valor que indica si está habilitada la supervisión de escalado en tiempo de ejecución de funciones. Cuando se habilita, ScaleController no supervisará los orígenes de eventos directamente, sino que llamará al entorno de ejecución para obtener el estado de escalado.
handlerMappings	HandlerMapping[]		Asignaciones de controladores.
healthCheckPath	string		Ruta de acceso de comprobación de estado
http20Enabled	boolean	True	Http20Enabled: configura un sitio web para permitir que los clientes se conecten a través de http2.0
http20ProxyFlag	integer (int32)	0	Http20ProxyFlag: configura un sitio web para permitir que http2.0 pase ser proxy hasta la aplicación. 0 = deshabilitado, 1 = pasar a través de todo el tráfico http2, 2 = pasar solo a través de gRPC.
httpLoggingEnabled	boolean		true si el registro HTTP está habilitado; de lo contrario, false.
ipSecurityRestrictions	IpSecurityRestriction[]		Restricciones de seguridad de IP para main.
ipSecurityRestrictionsDefaultAction	DefaultAction		Acción predeterminada para la restricción de acceso principal si no hay ninguna regla coincidente.
javaContainer	string		Contenedor de Java.
javaContainerVersion	string		Versión del contenedor de Java.
javaVersion	string		Versión de Java.
keyVaultReferenceIdentity	string		Identidad que se va a usar para la autenticación de referencia de Key Vault.
limits	SiteLimits		Límites del sitio.
linuxFxVersion	string		Linux App Framework y versión
loadBalancing	SiteLoadBalancing		Equilibrio de carga del sitio.
localMySqlEnabled	boolean	False	true habilitar MySQL local; de lo contrario, false.
logsDirectorySizeLimit	integer (int32)		Límite de tamaño del directorio de registros HTTP.
machineKey	SiteMachineKey		MachineKey del sitio.
managedPipelineMode	ManagedPipelineMode		Modo de canalización administrada.
managedServiceIdentityId	integer (int32)		Identificador de identidad de servicio administrada
metadata	NameValuePair[]		Metadatos de la aplicación. Esta propiedad no se puede recuperar, ya que puede contener secretos.
minTlsCipherSuite	TlsCipherSuites		Conjunto de cifrado TLS de intensidad mínima permitido para una aplicación
minTlsVersion	SupportedTlsVersions		MinTlsVersion: configura la versión mínima de TLS necesaria para las solicitudes SSL.
minimumElasticInstanceCount	integer (int32) minimum: 0 maximum: 20		Número mínimo de recuento de instancias de un sitio Esta configuración solo se aplica a los planes elásticos.
netFrameworkVersion	string	v4.6	Versión de .NET Framework.
nodeVersion	string		Versión de Node.js.
numberOfWorkers	integer (int32)		Número de trabajadores.
phpVersion	string		Versión de PHP.
powerShellVersion	string		Versión de PowerShell.
preWarmedInstanceCount	integer (int32) minimum: 0 maximum: 10		Número de instancias preWarmed. Esta configuración solo se aplica a los planes de consumo y elástico
publicNetworkAccess	string		Propiedad para permitir o bloquear todo el tráfico público.
publishingUsername	string		Publicar el nombre de usuario.
push	PushSettings		Configuración del punto de conexión de inserción.
pythonVersion	string		Versión de Python.
remoteDebuggingEnabled	boolean		true si la depuración remota está habilitada; de lo contrario, false.
remoteDebuggingVersion	string		Versión de depuración remota.
requestTracingEnabled	boolean		true si está habilitado el seguimiento de solicitudes; de lo contrario, false.
requestTracingExpirationTime	string (date-time)		Tiempo de expiración del seguimiento de solicitudes.
scmIpSecurityRestrictions	IpSecurityRestriction[]		Restricciones de seguridad de IP para scm.
scmIpSecurityRestrictionsDefaultAction	DefaultAction		Acción predeterminada para la restricción de acceso scm si no hay ninguna regla coinciden.
scmIpSecurityRestrictionsUseMain	boolean		Restricciones de seguridad de IP para que scm use main.
scmMinTlsVersion	SupportedTlsVersions		ScmMinTlsVersion: configura la versión mínima de TLS necesaria para las solicitudes SSL para el sitio de SCM.
scmType	ScmType		Tipo SCM.
tracingOptions	string		Opciones de seguimiento.
use32BitWorkerProcess	boolean		true usar el proceso de trabajo de 32 bits; de lo contrario, false.
virtualApplications	VirtualApplication[]		Aplicaciones virtuales.
vnetName	string		Nombre de red virtual.
vnetPrivatePortsCount	integer (int32)		Número de puertos privados asignados a esta aplicación. Estos se asignarán dinámicamente en tiempo de ejecución.
vnetRouteAllEnabled	boolean		Virtual Network Enrutar todo habilitado. Esto hace que todo el tráfico saliente tenga aplicados grupos de seguridad de red virtual y rutas definidas por el usuario.
webSocketsEnabled	boolean		true si WebSocket está habilitado; de lo contrario, false.
websiteTimeZone	string		Establece la zona horaria que usa un sitio para generar marcas de tiempo. Compatible con Linux y Windows App Service. Establecer la configuración de WEBSITE_TIME_ZONE aplicación tiene prioridad sobre esta configuración. Para Linux, espera valores de base de datos tz https://www.iana.org/time-zones (para obtener una referencia rápida, consulte https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). Para Windows, espera una de las zonas horarias enumeradas en HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones
windowsFxVersion	string		Xenon App Framework y versión
xManagedServiceIdentityId	integer (int32)		Identificador explícito de Identidad de servicio administrada

SiteDnsConfig

Object

Nombre	Tipo	Description
dnsAltServer	string	Servidor DNS alternativo que usarán las aplicaciones. Esta propiedad replica la configuración de la aplicación WEBSITE_DNS_ALT_SERVER.
dnsLegacySortOrder	boolean	Indica que los sitios que usan servidores DNS personalizados de red virtual siguen ordenando la lista de servidores DNS. Solo lectura.
dnsMaxCacheTimeout	integer (int32)	Tiempo personalizado para que DNS se almacene en caché en segundos. Intervalo permitido: 0-60. El valor predeterminado es 30 segundos. 0 significa el almacenamiento en caché deshabilitado.
dnsRetryAttemptCount	integer (int32)	Número total de reintentos para la búsqueda dns. Intervalo permitido: 1-5. El valor predeterminado es 3.
dnsRetryAttemptTimeout	integer (int32)	Tiempo de espera de una sola búsqueda dns en segundos. Intervalo permitido: 1-30. El valor predeterminado es 3.
dnsServers	string[]	Lista de servidores DNS personalizados que va a usar una aplicación para búsquedas. Se pueden establecer 5 servidores DNS como máximo.

SiteLimits

Object

Límites de métricas establecidos en una aplicación.

Nombre	Tipo	Description
maxDiskSizeInMb	integer (int64)	Uso máximo permitido del tamaño del disco en MB.
maxMemoryInMb	integer (int64)	Uso máximo permitido de memoria en MB.
maxPercentageCpu	number (double)	Porcentaje máximo permitido de uso de CPU.

SiteLoadBalancing

Enumeración

Equilibrio de carga del sitio.

Valor	Description
LeastRequests
LeastRequestsWithTieBreaker
LeastResponseTime
PerSiteRoundRobin
RequestHash
WeightedRoundRobin
WeightedTotalTraffic

SiteMachineKey

Object

MachineKey de una aplicación.

Nombre	Tipo	Description
decryption	string	Algoritmo usado para el descifrado.
decryptionKey	string	Clave de descifrado.
validation	string	Validación de MachineKey.
validationKey	string	Clave de validación.

SlotSwapStatus

Object

Estado de la última operación de intercambio de ranura correcta.

Nombre	Tipo	Description
destinationSlotName	string	Ranura de destino de la última operación de intercambio.
sourceSlotName	string	Ranura de origen de la última operación de intercambio.
timestampUtc	string (date-time)	Hora en que se completó el último intercambio de ranura correcto.

SlowRequestsBasedTrigger

Object

Desencadenador basado en el tiempo de ejecución de la solicitud.

Nombre	Tipo	Description
count	integer (int32)	Recuento de solicitudes.
path	string	Ruta de acceso de solicitud.
timeInterval	string	Intervalo de tiempo.
timeTaken	string	Tiempo necesario.

SslState

Enumeración

Tipo SSL

Valor	Description
Disabled
IpBasedEnabled
SniEnabled

StatusCodesBasedTrigger

Object

Desencadenador basado en el código de estado.

Nombre	Tipo	Description
count	integer (int32)	Recuento de solicitudes.
path	string	Ruta de acceso de solicitud
status	integer (int32)	Código de estado HTTP.
subStatus	integer (int32)	Solicitar subestado.
timeInterval	string	Intervalo de tiempo.
win32Status	integer (int32)	Código de error win32.

StatusCodesRangeBasedTrigger

Object

Desencadenador basado en el intervalo de códigos de estado.

Nombre	Tipo	Description
count	integer (int32)	Recuento de solicitudes.
path	string
statusCodes	string	Código de estado HTTP.
timeInterval	string	Intervalo de tiempo.

Storage

Object

Almacenamiento para el paquete implementado usado por la aplicación de funciones.

Nombre	Tipo	Description
authentication	Authentication	Método de autenticación para acceder a la cuenta de almacenamiento para la implementación.
type	FunctionsDeploymentStorageType	Propiedad para seleccionar el tipo de Azure Storage. Opciones disponibles: blobContainer.
value	string (uri)	Propiedad para establecer la dirección URL del tipo de Azure Storage seleccionado. Ejemplo: para blobContainer, el valor podría ser https://.blob.core.windows.net/.

SupportedTlsVersions

Enumeración

MinTlsVersion: configura la versión mínima de TLS necesaria para las solicitudes SSL.

Valor	Description
1.0
1.1
1.2
1.3

TlsCipherSuites

Enumeración

Conjunto de cifrado TLS de intensidad mínima permitido para una aplicación

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

Triggers

Object

Configuración de escalado y simultaneidad para los desencadenadores de la aplicación de funciones.

Nombre	Tipo	Description
http	Http	Configuración de escalado y simultaneidad para el desencadenador HTTP.

UsageState

Enumeración

Estado que indica si la aplicación ha superado su uso de cuota. Solo lectura.

Valor	Description
Exceeded
Normal

userAssignedIdentity

Object

Identidad asignada por el usuario.

Nombre	Tipo	Description
clientId	string	Identificador de cliente de la identidad asignada por el usuario
principalId	string	Identificador de entidad de seguridad de la identidad asignada por el usuario

VirtualApplication

Object

Aplicación virtual en una aplicación.

Nombre	Tipo	Description
physicalPath	string	Ruta de acceso física.
preloadEnabled	boolean	true si la precarga está habilitada; de lo contrario, false.
virtualDirectories	VirtualDirectory[]	Directorios virtuales para la aplicación virtual.
virtualPath	string	Ruta de acceso virtual.

VirtualDirectory

Object

Directorio de la aplicación virtual.

Nombre	Tipo	Description
physicalPath	string	Ruta de acceso física.
virtualPath	string	Ruta de acceso a la aplicación virtual.