ec2metadata

Documentation

Index

• Constants
• type InstanceAction
• type NodeMetadata
• type ScheduledEventDetail
• type Service
  • func New(metadataURL string, tries int) *Service
  • func (e *Service) GetMetadataInfo(path string) (info string, err error)
  • func (e *Service) GetNodeMetadata() NodeMetadata
  • func (e *Service) GetScheduledMaintenanceEvents() ([]ScheduledEventDetail, error)
  • func (e *Service) GetSpotITNEvent() (instanceAction *InstanceAction, err error)
  • func (e *Service) Request(contextPath string) (*http.Response, error)

Constants

const (
	// SpotInstanceActionPath is the context path to spot/instance-action within IMDS
	SpotInstanceActionPath = "/latest/meta-data/spot/instance-action"
	// ScheduledEventPath is the context path to events/maintenance/scheduled within IMDS
	ScheduledEventPath = "/latest/meta-data/events/maintenance/scheduled"
	// InstanceIDPath path to instance id
	InstanceIDPath = "/latest/meta-data/instance-id"
	// InstanceTypePath path to instance type
	InstanceTypePath = "/latest/meta-data/instance-type"
	// PublicHostnamePath path to public hostname
	PublicHostnamePath = "/latest/meta-data/public-hostname"
	// PublicIPPath path to public ip
	PublicIPPath = "/latest/meta-data/public-ipv4"
	// LocalHostnamePath path to local hostname
	LocalHostnamePath = "/latest/meta-data/local-hostname"
	// LocalIPPath path to local ip
	LocalIPPath = "/latest/meta-data/local-ipv4"
	// AZPlacementPath path to availability zone placement
	AZPlacementPath = "/latest/meta-data/placement/availability-zone"
)

Types

type InstanceAction

type InstanceAction struct {
	Action string `json:"action"`
	Time   string `json:"time"`
}

InstanceAction metadata structure for json parsing

type NodeMetadata

type NodeMetadata struct {
	InstanceID       string
	InstanceType     string
	PublicHostname   string
	PublicIP         string
	LocalHostname    string
	LocalIP          string
	AvailabilityZone string
}

NodeMetadata contains information that applies to every drain event

type ScheduledEventDetail

type ScheduledEventDetail struct {
	NotBefore   string `json:"NotBefore"`
	Code        string `json:"Code"`
	Description string `json:"Description"`
	EventID     string `json:"EventId"`
	NotAfter    string `json:"NotAfter"`
	State       string `json:"State"`
}

ScheduledEventDetail metadata structure for json parsing

type Service

type Service struct {
	sync.RWMutex
	// contains filtered or unexported fields
}

Service is used to query the EC2 instance metadata service v1 and v2

func New

func New(metadataURL string, tries int) *Service

New constructs an instance of the Service client

func (*Service) GetMetadataInfo

func (e *Service) GetMetadataInfo(path string) (info string, err error)

GetMetadataInfo generic function for retrieving ec2 metadata

func (*Service) GetNodeMetadata

func (e *Service) GetNodeMetadata() NodeMetadata

GetNodeMetadata attempts to gather additional ec2 instance information from the metadata service

func (*Service) GetScheduledMaintenanceEvents

func (e *Service) GetScheduledMaintenanceEvents() ([]ScheduledEventDetail, error)

GetScheduledMaintenanceEvents retrieves EC2 scheduled maintenance events from imds

func (*Service) GetSpotITNEvent

func (e *Service) GetSpotITNEvent() (instanceAction *InstanceAction, err error)

GetSpotITNEvent retrieves EC2 spot interruption events from imds

func (*Service) Request

func (e *Service) Request(contextPath string) (*http.Response, error)

Request sends an http request to IMDSv1 or v2 at the specified path It is up to the caller to handle http status codes on the response An error will only be returned if the request is unable to be made