מחיקת משימה
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
במאמר הזה נסביר איך למחוק משימה. ההנחה היא שהגדרתם את Fleet Engine. מידע נוסף מופיע במאמר בנושא הגדרת Fleet Engine.
עקרונות בסיסיים למחיקת משימות
יכול להיות שהמערכת שלכם תשתמש ב-Fleet Engine כדי למחוק משימה במצבים הבאים:
- כדי לבצע פעולות ניקוי במהלך בדיקה של ממשקי Fleet Engine API.
- כדי למחוק מיד משימה שכבר לא נדרשת.
כדי למחוק משימה, שולחים בקשה באמצעות gRPC או REST.
- שיטה:
DeleteTask()
gRPC או REST
- הודעה
DeleteTaskRequest
: gRPC בלבד
משתמשים בפרטי הכניסה המתאימים לחשבון השירות של הפרויקט, כפי שמתואר במאמר Fleet Engine: תפקידים בחשבון שירות.
דוגמה: מחיקת משימה
בדוגמה הבאה מוסבר איך למחוק משימה ב-Fleet Engine.
static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String TASK_ID = "task-8241890";
String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
DeliveryServiceBlockingStub deliveryService = DeliveryServiceGrpc.newBlockingStub(channel);
// Delete task request.
DeleteTaskRequest deleteTaskRequest = DeleteTaskRequest.newBuilder()
.setName(taskName)
.build();
// Error handling.
try {
deliveryService.deleteTask(deleteTaskRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case NOT_FOUND: // The task doesn't exist.
break;
case FAILED_PRECONDITION: // Task is active and assigned to a delivery vehicle.
break;
case PERMISSION_DENIED:
break;
}
return;
}
טיפול בשגיאות
כשמוחקים משימה, יכול להיות שתופיע שגיאה FAILED_PRECONDITION
. במקרה כזה, המשימה פעילה ומשויכת לרכב משלוחים.
כדי להמשיך במחיקה, סוגרים את המשימה.
המאמרים הבאים
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-31 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-31 (שעון UTC)."],[],[],null,["This document describes how to delete a task. It assumes you\nhave set up Fleet Engine. See [Set up Fleet Engine](/maps/documentation/mobility/fleet-engine/essentials/set-up-fleet).\n\nTask deletion basics\n\nYour system may use Fleet Engine to delete a task in the following situations:\n\n- To perform cleanup operations while testing Fleet Engine APIs.\n- To immediately delete a Task that is no longer required.\n\nTo delete a task, send a request using either gRPC or REST.\n\n- `DeleteTask()` method: [gRPC](/maps/documentation/mobility/fleet-engine/reference/tasks/rpc/maps.fleetengine.delivery.v1#maps.fleetengine.delivery.v1.DeliveryService) or [REST](/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/providers.tasks/delete)\n- `DeleteTaskRequest` message: [gRPC](/maps/documentation/mobility/fleet-engine/reference/tasks/rpc/maps.fleetengine.delivery.v1#deletetaskrequest) only\n\nUse the appropriate credentials for the service account of your project as\ndescribed in [Fleet Engine: Service account roles](/maps/documentation/mobility/fleet-engine/essentials/set-up-fleet/service-accounts).\n| **Note:** Fleet Engine automatically deletes a task after it has been inactive for a period of time. See [Life of a task](/maps/documentation/mobility/fleet-engine/journeys/tasks#life_of_a_task).\n\nExample: delete task\n\nThe following example demonstrates how to delete a task in Fleet Engine. \n\n static final String PROJECT_ID = \"my-delivery-co-gcp-project\";\n static final String TASK_ID = \"task-8241890\";\n\n String taskName = \"providers/\" + PROJECT_ID + \"/tasks/\" + TASK_ID;\n\n DeliveryServiceBlockingStub deliveryService = DeliveryServiceGrpc.newBlockingStub(channel);\n\n // Delete task request.\n DeleteTaskRequest deleteTaskRequest = DeleteTaskRequest.newBuilder()\n .setName(taskName)\n .build();\n\n // Error handling.\n try {\n deliveryService.deleteTask(deleteTaskRequest);\n } catch (StatusRuntimeException e) {\n Status s = e.getStatus();\n switch (s.getCode()) {\n case NOT_FOUND: // The task doesn't exist.\n break;\n case FAILED_PRECONDITION: // Task is active and assigned to a delivery vehicle.\n break;\n case PERMISSION_DENIED:\n break;\n }\n return;\n }\n\nHandle errors\n\nWhen deleting a task, you might encounter a\n`FAILED_PRECONDITION` error, in which case the task is active and assigned to a\ndelivery vehicle.\nTo proceed with the deletion, [close the task](/maps/documentation/mobility/fleet-engine/journeys/tasks/finalize-tasks#close-task).\n\nWhat's next\n\n- [Update tasks](/maps/documentation/mobility/fleet-engine/journeys/tasks/update-tasks)\n- [Finalize a task](/maps/documentation/mobility/fleet-engine/journeys/tasks/finalize-tasks)"]]