Share via

App Service Plans - Create Or Update

  • Référence
Service:
App Service
API Version:
2023-12-01

Description de La création ou de la mise à jour d’un plan d’App Service.

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

Paramètres URI

Nom Dans Obligatoire Type Description
name
 path True

string

Nom du plan App Service.
resourceGroupName
 path True

string

Nom du groupe de ressources auquel appartient la ressource.

Regex pattern: ^[-\w\._\(\)]+[^\.]$
subscriptionId
 path True

string

Votre ID d’abonnement Azure. Il s’agit d’une chaîne au format GUID (par exemple, 000000-0000-0000-0000-000000000000000).
api-version
 query True

string

Version d'API

Corps de la demande

Nom Obligatoire Type Description
location True

string

Emplacement de la ressource.
extendedLocation

ExtendedLocation

Emplacement étendu.
kind

string

Type de ressource.
properties.elasticScaleEnabled

boolean

ServerFarm prend en charge ElasticScale. Les applications de ce plan sont mises à l’échelle comme si la référence SKU ServerFarmium était ElasticPremium
properties.freeOfferExpirationTime

string

Heure à laquelle l’offre gratuite de batterie de serveurs expire.
properties.hostingEnvironmentProfile

HostingEnvironmentProfile

Spécification du App Service Environment à utiliser pour le plan App Service.
properties.hyperV

boolean

Si le plan trueDe service d’application de conteneur Hyper-V est , false sinon.
properties.isSpot

boolean

Si truela valeur est , cette App Service Plan possède des instances spot.
properties.isXenon

boolean

Obsolète : si le plan App Service de conteneur Hyper-V est , truefalse sinon.
properties.kubeEnvironmentProfile

KubeEnvironmentProfile

Spécification de l’environnement Kubernetes à utiliser pour le plan App Service.
properties.maximumElasticWorkerCount

integer

Nombre maximal de workers autorisés pour ce plan de App Service ElasticScaleEnabled
properties.perSiteScaling

boolean

Si la valeur est true, les applications affectées à ce plan App Service peuvent être mises à l’échelle indépendamment. Si falsela valeur est , les applications affectées à ce plan App Service seront mises à l’échelle pour toutes les instances du plan.
properties.reserved

boolean

Si le plan trueApp Service Linux est , false sinon.
properties.spotExpirationTime

string

Heure d’expiration de la batterie de serveurs. Valide uniquement s’il s’agit d’une batterie de serveurs spot.
properties.targetWorkerCount

integer

Mise à l’échelle du nombre de workers.
properties.targetWorkerSizeId

integer

Mise à l’échelle de l’ID de taille du worker.
properties.workerTierName

string

Niveau Worker cible affecté au plan App Service.
properties.zoneRedundant

boolean

Si truela valeur est , cette App Service Plan effectue l’équilibrage de zone de disponibilité. Si false, ce plan App Service n’effectue pas l’équilibrage des zones de disponibilité.
sku

SkuDescription

Description d’une référence SKU pour une ressource scalable.
tags

object

Balises de ressource.

Réponses

Nom Type Description
200 OK

AppServicePlan

OK.
202 Accepted

AppServicePlan

L’opération est en cours.
Other Status Codes

DefaultErrorResponse

App Service réponse d’erreur.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

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

Scopes

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

Create Or Update App Service plan

Sample Request

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/testsf6141?api-version=2023-12-01

{
  "kind": "app",
  "location": "East US",
  "properties": {},
  "sku": {
    "name": "P1",
    "tier": "Premium",
    "size": "P1",
    "family": "P",
    "capacity": 1
  }
}

Sample Response

