מחיקת הפעלות של צינורות

אם הפרויקט שלכם מכיל הפעלות של צינורות שלא הצליחו או בוטלו, אתם יכולים למחוק אותן. אפשר למחוק עד 32 הפעלות של צינורות בעת ביצוע פעולת מחיקה של כמות גדולה.

כשמתחילים למחוק הפעלה של צינור עיבוד נתונים, הסטטוס של ההפעלה משתנה לבתהליך מחיקה. אם הצינור יישאר במצב הזה למשך שעה, הוא יתווסף לתור למחיקה סופית ב-Gemini Enterprise Agent Platform Pipelines. לאחר מכן, פעולה מתוזמנת יומית מסירה באופן סופי את כל ההרצות של צינורות עיבוד הנתונים שהוכנסו לתור למחיקה סופית.

מחיקת הפעלה של צינור עיבוד נתונים

כדי למחוק הפעלה של פייפליין, משתמשים במסוף, ב-API בארכיטקטורת REST או ב-Agent Platform SDK ל-Python. Cloud de Confiance

המסוף

כדי למחוק הפעלה של צינור מתמשך מהמסוף Cloud de Confiance :

  1. בקטע Agent Platform, עוברים לכרטיסייה Runs בדף Pipelines.

    לדף Runs

  2. מסמנים את התיבה לצד הרצת צינור שבוטלה או נכשלה שרוצים למחוק.
  3. לוחצים על Delete. האפשרות הזו זמינה רק אם הסטטוס של הפעלת צינור הנתונים הוא נכשל או בוטל.

אחרי שלוחצים על מחיקה, הסטטוס של הפעלת צינור הנתונים משתנה לבתהליך מחיקה, לפני שהוא נמחק באופן סופי.

REST

כדי למחוק הפעלה של צינור נתונים שמתבצעת או מתוזמנת, שולחים בקשת DELETE באמצעות השיטה pipelineJobs.delete.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫LOCATION: האזור שבו נמצאת ההרצה של צינור העיבוד. מידע נוסף על האזורים שבהם זמינים צינורות של Agent Platform זמין במדריך מיקומים של Agent Platform ב-Gemini Enterprise.
  • ‫PROJECT_ID: Cloud de Confiance by S3NS הפרויקט שמכיל את ההרצה של צינור הנתונים.
  • ‫PIPELINE_RUN_ID: המזהה הייחודי של הפעלת הצינור שרוצים למחוק. מזהה ההרצה של צינור העיבוד מוצג בכרטיסייה Runs בדף Pipelines במסוף Cloud de Confiance .

ה-method של ה-HTTP וכתובת ה-URL:

DELETE https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID

כדי לשלוח את הבקשה אתם צריכים לבחור אחת מהאפשרויות הבאות:

curl

מריצים את הפקודה הבאה:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID"

PowerShell

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/PROJECT_NUMBER/locations/us-central1/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteOperationMetadata",
    "genericMetadata": {
      "createTime": "2025-07-25T16:23:47.201943Z",
      "updateTime": "2025-07-25T16:23:47.201943Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  }
}

Python

בדוגמה הבאה מוסבר איך למחוק הפעלה של צינור שלא הצליחה או בוטלה באמצעות השיטה PipelineJob.delete:

from google.cloud import aiplatform
aiplatform.init(project="PROJECT_ID", location="LOCATION")
pipeline_job = aiplatform.PipelineJob.get(resource_name="PIPELINE_RUN_ID")
pipeline_job.delete()

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: Cloud de Confiance by S3NS הפרויקט שמכיל את ההרצה של צינור הנתונים.
  • ‫LOCATION: האזור שבו נמצאת ההרצה של צינור העיבוד. מידע נוסף על האזורים שבהם זמינים צינורות של Agent Platform זמין במדריך מיקומים של Agent Platform ב-Gemini Enterprise.
  • ‫PIPELINE_RUN_ID עם המזהה הייחודי של הפעלת הצינור שרוצים למחוק. המזהה מוצג בכרטיסייה Runs בדף Pipelines במסוףCloud de Confiance .

מחיקה של כמה הרצות של צינורות

כדי למחוק כמה הרצות של פייפליינים שכשלו או בוטלו בו-זמנית, אפשר להשתמש בCloud de Confiance מסוף, ב-API בארכיטקטורת REST או ב-Agent Platform SDK ל-Python. אפשר למחוק בבת אחת כמה הרצות של צינורות שנמצאות באותו פרויקט ובאותו אזור.

