App Service Plans - List
Description pour Obtenir tous les plans App Service d’un abonnement.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Web/serverfarms?api-version=2023-12-01
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Web/serverfarms?detailed={detailed}&api-version=2023-12-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
subscription
|
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 |
detailed
|
query |
boolean |
Spécifiez |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Ok |
|
Other Status Codes |
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
List App Service plans
Sample Request
GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.Web/serverfarms?api-version=2023-12-01
Sample Response
{
"value": [
{
"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,
"numberOfWorkers": 19,
"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
}
},
{
"id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/testsf7252",
"name": "testsf7252",
"type": "Microsoft.Web/serverfarms",
"kind": "app",
"location": "East US",
"properties": {
"status": "Ready",
"maximumNumberOfWorkers": 20,
"numberOfWorkers": 19,
"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 |
---|---|
App |
Plan App Service. |
App |
Collection de plans App Service. |
Capability |
Décrit les fonctionnalités autorisées pour une référence SKU spécifique. |
Default |
App Service réponse d’erreur. |
Details | |
Error |
Modèle d’erreur. |
Extended |
Emplacement étendu. |
Hosting |
Spécification d’un App Service Environment à utiliser pour cette ressource. |
Kube |
Spécification d’un environnement Kubernetes à utiliser pour cette ressource. |
Provisioning |
État d’approvisionnement du plan de App Service. |
Sku |
Description des options de mise à l’échelle du plan App Service. |
Sku |
Description d’une référence SKU pour une ressource évolutive. |
Status |
App Service status de plan. |
AppServicePlan
Plan App Service.
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
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 ServerFarm é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 |
Spécification du App Service Environment à utiliser pour le plan App Service. |
||
properties.hyperV |
boolean |
False |
Si vous prévoyez |
properties.isSpot |
boolean |
Si |
|
properties.isXenon |
boolean |
False |
Obsolète : si le plan |
properties.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 App Service. |
|
properties.perSiteScaling |
boolean |
False |
Si |
properties.provisioningState |
État d’approvisionnement du plan de App Service. |
||
properties.reserved |
boolean |
False |
Si le service d’application Linux plane |
properties.resourceGroup |
string |
Groupe de ressources du plan App Service. |
|
properties.spotExpirationTime |
string |
Heure à laquelle la batterie de serveurs expire. Valide uniquement s’il s’agit d’une batterie de serveurs spot. |
|
properties.status |
App Service status de plan. |
||
properties.subscription |
string |
App Service abonnement au plan. |
|
properties.targetWorkerCount |
integer |
Mise à l’échelle du nombre de workers. |
|
properties.targetWorkerSizeId |
integer |
Mise à l’échelle de l’ID de taille de worker. |
|
properties.workerTierName |
string |
Niveau Worker cible affecté au plan App Service. |
|
properties.zoneRedundant |
boolean |
False |
Si |
sku |
Description d’une référence SKU pour une ressource évolutive. |
||
tags |
object |
Balises de ressource. |
|
type |
string |
Type de ressource. |
AppServicePlanCollection
Collection de plans App Service.
Nom | Type | Description |
---|---|---|
nextLink |
string |
Lien vers la page suivante de ressources. |
value |
Collection de ressources. |
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 |
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 |
Plus d’informations sur l’erreur de débogage. |
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 de 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 par défaut de workers 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 évolutive.
Nom | Type | Description |
---|---|---|
capabilities |
Les fonctionnalités de la référence SKU, par exemple, le gestionnaire de trafic 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 |
Valeurs d’échelle min, max 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 status de plan.
Nom | Type | Description |
---|---|---|
Creating |
string |
|
Pending |
string |
|
Ready |
string |