Data Catalog API methods that are related to Data Catalog search and metadata are deprecated and will be discontinued on January 30, 2026. See Transition from Data Catalog to Dataplex Universal Catalog. Methods that are related to policy tags and policy tag taxonomies are not deprecated.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-17 UTC."],[[["\u003cp\u003eThis operation replaces an existing taxonomy and all its policy tags with a new structure defined by \u003ccode\u003eSerializedTaxonomy\u003c/code\u003e and \u003ccode\u003eSerializedPolicyTag\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe process automatically deletes existing policy tags not present in the new structure, creates new policy tags, and updates existing ones based on resource names.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request uses the POST method to the provided URL, requiring a resource name of the taxonomy in the form \u003ccode\u003eprojects/{project}/locations/{location}/taxonomies/{taxonomies}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include the \u003ccode\u003eserializedTaxonomy\u003c/code\u003e field, containing the structure of the new taxonomy and its policy tags.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests return an instance of the updated \u003ccode\u003eTaxonomy\u003c/code\u003e, and it also requires the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.taxonomies.replace\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReplaces (updates) a taxonomy and all its policy tags.\n\nThe taxonomy and its entire hierarchy of policy tags must be represented literally by `SerializedTaxonomy` and the nested `SerializedPolicyTag` messages.\n\nThis operation automatically does the following:\n\n- Deletes the existing policy tags that are missing from the `SerializedPolicyTag`.\n- Creates policy tags that don't have resource names. They are considered new.\n- Updates policy tags with valid resources names accordingly.\n\n### HTTP request\n\n`POST https://datacatalog.googleapis.com/v1/{name}:replace`\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [Taxonomy](/data-catalog/docs/reference/rest/v1/projects.locations.taxonomies#Taxonomy).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]