# REST Resource: projects.locations.taxonomies

- [Resource: Taxonomy](https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies#Taxonomy)
  - [JSON representation](https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies#Taxonomy.SCHEMA_REPRESENTATION)
- [PolicyType](https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies#PolicyType)
- [Service](https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies#Service)
  - [JSON representation](https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies#Service.SCHEMA_REPRESENTATION)
- [ManagingSystem](https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies#ManagingSystem)
- [Methods](https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies#METHODS_SUMMARY)

## Resource: Taxonomy

A taxonomy is a collection of policy tags that classify data along a common axis. For instance a data *sensitivity* taxonomy could contain policy tags denoting PII such as age, zipcode, and SSN. A data *origin* taxonomy could contain policy tags to distinguish user data, employee data, partner data, public data.

| JSON representation |
|---|
| ``` { "name": string, "displayName": string, "description": string, "policyTagCount": integer, "taxonomyTimestamps": { object (`https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/SystemTimestamps`) }, "activatedPolicyTypes": [ enum (`https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies#PolicyType`) ], "service": { object (`https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies#Service`) } } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. Resource name of this taxonomy, whose format is: "projects/{projectNumber}/locations/{locationId}/taxonomies/{id}". |
| `displayName` | `string` Required. User defined name of this taxonomy. It must: contain only unicode letters, numbers, underscores, dashes and spaces; not start or end with spaces; and be at most 200 bytes long when encoded in UTF-8. The taxonomy display name must be unique within an organization. |
| `description` | `string` Optional. Description of this taxonomy. It must: contain only unicode characters, tabs, newlines, carriage returns and page breaks; and be at most 2000 bytes long when encoded in UTF-8. If not set, defaults to an empty description. |
| `policyTagCount` | `integer` Output only. Number of policy tags contained in this taxonomy. |
| `taxonomyTimestamps` | ``object (`https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/SystemTimestamps`)`` Output only. Timestamps about this taxonomy. Only createTime and updateTime are used. |
| `activatedPolicyTypes[]` | ``enum (`https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies#PolicyType`)`` Optional. A list of policy types that are activated for this taxonomy. If not set, defaults to an empty list. |
| `service` | ``object (`https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies#Service`)`` Output only. Identity of the service which owns the Taxonomy. This field is only populated when the taxonomy is created by a Google Cloud service. Currently only 'DATAPLEX' is supported. |

## PolicyType

Defines policy types where policy tag can be used for.

| Enums ||
|---|---|
| `POLICY_TYPE_UNSPECIFIED` | Unspecified policy type. |
| `FINE_GRAINED_ACCESS_CONTROL` | Fine grained access control policy, which enables access control on tagged resources. |

## Service

The source system of the Taxonomy.

| JSON representation |
|---|
| ``` { "name": enum (`https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies#ManagingSystem`), "identity": string } ``` |

| Fields ||
|---|---|
| `name` | ``enum (`https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies#ManagingSystem`)`` The Google Cloud service name. |
| `identity` | `string` The service agent for the service. |

## ManagingSystem

This enum describes all the systems that manage Taxonomy and PolicyTag resources in Data Catalog.

| Enums ||
|---|---|
| `MANAGING_SYSTEM_UNSPECIFIED` | Default value |
| `MANAGING_SYSTEM_DATAPLEX` | Dataplex Universal Catalog. |
| `MANAGING_SYSTEM_OTHER` | Other |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies/create` | Creates a taxonomy in the specified project. |
| ### `https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies/delete` | Deletes a taxonomy. |
| ### `https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies/export` | Exports all taxonomies and their policy tags in a project. |
| ### `https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies/get` | Gets a taxonomy. |
| ### `https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies/getIamPolicy` | Gets the IAM policy for a taxonomy or a policy tag. |
| ### `https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies/import` | Imports all taxonomies and their policy tags to a project as new taxonomies. |
| ### `https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies/list` | Lists all taxonomies in a project in a particular location that the caller has permission to view. |
| ### `https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies/patch` | Updates a taxonomy. |
| ### `https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies/setIamPolicy` | Sets the IAM policy for a taxonomy or a policy tag. |
| ### `https://docs.cloud.google.com/data-catalog/docs/reference/rest/v1beta1/projects.locations.taxonomies/testIamPermissions` | Returns the permissions that a caller has on the specified taxonomy or policy tag. |