Xoá xe

Tài liệu này mô tả cách xoá một chiếc xe. Tài liệu này giả định rằng 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

Hệ thống của bạn có thể sử dụng Fleet Engine để xoá một chiếc xe trong những 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 chiếc Xe không còn cần thiết nữa.

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

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

Sử dụng thông tin đăng nhập thích hợp cho tài khoản dịch vụ của dự án như mô tả trong Fleet Engine: Vai trò của tài1 khoản dịch vụ.

Ví dụ: xoá xe

Java

Ví dụ sau cho biết cách sử dụng thư viện gRPC Java để xoá một chiếc xe. Để xem danh sách đầy đủ các ngôn ngữ được hỗ trợ, hãy xem Thư viện ứng dụng cho các dịch vụ chuyến đi theo yêu cầu.

  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 cho biết cách xoá một chiếc xe khỏi Fleet Engine 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 chiếc xe, bạn có thể gặp lỗi FAILED_PRECONDITION. Trong trường hợp đó, có(các) chuyến đi tham chiếu đến chiếc xe. Cách tiếp tục xoá:

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

Bước tiếp theo

Tạo một chuyến đi theo yêu cầu