מחיקת הרכב

במאמר הזה מוסבר איך למחוק רכב. ההנחה היא שהגדרתם את Fleet Engine. מידע נוסף מופיע במאמר בנושא הגדרת Fleet Engine.

מידע בסיסי על מחיקת רכבים

יכול להיות שהמערכת שלכם תשתמש ב-Fleet Engine כדי למחוק רכב במצבים הבאים:

  • כדי לבצע פעולות ניקוי בזמן בדיקת ממשקי Fleet Engine API.
  • כדי למחוק מיד רכב שכבר לא נדרש.

כדי למחוק רכב, שולחים בקשה באמצעות gRPC או REST.

  • שיטה: DeleteVehicle() gRPC או REST
  • הודעה DeleteVehicleRequest: gRPC בלבד

משתמשים בפרטי הכניסה המתאימים לחשבון השירות של הפרויקט, כפי שמתואר במאמר Fleet Engine: תפקידים בחשבון שירות.

דוגמה: מחיקת הרכב

Java

בדוגמה הבאה מוצג אופן השימוש בספריית 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;
  }

REST

בדוגמה הבאה מוצג איך למחוק רכב מ-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 כדי למחוק כל אחת מהנסיעות שנמצאו.

המאמרים הבאים