العمليات

الحصول على عقد نظام المجموعة

GET /clusters/{cluster}/nodes

البارامترات

نوع	اسم	وصف	مخطط
مسار	نظام مجموعة مطلوب	نظام المجموعة للاستعلام	خيط
استعلام	العملية اختياري	إذا تم منحها، فترجع العقد لمعرف العملية هذا فقط، وتتضمن سمة العملية على النص الأساسي	خيط
استعلام	request_id اختياري	إذا تم منحها، فترجع العقد الخاصة بالعملية المحددة بواسطة معرف الطلب هذا فقط، ويتضمن سمة العملية على النص الأساسي	خيط

الاستجابات

رمز HTTP	وصف	مخطط
200	موافق	NodeList
400	مواصفات غير صحيحة	لا يوجد محتوى
404	غير موجود	لا يوجد محتوى

مثال طلب HTTP

مسار الطلب

/clusters/CLUSTER_NAME/nodes

مثال على استجابة HTTP

الاستجابة 200

{
  "nodes" : [ { } ],
  "operation" : {
    "action" : "string",
    "startTime" : "2020-01-01T12:34:56Z"
  }
}

إنشاء عقد نظام المجموعة

POST /clusters/{cluster}/nodes/create

وصف

تضيف هذه العملية عقدا جديدة من nodearray إلى نظام مجموعة. يقبل تعريفات عقدة متعددة في مكالمة واحدة. يقوم بإرجاع عنوان URL إلى العملية التي يمكن استخدامها لتتبع حالة العملية.

البارامترات

نوع	اسم	وصف	مخطط
مسار	نظام مجموعة مطلوب	نظام المجموعة المراد إضافة العقد إليه	خيط
الجسم	العقد مطلوب	مجموعات العقد التي سيتم إنشاؤها	NodeCreationRequest

الاستجابات

رمز HTTP	وصف	مخطط
202	قبلت عناوين : Location (سلسلة) : عنوان URL للعملية.	NodeCreationResult
409	إدخال غير صحيح	لا يوجد محتوى

مثال طلب HTTP

مسار الطلب

/clusters/CLUSTER_NAME/nodes/create

نص الطلب

{
  "requestId" : "00000000-0000-0000-0000-000000000000",
  "sets" : [ "object" ]
}

مثال على استجابة HTTP

الاستجابة 202

{
  "operationId" : "00000000-0000-0000-0000-000000000000",
  "sets" : [ "object" ]
}

إلغاء تخصيص عقد نظام المجموعة

POST /clusters/{cluster}/nodes/deallocate

وصف

تعمل هذه العملية على إلغاء تخصيص العقد في نظام مجموعة. يمكن تحديد العقد بعدة طرق، بما في ذلك اسم العقدة أو معرف العقدة أو حسب عامل التصفية.

البارامترات

نوع	اسم	وصف	مخطط
مسار	نظام مجموعة مطلوب	نظام المجموعة الذي يجب إلغاء تخصيص العقد فيه	خيط
الجسم	الإجراء مطلوب	وصف العقد التي يجب إلغاء تخصيصها	NodeManagementRequest

الاستجابات

رمز HTTP	وصف	مخطط
202	قبلت عناوين : Location (سلسلة) : عنوان URL للعملية.	NodeManagementResult
409	إدخال غير صحيح	لا يوجد محتوى

مثال طلب HTTP

مسار الطلب

/clusters/CLUSTER_NAME/nodes/deallocate

نص الطلب

{
  "filter" : "State === \"Started\"",
  "hostnames" : [ "hostname1", "hostname2" ],
  "ids" : [ "id1", "id2" ],
  "ip_addresses" : [ "10.0.1.1", "10.1.1.2" ],
  "names" : [ "name1", "name2" ],
  "requestId" : "00000000-0000-0000-0000-000000000000"
}

مثال على استجابة HTTP

الاستجابة 202

{
  "nodes" : [ "object" ],
  "operationId" : "00000000-0000-0000-0000-000000000000"
}

إنهاء عقد نظام المجموعة وإزالتها

POST /clusters/{cluster}/nodes/remove

وصف

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

البارامترات

نوع	اسم	وصف	مخطط
مسار	نظام مجموعة مطلوب	نظام المجموعة لإزالة العقد في	خيط
الجسم	الإجراء مطلوب	وصف العقد التي يجب إزالتها	NodeManagementRequest

