Microsoft.ContainerService managedClusters/maintenanceConfigurations 2026-01-01

تعريف مورد Bicep

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

  • مجموعات الموارد - انظر <أوامر نشر مجموعة الموارد> c1

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

تنسيق المورد

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

resource symbolicname 'Microsoft.ContainerService/managedClusters/maintenanceConfigurations@2026-01-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

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

لمزيد من المعلومات، راجع Child Resource External Parent resource.
اسم رمزي للمورد من النوع: managedClusters
الخصائص خصائص تكوين الصيانة الافتراضية. MaintenanceConfigurationProperties

الجدول الزمني الشهري المطلق

الاسم الوصف قيمة
يومالشهر تاريخ الشهر. int

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

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

DailySchedule

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

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

تيت سبان

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

MaintenanceConfigurationProperties

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

MaintenanceWindow

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

القيود:
قيمة الحد الأدنى = 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[]
جدول جدول التكرار لنافذة الصيانة. الجدول الزمني (مطلوب)
تاريخ البدء تاريخ تنشيط نافذة الصيانة. إذا كان التاريخ الحالي قبل هذا التاريخ، فإن نافذة الصيانة غير نشطة ولن يتم استخدامها للترقيات. إذا لم يتم تحديدها، فستكون نافذة الصيانة نشطة على الفور. string
وقت البدء وقت بدء نافذة الصيانة. القيم المقبولة من "00:00" إلى "23:59". ينطبق "utcOffset" على هذا الحقل. على سبيل المثال: "02:00" مع "utcOffset: +02:00" تعني التوقيت العالمي المنسق "00:00". خيط

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

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

RelativeMonthlySchedule

الاسم الوصف قيمة
يومالأسبوع يحدد في أي يوم من أيام الأسبوع تتم الصيانة. "الجمعة"
"الاثنين"
"السبت"
"الأحد"
'الخميس'
"الثلاثاء"
"الأربعاء" (مطلوب)
فترات فاصلة يحدد عدد الأشهر بين كل مجموعة من التكرارات. int

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

الجدول

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

تايم إن ويك

الاسم الوصف قيمة
day يوم الأسبوع. "الجمعة"
"الاثنين"
"السبت"
"الأحد"
'الخميس'
"الثلاثاء"
'الأربعاء'
فتحات الساعة قائمة بالساعات في اليوم المستخدمة لتحديد النطاق الزمني. تمثل كل ساعة صحيحة نطاقا زمنيا يبدأ من 0 متر بعد الساعة التي تنتهي بالساعة التالية (غير شاملة). 0 يتوافق مع 00:00 UTC ، 23 يتوافق مع 23:00 بالتوقيت العالمي المنسق. تحديد [0، 1] يعني النطاق الزمني من 00:00 إلى 02:00 UTC. int

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

TimeSpan

الاسم الوصف قيمة
end نهاية الفترة الزمنية string
start بداية فترة زمنية string

WeeklySchedule

الاسم الوصف قيمة
يومالأسبوع يحدد في أي يوم من أيام الأسبوع تتم الصيانة. "الجمعة"
"الاثنين"
"السبت"
"الأحد"
'الخميس'
"الثلاثاء"
"الأربعاء" (مطلوب)
فترات أسابيع تحديد عدد الأسابيع بين كل مجموعة من التكرارات. int

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

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

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

  • مجموعات الموارد - انظر <أوامر نشر مجموعة الموارد> c1

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

تنسيق المورد

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

