--- title: "تكوين API - تحديث تفاصيل الموقع العام" slug: "configuration-api-updatesitegeneraldetails" updated: 2026-07-30T02:30:50Z published: 2026-07-30T02:30:50Z canonical: "knowledge.catonetworks.com/configuration-api-updatesitegeneraldetails" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # تكوين API - تحديث تفاصيل الموقع العام نوصي بشدة بمراجعة [سياسة الدعم لواجهة برمجة التطبيقات من Cato](/v1/docs/support-policy-for-the-cato-api) قبل البدء في استخدامها. ## نظرة عامة على updateSiteGeneralDetails استخدم واجهة برمجة التطبيقات updateSiteGeneralDetails لتحديث الإعدادات التالية في قسم **عام** لموقع في تطبيق الإدارة Cato (الشبكة > المواقع > {اسم الموقع} > تكوين الموقع > عام) - الاسم - وصف - النوع - Timezone - الدولة - State - عنوان ### تحديد الحساب الخاص بك لا يتم عرض معرف الحساب هذا في تطبيق إدارة Cato، بدلاً من ذلك هو الرقم الموجود في الرابط لـ تطبيق إدارة Cato. على سبيل المثال، معرف الحساب هو 26 للرابط التالي: https://cc.catonetworks.com/#!/26/topology. أدخل هذا المعرف في الوسيطة `accountId` لواجهة برمجة التطبيقات لإنشاء الموقع، على سبيل المثال: ```plaintext site(accountId: 26) { addSocketSite(input: $addSocketSite) { siteId } } ``` ### تحديد موقع معرف الموقع لموقع لا يظهر معرف الموقع في تطبيق إدارة Cato، يمكنك تحديد معرف الموقع: - باستخدام استعلام واجهة برمجة التطبيقات entityLookup (راجع [واجهة برمجة التطبيقات Cato - EntityLookup](/v1/docs/cato-api-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](/v1/docs/cato-api-entitylookup). هذه هي وسائط `siteLocation`: - countryCode - رمز من حرفين (ISO 3166-1 alpha-2) للدولة التي يقع فيها الموقع للبحث عن الكيان، استخدم `type` بالقيمة **country**. - stateCode - (اختياري) للدول المطبقة، الولاية التي يقع فيها الموقع للبحث عن الكيان، استخدم `type` بالقيمة **countryState**. - timezone - منطقة زمنية للموقع، تستخدم لتحديد الإطار الزمني لفترة الصيانة لترقيات Socket وvSocket للبحث عن الكيان، استخدم `type` بالقيمة **timezone**. - address - (اختياري) عنوان الشارع للموقع الفعلي ## نموذج برنامج Postman ```plaintext mutation updateSiteGeneralDetails ($accountId: ID!, $siteID: ID!, $input: UpdateSiteGeneralDetailsInput!) { site(accountId: $accountId) { updateSiteGeneralDetails (siteId: $siteID, input: $input) { siteId } } } ``` **متغيرات GraphQL** ```plaintext { "accountId": "", "siteID": "", "input": { "name": "MySite", "description": "My first DC using the API", "siteType": "DATACENTER", "siteLocation": { "countryCode": "FR", "timezone": "Europe/Paris" } } } ``` **المصادر ذات الصلة** - [استخدام API لإنشاء موقع كاتو مع Postman](/v1/docs/using-the-cato-site-creation-api-with-postman) - [برامج واجهة برمجة التطبيقات للتكوين](https://support.catonetworks.com/hc/en-us/articles/8130916998429)