Add Region and Tenancy data sources with example updates

* New concept example shows how to route identity calls to the home tenancy home region

Author: ccushing

docs/examples/concepts/identity_home_resolution/main.tf

@@ -0,0 +1,46 @@
+/*
+ * This example demonstrates how to use tenancy and region data sources to route identity calls to the correct
+ * home region.
+ */
+
+variable "tenancy_ocid" {}
+variable "user_ocid" {}
+variable "fingerprint" {}
+variable "private_key_path" {}
+variable "compartment_ocid" {}
+variable "region" { default = "us-ashburn-1" }
+
+
+provider "oci" {
+  region = "${var.region}"
+  tenancy_ocid = "${var.tenancy_ocid}"
+  user_ocid = "${var.user_ocid}"
+  fingerprint = "${var.fingerprint}"
+  private_key_path = "${var.private_key_path}"
+}
+
+data "oci_identity_tenancy" "tenancy" {
+  tenancy_id = "${var.tenancy_ocid}"
+}
+
+data "oci_identity_regions" "home-region" {
+  filter {
+    name = "key"
+    values = ["${data.oci_identity_tenancy.tenancy.home_region_key}"]
+  }
+}
+
+provider "oci" {
+  alias = "home"
+  region = "${lookup(data.oci_identity_regions.home-region.regions[0], "name")}"
+  tenancy_ocid = "${var.tenancy_ocid}"
+  user_ocid = "${var.user_ocid}"
+  fingerprint = "${var.fingerprint}"
+  private_key_path = "${var.private_key_path}"
+}
+
+resource "oci_identity_user" "user1" {
+  provider = "oci.home"
+  name = "tf-example-user"
+  description = "user created by terraform"
+}

docs/examples/identity/readme.md

@@ -8,6 +8,7 @@
 ## Identity Resource and Datasource Examples
 
 This example demonstrates the following Identity concepts:
+* Show tenancy details and list OCI regions 
 * List and filter Availability Domains
 * Create and list compartments
 * Create users, add an api key and access their password

docs/examples/identity/region.tf

@@ -0,0 +1,10 @@
+/*
+ * This example file shows how to list available OCI regions.
+ */
+
+data "oci_identity_regions" "regions" {
+}
+
+output "regions" {
+  value = "${data.oci_identity_regions.regions.regions}"
+}

docs/examples/identity/tenancy.tf

@@ -0,0 +1,17 @@
+/*
+ * This example file shows how to access information on the current tenancy.
+ */
+
+data "oci_identity_tenancy" "tenancy" {
+  tenancy_id = "${var.tenancy_ocid}"
+}
+
+output "tenancy" {
+  value = <<EOF
+
+name            = ${data.oci_identity_tenancy.tenancy.name}
+description     = ${data.oci_identity_tenancy.tenancy.description}
+tenancy_id      = ${data.oci_identity_tenancy.tenancy.tenancy_id}
+home_region_key = ${data.oci_identity_tenancy.tenancy.home_region_key}
+EOF
+}

docs/identity/regions.md

@@ -0,0 +1,26 @@
+
+# oci_identity_regions
+
+## Region DataSource
+
+Gets a list of regions.
+
+### List Operation
+Lists all the regions offered by Oracle Cloud Infrastructure.
+
+The following attributes are exported:
+
+* `regions` - The list of regions.
+
+### Example Usage
+
+```
+data "oci_identity_regions" "test_regions" {
+}
+```
+### Region Reference
+
+The following attributes are exported:
+
+* `key` - The key of the region.  Allowed values are: - `PHX` - `IAD` - `FRA` - `LHR` 
+* `name` - The name of the region.  Allowed values are: - `us-phoenix-1` - `us-ashburn-1` - `eu-frankfurt-1` - `uk-london-1` 

docs/identity/tenancies.md

@@ -0,0 +1,38 @@
+
+# oci_identity_tenancies
+
+## Tenancy DataSource
+
+Gets a single tenancy
+
+### Get Operation
+Get the specified tenancy's information.
+The following arguments are supported:
+
+* `tenancy_id` - (Required) The OCID of the tenancy.
+
+
+The following attributes are exported:
+
+* `description` - The description of the tenancy.
+* `home_region_key` - The region key for the tenancy's home region. For more information about regions, see [Regions and Availability Domains](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/regions.htm).  Allowed values are: - `IAD` - `PHX` - `FRA` - `LHR` 
+* `tenancy_id` - The OCID of the tenancy.
+* `name` - The name of the tenancy.
+
+
+### Example Usage
+
+```
+data "oci_identity_tenancies" "test_tenancies" {
+	#Required
+	tenancy_id = "${var.tenancy_tenancy_id}"
+}
+```
+### Tenancy Reference
+
+The following attributes are exported:
+
+* `description` - The description of the tenancy.
+* `home_region_key` - The region key for the tenancy's home region. For more information about regions, see [Regions and Availability Domains](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/regions.htm).  Allowed values are: - `IAD` - `PHX` - `FRA` - `LHR` 
+* `tenancy_id` - The OCID of the tenancy.
+* `name` - The name of the tenancy.

