تحسينات Healthcheck

بيانات التعريف الإثرائية لمخططات healthcheck. راجع امتدادات OpenAPI للاطلاع على تعريفات الامتدادات.

المخططات المُثرَاة

النمط

تتلقى جميع المخططات المطابقة لـ healthcheck.*SpecType إثراءات:

healthcheckCreateSpecType
healthcheckReplaceSpecType
healthcheckGetSpecType

بالإضافة إلى ذلك، يحتوي المخطط المتداخل healthcheckHttpHealthCheck على إثراءات لتهيئة فحص الصحة عبر HTTP.

القيم الافتراضية المُطبَّقة من الخادم

الحقول المُعلَّمة بـ x-f5xc-server-default: true يتم تطبيق قيمتها الافتراضية default بواسطة خادم F5 XC API عند حذفها من الطلبات.

الحقول على المستوى الأعلى

الحقل	القيمة الافتراضية	النوع	الوصف
`jitter`	`0`	integer	قيمة jitter المطلقة لعشوائية التوقيت
`jitter_percent`	`0`	integer	نسبة jitter المئوية لعشوائية التوقيت

مخطط healthcheckHttpHealthCheck

الحقل	القيمة الافتراضية	النوع	الوصف
`use_origin_server_name`	`{}`	object	اسم خادم المصدر لترويسة Host
`headers`	`{}`	object	ترويسات مخصصة
`request_headers_to_remove`	`[]`	array	الترويسات المراد حذفها من الطلبات
`use_http2`	`false`	boolean	دعم HTTP/2
`expected_status_codes`	`[]`	array	رموز الحالة المقبولة (فارغة = 200-299)

القيم الموصى بها

الحقول المُعلَّمة بـ x-f5xc-recommended-value تشير إلى القيم التي تُعبئها وحدة تحكم F5 XC مسبقاً عند إنشاء موارد جديدة.

الحقول على المستوى الأعلى

الحقل	القيمة الموصى بها	النوع	الوصف
`timeout`	`3`	integer	مهلة فحص الصحة بالثواني
`interval`	`15`	integer	الفاصل الزمني بين فحوصات الصحة بالثواني
`unhealthy_threshold`	`1`	integer	الإخفاقات المتتالية قبل التعليم بأنه غير صحي
`healthy_threshold`	`3`	integer	النجاحات المتتالية قبل التعليم بأنه صحي
`jitter_percent`	`30`	integer	نسبة jitter للاستخدام في الإنتاج

مخطط healthcheckHttpHealthCheck

الحقل	القيمة الموصى بها	النوع	الوصف
`path`	`"/"`	string	مسار نقطة نهاية فحص الصحة
`use_http2`	`false`	boolean	إعداد دعم HTTP/2
`expected_status_codes`	`["200"]`	array	رموز الحالة التي تشير إلى خادم المصدر السليم
`use_origin_server_name`	`{}`	object	اسم خادم المصدر لترويسة Host

توصيات متغيرات OneOf

تتضمن المخططات التي تحتوي على مجموعات حقول متنافية (OneOf) الامتداد x-f5xc-recommended-oneof-variant للإشارة إلى المتغير الأكثر استخداماً. تُحدد هذه البيانات الوصفية الاختيار النموذجي عند وجود خيارات متعددة، استناداً إلى الإعدادات الافتراضية لوحدة تحكم F5 XC وأنماط الاستخدام الشائعة.

مجموعات OneOf على المستوى الأعلى

المخطط	مجموعة OneOf	المتغير الموصى به	الوصف
`healthcheckCreateSpecType`	`health_check`	`http_health_check`	نوع فحص الصحة عبر HTTP
`healthcheckReplaceSpecType`	`health_check`	`http_health_check`	نوع فحص الصحة عبر HTTP

مجموعات OneOf لـ healthcheckHttpHealthCheck

المخطط	مجموعة OneOf	المتغير الموصى به	الوصف
`healthcheckHttpHealthCheck`	`host_header_choice`	`use_origin_server_name`	ترويسة Host لطلبات فحص الصحة

اختيار ترويسة Host

