Skip to main content

taxonomies

Overview

Nametaxonomies
TypeResource
Idgoogle.datacatalog.taxonomies

Fields

NameDatatypeDescription
namestringOutput only. Resource name of this taxonomy in URL format. Note: Policy tag manager generates unique taxonomy IDs.
descriptionstringOptional. Description of this taxonomy. If not set, defaults to empty. The description must contain only Unicode characters, tabs, newlines, carriage returns, and page breaks, and be at most 2000 bytes long when encoded in UTF-8.
taxonomyTimestampsobjectTimestamps associated with this resource in a particular system.
activatedPolicyTypesarrayOptional. A list of policy types that are activated for this taxonomy. If not set, defaults to an empty list.
displayNamestringRequired. User-defined name of this taxonomy. The name can't start or end with spaces, must contain only Unicode letters, numbers, underscores, dashes, and spaces, and be at most 200 bytes long when encoded in UTF-8. The taxonomy display name must be unique within an organization.
policyTagCountintegerOutput only. Number of policy tags in this taxonomy.
serviceobjectThe source system of the Taxonomy.

Methods

NameAccessible byRequired ParamsDescription
projects_locations_taxonomies_getSELECTlocationsId, projectsId, taxonomiesIdGets a taxonomy.
projects_locations_taxonomies_listSELECTlocationsId, projectsIdLists all taxonomies in a project in a particular location that you have a permission to view.
projects_locations_taxonomies_createINSERTlocationsId, projectsIdCreates a taxonomy in a specified project. The taxonomy is initially empty, that is, it doesn't contain policy tags.
projects_locations_taxonomies_deleteDELETElocationsId, projectsId, taxonomiesIdDeletes a taxonomy, including all policy tags in this taxonomy, their associated policies, and the policy tags references from BigQuery columns.
_projects_locations_taxonomies_listEXEClocationsId, projectsIdLists all taxonomies in a project in a particular location that you have a permission to view.
projects_locations_taxonomies_exportEXEClocationsId, projectsIdExports taxonomies in the requested type and returns them, including their policy tags. The requested taxonomies must belong to the same project. This method generates SerializedTaxonomy protocol buffers with nested policy tags that can be used as input for ImportTaxonomies calls.
projects_locations_taxonomies_importEXEClocationsId, projectsIdCreates 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.
projects_locations_taxonomies_patchEXEClocationsId, projectsId, taxonomiesIdUpdates a taxonomy, including its display name, description, and activated policy types.
projects_locations_taxonomies_replaceEXEClocationsId, projectsId, taxonomiesIdReplaces (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.