الاستجابات

رمز HTTP	وصف	مخطط
202	قبلت عناوين : Location (سلسلة) : عنوان URL للعملية.	NodeManagementResult
409	إدخال غير صحيح	لا يوجد محتوى

مثال طلب HTTP

مسار الطلب

/clusters/CLUSTER_NAME/nodes/remove

نص الطلب

{
  "filter" : "State === \"Started\"",
  "hostnames" : [ "hostname1", "hostname2" ],
  "ids" : [ "id1", "id2" ],
  "ip_addresses" : [ "10.0.1.1", "10.1.1.2" ],
  "names" : [ "name1", "name2" ],
  "requestId" : "00000000-0000-0000-0000-000000000000"
}

مثال على استجابة HTTP

الاستجابة 202

{
  "nodes" : [ "object" ],
  "operationId" : "00000000-0000-0000-0000-000000000000"
}

إنهاء عقد نظام المجموعة أو إلغاء تخصيصها

POST /clusters/{cluster}/nodes/shutdown

وصف

تقوم هذه العملية بإنهاء العقد أو إلغاء تخصيصها في نظام مجموعة، اعتمادا على ما إذا كانت سمة ShutdownPolicy على كل عقدة هي Terminate (الافتراضي) أو Deallocate، على التوالي.

البارامترات

نوع	اسم	وصف	مخطط
مسار	نظام مجموعة مطلوب	نظام المجموعة لإيقاف تشغيل العقد في	خيط
الجسم	الإجراء مطلوب	وصف العقد التي يجب إيقاف تشغيلها	NodeManagementRequest

الاستجابات

رمز HTTP	وصف	مخطط
202	قبلت عناوين : Location (سلسلة) : عنوان URL للعملية.	NodeManagementResult
409	إدخال غير صحيح	لا يوجد محتوى

مثال طلب HTTP

مسار الطلب

/clusters/CLUSTER_NAME/nodes/shutdown

نص الطلب

{
  "filter" : "State === \"Started\"",
  "hostnames" : [ "hostname1", "hostname2" ],
  "ids" : [ "id1", "id2" ],
  "ip_addresses" : [ "10.0.1.1", "10.1.1.2" ],
  "names" : [ "name1", "name2" ],
  "requestId" : "00000000-0000-0000-0000-000000000000"
}

مثال على استجابة HTTP

الاستجابة 202

{
  "nodes" : [ "object" ],
  "operationId" : "00000000-0000-0000-0000-000000000000"
}

بدء عقد نظام المجموعة التي تم إلغاء تخصيصها أو إنهاؤها

POST /clusters/{cluster}/nodes/start

وصف

تبدأ هذه العملية العقد في نظام مجموعة. يمكن تحديد العقد بعدة طرق، بما في ذلك اسم العقدة أو معرف العقدة أو حسب عامل التصفية.

البارامترات

نوع	اسم	وصف	مخطط
مسار	نظام مجموعة مطلوب	نظام المجموعة لبدء العقد في	خيط
الجسم	الإجراء مطلوب	وصف العقد التي يجب بدء تشغيلها	NodeManagementRequest

الاستجابات

رمز HTTP	وصف	مخطط
202	قبلت عناوين : Location (سلسلة) : عنوان URL للعملية.	NodeManagementResult
409	إدخال غير صحيح	لا يوجد محتوى

مثال طلب HTTP

مسار الطلب

/clusters/CLUSTER_NAME/nodes/start

نص الطلب

{
  "filter" : "State === \"Started\"",
  "hostnames" : [ "hostname1", "hostname2" ],
  "ids" : [ "id1", "id2" ],
  "ip_addresses" : [ "10.0.1.1", "10.1.1.2" ],
  "names" : [ "name1", "name2" ],
  "requestId" : "00000000-0000-0000-0000-000000000000"
}

مثال على استجابة HTTP

الاستجابة 202

{
  "nodes" : [ "object" ],
  "operationId" : "00000000-0000-0000-0000-000000000000"
}

إنهاء عقد نظام المجموعة

POST /clusters/{cluster}/nodes/terminate

وصف

تنهي هذه العملية العقد في نظام مجموعة. يمكن تحديد العقد بعدة طرق، بما في ذلك اسم العقدة أو معرف العقدة أو حسب عامل التصفية.

