Amazon S3 एक्सटेंशन

Apigee Edge दस्तावेज़ देखा जा रहा है.
Apigee X दस्तावेज़ पर जाएं.
जानकारी

वर्शन: 1.1.1

Amazon S3 बकेट में फ़ाइलें मैनेज करना. इस एक्सटेंशन की मदद से, फ़ाइलों को लिस्ट किया जा सकता है, डाउनलोड किया जा सकता है, और उन्हें मिटाया जा सकता है. फ़ाइल डाउनलोड करने के लिए, साइन किया हुआ यूआरएल भी जनरेट किया जा सकता है.

इस एक्सटेंशन का कॉन्फ़िगर किया गया हर इंस्टेंस, एक खास बकेट के साथ काम करता है. एक से ज़्यादा बकेट के लिए, हर बकेट के लिए इस एक्सटेंशन के कॉन्फ़िगर किए गए इंस्टेंस का इस्तेमाल करें.

ज़रूरी शर्तें

एक्सटेंशन कॉल आउट नीति का इस्तेमाल करके, एपीआई प्रॉक्सी से एक्सटेंशन का इस्तेमाल करने से पहले:

Amazon S3 के बारे में जानकारी

Amazon Simple Storage Service (Amazon S3) एक ऑब्जेक्ट स्टोरेज सेवा है.

कार्रवाइयाँ

deleteFile

किसी S3 बकेट से बताई गई फ़ाइल मिटाता है.

सिंटैक्स

<Action>deleteFile</Action>
<Input><![CDATA[
{
  "fileName" : "name-of-file-to-delete"
}
]]>
</Input>

उदाहरण

<Action>deleteFile</Action>
<Input><![CDATA[
{
  "fileName" : "names.tmp"
}
]]>
</Input>

अनुरोध के पैरामीटर

पैरामीटर ब्यौरा Type डिफ़ॉल्ट ज़रूरी है
fileName मिटाई जाने वाली फ़ाइल का नाम. String कोई नहीं. हां.

जवाब

कोई नहीं.

रिस्पॉन्स प्रॉपर्टी

कोई नहीं.

downloadFile

किसी S3 बकेट से बताई गई फ़ाइल डाउनलोड करता है.

सिंटैक्स

<Action>downloadFile</Action>
<Input><![CDATA[
{
  "fileName" : "filename"
}
]]>
</Input>
<Output>flow-variable</Output>

उदाहरण

<Action>downloadFile</Action>
<Input><![CDATA[
{
  "fileName" : "product-sheet.pdf"
}
]]>
</Input>
<Output>downloaded.file</Output>

अनुरोध के पैरामीटर

पैरामीटर ब्यौरा Type डिफ़ॉल्ट ज़रूरी है
fileName डाउनलोड की जाने वाली फ़ाइल का नाम. String कोई नहीं. हां.

जवाब

content प्रॉपर्टी के साथ JSON, जिसमें फ़ाइल का कॉन्टेंट शामिल है.

{
  "content":"Hello World!"
}

रिस्पॉन्स प्रॉपर्टी

प्रॉपर्टी ब्यौरा Type डिफ़ॉल्ट
वीडियो इस स्ट्रिंग में अनुरोध की गई फ़ाइल का कॉन्टेंट होता है. स्ट्रिंग. कोई नहीं.

generateSignedURL

किसी S3 बकेट से बताई गई फ़ाइल डाउनलोड करने के लिए, एक साइन किया हुआ यूआरएल जनरेट करता है.

सिंटैक्स

<Action>generateSignedURL</Action>
<Input><![CDATA[
{
  "fileName": "filename",
  "expiresIn": duration-in-seconds
}
]]>
</Input>
<Output>flow-variable</Output>

उदाहरण

<Action>generateSignedURL</Action>
<Input><![CDATA[
{
  "fileName": "product-info.pdf",
  "expiresIn": 3600
}
]]>
</Input>
<Output>download.url</Output>

अनुरोध के पैरामीटर

पैरामीटर ब्यौरा Type डिफ़ॉल्ट ज़रूरी है
fileName डाउनलोड की जाने वाली फ़ाइल का नाम. String कोई नहीं. हां.
expiresIn यूआरएल के खत्म होने तक, समय (सेकंड में). Integer 86400 नहीं.

