مشاركة عبر

Microsoft.ContainerService managedClusters/maintenanceConfigurations 2025-10-01

تعريف مورد Bicep

يمكن نشر نوع مورد ManagedClusters/maintenanceConfigurations مع العمليات التي تستهدف:

  • مجموعات الموارد - راجع أوامر نشر مجموعة الموارد

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

تنسيق المورد

لإنشاء مورد Microsoft.ContainerService/managedClusters/maintenanceConfigurations، أضف Bicep التالي إلى القالب الخاص بك.

resource symbolicname 'Microsoft.ContainerService/managedClusters/maintenanceConfigurations@2025-10-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    maintenanceWindow: {
      durationHours: int
      notAllowedDates: [
        {
          end: 'string'
          start: 'string'
        }
      ]
      schedule: {
        absoluteMonthly: {
          dayOfMonth: int
          intervalMonths: int
        }
        daily: {
          intervalDays: int
        }
        relativeMonthly: {
          dayOfWeek: 'string'
          intervalMonths: int
          weekIndex: 'string'
        }
        weekly: {
          dayOfWeek: 'string'
          intervalWeeks: int
        }
      }
      startDate: 'string'
      startTime: 'string'
      utcOffset: 'string'
    }
    notAllowedTime: [
      {
        end: 'string'
        start: 'string'
      }
    ]
    timeInWeek: [
      {
        day: 'string'
        hourSlots: [
          int
        ]
      }
    ]
  }
}

قيم الخصائص

Microsoft.ContainerService/managedClusters/maintenanceConfigurations

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

لمزيد من المعلومات، راجع المورد التابع خارج المورد الأصل.		 اسم رمزي للمورد من النوع: managedClusters
properties خصائص تكوين الصيانة الافتراضي. MaintenanceConfigurationProperties

AbsoluteMonthlySchedule

الاسم Description قيمة
dayOfMonth تاريخ الشهر. int

Constraints:
قيمة الحد الأدنى = 1
الحد الأقصى للقيمة = 31 (مطلوب)
intervalMonths يحدد عدد الأشهر بين كل مجموعة من التكرارات. int

Constraints:
قيمة الحد الأدنى = 1
الحد الأقصى للقيمة = 6 (مطلوب)

DailySchedule

الاسم Description قيمة
intervalDays يحدد عدد الأيام بين كل مجموعة من التكرارات. int

Constraints:
قيمة الحد الأدنى = 1
الحد الأقصى للقيمة = 7 (مطلوب)

DateSpan

الاسم Description قيمة
انتهاء تاريخ انتهاء امتداد التاريخ. سلسلة (مطلوب)
بدء تاريخ بدء امتداد التاريخ. سلسلة (مطلوب)

خصائص تكوين الصيانة

الاسم Description قيمة
صيانةWindow نافذة الصيانة لتكوين الصيانة. نافذة الصيانة
notAllowedTime الفتحات الزمنية التي لا يسمح بالترقية عليها. TimeSpan[]
timeInWeek فترات زمنية خلال الأسبوع يسمح فيها بالمضي قدما في الصيانة المخطط لها. إذا حدد إدخالا صفيف نفس اليوم من الأسبوع، فإن التكوين المطبق هو اتحاد الأوقات في كلا الإدخالين. TimeInWeek[]

نافذة الصيانة

الاسم Description قيمة
durationHours يتراوح طول نافذة الصيانة من 4 إلى 24 ساعة. int