Status code:
200 
{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/testsf6141",
  "name": "testsf6141",
  "type": "Microsoft.Web/serverfarms",
  "kind": "app",
  "location": "East US",
  "properties": {
    "status": "Ready",
    "maximumNumberOfWorkers": 20,
    "geoRegion": "East US",
    "numberOfSites": 4,
    "reserved": false,
    "targetWorkerCount": 0,
    "targetWorkerSizeId": 0,
    "provisioningState": "Succeeded"
  },
  "sku": {
    "name": "P1",
    "tier": "Premium",
    "size": "P1",
    "family": "P",
    "capacity": 1
  }
}
Status code:
202 
location: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/testsf6141/operationresults/F0C6B8EC-0D53-432C-913B-1CD9E8CDE3A0
azure-asyncoperation: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/testsf6141/operationresults/F0C6B8EC-0D53-432C-913B-1CD9E8CDE3A0
Response Body
{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/testsf6141",
  "name": "testsf6141",
  "type": "Microsoft.Web/serverfarms",
  "kind": "app",
  "location": "East US",
  "properties": {
    "status": "Ready",
    "maximumNumberOfWorkers": 20,
    "geoRegion": "East US",
    "numberOfSites": 4,
    "isSpot": false,
    "reserved": false,
    "targetWorkerCount": 0,
    "targetWorkerSizeId": 0,
    "provisioningState": "Succeeded"
  },
  "sku": {
    "name": "P1",
    "tier": "Premium",
    "size": "P1",
    "family": "P",
    "capacity": 1
  }
}

Définitions

Nom Description
AppServicePlan

Plan App Service.
Capability

Décrit les fonctionnalités autorisées pour une référence SKU spécifique.
DefaultErrorResponse

App Service réponse d’erreur.
Details
Error

Modèle d’erreur.
ExtendedLocation

Emplacement étendu.
HostingEnvironmentProfile

Spécification d’un App Service Environment à utiliser pour cette ressource.
KubeEnvironmentProfile

Spécification d’un environnement Kubernetes à utiliser pour cette ressource.
ProvisioningState

État d’approvisionnement du plan App Service.
SkuCapacity

Description des options de mise à l’échelle du plan App Service.
SkuDescription

Description d’une référence SKU pour une ressource scalable.
StatusOptions

App Service plan status.

AppServicePlan

Plan App Service.

Nom Type Valeur par défaut Description
extendedLocation

ExtendedLocation

Emplacement étendu.
id

string

ID de ressource.
kind

string

Type de ressource.
location

string

Emplacement de la ressource.
name

string

Nom de la ressource.
properties.elasticScaleEnabled

boolean

ServerFarm prend en charge ElasticScale. Les applications de ce plan sont mises à l’échelle comme si la référence SKU ServerFarmium était ElasticPremium
properties.freeOfferExpirationTime

string

Heure à laquelle l’offre gratuite de batterie de serveurs expire.
properties.geoRegion

string

Emplacement géographique du plan App Service.
properties.hostingEnvironmentProfile

HostingEnvironmentProfile

Spécification du App Service Environment à utiliser pour le plan App Service.
properties.hyperV

boolean

False

Si le plan trueDe service d’application de conteneur Hyper-V est , false sinon.
properties.isSpot

boolean

Si truela valeur est , cette App Service Plan possède des instances spot.
properties.isXenon

boolean

False

Obsolète : si le plan App Service de conteneur Hyper-V est , truefalse sinon.
properties.kubeEnvironmentProfile

KubeEnvironmentProfile

Spécification de l’environnement Kubernetes à utiliser pour le plan App Service.
properties.maximumElasticWorkerCount

integer

Nombre maximal de workers autorisés pour ce plan de App Service ElasticScaleEnabled
properties.maximumNumberOfWorkers

integer

Nombre maximal d’instances pouvant être affectées à ce plan App Service.
properties.numberOfSites

integer

Nombre d’applications affectées à ce plan App Service.
properties.numberOfWorkers

integer

Nombre d’instances affectées à ce plan de App Service.
properties.perSiteScaling

boolean

False

Si la valeur est true, les applications affectées à ce plan App Service peuvent être mises à l’échelle indépendamment. Si falsela valeur est , les applications affectées à ce plan App Service seront mises à l’échelle pour toutes les instances du plan.
properties.provisioningState

ProvisioningState

État d’approvisionnement du plan App Service.
properties.reserved

boolean

False

Si le plan trueApp Service Linux est , false sinon.
properties.resourceGroup

string

Groupe de ressources du plan App Service.
properties.spotExpirationTime

