حذف سفر، حذف سفر

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

اصول اولیه حذف سفر

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

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

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

  • DeleteTrip() : gRPC یا REST
  • پیام DeleteTripRequest : فقط gRPC

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

مثال: حذف سفر

مثال زیر نحوه حذف یک سفر در Fleet Engine را نشان می‌دهد.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "trip-8241890";

String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;

TripServiceBlockingStub tripService = TripServiceGrpc.newBlockingStub(channel);

// Delete trip request.
DeleteTripRequest deleteTripRequest = DeleteTripRequest.newBuilder()
    .setName(tripName)
    .build();

// Error handling.
try {
  tripService.deleteTrip(deleteTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:            // The trip doesn't exist.
      break;
    case FAILED_PRECONDITION:  // Trip is active and assigned to a vehicle.
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

مدیریت خطاها

هنگام حذف یک سفر، ممکن است با خطای FAILED_PRECONDITION مواجه شوید، که در این صورت سفر فعال بوده و به یک وسیله نقلیه اختصاص داده شده است.
برای ادامه حذف، UpdateTrip را فراخوانی کنید و trip_status را به COMPLETE / CANCELED به‌روزرسانی کنید.

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