مشاركة عبر

Microsoft.ContainerService managedClusters/maintenanceConfigurations 2025-06-02-preview

تعريف مورد Bicep

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

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

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

تنسيق المورد

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

resource symbolicname 'Microsoft.ContainerService/managedClusters/maintenanceConfigurations@2025-06-02-preview' = {
  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

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

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

AbsoluteMonthlySchedule

Name Description Value
dayOfMonth تاريخ الشهر. int

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

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

DailySchedule

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

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

DateSpan

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

MaintenanceConfigurationProperties

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

MaintenanceWindow

Name Description Value
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 تاريخ تنشيط نافذة الصيانة. إذا كان التاريخ الحالي قبل هذا التاريخ، فإن نافذة الصيانة غير نشطة ولن يتم استخدامها للترقيات. إذا لم يتم تحديدها، ستكون نافذة الصيانة نشطة على الفور. string
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

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

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

Schedule

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

TimeInWeek

Name Description Value
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

Name Description Value
end نهاية فترة زمنية string
start بداية فترة زمنية string

WeeklySchedule

Name Description Value
dayOfWeek يحدد في أي يوم من أيام الأسبوع تحدث الصيانة. '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-06-02-preview",
  "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

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

AbsoluteMonthlySchedule

Name Description Value
dayOfMonth تاريخ الشهر. int

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

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

DailySchedule

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

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

DateSpan

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

MaintenanceConfigurationProperties

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

MaintenanceWindow

Name Description Value
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 تاريخ تنشيط نافذة الصيانة. إذا كان التاريخ الحالي قبل هذا التاريخ، فإن نافذة الصيانة غير نشطة ولن يتم استخدامها للترقيات. إذا لم يتم تحديدها، ستكون نافذة الصيانة نشطة على الفور. string
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

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

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

Schedule

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

TimeInWeek

Name Description Value
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

Name Description Value
end نهاية فترة زمنية string
start بداية فترة زمنية string

WeeklySchedule

Name Description Value
dayOfWeek يحدد في أي يوم من أيام الأسبوع تحدث الصيانة. '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-06-02-preview"
  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

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

AbsoluteMonthlySchedule

Name Description Value
dayOfMonth تاريخ الشهر. int

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

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

DailySchedule

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

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

DateSpan

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

MaintenanceConfigurationProperties

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

MaintenanceWindow

Name Description Value
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 تاريخ تنشيط نافذة الصيانة. إذا كان التاريخ الحالي قبل هذا التاريخ، فإن نافذة الصيانة غير نشطة ولن يتم استخدامها للترقيات. إذا لم يتم تحديدها، ستكون نافذة الصيانة نشطة على الفور. string
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

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

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

Schedule

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

TimeInWeek

Name Description Value
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

Name Description Value
end نهاية فترة زمنية string
start بداية فترة زمنية string

WeeklySchedule

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

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