string

Heure d’expiration de la batterie de serveurs. Valide uniquement s’il s’agit d’une batterie de serveurs spot.
properties.status

StatusOptions

App Service plan status.
properties.subscription

string

abonnement App Service plan.
properties.targetWorkerCount

integer

Mise à l’échelle du nombre de workers.
properties.targetWorkerSizeId

integer

Mise à l’échelle de l’ID de taille du worker.
properties.workerTierName

string

Niveau Worker cible affecté au plan App Service.
properties.zoneRedundant

boolean

False

Si truela valeur est , cette App Service Plan effectue l’équilibrage de zone de disponibilité. Si falsela valeur est , cette App Service Plan n’effectue pas d’équilibrage de zone de disponibilité.
sku

SkuDescription

Description d’une référence SKU pour une ressource scalable.
tags

object

Balises de ressource.
type

string

Type de ressource.

Capability

Décrit les fonctionnalités autorisées pour une référence SKU spécifique.

Nom Type Description
name

string

Nom de la fonctionnalité de référence SKU.
reason

string

Raison de la fonctionnalité de référence SKU.
value

string

Valeur de la fonctionnalité de référence SKU.

DefaultErrorResponse

App Service réponse d’erreur.

Nom Type Description
error

Error

Modèle d’erreur.

Details

Nom Type Description
code

string

Chaîne standardisée pour identifier l’erreur par programmation.
message

string

Description détaillée de l’erreur et informations de débogage.
target

string

Description détaillée de l’erreur et informations de débogage.

Error

Modèle d’erreur.

Nom Type Description
code

string

Chaîne standardisée pour identifier l’erreur par programmation.
details

Details[]

Erreurs détaillées.
innererror

string

Informations supplémentaires pour déboguer l’erreur.
message

string

Description détaillée de l’erreur et informations de débogage.
target

string

Description détaillée de l’erreur et informations de débogage.

ExtendedLocation

Emplacement étendu.

Nom Type Description
name

string

Nom de l’emplacement étendu.
type

string

Type d’emplacement étendu.

HostingEnvironmentProfile

Spécification d’un App Service Environment à utiliser pour cette ressource.

Nom Type Description
id

string

ID de ressource du App Service Environment.
name

string

Nom du App Service Environment.
type

string

Type de ressource du App Service Environment.

KubeEnvironmentProfile

Spécification d’un environnement Kubernetes à utiliser pour cette ressource.

Nom Type Description
id

string

ID de ressource de l’environnement Kubernetes.
name

string

Nom de l’environnement Kubernetes.
type

string

Type de ressource de l’environnement Kubernetes.

ProvisioningState

État d’approvisionnement du plan App Service.

Nom Type Description
Canceled

string

Deleting

string

Failed

string

InProgress

string

Succeeded

string

SkuCapacity

Description des options de mise à l’échelle du plan App Service.

Nom Type Description
default

integer

Nombre de workers par défaut pour cette référence SKU de plan App Service.
elasticMaximum

integer

Nombre maximal de workers élastiques pour cette référence SKU de plan App Service.
maximum

integer

Nombre maximal de workers pour cette référence SKU de plan App Service.
minimum

integer

Nombre minimal de workers pour cette référence SKU de plan App Service.
scaleType

string

Configurations de mise à l’échelle disponibles pour un plan App Service.

SkuDescription

Description d’une référence SKU pour une ressource scalable.

Nom Type Description
capabilities

Capability[]

Fonctionnalités de la référence SKU, par exemple, Traffic Manager est-il activé ?
capacity

integer

Nombre actuel d’instances affectées à la ressource.
family

string

Code de famille de la référence SKU de ressource.
locations

string[]

Emplacements de la référence SKU.
name

string

Nom de la référence SKU de ressource.
size

string

Spécificateur de taille de la référence SKU de ressource.
skuCapacity

SkuCapacity

Valeurs d’échelle minimales, maximales et par défaut de la référence SKU.
tier

string

Niveau de service de la référence SKU de ressource.

StatusOptions

App Service plan status.

Nom Type Description
Creating

string

Pending

string

Ready

string