App Service Plans - Get

Szolgáltatás:: App Service

API-verzió:: 2025-05-01

A Get a App Service csomag leírása.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
name	path	True	string	Az alkalmazásszolgáltatási terv neve.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Válaszok

Name	Típus	Description
200 OK	AppServicePlan	Az Azure-művelet sikeresen befejeződött.
404 Not Found		A kiszolgáló nem találja a kért erőforrást.
Other Status Codes	DefaultErrorResponse	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

Get App Service plan

Mintakérelem

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


/**
 * Samples for AppServicePlans GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file: 2025-05-01/GetAppServicePlan.json
     */
    /**
     * Sample code: Get App Service plan.
     * 
     * @param manager Entry point to AppServiceManager.
     */
    public static void getAppServicePlan(com.azure.resourcemanager.appservice.AppServiceManager manager) {
        manager.serviceClient().getAppServicePlans().getByResourceGroupWithResponse("testrg123", "testsf6141",
            com.azure.core.util.Context.NONE);
    }
}

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

package armappservice_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/appservice/armappservice/v6"
)

// Generated from example definition: 2025-05-01/GetAppServicePlan.json
func ExamplePlansClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armappservice.NewClientFactory("34adfa4f-cedf-4dc0-ba29-b6d1a69ab345", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewPlansClient().Get(ctx, "testrg123", "testsf6141", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armappservice.PlansClientGetResponse{
	// 	Plan: &armappservice.Plan{
	// 		Name: to.Ptr("testsf6141"),
	// 		Type: to.Ptr("Microsoft.Web/serverfarms"),
	// 		ID: to.Ptr("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/testsf6141"),
	// 		Kind: to.Ptr("app"),
	// 		Location: to.Ptr("East US"),
	// 		Properties: &armappservice.PlanProperties{
	// 			GeoRegion: to.Ptr("East US"),
	// 			IsSpot: to.Ptr(false),
	// 			MaximumNumberOfWorkers: to.Ptr[int32](20),
	// 			NumberOfSites: to.Ptr[int32](4),
	// 			NumberOfWorkers: to.Ptr[int32](19),
	// 			ProvisioningState: to.Ptr(armappservice.ProvisioningStateSucceeded),
	// 			Reserved: to.Ptr(false),
	// 			Status: to.Ptr(armappservice.StatusOptionsReady),
	// 			TargetWorkerCount: to.Ptr[int32](0),
	// 			TargetWorkerSizeID: to.Ptr[int32](0),
	// 		},
	// 		SKU: &armappservice.SKUDescription{
	// 			Name: to.Ptr("P1"),
	// 			Capacity: to.Ptr[int32](1),
	// 			Family: to.Ptr("P"),
	// 			Size: to.Ptr("P1"),
	// 			Tier: to.Ptr("Premium"),
	// 		},
	// 	},
	// }
}

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

Mintaválasz

Állapotkód:: 200

{
  "name": "testsf6141",
  "type": "Microsoft.Web/serverfarms",
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.Web/serverfarms/testsf6141",
  "kind": "app",
  "location": "East US",
  "properties": {
    "geoRegion": "East US",
    "isSpot": false,
    "maximumNumberOfWorkers": 20,
    "numberOfSites": 4,
    "numberOfWorkers": 19,
    "provisioningState": "Succeeded",
    "reserved": false,
    "status": "Ready",
    "targetWorkerCount": 0,
    "targetWorkerSizeId": 0
  },
  "sku": {
    "name": "P1",
    "capacity": 1,
    "family": "P",
    "size": "P1",
    "tier": "Premium"
  }
}

Állapotkód:: 404

Definíciók

Name	Description
AppServicePlan	App Service-csomag.
Capability	Ismerteti az adott termékváltozathoz engedélyezett képességeket/funkciókat.
createdByType	Az erőforrást létrehozó identitás típusa.
DefaultErrorResponse	App Service-hibaválasz.
DefaultErrorResponseError	Hibamodell.
DefaultErrorResponseErrorDetailsItem	Részletes hibák.
DefaultIdentity
ExtendedLocation	Kiterjesztett hely.
HostingEnvironmentProfile	Az erőforráshoz használandó App Service Environment specifikációja.
InstallScript	Kiszolgálófarm telepítési parancsfájl konfigurációja.
InstallScriptSource	A telepítési szkript referenciájának tartására szolgáló objektum.
InstallScriptType	A telepítési szkript típusa.
KeyVaultReferenceWithStatus	A kulcstartó hivatkozásának és a feloldási állapotnak a tárolására szolgáló objektum
KubeEnvironmentProfile	Az erőforráshoz használható Kubernetes-környezet specifikációja.
ManagedServiceIdentity	Felügyelt szolgáltatás identitása.
ManagedServiceIdentityType	A felügyelt szolgáltatás identitásának típusa.
ProvisioningState	Az App Service-csomag kiépítési állapota.
RegistryAdapter	Kiszolgálófarm beállításjegyzék-adapterének konfigurálása.
RegistryAdapterType	A beállításjegyzék-adapter típusa.
ServerFarmNetworkSettings	App Service csomag hálózati beállításai.
SkuCapacity	A App Service csomag méretezési beállításainak leírása.
SkuDescription	Egy méretezhető erőforrás termékváltozatának leírása.
StatusOptions	App Service csomag állapota.
StorageMount	Kiszolgálófarm tárolójának csatlakoztatásának konfigurációja.
StorageMountType	A tárolótartó típusa.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
UserAssignedIdentity	Felhasználó által hozzárendelt identitás.

AppServicePlan

Tárgy

App Service-csomag.

Name	Típus	Description
extendedLocation	ExtendedLocation	Kiterjesztett hely.
id	string (arm-id)	Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Felügyelt szolgáltatás identitása.
kind	string	Erőforrás típusa. Ha az erőforrás egy alkalmazás, a https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference a természetben támogatott értékek részleteiért tekintse meg.
location	string	Az a földrajzi hely, ahol az erőforrás él
name	string	Az erőforrás neve
properties.asyncScalingEnabled	boolean	Ha `true`, ez a App Service csomag aszinkron skálázást tesz lehetővé, ha nincs elegendő feldolgozó a szinkron skálázáshoz. Ha `false`, ez a App Service csomag csak a szinkronizálási skálázást kísérli meg.
properties.elasticScaleEnabled	boolean	A ServerFarm támogatja az ElasticScale-et. Az ebben a csomagban lévő alkalmazások úgy fognak skálázni, mintha a ServerFarm ElasticPremium termékváltozata lett volna
properties.freeOfferExpirationTime	string (date-time)	A kiszolgálófarm ingyenes ajánlatának lejárati ideje.
properties.geoRegion	string	A App Service csomag földrajzi helye.
properties.hostingEnvironmentProfile	HostingEnvironmentProfile	Az App Service-csomaghoz használandó App Service-környezet specifikációja.
properties.hyperV	boolean	Ha Hyper-V tároló App Service-csomag, `true`ellenkező `false` esetben.
properties.installScripts	InstallScript[]	Telepítse a App Service csomaghoz társított szkripteket.
properties.isCustomMode	boolean	A kiszolgálófarm egyéni módban van-e.
properties.isSpot	boolean	Ha `true`, ez a App Service csomag kihasználatlan példányok tulajdonosa.
properties.isXenon	boolean	Elavult: Ha Hyper-V tároló App Service csomag, `truefalse` ellenkező esetben.
properties.kubeEnvironmentProfile	KubeEnvironmentProfile	Az App Service-csomaghoz használandó Kubernetes-környezet specifikációja.
properties.maximumElasticWorkerCount	integer (int32)	Az ElasticScaleEnabled App Service-csomaghoz engedélyezett összes feldolgozó maximális száma
properties.maximumNumberOfWorkers	integer (int32)	A App Service csomaghoz hozzárendelhető példányok maximális száma.
properties.network	ServerFarmNetworkSettings	A kiszolgálófarm összes hálózati beállítása.
properties.numberOfSites	integer (int32)	A App Service csomaghoz rendelt alkalmazások száma.
properties.numberOfWorkers	integer (int32)	A App Service csomaghoz rendelt példányok száma.
properties.perSiteScaling	boolean	Ha `true`a App Service csomaghoz rendelt alkalmazások egymástól függetlenül skálázhatók. Ha `false`, az ehhez a App Service csomaghoz rendelt alkalmazások a csomag összes példányára skálázhatók.
properties.planDefaultIdentity	DefaultIdentity	A felügyelt identitást használó különböző funkciókhoz és integrációkhoz platformonként használható identitás.
properties.provisioningState	ProvisioningState	Az App Service-csomag kiépítési állapota.
properties.rdpEnabled	boolean	Ha `true`az RDP-hozzáférés engedélyezve van ehhez a App Service csomaghoz. Csak az IsCustomMode ASP-k esetében alkalmazható. Ha `false`az RDP-hozzáférés le van tiltva.
properties.registryAdapters	RegistryAdapter[]	A App Service csomaghoz társított beállításjegyzék-adapterek.
properties.reserved	boolean	Ha Linux App Service terv `true`, `false` ellenkező esetben.
properties.resourceGroup	string	A App Service csomag erőforráscsoportja.
properties.spotExpirationTime	string (date-time)	A kiszolgálófarm lejárati ideje. Csak akkor érvényes, ha az egy kihasználatlan kiszolgálófarm.
properties.status	StatusOptions	App Service csomag állapota.
properties.storageMounts	StorageMount[]	A App Service csomaghoz társított tárcsatlakoztatások.
properties.subscription	string	App Service csomag-előfizetés.
properties.targetWorkerCount	integer (int32)	Feldolgozók számának skálázása.
properties.targetWorkerSizeId	integer (int32)	Feldolgozó méretazonosítója skálázása.
properties.workerTierName	string	Az App Service-csomaghoz rendelt célmunkaréteg.
properties.zoneRedundant	boolean	Ha `true`, ez a App Service csomag a rendelkezésre állási zónák kiegyensúlyozását végzi. Ha `false`, ez a App Service csomag nem hajtja végre a rendelkezésre állási zóna kiegyensúlyozását.
sku	SkuDescription	Egy méretezhető erőforrás termékváltozatának leírása.
systemData	systemData	A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.
tags	object	Erőforráscímkék.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

Capability

Tárgy

Ismerteti az adott termékváltozathoz engedélyezett képességeket/funkciókat.

Name	Típus	Description
name	string	Az SKU-képesség neve.
reason	string	Az SKU-képesség oka.
value	string	Az SKU-képesség értéke.

createdByType

Felsorolás

Az erőforrást létrehozó identitás típusa.

Érték	Description
User
Application
ManagedIdentity
Key

DefaultErrorResponse

Tárgy

App Service-hibaválasz.

Name	Típus	Description
error	DefaultErrorResponseError	Hibamodell.

DefaultErrorResponseError

Tárgy

Hibamodell.

Name	Típus	Description
code	string	Szabványosított sztring a hiba programozott azonosításához.
details	DefaultErrorResponseErrorDetailsItem[]	Részletes hibák.
innererror	string	További információ a hiba hibakereséséről.
message	string	Részletes hibaleírás és hibakeresési információk.
target	string	Részletes hibaleírás és hibakeresési információk.

DefaultErrorResponseErrorDetailsItem

Tárgy

Részletes hibák.

Name	Típus	Description
code	string	Szabványosított sztring a hiba programozott azonosításához.
message	string	Részletes hibaleírás és hibakeresési információk.
target	string	Részletes hibaleírás és hibakeresési információk.

DefaultIdentity

Tárgy

Name	Típus	Description
identityType	ManagedServiceIdentityType	A felügyelt szolgáltatás identitásának típusa.
userAssignedIdentityResourceId	string

ExtendedLocation

Tárgy

Kiterjesztett hely.

Name	Típus	Description
name	string	A kiterjesztett hely neve.
type	string	A kiterjesztett hely típusa.

HostingEnvironmentProfile

Tárgy

Az erőforráshoz használandó App Service Environment specifikációja.

Name	Típus	Description
id	string	Az App Service-környezet erőforrás-azonosítója.
name	string	Az App Service-környezet neve.
type	string	A App Service Environment erőforrástípusa.

InstallScript

Tárgy

Kiszolgálófarm telepítési parancsfájl konfigurációja.

Name	Típus	Description
name	string	A telepítési szkript neve.
source	InstallScriptSource	A telepítési szkript forrása.

InstallScriptSource

Tárgy

A telepítési szkript referenciájának tartására szolgáló objektum.

Name	Típus	Description
sourceUri	string	Telepítse a szkriptforrás URI-ját, ahonnan a telepítési szkriptfájl lekérhető.
type	InstallScriptType	A telepítési szkript típusa.

InstallScriptType

Felsorolás

A telepítési szkript típusa.

Érték	Description
RemoteAzureBlob
PlatformStorage

KeyVaultReferenceWithStatus

Tárgy

A kulcstartó hivatkozásának és a feloldási állapotnak a tárolására szolgáló objektum

Name	Típus	Description
referenceStatus	string	A kulcstartó titkos kulcsának referenciaállapota.
secretUri	string	Key Vault titkos URI-ja.

KubeEnvironmentProfile

Tárgy

Az erőforráshoz használható Kubernetes-környezet specifikációja.

Name	Típus	Description
id	string	A Kubernetes-környezet erőforrás-azonosítója.
name	string	A Kubernetes-környezet neve.
type	string	A Kubernetes-környezet erőforrástípusa.

ManagedServiceIdentity

Tárgy

Felügyelt szolgáltatás identitása.

Name	Típus	Description
principalId	string	A felügyelt szolgáltatás identitásának egyszerű azonosítója.
tenantId	string	A felügyelt szolgáltatás identitásának bérlője.
type	ManagedServiceIdentityType	A felügyelt szolgáltatás identitásának típusa.
userAssignedIdentities	<string, UserAssignedIdentity>	Az erőforráshoz társított felhasználó által hozzárendelt identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai arm-erőforrás-azonosítók lesznek az űrlapon: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}

ManagedServiceIdentityType

Felsorolás

A felügyelt szolgáltatás identitásának típusa.

Érték	Description
SystemAssigned
UserAssigned
SystemAssigned, UserAssigned
None

ProvisioningState

Felsorolás

Az App Service-csomag kiépítési állapota.

Érték	Description
Succeeded
Failed
Canceled
InProgress
Deleting

RegistryAdapter

Tárgy

Kiszolgálófarm beállításjegyzék-adapterének konfigurálása.

Name	Típus	Description
keyVaultSecretReference	KeyVaultReferenceWithStatus	Key Vault hivatkozás a beállításjegyzék helyére helyezett értékre
registryKey	string	Az adapter beállításkulcsa.
type	RegistryAdapterType	A beállításjegyzék-adapter típusa.

RegistryAdapterType

Felsorolás

A beállításjegyzék-adapter típusa.

Érték	Description
Binary
String
Expand_String
Multi_String
DWord
QWord

ServerFarmNetworkSettings

Tárgy

App Service csomag hálózati beállításai.

Name	Típus	Description
virtualNetworkSubnetId	string	A regionális VNET-integrációhoz csatlakoztatandó virtuális hálózat és alhálózat Azure Resource Manager-azonosítója. Ennek /subscriptions/{subscriptionName}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName} formában kell lennie.