जवाब

url स्ट्रिंग प्रॉपर्टी वाला JSON, जिसमें जनरेट किया गया यूआरएल शामिल है.

{
  "url":"https://fake.s3.amazonaws.com/hello_world.txt?AWSAccessKeyId=123&Expires=1542753572&Signature=ABC"
}

रिस्पॉन्स प्रॉपर्टी

प्रॉपर्टी ब्यौरा Type डिफ़ॉल्ट
यूआरएल अनुरोध की गई फ़ाइल का यूआरएल. String कोई नहीं.

listFiles

AWS Lambda फ़ंक्शन के चलने को शुरू करता है.

सिंटैक्स

<Action>listFiles</Action>
<Input><![CDATA[{}]]></Input>
<Output>flow-variable</Output>

अगर आपको वैरिएबल में रॉ JSON शामिल करना है, तो आपको <Output> एलिमेंट पर parsed="false" तय करना होगा. नहीं तो, वैरिएबल का इस्तेमाल नहीं किया जा सकता.

उदाहरण

<Action>listFiles</Action>
<Input><![CDATA[{}]]></Input>
<Output parsed="false">listFilesOutput</Output>

अनुरोध के पैरामीटर

कोई नहीं.

जवाब

S3 फ़ाइल नामों का कलेक्शन.

["hello_world.txt"]

रिस्पॉन्स प्रॉपर्टी

कोई नहीं.

कॉन्फ़िगरेशन का रेफ़रंस

इस एक्सटेंशन को एपीआई प्रॉक्सी में इस्तेमाल करने के लिए, कॉन्फ़िगर और डिप्लॉय करते समय, इनका इस्तेमाल करें. Apigee कंसोल का इस्तेमाल करके, एक्सटेंशन को कॉन्फ़िगर करने का तरीका जानने के लिए, एक्सटेंशन जोड़ना और उसे कॉन्फ़िगर करना देखें.

सामान्य एक्सटेंशन प्रॉपर्टी

हर प्रॉपर्टी के लिए नीचे दी गई प्रॉपर्टी मौजूद हैं.

प्रॉपर्टी जानकारी डिफ़ॉल्ट ज़रूरी है
name वह नाम, जिसे आप एक्सटेंशन का यह कॉन्फ़िगरेशन दे रहे हैं. कभी नहीं हां
packageName एक्सटेंशन पैकेज का नाम, जो Apigee Edge से दिया गया है. कभी नहीं हां
version उस एक्सटेंशन पैकेज का वर्शन नंबर जिससे आपको एक्सटेंशन कॉन्फ़िगर करना है. कभी नहीं हां
configuration आप जिस एक्सटेंशन को जोड़ रहे हैं उसके लिए खास तौर पर कॉन्फ़िगरेशन वैल्यू. इस एक्सटेंशन पैकेज के लिए प्रॉपर्टी देखें कभी नहीं हां

इस एक्सटेंशन पैकेज की प्रॉपर्टी

इस एक्सटेंशन के लिए खास तौर पर, यहां दी गई कॉन्फ़िगरेशन प्रॉपर्टी की वैल्यू तय करें.

प्रॉपर्टी ब्यौरा डिफ़ॉल्ट ज़रूरी है
कॉन्फ़िगरेशन इस्तेमाल करने के लिए, Amazon S3 बकेट का नाम डालें, जैसे कि sample-bucket. कोई नहीं. हां.
कॉन्फ़िगरेशन इस्तेमाल करने के लिए, AWS क्षेत्र का नाम डालें, जैसे कि us-east-2. कोई नहीं. हां.
क्रेडेंशियल Apigee Edge के कंसोल में डाले जाने पर, यह एक JSON फ़ाइल होती है. इसमें आपका Amazon ऐक्सेस कुंजी आईडी और ऐक्सेस कुंजी इस तरह से होती है:

{
"accessKeyId" : access-key-ID,
"secretAccessKey" : secret-access-key
}

Management API से भेजी जाने पर, यह base64 कोड में बदली गई वैल्यू होती है, जो उस JSON फ़ाइल से जनरेट होती है.
कोई नहीं. हां.