Get taxonomy

Stay organized with collections Save and categorize content based on your preferences.

Retrieve existing taxonomy.

Code sample

Go

Before trying this sample, follow the Go setup instructions in the Data Catalog quickstart using client libraries. For more information, see the Data Catalog Go API reference documentation.

import (
	"context"
	"fmt"
	"io"

	datacatalog "cloud.google.com/go/datacatalog/apiv1beta1"
	datacatalogpb "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1"
)

// getTaxonomy prints information about a given taxonomy.
func getTaxonomy(w io.Writer, taxonomyID string) error {
	// taxonomyID := "projects/myproject/locations/us/taxonomies/1234"
	ctx := context.Background()
	policyClient, err := datacatalog.NewPolicyTagManagerClient(ctx)
	if err != nil {
		return fmt.Errorf("datacatalog.NewPolicyTagManagerClient: %v", err)
	}
	defer policyClient.Close()

	req := &datacatalogpb.GetTaxonomyRequest{
		Name: taxonomyID,
	}
	resp, err := policyClient.GetTaxonomy(ctx, req)
	if err != nil {
		return fmt.Errorf("GetTaxonomy: %v", err)
	}
	fmt.Fprintf(w, "Taxonomy %s has Display Name %s and Description: %s\n", resp.Name, resp.DisplayName, resp.Description)
	return nil
}

Node.js

Before trying this sample, follow the Node.js setup instructions in the Data Catalog quickstart using client libraries. For more information, see the Data Catalog Node.js API reference documentation.

// Import the Google Cloud client library.
const {PolicyTagManagerClient} = require('@google-cloud/datacatalog').v1;
const policyTagManager = new PolicyTagManagerClient();

async function getTaxonomy() {
  /**
   * TODO(developer): Uncomment the following line before running the sample.
   */
  // const projectId = 'my_project'; // Google Cloud Platform project
  // const location = 'us';
  // const taxonomy = 'my_existing_taxonomy';
  // const taxonomyName = `projects/${projectId}/locations/${location}/taxonomies/${taxonomy}`;

  const request = {
    name: taxonomyName,
  };

  try {
    const [taxonomy] = await policyTagManager.getTaxonomy(request);
    console.log(`Retrieved taxonomy: ${taxonomy.name}`);
  } catch (e) {
    console.error(e);
    process.exitCode = 1;
  }
}

What's next

To search and filter code samples for other Google Cloud products, see the Google Cloud sample browser.