netboxgo/devices.go

package netboxgo

import (
	"context"
	"fmt"
	"net/http"
	"net/url"
	"time"

	"github.com/gorilla/schema"
)

type DevicesService service

// Devices is used for Netbox dcim_device_list return struct
type Devices struct {
	Next     string   `json:"next"`
	Previous string   `json:"previous"`
	Results  []Device `json:"results"`
	Count    int      `json:"count"`
}

type Device struct {
	LastUpdated   time.Time   `json:"last_updated"`
	CustomFields  interface{} `json:"custom_fields,omitempty"`
	ConfigContext interface{} `json:"config_context"`
	Status        struct {
		Label string `json:"label"`
		Value string `json:"value"`
	} `json:"status"`
	Face struct {
		Label string `json:"label"`
		Value string `json:"value"`
	} `json:"face"`
	Name         string `json:"name"`
	AssetTag     string `json:"asset_tag"`
	Comments     string `json:"comments"`
	DisplayName  string `json:"display_name"`
	Created      string `json:"created"`
	Serial       string `json:"serial"`
	ParentDevice struct {
		URL         string `json:"url"`
		Name        string `json:"name"`
		DisplayName string `json:"display_name"`
		ID          int    `json:"id"`
	} `json:"parent_device"`
	Tenant struct {
		URL  string `json:"url"`
		Name string `json:"name"`
		Slug string `json:"slug"`
		ID   int    `json:"id"`
	} `json:"tenant"`
	Site struct {
		URL  string `json:"url"`
		Name string `json:"name"`
		Slug string `json:"slug"`
		ID   int    `json:"id"`
	} `json:"site"`
	Tags []struct {
		URL   string `json:"url"`
		Name  string `json:"name"`
		Slug  string `json:"slug"`
		Color string `json:"color"`
		ID    int    `json:"id"`
	} `json:"tags"`
	Rack struct {
		URL         string `json:"url"`
		Name        string `json:"name"`
		DisplayName string `json:"display_name"`
		ID          int    `json:"id"`
		DeviceCount int    `json:"device_count"`
	} `json:"rack"`
	PrimaryIP4 struct {
		URL     string `json:"url"`
		Address string `json:"address"`
		ID      int    `json:"id"`
		Family  int    `json:"family"`
	} `json:"primary_ip4"`
	PrimaryIP struct {
		URL     string `json:"url"`
		Address string `json:"address"`
		ID      int    `json:"id"`
		Family  int    `json:"family"`
	} `json:"primary_ip"`
	Cluster struct {
		URL                 string `json:"url"`
		Name                string `json:"name"`
		ID                  int    `json:"id"`
		VirtualmachineCount int    `json:"virtualmachine_count"`
	} `json:"cluster"`
	PrimaryIP6 struct {
		URL     string `json:"url"`
		Address string `json:"address"`
		ID      int    `json:"id"`
		Family  int    `json:"family"`
	} `json:"primary_ip6"`
	VirtualChassis struct {
		URL    string `json:"url"`
		Master struct {
			URL         string `json:"url"`
			Name        string `json:"name"`
			DisplayName string `json:"display_name"`
			ID          int    `json:"id"`
		} `json:"master"`
		ID          int `json:"id"`
		MemberCount int `json:"member_count"`
	} `json:"virtual_chassis"`
	DeviceRole struct {
		URL                 string `json:"url"`
		Name                string `json:"name"`
		Slug                string `json:"slug"`
		ID                  int    `json:"id"`
		DeviceCount         int    `json:"device_count"`
		VirtualmachineCount int    `json:"virtualmachine_count"`
	} `json:"device_role"`
	Platform struct {
		URL                 string `json:"url"`
		Name                string `json:"name"`
		Slug                string `json:"slug"`
		ID                  int    `json:"id"`
		DeviceCount         int    `json:"device_count"`
		VirtualmachineCount int    `json:"virtualmachine_count"`
	} `json:"platform"`
	DeviceType struct {
		URL          string `json:"url"`
		Model        string `json:"model"`
		Slug         string `json:"slug"`
		DisplayName  string `json:"display_name"`
		Manufacturer struct {
			URL             string `json:"url"`
			Name            string `json:"name"`
			Slug            string `json:"slug"`
			ID              int    `json:"id"`
			DevicetypeCount int    `json:"devicetype_count"`
		} `json:"manufacturer"`
		ID          int `json:"id"`
		DeviceCount int `json:"device_count"`
	} `json:"device_type"`
	Position   int `json:"position"`
	VcPriority int `json:"vc_priority"`
	VcPosition int `json:"vc_position"`
	ID         int `json:"id"`
}

