Nat Gateways - Create Or Update
Crea o aggiorna un gateway nat.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/natGateways/{natGatewayName}?api-version=2025-05-01
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
nat
|
path | True |
string |
Nome del gateway NAT. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole. |
|
subscription
|
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. |
Corpo della richiesta
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string |
ID risorsa. |
| location |
string |
Percorso della risorsa. |
| properties.idleTimeoutInMinutes |
integer (int32) |
Timeout di inattività del gateway NAT. |
| properties.publicIpAddresses |
Matrice di indirizzi IP pubblici V4 associati alla risorsa gateway nat. |
|
| properties.publicIpAddressesV6 |
Matrice di indirizzi IP pubblici V6 associati alla risorsa gateway nat. |
|
| properties.publicIpPrefixes |
Matrice di prefissi IP pubblici V4 associati alla risorsa gateway nat. |
|
| properties.publicIpPrefixesV6 |
Matrice di prefissi IP pubblici V6 associati alla risorsa gateway nat. |
|
| properties.serviceGateway |
Riferimento a un gateway di servizio esistente. |
|
| properties.sourceVirtualNetwork |
Riferimento alla rete virtuale di origine che usa questa risorsa gateway nat. |
|
| sku |
SKU del gateway NAT. |
|
| tags |
object |
Tag di risorsa. |
| zones |
string[] |
Elenco di zone di disponibilità che denota la zona in cui deve essere distribuito il gateway Nat. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
Operazione di aggiornamento 'NatGateway' della risorsa riuscita |
|
| 201 Created |
Risorsa 'NatGateway' crea operazione con successo Intestazioni Retry-After: integer |
|
| 202 Accepted |
La richiesta è stata accettata per l'elaborazione, ma l'elaborazione non è ancora stata completata. Intestazioni
|
|
| Other Status Codes |
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 | rappresentare l'account utente |
Esempio
| Create nat gateway |
| Create nat gateway with service gateway |
| Create nat gateway with StandardV2 Sku |
Create nat gateway
Esempio di richiesta
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/natGateways/test-natgateway?api-version=2025-05-01
{
"location": "westus",
"properties": {
"publicIpAddresses": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/PublicIpAddress1"
}
],
"publicIpPrefixes": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/PublicIpPrefix1"
}
]
},
"sku": {
"name": "Standard"
}
}
Risposta di esempio
{
"name": "test-natGateway",
"type": "Microsoft.Network/natGateways",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/natGateways/test-natGateway",
"location": "westus",
"properties": {
"idleTimeoutInMinutes": 5,
"provisioningState": "Succeeded",
"publicIpAddresses": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/PublicIpAddress1"
}
],
"publicIpPrefixes": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/PublicIpPrefix1"
}
],
"subnets": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1"
}
]
},
"sku": {
"name": "Standard"
}
}
{
"name": "test-natGateway",
"type": "Microsoft.Network/natGateways",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/natGateways/test-natGateway",
"location": "westus",
"properties": {
"idleTimeoutInMinutes": 5,
"provisioningState": "Succeeded",
"publicIpAddresses": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/PublicIpAddress1"
}
],
"publicIpPrefixes": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/PublicIpPrefix1"
}
],
"subnets": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1"
}
]
},
"sku": {
"name": "Standard"
}
}
Create nat gateway with service gateway
Esempio di richiesta
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/natGateways/test-natgateway?api-version=2025-05-01
{
"location": "westus",
"properties": {
"publicIpAddresses": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/PublicIpAddress1"
}
],
"publicIpPrefixes": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/PublicIpPrefix1"
}
],
"serviceGateway": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/serviceGateways/SG1"
}
},
"sku": {
"name": "Standard"
}
}
Risposta di esempio
{
"name": "test-natGateway",
"type": "Microsoft.Network/natGateways",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/natGateways/test-natGateway",
"location": "westus",
"properties": {
"idleTimeoutInMinutes": 5,
"provisioningState": "Succeeded",
"publicIpAddresses": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/PublicIpAddress1"
}
],
"publicIpPrefixes": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/PublicIpPrefix1"
}
],
"serviceGateway": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/serviceGateways/SG1"
}
},
"sku": {
"name": "Standard"
}
}
{
"name": "test-natGateway",
"type": "Microsoft.Network/natGateways",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/natGateways/test-natGateway",
"location": "westus",
"properties": {
"idleTimeoutInMinutes": 5,
"provisioningState": "Succeeded",
"publicIpAddresses": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/PublicIpAddress1"
}
],
"publicIpPrefixes": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/PublicIpPrefix1"
}
],
"serviceGateway": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/serviceGateways/SG1"
}
},
"sku": {
"name": "Standard"
}
}
Create nat gateway with StandardV2 Sku
Esempio di richiesta
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/natGateways/test-natgateway?api-version=2025-05-01
{
"location": "westus",
"properties": {
"publicIpAddresses": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/PublicIpAddress1"
}
],
"publicIpPrefixes": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/PublicIpPrefix1"
}
]
},
"sku": {
"name": "StandardV2"
}
}
Risposta di esempio
{
"name": "test-natGateway",
"type": "Microsoft.Network/natGateways",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/natGateways/test-natGateway",
"location": "westus",
"properties": {
"idleTimeoutInMinutes": 5,
"provisioningState": "Succeeded",
"publicIpAddresses": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/PublicIpAddress1"
}
],
"publicIpPrefixes": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/PublicIpPrefix1"
}
],
"sourceVirtualNetwork": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet"
},
"subnets": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1"
}
]
},
"sku": {
"name": "StandardV2"
}
}
{
"name": "test-natGateway",
"type": "Microsoft.Network/natGateways",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/natGateways/test-natGateway",
"location": "westus",
"properties": {
"idleTimeoutInMinutes": 5,
"provisioningState": "Succeeded",
"publicIpAddresses": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/PublicIpAddress1"
}
],
"publicIpAddressesV6": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPAddresses/PublicIpAddress2"
}
],
"publicIpPrefixes": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/PublicIpPrefix1"
}
],
"publicIpPrefixesV6": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/publicIPPrefixes/PublicIpPrefix2"
}
],
"sourceVirtualNetwork": {
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet"
},
"subnets": [
{
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1"
}
]
},
"sku": {
"name": "StandardV2"
}
}
Definizioni
| Nome | Descrizione |
|---|---|
|
Common. |
Risposta di errore dal servizio. |
|
Common. |
Risposta di errore dal servizio. |
|
Common. |
Risorsa gateway NAT. |
|
Common. |
SKU del gateway NAT. |
|
Common. |
Riferimento a un'altra sottorisorsa. |
|
Nat |
Nome dello SKU del gateway Nat. |
|
Provisioning |
Stato di provisioning della risorsa del gruppo di sicurezza dell'applicazione. |
Common.CloudError
Risposta di errore dal servizio.
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Corpo dell'errore cloud. |
Common.CloudErrorBody
Risposta di errore dal servizio.
| Nome | Tipo | Descrizione |
|---|---|---|
| code |
string |
Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice. |
| details |
Un elenco di dettagli aggiuntivi sull'errore. |
|
| message |
string |
Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente. |
| target |
string |
Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in errore. |
Common.NatGateway
Risorsa gateway NAT.
| Nome | Tipo | Descrizione |
|---|---|---|
| etag |
string |
Stringa di sola lettura univoca che cambia ogni volta che la risorsa viene aggiornata. |
| id |
string |
ID risorsa. |
| location |
string |
Percorso della risorsa. |
| name |
string |
Nome risorsa. |
| properties.idleTimeoutInMinutes |
integer (int32) |
Timeout di inattività del gateway NAT. |
| properties.provisioningState |
Stato di provisioning della risorsa gateway NAT. |
|
| properties.publicIpAddresses |
Matrice di indirizzi IP pubblici V4 associati alla risorsa gateway nat. |
|
| properties.publicIpAddressesV6 |
Matrice di indirizzi IP pubblici V6 associati alla risorsa gateway nat. |
|
| properties.publicIpPrefixes |
Matrice di prefissi IP pubblici V4 associati alla risorsa gateway nat. |
|
| properties.publicIpPrefixesV6 |
Matrice di prefissi IP pubblici V6 associati alla risorsa gateway nat. |
|
| properties.resourceGuid |
string |
Proprietà GUID della risorsa gateway NAT. |
| properties.serviceGateway |
Riferimento a un gateway di servizio esistente. |
|
| properties.sourceVirtualNetwork |
Riferimento alla rete virtuale di origine che usa questa risorsa gateway nat. |
|
| properties.subnets |
Matrice di riferimenti alle subnet che utilizzano questa risorsa gateway nat. |
|
| sku |
SKU del gateway NAT. |
|
| tags |
object |
Tag di risorsa. |
| type |
string |
Tipo di risorsa. |
| zones |
string[] |
Elenco di zone di disponibilità che denota la zona in cui deve essere distribuito il gateway Nat. |
Common.NatGatewaySku
SKU del gateway NAT.
| Nome | Tipo | Descrizione |
|---|---|---|
| name |
Nome dello SKU del gateway Nat. |
Common.SubResource
Riferimento a un'altra sottorisorsa.
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string |
ID risorsa. |
NatGatewaySkuName
Nome dello SKU del gateway Nat.
| Valore | Descrizione |
|---|---|
| Standard |
Standard |
| StandardV2 |
StandardV2 |
ProvisioningState
Stato di provisioning della risorsa del gruppo di sicurezza dell'applicazione.
| Valore | Descrizione |
|---|---|
| Failed |
Non riuscito |
| Succeeded |
Succeeded |
| Canceled |
Operazione annullata |
| Creating |
Creazione |
| Updating |
Aggiornamento |
| Deleting |
Deleting |