Usuń pojazd

Z tego dokumentu dowiesz się, jak usunąć pojazd. Zakładamy, że masz skonfigurowany mechanizm floty. Zobacz Konfigurowanie Fleet Engine.

Podstawowe informacje o usunięciu pojazdu

Twój system może użyć narzędzia Fleet Engine do usunięcia pojazdu w tych sytuacjach:

  • Aby podczas testowania interfejsów API Fleet Engine wykonywać operacje czyszczenia.
  • Aby natychmiast usunąć pojazd, który nie jest już potrzebny.

Aby usunąć pojazd, wyślij żądanie za pomocą gRPC lub REST.

  • metoda DeleteVehicle(): gRPC lub REST
  • DeleteVehicleRequest komunikat: dotyczy tylko gRPC

Użyj odpowiednich danych logowania do konta usługi w projekcie, zgodnie z opisem w artykule Fleet Engine: role kont usług.

Przykład: usuń pojazd

Java

Z tego przykładu dowiesz się, jak użyć biblioteki gRPC w języku Java do usunięcia pojazdu.

  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

Poniższy przykład pokazuje, jak usunąć pojazd z Fleet Engine za pomocą interfejsu REST, wykonując wywołanie 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}"

Jeśli operacja usunięcia się powiedzie, interfejs API zwróci pustą odpowiedź.

Obsługuj błędy

Podczas usuwania pojazdu możesz napotkać błąd FAILED_PRECONDITION. W takim przypadku występują przejazdy, które odwołują się do tego pojazdu. Aby usunąć konto:

  1. Zadzwoń pod numer SearchTrips, aby znaleźć podróże, które odwołują się do pojazdu.
  2. Aby usunąć znalezione podróże, naciśnij DeleteTrip.

Co dalej?