Constraints:
قيمة الحد الأدنى = 4
الحد الأقصى للقيمة = 24 (مطلوب)
notAllowedDates نطاقات التاريخ التي لا يسمح بالترقية عليها. ينطبق "utcOffset" على هذا الحقل. على سبيل المثال، مع 'utcOffset: +02:00' و'dateSpan' يجري '2022-12-23' إلى '2023-01-03'، سيتم حظر الصيانة من "2022-12-22 22:00" إلى "2023-01-03 22:00" في التوقيت العالمي المتفق عليه. DateSpan[]
schedule جدول التكرار لنافذة الصيانة. الجدول الزمني (مطلوب)
startDate تاريخ تنشيط نافذة الصيانة. إذا كان التاريخ الحالي قبل هذا التاريخ، فإن نافذة الصيانة غير نشطة ولن يتم استخدامها للترقيات. إذا لم يتم تحديدها، ستكون نافذة الصيانة نشطة على الفور. سلسلة
startTime وقت بدء نافذة الصيانة. تتراوح القيم المقبولة من "00:00" إلى "23:59". ينطبق "utcOffset" على هذا الحقل. على سبيل المثال: "02:00" مع "utcOffset: +02:00" يعني التوقيت العالمي المتفق عليه "00:00". string

Constraints:
النمط = ^\d{2}:\d{2}$ (مطلوب)
utcOffset إزاحة UTC بتنسيق +/-HH:mm. على سبيل المثال، '+05:30' ل IST و'-07:00' ل PST. إذا لم يتم تحديده، يكون الافتراضي هو '+00:00'. string

Constraints:
النمط = ^(-|\+)[0-9]{2}:[0-9]{2}$

RelativeMonthlySchedule

الاسم Description قيمة
يومالأسبوع يحدد في أي يوم من أيام الأسبوع تحدث الصيانة. 'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'الأربعاء' (مطلوب)
intervalMonths يحدد عدد الأشهر بين كل مجموعة من التكرارات. int

Constraints:
قيمة الحد الأدنى = 1
الحد الأقصى للقيمة = 6 (مطلوب)
weekIndex مؤشر الأسبوع. يحدد الأسبوع من الشهر الذي ينطبق فيه dayOfWeek. 'First'
'Fourth'
'Last'
'Second'
"الثالث" (مطلوب)

الجدولة

الاسم Description قيمة
absoluteMonthly بالنسبة للجداول الزمنية مثل: "تتكرر كل شهر في 15th" أو "تتكرر كل 3 أشهر في 20th". AbsoluteMonthlySchedule
daily بالنسبة للجداول الزمنية مثل: "تتكرر كل يوم" أو "تتكرر كل 3 أيام". DailySchedule
relativeMonthly بالنسبة للجداول الزمنية مثل: "تتكرر كل شهر في أول يوم اثنين" أو "تتكرر كل 3 أشهر يوم الجمعة الماضي". RelativeMonthlySchedule
أسبوعي بالنسبة للجداول الزمنية مثل: "تتكرر كل يوم اثنين" أو "تتكرر كل 3 أسابيع يوم الأربعاء". WeeklySchedule

TimeInWeek

الاسم Description قيمة
day يوم الأسبوع. 'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Wednesday'
hourSlots قائمة بالساعات في اليوم المستخدمة لتحديد النطاق الزمني. تمثل كل ساعة عدد صحيح نطاقا زمنيا يبدأ من 0m بعد انتهاء الساعة في الساعة التالية (غير شاملة). 0 يتوافق مع 00:00 بالتوقيت العالمي المتفق عليه، 23 يتوافق مع 23:00 بالتوقيت العالمي المتفق عليه. يعني تحديد [0، 1] النطاق الزمني 00:00 - 02:00 بالتوقيت العالمي المتفق عليه. int

Constraints:
قيمة الحد الأدنى = 0
الحد الأقصى للقيمة = 23[]

TimeSpan

الاسم Description قيمة
انتهاء نهاية فترة زمنية سلسلة
بدء بداية فترة زمنية سلسلة

WeeklySchedule

الاسم Description قيمة
يومالأسبوع يحدد في أي يوم من أيام الأسبوع تحدث الصيانة. 'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'الأربعاء' (مطلوب)
intervalWeeks تحديد عدد الأسابيع بين كل مجموعة من التكرارات. int

Constraints:
قيمة الحد الأدنى = 1
الحد الأقصى للقيمة = 4 (مطلوب)

تعريف مورد قالب ARM

