Hvernig á að nota Vultr Go bókasafnið til að fá upplýsingar um netþjón

• Kynning
• Forkröfur
• Markmið
• Skref 1: Að búa til verkefnið
• Skref 2: Að hlaða niður bókasafninu
• Skref 3: Að fá API lykilinn þinn
• Skref 4: Að búa til forritaskrána
• Skref 5: Uppsetning API biðlarans
• Skref 6: Notkun API
• Skref 7: Sýnir upplýsingarnar
• Skref 8: Hlaupandi
• Niðurstaða

Kynning

Opinbera Vultr Go bókasafnið er hægt að nota til að hafa samskipti við Vultr API . Vultr API gerir þér kleift að stjórna auðlindum sem tengjast reikningnum þínum, þar á meðal netþjónum, dns, eldvegg, skyndimyndum, neti og fleira. Þessi kennsla mun gefa kynningu á notkun opinbera Go API biðlarans með því að búa til einfalt forrit til að fá upplýsingar um netþjóna þína.

Forkröfur

• Tölva sem keyrir Windows, Linux eða macOS með Go 1.12+ uppsett.
• Grunnþekking á forritun.
• Valfrjálst: IDE sem styður Go (til dæmis Visual Studio Code, emacs eða Atom).

Markmið

• Til að læra hvernig á að nota opinbera Vultr API bókasafnið.
• Til að skrifa forrit til að skoða upplýsingar um miðlara.

Skref 1: Að búa til verkefnið

Fyrst munum við byrja á því að búa til nýja einingu (verkefni). Venjulega myndirðu nota slóðina á geymslu fyrir kóðann þinn sem einingaheiti, en það er utan gildissviðs þessa kennslu. Í bili munum við nota serverinfo sem einingaheitið .

Til að búa til verkefnið skaltu keyra eftirfarandi skipanir:

# Create the folder in the current directory. mkdir serverinfo # Enter the new folder. cd serverinfo # Initialize the module. go mod init serverinfo

Skref 2: Að hlaða niður bókasafninu

Næst munum við hlaða niður API bókasafninu frá GitHub (kóðahýsingarsíðu). Til að hlaða niður bókasöfnum þarftu að nota go getskipunina. Þetta mun sjálfkrafa hlaða niður bókasafninu og ósjálfstæði þess á meðan því er bætt við go.mod skrána. Í sömu flugstöðinni og þú opnaðir áðan skaltu slá inn eftirfarandi skipun:

go get github.com/vultr/govultr

Skref 3: Að fá API lykilinn þinn

Til að nota API biðlarann ​​þarftu API lykilinn þinn. Þú getur sótt API lykilinn þinn á API flipanum í Account hlutanum á mælaborðinu þínu . Þú þarft einnig að heimila IP tölu þína til að nota API lykilinn. Þú getur fundið IP tölu þína með því að fara á ifconfig.me . Athugaðu að þú ert að leita að opinberu IP-tölunni þinni, ekki þinni persónulegu. Einka IP- talið þitt er það sem þú finnur í netstillingum þínum á tölvunni þinni og er á einu af eftirfarandi CIDR sviðum: 10.0.0.0/8 , 172.16.0.0/12 , eða 192.168.0.0/16 .

Þegar þú hefur fengið IP tölu þína skaltu bæta því við undir hlutanum Aðgangsstýring . Sláðu inn í reitinn á eftir /32 . /32er netmask merking 255.255.255.255. Þetta þýðir að aðeins IP-talan þín er innifalin í bilinu.

Viðvörun: Verndaðu API lykilinn þinn eins og þú myndir vernda lykilorðið þitt. API lykillinn hefur aðgang að öllum reikningnum þínum, þar á meðal innheimtu, netþjónum og geymslu.

Skref 4: Að búa til forritaskrána

Nú ætlum við að byrja að vinna að forritinu. Opnaðu möppuna sem við bjuggum til í ritstjóranum þínum og búðu til skrá sem heitir main.go.

Inni í skránni skaltu slá inn eða afrita og líma eftirfarandi kóða:

package main import ( "context" "fmt" "os" "github.com/vultr/govultr" ) func main() { }

The package mainsegir Go að við erum að búa til skipun, ekki bókasafn. Innflutningsyfirlýsingin lýsir yfir ósjálfstæði sem við munum nota. func main()er aðgerðin sem kallast þegar við keyrum forritið okkar.

Skref 5: Uppsetning API biðlarans

Næsta skref er að frumstilla API biðlarann. Til að gera þetta þurfum við að nota govultr.NewClient(http.Client, string) aðgerðina. Bættu við eftirfarandi kóða inni í aðal() fallinu:

client := govultr.NewClient(nil, "YOURAPIKEY")

Skiptu út YOURAPIKEYfyrir API lyklinum sem þú sóttir áðan.