البارامترات

نوع	اسم	وصف	مخطط
مسار	نظام مجموعة مطلوب	نظام المجموعة لإنهاء العقد في	خيط
الجسم	الإجراء مطلوب	وصف العقد التي يجب إنهائها	NodeManagementRequest

الاستجابات

رمز HTTP	وصف	مخطط
202	قبلت عناوين : Location (سلسلة) : عنوان URL للعملية.	NodeManagementResult
409	إدخال غير صحيح	لا يوجد محتوى

مثال طلب HTTP

مسار الطلب

/clusters/CLUSTER_NAME/nodes/terminate

نص الطلب

{
  "filter" : "State === \"Started\"",
  "hostnames" : [ "hostname1", "hostname2" ],
  "ids" : [ "id1", "id2" ],
  "ip_addresses" : [ "10.0.1.1", "10.1.1.2" ],
  "names" : [ "name1", "name2" ],
  "requestId" : "00000000-0000-0000-0000-000000000000"
}

مثال على استجابة HTTP

الاستجابة 202

{
  "nodes" : [ "object" ],
  "operationId" : "00000000-0000-0000-0000-000000000000"
}

تحجيم نظام المجموعة إلى الحجم

POST /clusters/{cluster}/scale/{nodearray}

وصف

تضيف هذه العملية العقد حسب الحاجة إلى nodearray لتصل إلى العدد الإجمالي. تتم معالجة الطلب مرة واحدة، ولا يعيد إضافة العقد لاحقا للحفاظ على الرقم المحدد. يتوسع هذا إما حسب إجمالي الذاكرات الأساسية أو إجمالي العقد، ولكن ليس كليهما. يقوم بإرجاع عنوان URL إلى العملية التي يمكن استخدامها لتتبع حالة العملية.

البارامترات

نوع	اسم	وصف	مخطط
مسار	نظام مجموعة مطلوب	نظام المجموعة المراد إضافة العقد إليه	خيط
مسار	nodearray مطلوب	nodearray لإضافة عقد إلى	خيط
استعلام	totalCoreCount اختياري	العدد الإجمالي للذاكرات الأساسية في nodearray هذا، بما في ذلك العقد التي تم إنشاؤها بالفعل	العدد الصحيح
استعلام	totalNodeCount اختياري	العدد الإجمالي للأجهزة التي يجب أن يكون لها في nodearray هذا، بما في ذلك العقد التي تم إنشاؤها بالفعل	العدد الصحيح

الاستجابات

رمز HTTP	وصف	مخطط
202	قبلت عناوين : Location (سلسلة) : عنوان URL للعملية.	NodeCreationResult
409	إدخال غير صحيح	لا يوجد محتوى

مثال طلب HTTP

مسار الطلب

/clusters/CLUSTER_NAME/scale/NODEARRAY_NAME

مثال على استجابة HTTP

الاستجابة 202

{
  "operationId" : "00000000-0000-0000-0000-000000000000",
  "sets" : [ "object" ]
}

الحصول على حالة نظام المجموعة

GET /clusters/{cluster}/status

وصف

تحتوي هذه العملية على معلومات للعقد وnodearrays في مجموعة معينة. لكل nodearray، فإنه يرجع حالة كل "مستودع" من التخصيص الذي يمكن استخدامه، مثل عدد العقد الموجودة في المستودع، وعدد العقد الأخرى التي يمكن إضافتها، وما إلى ذلك. كل مستودع هو مجموعة من الأجهزة الظاهرية المحتملة لملف تعريف جهاز معين، والتي يمكن إنشاؤها في موقع معين، ضمن حساب عميل معين، وما إلى ذلك. يتم تحديد المستودعات الصالحة ل nodearray بواسطة تعريف نظام مجموعة المستخدم، ولكن يتم تحديد الحدود جزئيا من قبل موفر السحابة.

البارامترات

نوع	اسم	وصف	مخطط
مسار	نظام مجموعة مطلوب	نظام المجموعة للاستعلام	خيط
استعلام	العقد اختياري	إذا كان صحيحا، يتم إرجاع العقد ومراجع العقدة في الاستجابة	منطقيه

الاستجابات

