المحتويات

المقدمة

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

علامات موارد الحساب

المتطلبات

عبر واجهة المستخدم

من خلال واجهة برمجة التطبيقات

أرقام موارد خدمة البنية الأساسية

من خلال طريقة عرض قائمة واجهة المستخدم

علامات موارد المؤسسة

Via API

علامات موارد تسجيل الأجهزة

من خلال واجهة برمجة التطبيقات

المقدمة

يصف هذا المستند الخطوات المطلوبة لإضافة علامات تمييز إلى موارد Cisco Intersight.

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

العلامة هي مجموعة عامة من البيانات الأولية للمفتاح/القيمة التي يمكن تطبيقها على الموارد في CiSco Intersight. يمكن أن تختلف هذه الموارد من نقاط نهاية الخادم إلى الحسابات وغير ذلك.

كمستخدم، يمكن إستخدام علامات التمييز لتجميع موارد CiSco Intersight التي تسمح بالاستعلام عن الموارد بناء على قيم علامات التمييز هذه.

ضمن Cisco، هناك برنامج مختلف أن يعتمد على cisco Intersight مورد بطاقة لتمكين/تعطيل ميزات معينة. يرجى الرجوع إلى وثائق البرنامج المحدد للحصول على مزيد من المعلومات حول هذه الميزات والوظائف.

علامات موارد الحساب

المتطلبات

- دور مسؤول الحساب للحساب المراد تعديله

- الوصول إلى نقطة نهاية IAM.Account API

عند تسجيل الدخول عبر واجهة المستخدم، انقر فوق قائمة ملف التعريف الموجودة في أعلى يمين واجهة المستخدم لعرض الحساب الذي تم تسجيل الدخول والدور.

عبر واجهة المستخدم

1. انقر فوق أداة تحديد الخدمات

2. تحديد "النظام"

3. من طريقة العرض إعدادات > تفاصيل الحساب، انقر فوق "تكوين".

4. من القائمة المنبثقة تكوين إعدادات الحساب"، يمكن إرسال زوج مفاتيح:قيمة لإضافة علامة جديدة.

5. بمجرد الإدخال، انقر فوق تكوين" للإرسال

يجب إدخال العلامة بتنسيق "key:value". مثلا فوق دخلنا:

AutoRMAEmail:kmccabe2@cisco.com,sttardy@cisco.com

سيؤدي هذا إلى إنشاء علامة على مورد الحساب باستخدام مفتاح AutoRMAEmail وقيمة kmccabe2@cisco.com،sttardy@cisco.com.

ملاحظة: عند إضافة علامة جديدة صافية، لن يظهر تنبؤ المساعد التلقائي أي خيارات. أدخل علامة net-new تماما كما هي موثقة، ثم اضغط على enter للإرسال.

6. يمكن التحقق من صحة العلامات المكونة من طريقة عرض تفاصيل الحساب

من خلال واجهة برمجة التطبيقات

1. HTTP احصل على مورد IAM.Account للعثور على Moid الخاص بمورد الحساب (AccountMoid) المطلوب تحديثه. يجب توثيق أي علامات موجودة ليتم الاحتفاظ بها.

GET /api/v1/iam/Accounts

RESPONSE:

{

"ObjectType": "iam.Account.List",

"Results": [

{

"AccountMoid": "5eb2e1e47564612d307xxxxx",

"Moid": "5eb2e1e47564612d307xxxxx",

...snip...

"Tags": [{

"Key":"existingKey",

"Value":"existingVal"

}]

}]

}

2. يقوم HTTP بترحيل مورد IAM.Account المحدد بواسطة MOID وتضمين العلامات الجديدة والحالية في حمولة الطلب.

ملاحظة: إذا كان لمورد الحساب علامات موجودة، فيجب تضمينها في مادة النشر التي سيتم الاحتفاظ بها. وإذا لم يتم تضمينها في مادة النشر، فسيتم حذفها من مورد الحساب.

POST /api/v1/iam/Accounts/5eb2e1e47564612d307xxxxx

PAYLOAD:

{

"Tags": [{

"Key": "existingKey",

"Value": "existingVal"

}, {

"Key": "ACIProactive",

"Value": "brvarney@cisco.com"

}]

}

أرقام موارد خدمة البنية الأساسية

من خلال طريقة عرض قائمة واجهة المستخدم

الموارد التي يتم عرضها ضمن عرض قائمة عبر خدمة البنية الأساسية يمكن تمييزها. على سبيل المثال، الخوادم ومجموعات البيانات ومنافذ الموصلات البينية الليفية والهيكل وما إلى ذلك.

