لبدء الإلغاء غير المتزامن على عملية طويلة الأمد يبذل الخادم قصارى جهده لإلغاء العملية، ولكن النجاح غير مضمون. إذا كان الخادم لا يتيح هذه الطريقة، سيعرض google.rpc.Code.UNIMPLEMENTED
. يمكن للعملاء استخدام Operations.GetOperation
أو طرق أخرى للتحقّق من نجاح عملية الإلغاء أو اكتمال العملية على الرغم من الإلغاء. عند الإلغاء بنجاح، لا يتم حذف العملية، وإنما تصبح عملية ذات قيمة Operation.error
مع google.rpc.Status.code
من 1، بما يتوافق مع Code.CANCELLED
.
طلب HTTP
POST https://firestore.googleapis.com/v1/{name=projects/*/databases/*/operations/*}:cancel
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
name |
اسم مورد العملية المطلوب إلغاؤه. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة حول المصادقة.