رمز HTTP	وصف	مخطط
200	موافق	ClusterStatus

مثال طلب HTTP

مسار الطلب

/clusters/CLUSTER_NAME/status

مثال على استجابة HTTP

الاستجابة 200

{
  "maxCoreCount" : 16,
  "maxCount" : 4,
  "nodearrays" : [ "object" ],
  "nodes" : [ { } ],
  "state" : "Starting",
  "targetState" : "Started"
}

الحصول على معلومات الاستخدام والتكلفة الاختيارية لنظام مجموعة

GET /clusters/{cluster}/usage

وصف

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

البارامترات

نوع	اسم	وصف	مخطط
مسار	نظام مجموعة مطلوب	نظام المجموعة لإرجاع بيانات الاستخدام ل	خيط
استعلام	الإطار الزمني اختياري	إذا تم تعيينه، فهذا يحدد النطاق الزمني لاستخدامه للاستعلام. يقوم monthToDate بإرجاع الاستخدام للشهر الحالي، ويرجع lastMonth الاستخدام للشهر السابق. ترجع weekToDate الاستخدام للأسبوع الحالي (بدءا من الأحد). يتطلب مخصص معلمات الاستعلام "من" و"إلى". الإعداد الافتراضي هو MonthToDate. جميع الأوقات بالتوقيت العالمي المتفق عليه.	قائمة تعداد (monthToDate, lastMonth, weekToDate, custom)
استعلام	من اختياري	بالنسبة إلى الإطارات الزمنية المخصصة، هذا هو بداية الإطار الزمني بتنسيق ISO-8601. يتم تقريب هذا إلى أقرب ساعة أو يوم.	خيط
استعلام	إلى اختياري	بالنسبة إلى الإطارات الزمنية المخصصة، هذه هي نهاية الإطار الزمني بتنسيق ISO-8601. يتم تقريب هذا إلى أقرب ساعة أو يوم.	خيط
استعلام	نقاوة اختياري	تحديد كيفية تجميع البيانات: بالساعة أو يوميا أو كعدد واحد. هذا الافتراضي يوميا.	قائمة تعداد (الإجمالي، يوميا، كل ساعة)

الاستجابات

رمز HTTP	وصف	مخطط
200	موافق	استخدام نظام المجموعة

مثال طلب HTTP

مسار الطلب

/clusters/CLUSTER_NAME/usage

مثال على استجابة HTTP

الاستجابة 200

{
  "usage" : [ "object" ]
}

يسرد حالة العمليات

GET /operations/

البارامترات

نوع	اسم	وصف	مخطط
استعلام	request_id اختياري	معرف الطلب للعملية. إذا تم تقديم هذا، فسيكون للقائمة عنصر 0 أو 1 فقط.	خيط

الاستجابات

رمز HTTP	وصف	مخطط
200	موافق	صفيف OperationStatus
400	طلب غير صالح	لا يوجد محتوى
404	غير موجود	لا يوجد محتوى

مثال طلب HTTP

مسار الطلب

/operations/

مثال على استجابة HTTP

الاستجابة 200

[ {
  "action" : "string",
  "startTime" : "2020-01-01T12:34:56Z"
} ]

الحصول على حالة العملية حسب المعرف

GET /operations/{id}

البارامترات

نوع	اسم	وصف	مخطط
مسار	معرف مطلوب	معرف العملية	خيط

الاستجابات

رمز HTTP	وصف	مخطط
200	موافق	OperationStatus
404	غير موجود	لا يوجد محتوى

مثال طلب HTTP

مسار الطلب

/operations/00000000-0000-0000-0000-000000000000

مثال على استجابة HTTP

الاستجابة 200

{
  "action" : "string",
  "startTime" : "2020-01-01T12:34:56Z"
}

موارد

نظام مجموعة نظام المجموعة

حالة نظام المجموعة

اسم	وصف	مخطط
maxCoreCount مطلوب	الحد الأقصى لعدد الذاكرات الأساسية التي يمكن إضافتها إلى نظام المجموعة هذا المثال :	العدد الصحيح
maxCount مطلوب	الحد الأقصى لعدد العقد التي يمكن إضافتها إلى نظام المجموعة هذا المثال :	العدد الصحيح
nodearrays مطلوب	المثال :	صفيف nodearrays
العقد اختياري	قائمة اختيارية بالعقد في نظام المجموعة هذا، مضمنة فقط إذا كانت العقد =true في الاستعلام المثال :	صفيف عقدة
حالة اختياري	الحالة الحالية للمجموعة، إذا تم تشغيلها مرة واحدة على الأقل المثال :	خيط
targetState اختياري	الحالة المطلوبة للمجموعة (على سبيل المثال تم البدء أو الإنهاء) المثال :	خيط

