Skip to content

NAT64 - StandardV2 NAT Gateway CLI Feature Work Request #33646

Description

@cozhang8

NAT64 - StandardV2 NAT Gateway CLI Feature Work Request

Description of Work Requested

Implementing a new property for StandardV2 NAT Gateway SKU that allows customers to enable and disable NAT64.

Feature request to add output value, new parameter and/or add values into existing parameters for the following commands for NAT Gateway:

az network nat gateway create
az network nat gateway list
az network nat gateway show
az network nat gateway update

Resource Provider

Microsoft.network/natgateways

Minimum API Version

NAT Gateway: 2025-07-01
https://github.com/Azure/azure-rest-api-specs/blob/de824f3d72d238a8f13d1fe8eba172de43c5efe9/specification/network/resource-manager/Microsoft.Network/Network/Common/main.tsp#L445-L446

Release

GA: 7/15/2026

Release requirements for client work:

CLI needs to be ready in time for 7/15/2026 release.

  • New features/functionality should locate in a command module
  • Upon GA, functionality will be available publicly

NAT Gateway Commands

az network nat gateway create

New parameters

--nat64

Output values

--nat64

Accepted values: None, Disabled, Enabled
Default setting should be:

  • None: null value (means same thing as Disabled) - best to hide until ready to expose when we GA otherwise customers will see property that they can’t do anything with.
  • Property won’t be exposed when value set to None – only shows after either set to Enabled or Disabled

Scenario – Create a StandardV2 NAT Gateway with Nat64 enabled

az network nat gateway create --resource-group MyResourceGroup --name MyStdV2NatGateway --location MyLocation --public-ip-addressesv6 Myv6PublicIp --idle-timeout 4 --zone 1 2 3 –-sku StandardV2 --nat64 enabled

az network nat gateway list

New output values

When a customer uses az network nat gateway list command, the output that should return for each NAT gateway resource in the list, should include the new properties if configured on the StandardV2 SKU NAT Gateway:

{  
    “publicIpAddressesV6”: [ 
         { 
            “id”: “insert id here” 
          } 
    ] 
   “publicIpPrefixesV6”: [ 
         { 
           “id”: “insert id here” 
          } 
    ] 
   “sourceVirtualNetwork”: { 
          “id”: “insert id here” 
     } 

Example scenario – Show list of NAT Gateways – includes a StandardV2 NAT GW Nat64 enabled or disabled or empty.

Input

az network nat gateway list --resource-group MyResourceGroup

Output

[   
  { 
    "etag": "insertetagname", 
    "id": "/subscriptions/.../resourceGroups/MyResourceGroup/providers/Microsoft.Network/natGateways/", 
    "idleTimeoutInMinutes": 4, 
    "location": "MyLocation", 
    "name": "MyStdV2NatGateway", 
    "provisioningState": "Succeeded", 
    "publicIpAddressesV6": [ 
        { 
           "id": "/subscriptions/..../resourceGroups/MyResourceGroup/providers/Microsoft.Network/publicIPAddresses/Myv6PublicIp" 
         } 
    ], 
    "publicIpPrefixesV6": [ 
        { 
          "id": 
"/subscriptions/..../resourceGroups/MyResourceGroup/providers/Microsoft.Network/publicIPPrefixes/Myv6PublicIpPrefix" 
        } 
    ], 
    "resourceGroup": "MyResourceGroup", 
    "resourceGuid": "insertGUID", 
    "sku": { 
       "name": "StandardV2" 
    }, 
    "tags": {}, 
    "type": "Microsoft.Network/natGateways", 
    "zones": [ 
      "1",
      "2", 
      "3" 
    ], 
     "Nat64": "Enabled" 
  }
] 

az network nat gateway show

New output values

When a customer uses az network nat gateway show command, the output that should return for the NAT gateway resource, should include the new properties if configured on the StandardV2 SKU NAT Gateway:

{“nat64”: "none ", " disabled ", "enabled"}

Example scenario – Show details of a StandardV2 SKU NAT Gateway resource that has Nat64 enabled.

az network nat gateway show --resource-group MyResourceGroup –name MyStdV2NatGateway

Output

[   
  { 
    "etag": "insertetagname", 
    "id": "/subscriptions/.../resourceGroups/MyResourceGroup/providers/Microsoft.Network/natGateways/", 
    "idleTimeoutInMinutes": 4, 
    "location": "MyLocation", 
    "name": "MyStdV2NatGateway", 
    "provisioningState": "Succeeded", 
    "publicIpAddressesV6": [ 
        { 
           "id": "/subscriptions/..../resourceGroups/MyResourceGroup/providers/Microsoft.Network/publicIPAddresses/Myv6PublicIp" 
         }
    ], 
    "publicIpPrefixesV6": [ 
        { 
          "id": 
"/subscriptions/..../resourceGroups/MyResourceGroup/providers/Microsoft.Network/publicIPPrefixes/Myv6PublicIpPrefix" 
        } 
    ], 
    "resourceGroup": "MyResourceGroup", 
    "resourceGuid": "insertGUID", 
    "sku": { 
       "name": "StandardV2" 
    }, 
    "sourceVirtualNetwork": { 
       "id": "/subscriptions/..../resourceGroups/MyResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet" 
      },  
    "tags": {}, 
    "type": "Microsoft.Network/natGateways", 
    "zones": [ 
      "1", 
      "2", 
      "3", 
    ], 
     "Nat64": "Enabled" 
  } 
] 

az network nat gateway update

New parameters

--nat64

Output values

--nat64

Accepted values: Disabled, Enabled

Example scenario – update a StandardV2 SKU NAT Gateway Nat64 enabled to disabled

az network nat gateway update --resource-group MyResourceGroup --name MyStdV2NatGateway --nat64 enabled

Metadata

Metadata

Assignees

Type

No type
No fields configured for issues without a type.

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions