REST Resource: projects.operations

منبع: عملیات

این منبع نشان دهنده یک عملیات طولانی مدت است که نتیجه یک فراخوانی API شبکه است.

نمایش JSON
{ "name": string, "metadata": { "@type": string, field1: ..., ... }, "done": boolean, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "error": { object (Status) }, "response": { "@type": string, field1: ..., ... } // End of mutually exclusive fields. }

فیلدها
name	string نام اختصاص داده شده توسط سرور، که فقط در همان سرویسی که در ابتدا آن را برمی‌گرداند، منحصر به فرد است. اگر از نگاشت پیش‌فرض HTTP استفاده می‌کنید، name باید نام منبعی باشد که با operations/{unique_id} خاتمه می‌یابد.
metadata	object فراداده‌های مختص سرویس مرتبط با عملیات. معمولاً شامل اطلاعات پیشرفت و فراداده‌های رایج مانند زمان ایجاد است. برخی از سرویس‌ها ممکن است چنین فراداده‌ای را ارائه ندهند. هر روشی که یک عملیات طولانی مدت را برمی‌گرداند، باید نوع فراداده را، در صورت وجود، مستند کند. یک شیء حاوی فیلدهایی از نوع دلخواه. یک فیلد اضافی "@type" حاوی یک URI است که نوع را مشخص می‌کند. مثال: { "id": 1234, "@type": "types.example.com/standard/id" } .
done	boolean اگر مقدار آن false باشد، به این معنی است که عملیات هنوز در حال انجام است. اگر true ، عملیات تکمیل شده و error یا response در دسترس است.
نتیجه عملیات، که می‌تواند یک error یا یک response معتبر باشد. اگر done == false باشد، نه error و نه response تنظیم نمی‌شوند. اگر done == true ، دقیقاً یکی از error یا response می‌تواند تنظیم شود. برخی از سرویس‌ها ممکن است نتیجه را ارائه ندهند. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در یک پاسخ تنظیم خواهد شد:
error	object ( Status ) نتیجه خطای عملیات در صورت عدم موفقیت یا لغو.
response	object پاسخ عادی و موفقیت‌آمیز عملیات. اگر متد اصلی هیچ داده‌ای مانند Delete در صورت موفقیت برنگرداند، پاسخ google.protobuf.Empty خواهد بود. اگر متد اصلی Get / Create / Update استاندارد باشد، پاسخ باید resource باشد. برای متدهای دیگر، پاسخ باید از نوع XxxResponse باشد، که در آن Xxx نام متد اصلی است. به عنوان مثال، اگر نام متد اصلی TakeSnapshot() باشد، نوع پاسخ استنباط شده TakeSnapshotResponse خواهد بود. یک شیء حاوی فیلدهایی از نوع دلخواه. یک فیلد اضافی "@type" حاوی یک URI است که نوع را مشخص می‌کند. مثال: { "id": 1234, "@type": "types.example.com/standard/id" } .
پایان میدان‌های ناسازگار.

روش‌ها
cancel	لغو ناهمزمان را در یک عملیات طولانی مدت آغاز می‌کند.
delete	یک عملیات طولانی مدت را حذف می‌کند.
get	آخرین وضعیت یک عملیات طولانی مدت را دریافت می‌کند.
list	عملیاتی را که با فیلتر مشخص شده در درخواست مطابقت دارند، فهرست می‌کند.
wait	منتظر می‌ماند تا عملیات طولانی‌مدت مشخص‌شده انجام شود یا حداکثر به یک زمان انقضای مشخص‌شده برسد و آخرین وضعیت را برمی‌گرداند.