nodearrays

اسم	وصف	مخطط
مستودعات مطلوب	كل مستودع تخصيص لهذا nodearray. دائما ما تكون إعدادات "عدد الذاكرة الأساسية" متعددة من العدد الأساسي لهذا المستودع. المثال :	< المستودعات> الصفيف
maxCoreCount مطلوب	الحد الأقصى لعدد الذاكرات الأساسية التي قد تكون في nodearray المثال :	العدد الصحيح
maxCount مطلوب	الحد الأقصى لعدد العقد التي قد تكون في nodearray المثال :	العدد الصحيح
اسم مطلوب	nodearray الذي يصفه هذا المثال :	خيط
nodearray مطلوب	سمات nodearray هذا المثال :	عقدة

مستودعات

اسم	وصف	مخطط
activeCoreCount مطلوب	عدد الذاكرات الأساسية المستخدمة لهذا المستودع، في nodearray هذا المثال :	العدد الصحيح
activeCount مطلوب	عدد العقد المستخدمة لهذا المستودع، في nodearray هذا. يتضمن ذلك العقد التي لا تزال تحصل على جهاز ظاهري. المثال :	العدد الصحيح
activeNodes اختياري	أسماء العقد المستخدمة لهذا المستودع، في nodearray هذا. يتضمن ذلك العقد التي لا تزال تحصل على جهاز ظاهري. يتم تضمين هذا فقط إذا كانت العقد =true في الاستعلام. المثال :	مصفوفة > سلسلة <
المتوفرةCoreCount مطلوب	كم عدد الذاكرات الأساسية الإضافية التي يمكن إنشاؤها في هذا المستودع، في nodearray هذا. دائما مضاعف من عدد المتوفرة. المثال :	العدد الصحيح
المتوفرة مطلوب	كم عدد العقد الإضافية التي يمكن إنشاؤها في هذا المستودع، في nodearray هذا. لاحظ أن هذا قد يكون أقل مما هو ضمني من قبل maxCount وcount المستخدم، نظرا لأن maxCount قد يكون محدودا عالميا. المثال :	العدد الصحيح
معرف مستودع مطلوب	معرف هذا المستودع. سيكون لهذا دائما نفس القيمة لمستودع معين في nodearray، طالما لم يتم حذف نظام المجموعة. المثال :	خيط
المستهلكةCoreCount مطلوب	عدد الذاكرات الأساسية لهذه العائلة المستخدمة بالفعل في جميع أنحاء المنطقة بأكملها. المثال :	العدد الصحيح
تعريف اختياري	خصائص هذا المستودع، المستخدمة لإنشاء عقد من هذا المستودع. تأخذ واجهة برمجة تطبيقات إنشاء العقد هذا التعريف في الخاصية bucket الخاصة بها. المثال :	تعريف
familyConsumedCoreCount اختياري	عدد الذاكرات الأساسية لهذه العائلة المستخدمة بالفعل في جميع أنحاء المنطقة بأكملها. المثال :	العدد الصحيح
familyQuotaCoreCount اختياري	عدد الذاكرات الأساسية الإجمالية التي يمكن بدء تشغيلها لهذه العائلة في هذه المنطقة. قد لا يكون هذا مضاعف عدد صحيح من quotaCount. المثال :	العدد الصحيح
familyQuotaCount اختياري	عدد المثيلات الإجمالية التي يمكن بدء تشغيلها (نظرا إلى familyQuotaCoreCount) المثال :	العدد الصحيح
invalidReason مطلوب	إذا كان صالحا غير صحيح، فسيحتوي هذا على سبب أن المستودع غير صالح. حاليا NotActivated و DisabledMachineType هما السببان الوحيدان. المثال :	خيط
lastCapacityFailure مطلوب	كم من الوقت، بالثوان، منذ آخر مرة واجه هذا المستودع فشلا في السعة. يتم التعامل مع أي قيمة سالبة على أنها أبدا. المثال :	رقم
maxCoreCount مطلوب	الحد الأقصى لعدد الذاكرات الأساسية التي قد تكون في هذا المستودع، بما في ذلك الحدود العمومية وحدود nodearray. دائما مضاعف maxCount. المثال :	العدد الصحيح
maxCount مطلوب	الحد الأقصى لعدد العقد التي قد تكون في هذا المستودع، بما في ذلك الحدود العمومية وحدود nodearray المثال :	العدد الصحيح
maxPlacementGroupCoreSize مطلوب	الحد الأقصى لإجمالي عدد الذاكرات الأساسية التي يمكن أن تكون في مجموعة موضع في هذا المستودع. دائما مضاعف maxPlacementGroupSize. المثال :	العدد الصحيح
maxPlacementGroupSize مطلوب	الحد الأقصى لإجمالي عدد المثيلات التي يمكن أن تكون في مجموعة موضع في هذا المستودع المثال :	العدد الصحيح
placementGroups مطلوب	مجموعات المواضع المستخدمة لهذا nodearray، إن وجدت. المثال :	< مجموعة المواضع> الصفيف
الحصة النسبية CoreCount مطلوب	عدد الذاكرات الأساسية الإجمالية التي يمكن البدء بها لهذه العائلة في هذه المنطقة، مع مراعاة العدد الأساسي للحصص الإقليمية أيضا. قد لا يكون هذا مضاعف عدد صحيح من quotaCount. المثال :	العدد الصحيح
الحصة النسبية مطلوب	عدد المثيلات الإجمالية التي يمكن بدء تشغيلها (معين quotaCoreCount) المثال :	العدد الصحيح
RegionalConsumedCoreCount اختياري	عدد الذاكرات الأساسية المستخدمة بالفعل عبر المنطقة بأكملها. المثال :	العدد الصحيح
الإقليميةQuotaCoreCount اختياري	عدد الذاكرات الأساسية الإجمالية التي يمكن بدء تشغيلها في هذه المنطقة. قد لا يكون هذا مضاعف عدد صحيح ل regionalQuotaCount. المثال :	العدد الصحيح
الإقليمية لCootaCount اختياري	عدد المثيلات الإجمالية التي يمكن بدء تشغيلها (بالنظر إلى regionalQuotaCoreCount) المثال :	العدد الصحيح
صالح مطلوب	إذا كان صحيحا، يمثل هذا المستودع مستودعا صالحا حاليا لاستخدامه للعقد الجديدة. إذا كانت خاطئة، فإن هذا المستودع يمثل العقد الموجودة فقط. المثال :	منطقيه
الجهاز الظاهري مطلوب	خصائص الأجهزة الظاهرية التي تم تشغيلها من هذا المستودع المثال :	الجهاز الظاهري

