حذف المركبة

يوضّح هذا المستند كيفية حذف مركبة. ويفترض أنك أعددت Fleet Engine. يُرجى الاطّلاع على مقالة إعداد Fleet Engine.

الأساسيات المتعلّقة بحذف المركبات

قد يستخدم نظامك Fleet Engine لحذف مركبة في الحالات التالية:

  • لإجراء عمليات التنظيف أثناء اختبار واجهات برمجة تطبيقات Fleet Engine
  • لحذف "مركبة" لم تعُد مطلوبة على الفور

لحذف مركبة، أرسِل طلبًا باستخدام gRPC أو REST.

  • طريقة DeleteVehicle(): gRPC أو REST
  • DeleteVehicleRequest رسالة: gRPC فقط

استخدِم بيانات الاعتماد المناسبة لحساب الخدمة في مشروعك كما هو موضّح في Fleet Engine: أدوار حساب الخدمة.

مثال: حذف مركبة

جافا

يوضّح المثال التالي كيفية استخدام مكتبة Java 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}"

إذا نجحت عملية الحذف، تعرض واجهة برمجة التطبيقات ردًا فارغًا.

التعامل مع الأخطاء

عند حذف مركبة، قد يظهر لك الخطأ FAILED_PRECONDITION، وفي هذه الحالة، تكون هناك رحلات تشير إلى المركبة. لمتابعة عملية الحذف:

  1. اتصِل بـ SearchTrips للعثور على الرحلات التي تشير إلى "المركبة".
  2. اتصِل بـ DeleteTrip لحذف كل رحلة تم العثور عليها.

الخطوات التالية