provider/identity_region_test.go

@@ -0,0 +1,39 @@
+// Copyright (c) 2017, Oracle and/or its affiliates. All rights reserved.
+
+package provider
+
+import (
+	"testing"
+
+	"github.com/hashicorp/terraform/helper/resource"
+	"github.com/hashicorp/terraform/terraform"
+)
+
+func TestIdentityRegionResource_basic(t *testing.T) {
+	provider := testAccProvider
+	config := testProviderConfig()
+
+	datasourceName := "data.oci_identity_regions.test_regions"
+
+	resource.Test(t, resource.TestCase{
+		Providers: map[string]terraform.ResourceProvider{
+			"oci": provider,
+		},
+		Steps: []resource.TestStep{
+			// verify datasource
+			{
+				Config: config + `
+data "oci_identity_regions" "test_regions" {
+	filter {
+		name = "name"
+		values = ["${var.region}"]
+	}
+}
+                `,
+				Check: resource.ComposeTestCheckFunc(
+					resource.TestCheckResourceAttr(datasourceName, "regions.#", "1"),
+				),
+			},
+		},
+	})
+}

provider/identity_regions_data_source.go

@@ -0,0 +1,107 @@
+// Copyright (c) 2017, Oracle and/or its affiliates. All rights reserved.
+
+package provider
+
+import (
+	"context"
+
+	"github.com/hashicorp/terraform/helper/schema"
+	oci_identity "github.com/oracle/oci-go-sdk/identity"
+
+	"github.com/oracle/terraform-provider-oci/crud"
+)
+
+func RegionsDataSource() *schema.Resource {
+	return &schema.Resource{
+		Read: readRegions,
+		Schema: map[string]*schema.Schema{
+			"filter": dataSourceFiltersSchema(),
+			"regions": {
+				Type:     schema.TypeList,
+				Computed: true,
+				Elem: &schema.Resource{
+					Schema: map[string]*schema.Schema{
+						// Required
+
+						// Optional
+
+						// Computed
+						"key": {
+							Type:     schema.TypeString,
+							Computed: true,
+						},
+						"name": {
+							Type:     schema.TypeString,
+							Computed: true,
+						},
+					},
+				},
+			},
+		},
+	}
+}
+
+func readRegions(d *schema.ResourceData, m interface{}) error {
+	sync := &RegionsDataSourceCrud{}
+	sync.D = d
+	sync.Client = m.(*OracleClients).identityClient
+
+	return crud.ReadResource(sync)
+}
+
+type RegionsDataSourceCrud struct {
+	D      *schema.ResourceData
+	Client *oci_identity.IdentityClient
+	Res    *oci_identity.ListRegionsResponse
+}
+
+func (s *RegionsDataSourceCrud) VoidState() {
+	s.D.SetId("")
+}
+
+func (s *RegionsDataSourceCrud) Get() error {
+	request := oci_identity.ListRegionsRequest{}
+
+	request.RequestMetadata.RetryPolicy = getRetryPolicy(false, "identity")
+
+	response, err := s.Client.ListRegions(context.Background())
+	if err != nil {
+		return err
+	}
+
+	s.Res = &response
+	return nil
+}
+
+func (s *RegionsDataSourceCrud) SetData() {
+	if s.Res == nil {
+		return
+	}
+
+	s.D.SetId(crud.GenerateDataSourceID())
+	resources := []map[string]interface{}{}
+
+	for _, r := range s.Res.Items {
+		region := map[string]interface{}{}
+
+		if r.Key != nil {
+			region["key"] = *r.Key
+		}
+
+		if r.Name != nil {
+			region["name"] = *r.Name
+		}
+
+		resources = append(resources, region)
+	}
+
+	if f, fOk := s.D.GetOkExists("filter"); fOk {
+		resources = ApplyFilters(f.(*schema.Set), resources)
+	}
+
+	if err := s.D.Set("regions", resources); err != nil {
+		panic(err)
+	}
+
+	return
+}