53e550f7d8
* uplink docs Change-Id: I67414c9e91b158ba1c120188aeb41b2907282431 * review Change-Id: I34b2185e261e3425beb5099f0a161f988d920966
81 lines
1.8 KiB
Go
81 lines
1.8 KiB
Go
// Copyright (C) 2019 Storj Labs, Inc.
|
|
// See LICENSE for copying information.
|
|
|
|
package uplink_test
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
"io"
|
|
"os"
|
|
|
|
"github.com/zeebo/errs"
|
|
|
|
"storj.io/storj/lib/uplink"
|
|
"storj.io/storj/pkg/storj"
|
|
)
|
|
|
|
func ListBucketsExample(ctx context.Context,
|
|
satelliteAddress, apiKey string,
|
|
cfg *uplink.Config, out io.Writer) (err error) {
|
|
|
|
errCatch := func(fn func() error) { err = errs.Combine(err, fn()) }
|
|
|
|
// First, create an Uplink handle.
|
|
ul, err := uplink.NewUplink(ctx, cfg)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
defer errCatch(ul.Close)
|
|
|
|
// Then, parse the API key. API keys are "macaroons" that allow you to create
|
|
// new, restricted API keys.
|
|
key, err := uplink.ParseAPIKey(apiKey)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
// Next, open the project in question. Projects are identified by a specific
|
|
// Satellite and API key
|
|
p, err := ul.OpenProject(ctx, satelliteAddress, key)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
defer errCatch(p.Close)
|
|
|
|
// Last, list the buckets! Bucket listing is paginated, so you'll need to
|
|
// use pagination.
|
|
list := uplink.BucketListOptions{
|
|
Direction: storj.Forward}
|
|
for {
|
|
result, err := p.ListBuckets(ctx, &list)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
for _, bucket := range result.Items {
|
|
fmt.Fprintf(out, "Bucket: %v\n", bucket.Name)
|
|
}
|
|
if !result.More {
|
|
break
|
|
}
|
|
list = list.NextPage(result)
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
func Example_listBuckets() {
|
|
// The satellite address is the address of the satellite your API key is
|
|
// valid on
|
|
satelliteAddress := "us-central-1.tardigrade.io:7777"
|
|
|
|
// The API key can be created in the web interface
|
|
apiKey := "qPSUM3k0bZyOIyil2xrVWiSuc9HuB2yBP3qDrA2Gc"
|
|
|
|
err := ListBucketsExample(context.Background(), satelliteAddress, apiKey,
|
|
&uplink.Config{}, os.Stdout)
|
|
if err != nil {
|
|
panic(err)
|
|
}
|
|
}
|