{
  "slug": "gcloud-datalineage-adds-run-and-lineage-event-command-groups-9e51e0bde001",
  "title": "gcloud datalineage adds run and lineage-event command groups",
  "tools": [
    "gcloud"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-07-14T00:00:00.000Z",
  "announced_at": "2026-07-14T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When managing Data Lineage, use `gcloud datalineage runs` to create or list runs and `gcloud datalineage lineage-events` to create events.",
    "examples": [
      "gcloud datalineage runs create <run> --process=<process> --location=<location> --state=started --start-time=<RFC3339-time>",
      "gcloud datalineage runs list --process=<process> --location=<location>",
      "gcloud datalineage lineage-events create <event> --run=<run> --process=<process> --location=<location> --start-time=<RFC3339-time>"
    ],
    "gotchas": [
      "<run> (required): Run ID or fully qualified identifier.",
      "--process (required): Process name for the run; required when listing runs.",
      "--location (required): Location of the run or process.",
      "--state (required): Run state: aborted, completed, failed, started, or unknown.",
      "--start-time (required): Run start time.",
      "<event> (required): Lineage event ID or fully qualified identifier.",
      "--run (required): Name of the run for the event.",
      "--process (required): Name of the process for the event.",
      "--location (required): Location of the event.",
      "--start-time (required): Event start time.",
      "Prerequisite: The gcloud command reference documents these command groups in release 576.0.0, dated 2026-07-14.",
      "Prerequisite: Creating runs requires IAM permission `datalineage.runs.create` on the parent process."
    ]
  },
  "why_it_matters": "Manage data lineage runs using the gcloud datalineage command groups.",
  "sources": [
    "https://docs.cloud.google.com/sdk/docs/release-notes#57600_2026-07-14",
    "https://docs.cloud.google.com/sdk/gcloud/reference/datalineage/runs/create",
    "https://docs.cloud.google.com/sdk/gcloud/reference/datalineage/runs/list",
    "https://docs.cloud.google.com/sdk/gcloud/reference/datalineage/lineage-events/create",
    "https://docs.cloud.google.com/knowledge-catalog/docs/reference/data-lineage/rest/v1/projects.locations.processes.runs/create"
  ],
  "rank": 0.90017,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "cloud-20261008",
    "verdict_id": "cloud-20261008:cloud-20261008-7679da116ca71cec-5:gate",
    "evidence_hash": "7fca986dfc8e4bc5c4bdd9b6ae8cdbab44928d85abb86f7fd51d1310321638a9"
  },
  "review": {
    "draft_hash": "0e76437ff55e15c3266396a63c35c0fe0c31e6446116bea028f13a103b7c1db5",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "cloud-20261008:gate",
    "reason": "2 of 3 judge runs approved with p_yes >= 0.9 (mean 0.90 >= 0.9; 2 needed) and Jev gave 0.63 (>= 0.6 needed)."
  }
}