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

خيارات التنزيل

  • PDF     (2.1 MB)
    عرض باستخدام Adobe Reader على مجموعة متنوعة من الأجهزة
  • ePub     (1.9 MB)
    العرض في تطبيقات مختلفة على iPhone أو iPad أو نظام تشغيل Android أو قارئ Sony أو نظام التشغيل Windows Phone
  • Mobi (Kindle)     (1.2 MB)
    عرض على جهاز Kindle أو تطبيق Kindle على أجهزة متعددة
تم التحديث:١٢ نوفمبر ٢٠٢٤
معرّف المستند:220345

لغة خالية من التحيز

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

حول هذه الترجمة

ترجمت Cisco هذا المستند باستخدام مجموعة من التقنيات الآلية والبشرية لتقديم محتوى دعم للمستخدمين في جميع أنحاء العالم بلغتهم الخاصة. يُرجى ملاحظة أن أفضل ترجمة آلية لن تكون دقيقة كما هو الحال مع الترجمة الاحترافية التي يقدمها مترجم محترف. تخلي Cisco Systems مسئوليتها عن دقة هذه الترجمات وتُوصي بالرجوع دائمًا إلى المستند الإنجليزي الأصلي (الرابط متوفر).

    المقدمة

    يصف هذا المستند طلبات واجهة برمجة التطبيقات (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،DecommissionRecommission، ReackRemove، Replace. يتم إستخدام هذا النموذج في هذا المستند بالكامل.

    Update a compute.Blades identity resource

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

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

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

    المفتاح القيمة الاستخدام
    مرشح $ سلسلة EQ 'FLM2402001A' لتصفية الإخراج إلى الخادم باستخدام الرقم التسلسلي المتوفر.
    $select مويد لتحديد القيم التي سيتم عرضها من هذا الكائن. القيمة المعروضة هي معرف الخادم.

    Read a compute.Blades identity resource

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

     {"AdminAction":"Decommission"}

    Update a compute.Blades identity resource

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

    تلميح: يمكن إصدار إجراءات مماثلة للخوادم المدمجة بالحوامل والهياكل في إدارة الحاوية. ابحث عن إستدعاءات واجهة برمجة التطبيقات (API) Compute/RackUnitIdentity وEquipment/ChassisIdentity.

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

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

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

    المفتاح القيمة الاستخدام
    مرشح $ اسم eq 'UCSX-Server-boot-SAN' لتصفية الإخراج إلى ملف تعريف الخادم الذي يتضمن الاسم الذي تم إدخاله.
    $select MOID،اسم لتحديد القيمة (القيم) التي سيتم عرضها من هذا الكائن. في هذه الحالة

    Read a serverProfile resource

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

    {"Action":"Unassign"}

    Update a serverProfile resource

    إزالة الخادم

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

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

    المفتاح القيمة الاستخدام
    مرشح $ سلسلة EQ 'FLM2402001A' لتصفية الإخراج إلى الخادم فقط مع توفير الرقم التسلسلي.
    $select مويد لتحديد القيم التي سيتم عرضها من هذا الكائن. القيمة المعروضة هي معرف الخادم.

    Read a compute.Blades identity resource

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

    {"AdminAction":"Remove"}

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

    Update a compute.Blades identity resource

    إعادة تشغيل IMC للخادم

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

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

    المفتاح القيمة الاستخدام
    مرشح $ الاسم eq 'fi-6536-1-3' لتصفية الإخراج إلى الخادم النصلي الذي يحمل الاسم الذي تم إدخاله.
    $select MOID،اسم لتحديد القيمة (القيم) التي سيتم عرضها من هذا الكائن.

    Read a compute.ServerSettings identity resource

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

    {"AdminPowerState":"Reboot"}

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

    Update a compute.ServerSettings identity resource

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

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

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

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

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

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

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

    Server API Explorer

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

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

    {"ResetType": "ForceRestart"}

    Server API Explorer reset

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

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

    Device console chassis inventory

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

    {"ResetType": "ForceRestart"}

    API Explorer Repurpose module

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

    Peer CMC ResetType

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

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

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

    محفوظات المراجعة

    المراجعة تاريخ النشر التعليقات
    3.0
    12-Nov-2024
    عملية محدثة لإعادة تشغيل IMC للخادم
    2.0
    05-Apr-2023
    الإصدار الأولي
    1.0
    05-Apr-2023
    الإصدار الأولي
    TAC Authored

    تمت المساهمة بواسطة مهندسو Cisco

    • Luis Uribe Rojas
      TAC
    • Justin Pierce
      TAC

    هل كان هذا المستند مفيدًا؟

    Feedbackالتعليقات

    اتصل بنا

    ينطبق هذا المستند على هذه المنتجات