আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য
ভার্সন: 2.0.2
Cloud Storage বাকেটে থাকা ফাইলের জন্য তালিকা তৈরি, ডাউনলোড ও সাইন করা URL জেনারেট করা।
এই এক্সটেনশন কনফিগার ও ব্যবহার করার জন্য এই কন্টেন্ট রেফারেন্স প্রদান করে। API প্রক্সি থেকে এই এক্সটেনশন ব্যবহার করার আগে, আপনাকে অবশ্যই:
আপনার বাকেটে অবজেক্ট আপলোড করুন।
আপনার Google Cloud Storage এক্সটেনশনকে প্রতিনিধিত্ব করে এমন Google Cloud পরিষেবা অ্যাকাউন্টের জন্য বাকেট অ্যাক্সেস করার অনুমতি দিন। ব্যবহার করার জন্য ভূমিকা সম্পর্কে আরও জানতে, Cloud Storage ভূমিকা দেখুন। Cloud Storage-এ অনুমতি সম্পর্কে আরও জানতে, পরিচয় ও অ্যাক্সেস ম্যানেজমেন্ট (IAM) অনুমতি ব্যবহার করা দেখুন।
পরিষেবা অ্যাকাউন্টের জন্য কী তৈরি করতে Google Cloud Console ব্যবহার করুন।
কনফিগারেশন রেফারেন্স ব্যবহার করে এক্সটেনশন যোগ ও কনফিগার করার সময়, ফলাফল হিসেবে প্রাপ্ত কী JSON ফাইলের কন্টেন্ট ব্যবহার করুন।
Cloud Storage সম্পর্কে
ক্লাউড স্টোরেজ হল নিরাপদ, টেকসই ও স্কেলেবল ফাইল স্টোরেজের পরিষেবা। আপনি Cloud Storage ব্যবহার করা সবেমাত্র শুরু করে থাকলে, Cloud Storage ডকুমেন্টেশনে দেওয়া কুইকস্টার্ট থেকে শুরু করতে পারেন।
নমুনা
ExtensionCallout নীতি ব্যবহার করে Cloud Storage এক্সটেনশন অ্যাকশনের জন্য কীভাবে সহায়তা কনফিগার করতে হয় তা নিম্নলিখিত উদাহরণ থেকে বোঝা যায়।
ফাইলের তালিকা
নিচের উদাহরণে, এক্সটেনশনের listFiles অ্যাকশন ফাইলের একটি তালিকা রিট্রিভ করে, সেগুলি একটি অ্যারেতে রিটার্ন করে। listFiles অ্যাকশন কোনও ইনপুট প্যারামিটার নেয় না।
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="false" enabled="true" name="Get-Storage-File-List">
<DisplayName>Get Storage File List</DisplayName>
<Connector>cloud-storage-extension-example</Connector>
<Action>listFiles</Action>
<Input><![CDATA[{}]]></Input>
<Output parsed="false">storage.filelist.retrieved</Output>
</ConnectorCallout>
উত্তর ভ্যালু দেখতে এই ধরনের হয়:
["example-text.txt","example-image.png"]
নিচে উল্লেখ করা Assign Message নীতি, ExtensionCallout নীতি থেকে উত্তরের ভ্যালু নেয় এবং তা উত্তরের পেলোডে কপি করে।
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Assign-Storage-File-List">
<DisplayName>Assign Storage File List</DisplayName>
<AssignTo type="response" createNew="false"/>
<Set>
<Payload contentType="application/json">{storage.filelist.retrieved}</Payload>
</Set>
</AssignMessage>
ফাইল ডাউনলোড করা
নিম্নলিখিত ExtensionCallout নীতিতে Google Cloud Storage এক্সটেনশন ব্যবহার করে একটি টেক্সট ফাইল ডাউনলোড করা হয়, যার কন্টেন্ট হল Some example text.,
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="false" enabled="true" name="Download-File">
<DisplayName>Download File</DisplayName>
<Connector>cloud-storage-extension-example</Connector>
<Action>downloadFile</Action>
<Input><![CDATA[{"fileName": "example-text.txt"}]]></Input>
<Output>storage.file.retrieved</Output>
</ConnectorCallout>
উত্তরের ভ্যালু এমন দেখতে হয়:
{"content":"Some example text."}
নিম্নলিখিত Assign Message নীতি এক্সটেনশন দ্বারা রিটার্ন করা ভ্যালু পুনরুদ্ধার করে এবং এটিকে রেসপন্স পেলোডে কপি করে।
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Assign-Storage-File-List">
<DisplayName>Assign Storage File List</DisplayName>
<AssignTo type="response" createNew="false"/>
<Set>
<Payload contentType="application/json">{storage.file.retrieved}</Payload>
</Set>
</AssignMessage>
স্বাক্ষরিত URL তৈরি করা
নিচে উল্লেখ করা ExtensionCallout নীতি, ক্লাউড স্টোরেজ বাকেট থেকে নির্দিষ্ট ফাইল ডাউনলোড করার জন্য URL তৈরি করতে এই এক্সটেনশন ব্যবহার করে। এটি ফাইলের নাম এবং সেই তারিখ পাস করে যার পরে URL আর কাজ করবে না।
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="false" enabled="true" name="Get-Signed-URL">
<DisplayName>Get Signed URL</DisplayName>
<Connector>cloud-storage-extension-example</Connector>
<Action>generateSignedURL</Action>
<Input><![CDATA[{
"fileName" : "example-text.txt",
"expiresOn" : "2018-08-05"
}]]></Input>
<Output>storage.url.retrieved</Output>
</ConnectorCallout>
এক্সটেনশনের রিটার্ন ভ্যালু নিচে উল্লেখ করা উদাহরণের মতো দেখতে হবে।
{"url":"https://storage.googleapis.com/storage-extension-example/example-text.txt?GoogleAccessId=extension-test%40my-test-33333.iam.gserviceaccount.com&Expires=1533427200&Signature=Y1cE1DCHesWeIZILRhdIuDR%2FhzZXZ%2BPeY3J1PUkRiosFYj41itHBWh2%2BTQgH9kI6E8s2mWrVDFU43YR7s8Tm9W5VgWRwh0nXSactQ0xKbkKbGZmCcWxgIscOezc1zc%2Bp7lnXSx1qd4wIlIKVH4KCd9WLx4qB1dLxGNxMKB32tA3dio5IiMXaHEA%2FR2fYc0Pjh45t8L5rilk5pekv7jfd3sfsgdfgfdglkj%2F7E%2FlJ%2B60RnetqV2IDqrc0sVEgSLTpgTbDGU%2Ft3EcitRUFOSdOb5czt7CiIwKAYSmDEFMSNHHiNTWjvLzq4IU%2BCa4Z5aKyvww%3D%3D"}
নিম্নলিখিত Assign Message নীতি এক্সটেনশন দ্বারা রিটার্ন করা ভ্যালু পুনরুদ্ধার করে এবং এটি রেসপন্স বডিতে কপি করে।
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Assign-Storage-File-URL">
<DisplayName>Assign Storage File URL</DisplayName>
<AssignTo type="response" createNew="false"/>
<Set>
<Payload contentType="application/json">{storage.url.retrieved}</Payload>
</Set>
</AssignMessage>
ক্রিয়াসমূহ
downloadFile
নির্দিষ্ট ফাইল ডাউনলোড করে।
অনুরোধের প্যারামিটার
| প্যারামিটার | বিবরণ | ধরন | ডিফল্ট | প্রয়োজনীয় |
|---|---|---|---|---|
| fileName | ডাউনলোড করার জন্য ফাইল। | স্ট্রিং | কোনওটিই নয়। | হ্যাঁ। |
সিন্ট্যাক্স
<Input><![CDATA[{"fileName" : "the-file-to-download"}]]></Input>
উদাহরণ
<Input><![CDATA[{"fileName" : "example-text.txt"}]]></Input>
রেসপন্স
ডাউনলোড করা ফাইলের কন্টেন্ট সহ অবজেক্টের JSON। যেমন:
{"content":"Some example text."}
listFiles
ডাউনলোড করার জন্য উপলভ্য ফাইল তালিকাভুক্ত করে।
অনুরোধের প্যারামিটার
কোনওটিই নয়।
রেসপন্স
ফাইলের নামের একটি অ্যারে। যেমন:
["example-text.txt","example-image.png"]
generateSignedURL
বাকেটে নির্দিষ্ট ফাইলের জন্য একটি স্বাক্ষর করা URL তৈরি করে। এই URL ব্যবহার করে ফাইলটি ডাউনলোড করা যাবে।
অনুরোধের প্যারামিটার
| প্যারামিটার | বিবরণ | ধরন | ডিফল্ট | প্রয়োজনীয় |
|---|---|---|---|---|
| fileName | যে Cloud Storage অবজেক্টের জন্য সাইন করা URL তৈরি করতে হবে তার নাম। | স্ট্রিং | কোনওটিই নয়। | হ্যাঁ। |
| expiresOn | যে তারিখে সাইন করা URL-এর মেয়াদ শেষ হয়ে যাবে। | স্ট্রিং | কোনওটিই নয়। | না। |
সিন্ট্যাক্স
<Input><![CDATA[{
"fileName" : "file-for-which-to-generate-url",
"expiresOn" : "date-to-expire-url"
}]]></Input>
উদাহরণ
<Input><![CDATA[{
"fileName" : "example-text.txt",
"expiresOn" : "2018-08-05"
}]]></Input>
রেসপন্স
স্বাক্ষরিত URL সহ অবজেক্টের প্রতিনিধিত্বকারী JSON। যেমন:
{"url":"https://storage.googleapis.com/storage-extension-example/example-text.txt?GoogleAccessId=extension-test%40my-test-33333.iam.gserviceaccount.com&Expires=1533427200&Signature=Y1cE1DCHesWeIZILRhdIuDR%2FhzZXZ%2BPeY3J1PUkRiosFYj41itHBWh2%2BTQgH9kI6E8s2mWrVDFU43YR7s8Tm9W5VgWRwh0nXSactQ0xKbkKbGZmCcWxgIscOezc1zc%2Bp7lnXSx1qd4wIlIKVH4KCd9WLx4qB1dLxGNxMKB32tA3dio5IiMXaHEA%2FR2fYc0Pjh45t8L5rilk5pekv7jfd3sfsgdfgfdglkj%2F7E%2FlJ%2B60RnetqV2IDqrc0sVEgSLTpgTbDGU%2Ft3EcitRUFOSdOb5czt7CiIwKAYSmDEFMSNHHiNTWjvLzq4IU%2BCa4Z5aKyvww%3D%3D"}
কনফিগারেশন রেফারেন্স
API প্রক্সিতে ব্যবহারের জন্য এই এক্সটেনশন কনফিগার ও ডেপ্লয় করার সময় নিম্নলিখিত বিষয়গুলি ব্যবহার করুন। Apigee কনসোল ব্যবহার করে এক্সটেনশন কনফিগার করার ধাপগুলি জানতে, এক্সটেনশন যোগ করা ও কনফিগার করা দেখুন।
এক্সটেনশনের সাধারণ প্রপার্টি
নিম্নলিখিত বৈশিষ্ট্যগুলি প্রতিটি এক্সটেনশনের জন্য উপস্থিত রয়েছে।
| সম্পত্তি | বর্ণনা | ডিফল্ট | প্রয়োজন |
|---|---|---|---|
name | আপনি এক্সটেনশনের এই কনফিগারেশনের নাম দিন। | কোনোটিই নয় | হ্যাঁ |
packageName | Apigee Edge দ্বারা প্রদত্ত এক্সটেনশন প্যাকেজের নাম। | কোনোটিই নয় | হ্যাঁ |
version | যে এক্সটেনশন প্যাকেজ থেকে আপনি একটি এক্সটেনশন কনফিগার করছেন তার সংস্করণ নম্বর। | কোনোটিই নয় | হ্যাঁ |
configuration | আপনি যে এক্সটেনশনটি যোগ করছেন তার জন্য নির্দিষ্ট কনফিগারেশন মান। এই এক্সটেনশন প্যাকেজের বৈশিষ্ট্য দেখুন | কোনোটিই নয় | হ্যাঁ |
এই এক্সটেনশন প্যাকেজের প্রপার্টি
| প্রপার্টি | বিবরণ | ডিফল্ট | প্রয়োজনীয় |
|---|---|---|---|
| bucketName | এই এক্সটেনশন যে GCS বাকেটের সাথে ইন্টার্যাক্ট করবে। | কোনওটিই নয়। | হ্যাঁ। |