Web Apps - Update Vnet Connection

Servizio:: App Service

Versione API:: 2026-07-15

Descrizione per Aggiunge una connessione Rete virtuale a un'app o slot (PUT) o aggiorna le proprietà della connessione (PATCH).

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{name}/virtualNetworkConnections/{vnetName}?api-version=2026-07-15

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
name	path	True	string	Nome dell'app.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
vnetName	path	True	string	Nome della rete virtuale.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
kind	string	Tipo di risorsa.
properties.certBlob	string	Un blob di file certificato (.cer) contenente la chiave pubblica della chiave privata utilizzata per autenticare una connessione VPN \nPoint-To-Site.
properties.dnsServers	string	Server DNS da utilizzare da questa Rete virtuale. Deve trattarsi di un elenco delimitato da virgole di indirizzi IP.
properties.isSwift	boolean	Flag usato per indicare se si tratta di inserimento della rete virtuale
properties.vnetResourceId	string	L'ID della risorsa della Rete virtuale.

Risposte

Nome	Tipo	Descrizione
200 OK	VnetInfoResource	L'operazione di Azure è stata completata correttamente.
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
createdByType	Tipo di identità che ha creato la risorsa.
DefaultErrorResponse	Risposta di errore del servizio app.
DefaultErrorResponseError	Modello di errore.
DefaultErrorResponseErrorDetailsItem	Errori dettagliati.
RouteType	Il tipo di percorso di cui si tratta: DEFAULT - Di default, ogni app ha rotte verso gli intervalli di indirizzi locali specificati da RFC1918 INHERITED - Route ereditate dalle rotte reali Rete virtuale STATIC - Route statica impostata solo sull'app Questi valori saranno utilizzati per sincronizzare i percorsi di un'app con quelli di una Rete virtuale.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
VnetInfoResource	Risorsa ARM per informazioni su Rete virtuale.
VnetRoute	Rete virtuale route contract utilizzato per trasmettere informazioni di routing a una Rete virtuale.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

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.

RouteType

Enumerazione

Il tipo di percorso di cui si tratta: DEFAULT - Di default, ogni app ha rotte verso gli intervalli di indirizzi locali specificati da RFC1918 INHERITED - Route ereditate dalle rotte reali Rete virtuale STATIC - Route statica impostata solo sull'app

Questi valori saranno utilizzati per sincronizzare i percorsi di un'app con quelli di una Rete virtuale.

Valore	Descrizione
DEFAULT
INHERITED
STATIC

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.

VnetInfoResource

Oggetto

Risorsa ARM per informazioni su Rete virtuale.

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.certBlob	string	Un blob di file certificato (.cer) contenente la chiave pubblica della chiave privata utilizzata per autenticare una connessione VPN \nPoint-To-Site.
properties.certThumbprint	string	Identificazione personale del certificato client.
properties.dnsServers	string	Server DNS da utilizzare da questa Rete virtuale. Deve trattarsi di un elenco delimitato da virgole di indirizzi IP.
properties.isSwift	boolean	Flag usato per indicare se si tratta di inserimento della rete virtuale
properties.resyncRequired	boolean	`true` se è necessaria una risincronizzazione; in caso contrario, `false`.
properties.routes	VnetRoute[]	Le rotte che questa connessione Rete virtuale utilizza.
properties.vnetResourceId	string	L'ID della risorsa della Rete virtuale.
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"

VnetRoute

Oggetto

Rete virtuale route contract utilizzato per trasmettere informazioni di routing a una Rete virtuale.

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.endAddress	string	Indirizzo finale per questa route. Se l'indirizzo iniziale viene specificato nella notazione CIDR, deve essere omesso.
properties.routeType	RouteType	Il tipo di percorso di cui si tratta: DEFAULT - Di default, ogni app ha rotte verso gli intervalli di indirizzi locali specificati da RFC1918 INHERITED - Route ereditate dalle rotte reali Rete virtuale STATIC - Route statica impostata solo sull'app Questi valori saranno utilizzati per sincronizzare i percorsi di un'app con quelli di una Rete virtuale.
properties.startAddress	string	Indirizzo iniziale per questa route. Ciò può includere anche una notazione CIDR, nel qual caso l'indirizzo finale non deve essere specificato.
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"