يمكن نشر نوع مورد ManagedClusters/maintenanceConfigurations مع العمليات التي تستهدف:

  • مجموعات الموارد - راجع أوامر نشر مجموعة الموارد

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

تنسيق المورد

لإنشاء مورد Microsoft.ContainerService/managedClusters/maintenanceConfigurations، أضف JSON التالي إلى القالب الخاص بك.

{
  "type": "Microsoft.ContainerService/managedClusters/maintenanceConfigurations",
  "apiVersion": "2025-10-01",
  "name": "string",
  "properties": {
    "maintenanceWindow": {
      "durationHours": "int",
      "notAllowedDates": [
        {
          "end": "string",
          "start": "string"
        }
      ],
      "schedule": {
        "absoluteMonthly": {
          "dayOfMonth": "int",
          "intervalMonths": "int"
        },
        "daily": {
          "intervalDays": "int"
        },
        "relativeMonthly": {
          "dayOfWeek": "string",
          "intervalMonths": "int",
          "weekIndex": "string"
        },
        "weekly": {
          "dayOfWeek": "string",
          "intervalWeeks": "int"
        }
      },
      "startDate": "string",
      "startTime": "string",
      "utcOffset": "string"
    },
    "notAllowedTime": [
      {
        "end": "string",
        "start": "string"
      }
    ],
    "timeInWeek": [
      {
        "day": "string",
        "hourSlots": [ "int" ]
      }
    ]
  }
}

قيم الخصائص

Microsoft.ContainerService/managedClusters/maintenanceConfigurations

الاسم Description قيمة
apiVersion إصدار واجهة برمجة التطبيقات '2025-10-01'
الاسم اسم المورد سلسلة (مطلوب)
properties خصائص تكوين الصيانة الافتراضي. MaintenanceConfigurationProperties
النوع نوع المورد 'Microsoft.ContainerService/managedClusters/maintenanceConfigurations'

AbsoluteMonthlySchedule

الاسم Description قيمة
dayOfMonth تاريخ الشهر. int

Constraints:
قيمة الحد الأدنى = 1
الحد الأقصى للقيمة = 31 (مطلوب)
intervalMonths يحدد عدد الأشهر بين كل مجموعة من التكرارات. int

Constraints:
قيمة الحد الأدنى = 1
الحد الأقصى للقيمة = 6 (مطلوب)

DailySchedule

الاسم Description قيمة
intervalDays يحدد عدد الأيام بين كل مجموعة من التكرارات. int

Constraints:
قيمة الحد الأدنى = 1
الحد الأقصى للقيمة = 7 (مطلوب)

DateSpan

الاسم Description قيمة
انتهاء تاريخ انتهاء امتداد التاريخ. سلسلة (مطلوب)
بدء تاريخ بدء امتداد التاريخ. سلسلة (مطلوب)

خصائص تكوين الصيانة

الاسم Description قيمة
صيانةWindow نافذة الصيانة لتكوين الصيانة. نافذة الصيانة
notAllowedTime الفتحات الزمنية التي لا يسمح بالترقية عليها. TimeSpan[]
timeInWeek فترات زمنية خلال الأسبوع يسمح فيها بالمضي قدما في الصيانة المخطط لها. إذا حدد إدخالا صفيف نفس اليوم من الأسبوع، فإن التكوين المطبق هو اتحاد الأوقات في كلا الإدخالين. TimeInWeek[]

نافذة الصيانة

الاسم Description قيمة
durationHours يتراوح طول نافذة الصيانة من 4 إلى 24 ساعة. int

Constraints:
قيمة الحد الأدنى = 4
الحد الأقصى للقيمة = 24 (مطلوب)
notAllowedDates نطاقات التاريخ التي لا يسمح بالترقية عليها. ينطبق "utcOffset" على هذا الحقل. على سبيل المثال، مع 'utcOffset: +02:00' و'dateSpan' يجري '2022-12-23' إلى '2023-01-03'، سيتم حظر الصيانة من "2022-12-22 22:00" إلى "2023-01-03 22:00" في التوقيت العالمي المتفق عليه. DateSpan[]
schedule جدول التكرار لنافذة الصيانة. الجدول الزمني (مطلوب)
startDate تاريخ تنشيط نافذة الصيانة. إذا كان التاريخ الحالي قبل هذا التاريخ، فإن نافذة الصيانة غير نشطة ولن يتم استخدامها للترقيات. إذا لم يتم تحديدها، ستكون نافذة الصيانة نشطة على الفور. سلسلة
startTime وقت بدء نافذة الصيانة. تتراوح القيم المقبولة من "00:00" إلى "23:59". ينطبق "utcOffset" على هذا الحقل. على سبيل المثال: "02:00" مع "utcOffset: +02:00" يعني التوقيت العالمي المتفق عليه "00:00". string

Constraints:
النمط = ^\d{2}:\d{2}$ (مطلوب)
utcOffset إزاحة UTC بتنسيق +/-HH:mm. على سبيل المثال، '+05:30' ل IST و'-07:00' ل PST. إذا لم يتم تحديده، يكون الافتراضي هو '+00:00'. string

Constraints:
النمط = ^(-|\+)[0-9]{2}:[0-9]{2}$

RelativeMonthlySchedule

الاسم Description قيمة
يومالأسبوع يحدد في أي يوم من أيام الأسبوع تحدث الصيانة. 'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'الأربعاء' (مطلوب)
intervalMonths يحدد عدد الأشهر بين كل مجموعة من التكرارات. int

Constraints:
قيمة الحد الأدنى = 1
الحد الأقصى للقيمة = 6 (مطلوب)
weekIndex مؤشر الأسبوع. يحدد الأسبوع من الشهر الذي ينطبق فيه dayOfWeek. 'First'
'Fourth'
'Last'
'Second'
"الثالث" (مطلوب)

الجدولة

الاسم Description قيمة
absoluteMonthly بالنسبة للجداول الزمنية مثل: "تتكرر كل شهر في 15th" أو "تتكرر كل 3 أشهر في 20th". AbsoluteMonthlySchedule
daily بالنسبة للجداول الزمنية مثل: "تتكرر كل يوم" أو "تتكرر كل 3 أيام". DailySchedule
relativeMonthly بالنسبة للجداول الزمنية مثل: "تتكرر كل شهر في أول يوم اثنين" أو "تتكرر كل 3 أشهر يوم الجمعة الماضي". RelativeMonthlySchedule
أسبوعي بالنسبة للجداول الزمنية مثل: "تتكرر كل يوم اثنين" أو "تتكرر كل 3 أسابيع يوم الأربعاء". WeeklySchedule

TimeInWeek

الاسم Description قيمة
day يوم الأسبوع. 'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Wednesday'
hourSlots قائمة بالساعات في اليوم المستخدمة لتحديد النطاق الزمني. تمثل كل ساعة عدد صحيح نطاقا زمنيا يبدأ من 0m بعد انتهاء الساعة في الساعة التالية (غير شاملة). 0 يتوافق مع 00:00 بالتوقيت العالمي المتفق عليه، 23 يتوافق مع 23:00 بالتوقيت العالمي المتفق عليه. يعني تحديد [0، 1] النطاق الزمني 00:00 - 02:00 بالتوقيت العالمي المتفق عليه. int

Constraints:
قيمة الحد الأدنى = 0
الحد الأقصى للقيمة = 23[]

TimeSpan

الاسم Description قيمة
انتهاء نهاية فترة زمنية سلسلة
بدء بداية فترة زمنية سلسلة

WeeklySchedule

الاسم Description قيمة
يومالأسبوع يحدد في أي يوم من أيام الأسبوع تحدث الصيانة. 'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'الأربعاء' (مطلوب)
intervalWeeks تحديد عدد الأسابيع بين كل مجموعة من التكرارات. int

Constraints:
قيمة الحد الأدنى = 1
الحد الأقصى للقيمة = 4 (مطلوب)

أمثلة الاستخدام

