Delete task

This document describes how to delete a task. It assumes you have set up Fleet Engine. See Set up Fleet Engine .

Task deletion basics

Your system may use Fleet Engine to delete a task in the following situations:

To perform cleanup operations while testing Fleet Engine APIs.
To immediately delete a Task that is no longer required.

To delete a task, send a request using either gRPC or REST.

DeleteTask() method: gRPC or REST
DeleteTaskRequest message: gRPC only

Use the appropriate credentials for the service account of your project as described in Fleet Engine: Service account roles .

Example: delete task

The following example demonstrates how to delete a task in 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 
 ; 
 }

Handle errors

When deleting a task, you might encounter a FAILED_PRECONDITION error, in which case the task is active and assigned to a delivery vehicle. To proceed with the deletion, close the task .

Delete task Stay organized with collections Save and categorize content based on your preferences.

Task deletion basics

Example: delete task

Handle errors

What's next

Delete task