You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
minio/pkg/madmin
Anis Elleuch 83abad0b37 admin: ServerInfo() returns info for each node (#4150) 8 years ago
..
examples Add disksUnavailable healStatus const (#3990) 8 years ago
API.md admin: ServerInfo() returns info for each node (#4150) 8 years ago
README.md admin: Add service Set Credentials API (#3580) 8 years ago
api-error-response.go admin: Add service Set Credentials API (#3580) 8 years ago
api.go cleanup: All conditionals simplified under pkg. (#3875) 8 years ago
api_test.go admin: Add missing madmin examples and API docs. (#3483) 8 years ago
config-commands.go admin: Set Config returns errSet and errMsg (#3822) 8 years ago
constants.go admin: Add missing madmin examples and API docs. (#3483) 8 years ago
generic-commands.go madmin: Do not require SSL to set credentials (#3879) 8 years ago
heal-commands.go Return possible states a heal operation (#4045) 8 years ago
info-commands.go admin: ServerInfo() returns info for each node (#4150) 8 years ago
lock-commands.go Remove duration field from lock instrumentation (#4111) 8 years ago
lock-commands_test.go Implement list, clear locks REST API w/ pkg/madmin support (#3491) 8 years ago
service-commands.go admin: Move SetCredentials from Service to Generic (#3805) 8 years ago
utils.go admin: Add service Set Credentials API (#3580) 8 years ago

README.md

Minio Admin Library. Slack

The Minio Admin Golang Client SDK provides APIs to manage Minio services.

This quickstart guide will show you how to install the Minio Admin client SDK, connect to Minio admin service, and provide a walkthrough of a simple file uploader.

This document assumes that you have a working Golang setup.

Download from Github


go get -u github.com/minio/minio/pkg/madmin

Initialize Minio Admin Client

You need four items to connect to Minio admin services.

Parameter Description
endpoint URL to object storage service.
accessKeyID Access key is the user ID that uniquely identifies your account.
secretAccessKey Secret key is the password to your account.
secure Set this value to 'true' to enable secure (HTTPS) access.

package main

import (
	"github.com/minio/minio/pkg/madmin"
	"log"
)

func main() {
	endpoint := "your-minio.example.com:9000"
	accessKeyID := "YOUR-ACCESSKEYID"
	secretAccessKey := "YOUR-SECRETKEY"
	useSSL := true

	// Initialize minio admin client object.
        madmClnt, err := madmin.New(endpoint, accessKeyID, secretAccessKey, useSSL)
	if err != nil {
		log.Fatalln(err)
	}

	log.Println("%v", madmClnt) // Minio admin client is now setup


Quick Start Example - Service Status.

This example program connects to minio server, gets the current disk status.

We will use the Minio server running at https://your-minio.example.com:9000 in this example. Feel free to use this service for testing and development. Access credentials shown in this example are open to the public.

ServiceStatus.go

package main

import (
	"log"

	"github.com/minio/minio/pkg/madmin"
)

func main() {
	endpoint := "your-minio.example.com:9000"
	accessKeyID := "YOUR-ACCESSKEYID"
	secretAccessKey := "YOUR-SECRETKEY"
	useSSL := true

	// Initialize minio admin client.
	mdmClnt, err := madmin.New(endpoint, accessKeyID, secretAccessKey, useSSL)
	if err != nil {
		log.Fatalln(err)
	}

	st, err := madmClnt.ServiceStatus()
	if err != nil {
		log.Fatalln(err)
	}
	log.Printf("%#v\n", st)

}

Run ServiceStatus


go run service-status.go
2016/12/20 16:46:01 madmin.ServiceStatusMetadata{Total:177038229504, Free:120365559808, Backend:struct { Type madmin.BackendType; OnlineDisks int; OfflineDisks int; ReadQuorum int; WriteQuorum int }{Type:1, OnlineDisks:0, OfflineDisks:0, ReadQuorum:0, WriteQuorum:0}}

API Reference

API Reference : Service Operations

Full Examples

Full Examples : Service Operations

Contribute

Contributors Guide