أستكشاف أخطاء الإجراءات وإصلاحها على خوادم IMM من خلال طلبات واجهة برمجة التطبيقات (API) Intersight

المقدمة

يصف هذا المستند طلبات واجهة برمجة التطبيقات (API) التي يمكن أن تكون مفيدة في أوقات النزاع عندما لا يمكن تنفيذ إجراءات معينة على الخوادم من خلال واجهة المستخدم (UI).

تمت المساهمة من قبل لويس أوريبي روجاس، مهندس مركز المساعدة الفنية من Cisco وجوستين بيرس، القائد التقني.

المتطلبات الأساسية

المتطلبات

توصي Cisco بأن تكون لديك معرفة بالمواضيع التالية:

• Intersight
• خوادم نظام الحوسبة الموحدة (UCS)
• وضع Intersight المدار (IMM)
• واجهة برمجة التطبيقات (API)

المكونات المستخدمة

تستند المعلومات الواردة في هذا المستند إلى إصدارات البرامج والمكونات المادية التالية:

• الارتباطات النسيجية Cisco UCS 6454، البرنامج الثابت 4.2(1m)
• خادم UCSB-B200-M5 المتعدد اللوحات، البرنامج الثابت 4.2(1a)
• برنامج Intersight كخدمة (SaaS)

تم إنشاء المعلومات الواردة في هذا المستند من الأجهزة الموجودة في بيئة معملية خاصة. بدأت جميع الأجهزة المُستخدمة في هذا المستند بتكوين ممسوح (افتراضي). إذا كانت شبكتك قيد التشغيل، فتأكد من فهمك للتأثير المحتمل لأي أمر.

معلومات أساسية

توفر Cisco Intersight واجهة برمجة تطبيقات RESTful قائمة على السحابة لإدارة الأهداف المتصلة ب Intersight عبر مراكز بيانات متعددة. تتضمن خدمات البنية الأساسية Cisco Intersight النشر والمراقبة والإدارة والدعم للبنية الأساسية المادية والافتراضية.

في الحالات التي لا يمكن فيها تنفيذ إجراءات معينة على Intersight Managed Servers من خلال واجهة المستخدم (UI) الخاصة ب Intersight، إما لأن الخيارات متدرجة أو أن الوصول إلى واجهة المستخدم غير متوفر، يمكن أن تكون طلبات API بديلا مفيدا.

طلبات API من حساب SAAs أو Intersight Appliance

نظرة عامة على الخطوات

تتبع الأمثلة التالية بنية متناسقة، على الرغم من أن المعلمات والقيم المحددة المستخدمة يمكن أن تختلف. هذا ملخص مختصر للخطوات المعنية:

سجل الدخول إلى حساب Intersight.

بالنسبة لبيئة SaaS، في مستعرض، انتقل إلى مرجع API وسجل الدخول باستخدام حسابك.

ملاحظة: لبيئة جهاز، مثل Intersight Connected Virtual Appliance (CVA) أو Intersight Private Virtual Appliance (PVA) في تنقل المستعرض إلى https://<appliance-hostname>/apidocs/apirefs وتسجيل الدخول باستخدام بيانات اعتماد الجهاز.

1. ابحث عن طلب واجهة برمجة التطبيقات (API) الذي تحتاج إليه واستخدم GET تمت تصفية المكالمة بقيمة (قيم) حقل معروفة، مثل الرقم التسلسلي وملف تعريف الخادم واسم الخادم ومعرف الجهاز وما إلى ذلك.
2. أستخدم PATCH الاتصال بالإجراء المراسل لتنفيذ المهمة المطلوبة

تلميح: في معلمات الاستعلام، تأكد من إستخدام نفس الأحرف الدقيقة لأمثلة المفاتيح والقيمة لتجنب الأخطاء.

في الدليل المرجعي لواجهة برمجة التطبيقات، من المفيد مراجعة Response Model علامة التبويب الخاصة بالصياغة المناسبة وجميع الإجراءات المدعومة التي يمكن إستخدامها في حمولة المكالمة. على سبيل المثال، من  /api/v1/compute/BladeIdentities/, AdminAction المدعومة هي None، Decommission، Recommission، Reack، Remove,و Replace. يتم إستخدام هذا النموذج في هذا المستند بالكامل.

إلغاء التشغيل/إعادة تعيين خادم

