Package google.longrunning

इंडेक्स

कार्रवाइयां

यह कुकी, एपीआई सेवा के साथ ज़्यादा समय तक चलने वाली कार्रवाइयों को मैनेज करती है.

जब किसी एपीआई तरीके को पूरा होने में आम तौर पर ज़्यादा समय लगता है, तो उसे क्लाइंट को Operation वापस करने के लिए डिज़ाइन किया जा सकता है. साथ ही, क्लाइंट इस इंटरफ़ेस का इस्तेमाल करके, ऑपरेशन रिसॉर्स को पोल करके एसिंक्रोनस तरीके से असली जवाब पा सकता है. इसके अलावा, वह जवाब पाने के लिए ऑपरेशन रिसॉर्स को किसी दूसरे एपीआई (जैसे कि Pub/Sub API) को पास कर सकता है. लंबे समय तक चलने वाली कार्रवाइयों को वापस लाने वाली किसी भी एपीआई सेवा को Operations इंटरफ़ेस लागू करना चाहिए, ताकि डेवलपर को लगातार बेहतर क्लाइंट अनुभव मिल सके.

CancelOperation

rpc CancelOperation(CancelOperationRequest) returns (Empty)

(फ़िलहाल, यह सुविधा उपलब्ध नहीं है) लंबे समय तक चलने वाली प्रोसेस को एसिंक्रोनस तरीके से रद्द करने की सुविधा शुरू करता है.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform
DeleteOperation

rpc DeleteOperation(DeleteOperationRequest) returns (Empty)

(फ़िलहाल, यह सुविधा उपलब्ध नहीं है) इस तरीके से, ज़्यादा समय तक चलने वाली कार्रवाई को मिटाया जाता है.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform
GetOperation

rpc GetOperation(GetOperationRequest) returns (Operation)

इस तरीके से, ज़्यादा समय तक चलने वाली कार्रवाई की मौजूदा स्थिति मिलती है. क्लाइंट इस तरीके का इस्तेमाल करके, एपीआई सेवा के सुझाए गए इंटरवल पर कार्रवाई के नतीजे को पोल कर सकते हैं.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform
IAM अनुमतियां

name रिसॉर्स पर, IAM से जुड़ी यह अनुमति ज़रूरी है:

  • routeoptimization.operations.get

ज़्यादा जानकारी के लिए, IAM का दस्तावेज़ देखें.
ListOperations

rpc ListOperations(ListOperationsRequest) returns (ListOperationsResponse)

(फ़िलहाल, यह सुविधा उपलब्ध नहीं है) अनुरोध में बताए गए फ़िल्टर से मेल खाने वाली सूचियों की कार्रवाइयां.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform
WaitOperation

rpc WaitOperation(WaitOperationRequest) returns (Operation)

(फ़िलहाल, यह सुविधा उपलब्ध नहीं है) यह तरीका तब तक इंतज़ार करता है, जब तक ज़्यादा समय तक चलने वाली कार्रवाई पूरी नहीं हो जाती या तय किए गए ज़्यादा से ज़्यादा समय तक नहीं पहुंच जाती. इसके बाद, यह मौजूदा स्थिति दिखाता है.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform

CancelOperationRequest

Operations.CancelOperation के लिए अनुरोध का मैसेज.

फ़ील्ड
name

string

कार्रवाई के उस रिसॉर्स का नाम जिसे रद्द करना है.

DeleteOperationRequest

Operations.DeleteOperation के लिए अनुरोध का मैसेज.

फ़ील्ड
name

string

मिटाए जाने वाले ऑपरेशन रिसॉर्स का नाम.

GetOperationRequest

Operations.GetOperation के लिए अनुरोध का मैसेज.

फ़ील्ड
name

string

कार्रवाई के रिसॉर्स का नाम.

ListOperationsRequest

Operations.ListOperations के लिए अनुरोध का मैसेज.

फ़ील्ड
name

string

कार्रवाई के पैरंट रिसॉर्स का नाम.
filter

string

यह सूची को फ़िल्टर करने वाला स्टैंडर्ड फ़िल्टर है.
page_size

int32

स्टैंडर्ड सूची वाले पेज का साइज़.
page_token

string

यह स्टैंडर्ड सूची वाले पेज का टोकन है.
return_partial_success

bool

true पर सेट होने पर, पहुंच वाली जगहों की जानकारी सामान्य तौर पर दिखाई जाती है. वहीं, जिन जगहों पर नहीं पहुंचा जा सकता उनकी जानकारी ListOperationsResponse.unreachable फ़ील्ड में दिखाई जाती है.

यह सुविधा सिर्फ़ तब true होती है, जब अलग-अलग कलेक्शन पढ़े जा रहे हों. उदाहरण के लिए, जब parent को "projects/example/locations/-" पर सेट किया जाता है.

