deviceid

Documentation

Overview

Package deviceid resolves the hardware UUID of the host running doctl for the hosted-agents API. Get returns "" on any failure; doctl never fails on a missing UUID. The lookup is cached per process.

Index

• Constants
• func Get() string
• func NewTransport(base http.RoundTripper, id string) http.RoundTripper
• type Transport
  • func (t *Transport) RoundTrip(req *http.Request) (*http.Response, error)

Constants

const EnvDisable = "DOCTL_DISABLE_DEVICE_ID"

EnvDisable disables the lookup when set to "1", "true", or "yes".

const HeaderName = "X-Device-UUID"

HeaderName is coordinated with the harness-api server. Rename in lockstep.

Functions

func Get

func Get() string

Get returns the host hardware UUID, or "" if unavailable / opted out.

func NewTransport

func NewTransport(base http.RoundTripper, id string) http.RoundTripper

NewTransport returns base unchanged when id is empty so callers can chain unconditionally.

Types

type Transport

type Transport struct {
	Base http.RoundTripper
	ID   string
}

Transport stamps HeaderName on requests under agentsBase.

func (*Transport) RoundTrip

func (t *Transport) RoundTrip(req *http.Request) (*http.Response, error)