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
natGatewayName
path True

string

Nome del gateway NAT.

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.

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

Common.SubResource[]

Matrice di indirizzi IP pubblici V4 associati alla risorsa gateway nat.

properties.publicIpAddressesV6

Common.SubResource[]

Matrice di indirizzi IP pubblici V6 associati alla risorsa gateway nat.

properties.publicIpPrefixes

Common.SubResource[]

Matrice di prefissi IP pubblici V4 associati alla risorsa gateway nat.

properties.publicIpPrefixesV6

Common.SubResource[]

Matrice di prefissi IP pubblici V6 associati alla risorsa gateway nat.

properties.serviceGateway

Common.SubResource

Riferimento a un gateway di servizio esistente.

properties.sourceVirtualNetwork

Common.SubResource

Riferimento alla rete virtuale di origine che usa questa risorsa gateway nat.

sku

Common.NatGatewaySku

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

Common.NatGateway

Operazione di aggiornamento 'NatGateway' della risorsa riuscita

201 Created

Common.NatGateway

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

  • Azure-AsyncOperation: string
  • Retry-After: integer
Other Status Codes

Common.CloudError

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.CloudError

Risposta di errore dal servizio.

Common.CloudErrorBody

Risposta di errore dal servizio.

Common.NatGateway

Risorsa gateway NAT.

Common.NatGatewaySku

SKU del gateway NAT.

Common.SubResource

Riferimento a un'altra sottorisorsa.

NatGatewaySkuName

Nome dello SKU del gateway Nat.

ProvisioningState

Stato di provisioning della risorsa del gruppo di sicurezza dell'applicazione.

Common.CloudError

Risposta di errore dal servizio.

Nome Tipo Descrizione
error

Common.CloudErrorBody

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

Common.CloudErrorBody[]

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

ProvisioningState

Stato di provisioning della risorsa gateway NAT.

properties.publicIpAddresses

Common.SubResource[]

Matrice di indirizzi IP pubblici V4 associati alla risorsa gateway nat.

properties.publicIpAddressesV6

Common.SubResource[]

Matrice di indirizzi IP pubblici V6 associati alla risorsa gateway nat.

properties.publicIpPrefixes

Common.SubResource[]

Matrice di prefissi IP pubblici V4 associati alla risorsa gateway nat.

properties.publicIpPrefixesV6

Common.SubResource[]

Matrice di prefissi IP pubblici V6 associati alla risorsa gateway nat.

properties.resourceGuid

string

Proprietà GUID della risorsa gateway NAT.

properties.serviceGateway

Common.SubResource

Riferimento a un gateway di servizio esistente.

properties.sourceVirtualNetwork

Common.SubResource

Riferimento alla rete virtuale di origine che usa questa risorsa gateway nat.

properties.subnets

Common.SubResource[]

Matrice di riferimenti alle subnet che utilizzano questa risorsa gateway nat.

sku

Common.NatGatewaySku

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

NatGatewaySkuName

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