تعريف

اسم	وصف	مخطط
نوع الجهاز مطلوب	حجم الجهاز الظاهري للجهاز الظاهري المثال :	خيط

placementGroups

اسم	وصف	مخطط
activeCoreCount مطلوب	كم عدد الذاكرات الأساسية في مجموعة التحجيم هذه المثال :	العدد الصحيح
activeCount مطلوب	عدد العقد الموجودة في مجموعة المقياس هذه المثال :	العدد الصحيح
اسم مطلوب	المعرف الفريد لمجموعة المواضع هذه المثال :	خيط

الجهاز الظاهري

اسم	وصف	مخطط
gpuCount مطلوب	عدد وحدات معالجة الرسومات (GPUs) التي يحتويها هذا النوع من الأجهزة المثال :	العدد الصحيح
infiniband مطلوب	إذا كان هذا الجهاز الظاهري يدعم اتصال InfiniBand المثال :	منطقيه
الذاكرة مطلوب	ذاكرة الوصول العشوائي في هذا الجهاز الظاهري، بالجيجابايت المثال :	رقم
pcpuCount مطلوب	عدد وحدات المعالجة المركزية الفعلية لهذا النوع من الأجهزة المثال :	العدد الصحيح
vcpuCount مطلوب	عدد وحدات المعالجة المركزية الظاهرية التي يحتويها هذا النوع من الأجهزة المثال :	العدد الصحيح
vcpuQuotaCount اختياري	عدد وحدات المعالجة المركزية الظاهرية التي يستخدمها هذا الجهاز من الحصة النسبية المثال :	العدد الصحيح