تتحكم مجموعة OneOf الخاصة بـ host_header_choice في كيفية تحديد ترويسة Host في طلبات HTTP لفحص الصحة.

المتغير	النوع	الوصف
`use_origin_server_name`	`object` (فارغ)	استخدام اسم خادم المصدر كترويسة Host. هذا هو الاختيار الافتراضي في وحدة تحكم F5 XC.
`host_header`	`string`	تحديد قيمة مخصصة لترويسة Host في طلبات فحص الصحة.

مرجع مخطط API: x-ves-oneof-field-host_header_choice: ["host_header", "use_origin_server_name"]

مرجع امتدادات OpenAPI

تُضاف هذه الامتدادات الخاصة بالمورد إلى مخطط OpenAPI القياسي لنقل سلوك الإعدادات الافتراضية الخاصة بـ F5 XC.

x-f5xc-server-default

النوع: boolean

عند كونه true، يشير إلى أن القيمة الافتراضية default المرافقة مُطبَّقة بواسطة خادم F5 XC API. يمكن حذف الحقول التي تحمل هذا الامتداد من طلبات API بأمان—يطبق الخادم القيمة الافتراضية تلقائياً.

use_http2:
  type: boolean
  default: false
  x-f5xc-server-default: true

x-f5xc-recommended-value

النوع: any (يطابق نوع الحقل)

يحدد قيمة تستخدمها وحدة تحكم F5 XC على الويب كإعداد افتراضي مُعبأ مسبقاً. هذه القيمة غير مُفرَضة من الخادم، لكنها تمثل التهيئة النموذجية الابتدائية للموارد الجديدة المنشأة عبر وحدة التحكم.

timeout:
  type: integer
  x-f5xc-recommended-value: 3

x-f5xc-recommended-oneof-variant

النوع: object (خريطة من اسم المجموعة إلى اسم المتغير)

للمخططات التي تحتوي على مجموعات حقول متنافية، يُحدد المتغير الافتراضي أو الأكثر شيوعاً. المفتاح هو اسم مجموعة OneOf والقيمة هي اسم حقل المتغير الموصى به.

healthcheckCreateSpecType:
  type: object
  x-f5xc-recommended-oneof-variant:
    health_check: "http_health_check"

الوصول إلى البيانات

مواصفات API

الملف	المحتوى
`docs/specifications/api/virtual.json`	`healthcheckHttpHealthCheck`، `healthcheckCreateSpecType`، `healthcheckReplaceSpecType`، `healthcheckGetSpecType`
`docs/specifications/api/openapi.json`	المواصفة المدمجة مع جميع المخططات

هيكل validation.json

defaults.resources.healthcheck
├── server_applied      # Fields with x-f5xc-server-default: true
├── recommended         # Fields with x-f5xc-recommended-value
├── oneof_recommended   # OneOf variant recommendations
└── nested_recommended  # Nested schema recommended values

الوثائق ذات الصلة

دليل التطوير - امتدادات OpenAPI - تعريفات الامتدادات وطريقة استخدامها
مواصفة التحقق - تنسيق وهيكل validation.json
تحسينات Origin Pool - إثراءات مخطط origin pool

سجل التغييرات

الإصدار	التاريخ	التغييرات
2.1.4	2026-01-19	إضافة توثيق مجموعة OneOf الخاصة بـ `host_header_choice` لمعاملات طلبات فحص الصحة عبر HTTP
2.1.3	2026-01-18	دمج توثيق الامتدادات العامة في DEVELOPMENT.md؛ البيانات الخاصة بالموارد فقط
2.1.2	2026-01-18	إعادة الكتابة كمرجع API خالص؛ إزالة أمثلة التدفق النهائي واللغة التوجيهية
2.1.1	2026-01-18	إضافة القيم الموصى بها المتداخلة، ومتغيرات OneOf الموصى بها، وامتداد `x-f5xc-recommended-oneof-variant`
2.1.0	2026-01-18	إضافة هيكل الإعدادات الافتراضية الموحد في validation.json
2.0.30	2026-01-16	إضافة الإعدادات الافتراضية المتداخلة لمخططات `$ref`
2.0.29	2026-01-17	الإعدادات الافتراضية الأولية لـ healthcheck