SkuCapacity

Tárgy

A App Service csomag méretezési beállításainak leírása.

Name	Típus	Description
default	integer (int32)	Az App Service-csomag termékváltozatához tartozó feldolgozók alapértelmezett száma.
elasticMaximum	integer (int32)	Az App Service-csomag termékváltozatához tartozó rugalmas feldolgozók maximális száma.
maximum	integer (int32)	Az App Service-csomag termékváltozatához tartozó feldolgozók maximális száma.
minimum	integer (int32)	Az App Service-csomag termékváltozatának minimális száma.
scaleType	string	App Service-csomagokhoz elérhető méretezési konfigurációk.

SkuDescription

Tárgy

Egy méretezhető erőforrás termékváltozatának leírása.

Name	Típus	Description
capabilities	Capability[]	A termékváltozat képességei, például a Traffic Manager engedélyezve van?
capacity	integer (int32)	Az erőforráshoz rendelt példányok aktuális száma.
family	string	Az erőforrás termékváltozatának családi kódja.
locations	string[]	A termékváltozat helyei.
name	string	Az erőforrás termékváltozatának neve.
size	string	Az erőforrás-termékváltozat méretkijelölője.
skuCapacity	SkuCapacity	A termékváltozat minimális, maximális és alapértelmezett méretezési értékei.
tier	string	Az erőforrás-termékváltozat szolgáltatási szintje.

