Nat Gateways - List All

Service:
Virtual Networks
Version d’API:
2025-09-01

Obtient toutes les passerelles Nat d’un abonnement.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/natGateways?api-version=2025-09-01

Paramètres URI

Nom Dans Obligatoire Type Description
subscriptionId
 path True

string (uuid)

ID de l’abonnement cible. La valeur doit être un UUID.
api-version
 query True

string

minLength: 1

Version de l’API à utiliser pour cette opération.

Réponses

Nom Type Description
200 OK

NatGatewayListResult

L’opération Azure s’est terminée avec succès.
Other Status Codes

CloudError

Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 d’Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Usurper l’identité de votre compte utilisateur

Exemples

List all nat gateways

Exemple de requête

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/natGateways?api-version=2025-09-01

Exemple de réponse

Code d’état:
200 
{
  "value": [
    {
      "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-natGateway2",
      "type": "Microsoft.Network/natGateways",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg2/providers/Microsoft.Network/natGatewayes/test-natGateway2",
      "location": "westus",
      "properties": {
        "idleTimeoutInMinutes": 5,
        "provisioningState": "Succeeded",
        "publicIpAddresses": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg2/providers/Microsoft.Network/publicIPAddresses/PublicIpAddress1"
          }
        ],
        "publicIpPrefixes": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg2/providers/Microsoft.Network/publicIPPrefixes/PublicIpPrefix1"
          }
        ],
        "subnets": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg2/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1"
          }
        ]
      },
      "sku": {
        "name": "Standard"
      }
    },
    {
      "name": "test-natGateway3",
      "type": "Microsoft.Network/natGateways",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg2/providers/Microsoft.Network/natGatewayes/test-natGateway3",
      "location": "westus",
      "properties": {
        "idleTimeoutInMinutes": 5,
        "provisioningState": "Succeeded",
        "publicIpAddresses": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg2/providers/Microsoft.Network/publicIPAddresses/PublicIpAddress1"
          }
        ],
        "publicIpAddressesV6": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg2/providers/Microsoft.Network/publicIPAddresses/PublicIpAddress2"
          }
        ],
        "publicIpPrefixes": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg2/providers/Microsoft.Network/publicIPPrefixes/PublicIpPrefix1"
          }
        ],
        "publicIpPrefixesV6": [
          {
            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg2/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/rg2/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1"
          }
        ]
      },
      "sku": {
        "name": "StandardV2"
      }
    }
  ]
}

Définitions

Nom Description
CloudError

Réponse d’erreur du service.
CloudErrorBody

Réponse d’erreur du service.
Nat64State

Est-ce que Nat64 est activé pour la ressource NAT Gateway ?
NatGateway

Ressource nat Gateway.
NatGatewayListResult

La réponse d’une opération de liste NatGateway.
NatGatewaySku

Référence SKU de la passerelle nat.
NatGatewaySkuName

Nom de la référence SKU nat Gateway.
ProvisioningState

États de provisionnement d’une ressource.
SubResource

Référence à une autre sous-ressource.

CloudError

Objet

Réponse d’erreur du service.

Nom Type Description
error

CloudErrorBody

Corps de l’erreur Cloud.

CloudErrorBody

Objet

Réponse d’erreur du service.

Nom Type Description
code

string

Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.
details

CloudErrorBody[]

Liste des détails supplémentaires sur l’erreur.
message

string

Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.
target

string

Cible de l’erreur particulière. Par exemple, le nom de la propriété en erreur.

Nat64State

Énumération

Est-ce que Nat64 est activé pour la ressource NAT Gateway ?

Valeur Description
None

La propriété Nat64 n’est pas définie.
Enabled

Nat64 est activé.
Disabled

Nat64 est désactivé.

NatGateway

Objet

Ressource nat Gateway.

Nom Type Description
etag

string

Chaîne en lecture seule unique qui change chaque fois que la ressource est mise à jour.
id

string

ID de la ressource
location

string

Emplacement des ressources.
name

string

Nom de la ressource.
properties.idleTimeoutInMinutes

integer (int32)

Délai d’inactivité de la passerelle nat.
properties.nat64

Nat64State

Est-ce que Nat64 est activé pour la ressource NAT Gateway ?
properties.provisioningState

ProvisioningState

État d’approvisionnement de la ressource de passerelle NAT.
properties.publicIpAddresses

SubResource[]

Tableau d’adresses IP publiques V4 associées à la ressource de passerelle nat.
properties.publicIpAddressesV6

SubResource[]

Tableau d’adresses IP publiques V6 associées à la ressource de passerelle nat.
properties.publicIpPrefixes

SubResource[]

Tableau de préfixes d’adresse IP publique V4 associés à la ressource de passerelle nat.
properties.publicIpPrefixesV6

SubResource[]

Tableau de préfixes d’adresse IP publique V6 associés à la ressource de passerelle nat.
properties.resourceGuid

string

Propriété GUID de ressource de la ressource de passerelle NAT.
properties.serviceGateway

SubResource

Référence à une passerelle de service existante.
properties.sourceVirtualNetwork

SubResource

Référence au réseau virtuel source à l’aide de cette ressource de passerelle nat.
properties.subnets

SubResource[]

Tableau de références aux sous-réseaux à l’aide de cette ressource de passerelle nat.
sku

NatGatewaySku

Référence SKU de passerelle nat.
tags

object

Balises de ressources.
type

string

Type de ressource.
zones

string[]

Liste des zones de disponibilité indiquant la zone dans laquelle la passerelle Nat doit être déployée.

NatGatewayListResult

Objet

La réponse d’une opération de liste NatGateway.

Nom Type Description
nextLink

string (uri)

Lien vers la page suivante des éléments
value

NatGateway[]

Les éléments NatGateway sur cette page

NatGatewaySku

Objet

Référence SKU de la passerelle nat.

Nom Type Description
name

NatGatewaySkuName

Nom de la référence SKU nat Gateway.

NatGatewaySkuName

Énumération

Nom de la référence SKU nat Gateway.

Valeur Description
Standard

Standard
StandardV2

StandardV2

ProvisioningState

Énumération

États de provisionnement d’une ressource.

Valeur Description
Failed

Échec
Succeeded

Réussi
Canceled

Opération annulée
Creating

Création
Updating

Updating
Deleting

Suppression

SubResource

Objet

Référence à une autre sous-ressource.

Nom Type Description
id

string

ID de la ressource