המסוף

כדי למחוק כמה הרצות של צינורות נתונים שמתבצעות כרגע במסוף Cloud de Confiance :

  1. בקטע Agent Platform, עוברים לכרטיסייה Runs בדף Pipelines.

    לדף Runs

  2. מסמנים את תיבות הסימון לצד ההרצות של צינורות העיבוד שבוטלו או נכשלו שרוצים למחוק.
  3. לוחצים על Delete. האפשרות הזו זמינה רק אם כל ההרצות של צינורות הנתונים שנבחרו נמצאות בסטטוס Failed או Canceled.

אחרי שלוחצים על מחיקה, הסטטוס של הפעלות הצינור שנבחרו משתנה לבתהליך מחיקה, לפני שההפעלות נמחקות סופית.

REST

כדי למחוק כמה הרצות של צינורות נתונים שמתבצעות או מתוזמנות, שולחים בקשת POST באמצעות השיטה pipelineJobs.batchDelete.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫LOCATION: האזור שבו נמצאים ההרצות של צינור עיבוד הנתונים. מידע נוסף על האזורים שבהם זמינים צינורות של Agent Platform זמין במדריך מיקומים של Agent Platform ב-Gemini Enterprise.
  • ‫PROJECT_ID: הפרויקט Cloud de Confiance by S3NS שמכיל את ההרצות של צינורות הנתונים.
  • ‫PIPELINE_RUN_ID_1, ‏PIPELINE_RUN_ID_2: המזהים של משימות הצינור שרוצים למחוק. מזהה העבודה מופיע בכרטיסייה Runs בדף Pipelines במסוף Cloud de Confiance .

ה-method של ה-HTTP וכתובת ה-URL:

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs:batchDelete

גוף בקשת JSON:

{
  "names": [
    "projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID_1",
    "projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID_2"
  ]
}

כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs:batchDelete"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/pipelineJobs:batchDelete" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteOperationMetadata",
    "genericMetadata": {
      "createTime": "2025-05-31T16:07:12.233655Z",
      "updateTime": "2025-05-31T16:07:12.233655Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.BatchDeletePipelineJobsResponse",
    "pipelineJobs": [
      {
        "name": "projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID_1"
      },
      {
        "name": "projects/PROJECT_ID/locations/LOCATION/pipelineJobs/PIPELINE_RUN_ID_2"
      }
    ]
  }
}

Python

בדוגמה הבאה מוצג איך למחוק כמה הפעלות של צינורות נתונים שמתבצעות או מתוזמנות, באמצעות השיטה PipelineJob.batch_delete:

from google.cloud import aiplatform_v1
from google.api_core.client_options import ClientOptions
pipeline_run_ids_to_delete = ["PIPELINE_RUN_ID_1",
  "PIPELINE_RUN_ID_2",
]
client_options = ClientOptions(api_endpoint=f"LOCATION-aiplatform.googleapis.com")
pipeline_job_client = aiplatform_v1.PipelineServiceClient(client_options=client_options)
pipeline_resource_names_to_delete = []
for run_id in pipeline_run_ids_to_delete:
  full_resource_name = f"projects/PROJECT_NUMBER/locations/LOCATION/pipelineJobs/{run_id}"
  pipeline_resource_names_to_delete.append(full_resource_name)
parent = f"projects/PROJECT_ID/locations/LOCATION"
pipeline_job_client.batch_delete_pipeline_jobs(
  parent=parent,
  names=pipeline_resource_names_to_delete
)

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט.
  • ‫PROJECT_ID: הפרויקט Cloud de Confiance by S3NS שמכיל את ההרצות של צינורות הנתונים.
  • ‫PROJECT_NUMBER: מספר הפרויקט. אפשר למצוא את מספר הפרויקט במסוף Cloud de Confiance . מידע נוסף זמין במאמר איך מוצאים את השם, המספר והמזהה של הפרויקט.
  • ‫PIPELINE_RUN_ID_1, ‏PIPELINE_RUN_ID_2: המזהים של משימות הצינור שרוצים למחוק. מזהי ההרצה של צינורות העיבוד מוצגים בכרטיסייה Runs בדף Pipelines במסוף Cloud de Confiance .