---
title: vpc_nat_gateways_info
description: List all VPC NAT Gateways on your account
product: Reference
url: https://docs.digitalocean.com/reference/ansible/reference/modules/vpc_nat_gateways_info/
last_updated: "2026-08-15"
---

> **For AI agents:** The documentation index is at [https://docs.digitalocean.com/llms.txt](https://docs.digitalocean.com/llms.txt). Markdown versions of pages use the same URL with `index.html.md` in place of the HTML page (for example, append `index.html.md` to the directory path instead of opening the HTML document).

# vpc_nat_gateways_info

## Synopsis

List all VPC NAT Gateways on your account. VPC NAT Gateways allow resources in a private VPC to access the public internet without exposing them to incoming traffic. View the API documentation at [https://docs.digitalocean.com/reference/api/api-reference/#operation/vpc_nat_gateways_list](https://docs.digitalocean.com/reference/api/api-reference/index.html.md#operation/vpc_nat_gateways_list).

## Requirements

- pydo >= 0.1.3
- azure-core >= 1.26.1

## Parameters

Parameter Choices / Default Description

`client_override_options`, dict Client override options (developer use). For example, can be used to override the DigitalOcean API endpoint for an internal test suite. If provided, these options will knock out existing options.

`module_override_options`, dict Module override options (developer use). Can be used to override module options to support experimental or future options. If provided, these options will knock out existing options.

`state`, str Choices:

- `present` (default)
- `absent`

State of the resource, `present` to create, `absent` to destroy.

`timeout`, int Default: `300` Polling timeout in seconds.

`token`, str DigitalOcean API token. There are several environment variables which can be used to provide this value. `DIGITALOCEAN_ACCESS_TOKEN`, `DIGITALOCEAN_TOKEN`, `DO_API_TOKEN`, `DO_API_KEY`, `DO_OAUTH_TOKEN` and `OAUTH_TOKEN`

## Examples

```yaml
- name: Get VPC NAT Gateways
  digitalocean.cloud.vpc_nat_gateways_info:
    token: "{{ token }}"
```

## Return Values

KeyReturnedDescription

`error`, dict failure DigitalOcean API error., Sample:,```json
{
  "Message": "Informational error message.",
  "Reason": "Unauthorized",
  "Status Code": 401
}
```

`msg`, str always VPC NAT Gateways result information., Sample:,```json
[
  "Current VPC NAT Gateways",
  "No VPC NAT Gateways"
]
```

`vpc_nat_gateways`, list always VPC NAT Gateways., Sample:,```json
[
  {
    "created_at": "2020-03-13T19:20:47.442049222Z",
    "id": "5a4981aa-9653-4bd1-bef5-d6bff52042e4",
    "name": "my-nat-gateway",
    "public_ip": "192.0.2.1",
    "region": "nyc1",
    "size": "small",
    "status": "ACTIVE",
    "vpc_uuid": "5a4981aa-9653-4bd1-bef5-d6bff52042e4"
  }
]
```