Við skulum skoða þennan kóða aðeins nánar. Vinstra megin við :=, höfum við client. Það er nafnið á breytu . Breyta geymir gildi. Hægra megin höfum við aðgerðarkall til govultr.NewClient . Fyrsta færibreytan er núll, vegna þess að við þurfum ekki að breyta sjálfgefna HTTP biðlaranum. Önnur færibreytan er API lykillinn sem við erum að nota til að auðkenna okkur. The :=stjórnandi úthlutar hægri hlið til vinstri, í þessu tilfelli, niðurstöðu virka símtalinu til client.

Skref 6: Notkun API

Dagskráin okkar gerir enn ekki neitt. Til að gera það gagnlegt ætlum við að sækja upplýsingar um netþjóna okkar frá Vultr. Við munum nota govultr.Client.Server.List(context.Context) ([]govultr.Server, villa) aðgerðina. Bættu við eftirfarandi kóða í lok aðal() fallsins:

servers, err := client.Server.List(context.Background()) if err != nil { fmt.Fprintf(os.Stderr, "Error: %v\n", err) os.Exit(1) }

Í þessum kóða erum við að kalla á API aðgerðina til að sækja upplýsingar um netþjóninn. Ekki hafa áhyggjur af merkingu samhengisins ennþá, þar sem það er lengra efni. Í bili, það eina sem við þurfum að vita er að samhengið stjórnar því hvernig API biðlarinn keyrir. context.Background() skilar auðu samhengi . Eftir að við höfum sótt netþjónsupplýsingarnar í breyturnar tvær, netþjónar og err , athugum við hvort það hafi verið villa. Ef svo er, segjum við notandanum frá villunni og hættum með kóða 1 (villu).

Skref 7: Sýnir upplýsingarnar

Nú þegar við erum með fjölda netþjóna í netþjónabreytunni ( []govultr.Server ), getum við í raun birt hana. Bættu við eftirfarandi kóða í lok aðal() fallsins:

fmt.Println("Servers:") for _, server := range servers { fmt.Printf(" %s (%s) - %s - $%s pending charges - %.2f/%s GB bandwidth\n", server.Label, server.MainIP, server.Location, server.PendingCharges, server.CurrentBandwidth, server.AllowedBandwidth, ) }

Fyrst prentum (sýnum) við haus, Servers:. Þá erum við lykkju yfir netþjónum fylki, hunsa vísitöluna með því að úthluta henni til _, og framselja núverandi miðlara til miðlara breytu. Inni í lykkjunni sýnum við merki miðlarans, IP-tölu, staðsetningu, biðgjöld, núverandi bandbreidd og leyfilega bandbreidd. Til að gera þetta efficently notum við snið strengi , band sem lítur út eins og " %s (%s) - %s - $%s pending charges - %.2f/%s GB bandwidth\n". The %sleið til að skipta á næsta band, en %.2fþýðir að prenta næstu fljóta (heiltala) námundað að 2 aukastöfum. Afgangurinn af sniðstrengnum er prentaður bókstaflega (eins og er).

Skref 8: Hlaupandi

Á þessum tímapunkti ætti kóðinn þinn að líta svona út:

package main import ( "context" "fmt" "os" "github.com/vultr/govultr" ) func main() { client := govultr.NewClient(nil, "YOURAPIKEY") servers, err := client.Server.List(context.Background()) if err != nil { fmt.Fprintf(os.Stderr, "Error: %v\n", err) os.Exit(1) } fmt.Println("Servers:") for _, server := range servers { fmt.Printf(" %s (%s) - %s - $%s pending charges - %.2f/%s GB bandwidth\n", server.Label, server.MainIP, server.Location, server.PendingCharges, server.CurrentBandwidth, server.AllowedBandwidth, ) } }

Við getum nú keyrt kóðann. Farðu aftur í flugstöðina sem við opnuðum áðan og sláðu inn skipunina go run. Úttakið mun líkjast eftirfarandi:

Servers: server1 (198.51.100.4) - New Jersey - $3.70 pending charges - 17.64/1000 GB bandwidth server2 (198.51.100.9) - Toronto - $1.70 pending charges - 3.24/500 GB bandwidth

Ef þú færð villu skaltu ganga úr skugga um að API lykillinn þinn og IP tölu séu réttar.

Niðurstaða

Á þessum tímapunkti muntu hafa lært grunnatriði hvernig á að nota opinbera API biðlarann ​​og skrifað forrit sem mun birta upplýsingar um netþjóna á reikningnum þínum.

Frekari skref

Héðan geturðu gert miklu meira. Til dæmis gætirðu skrifað forrit til að útvega nýjan netþjón þegar minnið er lítið. Þú gætir skrifað forrit til að uppfæra þjóninn þinn sjálfkrafa þegar þú ert með litla bandbreidd eða geymslupláss. Þú gætir jafnvel skrifað tól til að uppfæra DNS færslur sjálfkrafa út frá núverandi IP þinni.

Fyrir frekari upplýsingar um govultr bókasafnið er að finna govultr bókasafnsskjölin á godoc .

govultr er opinn uppspretta verkefni . Ef þú finnur einhverjar villur í govultr geturðu tilkynnt þær á GitHub . Þú getur líka lagt inn kóðann beint með því að senda inn beiðni um drátt .