تكوين API - تحديث تفاصيل الموقع العام

نوصي بشدة بمراجعة سياسة الدعم لواجهة برمجة التطبيقات من Cato قبل البدء في استخدامها.

نظرة عامة على updateSiteGeneralDetails

استخدم واجهة برمجة التطبيقات updateSiteGeneralDetails لتحديث الإعدادات التالية في قسم عام لموقع في تطبيق الإدارة Cato (الشبكة > المواقع > {اسم الموقع} > تكوين الموقع > عام)

• الاسم

• وصف

• النوع

• Timezone

• الدولة

• State

• عنوان

تحديد الحساب الخاص بك

لا يتم عرض معرف الحساب هذا في تطبيق إدارة Cato، بدلاً من ذلك هو الرقم الموجود في الرابط لـ تطبيق إدارة Cato. على سبيل المثال، معرف الحساب هو 26 للرابط التالي: https://cc.catonetworks.com/#!/26/topology.

أدخل هذا المعرف في الوسيطة accountId لواجهة برمجة التطبيقات لإنشاء الموقع، على سبيل المثال:

site(accountId: 26) {
 addSocketSite(input: $addSocketSite) {
 siteId
 }
 }

تحديد موقع معرف الموقع لموقع

لا يظهر معرف الموقع في تطبيق إدارة Cato، يمكنك تحديد معرف الموقع:

• باستخدام استعلام واجهة برمجة التطبيقات entityLookup (راجع واجهة برمجة التطبيقات Cato - EntityLookup)، استخدم النوع بالقيمة الموقع

  يمكنك أيضًا استخدام معامل search بالقيمة كاسم الموقع، ويعيد الاستعلام معرف الموقع

• الرقم في عنوان URL لتطبيق إدارة Cato، عند اختيارك لموقع (الشبكة > المواقع > {اسم الموقع}). على سبيل المثال، معرف الموقع هو 12345 للرابط التالي: https://cc.catonetworks.com/#/26/sites/12345/networkAnalytics

تفاصيل لـ updateSiteGeneralDetails Arguments

هذه هي الوسائط لتحديث الإعدادات العامة التالية لموقع باستخدام واجهة برمجة تطبيقات تكوين Cato. الوسائط إلزامية ما لم يتم تحديدها كاختيارية:

• الاسم - اسم الموقع

• siteType - نوع الموقع في منظمتك، على سبيل المثال مركز بيانات السحابة

• description - (اختياري) وصف الموقع

• siteLocation - بيانات حول الموقع الفعلي للموقع

updateSiteGeneralDetails Name

تحديث اسم الموقع.

updateSiteGeneralDetails siteType

siteType عبارة عن وسيطة تعداد تحدد نوع الموقع الذي يحدد الرمز المستخدم للموقع في شاشة المراقبة > الطوبولوجيا في تطبيق إدارة Cato.

هذه هي الخيارات:

• BRANCH - مواقع فعلية أو افتراضية

• HEADQUARTERS - مواقع فعلية للمقر الرئيسي للشركة

• CLOUD_DC - مواقع افتراضية لمراكز بيانات مستندة إلى السحابة

• DATACENTER - مواقع فعلية لمراكز البيانات

updateSiteGeneralDetails description (اختياري)

description عبارة عن حقل نصي حر اختياري لوصف الموقع.

updateSiteGeneralDetails siteLocation

وسائط siteLocation تحدد التفاصيل الفعلية التالية للموقع. الرمز countryCode له صلة بعدد تراخيص المواقع المتاحة لمنطقة محددة في حسابك.

يمكنك استخدام استعلام entityLookup API لاسترجاع القيم لهذه الوسائط، راجع Cato API - EntityLookup.

هذه هي وسائط siteLocation:

• countryCode - رمز من حرفين (ISO 3166-1 alpha-2) للدولة التي يقع فيها الموقع

  للبحث عن الكيان، استخدم type بالقيمة country.

• stateCode - (اختياري) للدول المطبقة، الولاية التي يقع فيها الموقع

  للبحث عن الكيان، استخدم type بالقيمة countryState.

• timezone - منطقة زمنية للموقع، تستخدم لتحديد الإطار الزمني لفترة الصيانة لترقيات Socket وvSocket

  للبحث عن الكيان، استخدم type بالقيمة timezone.

• address - (اختياري) عنوان الشارع للموقع الفعلي

نموذج برنامج Postman

mutation updateSiteGeneralDetails ($accountId: ID!, $siteID: ID!, $input: UpdateSiteGeneralDetailsInput!) {
 site(accountId: $accountId) {
 updateSiteGeneralDetails (siteId: $siteID, input: $input) {
 siteId
 }
 }
}

متغيرات GraphQL

{
 "accountId": "",
 "siteID": "",
 "input": {
 "name": "MySite",
 "description": "My first DC using the API",
 "siteType": "DATACENTER",
 "siteLocation": {
 "countryCode": "FR",
 "timezone": "Europe/Paris"
 }
 }
}

المصادر ذات الصلة

• استخدام API لإنشاء موقع كاتو مع Postman

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