Data Catalog is deprecated and will be discontinued on January 30, 2026. For steps to transition your Data Catalog users, workloads, and content to Dataplex Catalog, see Transition from Data Catalog to Dataplex Catalog.

Method: organizations.locations.retrieveEffectiveConfig

Retrieves the effective configuration related to the migration from Data Catalog to Dataplex 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

Parameters
`name`	`string` Required. The resource whose effective config is being retrieved. It takes the form `organizations/{organization}/locations/{location}`.

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.

Authorization scopes

Requires the following OAuth scope:

https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the name resource:

datacatalog.migrationConfig.get

For more information, see the IAM documentation.