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