استخدام نظام المجموعة

معلومات الاستخدام والتكلفة الاختيارية للمجموعة

اسم	وصف	مخطط
استخدام مطلوب	قائمة بالاستخدامات حسب الفاصل الزمني المثال :	صفيف استخدام

استخدام

اسم	وصف	مخطط
تقسيم مطلوب	تصنيف الاستخدام في هذا الفاصل الزمني، حسب فئة "العقدة" و"nodearray" المثال :	صفيف clusterUsageItem
نهاية مطلوب	نهاية الفاصل الزمني (خاص) المثال :	خيط
بدء مطلوب	بداية الفاصل الزمني (شامل) المثال :	خيط
إجمالي مطلوب	الاستخدام الإجمالي لهذه المجموعة في هذا الفاصل الزمني، مع فئة "نظام المجموعة" المثال :	ClusterUsageItem

ClusterUsageItem

اسم	وصف	مخطط
فئة مطلوب	"نظام المجموعة" للاستخدام الكلي؛ "عقدة" لعقدة رأس واحدة غير صفيف؛ "nodearray" ل nodearray بأكمله المثال :	تعداد (نظام المجموعة، العقدة، nodearray)
التكلفة اختياري	المبلغ الذي سيتم تحصيله مقابل هذا الاستخدام بالدولار الأمريكي وأسعار التجزئة. ملاحظة: جميع مبالغ التكلفة هي تقديرات ولا تعكس الفاتورة الفعلية! المثال :	رقم
تفاصيل اختياري	تفاصيل حجم الجهاز الظاهري المستخدمة من قبل nodearray بما في ذلك ساعات core_count وأولوية المنطقة ونظام التشغيل. المثال :	صفيف تفاصيل
ساعات مطلوب	عدد ساعات الاستخدام الأساسية لهذه الفئة المثال :	رقم
عقدة اختياري	اسم العقدة أو nodearray الذي يستخدمه (غير موجود للبيانات على مستوى نظام المجموعة) المثال :	خيط

تفاصيل

اسم	وصف	مخطط
core_count اختياري	عدد الذاكرات الأساسية في حجم الجهاز الظاهري هذا المثال :	رقم
التكلفة اختياري	تكلفة حجم الجهاز الظاهري هذا المثال :	رقم
ساعات اختياري	عدد ساعات الاستخدام الأساسية لحجم الجهاز الظاهري هذا المثال :	رقم
نظام التشغيل اختياري	نوع نظام التشغيل المثال :	قائمة تعداد (Windows، Linux)
الأولوية اختياري	أولوية VM Sku المثال :	قائمة تعداد (عادية، موضعية)
منطقة اختياري	المنطقة التي يتم إنشاء مثيل لحجم الجهاز الظاهري فيها المثال :	خيط
vm_size اختياري	حجم وحدة Sku للجهاز الظاهري المثال :	خيط

كعب

سجل عقدة

نوع : كائن

طلب إنشاء العقدة

تحديد كيفية إضافة عقد إلى نظام مجموعة

اسم	وصف	مخطط
requestId اختياري	رمز مميز فريد اختياري يوفره المستخدم لمنع العمليات المكررة في حالة حدوث أخطاء في اتصال الشبكة. إذا كان هذا مضمنا ويطابق معرف طلب سابق، يتجاهل الخادم هذا الطلب ويرجع خطأ 409. المثال :	خيط
مجموعات مطلوب	قائمة تعريفات العقدة المراد إنشاؤها. يجب أن يحتوي الطلب على مجموعة واحدة على الأقل. يمكن لكل مجموعة تحديد مجموعة مختلفة من الخصائص. المثال :	مجموعة <> الصفيف

مجموعات

