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.
Go - Bucket.On()
Create a new bucket notification trigger when certain files are created or deleted.
import (
"context"
"fmt"
"github.com/nitrictech/go-sdk/nitric/storage"
"github.com/nitrictech/go-sdk/nitric"
)
func main() {
assets := nitric.NewBucket("assets")
readableAssets, err := nitric.NewBucket("assets").Allow(nitric.BucketRead)
if err != nil {
return
}
assets.On(storage.DeleteNotification, "*", func(ctx *storage.Ctx) {
fmt.Printf("a file named %s was deleted\n", ctx.Request.Key())
})
assets.On(storage.WriteNotification, "/images/cat", func(ctx *storage.Ctx) {
fmt.Printf("a cat image was written")
})
assets.On(storage.WriteNotification, "/images/dog", func(ctx *storage.Ctx) error {
dogImage, err := readableAssets.Read(context.TODO(), ctx.Request.Key())
if err != nil {
return err
}
fmt.Println(dogImage)
return nil
})
if err := nitric.Run(); err != nil {
fmt.Println(err)
}
}
Parameters
- Name
notificationType
- Required
- Required
- Type
- WriteNotification or DeleteNotification
- Description
The notification type for a triggered event, either on a file write or a file delete.
- Name
notificationPrefixFilter
- Required
- Required
- Type
- string
- Description
The file prefix filter that must match for a triggered event. If multiple filters overlap across notifications, an error will be thrown when registering the resource.
- Name
middleware
- Required
- Required
- Type
- interface{}
- Description
The middleware (code) to be triggered by the bucket notification being triggered.
Available trigger types
WriteNotification
Run when a file in the bucket is created using: Bucket.Write()
DeleteNotification
Run when a file in the bucket is deleted using: Bucket.Delete()
Trigger type cloud mapping
Permission | AWS | GCP | Azure |
---|---|---|---|
write | s3:ObjectCreated:* | OBJECT_FINALIZE | Microsoft.Storage.BlobCreated |
delete | s3:ObjectRemoved:* | OBJECT_DELETE | Microsoft.Storage.BlobDeleted |