StatusOptions

Felsorolás

App Service csomag állapota.

Érték	Description
Ready
Pending
Creating

StorageMount

Tárgy

Kiszolgálófarm tárolójának csatlakoztatásának konfigurációja.

Name	Típus	Description
credentialsKeyVaultReference	KeyVaultReferenceWithStatus	KV hivatkozás a megosztáshoz való csatlakozáshoz szükséges hitelesítő adatokra.
destinationPath	string	A feldolgozó elérési útja, ahová a tároló csatlakoztatva lesz.
name	string	A tárolótartó neve.
source	string	A fájlmegosztás/tároló forrása.
type	StorageMountType	A tárolótartó típusa.

StorageMountType

Felsorolás

A tárolótartó típusa.

Érték	Description
AzureFiles
LocalStorage
FileShare

systemData

Tárgy

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

UserAssignedIdentity

Tárgy

Felhasználó által hozzárendelt identitás.

Name	Típus	Description
clientId	string	A felhasználó által hozzárendelt identitás ügyfélazonosítója
principalId	string	A felhasználó által hozzárendelt identitás egyszerű azonosítója

Megosztás a következőn keresztül:

App Service Plans - Get

URI-paraméterek

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

Get App Service plan

Mintakérelem

Mintaválasz

Definíciók

AppServicePlan

Capability

createdByType

DefaultErrorResponse

DefaultErrorResponseError

DefaultErrorResponseErrorDetailsItem

DefaultIdentity

ExtendedLocation

HostingEnvironmentProfile

InstallScript

InstallScriptSource

InstallScriptType

KeyVaultReferenceWithStatus

KubeEnvironmentProfile

ManagedServiceIdentity

ManagedServiceIdentityType

ProvisioningState

RegistryAdapter

RegistryAdapterType

ServerFarmNetworkSettings

SkuCapacity

SkuDescription

StatusOptions

StorageMount

StorageMountType

systemData

UserAssignedIdentity