דף זה תורגם על ידי Cloud Translation API.

מחיקת הרכב

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

מתקשרים למספר SearchTrips כדי למצוא נסיעות שבהן נעשה שימוש ברכב.
מתקשרים למספר DeleteTrip כדי למחוק כל אחת מהנסיעות שנמצאו.

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

יצירת נסיעה לפי דרישה