ইন্টিগ্রেশন স্ট্যাটাস ও সেটিংস চেক করা

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

এই পৃষ্ঠা থেকে আপনি জানতে পারবেন যে Apigee Edge API হাব কানেক্টর ইন্টিগ্রেশন চালু করার পরে কীভাবে আপনার Apigee Edge সংস্থার মধ্যে এর স্ট্যাটাস ও সেটিংস চেক করতে হয়।

API হাব কানেক্টর ইন্টিগ্রেশন সেটিংস চেক করা

কোনও সংস্থার জন্য API হাব কানেক্টর ইন্টিগ্রেশন সেটিংস পেতে, নিম্নলিখিত অনুরোধ পাঠানোর জন্য একটি GET অনুরোধ করুন:

curl -X GET https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/settings -H "Authorization: Bearer OAUTH_TOKEN"

যেখানে:

  • ORG_NAME হল আপনার Apigee Edge সংস্থার নাম।
  • OAUTH_TOKENঅনুরোধ যাচাই করার জন্য OAuth টোকেন ব্যবহার করা হয়। OAuth টোকেন তৈরি করা সম্পর্কে আরও জানতে, টোকেন পান নিবন্ধটি দেখুন।

সফল উত্তরটি নিচে দেওয়া উত্তরের মতো হবে:

  {
    "enabled": true,
    "gatewayId": "my-gateway-id"
  }

"enabled": true কনফার্ম করে যে সংস্থার জন্য API হাব কানেক্টর ইন্টিগ্রেশন অ্যাক্টিভেট করা হয়েছে।

"gatewayId" সেই ইনস্ট্যান্স রিসোর্স নেম দেখায় যার সাথে এই Apigee Edge সংস্থা কানেক্ট করা আছে।

একত্রিত স্ট্যাটাস চেক করা হচ্ছে

আপলোড প্রসেসের বিস্তারিত বিবরণ সহ একত্রিত স্ট্যাটাস পেতে, Edge ম্যানেজমেন্ট API-তে GET অনুরোধ করুন:

curl -X GET https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/status
  -H "Authorization: Bearer OAUTH_TOKEN

যেখানে:

  • ORG_NAME হল আপনার Apigee Edge সংস্থার নাম।

সফলভাবে কনসোলিডেট করা উত্তরটি নিচে দেওয়া উত্তরের মতো হবে, যেখানে প্রক্সি ও এনভায়রনমেন্টের আপলোড প্রগ্রেস দেখানো হবে। নিচের উদাহরণে একটি Queued ফেজ দেখানো হয়েছে:

{
  "phase": "Preparing",
  "lastUpdated": "2025-09-15T02:23:50.706Z",
  "components": {
    "proxy": {
      "lastUpdated": "2025-09-15T02:23:50.706Z",
      "progress": {
        "totalItems": 10,
        "pendingItems": 1,
        "completedItems": 9,
        "failedItems": 0
      }
    },
    "environment": {
      "lastUpdated": "2025-09-15T02:23:50.706Z",
      "progress": {
        "totalItems": 5,
        "pendingItems": 0,
        "completedItems": 4,
        "failedItems": 1
      }
    }
  }
}

একত্রিত স্ট্যাটাস ফিল্ড

ফিল্ড বিবরণ
phase সংস্থাটির জন্য বর্তমান প্রসেসিং ফেজ। সম্ভাব্য ভ্যালু হল:
  • Queued: সংস্থাটি সম্প্রতি যোগ করা হয়েছে এবং প্রাথমিক প্রসেসিংয়ের জন্য তা সারিতে আছে।
  • Preparing: সংস্থাটি কোল্ড ট্রান্সফার স্টেটে আছে যেখানে আগে থেকে থাকা সব প্রক্সি API হাবে আপলোড করা হচ্ছে। সংস্থাটি সম্প্রতি যোগ করা হলে এবং সেটি প্রস্তুত করা হলে এই স্ট্যাটাস দেখা যায়।
  • Processing: সংস্থাটি ক্রমাগত আপডেট করার অবস্থায় আছে যেখানে প্রক্সি ও এনভায়রনমেন্টে করা পরিবর্তনগুলি API হাবে ক্রমাগত আপলোড করা হচ্ছে।
lastUpdated এই সংস্থার জন্য প্রসেস করা শেষ ইভেন্টের টাইমস্ট্যাম্প।
components প্রসেস করা প্রক্সি ও এনভায়রনমেন্ট সম্পর্কে বিস্তারিত তথ্য প্রদানকারী ম্যাপ। ম্যাপে নিম্নলিখিত কী থাকতে পারে:
  • proxy: Edge সিস্টেমে API প্রক্সিগুলির বিস্তারিত সংখ্যা প্রদান করে যা API হাবে প্রসেস ও আপলোড করা হয়েছে।
  • environment: Edge সিস্টেমে প্রসেস করা এবং API হাবে আপলোড করা এনভায়রনমেন্টের বিস্তারিত সংখ্যা প্রদান করে।
