Skip to content
ibm-cos-sdk-go
Go HTML JavaScript CSS Makefile Ruby Roff
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Release 1.1.0 Jun 3, 2019
aws Release 1.3.1 Dec 6, 2019
awsmigrate/awsmigrate-renamer Release 1.3.1 Dec 6, 2019
awstesting Release 1.3.1 Dec 6, 2019
doc-src Release 1.0.1 Mar 28, 2019
example Release 1.3.1 Dec 6, 2019
internal Release 1.3.0 Nov 6, 2019
models Release 1.3.1 Dec 6, 2019
private Release 1.3.1 Dec 6, 2019
service Release 1.3.1 Dec 6, 2019
.gitignore Release 1.0.1 Mar 28, 2019
.godoc_config Release 1.0.0 Feb 22, 2019
.yardopts Release 1.2.0 Sep 6, 2019
CHANGELOG.md Release 1.3.1 Dec 6, 2019
Gemfile Release 1.2.0 Sep 6, 2019
Gopkg.lock Release 1.0.1 Mar 28, 2019
Gopkg.toml Release 1.0.1 Mar 28, 2019
LICENSE.txt Release 1.0.0 Feb 22, 2019
Makefile Release 1.3.1 Dec 6, 2019
NOTICE.txt Release 1.0.1 Mar 28, 2019
README.md Release 1.3.0 Nov 6, 2019
doc.go Release 1.3.0 Nov 6, 2019
go.mod Release 1.0.1 Mar 28, 2019
go.sum Release 1.3.1 Dec 6, 2019

README.md

IBM Cloud Object Storage - Go SDK

This package allows Go developers to write software that interacts with IBM Cloud Object Storage. It is a fork of the AWS SDK for Go library and can stand as a drop-in replacement if the application needs to connect to object storage using an S3-like API and does not make use of other AWS services.

Documentation

For release notes, see the CHANGELOG.

Quick start

You'll need:

  • An instance of COS.
  • An API key from IBM Cloud Identity and Access Management with at least Writer permissions.
  • The ID of the instance of COS that you are working with.
  • Token acquisition endpoint
  • Service endpoint

These values can be found in the IBM Cloud Console by generating a 'service credential'.

Archive Tier Support

You can automatically archive objects after a specified length of time or after a specified date. Once archived, a temporary copy of an object can be restored for access as needed. Restore time may take up to 15 hours.

An archive policy is set at the bucket level by calling the PutBucketLifecycleConfiguration method on a client instance. A newly added or modified archive policy applies to new objects uploaded and does not affect existing objects. For more detail, see the documentation.

Immutable Object Storage

Users can configure buckets with an Immutable Object Storage policy to prevent objects from being modified or deleted for a defined period of time. The retention period can be specified on a per-object basis, or objects can inherit a default retention period set on the bucket. It is also possible to set open-ended and permanent retention periods. Immutable Object Storage meets the rules set forth by the SEC governing record retention, and IBM Cloud administrators are unable to bypass these restrictions. For more detail, see the IBM Cloud documentation.

Note: Immutable Object Storage does not support Aspera transfers via the SDK to upload objects or directories at this stage.

Getting the SDK

Use go get to retrieve the SDK to add it to your GOPATH workspace, or project's Go module dependencies. The SDK requires a minimum version of Go 1.11.

go get github.com/IBM/ibm-cos-sdk-go

To update the SDK use go get -u to retrieve the latest version of the SDK.

go get -u github.com/IBM/ibm-cos-sdk-go

Example code

Create a file main.go, replacing your own values for API key, instance ID, and bucket name:

package main

import (
	"fmt"

	"github.com/IBM/ibm-cos-sdk-go/aws"
	"github.com/IBM/ibm-cos-sdk-go/aws/credentials/ibmiam"
	"github.com/IBM/ibm-cos-sdk-go/aws/session"
	"github.com/IBM/ibm-cos-sdk-go/service/s3"
)

const (
	apiKey            = "<API_KEY>"
	serviceInstanceID = "<RESOURCE_INSTANCE_ID>"
	authEndpoint      = "https://iam.cloud.ibm.com/identity/token"
	serviceEndpoint   = "https://s3-api.us-geo.objectstorage.softlayer.net"
)

func main() {

	newBucket := "new-bucketee"
	newColdBucket := "new-cold-bucketee"

	conf := aws.NewConfig().
		WithEndpoint(serviceEndpoint).
		WithCredentials(ibmiam.NewStaticCredentials(aws.NewConfig(),
			authEndpoint, apiKey, serviceInstanceID)).
		WithS3ForcePathStyle(true)

	sess := session.Must(session.NewSession())
	client := s3.New(sess, conf)

	input := &s3.CreateBucketInput{
		Bucket: aws.String(newBucket),
	}
	client.CreateBucket(input)

	input2 := &s3.CreateBucketInput{
		Bucket: aws.String(newColdBucket),
		CreateBucketConfiguration: &s3.CreateBucketConfiguration{
			LocationConstraint: aws.String("us-cold"),
		},
	}
	client.CreateBucket(input2)

	d, _ := client.ListBuckets(&s3.ListBucketsInput{})
	fmt.Println(d)
}

From the command line, run go run main.go. You should see a list of your buckets.

Getting Help

Feel free to use GitHub issues for tracking bugs and feature requests, but for help please use one of the following resources:

License

This SDK is distributed under the Apache License, Version 2.0, see LICENSE.txt and NOTICE.txt for more information.

You can’t perform that action at this time.