ตรวจสอบสถานะและการตั้งค่าการผสานรวม

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่ เอกสารประกอบของ Apigee X info

หน้านี้อธิบายวิธีตรวจสอบสถานะและการตั้งค่าการผสานรวมตัวเชื่อมต่อ API Hub ของ Apigee Edge ในองค์กร Apigee Edge หลังจากเปิดใช้แล้ว

การตรวจสอบการตั้งค่าการผสานรวมตัวเชื่อมต่อ API Hub

หากต้องการดึงข้อมูลการตั้งค่าการผสานรวมตัวเชื่อมต่อ API Hub สำหรับองค์กร ให้ส่งคำขอ 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 Hub สำหรับองค์กรแล้ว

"gatewayId" จะแสดงชื่อทรัพยากรของอินสแตนซ์ที่องค์กร Apigee Edge นี้เชื่อมต่ออยู่

การตรวจสอบสถานะรวม

หากต้องการดูสถานะรวม ที่มีรายละเอียดความคืบหน้าในการอัปโหลด ให้ส่งคำขอ GET ไปยัง Edge Management API ดังนี้

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

ช่องสถานะรวม

การตรวจสอบสถานะการอัปโหลดโดยละเอียด

คุณสามารถตรวจสอบสถานะโดยละเอียดของพร็อกซี API หรือสภาพแวดล้อมแต่ละรายการ หรือกลุ่มรายการที่กรองตามสถานะได้โดยใช้ปลายทาง /details และพารามิเตอร์การค้นหา

สถานะของรายการที่เฉพาะเจาะจง

หากต้องการตรวจสอบสถานะโดยละเอียดของรายการที่เฉพาะเจาะจง ให้ใช้พารามิเตอร์การค้นหา filter และ name หากต้องการดูสถานะของพร็อกซี API ชื่อ myproxy ในองค์กร acme ให้เรียก API สถานะดังนี้

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

หากต้องการดูสถานะของสภาพแวดล้อมชื่อ myenv ในองค์กร acme ให้เรียก 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

การเรียก API ด้านบนด้วยพารามิเตอร์ showrevisions จะให้เอาต์พุต 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

หากต้องการดูสถานะของพร็อกซี API ทั้งหมดที่อยู่ในสถานะล้มเหลว ในองค์กร acme ให้เรียก 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 มีพารามิเตอร์การค้นหา 3 รายการ ค่าจะพิจารณาตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

การผสมพารามิเตอร์สำหรับสถานะโดยละเอียด

ตารางด้านล่างอธิบายการผสมพารามิเตอร์ที่เป็นไปได้ซึ่งสามารถส่งไปยัง REST API เพื่อดูสถานะโดยละเอียด NA หมายความว่าระบบจะละเว้นพารามิเตอร์ NULL หมายความว่าไม่ได้ระบุพารามิเตอร์