Method: projects.locations.taxonomies.import

Creates new taxonomies (including their policy tags) by importing from inlined source or cross-regional source. New taxonomies will be created in a given parent project.

If using the cross-regional source, a new taxonomy is created by copying from a source in another region.

If using the inlined source, this method provides a way to bulk create taxonomies and policy tags using nested proto structure.

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 be imported. source can be only one of the following:
inlineSource

object (InlineSource)

Inline source used for taxonomies import.
crossRegionalSource

object (CrossRegionalSource)

Cross-regional source taxonomy to be imported.

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)

Taxonomies that were imported.

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 be imported.

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 be imported.