gcsblob

Overview ¶

Package gcsblob provides a blob implementation that uses GCS. Use OpenBucket to construct a blob.Bucket.

Open URLs ¶

For blob.Open URLs, gcsblob registers for the scheme "gs"; URLs start with "gs://".

The URL's Host is used as the bucket name. The following query options are supported:

• cred_path: Sets path to the Google credentials file. If unset, default credentials are loaded. See https://cloud.google.com/docs/authentication/production.
• access_id: Sets Options.GoogleAccessID.
• private_key_path: Sets path to a private key, which is read and used to set Options.PrivateKey.

Example URL:

gs://mybucket

As ¶

gcsblob exposes the following types for As:

• Bucket: *storage.Client
• Error: *googleapi.Error
• ListObject: storage.ObjectAttrs
• ListOptions.BeforeList: *storage.Query
• Reader: storage.Reader
• Attributes: storage.ObjectAttrs
• WriterOptions.BeforeWrite: *storage.Writer

package main

import (
	"context"

	"gocloud.dev/blob/gcsblob"
	"gocloud.dev/gcp"
)

func main() {
	ctx := context.Background()

	// Load credentials for GCP.
	// This example uses the default approach; see
	// https://cloud.google.com/docs/authentication/production
	// for more info on alternatives.
	creds, err := gcp.DefaultCredentials(ctx)
	if err != nil {
		return
	}

	// Create an HTTP client.
	// This example uses the default HTTP transport and the credentials created
	// above.
	client, err := gcp.NewHTTPClient(gcp.DefaultTransport(), gcp.CredentialsTokenSource(creds))
	if err != nil {
		return
	}

	// Create a *blob.Bucket.
	_, _ = gcsblob.OpenBucket(ctx, "my-bucket", client, nil)

}