type NewDevice struct {
	CustomFields     interface{} `json:"custom_fields,omitempty"`
	Face             string      `json:"face,omitempty"`
	LocalContextData string      `json:"local_context_data,omitempty"`
	Comments         string      `json:"comments,omitempty"`
	Status           string      `json:"status,omitempty"`
	Serial           string      `json:"serial,omitempty"`
	AssetTag         string      `json:"asset_tag,omitempty"`
	ParentDevice     struct {
		Name string `json:"name,omitempty"`
	} `json:"parent_device,omitempty"`
	Name string `json:"name,omitempty"`
	Tags []struct {
		Name  string `json:"name"`
		Slug  string `json:"slug"`
		Color string `json:"color"`
	} `json:"tags"`
	Cluster        int `json:"cluster,omitempty"`
	Platform       int `json:"platform,omitempty"`
	Tenant         int `json:"tenant,omitempty"`
	PrimaryIP4     int `json:"primary_ip4,omitempty"`
	PrimaryIP6     int `json:"primary_ip6,omitempty"`
	Site           int `json:"site,omitempty"`
	VirtualChassis int `json:"virtual_chassis,omitempty"`
	VcPosition     int `json:"vc_position,omitempty"`
	VcPriority     int `json:"vc_priority,omitempty"`
	DeviceRole     int `json:"device_role,omitempty"`
	DeviceType     int `json:"device_type,omitempty"`
	Position       int `json:"position,omitempty"`
	Rack           int `json:"rack,omitempty"`
}

type UpdateDevice struct {
	CustomFields interface{} `json:"custom_fields,omitempty"`
	ParentDevice *struct {
		Name string `json:"name,omitempty"`
	} `json:"parent_device,omitempty"`
	Face             string   `json:"face,omitempty"`
	LocalContextData string   `json:"local_context_data,omitempty"`
	Comments         string   `json:"comments,omitempty"`
	Serial           string   `json:"serial,omitempty"`
	AssetTag         string   `json:"asset_tag,omitempty"`
	Status           string   `json:"status,omitempty"`
	Name             string   `json:"name,omitempty"`
	Tags             []string `json:"tags,omitempty"`
	Position         int      `json:"position,omitempty"`
	DeviceType       int      `json:"device_type,omitempty"`
	Site             int      `json:"site,omitempty"`
	PrimaryIP4       int      `json:"primary_ip4,omitempty"`
	PrimaryIP6       int      `json:"primary_ip6,omitempty"`
	Cluster          int      `json:"cluster,omitempty"`
	VirtualChassis   int      `json:"virtual_chassis,omitempty"`
	VcPosition       int      `json:"vc_position,omitempty"`
	VcPriority       int      `json:"vc_priority,omitempty"`
	Platform         int      `json:"platform,omitempty"`
	Tenant           int      `json:"tenant,omitempty"`
	Rack             int      `json:"rack,omitempty"`
	DeviceRole       int      `json:"device_role,omitempty"`
}

