{ "kind": "discovery#restDescription", "ownerName": "Google", "id": "datalineage:v1", "endpoints": [ { "description": "Regional Endpoint", "location": "africa-south1", "endpointUrl": "https://datalineage.africa-south1.rep.googleapis.com/" }, { "description": "Regional Endpoint", "endpointUrl": "https://datalineage.asia-east1.rep.googleapis.com/", "location": "asia-east1" }, { "endpointUrl": "https://datalineage.asia-east2.rep.googleapis.com/", "description": "Regional Endpoint", "location": "asia-east2" }, { "endpointUrl": "https://datalineage.asia-northeast1.rep.googleapis.com/", "description": "Regional Endpoint", "location": "asia-northeast1" }, { "description": "Regional Endpoint", "endpointUrl": "https://datalineage.asia-northeast2.rep.googleapis.com/", "location": "asia-northeast2" }, { "description": "Regional Endpoint", "location": "asia-northeast3", "endpointUrl": "https://datalineage.asia-northeast3.rep.googleapis.com/" }, { "endpointUrl": "https://datalineage.asia-south1.rep.googleapis.com/", "description": "Regional Endpoint", "location": "asia-south1" }, { "description": "Regional Endpoint", "endpointUrl": "https://datalineage.asia-south2.rep.googleapis.com/", "location": "asia-south2" }, { "location": "asia-southeast1", "description": "Regional Endpoint", "endpointUrl": "https://datalineage.asia-southeast1.rep.googleapis.com/" }, { "endpointUrl": "https://datalineage.asia-southeast2.rep.googleapis.com/", "description": "Regional Endpoint", "location": "asia-southeast2" }, { "endpointUrl": "https://datalineage.asia-southeast3.rep.googleapis.com/", "location": "asia-southeast3", "description": "Regional Endpoint" }, { "location": "australia-southeast1", "endpointUrl": "https://datalineage.australia-southeast1.rep.googleapis.com/", "description": "Regional Endpoint" }, { "location": "australia-southeast2", "description": "Regional Endpoint", "endpointUrl": "https://datalineage.australia-southeast2.rep.googleapis.com/" }, { "description": "Regional Endpoint", "location": "europe-central2", "endpointUrl": "https://datalineage.europe-central2.rep.googleapis.com/" }, { "location": "europe-north1", "description": "Regional Endpoint", "endpointUrl": "https://datalineage.europe-north1.rep.googleapis.com/" }, { "location": "europe-north2", "endpointUrl": "https://datalineage.europe-north2.rep.googleapis.com/", "description": "Regional Endpoint" }, { "endpointUrl": "https://datalineage.europe-southwest1.rep.googleapis.com/", "location": "europe-southwest1", "description": "Regional Endpoint" }, { "location": "europe-west1", "description": "Regional Endpoint", "endpointUrl": "https://datalineage.europe-west1.rep.googleapis.com/" }, { "location": "europe-west10", "endpointUrl": "https://datalineage.europe-west10.rep.googleapis.com/", "description": "Regional Endpoint" }, { "endpointUrl": "https://datalineage.europe-west12.rep.googleapis.com/", "description": "Regional Endpoint", "location": "europe-west12" }, { "location": "europe-west15", "endpointUrl": "https://datalineage.europe-west15.rep.googleapis.com/", "description": "Regional Endpoint" }, { "endpointUrl": "https://datalineage.europe-west2.rep.googleapis.com/", "description": "Regional Endpoint", "location": "europe-west2" }, { "location": "europe-west3", "endpointUrl": "https://datalineage.europe-west3.rep.googleapis.com/", "description": "Regional Endpoint" }, { "description": "Regional Endpoint", "location": "europe-west4", "endpointUrl": "https://datalineage.europe-west4.rep.googleapis.com/" }, { "endpointUrl": "https://datalineage.europe-west6.rep.googleapis.com/", "location": "europe-west6", "description": "Regional Endpoint" }, { "description": "Regional Endpoint", "location": "europe-west8", "endpointUrl": "https://datalineage.europe-west8.rep.googleapis.com/" }, { "description": "Regional Endpoint", "endpointUrl": "https://datalineage.europe-west9.rep.googleapis.com/", "location": "europe-west9" }, { "description": "Regional Endpoint", "endpointUrl": "https://datalineage.me-central1.rep.googleapis.com/", "location": "me-central1" }, { "description": "Regional Endpoint", "location": "me-central2", "endpointUrl": "https://datalineage.me-central2.rep.googleapis.com/" }, { "location": "me-west1", "endpointUrl": "https://datalineage.me-west1.rep.googleapis.com/", "description": "Regional Endpoint" }, { "location": "northamerica-northeast1", "endpointUrl": "https://datalineage.northamerica-northeast1.rep.googleapis.com/", "description": "Regional Endpoint" }, { "endpointUrl": "https://datalineage.northamerica-northeast2.rep.googleapis.com/", "location": "northamerica-northeast2", "description": "Regional Endpoint" }, { "description": "Regional Endpoint", "endpointUrl": "https://datalineage.northamerica-south1.rep.googleapis.com/", "location": "northamerica-south1" }, { "location": "southamerica-east1", "description": "Regional Endpoint", "endpointUrl": "https://datalineage.southamerica-east1.rep.googleapis.com/" }, { "location": "southamerica-west1", "endpointUrl": "https://datalineage.southamerica-west1.rep.googleapis.com/", "description": "Regional Endpoint" }, { "location": "us-central1", "endpointUrl": "https://datalineage.us-central1.rep.googleapis.com/", "description": "Regional Endpoint" }, { "description": "Regional Endpoint", "location": "us-central2", "endpointUrl": "https://datalineage.us-central2.rep.googleapis.com/" }, { "endpointUrl": "https://datalineage.us-east1.rep.googleapis.com/", "location": "us-east1", "description": "Regional Endpoint" }, { "location": "us-east4", "endpointUrl": "https://datalineage.us-east4.rep.googleapis.com/", "description": "Regional Endpoint" }, { "endpointUrl": "https://datalineage.us-east5.rep.googleapis.com/", "description": "Regional Endpoint", "location": "us-east5" }, { "location": "us-east7", "endpointUrl": "https://datalineage.us-east7.rep.googleapis.com/", "description": "Regional Endpoint" }, { "endpointUrl": "https://datalineage.us-south1.rep.googleapis.com/", "description": "Regional Endpoint", "location": "us-south1" }, { "location": "us-west1", "endpointUrl": "https://datalineage.us-west1.rep.googleapis.com/", "description": "Regional Endpoint" }, { "location": "us-west2", "description": "Regional Endpoint", "endpointUrl": "https://datalineage.us-west2.rep.googleapis.com/" }, { "description": "Regional Endpoint", "endpointUrl": "https://datalineage.us-west3.rep.googleapis.com/", "location": "us-west3" }, { "endpointUrl": "https://datalineage.us-west4.rep.googleapis.com/", "description": "Regional Endpoint", "location": "us-west4" }, { "description": "Regional Endpoint", "endpointUrl": "https://datalineage.us-west8.rep.googleapis.com/", "location": "us-west8" }, { "endpointUrl": "https://datalineage.us.rep.googleapis.com/", "description": "Regional Endpoint", "location": "us" }, { "location": "eu", "endpointUrl": "https://datalineage.eu.rep.googleapis.com/", "description": "Regional Endpoint" } ], "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/cloud-platform": { "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." }, "https://www.googleapis.com/auth/datalineage.read-write": { "description": "See, edit, configure, and delete your Google Cloud Data Lineage data and see the email address for your Google Account" }, "https://www.googleapis.com/auth/datalineage.readonly": { "description": "See your Google Cloud Data Lineage data and the email address of your Google Account" } } } }, "servicePath": "", "resources": { "folders": { "resources": { "locations": { "resources": { "config": { "methods": { "patch": { "parameterOrder": [ "name" ], "id": "datalineage.folders.locations.config.patch", "flatPath": "v1/folders/{foldersId}/locations/{locationsId}/config", "request": { "$ref": "GoogleCloudDatacatalogLineageConfigmanagementV1Config" }, "httpMethod": "PATCH", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudDatacatalogLineageConfigmanagementV1Config" }, "parameters": { "name": { "type": "string", "pattern": "^folders/[^/]+/locations/[^/]+/config$", "description": "Identifier. The resource name of the config. Format: `organizations/{organization_id}/locations/global/config` `folders/{folder_id}/locations/global/config` `projects/{project_id}/locations/global/config` `projects/{project_number}/locations/global/config`", "required": true, "location": "path" } }, "description": "Update the Config for a given resource." }, "get": { "flatPath": "v1/folders/{foldersId}/locations/{locationsId}/config", "parameters": { "name": { "pattern": "^folders/[^/]+/locations/[^/]+/config$", "type": "string", "location": "path", "description": "Required. REQUIRED: The resource name of the config to be fetched. Format: `organizations/{organization_id}/locations/global/config` `folders/{folder_id}/locations/global/config` `projects/{project_id}/locations/global/config` `projects/{project_number}/locations/global/config`", "required": true } }, "id": "datalineage.folders.locations.config.get", "description": "Get the Config for a given resource.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudDatacatalogLineageConfigmanagementV1Config" }, "path": "v1/{+name}", "parameterOrder": [ "name" ], "httpMethod": "GET" } } } } } } }, "projects": { "resources": { "locations": { "resources": { "operations": { "methods": { "list": { "id": "datalineage.projects.locations.operations.list", "parameterOrder": [ "name" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "description": "The name of the operation's parent resource.", "required": true, "type": "string" }, "pageToken": { "location": "query", "description": "The standard list page token.", "type": "string" }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "filter": { "type": "string", "description": "The standard list filter.", "location": "query" }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The standard list page size." } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "path": "v1/{+name}/operations", "response": { "$ref": "GoogleLongrunningListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`." }, "cancel": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "datalineage.projects.locations.operations.cancel", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "type": "string", "description": "The name of the operation resource to be cancelled.", "required": true, "location": "path" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "path": "v1/{+name}:cancel", "request": { "$ref": "GoogleLongrunningCancelOperationRequest" }, "httpMethod": "POST", "description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "response": { "$ref": "GoogleProtobufEmpty" } }, "get": { "httpMethod": "GET", "response": { "$ref": "GoogleLongrunningOperation" }, "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "datalineage.projects.locations.operations.get", "parameterOrder": [ "name" ], "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "location": "path", "description": "The name of the operation resource.", "required": true, "type": "string" } }, "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}" }, "delete": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "id": "datalineage.projects.locations.operations.delete", "httpMethod": "DELETE", "description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1/{+name}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "description": "The name of the operation resource to be deleted.", "location": "path", "required": true, "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ] } } }, "processes": { "methods": { "patch": { "id": "datalineage.projects.locations.processes.patch", "parameters": { "updateMask": { "location": "query", "format": "google-fieldmask", "description": "Optional. The list of fields to update. Currently not used. The whole message is updated.", "type": "string" }, "allowMissing": { "location": "query", "description": "Optional. If set to true and the process is not found, the request inserts it.", "type": "boolean" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+/processes/[^/]+$", "description": "Immutable. The resource name of the lineage process. Format: `projects/{project}/locations/{location}/processes/{process}`. Can be specified or auto-assigned. {process} must be not longer than 200 characters and only contain characters in a set: `a-zA-Z0-9_-:.`", "required": true, "type": "string", "location": "path" }, "requestId": { "description": "Optional. A unique identifier for this request. Restricted to 36 ASCII characters. A random UUID is recommended. This request is idempotent only if a `request_id` is provided.", "location": "query", "type": "string" } }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}", "response": { "$ref": "GoogleCloudDatacatalogLineageV1Process" }, "request": { "$ref": "GoogleCloudDatacatalogLineageV1Process" }, "description": "Updates a process.", "parameterOrder": [ "name" ], "httpMethod": "PATCH", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processes/{processesId}" }, "create": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processes", "parameterOrder": [ "parent" ], "httpMethod": "POST", "request": { "$ref": "GoogleCloudDatacatalogLineageV1Process" }, "response": { "$ref": "GoogleCloudDatacatalogLineageV1Process" }, "description": "Creates a new process.", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "type": "string", "location": "path", "description": "Required. The name of the project and its location that should own the process." }, "requestId": { "location": "query", "description": "Optional. A unique identifier for this request. Restricted to 36 ASCII characters. A random UUID is recommended. This request is idempotent only if a `request_id` is provided.", "type": "string" } }, "id": "datalineage.projects.locations.processes.create", "path": "v1/{+parent}/processes", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processes/{processesId}", "path": "v1/{+name}", "description": "Gets the details of the specified process.", "parameters": { "name": { "description": "Required. The name of the process to get.", "type": "string", "required": true, "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/processes/[^/]+$" } }, "id": "datalineage.projects.locations.processes.get", "parameterOrder": [ "name" ], "httpMethod": "GET", "response": { "$ref": "GoogleCloudDatacatalogLineageV1Process" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "response": { "$ref": "GoogleCloudDatacatalogLineageV1ListProcessesResponse" }, "parameters": { "parent": { "description": "Required. The name of the project and its location that owns this collection of processes.", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path" }, "pageToken": { "location": "query", "description": "Optional. The page token received from a previous `ListProcesses` call. Specify it to get the next page. When paginating, all other parameters specified in this call must match the parameters of the call that provided the page token.", "type": "string" }, "pageSize": { "description": "Optional. The maximum number of processes to return. The service may return fewer than this value. If unspecified, at most 50 processes are returned. The maximum value is 100; values greater than 100 are cut to 100.", "location": "query", "format": "int32", "type": "integer" } }, "description": "List processes in the given project and location. List order is descending by insertion time.", "id": "datalineage.projects.locations.processes.list", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processes", "parameterOrder": [ "parent" ], "httpMethod": "GET", "path": "v1/{+parent}/processes" }, "delete": { "description": "Deletes the process with the specified name.", "response": { "$ref": "GoogleLongrunningOperation" }, "httpMethod": "DELETE", "path": "v1/{+name}", "id": "datalineage.projects.locations.processes.delete", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processes/{processesId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "allowMissing": { "description": "Optional. If set to true and the process is not found, the request succeeds but the server doesn't perform any actions.", "location": "query", "type": "boolean" }, "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/processes/[^/]+$", "location": "path", "description": "Required. The name of the process to delete.", "required": true } }, "parameterOrder": [ "name" ] } }, "resources": { "runs": { "resources": { "lineageEvents": { "methods": { "create": { "id": "datalineage.projects.locations.processes.runs.lineageEvents.create", "parameters": { "parent": { "type": "string", "description": "Required. The name of the run that should own the lineage event.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/processes/[^/]+/runs/[^/]+$", "required": true }, "requestId": { "location": "query", "description": "Optional. A unique identifier for this request. Restricted to 36 ASCII characters. A random UUID is recommended. This request is idempotent only if a `request_id` is provided.", "type": "string" } }, "response": { "$ref": "GoogleCloudDatacatalogLineageV1LineageEvent" }, "description": "Creates a new lineage event.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processes/{processesId}/runs/{runsId}/lineageEvents", "request": { "$ref": "GoogleCloudDatacatalogLineageV1LineageEvent" }, "parameterOrder": [ "parent" ], "httpMethod": "POST", "path": "v1/{+parent}/lineageEvents" }, "list": { "path": "v1/{+parent}/lineageEvents", "httpMethod": "GET", "response": { "$ref": "GoogleCloudDatacatalogLineageV1ListLineageEventsResponse" }, "parameters": { "pageToken": { "type": "string", "description": "Optional. The page token received from a previous `ListLineageEvents` call. Specify it to get the next page. When paginating, all other parameters specified in this call must match the parameters of the call that provided the page token.", "location": "query" }, "pageSize": { "location": "query", "type": "integer", "description": "Optional. The maximum number of lineage events to return. The service may return fewer events than this value. If unspecified, at most 50 events are returned. The maximum value is 100; values greater than 100 are cut to 100.", "format": "int32" }, "parent": { "description": "Required. The name of the run that owns the collection of lineage events to get.", "pattern": "^projects/[^/]+/locations/[^/]+/processes/[^/]+/runs/[^/]+$", "type": "string", "required": true, "location": "path" } }, "description": "Lists lineage events in the given project and location. The list order is not defined.", "id": "datalineage.projects.locations.processes.runs.lineageEvents.list", "parameterOrder": [ "parent" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processes/{processesId}/runs/{runsId}/lineageEvents", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "path": "v1/{+name}", "response": { "$ref": "GoogleCloudDatacatalogLineageV1LineageEvent" }, "httpMethod": "GET", "parameters": { "name": { "required": true, "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/processes/[^/]+/runs/[^/]+/lineageEvents/[^/]+$", "description": "Required. The name of the lineage event to get." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processes/{processesId}/runs/{runsId}/lineageEvents/{lineageEventsId}", "parameterOrder": [ "name" ], "id": "datalineage.projects.locations.processes.runs.lineageEvents.get", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "description": "Gets details of a specified lineage event." }, "delete": { "httpMethod": "DELETE", "response": { "$ref": "GoogleProtobufEmpty" }, "path": "v1/{+name}", "id": "datalineage.projects.locations.processes.runs.lineageEvents.delete", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processes/{processesId}/runs/{runsId}/lineageEvents/{lineageEventsId}", "description": "Deletes the lineage event with the specified name.", "parameterOrder": [ "name" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "allowMissing": { "type": "boolean", "location": "query", "description": "Optional. If set to true and the lineage event is not found, the request succeeds but the server doesn't perform any actions." }, "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/processes/[^/]+/runs/[^/]+/lineageEvents/[^/]+$", "required": true, "description": "Required. The name of the lineage event to delete.", "location": "path" } } } } } }, "methods": { "get": { "id": "datalineage.projects.locations.processes.runs.get", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/processes/[^/]+/runs/[^/]+$", "type": "string", "description": "Required. The name of the run to get." } }, "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudDatacatalogLineageV1Run" }, "parameterOrder": [ "name" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processes/{processesId}/runs/{runsId}", "httpMethod": "GET", "description": "Gets the details of the specified run." }, "create": { "parameterOrder": [ "parent" ], "path": "v1/{+parent}/runs", "httpMethod": "POST", "request": { "$ref": "GoogleCloudDatacatalogLineageV1Run" }, "response": { "$ref": "GoogleCloudDatacatalogLineageV1Run" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "datalineage.projects.locations.processes.runs.create", "description": "Creates a new run.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processes/{processesId}/runs", "parameters": { "requestId": { "description": "Optional. A unique identifier for this request. Restricted to 36 ASCII characters. A random UUID is recommended. This request is idempotent only if a `request_id` is provided.", "type": "string", "location": "query" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/processes/[^/]+$", "description": "Required. The name of the process that should own the run.", "type": "string", "required": true, "location": "path" } } }, "patch": { "description": "Updates a run.", "httpMethod": "PATCH", "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudDatacatalogLineageV1Run" }, "id": "datalineage.projects.locations.processes.runs.patch", "request": { "$ref": "GoogleCloudDatacatalogLineageV1Run" }, "parameterOrder": [ "name" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processes/{processesId}/runs/{runsId}", "parameters": { "name": { "location": "path", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/processes/[^/]+/runs/[^/]+$", "description": "Immutable. The resource name of the run. Format: `projects/{project}/locations/{location}/processes/{process}/runs/{run}`. Can be specified or auto-assigned. {run} must be not longer than 200 characters and only contain characters in a set: `a-zA-Z0-9_-:.`", "type": "string" }, "updateMask": { "description": "Optional. The list of fields to update. Currently not used. The whole message is updated.", "location": "query", "format": "google-fieldmask", "type": "string" }, "allowMissing": { "description": "Optional. If set to true and the run is not found, the request creates it.", "type": "boolean", "location": "query" } } }, "list": { "description": "Lists runs in the given project and location. List order is descending by `start_time`.", "parameterOrder": [ "parent" ], "httpMethod": "GET", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processes/{processesId}/runs", "id": "datalineage.projects.locations.processes.runs.list", "path": "v1/{+parent}/runs", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudDatacatalogLineageV1ListRunsResponse" }, "parameters": { "pageSize": { "type": "integer", "location": "query", "description": "Optional. The maximum number of runs to return. The service may return fewer than this value. If unspecified, at most 50 runs are returned. The maximum value is 100; values greater than 100 are cut to 100.", "format": "int32" }, "parent": { "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/processes/[^/]+$", "required": true, "type": "string", "description": "Required. The name of process that owns this collection of runs." }, "pageToken": { "location": "query", "type": "string", "description": "Optional. The page token received from a previous `ListRuns` call. Specify it to get the next page. When paginating, all other parameters specified in this call must match the parameters of the call that provided the page token." } } }, "delete": { "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "allowMissing": { "description": "Optional. If set to true and the run is not found, the request succeeds but the server doesn't perform any actions.", "location": "query", "type": "boolean" }, "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/processes/[^/]+/runs/[^/]+$", "description": "Required. The name of the run to delete.", "required": true, "location": "path" } }, "description": "Deletes the run with the specified name.", "parameterOrder": [ "name" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/processes/{processesId}/runs/{runsId}", "path": "v1/{+name}", "id": "datalineage.projects.locations.processes.runs.delete", "httpMethod": "DELETE", "response": { "$ref": "GoogleLongrunningOperation" } } } } } }, "config": { "methods": { "get": { "parameterOrder": [ "name" ], "httpMethod": "GET", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/config", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "id": "datalineage.projects.locations.config.get", "path": "v1/{+name}", "description": "Get the Config for a given resource.", "response": { "$ref": "GoogleCloudDatacatalogLineageConfigmanagementV1Config" }, "parameters": { "name": { "type": "string", "description": "Required. REQUIRED: The resource name of the config to be fetched. Format: `organizations/{organization_id}/locations/global/config` `folders/{folder_id}/locations/global/config` `projects/{project_id}/locations/global/config` `projects/{project_number}/locations/global/config`", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/config$", "required": true } } }, "patch": { "httpMethod": "PATCH", "description": "Update the Config for a given resource.", "response": { "$ref": "GoogleCloudDatacatalogLineageConfigmanagementV1Config" }, "parameterOrder": [ "name" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/config", "id": "datalineage.projects.locations.config.patch", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "name": { "required": true, "description": "Identifier. The resource name of the config. Format: `organizations/{organization_id}/locations/global/config` `folders/{folder_id}/locations/global/config` `projects/{project_id}/locations/global/config` `projects/{project_number}/locations/global/config`", "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/config$" } }, "request": { "$ref": "GoogleCloudDatacatalogLineageConfigmanagementV1Config" }, "path": "v1/{+name}" } } } }, "methods": { "processOpenLineageRunEvent": { "request": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object." } }, "httpMethod": "POST", "path": "v1/{+parent}:processOpenLineageRunEvent", "response": { "$ref": "GoogleCloudDatacatalogLineageV1ProcessOpenLineageRunEventResponse" }, "description": "Creates new lineage events together with their parents: process and run. Updates the process and run if they already exist. Mapped from Open Lineage specification: https://github.com/OpenLineage/OpenLineage/blob/main/spec/OpenLineage.json.", "parameterOrder": [ "parent" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:processOpenLineageRunEvent", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "parameters": { "parent": { "description": "Required. The name of the project and its location that should own the process, run, and lineage event.", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "location": "path" }, "requestId": { "location": "query", "type": "string", "description": "Optional. A unique identifier for this request. Restricted to 36 ASCII characters. A random UUID is recommended. This request is idempotent only if a `request_id` is provided." } }, "id": "datalineage.projects.locations.processOpenLineageRunEvent" }, "searchLinks": { "request": { "$ref": "GoogleCloudDatacatalogLineageV1SearchLinksRequest" }, "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "GoogleCloudDatacatalogLineageV1SearchLinksResponse" }, "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "required": true, "type": "string", "description": "Required. The project and location you want search in." } }, "httpMethod": "POST", "description": "Retrieve a list of links connected to a specific asset. Links represent the data flow between **source** (upstream) and **target** (downstream) assets in transformation pipelines. Links are stored in the same project as the Lineage Events that create them. You can retrieve links in every project where you have the `datalineage.events.get` permission. The project provided in the URL is used for Billing and Quota.", "path": "v1/{+parent}:searchLinks", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:searchLinks", "id": "datalineage.projects.locations.searchLinks", "parameterOrder": [ "parent" ] }, "searchLineageStreaming": { "path": "v1/{+parent}:searchLineageStreaming", "httpMethod": "POST", "id": "datalineage.projects.locations.searchLineageStreaming", "response": { "$ref": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingResponse" }, "description": "Retrieves a streaming response of lineage links connected to the requested assets by performing a breadth-first search in the given direction. Links represent the data flow between **source** (upstream) and **target** (downstream) assets in transformation pipelines. Links are stored in the same project as the Lineage Events that create them. This method retrieves links from all valid locations provided in the request. This method supports Column-Level Lineage (CLL) along with wildcard support to retrieve all CLL for an Entity FQN. Following permissions are required to retrieve links: * `datalineage.events.get` permission for the project where the link is stored for entity-level lineage. * `datalineage.events.getFields` permission for the project where the link is stored for column-level lineage. This method also returns processes that created the links if explicitly requested by setting [max_process_per_link](google.cloud.datacatalog.lineage.v1.SearchLineageStreamingRequest.limits.max_process_per_link) is non-zero and full process details are requested via `links.processes.process` in the [FieldMask](https://developers.google.com/workspace/docs/api/how-tos/field-masks#read_with_a_field_mask). Permission required to retrieve processes: * `datalineage.processes.get` permission for the project where the process is stored.", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "location": "path", "description": "Required. The project and location to initiate the search from.", "required": true, "type": "string" } }, "parameterOrder": [ "parent" ], "scopes": [ "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/datalineage.read-write", "https://www.googleapis.com/auth/datalineage.readonly" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:searchLineageStreaming", "request": { "$ref": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequest" } }, "batchSearchLinkProcesses": { "description": "Retrieve information about LineageProcesses associated with specific links. LineageProcesses are transformation pipelines that result in data flowing from **source** to **target** assets. Links between assets represent this operation. If you have specific link names, you can use this method to verify which LineageProcesses contribute to creating those links. See the SearchLinks method for more information on how to retrieve link name. You can retrieve the LineageProcess information in every project where you have the `datalineage.events.get` permission. The project provided in the URL is used for Billing and Quota.", "httpMethod": "POST", "request": { "$ref": "GoogleCloudDatacatalogLineageV1BatchSearchLinkProcessesRequest" }, "parameterOrder": [ "parent" ], "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:batchSearchLinkProcesses", "id": "datalineage.projects.locations.batchSearchLinkProcesses", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}:batchSearchLinkProcesses", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "description": "Required. The project and location where you want to search.", "location": "path", "type": "string", "required": true } }, "response": { "$ref": "GoogleCloudDatacatalogLineageV1BatchSearchLinkProcessesResponse" } } } } } }, "organizations": { "resources": { "locations": { "resources": { "config": { "methods": { "patch": { "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "GoogleCloudDatacatalogLineageConfigmanagementV1Config" }, "id": "datalineage.organizations.locations.config.patch", "httpMethod": "PATCH", "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/config", "description": "Update the Config for a given resource.", "parameters": { "name": { "required": true, "location": "path", "description": "Identifier. The resource name of the config. Format: `organizations/{organization_id}/locations/global/config` `folders/{folder_id}/locations/global/config` `projects/{project_id}/locations/global/config` `projects/{project_number}/locations/global/config`", "type": "string", "pattern": "^organizations/[^/]+/locations/[^/]+/config$" } }, "response": { "$ref": "GoogleCloudDatacatalogLineageConfigmanagementV1Config" }, "parameterOrder": [ "name" ] }, "get": { "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/config", "path": "v1/{+name}", "id": "datalineage.organizations.locations.config.get", "description": "Get the Config for a given resource.", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "response": { "$ref": "GoogleCloudDatacatalogLineageConfigmanagementV1Config" }, "parameters": { "name": { "pattern": "^organizations/[^/]+/locations/[^/]+/config$", "location": "path", "required": true, "type": "string", "description": "Required. REQUIRED: The resource name of the config to be fetched. Format: `organizations/{organization_id}/locations/global/config` `folders/{folder_id}/locations/global/config` `projects/{project_id}/locations/global/config` `projects/{project_number}/locations/global/config`" } }, "parameterOrder": [ "name" ] } } } } } } } }, "schemas": { "GoogleCloudDatacatalogLineageV1SearchLinksResponse": { "description": "Response message for SearchLinks.", "id": "GoogleCloudDatacatalogLineageV1SearchLinksResponse", "properties": { "links": { "type": "array", "description": "The list of links for a given asset. Can be empty if the asset has no relations of requested type (source or target).", "items": { "$ref": "GoogleCloudDatacatalogLineageV1Link" } }, "nextPageToken": { "type": "string", "description": "The token to specify as `page_token` in the subsequent call to get the next page. Omitted if there are no more pages in the response." } }, "type": "object" }, "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestRootCriteria": { "description": "Criteria for the root of the search.", "type": "object", "id": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestRootCriteria", "properties": { "entities": { "description": "Optional. The entities to initiate the search from. Entities can be specified by FQN only, or by FQN and field. To search by FQN and all available fields for that FQN, use the wildcard `*` as the field value.", "$ref": "GoogleCloudDatacatalogLineageV1MultipleEntityReference" } } }, "GoogleCloudDatacatalogLineageV1LineageLinkLineageProcess": { "id": "GoogleCloudDatacatalogLineageV1LineageLinkLineageProcess", "properties": { "process": { "$ref": "GoogleCloudDatacatalogLineageV1Process", "description": "Process that created the link." } }, "description": "Process metadata for the link.", "type": "object" }, "GoogleLongrunningListOperationsResponse": { "id": "GoogleLongrunningListOperationsResponse", "properties": { "nextPageToken": { "description": "The standard List next-page token.", "type": "string" }, "operations": { "items": { "$ref": "GoogleLongrunningOperation" }, "type": "array", "description": "A list of operations that matches the specified filter in the request." }, "unreachable": { "items": { "type": "string" }, "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations.", "type": "array" } }, "type": "object", "description": "The response message for Operations.ListOperations." }, "GoogleCloudDatacatalogLineageV1OperationMetadata": { "type": "object", "properties": { "resourceUuid": { "type": "string", "description": "Output only. The UUID of the resource being operated on.", "readOnly": true }, "state": { "description": "Output only. The current operation state.", "enumDescriptions": [ "Unused.", "The operation has been created but is not yet started.", "The operation is underway.", "The operation completed successfully.", "The operation is no longer running and did not succeed." ], "enum": [ "STATE_UNSPECIFIED", "PENDING", "RUNNING", "SUCCEEDED", "FAILED" ], "readOnly": true, "type": "string" }, "createTime": { "description": "Output only. The timestamp of the operation submission to the server.", "format": "google-datetime", "readOnly": true, "type": "string" }, "resource": { "description": "Output only. The [relative name] (https://cloud.google.com//apis/design/resource_names#relative_resource_name) of the resource being operated on.", "readOnly": true, "type": "string" }, "endTime": { "format": "google-datetime", "type": "string", "description": "Output only. The timestamp of the operation termination, regardless of its success. This field is unset if the operation is still ongoing.", "readOnly": true }, "operationType": { "enum": [ "TYPE_UNSPECIFIED", "DELETE", "CREATE" ], "enumDescriptions": [ "Unused.", "The resource deletion operation.", "The resource creation operation." ], "description": "Output only. The type of the operation being performed.", "type": "string", "readOnly": true } }, "id": "GoogleCloudDatacatalogLineageV1OperationMetadata", "description": "Metadata describing the operation." }, "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestSearchLimits": { "id": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestSearchLimits", "properties": { "maxResults": { "format": "int32", "type": "integer", "description": "Optional. The maximum number of links to return in the response. The default value is 1_000 and the maximum value is 10_000." }, "maxDepth": { "description": "Optional. The maximum depth of the search. The default value is 5 and maximum value is 100.", "format": "int32", "type": "integer" }, "maxProcessPerLink": { "description": "Optional. The maximum number of processes to return per link. The default value is 0 and the maximum value is 100. If this value is non-zero, the response will contain process names for the links. To retrieve full process details in the response, include `links.processes.process` in the [FieldMask](https://developers.google.com/workspace/docs/api/how-tos/field-masks#read_with_a_field_mask).", "format": "int32", "type": "integer" } }, "type": "object", "description": "Limits for the search results." }, "GoogleCloudDatacatalogLineageV1EntityReference": { "type": "object", "properties": { "fullyQualifiedName": { "description": "Required. [Fully Qualified Name (FQN)](https://cloud.google.com/dataplex/docs/fully-qualified-names) of the entity.", "type": "string" }, "field": { "description": "Optional. Field path within the entity. Each nesting level should be a separate value in the repeated field. The order matters. Must be empty for asset level lineage For example to address \"salary.net\" subfield where \"salary\" is a column and \"net\" is a proto field two values in the `field` should be reported, the first is \"salary\" and the second is \"net\". Each field length is limited to 500 characters. Maximum supported nesting level is 20.", "items": { "type": "string" }, "type": "array" } }, "description": "The soft reference to everything you can attach a lineage event to.", "id": "GoogleCloudDatacatalogLineageV1EntityReference" }, "GoogleCloudDatacatalogLineageConfigmanagementV1Config": { "description": "Configuration for Data Lineage. Defines different configuration options for Lineage customers to control behaviour of lineage systems.", "type": "object", "properties": { "name": { "type": "string", "description": "Identifier. The resource name of the config. Format: `organizations/{organization_id}/locations/global/config` `folders/{folder_id}/locations/global/config` `projects/{project_id}/locations/global/config` `projects/{project_number}/locations/global/config`" }, "etag": { "type": "string", "description": "Optional. `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a config from overwriting each other. It is required that systems make use of the `etag` in the read-modify-write cycle to perform config updates in order to avoid race conditions: An `etag` is returned in the response to `GetConfig`, and systems are expected to put that etag in the request to `UpdateConfig` to ensure that their change will be applied to the same version of the config. If an `etag` is not provided in the call to `UpdateConfig`, then the existing config, if any, will be overwritten." }, "ingestion": { "description": "Optional. Ingestion rule for Data Lineage ingestion.", "$ref": "GoogleCloudDatacatalogLineageConfigmanagementV1ConfigIngestion" } }, "id": "GoogleCloudDatacatalogLineageConfigmanagementV1Config" }, "GoogleCloudDatacatalogLineageV1ProcessLinks": { "description": "Links associated with a specific process.", "id": "GoogleCloudDatacatalogLineageV1ProcessLinks", "properties": { "process": { "description": "The process name in the format of `projects/{project}/locations/{location}/processes/{process}`.", "type": "string" }, "links": { "type": "array", "description": "An array containing link details objects of the links provided in the original request. A single process can result in creating multiple links. If any of the links you provide in the request are created by the same process, they all are included in this array.", "items": { "$ref": "GoogleCloudDatacatalogLineageV1ProcessLinkInfo" } } }, "type": "object" }, "GoogleCloudDatacatalogLineageV1ListLineageEventsResponse": { "description": "Response message for ListLineageEvents.", "type": "object", "id": "GoogleCloudDatacatalogLineageV1ListLineageEventsResponse", "properties": { "lineageEvents": { "items": { "$ref": "GoogleCloudDatacatalogLineageV1LineageEvent" }, "description": "Lineage events from the specified project and location.", "type": "array" }, "nextPageToken": { "description": "The token to specify as `page_token` in the next call to get the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "GoogleCloudDatacatalogLineageV1LineageLink": { "description": "Lineage link between two entities.", "type": "object", "id": "GoogleCloudDatacatalogLineageV1LineageLink", "properties": { "location": { "type": "string", "description": "The location where the LineageEvent that created the link is stored." }, "depth": { "type": "integer", "description": "Depth of the current link in the graph starting from 1.", "format": "int32" }, "target": { "description": "The entity that is the **target** of this link.", "$ref": "GoogleCloudDatacatalogLineageV1EntityReference" }, "dependencyInfo": { "items": { "$ref": "GoogleCloudDatacatalogLineageV1LineageLinkDependencyInfo" }, "type": "array", "description": "Describes how the target entity is dependent on the source entity." }, "processes": { "type": "array", "description": "Processes metadata associated with the link.", "items": { "$ref": "GoogleCloudDatacatalogLineageV1LineageLinkLineageProcess" } }, "source": { "$ref": "GoogleCloudDatacatalogLineageV1EntityReference", "description": "The entity that is the **source** of this link." } } }, "GoogleCloudDatacatalogLineageConfigmanagementV1ConfigIngestionIngestionRuleIntegrationSelector": { "properties": { "integration": { "description": "Required. Integration to which the rule applies. This field can be used to specify the integration against which the ingestion rule should be applied.", "type": "string", "enum": [ "INTEGRATION_UNSPECIFIED", "BIGQUERY", "DATAPROC", "LOOKER_CORE", "MANAGED_AIRFLOW" ], "enumDescriptions": [ "Integration is Unspecified", "BigQuery", "Dataproc", "Looker Core", "Managed Service for Apache Airflow (formerly known as Cloud Composer)" ] } }, "id": "GoogleCloudDatacatalogLineageConfigmanagementV1ConfigIngestionIngestionRuleIntegrationSelector", "description": "Integration selector of the rule. The rule is only applied to the Integration selected by the selector.", "type": "object" }, "GoogleProtobufEmpty": { "properties": {}, "id": "GoogleProtobufEmpty", "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "type": "object" }, "GoogleCloudDatacatalogLineageV1Origin": { "properties": { "sourceType": { "type": "string", "enum": [ "SOURCE_TYPE_UNSPECIFIED", "CUSTOM", "BIGQUERY", "DATA_FUSION", "COMPOSER", "LOOKER_STUDIO", "DATAPROC", "VERTEX_AI", "DATAFLOW", "LOOKER_CORE" ], "description": "Type of the source. Use of a source_type other than `CUSTOM` for process creation or updating is highly discouraged. It might be restricted in the future without notice. There will be increase in cost if you use any of the source types other than `CUSTOM`.", "enumDescriptions": [ "Source is Unspecified", "A custom source", "BigQuery", "Data Fusion", "Composer", "Looker Studio", "Dataproc", "Vertex AI", "Dataflow", "Looker Core" ] }, "name": { "type": "string", "description": "If the source_type isn't CUSTOM, the value of this field should be a Google Cloud resource name of the system, which reports lineage. The project and location parts of the resource name must match the project and location of the lineage resource being created. Examples: - `{source_type: COMPOSER, name: \"projects/foo/locations/us/environments/bar\"}` - `{source_type: BIGQUERY, name: \"projects/foo/locations/eu\"}` - `{source_type: CUSTOM, name: \"myCustomIntegration\"}`" } }, "description": "Origin of a process.", "id": "GoogleCloudDatacatalogLineageV1Origin", "type": "object" }, "GoogleCloudDatacatalogLineageV1BatchSearchLinkProcessesResponse": { "type": "object", "id": "GoogleCloudDatacatalogLineageV1BatchSearchLinkProcessesResponse", "properties": { "processLinks": { "description": "An array of processes associated with the specified links.", "type": "array", "items": { "$ref": "GoogleCloudDatacatalogLineageV1ProcessLinks" } }, "nextPageToken": { "description": "The token to specify as `page_token` in the subsequent call to get the next page. Omitted if there are no more pages in the response.", "type": "string" } }, "description": "Response message for BatchSearchLinkProcesses." }, "GoogleCloudDatacatalogLineageV1Process": { "id": "GoogleCloudDatacatalogLineageV1Process", "description": "A process is the definition of a data transformation operation.", "type": "object", "properties": { "attributes": { "additionalProperties": { "type": "any" }, "type": "object", "description": "Optional. The attributes of the process. Should only be used for the purpose of non-semantic management (classifying, describing or labeling the process). Up to 100 attributes are allowed." }, "name": { "type": "string", "description": "Immutable. The resource name of the lineage process. Format: `projects/{project}/locations/{location}/processes/{process}`. Can be specified or auto-assigned. {process} must be not longer than 200 characters and only contain characters in a set: `a-zA-Z0-9_-:.`" }, "displayName": { "type": "string", "description": "Optional. A human-readable name you can set to display in a user interface. Must be not longer than 200 characters and only contain UTF-8 letters or numbers, spaces or characters like `_-:&.`" }, "origin": { "description": "Optional. The origin of this process and its runs and lineage events.", "$ref": "GoogleCloudDatacatalogLineageV1Origin" } } }, "GoogleLongrunningCancelOperationRequest": { "id": "GoogleLongrunningCancelOperationRequest", "properties": {}, "type": "object", "description": "The request message for Operations.CancelOperation." }, "GoogleCloudDatacatalogLineageV1Run": { "type": "object", "id": "GoogleCloudDatacatalogLineageV1Run", "description": "A lineage run represents an execution of a process that creates lineage events.", "properties": { "attributes": { "description": "Optional. The attributes of the run. Should only be used for the purpose of non-semantic management (classifying, describing or labeling the run). Up to 100 attributes are allowed.", "type": "object", "additionalProperties": { "type": "any" } }, "state": { "enumDescriptions": [ "The state is unknown. The true state may be any of the below or a different state that is not supported here explicitly.", "The run is still executing.", "The run completed.", "The run failed.", "The run aborted." ], "type": "string", "enum": [ "UNKNOWN", "STARTED", "COMPLETED", "FAILED", "ABORTED" ], "description": "Required. The state of the run." }, "startTime": { "type": "string", "format": "google-datetime", "description": "Required. The timestamp of the start of the run." }, "endTime": { "format": "google-datetime", "type": "string", "description": "Optional. The timestamp of the end of the run." }, "name": { "description": "Immutable. The resource name of the run. Format: `projects/{project}/locations/{location}/processes/{process}/runs/{run}`. Can be specified or auto-assigned. {run} must be not longer than 200 characters and only contain characters in a set: `a-zA-Z0-9_-:.`", "type": "string" }, "displayName": { "type": "string", "description": "Optional. A human-readable name you can set to display in a user interface. Must be not longer than 200 characters and only contain UTF-8 letters or numbers, spaces or characters like `_-:&.`" } } }, "GoogleRpcStatus": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "type": "object", "properties": { "code": { "description": "The status code, which should be an enum value of google.rpc.Code.", "type": "integer", "format": "int32" }, "details": { "type": "array", "items": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." } }, "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use." }, "message": { "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", "type": "string" } }, "id": "GoogleRpcStatus" }, "GoogleLongrunningOperation": { "id": "GoogleLongrunningOperation", "type": "object", "description": "This resource represents a long-running operation that is the result of a network API call.", "properties": { "response": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`." }, "name": { "type": "string", "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`." }, "error": { "description": "The error result of the operation in case of failure or cancellation.", "$ref": "GoogleRpcStatus" }, "metadata": { "type": "object", "additionalProperties": { "description": "Properties of the object. Contains field @type with type URL.", "type": "any" }, "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any." }, "done": { "type": "boolean", "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available." } } }, "GoogleTypeInterval": { "properties": { "startTime": { "format": "google-datetime", "type": "string", "description": "Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start." }, "endTime": { "format": "google-datetime", "description": "Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.", "type": "string" } }, "type": "object", "description": "Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.", "id": "GoogleTypeInterval" }, "GoogleCloudDatacatalogLineageConfigmanagementV1ConfigIngestion": { "properties": { "rules": { "type": "array", "items": { "$ref": "GoogleCloudDatacatalogLineageConfigmanagementV1ConfigIngestionIngestionRule" }, "description": "Optional. List of rules for Data Lineage ingestion." } }, "id": "GoogleCloudDatacatalogLineageConfigmanagementV1ConfigIngestion", "description": "Defines how Lineage should be ingested for a given resource.", "type": "object" }, "GoogleCloudDatacatalogLineageV1ListProcessesResponse": { "description": "Response message for ListProcesses.", "type": "object", "id": "GoogleCloudDatacatalogLineageV1ListProcessesResponse", "properties": { "processes": { "description": "The processes from the specified project and location.", "type": "array", "items": { "$ref": "GoogleCloudDatacatalogLineageV1Process" } }, "nextPageToken": { "type": "string", "description": "The token to specify as `page_token` in the next call to get the next page. If this field is omitted, there are no subsequent pages." } } }, "GoogleCloudDatacatalogLineageV1ListRunsResponse": { "description": "Response message for ListRuns.", "properties": { "runs": { "description": "The runs from the specified project and location.", "type": "array", "items": { "$ref": "GoogleCloudDatacatalogLineageV1Run" } }, "nextPageToken": { "description": "The token to specify as `page_token` in the next call to get the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "type": "object", "id": "GoogleCloudDatacatalogLineageV1ListRunsResponse" }, "GoogleCloudDatacatalogLineageConfigmanagementV1ConfigIngestionIngestionRule": { "properties": { "lineageEnablement": { "description": "Required. Lineage enablement configuration. Defines configurations for the ingestion of lineage for the resource and its children. If unspecified, the ingestion will be enabled only if it was configured in the resource's parent.", "$ref": "GoogleCloudDatacatalogLineageConfigmanagementV1ConfigIngestionIngestionRuleLineageEnablement" }, "integrationSelector": { "description": "Required. Integration selector of the rule. The rule is only applied to the Integration selected by the selector.", "$ref": "GoogleCloudDatacatalogLineageConfigmanagementV1ConfigIngestionIngestionRuleIntegrationSelector" } }, "type": "object", "id": "GoogleCloudDatacatalogLineageConfigmanagementV1ConfigIngestionIngestionRule", "description": "Ingestion rule for Data Lineage ingestion." }, "GoogleCloudDatacatalogLineageV1BatchSearchLinkProcessesRequest": { "id": "GoogleCloudDatacatalogLineageV1BatchSearchLinkProcessesRequest", "description": "Request message for BatchSearchLinkProcesses.", "properties": { "links": { "items": { "type": "string" }, "type": "array", "description": "Required. An array of links to check for their associated LineageProcesses. The maximum number of items in this array is 100. If the request contains more than 100 links, it returns the `INVALID_ARGUMENT` error. Format: `projects/{project}/locations/{location}/links/{link}`." }, "pageSize": { "description": "Optional. The maximum number of processes to return in a single page of the response. A page may contain fewer results than this value.", "format": "int32", "type": "integer" }, "pageToken": { "type": "string", "description": "Optional. The page token received from a previous `BatchSearchLinkProcesses` call. Use it to get the next page. When requesting subsequent pages of a response, remember that all parameters must match the values you provided in the original request." } }, "type": "object" }, "GoogleCloudDatacatalogLineageV1LineageLinkDependencyInfo": { "properties": { "dependencyType": { "type": "string", "enum": [ "DEPENDENCY_TYPE_UNSPECIFIED", "EXACT_COPY", "OTHER" ], "description": "The type of dependency.", "enumDescriptions": [ "Dependency type unspecified.", "Exact data copy without any change.", "Other types of dependencies like filtering or grouping." ] } }, "description": "Dependency info describes how one entity is dependent on another.", "id": "GoogleCloudDatacatalogLineageV1LineageLinkDependencyInfo", "type": "object" }, "GoogleCloudDatacatalogLineageV1MultipleEntityReference": { "id": "GoogleCloudDatacatalogLineageV1MultipleEntityReference", "properties": { "entities": { "items": { "$ref": "GoogleCloudDatacatalogLineageV1EntityReference" }, "type": "array", "description": "Optional. The list of entities to search for links. The maximum number of entities is 20." } }, "description": "Multiple entity reference for SearchLinksRequest.", "type": "object" }, "GoogleCloudDatacatalogLineageConfigmanagementV1ConfigIngestionIngestionRuleLineageEnablement": { "type": "object", "description": "Lineage enablement configuration. Defines configurations for the ingestion of lineage for the resource and its children.", "properties": { "enabled": { "description": "Optional. If true, ingestion of lineage should be enabled. If false, it should be disabled. If unspecified, the system default value is used.", "type": "boolean" } }, "id": "GoogleCloudDatacatalogLineageConfigmanagementV1ConfigIngestionIngestionRuleLineageEnablement" }, "GoogleCloudDatacatalogLineageV1Link": { "description": "Links represent the data flow between **source** (upstream) and **target** (downstream) assets in transformation pipelines. Links are created when LineageEvents record data transformation between related assets.", "type": "object", "id": "GoogleCloudDatacatalogLineageV1Link", "properties": { "endTime": { "description": "The end of the last event establishing this link.", "format": "google-datetime", "type": "string" }, "target": { "$ref": "GoogleCloudDatacatalogLineageV1EntityReference", "description": "The pointer to the entity that is the **target** of this link." }, "name": { "description": "Output only. Immutable. The name of the link. Format: `projects/{project}/locations/{location}/links/{link}`.", "readOnly": true, "type": "string" }, "dependencyInfo": { "items": { "$ref": "GoogleCloudDatacatalogLineageV1LinkDependencyInfo" }, "description": "Optional. The dependency info of the link (applies only to column level links).", "type": "array" }, "source": { "description": "The pointer to the entity that is the **source** of this link.", "$ref": "GoogleCloudDatacatalogLineageV1EntityReference" }, "startTime": { "description": "The start of the first event establishing this link.", "format": "google-datetime", "type": "string" } } }, "GoogleCloudDatacatalogLineageV1ProcessLinkInfo": { "description": "Link details.", "type": "object", "properties": { "link": { "description": "The name of the link in the format of `projects/{project}/locations/{location}/links/{link}`.", "type": "string" }, "startTime": { "format": "google-datetime", "type": "string", "description": "The start of the first event establishing this link-process tuple." }, "endTime": { "description": "The end of the last event establishing this link-process tuple.", "format": "google-datetime", "type": "string" } }, "id": "GoogleCloudDatacatalogLineageV1ProcessLinkInfo" }, "GoogleCloudDatacatalogLineageV1ProcessOpenLineageRunEventResponse": { "type": "object", "properties": { "process": { "type": "string", "description": "Created process name. Format: `projects/{project}/locations/{location}/processes/{process}`." }, "lineageEvents": { "description": "Created lineage event names. Format: `projects/{project}/locations/{location}/processes/{process}/runs/{run}/lineageEvents/{lineage_event}`.", "items": { "type": "string" }, "type": "array" }, "run": { "type": "string", "description": "Created run name. Format: `projects/{project}/locations/{location}/processes/{process}/runs/{run}`." } }, "id": "GoogleCloudDatacatalogLineageV1ProcessOpenLineageRunEventResponse", "description": "Response message for ProcessOpenLineageRunEvent." }, "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestSearchFilters": { "description": "Filters for the search.", "id": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestSearchFilters", "properties": { "entitySet": { "enumDescriptions": [ "The entity set is unspecified. Returns all the data.", "Returns entities with only FQN specified. For example, entities with the `field` field set are not returned." ], "description": "Optional. Entity set restriction. If unspecified, the method returns all entities.", "type": "string", "enum": [ "ENTITY_SET_UNSPECIFIED", "ENTITIES" ] }, "timeRange": { "description": "Optional. Time interval to search for lineage. If unspecified, all lineage is returned. Currently, at most one of `start_time` and `end_time` can be set.", "$ref": "GoogleTypeInterval" }, "dependencyTypes": { "type": "array", "description": "Optional. Types of dependencies between entities to retrieve. If unspecified, all dependency types are returned.", "items": { "enumDescriptions": [ "Dependency type unspecified.", "Exact data copy without any change.", "Other types of dependencies like filtering or grouping." ], "type": "string", "enum": [ "DEPENDENCY_TYPE_UNSPECIFIED", "EXACT_COPY", "OTHER" ] } } }, "type": "object" }, "GoogleCloudDatacatalogLineageV1SearchLineageStreamingResponse": { "properties": { "unreachable": { "type": "array", "description": "Unordered list. Unreachable resources. If non-empty, the result set might be incomplete. Currently, only locations are supported. Format: `projects/[PROJECT_NUMBER]/locations/[LOCATION]` Example: projects/123456789/locations/us-east1", "items": { "type": "string" } }, "links": { "description": "Output only. The lineage links that match the search criteria. Can be empty if no links match.", "readOnly": true, "items": { "$ref": "GoogleCloudDatacatalogLineageV1LineageLink" }, "type": "array" } }, "type": "object", "description": "Response message for SearchLineageStreaming.", "id": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingResponse" }, "GoogleCloudDatacatalogLineageV1DependencyInfo": { "properties": { "dependencyType": { "type": "string", "enum": [ "DEPENDENCY_TYPE_UNSPECIFIED", "EXACT_COPY", "OTHER" ], "enumDescriptions": [ "Dependency type unspecified.", "Exact data copy without any change.", "Other types of dependencies like filtering or grouping." ], "description": "Required. Type of dependency." } }, "type": "object", "id": "GoogleCloudDatacatalogLineageV1DependencyInfo", "description": "Dependency info describes how one entity depends on another." }, "GoogleCloudDatacatalogLineageV1SearchLinksRequest": { "description": "Request message for SearchLinks.", "id": "GoogleCloudDatacatalogLineageV1SearchLinksRequest", "type": "object", "properties": { "targets": { "$ref": "GoogleCloudDatacatalogLineageV1MultipleEntityReference", "description": "Optional. Send a list of asset information in the **targets** field to retrieve all links that lead from upstream assets to the specified assets. This field is similar to the `target` target field but allows providing multiple entities. All entities within the `MultipleEntityReference` must have the same `fully_qualified_name`." }, "sources": { "$ref": "GoogleCloudDatacatalogLineageV1MultipleEntityReference", "description": "Optional. Send a list of asset information in the **sources** field to retrieve all links that lead from the specified assets to downstream assets. This field is similar to the `source` source field but allows providing multiple entities. All entities within the `MultipleEntityReference` must have the same `fully_qualified_name`." }, "source": { "description": "Optional. Send asset information in the **source** field to retrieve all links that lead from the specified asset to downstream assets.", "$ref": "GoogleCloudDatacatalogLineageV1EntityReference" }, "pageToken": { "type": "string", "description": "Optional. The page token received from a previous `SearchLinksRequest` call. Use it to get the next page. When requesting subsequent pages of a response, remember that all parameters must match the values you provided in the original request." }, "pageSize": { "type": "integer", "format": "int32", "description": "Optional. The maximum number of links to return in a single page of the response. A page may contain fewer links than this value. If unspecified, at most 10 links are returned. Maximum value is 100; values greater than 100 are reduced to 100." }, "target": { "description": "Optional. Send asset information in the **target** field to retrieve all links that lead from upstream assets to the specified asset.", "$ref": "GoogleCloudDatacatalogLineageV1EntityReference" } } }, "GoogleCloudDatacatalogLineageV1LinkDependencyInfo": { "type": "object", "properties": { "dependencyType": { "type": "string", "enum": [ "DEPENDENCY_TYPE_UNSPECIFIED", "EXACT_COPY", "OTHER" ], "description": "The type of dependency.", "enumDescriptions": [ "Dependency type unspecified.", "Exact data copy without any change.", "Other types of dependencies like filtering or grouping." ] } }, "id": "GoogleCloudDatacatalogLineageV1LinkDependencyInfo", "description": "Dependency info describes how one entity depends on another." }, "GoogleCloudDatacatalogLineageV1EventLink": { "id": "GoogleCloudDatacatalogLineageV1EventLink", "description": "A lineage between source and target entities.", "type": "object", "properties": { "source": { "$ref": "GoogleCloudDatacatalogLineageV1EntityReference", "description": "Required. Reference to the source entity" }, "target": { "description": "Required. Reference to the target entity", "$ref": "GoogleCloudDatacatalogLineageV1EntityReference" }, "dependencyInfo": { "description": "Optional. Describes how the target depends on the source.", "$ref": "GoogleCloudDatacatalogLineageV1DependencyInfo" } } }, "GoogleCloudDatacatalogLineageV1LineageEvent": { "properties": { "links": { "items": { "$ref": "GoogleCloudDatacatalogLineageV1EventLink" }, "type": "array", "description": "Optional. List of source-target pairs. Can't contain more than 100 tuples." }, "endTime": { "format": "google-datetime", "description": "Optional. The end of the transformation which resulted in this lineage event. For streaming scenarios, it should be the end of the period from which the lineage is being reported.", "type": "string" }, "startTime": { "type": "string", "format": "google-datetime", "description": "Required. The beginning of the transformation which resulted in this lineage event. For streaming scenarios, it should be the beginning of the period from which the lineage is being reported." }, "name": { "description": "Immutable. The resource name of the lineage event. Format: `projects/{project}/locations/{location}/processes/{process}/runs/{run}/lineageEvents/{lineage_event}`. Can be specified or auto-assigned. {lineage_event} must be not longer than 200 characters and only contain characters in a set: `a-zA-Z0-9_-:.`", "type": "string" } }, "id": "GoogleCloudDatacatalogLineageV1LineageEvent", "description": "A lineage event represents an operation on assets. Within the operation, the data flows from the source to the target defined in the links field.", "type": "object" }, "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequest": { "properties": { "filters": { "$ref": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestSearchFilters", "description": "Optional. Filters for the search." }, "limits": { "description": "Optional. Limits for the search.", "$ref": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestSearchLimits" }, "direction": { "description": "Required. Direction of the search.", "type": "string", "enum": [ "SEARCH_DIRECTION_UNSPECIFIED", "DOWNSTREAM", "UPSTREAM" ], "enumDescriptions": [ "Direction is unspecified.", "Retrieve links that lead from the specified asset to downstream assets.", "Retrieve links that lead from upstream assets to the specified asset." ] }, "rootCriteria": { "description": "Required. Criteria for the root of the search.", "$ref": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestRootCriteria" }, "locations": { "items": { "type": "string" }, "description": "Required. The locations to search in. This list should contain the location from the `parent` field.", "type": "array" } }, "description": "Request message for SearchLineageStreaming.", "type": "object", "id": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequest" } }, "name": "datalineage", "parameters": { "alt": { "default": "json", "description": "Data format for response.", "type": "string", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "enum": [ "json", "media", "proto" ], "location": "query" }, "oauth_token": { "location": "query", "type": "string", "description": "OAuth 2.0 token for the current user." }, "upload_protocol": { "type": "string", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query" }, "$.xgafv": { "description": "V1 error format.", "enum": [ "1", "2" ], "enumDescriptions": [ "v1 error format", "v2 error format" ], "location": "query", "type": "string" }, "fields": { "location": "query", "description": "Selector specifying which fields to include in a partial response.", "type": "string" }, "callback": { "description": "JSONP", "location": "query", "type": "string" }, "quotaUser": { "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "location": "query", "type": "string" }, "prettyPrint": { "type": "boolean", "location": "query", "description": "Returns response with indentations and line breaks.", "default": "true" }, "access_token": { "location": "query", "type": "string", "description": "OAuth access token." }, "key": { "location": "query", "type": "string", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." }, "uploadType": { "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query" } }, "rootUrl": "https://datalineage.googleapis.com/", "fullyEncodeReservedExpansion": true, "description": "", "revision": "20260822", "version": "v1", "ownerDomain": "google.com", "documentationLink": "https://cloud.google.com/data-catalog", "baseUrl": "https://datalineage.googleapis.com/", "protocol": "rest", "mtlsRootUrl": "https://datalineage.mtls.googleapis.com/", "title": "Data Lineage API", "canonicalName": "Datalineage", "version_module": true, "batchPath": "batch", "basePath": "", "icons": { "x32": "http://www.google.com/images/icons/product/search-32.gif", "x16": "http://www.google.com/images/icons/product/search-16.gif" }, "discoveryVersion": "v1" }