Skip to content
Start here

Create new targets

client.ZeroTrust.Access.Infrastructure.Targets.BulkUpdate(ctx, params) (*SinglePage[AccessInfrastructureTargetBulkUpdateResponse], error)
PUT/accounts/{account_id}/infrastructure/targets/batch

Adds one or more targets.

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 AccessInfrastructureTargetBulkUpdateParams
AccountID param.Field[string]

Path param: Account identifier

maxLength32
Body param.Field[[]AccessInfrastructureTargetBulkUpdateParamsBody]

Body param

Hostname string

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 AccessInfrastructureTargetBulkUpdateParamsBodyIP

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

IPV4 AccessInfrastructureTargetBulkUpdateParamsBodyIPIPV4Optional

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 AccessInfrastructureTargetBulkUpdateParamsBodyIPIPV6Optional

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 AccessInfrastructureTargetBulkUpdateResponse 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 AccessInfrastructureTargetBulkUpdateResponseIP

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

IPV4 AccessInfrastructureTargetBulkUpdateResponseIPIPV4Optional

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 AccessInfrastructureTargetBulkUpdateResponseIPIPV6Optional

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 targets

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"),
  )
  page, err := client.ZeroTrust.Access.Infrastructure.Targets.BulkUpdate(context.TODO(), zero_trust.AccessInfrastructureTargetBulkUpdateParams{
    AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
    Body: []zero_trust.AccessInfrastructureTargetBulkUpdateParamsBody{zero_trust.AccessInfrastructureTargetBulkUpdateParamsBody{
      Hostname: cloudflare.F("infra-access-target"),
      IP: cloudflare.F(zero_trust.AccessInfrastructureTargetBulkUpdateParamsBodyIP{

      }),
    }},
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", page)
}
{
  "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"
    }
  ]
}