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

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

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

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

  • Name

  • Description

  • Type

  • Timezone

  • Country

  • State

  • Address

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

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

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

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

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

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

  • باستخدام استعلام entityLookup API (راجع Cato API - EntityLookup)، استخدم type بالقيمة site.

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

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

تفاصيل لـ updateSiteGeneralDetails Arguments

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

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

  • 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"
 }
 }
}

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

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

0 من 0 وجدوا هذا مفيداً

لا توجد تعليقات