تعريف مورد Terraform (موفر AzAPI)

يمكن نشر نوع مورد ManagedClusters/maintenanceConfigurations مع العمليات التي تستهدف:

  • مجموعات الموارد

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

تنسيق المورد

لإنشاء مورد Microsoft.ContainerService/managedClusters/maintenanceConfigurations، أضف Terraform التالي إلى القالب الخاص بك.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/managedClusters/maintenanceConfigurations@2025-10-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      maintenanceWindow = {
        durationHours = int
        notAllowedDates = [
          {
            end = "string"
            start = "string"
          }
        ]
        schedule = {
          absoluteMonthly = {
            dayOfMonth = int
            intervalMonths = int
          }
          daily = {
            intervalDays = int
          }
          relativeMonthly = {
            dayOfWeek = "string"
            intervalMonths = int
            weekIndex = "string"
          }
          weekly = {
            dayOfWeek = "string"
            intervalWeeks = int
          }
        }
        startDate = "string"
        startTime = "string"
        utcOffset = "string"
      }
      notAllowedTime = [
        {
          end = "string"
          start = "string"
        }
      ]
      timeInWeek = [
        {
          day = "string"
          hourSlots = [
            int
          ]
        }
      ]
    }
  }
}

قيم الخصائص

Microsoft.ContainerService/managedClusters/maintenanceConfigurations

الاسم Description قيمة
الاسم اسم المورد سلسلة (مطلوب)
parent_id معرف المورد الأصل لهذا المورد. معرف المورد من النوع: managedClusters
properties خصائص تكوين الصيانة الافتراضي. MaintenanceConfigurationProperties
النوع نوع المورد "Microsoft.ContainerService/managedClusters/maintenanceConfigurations@2025-10-01"

AbsoluteMonthlySchedule

الاسم Description قيمة
dayOfMonth تاريخ الشهر. int

Constraints:
قيمة الحد الأدنى = 1
الحد الأقصى للقيمة = 31 (مطلوب)
intervalMonths يحدد عدد الأشهر بين كل مجموعة من التكرارات. int

Constraints:
قيمة الحد الأدنى = 1
الحد الأقصى للقيمة = 6 (مطلوب)

DailySchedule

الاسم Description قيمة
intervalDays يحدد عدد الأيام بين كل مجموعة من التكرارات. int

Constraints:
قيمة الحد الأدنى = 1
الحد الأقصى للقيمة = 7 (مطلوب)

DateSpan

الاسم Description قيمة
انتهاء تاريخ انتهاء امتداد التاريخ. سلسلة (مطلوب)
بدء تاريخ بدء امتداد التاريخ. سلسلة (مطلوب)

خصائص تكوين الصيانة

الاسم Description قيمة
صيانةWindow نافذة الصيانة لتكوين الصيانة. نافذة الصيانة
notAllowedTime الفتحات الزمنية التي لا يسمح بالترقية عليها. TimeSpan[]
timeInWeek فترات زمنية خلال الأسبوع يسمح فيها بالمضي قدما في الصيانة المخطط لها. إذا حدد إدخالا صفيف نفس اليوم من الأسبوع، فإن التكوين المطبق هو اتحاد الأوقات في كلا الإدخالين. TimeInWeek[]

نافذة الصيانة

الاسم Description قيمة
durationHours يتراوح طول نافذة الصيانة من 4 إلى 24 ساعة. int

