REST Resource: operations

संसाधन: ऑपरेशन

यह संसाधन लंबे समय तक चलने वाले ऑपरेशन का प्रतिनिधित्व करता है जो नेटवर्क एपीआई कॉल का परिणाम है।

JSON प्रतिनिधित्व
{
  "name": string,
  "metadata": {
    "@type": string,
    field1: ...,
    ...
  },
  "done": boolean,

  // Union field result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    "@type": string,
    field1: ...,
    ...
  }
  // End of list of possible types for union field result.
}
खेत
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 उपलब्ध है।

संघ क्षेत्र result . ऑपरेशन परिणाम, जो या तो एक error या वैध response हो सकता है। यदि done == false , तो न तो error और न ही response सेट की जाती है। यदि done == true , तो error या response में से कोई एक सेट किया जा सकता है। कुछ सेवाएँ परिणाम प्रदान नहीं कर सकती हैं। result निम्न में से केवल एक ही हो सकता है:
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" }

स्थिति

Status प्रकार एक तार्किक त्रुटि मॉडल को परिभाषित करता है जो REST API और RPC API सहित विभिन्न प्रोग्रामिंग वातावरणों के लिए उपयुक्त है। इसका उपयोग GRPC द्वारा किया जाता है। प्रत्येक Status संदेश में डेटा के तीन भाग होते हैं: त्रुटि कोड, त्रुटि संदेश और त्रुटि विवरण।

आप एपीआई डिज़ाइन गाइड में इस त्रुटि मॉडल और इसके साथ काम करने के तरीके के बारे में अधिक जानकारी प्राप्त कर सकते हैं।

JSON प्रतिनिधित्व
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
खेत
code

integer

स्थिति कोड, जो google.rpc.Code का एक एनम मान होना चाहिए।

message

string

एक डेवलपर-सामना करने वाला त्रुटि संदेश, जो अंग्रेजी में होना चाहिए। किसी भी उपयोगकर्ता-सामना वाले त्रुटि संदेश को स्थानीयकृत किया जाना चाहिए और google.rpc.Status.details फ़ील्ड में भेजा जाना चाहिए, या क्लाइंट द्वारा स्थानीयकृत किया जाना चाहिए।

details[]

object

संदेशों की एक सूची जिसमें त्रुटि विवरण होता है। एपीआई के उपयोग के लिए संदेश प्रकारों का एक सामान्य सेट है।

एक वस्तु जिसमें मनमाना प्रकार के फ़ील्ड हों। एक अतिरिक्त फ़ील्ड "@type" में प्रकार की पहचान करने वाला एक URI होता है। उदाहरण: { "id": 1234, "@type": "types.example.com/standard/id" }

तरीकों

get

लंबे समय से चल रहे ऑपरेशन की नवीनतम स्थिति प्राप्त करता है।