Method: projects.locations.taxonomies.import

Creates new taxonomies (including their policy tags) in a given project by importing from inlined or cross-regional sources.

For a cross-regional source, new taxonomies are created by copying from a source in another region.

For an inlined source, taxonomies and policy tags are created in bulk using nested protocol buffer structures.

HTTP request

POST https://datacatalog.googleapis.com/v1/{parent}/taxonomies:import

Path parameters

Parameters
parent

string

Required. Resource name of project that the imported taxonomies will belong to. It takes the form projects/{project}/locations/{location}.

Authorization requires the following IAM permission on the specified resource parent:

  • datacatalog.taxonomies.create

Request body

The request body contains data with the following structure:

JSON representation
{

  // Union field source can be only one of the following:
  "inlineSource": {
    object (InlineSource)
  },
  "crossRegionalSource": {
    object (CrossRegionalSource)
  }
  // End of list of possible types for union field source.
}
Fields
Union field source. Source taxonomies to import. source can be only one of the following:
inlineSource

object (InlineSource)

Inline source taxonomy to import.

crossRegionalSource

object (CrossRegionalSource)

Cross-regional source taxonomy to import.

Response body

If successful, the response body contains data with the following structure:

Response message for taxonomies.import.

JSON representation
{
  "taxonomies": [
    {
      object (Taxonomy)
    }
  ]
}
Fields
taxonomies[]

object (Taxonomy)

Imported taxonomies.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

InlineSource

Inline source containing taxonomies to import.

JSON representation
{
  "taxonomies": [
    {
      object (SerializedTaxonomy)
    }
  ]
}
Fields
taxonomies[]

object (SerializedTaxonomy)

Required. Taxonomies to import.

CrossRegionalSource

Cross-regional source used to import an existing taxonomy into a different region.

JSON representation
{
  "taxonomy": string
}
Fields
taxonomy

string

Required. The resource name of the source taxonomy to import.