Authorization requires the followingIAMpermission on the specified resourceparent:
dataplex.dataTaxonomies.create
Query parameters
Parameters
dataTaxonomyId
string
Required. DataTaxonomy identifier. * Must contain only lowercase letters, numbers and hyphens. * Must start with a letter. * Must be between 1-63 characters. * Must end with a number or a letter. * Must be unique within the Project.
validateOnly
boolean
Optional. Only validate the request, but do not perform mutations. The default is false.
Request body
The request body contains an instance ofDataTaxonomy.
Response body
If successful, the response body contains a newly created instance ofOperation.
[[["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-21 UTC."],[[["\u003cp\u003eThis page details the process of creating a DataTaxonomy resource using a POST request to the specified URL \u003ccode\u003ehttps://dataplex.googleapis.com/v1/{parent=projects/*/locations/*}/dataTaxonomies\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires a \u003ccode\u003eparent\u003c/code\u003e path parameter for authorization and also takes two query parameters: a \u003ccode\u003edataTaxonomyId\u003c/code\u003e string and an optional \u003ccode\u003evalidateOnly\u003c/code\u003e boolean.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain an instance of DataTaxonomy, while the successful response body will contain a newly created instance of Operation.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this operation requires the \u003ccode\u003edataplex.dataTaxonomies.create\u003c/code\u003e IAM permission and the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.dataTaxonomies.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\n| This item is deprecated!\nCreate a DataTaxonomy resource.\n\n### HTTP request\n\n`POST https://dataplex.googleapis.com/v1/{parent=projects/*/locations/*}/dataTaxonomies`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [DataTaxonomy](/dataplex/docs/reference/rest/v1/projects.locations.dataTaxonomies#DataTaxonomy).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/dataplex/docs/reference/rest/v1/organizations.locations.operations#Operation).\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)."]]
