Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
In diesem Dokument wird beschrieben, wie Sie eine Aufgabe löschen. Dabei wird davon ausgegangen, dass Sie Fleet Engine eingerichtet haben. Weitere Informationen finden Sie unter Fleet Engine einrichten.
Grundlagen zum Löschen von Aufgaben
Ihr System kann Fleet Engine verwenden, um einen Task in den folgenden Situationen zu löschen:
Bereinigungsvorgänge beim Testen von Fleet Engine-APIs ausführen.
Eine nicht mehr benötigte Aufgabe sofort löschen.
Wenn Sie eine Aufgabe löschen möchten, senden Sie eine Anfrage über gRPC oder REST.
Verwenden Sie die entsprechenden Anmeldedaten für das Dienstkonto Ihres Projekts, wie unter Fleet Engine: Dienstkontorollen beschrieben.
Beispiel: Aufgabe löschen
Im folgenden Beispiel wird gezeigt, wie eine Aufgabe in Fleet Engine gelöscht wird.
staticfinalStringPROJECT_ID="my-delivery-co-gcp-project";staticfinalStringTASK_ID="task-8241890";StringtaskName="providers/"+PROJECT_ID+"/tasks/"+TASK_ID;DeliveryServiceBlockingStubdeliveryService=DeliveryServiceGrpc.newBlockingStub(channel);// Delete task request.DeleteTaskRequestdeleteTaskRequest=DeleteTaskRequest.newBuilder().setName(taskName).build();// Error handling.try{deliveryService.deleteTask(deleteTaskRequest);}catch(StatusRuntimeExceptione){Statuss=e.getStatus();switch(s.getCode()){caseNOT_FOUND:// The task doesn't exist.break;caseFAILED_PRECONDITION:// Task is active and assigned to a delivery vehicle.break;casePERMISSION_DENIED:break;}return;}
Fehler verarbeiten
Wenn Sie eine Aufgabe löschen, kann es zu einem FAILED_PRECONDITION-Fehler kommen. In diesem Fall ist die Aufgabe aktiv und einem Lieferfahrzeug zugewiesen.
Wenn Sie mit dem Löschen fortfahren möchten, schließen Sie die Aufgabe.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-10 (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)"]]