Tài liệu này mô tả cách xoá một xe giao hàng. Giả sử bạn đã thiết lập Fleet Engine. Xem bài viết Thiết lập Fleet Engine.
Thông tin cơ bản về việc xoá xe giao hàng
Hệ thống của bạn có thể sử dụng Fleet Engine để xoá xe giao hàng trong các trường hợp sau:
- Để thực hiện các thao tác dọn dẹp trong khi kiểm thử API Fleet Engine.
- Để xoá ngay một Xe giao hàng không còn cần thiết.
Để xoá một xe giao hàng, hãy gửi yêu cầu bằng gRPC hoặc REST.
- Phương thức
DeleteDeliveryVehicle()
: gRPC hoặc REST - Thông báo
DeleteDeliveryVehicleRequest
: Chỉ gRPC
Sử dụng thông tin đăng nhập phù hợp cho tài khoản dịch vụ của dự án như mô tả trong phần Fleet Engine: Vai trò của tài khoản dịch vụ.
Ví dụ: xoá xe giao hàng
Java
Ví dụ sau đây cho biết cách sử dụng Thư viện gRPC Java để xoá một xe giao hàng.
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
Ví dụ sau đây cho biết cách xoá một xe giao hàng khỏi Fleet Engine bằng cách sử dụng REST bằng cách gọi 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}"
Nếu thao tác xoá thành công, API sẽ trả về một phản hồi trống.
Xử lý lỗi
Khi xoá một xe giao hàng, bạn có thể gặp phải lỗi FAILED_PRECONDITION
. Trong trường hợp này, có(các) nhiệm vụ tham chiếu đến xe giao hàng đó.
Cách xoá:
- Gọi
ListTasks
để tìm(các) việc cần làm có liên quan đến Xe giao hàng. - Gọi
DeleteTask
để xoá từng việc cần làm tìm được.