The Go SDK is currently in experimental status. If you would like to provide feedback, please reach out to us with your suggestions and comments on our Discord.

Note: You are viewing documentation for version v0 of Go. View the latest version.

Go - NewBucket()

Create a new bucket for storing and retrieving files.

import (
  "fmt"

  "github.com/nitrictech/go-sdk/nitric"
)

func main() {
  bucket, err := nitric.NewBucket("bucket-name").With(nitric.BucketWriting, nitric.BucketReading, nitric.BucketDeleting)
  if err != nil {
    return
  }

  if err := nitric.Run(); err != nil {
    fmt.Println(err)
  }
}

Parameters

Name
name
Required
Required
Type
string
Description
The unique name of this bucket within the app. Subsequent calls to NewBucket with the same name will return the same object.

Access

All Nitric resources provide access permissions you can use to specify the level of access your code needs to the resource. See here for details Access Control documentation.

Available permissions:

BucketReading

This permission allows your function to read files from the bucket

BucketWriting

This permission allows your function to write files to the bucket

BucketDeleting

This permission allows your function to delete files from the bucket

Working with files

See the following for examples on working with files in a bucket: