- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- IAM Permissions
- Try it!
Lists metadata jobs.
HTTP request
GET https://dataplex.googleapis.com/v1/{parent=projects/*/locations/*}/metadataJobs
The URL uses gRPC Transcoding syntax.
Path 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.list
Query parameters
pageSize
integer
Optional. The maximum number of metadata jobs to return. The service might return fewer jobs than this value. If unspecified, at most 10 jobs are returned. The maximum value is 1,000.
pageToken
string
Optional. The page token received from a previous metadataJobs.list
call. Provide this token to retrieve the subsequent page of results. When paginating, all other parameters that are provided to the metadataJobs.list
request must match the call that provided the page token.
filter
string
Optional. Filter request. Filters are case-sensitive. The service supports the following formats:
-
labels.key1 = "value1"
-
labels:key1
-
name = "value"
You can combine filters with AND
, OR
, and NOT
operators.
orderBy
string
Optional. The field to sort the results by, either name
or createTime
. If not specified, the ordering is undefined.
Request body
The request body must be empty.
Response body
List metadata jobs response.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"metadataJobs"
:
[
{
object (
|
Fields | |
---|---|
metadataJobs[]
|
Metadata jobs under the specified parent location. |
nextPageToken
|
A token to retrieve the next page of results. If there are no more results in the list, the value is empty. |
unreachableLocations[]
|
Locations that the service couldn't reach. |
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.list
For more information, see the IAM documentation .