في وثيقة Intersight API المرجعية، ابحث عن compute/BladeIdentities طلب، حدد الأول GET قم بالاتصال، ثم أدخل معلمات الاستعلام المطلوبة.

يستخدم هذا المثال المعلمات التالية:

تطبيق PATCH اتصل مع الإجراء المطلوب. يستخدم هذا المثال:

 {"AdminAction":"Decommission"}

تلميح: إذا كانت عملية إعادة التشغيل مطلوبة، أستخدم {"AdminAction":"Recommission"}.

إلغاء تعيين ملف تعريف الخادم

ابحث عن طلب الخادم/ملفات التعريف وحدد أول إستدعاء GET، ثم أدخل معلمات الاستعلام المطلوبة.

يستخدم هذا المثال المعلمات التالية:

تطبيق إستدعاء التصحيح مع الإجراء المطلوب. يستخدم هذا المثال:

{"Action":"Unassign"}

إزالة الخادم

في وثيقة Intersight API Reference، ابحث عن طلب Compute/BladeIdentity وحدد الأول GET قم بالاتصال، ثم أدخل معلمات الاستعلام المطلوبة.

يستخدم هذا المثال المعلمات التالية:

تطبيق إستدعاء التصحيح مع الإجراء المطلوب. يستخدم هذا المثال:

{"AdminAction":"Remove"} 

تحذير: يؤدي هذا الطلب إلى إزالة الخادم من المخزون. لإضافة الخادم مرة أخرى إلى مخزون المجال، يلزم اكتشاف جديد. يمكن تشغيل هذا الإجراء من خلال إعادة بيع فعلية للخادم أو من خلال مهمة إعادة اكتشاف الهيكل.

أستكشاف أخطاء الإجراءات وإصلاحها من خلال مستكشف واجهة برمجة التطبيقات (API) في وحدة تحكم الجهاز

تسمح لك وحدة تحكم الجهاز بمراقبة سلامة أجهزتك وحالة إتصالها ب Intersight. يمكنك إنشاء مجموعات الدعم الفني التي تحتوي على معلومات تشخيصية لاستكشاف المشكلات وحلها. بالإضافة إلى ذلك، تتضمن وحدة تحكم الجهاز القدرة على تشغيل مستكشف واجهة برمجة التطبيقات (API) لتنفيذ عمليات قائمة على Redfish™ على الخوادم.

في حالة فقد الاتصال بين Intersight أو Appliance، يمكن إستخدام مستكشف واجهة برمجة التطبيقات (API) في وحدة تحكم الجهاز أيضا لتنفيذ بعض الإجراءات الأساسية لاستكشاف الأخطاء وإصلاحها.

1) افتح وحدة تحكم الجهاز، ثم انتقل إلى أحد عناوين IP الخاصة بواجهة اتصال البنية، وحدد علامة التبويب "جرد".

2) انتقل إلى الجهاز المحدد الذي يحتاج إلى أن يكون مثيرا للمشاكل، حدد النقاط الثلاث الموجودة على يمينه وحدد Launch API Explorer. يتم تشغيل مستكشف واجهة برمجة التطبيقات (API) لهذا الجهاز فقط، ولا يتم تشغيل أية أجهزة أخرى.

إعادة تمهيد وحدة التحكم في إدارة CIMC للخادم

تشغيل "مستكشف واجهة برمجة التطبيقات" للخادم:

اكتب CIMC في {ManagerID} وطبق مادة نشر المدراء/{ManagerId}/Actions/Manager.Reset الاتصال بإضافة نوع إعادة التعيين.

يستخدم هذا المثال:

{"ResetType": "ForceRestart"}

إعادة تشغيل وحدة الإدخال/الإخراج (IOM)

تشغيل مستكشف واجهة برمجة التطبيقات (API) التابع للمنظمة الدولية للهجرة:

اكتب CMC في {ManagerID} وطبق مادة نشر المدراء/{ManagerId}/Actions/Manager.Reset الاتصال بإضافة نوع إعادة التعيين. يستخدم هذا المثال:

{"ResetType": "ForceRestart"}

لإعادة تشغيل IOM نظيرة في {حقل ManagerID}، أدخل PeerCMC بنفس النداء السابق.

معلومات ذات صلة

نظرة عامة على واجهة برمجة التطبيقات Intersight

نظرة عامة على وحدة تحكم الجهاز