Get Subscription Deployment Locations - Get Subscription Deployment Locations

Servizio:

App Service

Versione API:

2026-07-15

Descrizione per Ottiene l'elenco delle regioni geografiche disponibili più i ministamp

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Web/deploymentLocations?api-version=2026-07-15

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	DeploymentLocations	La richiesta ha avuto esito positivo.
Other Status Codes	DefaultErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	impersonare il tuo account utente

Definizioni

Nome	Descrizione
AppServiceEnvironment	Descrizione di un ambiente del servizio app.
AseV3NetworkingConfiguration	Visualizzazione completa della configurazione di rete per un ambiente del servizio app.
createdByType	Tipo di identità che ha creato la risorsa.
CustomDnsSuffixConfiguration	Visualizzazione completa della configurazione del suffisso di dominio personalizzato per ASEv3.
CustomDnsSuffixProvisioningState
DefaultErrorResponse	Risposta di errore del servizio app.
DefaultErrorResponseError	Modello di errore.
DefaultErrorResponseErrorDetailsItem	Errori dettagliati.
DeploymentLocations	Elenco delle posizioni disponibili (aree o ambienti del servizio app) per la distribuzione delle risorse del servizio app.
GeoRegion	Regione geografica.
HostingEnvironmentDeploymentInfo	Informazioni necessarie per creare risorse su un ambiente del servizio app.
HostingEnvironmentStatus	Stato attuale dell'ambiente del servizio app.
LoadBalancingMode	Specifica quali endpoint servire internamente nella Rete virtuale per l'ambiente del servizio app.
NameValuePair	Coppia nome-valore.
ProvisioningState	Stato di provisioning del piano di servizio app.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UpgradeAvailability	Se è disponibile un aggiornamento per questo ambiente del servizio app.
UpgradePreference	Preferenza aggiornamento
VirtualNetworkProfile	Specifica per l'utilizzo di una Rete virtuale.

AppServiceEnvironment

Oggetto

Descrizione di un ambiente del servizio app.

Nome	Tipo	Valore predefinito	Descrizione
clusterSettings	NameValuePair[]		Impostazioni personalizzate per modificare il comportamento dell'ambiente del servizio app.
customDnsSuffixConfiguration	CustomDnsSuffixConfiguration		Visualizzazione completa della configurazione del suffisso di dominio personalizzato per ASEv3.
dedicatedHostCount	integer (int32)		Numero host dedicato
dnsSuffix	string		Il suffisso DNS dell'ambiente del servizio app.
frontEndScaleFactor	integer (int32)		Fattore di scala per i front-end.
hasLinuxWorkers	boolean		Flag che indica se un ambiente del servizio app ha ruoli di lavoro Linux o meno
internalLoadBalancingMode	LoadBalancingMode		Specifica quali endpoint servire internamente nella Rete virtuale per l'ambiente del servizio app.
ipsslAddressCount	integer (int32)		Numero di indirizzi IP SSL riservati all'ambiente del servizio app.
maximumNumberOfMachines	integer (int32)		Numero massimo di VM nell'ambiente del servizio app.
multiRoleCount	integer (int32)		Numero di istanze front-end.
multiSize	string		Dimensioni della macchina virtuale front-end, ad esempio "Medium", "Large".
networkingConfiguration	AseV3NetworkingConfiguration		Visualizzazione completa della configurazione di rete per un ambiente del servizio app.
provisioningState	ProvisioningState		Stato di provisioning dell'ambiente del servizio app.
status	HostingEnvironmentStatus		Stato attuale dell'ambiente del servizio app.
suspended	boolean		true se la ambiente del servizio app è sospesa; altrimenti, false. L'ambiente può essere sospeso, ad esempio quando l'endpoint di gestione non è più disponibile (molto probabilmente perché il gruppo di sicurezza di rete ha bloccato il traffico in ingresso).
upgradeAvailability	UpgradeAvailability		Se è disponibile un aggiornamento per questo ambiente del servizio app.
upgradePreference	UpgradePreference	None	Preferenza aggiornamento
userWhitelistedIpRanges	string[]		Gli intervalli IP aggiunti dall'utente all'elenco elementi consentiti nel database dell'ambiente del servizio app
virtualNetwork	VirtualNetworkProfile		Descrizione della Rete virtuale.
zoneRedundant	boolean		Se questo ambiente del servizio app sia o meno ridondante per zona.

AseV3NetworkingConfiguration

Oggetto

Visualizzazione completa della configurazione di rete per un ambiente del servizio app.

Nome	Tipo	Descrizione
id	string (arm-id)	Identificatore di risorsa completamente qualificato per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Tipo di risorsa.
name	string	nome della risorsa.
properties.allowNewPrivateEndpointConnections	boolean	Proprietà per abilitare e disabilitare la creazione di una nuova connessione all'endpoint privato nell'ambiente del servizio app
properties.externalInboundIpAddresses	string[]
properties.ftpEnabled	boolean	Proprietà per abilitare e disabilitare FTP in ASEV3
properties.inboundIpAddressOverride	string	Indirizzo IP in ingresso fornito dal cliente. Solo in grado di essere impostato nella creazione dell'ambiente del servizio app.
properties.internalInboundIpAddresses	string[]
properties.linuxOutboundIpAddresses	string[]
properties.remoteDebugEnabled	boolean	Proprietà per abilitare e disabilitare il debug remoto in ASEV3
properties.windowsOutboundIpAddresses	string[]
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

CustomDnsSuffixConfiguration

Oggetto

