go-redfish-api-idrac

go-redfish-api-idrac

iDRAC Redfish API client library written in Go.

Table of Contents

• Getting Started
  • API Client
• References

Getting Started

Tested with:

• Integrated Dell Remote Access Controller, Redfish API Version: 1.4.0

API Client

Install the client by running:

go get -u github.com/greenpau/go-redfish-api-idrac/cmd/go-redfish-api-idrac-client

Prior to using the client, add your credentials via the following environment variables:

export IDRAC_API_USERNAME=admin
export IDRAC_API_PASSWORD=secret

Additionally, there is an option for adding host via environment variables:

export IDRAC_API_HOST=10.10.10.10

Alternative, the credentials may be kept in config.yaml configuration file. The binary searches for the file $HOME/.redfish directory.

Next, use the API in the following manner:

bin/go-redfish-api-idrac-client --host 10.10.10.10 --operation get-info --log.level debug
bin/go-redfish-api-idrac-client --host 10.10.10.10 --operation get-systems --log.level debug

The list of available operations (--operation argument) follows:

• get-info: Get basic information about a remote API endpoint
• get-system: Get system information

Additionally, the --resource argument accepts any valid Redfish API Endpoint:

go-redfish-api-idrac-client --host 10.10.10.10 --resource "/redfish/v1/Systems" --log.level debug
go-redfish-api-idrac-client --host 10.10.10.10 --resource "/redfish/v1/Systems/System.Embedded.1" --log.level debug

References

• Open Data Protocol (OData)
• OData Version 4.01 Documentation