Xoá xe

Tài liệu này mô tả cách xoá xe. Giả sử bạn đã thiết lập Công cụ của đội xe. Xem bài viết Thiết lập Công cụ quản lý đội xe.

Kiến thức cơ bản về việc xoá xe

Hệ thống của bạn có thể sử dụng Công cụ quản lý đội xe để xoá một xe 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 Động cơ của đội xe.
  • Để xoá ngay một Xe không còn cần thiết.

Để xoá một xe, hãy gửi yêu cầu bằng gRPC hoặc REST.

  • Phương thức DeleteVehicle(): gRPC hoặc REST
  • Thông báo DeleteVehicleRequest: Chỉ gRPC

Sử dụng thông tin xác thực thích hợp cho tài khoản dịch vụ của dự án như mô tả trong phần Công cụ của đội xe: Vai trò của tài khoản dịch vụ.

Ví dụ: xoá xe

Java

Ví dụ sau đây cho biết cách sử dụng thư viện gRPC Java để xoá một xe.

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

  String vehicleName = "providers/" + PROJECT_ID + "/vehicles/" + VEHICLE_ID;

  VehicleServiceBlockingStub vehicleService = VehicleService.newBlockingStub(channel);

  // Delete Vehicle request
  DeleteVehicleRequest deleteVehicleRequest = DeleteVehicleRequest.newBuilder()
      .setName(vehicleName)
      .build();

  try {
    vehicleService.deleteVehicle(deleteVehicleRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case NOT_FOUND:            // The vehicle doesn't exist.
         break;
       case FAILED_PRECONDITION:  // There are trip(s) that reference vehicle.
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

REST

Ví dụ sau đây cho thấy cách xoá một xe khỏi Công cụ quản lý đội xe bằng REST bằng cách gọi DeleteVehicle.

  # DELETE https://fleetengine.googleapis.com/v1/providers/<project_id>/vehicles/<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}/vehicles/${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, bạn có thể gặp lỗi FAILED_PRECONDITION. Trong trường hợp này, có(các) chuyến đi tham chiếu đến xe đó. Cách tiếp tục xoá:

  1. Gọi SearchTrips để tìm(các) chuyến đi tham chiếu đến Xe.
  2. Gọi DeleteTrip để xoá từng chuyến đi đã tìm thấy.

Bước tiếp theo