REST Resource: projects.operations

সম্পদ: অপারেশন

এই রিসোর্সটি একটি দীর্ঘস্থায়ী অপারেশনকে নির্দেশ করে, যা একটি নেটওয়ার্ক এপিআই কলের ফলাফল।

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 হয়, তাহলে প্রতিক্রিয়াটি রিসোর্স হওয়া উচিত। অন্যান্য মেথডের ক্ষেত্রে, প্রতিক্রিয়ার টাইপ হবে XxxResponse , যেখানে Xxx হলো মূল মেথডের নাম। উদাহরণস্বরূপ, যদি মূল মেথডের নাম TakeSnapshot() হয়, তাহলে অনুমিত প্রতিক্রিয়ার টাইপ হবে TakeSnapshotResponse । একটি অবজেক্ট যাতে যেকোনো ধরনের ফিল্ড থাকে। "@type" নামে একটি অতিরিক্ত ফিল্ড থাকে, যা ধরনটি শনাক্তকারী একটি URI ধারণ করে। উদাহরণ: { "id": 1234, "@type": "types.example.com/standard/id" } ।
পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।

পদ্ধতি
cancel	দীর্ঘক্ষণ ধরে চলা কোনো অপারেশনের অ্যাসিঙ্ক্রোনাস বাতিলকরণ শুরু করে।
delete	দীর্ঘক্ষণ ধরে চলমান কোনো অপারেশন মুছে দেয়।
get	দীর্ঘদিন ধরে চলমান কোনো কার্যক্রমের সর্বশেষ অবস্থা জানায়।
list	অনুরোধে নির্দিষ্ট ফিল্টারের সাথে মেলে এমন অপারেশনগুলির তালিকা দেখায়।
wait	নির্দিষ্ট দীর্ঘ-সময়ব্যাপী অপারেশনটি সম্পন্ন হওয়া পর্যন্ত অথবা সর্বাধিক একটি নির্দিষ্ট টাইমআউট পর্যন্ত অপেক্ষা করে এবং সর্বশেষ অবস্থাটি ফেরত দেয়।