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.
Retrieves the effective configuration related to the migration from Data Catalog to Dataplex Universal Catalog for a specific organization or project. If there is no specific configuration set for the resource, the setting is checked hierarchicahlly through the ancestors of the resource, starting from the resource itself.
HTTP request
GET https://datacatalog.googleapis.com/v1/{name}:retrieveEffectiveConfig
Path parameters
Parameters
name
string
Required. The resource whose effective config is being retrieved. It takes the form organizations/{organization}/locations/{location}.
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of MigrationConfig.
[[["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 page details how to retrieve the effective configuration for migrating from Data Catalog to Dataplex for a given organization or project.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves making a \u003ccode\u003eGET\u003c/code\u003e HTTP request to a specific endpoint using a designated \u003ccode\u003ename\u003c/code\u003e parameter that identifies the resource.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and the server returns an instance of \u003ccode\u003eMigrationConfig\u003c/code\u003e in the response if successful.\u003c/p\u003e\n"],["\u003cp\u003eTo complete this request, you will need OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e and IAM permission \u003ccode\u003edatacatalog.migrationConfig.get\u003c/code\u003e on the specified resource.\u003c/p\u003e\n"]]],[],null,["# Method: organizations.locations.retrieveEffectiveConfig\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\n| Data Catalog is deprecated. Please use Dataplex Universal Catalog instead.\nRetrieves the effective configuration related to the migration from Data Catalog to Dataplex Universal Catalog for a specific organization or project. If there is no specific configuration set for the resource, the setting is checked hierarchicahlly through the ancestors of the resource, starting from the resource itself.\n\n### HTTP request\n\n`GET https://datacatalog.googleapis.com/v1/{name}:retrieveEffectiveConfig`\n\n### Path parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [MigrationConfig](/data-catalog/docs/reference/rest/v1/MigrationConfig).\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).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource:\n\n- `datacatalog.migrationConfig.get`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]