// DeviceFilter is used to filter dcim_device_list query to the Netbox API
type DeviceFilter struct {
	// User specific filters
	ID                  string `schema:"id,omitempty"`
	Name                string `schema:"name,omitempty"`
	AssetTag            string `schema:"asset_tag,omitempty"`
	Face                string `schema:"face,omitempty"`
	Position            string `schema:"position,omitempty"`
	VcPosition          string `schema:"vc_position,omitempty"`
	VcPriority          string `schema:"vc_priority,omitempty"`
	TenantGroupID       string `schema:"tenant_group_id,omitempty"`
	TenantGroup         string `schema:"tenant_group,omitempty"`
	TenantID            string `schema:"tenant_id,omitempty"`
	Tenant              string `schema:"tenant,omitempty"`
	IDIn                string `schema:"id__in,omitempty"`
	Q                   string `schema:"q,omitempty"`
	ManufacturerID      string `schema:"manufacturer_id,omitempty"`
	Manufacturer        string `schema:"manufacturer,omitempty"`
	DeviceTypeID        string `schema:"device_type_id,omitempty"`
	RoleID              string `schema:"role_id,omitempty"`
	Role                string `schema:"role,omitempty"`
	RegionID            string `schema:"region_id,omitempty"`
	Region              string `schema:"region,omitempty"`
	SiteID              string `schema:"site_id,omitempty"`
	Site                string `schema:"site,omitempty"`
	RackGroupID         string `schema:"rack_group_id,omitempty"`
	RackID              string `schema:"rack_id,omitempty"`
	ClusterID           string `schema:"cluster_id,omitempty"`
	Model               string `schema:"model,omitempty"`
	Status              string `schema:"status,omitempty"`
	IsfullDepth         string `schema:"is_full_depth,omitempty"`
	MacAddress          string `schema:"mac_address,omitempty"`
	Serial              string `schema:"serial,omitempty"`
	HasPrimaryIP        string `schema:"has_primary_ip,omitempty"`
	VirtualChassiID     string `schema:"virtual_chassis_id,omitempty"`
	VirtualChassiMember string `schema:"virtual_chassis_member,omitempty"`
	ConsolePorts        string `schema:"console_ports,omitempty"`
	ConsoleServerPorts  string `schema:"console_server_ports,omitempty"`
	PowerPorts          string `schema:"power_ports,omitempty"`
	PowerOutlets        string `schema:"power_outlets,omitempty"`
	Interfaces          string `schema:"interfaces,omitempty"`
	PassThroughPorts    string `schema:"pass_through_ports,omitempty"`
	Tag                 string `schema:"tag,omitempty"`

	Offset int `schema:"offset,omitempty"`
	Limit  int `schema:"limit,omitempty"`
}

const devicesPath = dcimPath + "/devices"

// List devices. DeviceFilter is used to list based on filter queries.
func (s *DevicesService) List(ctx context.Context, f *DeviceFilter) (*Devices, error) {
	var devices Devices
	var query string
	var req *http.Request
	var err error

	encoder := schema.NewEncoder()

	query = ""
	if f != nil {
		form := url.Values{}
		err = encoder.Encode(f, form)
		if err != nil {
			return &devices, err
		}
		query = form.Encode()
	}

	req, err = s.client.newRequest(ctx, "GET", devicesPath, query, nil)
	if err != nil {
		return &devices, err
	}

	_, err = s.client.do(req, &devices)
	if err != nil {
		return &devices, err
	}

	return &devices, nil
}

// Create a device
func (s *DevicesService) Create(ctx context.Context, c *NewDevice) error {
	var err error
	var req *http.Request

	req, err = s.client.newRequest(ctx, "POST", devicesPath, "", c)
	if err != nil {
		return fmt.Errorf("unable to create request: %w", err)
	}

	_, err = s.client.do(req, nil)
	if err != nil {
		return fmt.Errorf("unable to do request: %w", err)
	}

	return nil
}

// Update a device
func (s *DevicesService) Update(ctx context.Context, id string, c *UpdateDevice) error {
	var req *http.Request
	var err error

	path := fmt.Sprintf("%s/%s", devicesPath, id)

	req, err = s.client.newRequest(ctx, "PATCH", path, "", c)
	if err != nil {
		return fmt.Errorf("unable to create request: %w", err)
	}

	_, err = s.client.do(req, nil)
	if err != nil {
		return fmt.Errorf("unable to do request: %w", err)
	}

	return nil
}