وسیله نقلیه را حذف کنید

این سند نحوه حذف یک وسیله نقلیه را شرح می‌دهد. فرض بر این است که شما Fleet Engine را تنظیم کرده‌اید. به بخش Setup Fleet Engine مراجعه کنید.

اصول اولیه حذف خودرو

سیستم شما ممکن است در شرایط زیر از Fleet Engine برای حذف یک وسیله نقلیه استفاده کند:

  • برای انجام عملیات پاکسازی هنگام آزمایش APIهای موتور ناوگان.
  • برای حذف فوری وسیله نقلیه‌ای که دیگر نیازی به آن نیست.

برای حذف یک وسیله نقلیه، درخواستی را با استفاده از gRPC یا REST ارسال کنید.

  • متد DeleteVehicle() : gRPC یا REST
  • پیام DeleteVehicleRequest : فقط gRPC

از اعتبارنامه‌های مناسب برای حساب سرویس پروژه خود، همانطور که در Fleet Engine: Service account roles توضیح داده شده است، استفاده کنید.

مثال: حذف وسیله نقلیه

جاوا

مثال زیر نحوه استفاده از کتابخانه جاوا gRPC برای حذف یک وسیله نقلیه را نشان می‌دهد.

  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;
  }

استراحت

مثال زیر نحوه حذف یک وسیله نقلیه از Fleet Engine با استفاده از REST و با فراخوانی 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}"

اگر عملیات حذف موفقیت‌آمیز باشد، API یک پاسخ خالی برمی‌گرداند.

مدیریت خطاها

هنگام حذف یک وسیله نقلیه، ممکن است با خطای FAILED_PRECONDITION مواجه شوید، که در این صورت سفر(هایی) وجود دارند که به وسیله نقلیه ارجاع می‌دهند. برای ادامه حذف:

  1. برای یافتن سفرهایی که به وسیله نقلیه اشاره دارند، با SearchTrips تماس بگیرید.
  2. برای حذف هر یک از سفرهای یافت شده، تابع DeleteTrip فراخوانی کنید.

قدم بعدی چیست؟