ลบยานพาหนะสำหรับจัดส่ง

เอกสารนี้อธิบายวิธีลบยานพาหนะสำหรับจัดส่ง โดยจะถือว่าคุณได้ตั้งค่า Fleet Engine แล้ว โปรดดูหัวข้อตั้งค่า Fleet Engine

ข้อมูลเบื้องต้นเกี่ยวกับการลบยานพาหนะสำหรับจัดส่ง

ระบบอาจใช้ Fleet Engine เพื่อลบยานพาหนะสำหรับจัดส่งในกรณีต่อไปนี้

• เพื่อดำเนินการล้างข้อมูลขณะทดสอบ Fleet Engine API
• เพื่อลบยานพาหนะสำหรับจัดส่งที่ไม่จำเป็นอีกต่อไปทันที

หากต้องการลบยานพาหนะสำหรับจัดส่ง ให้ส่งคำขอโดยใช้ gRPC หรือ REST

• เมธอด DeleteDeliveryVehicle() method: gRPC หรือ REST
• DeleteDeliveryVehicleRequest ข้อความ: gRPC เท่านั้น

ใช้ข้อมูลเข้าสู่ระบบที่เหมาะสมสำหรับบัญชีบริการของโปรเจ็กต์ตามที่ อธิบายไว้ใน Fleet Engine: บทบาทของบัญชีบริการ

หมายเหตุ: Fleet Engine จะลบยานพาหนะสำหรับจัดส่งโดยอัตโนมัติหลังจากที่ยานพาหนะดังกล่าวไม่มีการใช้งานเป็นระยะเวลาหนึ่ง โปรดดูหัวข้อการนำยานพาหนะกลับมาใช้ใหม่

ตัวอย่าง: ลบยานพาหนะสำหรับจัดส่ง

Java

ตัวอย่างต่อไปนี้แสดงวิธีใช้ไลบรารี gRPC ของ Java เพื่อลบ ยานพาหนะสำหรับจัดส่ง ดูรายชื่อภาษาที่รองรับทั้งหมดได้ที่ ไลบรารีของไคลเอ็นต์สำหรับบริการงานที่กำหนดเวลาไว้

  static final String PROJECT_ID = "my-rideshare-co-gcp-project";
  static final String VEHICLE_ID = "vehicle-8241890";

  String deliveryVehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;

  DeliveryServiceBlockingStub deliveryService = DeliveryServiceGrpc.newBlockingStub(channel);

  // Delete Vehicle request
  DeleteDeliveryVehicleRequest deleteDeliveryVehicleRequest =
      DeleteDeliveryVehicleRequest.newBuilder().setName(deliveryVehicleName).build();

  try {
    deliveryService.deleteDeliveryVehicle(deleteDeliveryVehicleRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case NOT_FOUND:            // The delivery vehicle doesn't exist.
         break;
       case FAILED_PRECONDITION:  // There are tasks(s) that reference delivery vehicle.
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

REST

ตัวอย่างต่อไปนี้แสดงวิธีลบยานพาหนะสำหรับจัดส่งจาก Fleet Engine โดยใช้ REST ด้วยการเรียก DeleteDeliveryVehicle

  # DELETE https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<vehicleId>
  # Set JWT, PROJECT_ID, and VEHICLE_ID in the local environment
  curl -X DELETE -H "Authorization: Bearer ${JWT}" \
    "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryvehicles/${VEHICLE_ID}"

หากการดำเนินการลบสำเร็จ API จะแสดงการตอบกลับที่ว่างเปล่า

จัดการข้อผิดพลาด

เมื่อลบยานพาหนะสำหรับจัดส่ง คุณอาจพบข้อผิดพลาด FAILED_PRECONDITION ซึ่งในกรณีนี้จะมีงานที่อ้างอิงยานพาหนะสำหรับจัดส่ง หากต้องการดำเนินการลบ ให้ทำดังนี้

1. เรียก ListTasks เพื่อค้นหางานที่อ้างอิงยานพาหนะสำหรับจัดส่ง
2. เรียก DeleteTask เพื่อลบงานที่พบแต่ละรายการ

คำเตือน: ตรวจสอบว่างานที่พบไม่จำเป็นอีกต่อไป เมื่อลบแล้วจะกู้คืนงานไม่ได้

ขั้นตอนถัดไป

• สร้างการเดินทางที่กำหนดเวลาไว้