Create new target

client.ZeroTrust.Access.Infrastructure.Targets.New(ctx, params) (*AccessInfrastructureTargetNewResponse, error)

POST/accounts/{account_id}/infrastructure/targets

Create new target

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

ParametersExpand Collapse

params AccessInfrastructureTargetNewParams

AccountID param.Field[string]

Path param: Account identifier

maxLength32

Hostname param.Field[string]

Body param: A non-unique field that refers to a target. Case insensitive, maximum length of 255 characters, supports the use of special characters dash and period, does not support spaces, and must start and end with an alphanumeric character.

IP param.Field[AccessInfrastructureTargetNewParamsIP]

Body param: The IPv4/IPv6 address that identifies where to reach a target

IPV4 AccessInfrastructureTargetNewParamsIPIPV4Optional

The target’s IPv4 address

IPAddr stringOptional

IP address of the target

VirtualNetworkID stringOptional

(optional) Private virtual network identifier for the target. If omitted, the default virtual network ID will be used.

formatuuid

IPV6 AccessInfrastructureTargetNewParamsIPIPV6Optional

The target’s IPv6 address

IPAddr stringOptional

IP address of the target

VirtualNetworkID stringOptional

(optional) Private virtual network identifier for the target. If omitted, the default virtual network ID will be used.

formatuuid

ReturnsExpand Collapse

type AccessInfrastructureTargetNewResponse struct{…}

ID string

Target identifier

formatuuid

maxLength36

CreatedAt Time

Date and time at which the target was created

formatdate-time

Hostname string

A non-unique field that refers to a target

IP AccessInfrastructureTargetNewResponseIP

The IPv4/IPv6 address that identifies where to reach a target

IPV4 AccessInfrastructureTargetNewResponseIPIPV4Optional

The target’s IPv4 address

IPAddr stringOptional

IP address of the target

VirtualNetworkID stringOptional

(optional) Private virtual network identifier for the target. If omitted, the default virtual network ID will be used.

formatuuid

IPV6 AccessInfrastructureTargetNewResponseIPIPV6Optional

The target’s IPv6 address

IPAddr stringOptional

IP address of the target

VirtualNetworkID stringOptional

(optional) Private virtual network identifier for the target. If omitted, the default virtual network ID will be used.

formatuuid

ModifiedAt Time

Date and time at which the target was modified

formatdate-time

Create new target

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"),
  )
  target, err := client.ZeroTrust.Access.Infrastructure.Targets.New(context.TODO(), zero_trust.AccessInfrastructureTargetNewParams{
    AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
    Hostname: cloudflare.F("infra-access-target"),
    IP: cloudflare.F(zero_trust.AccessInfrastructureTargetNewParamsIP{

    }),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", target.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": {
    "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "created_at": "2019-08-24T14:15:22Z",
    "hostname": "infra-access-target",
    "ip": {
      "ipv4": {
        "ip_addr": "187.26.29.249",
        "virtual_network_id": "c77b744e-acc8-428f-9257-6878c046ed55"
      },
      "ipv6": {
        "ip_addr": "64c0:64e8:f0b4:8dbf:7104:72b0:ec8f:f5e0",
        "virtual_network_id": "c77b744e-acc8-428f-9257-6878c046ed55"
      }
    },
    "modified_at": "2019-08-24T14:15:22Z"
  }
}

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": {
    "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "created_at": "2019-08-24T14:15:22Z",
    "hostname": "infra-access-target",
    "ip": {
      "ipv4": {
        "ip_addr": "187.26.29.249",
        "virtual_network_id": "c77b744e-acc8-428f-9257-6878c046ed55"
      },
      "ipv6": {
        "ip_addr": "64c0:64e8:f0b4:8dbf:7104:72b0:ec8f:f5e0",
        "virtual_network_id": "c77b744e-acc8-428f-9257-6878c046ed55"
      }
    },
    "modified_at": "2019-08-24T14:15:22Z"
  }
}