الحصول على معرِّفات فريدة عالمية (UUID)

المعرّف الفريد العالمي (UUID) (معرّف فريد عالميًا) هو معرّف فريد لمكوِّن في نظامك. تتطلّب بعض مهام الصيانة والضبط الخاصة بخدمة Private Cloud استخدام المعرّف الفريد العالمي (UUID) للمكوِّن.

يعرض هذا القسم طُرقًا متعدّدة يمكنك استخدامها للحصول على أرقام التعريف الفريدة العالمية (UUID) لمكوّنات Private Cloud.

استخدام واجهة برمجة التطبيقات للإدارة

للحصول على المعرّف الفريد العالمي لمكوّنات Private Cloud من خلال واجهة برمجة تطبيقات الإدارة، يمكنك استخدام طلبات البيانات التالية من واجهة برمجة التطبيقات:

curl http://router_IP:8081/v1/servers/self

curl http://mp_IP:8082/v1/servers/self

curl http://qp_IP:8083/v1/servers/self

curl http://pg_IP:8084/v1/servers/self

لاحظ أن أرقام المنافذ مختلفة، بناءً على المكون الذي تتصل به.

عند طلب واجهة برمجة التطبيقات من الجهاز نفسه، لن تحتاج إلى تحديد اسم مستخدم وكلمة مرور. إذا اتصلت بواجهة برمجة التطبيقات عن بُعد، يجب تحديد اسم المستخدم وكلمة المرور لمشرف Edge، كما يبيِّن المثال التالي:

curl http://10.1.1.0:8081/v1/servers/self -u user@example.com:abcd1234 \
  -H "Accept:application/xml"

تعرض كل عملية من هذه الاستدعاءات كائن JSON يحتوي على تفاصيل حول الخدمة. وتحدّد السمة uUID المعرّف الفريد العالمي للخدمة، كما يبيِّن المثال التالي:

{
  "buildInfo" : {
    ...
  },
  ...
  "tags" : {
    ...
  },
  "type" : [ "router" ],
  "uUID" : "71ad42fb-abd1-4242-b795-3ef29342fc42"
}

يمكنك اختياريًا ضبط عنوان Accept على application/xml لتوجيه apigee-adminapi.sh إلى عرض ملف XML بدلاً من JSON. مثال:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh servers list --admin user@example.com \
  --pwd abcd1234 --host localhost -H "Accept:application/xml"

استخدام apigee-adminapi.sh

يمكنك الحصول على المعرّفات الفريدة العالمية (UUID) لبعض المكوّنات باستخدام الخيار servers list في الأداة المساعدة apigee-adminapi.sh. للحصول على أرقام التعريف الفريدة العالمية (UUID) مع apigee-adminapi.sh، استخدِم البنية التالية:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh servers list \
  --admin admin_email_address --pwd admin_password --host edge_server

المكان:

• admin_email_address هو عنوان البريد الإلكتروني لمشرف Edge.
• admin_password هي كلمة مرور مشرف Edge.
• edge_server هو عنوان IP للخادم الذي تريد الاطّلاع على قائمة منه. إذا كنت مسجّلاً الدخول إلى الخادم، يمكنك استخدام localhost.

مثال:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh servers list --admin user@example.com --pwd abcd1234 --host localhost

يعرض هذا الأمر كائن JSON معقدًا يحدد الخصائص نفسها لكل خدمة مثل طلبات البيانات من واجهة برمجة التطبيقات للإدارة.

كما هي الحال في طلبات البيانات من واجهة برمجة التطبيقات للإدارة، يمكنك اختياريًا ضبط عنوان Accept على application/xml لتوجيه apigee-adminapi.sh إلى عرض ملف XML بدلاً من JSON. على سبيل المثال:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh servers list --admin user@example.com \
  --pwd abcd1234 --host localhost -H "Accept:application/xml"