Method: projects.locations.metadataJobs.create

Creates a metadata job. For example, use a metadata job to import Dataplex Catalog entries and aspects from a third-party system into Dataplex.

HTTP request

POST https://dataplex.googleapis.com/v1/{parent=projects/*/locations/*}/metadataJobs

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The resource name of the parent location, in the format projects/{project_id_or_number}/locations/{locationId}

Authorization requires the following IAM permission on the specified resource parent:

  • dataplex.metadataJobs.create

Query parameters

Parameters
metadataJobId

string

Optional. The metadata job ID. If not provided, a unique ID is generated with the prefix metadata-job-.

Request body

The request body contains an instance of MetadataJob.

Response body

If successful, the response body contains a newly created instance of Operation.

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 parent resource:

  • dataplex.metadataJobs.create

For more information, see the IAM documentation.