Jayin/moreexamples (#92)

* follow golang example naming standards

* add retry logic

* clean up resources and add object storage sample

* split the pagination sample

* update launch instance output

* clean up VCN after created

* add sample for raw request

* forgot remove the ocid

* add document about how to run samples

* fix a typo

Author: jasonyin

common/client.go

@@ -83,7 +83,7 @@ func defaultHTTPDispatcher() http.Client {
 
 func defaultBaseClient(provider KeyProvider) BaseClient {
 	dispatcher := defaultHTTPDispatcher()
-	signer := defaultRequestSigner(provider)
+	signer := DefaultRequestSigner(provider)
 	return newBaseClient(signer, &dispatcher)
 }
 

common/http_signer.go

@@ -50,7 +50,8 @@ var (
 	}
 )
 
-func defaultRequestSigner(provider KeyProvider) HTTPRequestSigner {
+// DefaultRequestSigner creates a signer with default parameters.
+func DefaultRequestSigner(provider KeyProvider) HTTPRequestSigner {
 	return RequestSigner(provider, defaultGenericHeaders, defaultBodyHeaders)
 }
 

example/.env.sample

@@ -0,0 +1,11 @@
+# The Availability Domain of the instance. Example: Uocm:PHX-AD-1
+# OCI_AVAILABILITY_DOMAIN=Uocm:PHX-AD-1
+OCI_AVAILABILITY_DOMAIN=
+
+# The OCID of the compartment.
+# OCI_COMPARTMENT_ID=ocid1.compartment.oc1..thisisafakeocidaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
+OCI_COMPARTMENT_ID=
+
+# The OCID of the root compartment.
+# OCI_ROOT_COMPARTMENT_ID=ocidv1:tenancy:oc1:phx:00000000000000aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
+OCI_ROOT_COMPARTMENT_ID=

example/example_audit_test.go

@@ -0,0 +1,36 @@
+// Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved.
+//
+// Example code for Audit API
+//
+package example
+
+import (
+	"context"
+	"fmt"
+	"time"
+
+	"github.com/oracle/oci-go-sdk/audit"
+	"github.com/oracle/oci-go-sdk/common"
+	"github.com/oracle/oci-go-sdk/example/helpers"
+)
+
+func ExampleListEvents() {
+	c, clerr := audit.NewAuditClientWithConfigurationProvider(common.DefaultConfigProvider())
+	helpers.LogIfError(clerr)
+
+	// list events for last 5 hour
+	req := audit.ListEventsRequest{
+		CompartmentId: helpers.CompartmentID(),
+		StartTime:     &common.SDKTime{time.Now().Add(time.Hour * -5)},
+		EndTime:       &common.SDKTime{time.Now()},
+	}
+
+	_, err := c.ListEvents(context.Background(), req)
+	helpers.LogIfError(err)
+
+	//log.Printf("events returned back: %v", resp.Items)
+	fmt.Println("list events completed")
+
+	// Output:
+	// list events completed
+}

example/example_core_pagination_test.go

@@ -0,0 +1,51 @@
+// Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved.
+//
+// Example code for Core Services API
+//
+package example
+
+import (
+	"context"
+	"fmt"
+	"log"
+
+	"github.com/oracle/oci-go-sdk/common"
+	"github.com/oracle/oci-go-sdk/core"
+	"github.com/oracle/oci-go-sdk/example/helpers"
+)
+
+// ExampleListShapes_Pagination demostrate how to use page parameter
+func ExampleListShapes_Pagination() {
+	c, err := core.NewComputeClientWithConfigurationProvider(common.DefaultConfigProvider())
+	helpers.LogIfError(err)
+
+	request := core.ListShapesRequest{
+		CompartmentId: helpers.CompartmentID(),
+	}
+
+	// to show how pagination works, reduce number of items to return in a paginated "List" call
+	request.Limit = common.Int(2)
+
+	listShapesFunc := func(request core.ListShapesRequest) (core.ListShapesResponse, error) {
+		return c.ListShapes(context.Background(), request)
+	}
+
+	for r, err := listShapesFunc(request); ; r, err = listShapesFunc(request) {
+		helpers.LogIfError(err)
+
+		log.Printf("list shapes returns: %v", r.Items)
+
+		if r.OpcNextPage != nil {
+			// if there are more items in next page, fetch items from next page
+			request.Page = r.OpcNextPage
+		} else {
+			// no more result, break the loop
+			break
+		}
+	}
+
+	fmt.Println("list shapes completed")
+
+	// Output:
+	// list shapes completed
+}