গুগল ক্লাউড স্টোরেজ এক্সটেনশন

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশনে যান
তথ্য

সংস্করণ: 1.4.1

ক্লাউড স্টোরেজ বাকেটে ফাইলগুলির জন্য স্বাক্ষরিত URL গুলি তালিকাভুক্ত করুন, ডাউনলোড করুন এবং তৈরি করুন।

এই কন্টেন্টটি এই এক্সটেনশনটি কনফিগার এবং ব্যবহারের জন্য রেফারেন্স প্রদান করে। API প্রক্সি থেকে এই এক্সটেনশনটি ব্যবহার করার আগে, আপনাকে অবশ্যই:

  1. একটি ক্লাউড স্টোরেজ বাকেট তৈরি করুন

  2. আপনার বালতিতে বস্তু আপলোড করুন

  3. আপনার Google ক্লাউড স্টোরেজ এক্সটেনশনের প্রতিনিধিত্বকারী GCP পরিষেবা অ্যাকাউন্টে বাকেট অ্যাক্সেস করার অনুমতি দিন । ব্যবহারের ভূমিকা সম্পর্কে আরও জানতে, ক্লাউড স্টোরেজ ভূমিকা দেখুন। ক্লাউড স্টোরেজের অনুমতি সম্পর্কে আরও জানতে, পরিচয় এবং অ্যাক্সেস ম্যানেজমেন্ট (IAM) অনুমতি ব্যবহার দেখুন।

  4. পরিষেবা অ্যাকাউন্টের জন্য একটি কী তৈরি করতে GCP কনসোল ব্যবহার করুন

  5. কনফিগারেশন রেফারেন্স ব্যবহার করে এক্সটেনশন যোগ এবং কনফিগার করার সময় ফলাফল কী 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 নীতিটি 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."}

নিম্নলিখিত অ্যাসাইন মেসেজ নীতি এক্সটেনশন দ্বারা ফেরত দেওয়া মান পুনরুদ্ধার করে এবং এটি প্রতিক্রিয়া পেলোডে অনুলিপি করে।

<?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"}

নিম্নলিখিত অ্যাসাইন মেসেজ নীতি এক্সটেনশন দ্বারা ফেরত দেওয়া মান পুনরুদ্ধার করে এবং প্রতিক্রিয়া বডিতে অনুলিপি করে।

<?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 তৈরি করে। এই URL টি ফাইলটি ডাউনলোড করতে ব্যবহার করা যেতে পারে।

অনুরোধের প্যারামিটার

প্যারামিটার বিবরণ আদর্শ ডিফল্ট প্রয়োজনীয়
ফাইলের নাম যে ক্লাউড স্টোরেজ অবজেক্টের জন্য একটি স্বাক্ষরিত URL তৈরি করতে হবে তার নাম। স্ট্রিং কোনোটিই নয়। হ্যাঁ।
মেয়াদ শেষ হয় স্বাক্ষরিত 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>

প্রতিক্রিয়া

JSON স্বাক্ষরিত URL সহ একটি বস্তুর প্রতিনিধিত্ব করে। উদাহরণস্বরূপ:

{"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 আপনি যে এক্সটেনশনটি যোগ করছেন তার জন্য নির্দিষ্ট কনফিগারেশন মান। এই এক্সটেনশন প্যাকেজের বৈশিষ্ট্য দেখুন কোনোটিই নয় হ্যাঁ

এই এক্সটেনশন প্যাকেজের বৈশিষ্ট্যাবলী

সম্পত্তি বিবরণ ডিফল্ট প্রয়োজনীয়
বাকেটনাম এই এক্সটেনশনটি যে GCS বাকেটের সাথে ইন্টারঅ্যাক্ট করবে। কোনোটিই নয়। হ্যাঁ।