ইন্টিগ্রেশন স্ট্যাটাস এবং সেটিংস চেক করুন

আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন
.info- তে যান।

আপনার Apigee Edge অর্গানাইজেশনে Apigee Edge 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 নিশ্চিত করে যে সংস্থাটির জন্য এপিআই হাব কানেক্টর ইন্টিগ্রেশন সক্রিয় করা হয়েছে।

"gatewayId" সেই ইনস্ট্যান্স রিসোর্স নেমটি প্রদর্শন করে, যার সাথে এই Apigee 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 : সংস্থাটি একটি কোল্ড ট্রান্সফার অবস্থায় রয়েছে, যেখানে সমস্ত বিদ্যমান প্রক্সি এপিআই হাবে আপলোড করা হচ্ছে। এই অবস্থাটি তখন ঘটে যখন সংস্থাটিকে সম্প্রতি যুক্ত করা হয় এবং প্রস্তুত করা হচ্ছে।
  • Processing : সংস্থাটি একটি নিরন্তর হালনাগাদ অবস্থায় রয়েছে, যেখানে প্রক্সি এবং এনভায়রনমেন্টের পরিবর্তনগুলো ক্রমাগত এপিআই হাবে আপলোড করা হচ্ছে।
lastUpdated এই সংস্থার জন্য প্রক্রিয়াকৃত সর্বশেষ ইভেন্টের টাইমস্ট্যাম্প।
components প্রক্রিয়াকৃত প্রক্সি এবং এনভায়রনমেন্টগুলো সম্পর্কে বিস্তারিত তথ্য প্রদানকারী একটি ম্যাপ। ম্যাপটিতে নিম্নলিখিত কী-গুলো থাকতে পারে:
  • proxy : এজ সিস্টেমে থাকা সেইসব এপিআই প্রক্সির বিস্তারিত সংখ্যা প্রদান করে, যেগুলো প্রসেস করে এপিআই হাবে আপলোড করা হয়েছে।
  • environment : এজ সিস্টেমে থাকা সেইসব এনভায়রনমেন্টের বিস্তারিত সংখ্যা প্রদান করে, যেগুলো প্রসেস করে এপিআই হাবে আপলোড করা হয়েছে।
progress proxy বা environment সেকশনের অন্তর্ভুক্ত মানগুলো হলো:
  • totalItems : মোট আইটেমের সংখ্যা।
  • pendingItems : প্রক্রিয়াকরণের জন্য অপেক্ষাধীন আইটেমের সংখ্যা।
  • completedItems : সফলভাবে সম্পন্ন হওয়া আইটেমের সংখ্যা।
  • failedItems : আপলোডের সময় ব্যর্থ হওয়া আইটেমের সংখ্যা।

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

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

একটি নির্দিষ্ট আইটেমের অবস্থা

কোনো নির্দিষ্ট আইটেমের বিস্তারিত অবস্থা জানতে, 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

এই এপিআইটি কল করার ফলে ফিল্টারের সাথে মিলে যাওয়া স্বতন্ত্র স্ট্যাটাস আইটেমগুলোর একটি 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"
  }
]

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

এপিআইটি তিনটি কোয়েরি প্যারামিটার প্রদান করে। মানগুলো কেস-সেনসিটিভ।

কোয়েরি প্যারাম সম্ভাব্য মান বর্ণনা
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 একটি ত্রুটি দেখাচ্ছে।