Visualizzazione completa della configurazione del suffisso di dominio personalizzato per ASEv3.

Nome	Tipo	Descrizione
id	string (arm-id)	Identificatore di risorsa completamente qualificato per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
kind	string	Tipo di risorsa.
name	string	nome della risorsa.
properties.certificateUrl	string	L'URL che fa riferimento al segreto del certificato Azure Key Vault dovrebbe essere usato come certificato SSL/TLS predefinito per i siti con il suffisso di dominio personalizzato.
properties.dnsSuffix	string	Suffisso di dominio personalizzato predefinito da usare per tutti i siti distribuiti nell'ambiente del servizio app.
properties.keyVaultReferenceIdentity	string	Identità assegnata dall'utente da usare per risolvere il riferimento al certificato dell'insieme di credenziali delle chiavi. Se non specificato, l'identità dell'ambiente del servizio app assegnata dal sistema verrà usata, se disponibile.
properties.provisioningDetails	string
properties.provisioningState	CustomDnsSuffixProvisioningState
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

CustomDnsSuffixProvisioningState

Enumerazione

Valore	Descrizione
Succeeded
Failed
Degraded
InProgress

DefaultErrorResponse

Oggetto

Risposta di errore del servizio app.

Nome	Tipo	Descrizione
error	DefaultErrorResponseError	Modello di errore.

DefaultErrorResponseError

Oggetto

Modello di errore.

Nome	Tipo	Descrizione
code	string	Stringa standardizzata per identificare l'errore a livello di codice.
details	DefaultErrorResponseErrorDetailsItem[]	Errori dettagliati.
innererror	string	Ulteriori informazioni per eseguire il debug dell'errore.
message	string	Descrizione dettagliata dell'errore e informazioni di debug.
target	string	Descrizione dettagliata dell'errore e informazioni di debug.

DefaultErrorResponseErrorDetailsItem

Oggetto

Errori dettagliati.

Nome	Tipo	Descrizione
code	string	Stringa standardizzata per identificare l'errore a livello di codice.
message	string	Descrizione dettagliata dell'errore e informazioni di debug.
target	string	Descrizione dettagliata dell'errore e informazioni di debug.

DeploymentLocations

Oggetto

Elenco delle posizioni disponibili (aree o ambienti del servizio app) per la distribuzione delle risorse del servizio app.

Nome	Tipo	Descrizione
hostingEnvironmentDeploymentInfos	HostingEnvironmentDeploymentInfo[]	Ambienti del servizio app disponibili con informazioni di base.
hostingEnvironments	AppServiceEnvironment[]	Ambienti del servizio app disponibili con descrizioni complete degli ambienti.
locations	GeoRegion[]	Regioni disponibili.

GeoRegion

Oggetto

Regione geografica.

Nome	Tipo	Descrizione
id	string	ID risorsa.
kind	string	Tipo di risorsa.
name	string	Nome risorsa.
properties.description	string	Descrizione della regione.
properties.displayName	string	Nome visualizzato per la regione.
properties.orgDomain	string	Nome visualizzato per la regione.
type	string	Tipo di risorsa.

HostingEnvironmentDeploymentInfo

Oggetto

Informazioni necessarie per creare risorse su un ambiente del servizio app.

Nome	Tipo	Descrizione
location	string	Posizione dell'ambiente del servizio app.
name	string	Nome dell'ambiente del servizio app.

HostingEnvironmentStatus

Enumerazione

Stato attuale dell'ambiente del servizio app.

Valore	Descrizione
Preparing
Ready
Scaling
Deleting

LoadBalancingMode

Enumerazione

Specifica quali endpoint servire internamente nella Rete virtuale per l'ambiente del servizio app.

Valore	Descrizione
None
Web
Publishing
Web, Publishing

NameValuePair

Oggetto

Coppia nome-valore.

Nome	Tipo	Descrizione
name	string	Nome coppia.
value	string	Valore della coppia.

ProvisioningState

Enumerazione

Stato di provisioning del piano di servizio app.

Valore	Descrizione
Succeeded
Failed
Canceled
InProgress
Deleting

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

UpgradeAvailability

Enumerazione

Se è disponibile un aggiornamento per questo ambiente del servizio app.

Valore	Descrizione
None	Attualmente non è disponibile alcun aggiornamento per questo ambiente del servizio app
Ready	Un aggiornamento è pronto per essere avviato manualmente su questo ambiente del servizio app

UpgradePreference

Enumerazione

Preferenza aggiornamento

Valore	Descrizione
None	Nessuna preferenza su quando questo ambiente del servizio app verrà aggiornato
Early	Questo ambiente del servizio app sarà aggiornato prima di altri nella stessa regione che hanno la preferenza di aggiornamento 'Late'
Late	Questo ambiente del servizio app sarà aggiornato dopo altri nella stessa regione che hanno la preferenza per l'aggiornamento 'Early'
Manual	Solo ASEv3. Una volta che un aggiornamento è disponibile, questo ambiente del servizio app attenderà 10 giorni prima che l'aggiornamento venga avviato manualmente. Dopo 10 giorni l'aggiornamento inizierà automaticamente

VirtualNetworkProfile

Oggetto

Specifica per l'utilizzo di una Rete virtuale.

Nome	Tipo	Descrizione
id	string	ID risorsa della Rete virtuale.
name	string	Nome della Rete virtuale (sola lettura).
subnet	string	Subnet all'interno della Rete virtuale.
type	string	Tipo di risorsa della Rete virtuale (sola lettura).