ملاحظة: لا تدعم خدمة RMA الاستباقية أي ميزات ممكنة من خلال أرقام موارد خدمة البنية الأساسية. لا تستخدم الخطوات التالية لتكوين علامات RMA الاستباقية.

1. ضمن عرض قائمة، حدد مربع الموارد التي سيتم تمييزها

2. اضغط زر العلامة الموجود بجوار القطع الناقص

3. ضمن القائمة المنبثقة مجموعة علامات التمييز المشتركة"، أدخل علامة المفتاح:القيمة ليتم تطبيقها على كل الكائنات المحددة

4. اضغط على حفظ" للإرسال

ملاحظة: عند إضافة علامة جديدة صافية، لن يظهر تنبؤ المساعد التلقائي أي خيارات. أدخل علامة net-new تماما كما هي موثقة، ثم اضغط على enter للإرسال.

علامات موارد المؤسسة

Via API

1. فتح مستندات API للمؤسسات

انتقل إلى صفحة مستند واجهة برمجة التطبيقات للمؤسسات.

ملاحظة: إذا كنت تستخدم الجهاز الظاهري المتصل، فيمكنك الانتقال إلى https://[FQDN of appliance]/apidocs/apirefs/organization/organizations/model/instead

2. حدد المنظمة التي ترغب في تحديثها.

الرجاء مراجعة دليل استعلام Intersight API للرجوع إليه.

يمكن للمستخدمين ببساطة إستخدام نقطة نهاية GET لسرد جميع المؤسسات التي ليس لها معلمات. في حالة وجود عدد كبير من المؤسسات في حسابك بحيث يتعذر عرضها بسهولة في إخراج واحد، يمكن للمستخدمين إستخدام معلمة استعلام $select لتحديد الحقول الموضحة، ولكن تأكد من تضمين علامات في جملة $select eg:

من مخرجات API يكون الحقل الذي نحتاجه هو حقل Moid، وهذا معرف فريد لهذه المؤسسة في Intersight وسيتم إستخدامه في الخطوة التالية، كما نحتاج إلى الحصول على أي علامات موجودة هناك للخطوة التالية.

3. تحديث علامات المؤسسة باستخدام نقطة نهاية واجهة برمجة التطبيقات (API) ل Organization Patch مقابل MOID الخاص بالمؤسسات. تأكد من إعادة إدخال علامات التمييز الموجودة التي تم تجميعها في حقل النص الأساسي، وإلا فسيتم إزالتها.

نص مكالمة PATCH العينة أعلاه:

{"Tags":[{"Key":"AutoRMAEmail","Value":"joe@somedomain.com"}]}

أي علامات موجودة موجودة على المسجل يمكن إضافتها إلى صفيف علامات التمييز.

يرجى الملاحظة: إذا كنت تتبع هذا الإجراء لتكوين RMA الاستباقي، فيجب ربط عنوان (عناوين) البريد الإلكتروني هنا بحساب CCO.

علامات موارد تسجيل الأجهزة

من خلال واجهة برمجة التطبيقات

1. فتح مستندات واجهة برمجة التطبيقات للأجهزة المسجلة

انتقل إلى صفحة مستند واجهة برمجة التطبيقات للأجهزة المسجلة

إذا كنت تستخدم الجهاز الظاهري المتصل، فيمكنك التنقل إلى https://[FQDN of appliance]/apidocs/apirefs/asset/DeviceRegister/model/instead

2. تحديد الجهاز المسجل الذي يحتاج إلى التحديث

الرجاء مراجعة دليل استعلام Intersight API للرجوع إليه

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

DeviceHostname eq 'F340-21-22-UCS4'

زيادة إستخدام عامل تصفية $و $select كما أننا نرى مخرجا أكثر قابلية للإدارة:

3. أستخدم واجهة برمجة تطبيقات التصحيح لتحديث العلامات

إستخراج أي علامات موجودة بالفعل على الجهاز المسجل وكذلك على مويد الجهاز. الانتقال إلى نقطة نهاية PATCH، الصق في Moid في إدخال Moid الأعلى على سبيل المثال:

نص مكالمة PATCH العينة أعلاه:

{"Tags":[{"Key":"AutoRMAEmail","Value":"joe@somedomain.com"}]}

أي علامات موجودة موجودة على المسجل يمكن إضافتها إلى صفيف علامات التمييز.

يرجى الملاحظة: إذا كنت تتبع هذا الإجراء لتكوين RMA الاستباقي، يلزم تسجيل عنوان (عناوين) البريد الإلكتروني هنا باسم مستخدم/معرف CCO صالح لحساب Cisco.