{
  "type": "Microsoft.ContainerService/managedClusters/maintenanceConfigurations",
  "apiVersion": "2026-01-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

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

الجدول الزمني الشهري المطلق

الاسم الوصف قيمة
يومالشهر تاريخ الشهر. int

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

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

DailySchedule

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

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

تيت سبان

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

MaintenanceConfigurationProperties

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

MaintenanceWindow

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

القيود:
قيمة الحد الأدنى = 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[]
جدول جدول التكرار لنافذة الصيانة. الجدول الزمني (مطلوب)
تاريخ البدء تاريخ تنشيط نافذة الصيانة. إذا كان التاريخ الحالي قبل هذا التاريخ، فإن نافذة الصيانة غير نشطة ولن يتم استخدامها للترقيات. إذا لم يتم تحديدها، فستكون نافذة الصيانة نشطة على الفور. string
وقت البدء وقت بدء نافذة الصيانة. القيم المقبولة من "00:00" إلى "23:59". ينطبق "utcOffset" على هذا الحقل. على سبيل المثال: "02:00" مع "utcOffset: +02:00" تعني التوقيت العالمي المنسق "00:00". خيط

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

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

RelativeMonthlySchedule

الاسم الوصف قيمة
يومالأسبوع يحدد في أي يوم من أيام الأسبوع تتم الصيانة. "الجمعة"
"الاثنين"
"السبت"
"الأحد"
'الخميس'
"الثلاثاء"
"الأربعاء" (مطلوب)
فترات فاصلة يحدد عدد الأشهر بين كل مجموعة من التكرارات. int

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

الجدول

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

تايم إن ويك

الاسم الوصف قيمة
day يوم الأسبوع. "الجمعة"
"الاثنين"
"السبت"
"الأحد"
'الخميس'
"الثلاثاء"
'الأربعاء'
فتحات الساعة قائمة بالساعات في اليوم المستخدمة لتحديد النطاق الزمني. تمثل كل ساعة صحيحة نطاقا زمنيا يبدأ من 0 متر بعد الساعة التي تنتهي بالساعة التالية (غير شاملة). 0 يتوافق مع 00:00 UTC ، 23 يتوافق مع 23:00 بالتوقيت العالمي المنسق. تحديد [0، 1] يعني النطاق الزمني من 00:00 إلى 02:00 UTC. int

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

TimeSpan

الاسم الوصف قيمة
end نهاية الفترة الزمنية string
start بداية فترة زمنية string

WeeklySchedule

الاسم الوصف قيمة
يومالأسبوع يحدد في أي يوم من أيام الأسبوع تتم الصيانة. "الجمعة"
"الاثنين"
"السبت"
"الأحد"
'الخميس'
"الثلاثاء"
"الأربعاء" (مطلوب)
فترات أسابيع تحديد عدد الأسابيع بين كل مجموعة من التكرارات. int

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

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

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

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

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

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

تنسيق المورد

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/managedClusters/maintenanceConfigurations@2026-01-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

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

الجدول الزمني الشهري المطلق

الاسم الوصف قيمة
يومالشهر تاريخ الشهر. int

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

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

DailySchedule

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

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

تيت سبان

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

MaintenanceConfigurationProperties

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

MaintenanceWindow

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

القيود:
قيمة الحد الأدنى = 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[]
جدول جدول التكرار لنافذة الصيانة. الجدول الزمني (مطلوب)
تاريخ البدء تاريخ تنشيط نافذة الصيانة. إذا كان التاريخ الحالي قبل هذا التاريخ، فإن نافذة الصيانة غير نشطة ولن يتم استخدامها للترقيات. إذا لم يتم تحديدها، فستكون نافذة الصيانة نشطة على الفور. string
وقت البدء وقت بدء نافذة الصيانة. القيم المقبولة من "00:00" إلى "23:59". ينطبق "utcOffset" على هذا الحقل. على سبيل المثال: "02:00" مع "utcOffset: +02:00" تعني التوقيت العالمي المنسق "00:00". خيط

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

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

RelativeMonthlySchedule

الاسم الوصف قيمة
يومالأسبوع يحدد في أي يوم من أيام الأسبوع تتم الصيانة. "الجمعة"
"الاثنين"
"السبت"
"الأحد"
'الخميس'
"الثلاثاء"
"الأربعاء" (مطلوب)
فترات فاصلة يحدد عدد الأشهر بين كل مجموعة من التكرارات. int

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

الجدول

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

تايم إن ويك

الاسم الوصف قيمة
day يوم الأسبوع. "الجمعة"
"الاثنين"
"السبت"
"الأحد"
'الخميس'
"الثلاثاء"
'الأربعاء'
فتحات الساعة قائمة بالساعات في اليوم المستخدمة لتحديد النطاق الزمني. تمثل كل ساعة صحيحة نطاقا زمنيا يبدأ من 0 متر بعد الساعة التي تنتهي بالساعة التالية (غير شاملة). 0 يتوافق مع 00:00 UTC ، 23 يتوافق مع 23:00 بالتوقيت العالمي المنسق. تحديد [0، 1] يعني النطاق الزمني من 00:00 إلى 02:00 UTC. int

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

TimeSpan

الاسم الوصف قيمة
end نهاية الفترة الزمنية string
start بداية فترة زمنية string

WeeklySchedule

الاسم الوصف قيمة
يومالأسبوع يحدد في أي يوم من أيام الأسبوع تتم الصيانة. "الجمعة"
"الاثنين"
"السبت"
"الأحد"
'الخميس'
"الثلاثاء"
"الأربعاء" (مطلوب)
فترات أسابيع تحديد عدد الأسابيع بين كل مجموعة من التكرارات. int

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