Skip to content
Cloudflare API
Start here
API Reference
Network Interconnects
CNIs

Create a new CNI object

client.NetworkInterconnects.CNIs.New(ctx, params) (*CNINewResponse, error)
POST/accounts/{account_id}/cni/cnis

Create a new CNI object

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)
Magic WAN WriteMagic Transit Write
ParametersExpand Collapse
params CNINewParams
AccountID param.Field[string]

Path param: Customer account tag

Account param.Field[string]

Body param: Customer account tag

Interconnect param.Field[string]

Body param

Magic param.Field[CNINewParamsMagic]

Body param

ConduitName string
Description string
Mtu int64
formatint32
minimum0
BGP param.Field[CNINewParamsBGP]optional

Body param

CustomerASN int64

ASN used on the customer end of the BGP session

formatint32
minimum0
ExtraPrefixes []string

Extra set of static prefixes to advertise to the customer's end of the session

Md5Key stringoptional

MD5 key to use for session authentication.

Note that this is not a security measure. MD5 is not a valid security mechanism, and the key is not treated as a secret value. This is only supported for preventing misconfiguration, not for defending against malicious attacks.

The MD5 key, if set, must be of non-zero length and consist only of the following types of character:

  • ASCII alphanumerics: [a-zA-Z0-9]
  • Special characters in the set '!@#$%^&*()+[]{}<>/.,;:_-~= |`

In other words, MD5 keys may contain any printable ASCII character aside from newline (0x0A), quotation mark ("), vertical tab (0x0B), carriage return (0x0D), tab (0x09), form feed (0x0C), and the question mark (?). Requests specifying an MD5 key with one or more of these disallowed characters will be rejected.

ReturnsExpand Collapse
type CNINewResponse struct{…}
ID string
formatuuid
Account string

Customer account tag

CustIP string

Customer end of the point-to-point link

This should always be inside the same prefix as p2p_ip.

formatA.B.C.D/N
Interconnect string

Interconnect identifier hosting this CNI

Magic CNINewResponseMagic
ConduitName string
Description string
Mtu int64
formatint32
minimum0
P2pIP string

Cloudflare end of the point-to-point link

formatA.B.C.D/N
BGP CNINewResponseBGPoptional
CustomerASN int64

ASN used on the customer end of the BGP session

formatint32
minimum0
ExtraPrefixes []string

Extra set of static prefixes to advertise to the customer's end of the session

Md5Key stringoptional

MD5 key to use for session authentication.

Note that this is not a security measure. MD5 is not a valid security mechanism, and the key is not treated as a secret value. This is only supported for preventing misconfiguration, not for defending against malicious attacks.

The MD5 key, if set, must be of non-zero length and consist only of the following types of character:

  • ASCII alphanumerics: [a-zA-Z0-9]
  • Special characters in the set '!@#$%^&*()+[]{}<>/.,;:_-~= |`

In other words, MD5 keys may contain any printable ASCII character aside from newline (0x0A), quotation mark ("), vertical tab (0x0B), carriage return (0x0D), tab (0x09), form feed (0x0C), and the question mark (?). Requests specifying an MD5 key with one or more of these disallowed characters will be rejected.

Create a new CNI object

package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/network_interconnects"
  "github.com/cloudflare/cloudflare-go/option"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  cni, err := client.NetworkInterconnects.CNIs.New(context.TODO(), network_interconnects.CNINewParams{
    AccountID: cloudflare.F("account_id"),
    Account: cloudflare.F("account"),
    Interconnect: cloudflare.F("interconnect"),
    Magic: cloudflare.F(network_interconnects.CNINewParamsMagic{
      ConduitName: cloudflare.F("conduit_name"),
      Description: cloudflare.F("description"),
      Mtu: cloudflare.F(int64(0)),
    }),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", cni.ID)
}

{
  "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "account": "account",
  "cust_ip": "192.168.3.4/31",
  "interconnect": "interconnect",
  "magic": {
    "conduit_name": "conduit_name",
    "description": "description",
    "mtu": 0
  },
  "p2p_ip": "192.168.3.4/31",
  "bgp": {
    "customer_asn": 0,
    "extra_prefixes": [
      "string"
    ],
    "md5_key": "md5_key"
  }
}
Returns Examples
{
  "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "account": "account",
  "cust_ip": "192.168.3.4/31",
  "interconnect": "interconnect",
  "magic": {
    "conduit_name": "conduit_name",
    "description": "description",
    "mtu": 0
  },
  "p2p_ip": "192.168.3.4/31",
  "bgp": {
    "customer_asn": 0,
    "extra_prefixes": [
      "string"
    ],
    "md5_key": "md5_key"
  }
}