Create a device managed network

client.ZeroTrust.Devices.Networks.New(ctx, params) (*DeviceNetwork, error)

POST/accounts/{account_id}/devices/networks

Creates a new device managed network.

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)

Zero Trust Write

ParametersExpand Collapse

params DeviceNetworkNewParams

AccountID param.Field[string]

Path param

Config param.Field[DeviceNetworkNewParamsConfig]

Body param: The configuration object containing information for the WARP client to detect the managed network.

TLSSockaddr string

A network address of the form “host:port” that the WARP client will use to detect the presence of a TLS host.

Sha256 stringOptional

The SHA-256 hash of the TLS certificate presented by the host found at tls_sockaddr. If absent, regular certificate verification (trusted roots, valid timestamp, etc) will be used to validate the certificate.

Name param.Field[string]

Body param: The name of the device managed network. This name must be unique.

Type param.Field[DeviceNetworkNewParamsType]

Body param: The type of device managed network.

const DeviceNetworkNewParamsTypeTLS DeviceNetworkNewParamsType = "tls"

ReturnsExpand Collapse

type DeviceNetwork struct{…}

Config DeviceNetworkConfigOptional

The configuration object containing information for the WARP client to detect the managed network.

TLSSockaddr string

A network address of the form “host:port” that the WARP client will use to detect the presence of a TLS host.

Sha256 stringOptional

Name stringOptional

The name of the device managed network. This name must be unique.

NetworkID stringOptional

API UUID.

maxLength36

Type DeviceNetworkTypeOptional

The type of device managed network.

Create a device managed network

package main

import (
  "context"
  "fmt"

  "github.com/stainless-sdks/cloudflare-go"
  "github.com/stainless-sdks/cloudflare-go/option"
  "github.com/stainless-sdks/cloudflare-go/zero_trust"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  deviceNetwork, err := client.ZeroTrust.Devices.Networks.New(context.TODO(), zero_trust.DeviceNetworkNewParams{
    AccountID: cloudflare.F("699d98642c564d2e855e9661899b7252"),
    Config: cloudflare.F(zero_trust.DeviceNetworkNewParamsConfig{
      TLSSockaddr: cloudflare.F("foo.bar:1234"),
    }),
    Name: cloudflare.F("managed-network-1"),
    Type: cloudflare.F(zero_trust.DeviceNetworkNewParamsTypeTLS),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", deviceNetwork.NetworkID)
}

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": {
    "config": {
      "tls_sockaddr": "foo.bar:1234",
      "sha256": "b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c"
    },
    "name": "managed-network-1",
    "network_id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415",
    "type": "tls"
  },
  "success": true
}

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"
      }
    }
  ],
  "result": {
    "config": {
      "tls_sockaddr": "foo.bar:1234",
      "sha256": "b5bb9d8014a0f9b1d61e21e796d78dccdf1352f23cd32812f4850b878ae4944c"
    },
    "name": "managed-network-1",
    "network_id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415",
    "type": "tls"
  },
  "success": true
}