আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।
সংস্করণ: ১.৪.১
ক্লাউড স্টোরেজ বাকেটে থাকা ফাইলগুলির তালিকা তৈরি করুন, ডাউনলোড করুন এবং স্বাক্ষরিত URL তৈরি করুন।
এই বিষয়বস্তুতে এই এক্সটেনশনটি কনফিগার এবং ব্যবহার করার জন্য নির্দেশিকা দেওয়া হয়েছে। একটি এপিআই প্রক্সি থেকে এই এক্সটেনশনটি ব্যবহার করার আগে, আপনাকে অবশ্যই:
আপনার বাকেটে অবজেক্টগুলো আপলোড করুন ।
আপনার Google Cloud Storage এক্সটেনশনের প্রতিনিধিত্বকারী GCP পরিষেবা অ্যাকাউন্টটিকে বাকেট অ্যাক্সেস করার অনুমতি দিন । কোন রোল ব্যবহার করতে হবে সে সম্পর্কে আরও জানতে, ক্লাউড স্টোরেজ রোলস দেখুন। ক্লাউড স্টোরেজে অনুমতি সম্পর্কে আরও জানতে, আইডেন্টিটি অ্যান্ড অ্যাক্সেস ম্যানেজমেন্ট (IAM) পারমিশন ব্যবহার দেখুন।
সার্ভিস অ্যাকাউন্টের জন্য একটি কী তৈরি করতে GCP কনসোল ব্যবহার করুন ।
কনফিগারেশন রেফারেন্স ব্যবহার করে এক্সটেনশনটি যোগ ও কনফিগার করার সময়, প্রাপ্ত কী JSON ফাইলের বিষয়বস্তু ব্যবহার করুন।
ক্লাউড স্টোরেজ সম্পর্কে
ক্লাউড স্টোরেজ হলো নিরাপদ, টেকসই এবং সম্প্রসারণযোগ্য ফাইল সংরক্ষণের একটি পরিষেবা। আপনি যদি ক্লাউড স্টোরেজ ব্যবহার সবে শুরু করে থাকেন, তবে ক্লাউড স্টোরেজ ডকুমেন্টেশনে থাকা কুইকস্টার্টটি শুরু করার জন্য একটি ভালো জায়গা।
নমুনা
নিম্নলিখিত উদাহরণগুলিতে ExtensionCallout পলিসি ব্যবহার করে ক্লাউড স্টোরেজ এক্সটেনশন অ্যাকশনের জন্য সাপোর্ট কীভাবে কনফিগার করতে হয় তা দেখানো হয়েছে।
ফাইলগুলির তালিকা
নিম্নলিখিত উদাহরণে, এক্সটেনশনটির ' 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"]
নিম্নলিখিত অ্যাসাইন মেসেজ পলিসিটি উপরের এক্সটেনশনকলআউট পলিসি থেকে রেসপন্স ভ্যালুটি গ্রহণ করে এবং সেটিকে রেসপন্স পেলোডে কপি করে।
<?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 পলিসিটি গুগল ক্লাউড স্টোরেজ এক্সটেনশন ব্যবহার করে একটি সাধারণ টেক্সট ফাইল ডাউনলোড করে, যার বিষয়বস্তু হলো কেবল 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."}
নিম্নলিখিত অ্যাসাইন মেসেজ পলিসিটি এক্সটেনশন দ্বারা ফেরত আসা মানটি গ্রহণ করে এবং সেটিকে রেসপন্স পেলোডে কপি করে।
<?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 তৈরি করুন
নিম্নলিখিত এক্সটেনশনকলআউট পলিসিটি ক্লাউড স্টোরেজ বাকেট থেকে নির্দিষ্ট ফাইলটি ডাউনলোড করার জন্য একটি ইউআরএল তৈরি করতে এই এক্সটেনশনটি ব্যবহার করে। এটি ফাইলের নামের সাথে সেই তারিখটিও প্রেরণ করে, যার পরে ইউআরএলটির মেয়াদ শেষ হয়ে যাবে এবং এটি আর কাজ করবে না।
<?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"}
নিম্নলিখিত অ্যাসাইন মেসেজ পলিসিটি এক্সটেনশন দ্বারা ফেরত আসা মানটি গ্রহণ করে এবং সেটিকে রেসপন্স বডিতে কপি করে।
<?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>
কর্ম
ডাউনলোডফাইল
নির্দিষ্ট ফাইলটি ডাউনলোড করে।
অনুরোধের পরামিতি
| প্যারামিটার | বর্ণনা | প্রকার | ডিফল্ট | প্রয়োজনীয় |
|---|---|---|---|---|
| ফাইলের নাম | ডাউনলোড করার জন্য ফাইলটি। | স্ট্রিং | কিছুই না। | হ্যাঁ। |
সিনট্যাক্স
<Input><![CDATA[{"fileName" : "the-file-to-download"}]]></Input>
উদাহরণ
<Input><![CDATA[{"fileName" : "example-text.txt"}]]></Input>
প্রতিক্রিয়া
ডাউনলোড করা ফাইলের বিষয়বস্তু সম্বলিত একটি অবজেক্টের JSON। উদাহরণস্বরূপ:
{"content":"Some example text."}
ফাইল তালিকা
ডাউনলোডের জন্য উপলব্ধ ফাইলগুলির তালিকা।
অনুরোধের পরামিতি
কিছুই না।
প্রতিক্রিয়া
ফাইল নামগুলোর একটি অ্যারে। উদাহরণস্বরূপ:
["example-text.txt","example-image.png"]
স্বাক্ষরিত ইউআরএল তৈরি করুন
বাকেটে নির্দিষ্ট ফাইলটির জন্য একটি স্বাক্ষরিত ইউআরএল তৈরি করে। এই ইউআরএলটি ফাইলটি ডাউনলোড করতে ব্যবহার করা যাবে।
অনুরোধের পরামিতি
| প্যারামিটার | বর্ণনা | প্রকার | ডিফল্ট | প্রয়োজনীয় |
|---|---|---|---|---|
| ফাইলের নাম | যে ক্লাউড স্টোরেজ অবজেক্টটির জন্য একটি স্বাক্ষরিত 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"}
কনফিগারেশন রেফারেন্স
এপিআই প্রক্সিতে ব্যবহারের জন্য এই এক্সটেনশনটি কনফিগার এবং ডেপ্লয় করার সময় নিম্নলিখিত বিষয়গুলো ব্যবহার করুন। Apigee কনসোল ব্যবহার করে একটি এক্সটেনশন কনফিগার করার ধাপগুলোর জন্য, “একটি এক্সটেনশন যোগ করা এবং কনফিগার করা” দেখুন।
সাধারণ সম্প্রসারণ বৈশিষ্ট্য
নিম্নলিখিত বৈশিষ্ট্যগুলি প্রতিটি এক্সটেনশনের জন্য উপস্থিত রয়েছে।
| সম্পত্তি | বর্ণনা | ডিফল্ট | প্রয়োজন |
|---|---|---|---|
name | আপনি এক্সটেনশনের এই কনফিগারেশনের নাম দিন। | কোনোটিই নয় | হ্যাঁ |
packageName | Apigee Edge দ্বারা প্রদত্ত এক্সটেনশন প্যাকেজের নাম। | কোনোটিই নয় | হ্যাঁ |
version | যে এক্সটেনশন প্যাকেজ থেকে আপনি একটি এক্সটেনশন কনফিগার করছেন তার সংস্করণ নম্বর। | কোনোটিই নয় | হ্যাঁ |
configuration | আপনি যে এক্সটেনশনটি যোগ করছেন তার জন্য নির্দিষ্ট কনফিগারেশন মান। এই এক্সটেনশন প্যাকেজের বৈশিষ্ট্য দেখুন | কোনোটিই নয় | হ্যাঁ |
এই এক্সটেনশন প্যাকেজের জন্য বৈশিষ্ট্যসমূহ
| সম্পত্তি | বর্ণনা | ডিফল্ট | প্রয়োজনীয় |
|---|---|---|---|
| বালতির নাম | GCS বাকেট যার সাথে এই এক্সটেনশনটি যোগাযোগ করবে। | কিছুই না। | হ্যাঁ। |