Method: projects.locations.taxonomies.replace

Replaces (updates) a taxonomy and all its policy tags.

The taxonomy and its entire hierarchy of policy tags must be represented literally by SerializedTaxonomy and the nested SerializedPolicyTag messages.

This operation automatically does the following:

  • Deletes the existing policy tags that are missing from the SerializedPolicyTag.
  • Creates policy tags that don't have resource names. They are considered new.
  • Updates policy tags with valid resources names accordingly.

HTTP request

POST https://datacatalog.googleapis.com/v1/{name}:replace

Path parameters

Parameters
name

string

Required. Resource name of the taxonomy to update. It takes the form projects/{project}/locations/{location}/taxonomies/{taxonomies}.

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

  • datacatalog.taxonomies.update

Request body

The request body contains data with the following structure:

JSON representation
{
  "serializedTaxonomy": {
    object (SerializedTaxonomy)
  }
}
Fields
serializedTaxonomy

object (SerializedTaxonomy)

Required. Taxonomy to update along with its child policy tags.

Response body

If successful, the response body contains an instance of Taxonomy.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.