Get WARP Connector HA configuration

GET/accounts/{account_id}/warp_connector/{tunnel_id}/configurations

Gets the high-availability configuration for a WARP Connector tunnel.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

Accepted Permissions (at least one required)

Cloudflare One Connectors WriteCloudflare One Connectors ReadCloudflare One Connector: WARP WriteCloudflare One Connector: WARP Read

Path ParametersExpand Collapse

account_id: string

Identifier.

maxLength32

tunnel_id: string

UUID of the tunnel.

formatuuid

maxLength36

ReturnsExpand Collapse

errors: array of object { code, message, documentation_url, source }

code: number

minimum1000

message: string

documentation_url: optional string

source: optional object { pointer }

pointer: optional string

messages: array of object { code, message, documentation_url, source }

code: number

minimum1000

message: string

documentation_url: optional string

source: optional object { pointer }

pointer: optional string

success: true

Whether the API call was successful.

result: optional object { configuration_version, created_at, ha_mode, 3 more }

configuration_version: number

Monotonically increasing configuration version, incremented on each PUT.

created_at: string

Timestamp of when the resource was created.

formatdate-time

ha_mode: "none" or "disabled" or "aws" or "local"

High-availability mode for the WARP Connector tunnel. none means HA is enabled but no provider is configured yet (newly created tunnels default to this). disabled means HA is explicitly turned off. aws uses AWS ENI move for failover. local uses virtual IPs (VIPs) on the local interface.

One of the following:

"none"

"disabled"

"aws"

"local"

tunnel_id: string

UUID of the tunnel.

formatuuid

maxLength36

config: optional object { fnr_id } or object { vips, vips_previous }

Provider-specific configuration. Present for aws and local modes.

One of the following:

TunnelMeshAwsConfig object { fnr_id }

fnr_id: string

Floating Network Resource ID — the secondary ENI that is moved between nodes on failover.

TunnelMeshLocalConfig object { vips, vips_previous }

vips: array of object { address }

VIPs to assign on the CloudflareWARP interface.

address: string

Virtual IP address (IPv4 or IPv6).

vips_previous: optional array of object { address }

VIPs to clean up on demotion or version drift.

address: string

Virtual IP address (IPv4 or IPv6).

updated_at: optional string

Timestamp of the last update. Null if never updated.

formatdate-time

Get WARP Connector HA configuration

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/warp_connector/$TUNNEL_ID/configurations \
    -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": {
    "configuration_version": 0,
    "created_at": "2021-01-25T18:22:34.317854Z",
    "ha_mode": "aws",
    "tunnel_id": "f70ff985-a4ef-4643-bbbc-4a0ed4fc8415",
    "config": {
      "fnr_id": "eni-0123456789abcdef0"
    },
    "updated_at": "2021-01-25T18:22:34.317854Z"
  }
}

Returns Examples

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": {
    "configuration_version": 0,
    "created_at": "2021-01-25T18:22:34.317854Z",
    "ha_mode": "aws",
    "tunnel_id": "f70ff985-a4ef-4643-bbbc-4a0ed4fc8415",
    "config": {
      "fnr_id": "eni-0123456789abcdef0"
    },
    "updated_at": "2021-01-25T18:22:34.317854Z"
  }
}