Get WARP Connector HA configuration

client.zeroTrust.tunnels.warpConnector.configurations.get(, , ?): ConfigurationGetResponse { configuration_version, created_at, ha_mode, 3 more }

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

ParametersExpand Collapse

tunnelId: string

UUID of the tunnel.

formatuuid

maxLength36

params: ConfigurationGetParams { account_id }

account_id: string

Identifier.

maxLength32

ReturnsExpand Collapse

ConfigurationGetResponse { 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" | "disabled" | "aws" | "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?: TunnelMeshAwsConfig { fnr_id } | TunnelMeshLocalConfig { vips, vips_previous } | null

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

One of the following:

TunnelMeshAwsConfig { fnr_id }

fnr_id: string

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

TunnelMeshLocalConfig { vips, vips_previous }

vips: Array<Vip>

VIPs to assign on the CloudflareWARP interface.

address: string

Virtual IP address (IPv4 or IPv6).

vips_previous?: Array<VipsPrevious>

VIPs to clean up on demotion or version drift.

address: string

Virtual IP address (IPv4 or IPv6).

updated_at?: string | null

Timestamp of the last update. Null if never updated.

formatdate-time

Get WARP Connector HA configuration

import Cloudflare from 'cloudflare';

const client = new Cloudflare({
  apiToken: process.env['CLOUDFLARE_API_TOKEN'], // This is the default and can be omitted
});

const configuration = await client.zeroTrust.tunnels.warpConnector.configurations.get(
  'f70ff985-a4ef-4643-bbbc-4a0ed4fc8415',
  { account_id: '023e105f4ecef8ad9ca31a8372d0c353' },
);

console.log(configuration.tunnel_id);

{
  "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"
  }
}