progress proxy বা environment বিভাগের মধ্যে থাকা ভ্যালুগুলি হল:
  • totalItems: আইটেমের মোট সংখ্যা।
  • pendingItems: প্রসেস করার জন্য বাকি থাকা আইটেমের সংখ্যা।
  • completedItems: সফলভাবে সম্পূর্ণ করা আইটেমের সংখ্যা।
  • failedItems: আপলোড করার সময় যতগুলি আইটেম আপলোড করা যায়নি।

আপলোড সংক্রান্ত বিস্তারিত স্ট্যাটাস চেক করা

/details এন্ডপয়েন্ট ও কোয়েরি প্যারামিটার ব্যবহার করে আপনি কোনও স্বতন্ত্র API প্রক্সি বা এনভায়রনমেন্ট অথবা স্ট্যাটাস অনুযায়ী ফিল্টার করা আইটেমের গ্রুপের বিস্তারিত স্ট্যাটাস চেক করতে পারবেন।

নির্দিষ্ট আইটেমের স্ট্যাটাস

নির্দিষ্ট আইটেমের বিস্তারিত স্ট্যাটাস চেক করতে, filter ও name কোয়েরি প্যারামিটার ব্যবহার করুন। acme সংস্থার myproxy নামের API প্রক্সির জন্য, নিম্নলিখিতভাবে স্ট্যাটাস API কল করুন:

curl -X GET https://api.enterprise.apigee.com/v1/organizations/acme/uapim/status/details?filter=proxy&name=myproxy \
  -H "Authorization: Bearer OAUTH_TOKEN"

acme সংস্থার myenv নামের এনভায়রনমেন্টের জন্য, নিম্নলিখিতভাবে স্ট্যাটাস API কল করুন:

GET http://enterprise.apigee.com/organizations/acme/uapim/status/details?filter=environment&name=myenv

উপরে উল্লেখ করা API কল করলে, সম্প্রতি আপলোড করা প্রক্সির জন্য নিম্নলিখিত JSON আউটপুটের মতো আউটপুট পাওয়া যাবে:

{
  "name": "myProxy",
  "status": "Pending Upload",
  "lastSuccessfulUploadTime": "2025-09-15T02:23:50.706Z",
}

পরিবর্তন সংক্রান্ত তথ্য সহ বিস্তারিত স্ট্যাটাস

অতিরিক্ত কোয়েরি প্যারামিটার showRevisions=true প্রদান করে কোনও প্রদত্ত প্রক্সি রিভিশনের স্বতন্ত্র প্রক্সি রিভিশন সম্পর্কে তথ্য পাওয়া সম্ভব। এখানে জেনারেট করা আউটপুট, কোনও নির্দিষ্ট প্রক্সির জন্য আপলোড করা প্রতিটি রিভিশনের বিবরণ প্রদান করবে।

GET http://enterprise.apigee.com/organizations/acme/uapim/status/details?filter=proxy&name=myproxy&showRevisions=true

showrevisions প্যারামিটার সহ উপরের API কল করলে, নিম্নলিখিত JSON আউটপুটের মতো আউটপুট পাওয়া যাবে:

{
  "name": "myProxy",
  "status": "Pending Upload",
  "lastSuccessfulUploadTime": "2025-09-15T02:23:50.706Z",
  "revisions": [
    {
      "name": "1",
      "status": "Up to date",
      "lastSuccessfulUploadTime": "2025-09-15T02:23:50.706Z",
    },  
    {
      "name": "2",
      "status": "Pending upload",
      "lastSuccessfulUploadTime": "2025-09-15T02:23:55.000Z",
    }  
  ]
}

গ্রুপ আপলোডের স্ট্যাটাস

state কোয়েরি প্যারামিটার সহ গ্রুপ ফিল্টার ব্যবহার করে আপনি আইটেমের একটি গ্রুপের জন্য আপলোড স্ট্যাটাস পেতে পারেন।

সংস্থা acme-এ কাজ করছে না এমন সব API প্রক্সির স্ট্যাটাস জানতে, নিম্নলিখিত স্ট্যাটাস API কল করুন:

GET http://enterprise.apigee.com/organizations/acme/uapim/status/details?filter=proxy&state=failed