اسم	وصف	مخطط
عدد مطلوب	عدد العقد المراد إنشاؤها المثال :	العدد الصحيح
تعريف اختياري	تعريف المستودع المراد استخدامه. يتم توفير ذلك بواسطة استدعاء API لحالة نظام المجموعة. إذا كانت بعض العناصر المحددة في استدعاء الحالة مفقودة، أو كانت خاصية المستودع بأكملها مفقودة، يتم استخدام المستودع الأول الذي يطابق العناصر المحددة. المثال :	تعريف
اسم تنسيق اختياري	إذا تم منحها، ستستخدم العقد اصطلاح التسمية هذا بدلا من تنسيق "nodearray-%d" القياسي المثال :	خيط
اسم Offset اختياري	إذا تم منحها، جنبا إلى جنب مع nameFormat، تعوض nodeindex للعقد الجديدة. المثال :	العدد الصحيح
nodeAttributes اختياري	السمات الإضافية التي سيتم تعيينها على كل عقدة من هذه المجموعة المثال :	عقدة
nodearray مطلوب	اسم nodearray لبدء العقد من المثال :	خيط
placementGroupId اختياري	إذا تم منحها، فستبدأ العقد التي لها نفس القيمة ل groupId في نفس مجموعة الموضع. المثال :	خيط

تعريف

اسم	وصف	مخطط
نوع الجهاز اختياري	المثال :	خيط

NodeCreationResult

اسم	وصف	مخطط
operationId مطلوب	معرف هذه العملية المثال :	خيط
مجموعات مطلوب	صفيف من المجموعات، بالترتيب نفسه كما في الطلب المثال :	مجموعة <> الصفيف

مجموعات

اسم	وصف	مخطط
تمت إضافة مطلوب	عدد العقد التي تم بدء تشغيلها في هذه المجموعة المثال :	العدد الصحيح
رسالة اختياري	يشير إلى سبب عدم إمكانية إضافة جميع العقد المطلوبة، إذا كانت موجودة المثال :	خيط

قائمة العقدة

نتائج بحث العقدة

اسم	وصف	مخطط
العقد مطلوب	العقد التي تم إرجاعها المثال :	صفيف عقدة
العملية اختياري	إذا كان الاستعلام يتضمن معرف عملية، فهذه هي حالة تلك العملية المثال :	OperationStatus

طلب إدارة العقدة

تحديد كيفية تنفيذ الإجراءات على العقد في نظام مجموعة. هناك طرق متعددة لتحديد العقد، وإذا تم تضمين أكثر من طريقة واحدة، يتم التعامل معها على أنها اتحاد.

اسم	وصف	مخطط
عامل تصفية اختياري	تعبير عامل تصفية يطابق العقد. لاحظ أنه يجب اقتباس السلاسل في التعبير بشكل صحيح. المثال :	خيط
أسماء المضيفين اختياري	قائمة بأسماء المضيفين القصيرة (بدون مجال) لإدارتها المثال :	مصفوفة > سلسلة <
معرفات اختياري	قائمة معرفات العقدة المراد إدارتها المثال :	مصفوفة > سلسلة <
ip_addresses اختياري	قائمة بعناوين IP لإدارتها المثال :	مصفوفة > سلسلة <
أسماء اختياري	قائمة بأسماء العقد المراد إدارتها المثال :	مصفوفة > سلسلة <
requestId اختياري	رمز مميز فريد اختياري يوفره المستخدم لمنع العمليات المكررة في حالة حدوث أخطاء في اتصال الشبكة. إذا كان هذا مضمنا ويطابق معرف طلب سابق، يتجاهل الخادم هذا الطلب ويرجع خطأ 409. المثال :	خيط

NodeManagementResult

اسم	وصف	مخطط
العقد مطلوب	صفيف من المعلومات حول كل عقدة تطابق عامل التصفية في طلب الإدارة. تشير حالة كل عقدة إلى ما إذا كانت قد تأثرت بالطلب. المثال :	< العقد> الصفيف
operationId مطلوب	معرف هذه العملية المثال :	خيط

العقد

اسم	وصف	مخطط
الخطأ اختياري	إذا كانت الحالة خطأ، فهذا يحتوي على رسالة الخطأ المثال :	خيط
معرف مطلوب	معرف العقدة المثال :	خيط
اسم مطلوب	اسم العقدة المثال :	خيط
حالة اختياري	واحد من موافق أو خطأ المثال :	قائمة تعداد (موافق، خطأ)

حالة العمليات

حالة عملية العقدة هذه

اسم	وصف	مخطط
الإجراء مطلوب	المثال :	قائمة تعداد (إنشاء)
وقت البدء مطلوب	عند إرسال هذه العملية المثال :	سلسلة (التاريخ والوقت)