यह फ़ील्ड डिफ़ॉल्ट रूप से काम नहीं करता. अगर इसे सेट किया जाता है, तो UNIMPLEMENTED गड़बड़ी होगी. हालांकि, अगर सेवा या प्रॉडक्ट से जुड़े दस्तावेज़ में इसके बारे में साफ़ तौर पर बताया गया है, तो ऐसा नहीं होगा.

ListOperationsResponse

Operations.ListOperations के लिए जवाब का मैसेज.

फ़ील्ड
operations[]

Operation

अनुरोध में बताए गए फ़िल्टर से मेल खाने वाली कार्रवाइयों की सूची.
next_page_token

string

यह सूची के अगले पेज का स्टैंडर्ड टोकन है.
unreachable[]

string

बिना क्रम वाली सूची. ऐसे संसाधन जिन तक नहीं पहुंचा जा सकता. यह तब भरता है, जब अनुरोध ListOperationsRequest.return_partial_success सेट करता है और सभी कलेक्शन में पढ़ता है. उदाहरण के लिए, जब सभी उपलब्ध जगहों के सभी संसाधनों को लिस्ट करने की कोशिश की जा रही हो.

कार्रवाई

यह संसाधन, ज़्यादा समय तक चलने वाली कार्रवाई को दिखाता है. यह कार्रवाई, नेटवर्क एपीआई कॉल का नतीजा है.

फ़ील्ड
name

string

सर्वर की ओर से असाइन किया गया नाम. यह नाम सिर्फ़ उसी सेवा के लिए यूनीक होता है जो इसे पहली बार दिखाती है. अगर डिफ़ॉल्ट एचटीटीपी मैपिंग का इस्तेमाल किया जाता है, तो name एक संसाधन का नाम होना चाहिए. इसका आखिरी हिस्सा operations/{unique_id} होना चाहिए.
metadata

Any

कार्रवाई से जुड़ा, सेवा के हिसाब से मेटाडेटा. आम तौर पर, इसमें प्रोग्रेस की जानकारी और सामान्य मेटाडेटा होता है. जैसे, बनाने का समय. ऐसा हो सकता है कि कुछ सेवाएं इस तरह का मेटाडेटा उपलब्ध न कराएं. लंबे समय तक चलने वाली कार्रवाई को वापस लाने वाले किसी भी तरीके को मेटाडेटा टाइप के बारे में जानकारी देनी चाहिए.
done

bool

अगर वैल्यू false है, तो इसका मतलब है कि कार्रवाई अब भी चल रही है. अगर वैल्यू true है, तो कार्रवाई पूरी हो गई है और error या response उपलब्ध है.
यूनियन फ़ील्ड result. कार्रवाई का नतीजा, जो error या मान्य response हो सकता है. अगर वैल्यू done == false है, तो न तो error और न ही response सेट है. अगर वैल्यू done == true है, तो error या response में से सिर्फ़ एक को सेट किया जा सकता है. ऐसा हो सकता है कि कुछ सेवाएं, नतीजे न दिखाएं. result इनमें से सिर्फ़ एक हो सकता है:
error

Status

अगर कार्रवाई पूरी नहीं होती है या रद्द हो जाती है, तो गड़बड़ी का नतीजा.
response

Any

कार्रवाई का सामान्य और सही रिस्पॉन्स. अगर मूल तरीके से डेटा नहीं मिलता है, जैसे कि Delete, तो जवाब google.protobuf.Empty होता है. अगर ओरिजनल तरीका स्टैंडर्ड Get/Create/Update है, तो जवाब संसाधन होना चाहिए. अन्य तरीकों के लिए, जवाब में टाइप XxxResponse होना चाहिए. यहां Xxx, मूल तरीके का नाम है. उदाहरण के लिए, अगर मूल तरीके का नाम TakeSnapshot() है, तो अनुमानित जवाब का टाइप TakeSnapshotResponse है.

WaitOperationRequest

Operations.WaitOperation के लिए अनुरोध का मैसेज.

फ़ील्ड
name

string

कार्रवाई के उस रिसॉर्स का नाम जिस पर इंतज़ार करना है.
timeout

Duration

टाइम आउट होने से पहले इंतज़ार करने की ज़्यादा से ज़्यादा अवधि. अगर इसे खाली छोड़ दिया जाता है, तो इंतज़ार का समय ज़्यादा से ज़्यादा उतना होगा जितना एचटीटीपी/आरपीसी प्रोटोकॉल के तहत अनुमति है. अगर आरपीसी कॉन्टेक्स्ट की समयसीमा भी तय की गई है, तो कम समयसीमा का इस्तेमाल किया जाएगा.