একইভাবে, কোনও সংস্থার acme মধ্যে আপলোড করার জন্য পেন্ডিং থাকা সমস্ত এনভায়রনমেন্টের বিস্তারিত তালিকা পেতে, নিম্নলিখিত স্ট্যাটাস API কল করুন:

GET http://enterprise.apigee.com/organizations/acme/uapim/status/details?filter=environment&state=pending

এই API কল করার ফলাফল হল ফিল্টারের সাথে ম্যাচ করা স্বতন্ত্র স্ট্যাটাস আইটেমের একটি JSON সংগ্রহ। উদাহরণ:

[
  {
    "name": "myProxy",
    "status": "last upload failed",
    "lastSuccessfulUploadTime": "2025-09-12T02:23:50.706Z",
    "lastFailedUploadTime": "2025-09-13T02:23:50.706Z",
    "lastUploadError": "Errors connecting to API Hub"
  },
  {
    "name": "secondProxy",
    "status": "last upload failed",
    "lastSuccessfulUploadTime": "2025-09-12T02:23:51.706Z",
    "lastFailedUploadTime": "2025-09-13T02:23:51.706Z",
    "lastUploadError": "Errors connecting to API Hub"
  }
]

বিস্তারিত স্ট্যাটাসের জন্য কোয়েরি প্যারামিটার

API তিনটি কোয়েরি প্যারামিটার প্রদান করে। ভ্যালুতে ছোট ও বড় হাতের অক্ষরের পার্থক্য করা হয়।

কোয়েরি প্যারামিটার সম্ভাব্য ভ্যালু বিবরণ
filter proxy, environment এই কোয়েরি প্যারামিটার থেকে বোঝা যায় যে ফলাফল কোনও প্রক্সি বা এনভায়রনমেন্ট অনুযায়ী ফিল্টার করতে হবে।
state failed, pending, all এই কোয়েরি প্যারামিটার থেকে বোঝা যায় যে filter ছাড়াও ফলাফল রাজ্য অনুযায়ী ফিল্টার করতে হবে।
name নির্দিষ্ট আইটেমের নাম এই কোয়েরি প্যারামিটার থেকে বোঝা যায় যে filter ছাড়াও নাম অনুযায়ী ফলাফল ফিল্টার করতে হবে।
showrevisions true, false এই কোয়েরি প্যারামিটার প্রদান করা হলে, আউটপুটে রিভিশন স্ট্যাটাস তৈরি হবে (শুধুমাত্র filter=proxy হলে বৈধ)।

বিস্তারিত স্ট্যাটাসের জন্য প্যারামিটারের কম্বিনেশন

বিস্তারিত স্ট্যাটাস পেতে REST API-তে পাস করা যেতে পারে এমন সম্ভাব্য প্যারামিটার কম্বিনেশন নিচে দেওয়া টেবিলে ব্যাখ্যা করা হয়েছে। NA ইঙ্গিত করে যে প্যারামিটারটি উপেক্ষা করা হবে। NULL থেকে বোঝা যায় যে প্যারামিটার প্রদান করা হয়নি।

ফিল্টার করুন রাজ্য নাম ফলাফল
proxy all NULL সব প্রক্সি সার্ভারের জন্য রিপোর্ট স্ট্যাটাসের বিবরণ।
proxy failed NULL আপলোড করা যায়নি এমন সব প্রক্সি সার্ভারের জন্য রিপোর্ট স্ট্যাটাসের বিবরণ।
proxy pending NULL আপলোড বা আবার আপলোড করা বাকি আছে এমন সব প্রক্সি সার্ভারের জন্য রিপোর্ট স্ট্যাটাসের বিবরণ।
proxy NULL myproxy myproxy নামের প্রক্সির জন্য রিপোর্ট স্ট্যাটাসের বিবরণ।
proxy NON-NULL NON-NULL সমস্যার ব্যাপারে রিপোর্ট করে।
environment all NULL সব এনভায়রনমেন্টের জন্য রিপোর্ট স্ট্যাটাসের বিবরণ।
environment failed NULL আপলোড করা যায়নি এমন সব এনভায়রনমেন্টের জন্য রিপোর্ট স্ট্যাটাসের বিবরণ।
environment pending NULL আপলোড বা আবার আপলোড করা বাকি আছে এমন সব এনভায়রনমেন্টের জন্য রিপোর্ট স্ট্যাটাসের বিবরণ।
environment NULL myenv myenv নামের এনভায়রনমেন্টের জন্য রিপোর্ট স্ট্যাটাসের বিবরণ।
environment NON-NULL NON-NULL সমস্যার ব্যাপারে অভিযোগ জানায়।