Constraints:
قيمة الحد الأدنى = 4
الحد الأقصى للقيمة = 24 (مطلوب)
notAllowedDates نطاقات التاريخ التي لا يسمح بالترقية عليها. ينطبق "utcOffset" على هذا الحقل. على سبيل المثال، مع 'utcOffset: +02:00' و'dateSpan' يجري '2022-12-23' إلى '2023-01-03'، سيتم حظر الصيانة من "2022-12-22 22:00" إلى "2023-01-03 22:00" في التوقيت العالمي المتفق عليه. DateSpan[]
schedule جدول التكرار لنافذة الصيانة. الجدول الزمني (مطلوب)
startDate تاريخ تنشيط نافذة الصيانة. إذا كان التاريخ الحالي قبل هذا التاريخ، فإن نافذة الصيانة غير نشطة ولن يتم استخدامها للترقيات. إذا لم يتم تحديدها، ستكون نافذة الصيانة نشطة على الفور. سلسلة
startTime وقت بدء نافذة الصيانة. تتراوح القيم المقبولة من "00:00" إلى "23:59". ينطبق "utcOffset" على هذا الحقل. على سبيل المثال: "02:00" مع "utcOffset: +02:00" يعني التوقيت العالمي المتفق عليه "00:00". string

Constraints:
النمط = ^\d{2}:\d{2}$ (مطلوب)
utcOffset إزاحة UTC بتنسيق +/-HH:mm. على سبيل المثال، '+05:30' ل IST و'-07:00' ل PST. إذا لم يتم تحديده، يكون الافتراضي هو '+00:00'. string

Constraints:
النمط = ^(-|\+)[0-9]{2}:[0-9]{2}$

RelativeMonthlySchedule

الاسم Description قيمة
يومالأسبوع يحدد في أي يوم من أيام الأسبوع تحدث الصيانة. 'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'الأربعاء' (مطلوب)
intervalMonths يحدد عدد الأشهر بين كل مجموعة من التكرارات. int

Constraints:
قيمة الحد الأدنى = 1
الحد الأقصى للقيمة = 6 (مطلوب)
weekIndex مؤشر الأسبوع. يحدد الأسبوع من الشهر الذي ينطبق فيه dayOfWeek. 'First'
'Fourth'
'Last'
'Second'
"الثالث" (مطلوب)

الجدولة

الاسم Description قيمة
absoluteMonthly بالنسبة للجداول الزمنية مثل: "تتكرر كل شهر في 15th" أو "تتكرر كل 3 أشهر في 20th". AbsoluteMonthlySchedule
daily بالنسبة للجداول الزمنية مثل: "تتكرر كل يوم" أو "تتكرر كل 3 أيام". DailySchedule
relativeMonthly بالنسبة للجداول الزمنية مثل: "تتكرر كل شهر في أول يوم اثنين" أو "تتكرر كل 3 أشهر يوم الجمعة الماضي". RelativeMonthlySchedule
أسبوعي بالنسبة للجداول الزمنية مثل: "تتكرر كل يوم اثنين" أو "تتكرر كل 3 أسابيع يوم الأربعاء". WeeklySchedule

TimeInWeek

الاسم Description قيمة
day يوم الأسبوع. 'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'Wednesday'
hourSlots قائمة بالساعات في اليوم المستخدمة لتحديد النطاق الزمني. تمثل كل ساعة عدد صحيح نطاقا زمنيا يبدأ من 0m بعد انتهاء الساعة في الساعة التالية (غير شاملة). 0 يتوافق مع 00:00 بالتوقيت العالمي المتفق عليه، 23 يتوافق مع 23:00 بالتوقيت العالمي المتفق عليه. يعني تحديد [0، 1] النطاق الزمني 00:00 - 02:00 بالتوقيت العالمي المتفق عليه. int

Constraints:
قيمة الحد الأدنى = 0
الحد الأقصى للقيمة = 23[]

TimeSpan

الاسم Description قيمة
انتهاء نهاية فترة زمنية سلسلة
بدء بداية فترة زمنية سلسلة

WeeklySchedule

الاسم Description قيمة
يومالأسبوع يحدد في أي يوم من أيام الأسبوع تحدث الصيانة. 'Friday'
'Monday'
'Saturday'
'Sunday'
'Thursday'
'Tuesday'
'الأربعاء' (مطلوب)
intervalWeeks تحديد عدد الأسابيع بين كل مجموعة من التكرارات. int

Constraints:
قيمة الحد الأدنى = 1
الحد الأقصى للقيمة = 4 (مطلوب)
  • Last updated on