Удалить транспортное средство доставки

В этом документе описывается, как удалить транспортное средство доставки. Предполагается, что вы настроили Fleet Engine. Подробнее о том, как настроить Fleet Engine…

Как удалить транспортное средство

Ваша система может использовать Fleet Engine для удаления транспортного средства доставки в следующих ситуациях:

  • Выполнять очистку при тестировании Fleet Engine API.
  • Чтобы немедленно удалить транспортное средство доставки, которое больше не требуется.

Чтобы удалить транспортное средство, отправьте запрос с помощью gRPC или REST.

  • DeleteDeliveryVehicle() метод: gRPC или REST
  • Сообщение DeleteDeliveryVehicleRequest: только gRPC

Используйте учетные данные, подходящие для сервисного аккаунта вашего проекта, как описано в статье 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, чтобы удалить каждую из найденных задач.

Дальнейшие действия