你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Microsoft.ContainerService managedClusters/maintenanceConfigurations 2023-01-02-preview

  • 项目

Bicep 资源定义

可以使用面向以下操作部署 managedClusters/maintenanceConfigurations 资源类型：

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.ContainerService/managedClusters/maintenanceConfigurations 资源，请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.ContainerService/managedClusters/maintenanceConfigurations@2023-01-02-preview' = {
  name: 'string'
  parent: resourceSymbolicName
  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
        ]
      }
    ]
  }
}

属性值

managedClusters/maintenanceConfigurations

名称 说明 值
name 资源名称

了解如何在 Bicep 中设置子资源的名称和类型。		 字符串 (必需)
父级 (parent) 在 Bicep 中，可以为子资源指定父资源。 仅当子资源在父资源外部声明时，才需要添加此属性。

有关详细信息，请参阅 父资源之外的子资源。		 类型为：managedClusters 的资源的符号名称
properties 默认维护配置的属性。 MaintenanceConfigurationProperties

MaintenanceConfigurationProperties

名称 说明 值
maintenanceWindow 维护配置的维护时段。 MaintenanceWindow
notAllowedTime 不允许升级的时间段。 TimeSpan[]
timeInWeek 如果两个数组条目指定一周中的同一天，则应用的配置是两个条目中的时间的并集。 TimeInWeek[]

MaintenanceWindow

名称 说明 值
durationHours 维护时段的时长范围为 4 到 24 小时。 int (必需)

约束：
最小值 = 4
最大值 = 24
notAllowedDates 不允许升级的日期范围。 “utcOffset”应用于此字段。 例如，将“utcOffset： +02：00”和“dateSpan”设置为“2022-12-23”到“2023-01-03”， 从 UTC 时间的“2022-12-22 22：00”到“2023-01-03 22：00”，将阻止维护。 DateSpan[]
schedule 维护时段的定期计划。 计划 所需的 ()
startDate 维护时段的激活日期。 如果当前日期在此日期之前，则维护时段处于非活动状态，不会用于升级。 如果未指定，维护时段将立即处于活动状态。 字符串
startTime 维护时段的开始时间。 接受的值从“00：00”到“23：59”。 “utcOffset”应用于此字段。 例如：“02：00”与“utcOffset： +02：00”表示 UTC 时间“00：00”。 字符串 (必需)

约束：
Pattern = ^\d{2}:\d{2}$
utcOffset 格式为 +/-HH：mm 的 UTC 偏移量。 例如，“+05：30”用于 IST，“-07：00”用于 PST。 如果未指定，则默认值为“+00：00”。 字符串

约束：
Pattern = ^(-|\+)[0-9]{2}:[0-9]{2}$

DateSpan

名称 说明 值
end 日期范围的结束日期。 字符串 (必需)
start 日期范围的开始日期。 字符串 (必需)

计划

名称 说明 值
absoluteMonthly 对于如下计划：“每月 15 日重复”或“20 日每 3 个月重复一次”。 AbsoluteMonthlySchedule
每日一次 对于如下计划：“每天重复”或“每 3 天重复一次”。 DailySchedule
relativeMonthly 对于如下计划：“每个月在第一个星期一重复”或“上周五每 3 个月重复一次”。 RelativeMonthlySchedule
weekly 对于如下计划：“每周一重复”或“每 3 周在周三重复一次”。 WeeklySchedule

AbsoluteMonthlySchedule

名称 说明 值
dayOfMonth 月份的日期。 int (必需)

约束：
最小值 = 1
最大值 = 31
intervalMonths 指定每组匹配项之间的月数。 int (必需)

约束：
最小值 = 1
最大值 = 6

DailySchedule

名称 说明 值
intervalDays 指定每组匹配项之间的天数。 int (必需)

约束：
最小值 = 1
最大值 = 7

RelativeMonthlySchedule

名称 说明 值
dayOfWeek 指定维护发生在一周中的哪一天。 “Friday”
“Monday”
“Saturday”
“星期日”
“星期四”
“Tuesday”
需要“星期三” ()
intervalMonths 指定每组匹配项之间的月数。 int (必需)

约束：
最小值 = 1
最大值 = 6
weekIndex 指定在以 daysOfWeek 为单位指定的允许天数的哪个实例上进行维护。 “First”
“Fourth”
“Last”
“Second”
“Third” (必需)

WeeklySchedule

名称 说明 值
dayOfWeek 指定维护发生在一周中的哪一天。 “Friday”
“Monday”
“Saturday”
“星期日”
“星期四”
“Tuesday”
需要“星期三” ()
intervalWeeks 指定每组匹配项之间的周数。 int (必需)

约束：
最小值 = 1
最大值 = 4

TimeSpan

名称 说明 值
end 时间跨度结束 字符串
start 时间范围的开始 字符串

TimeInWeek

名称 说明 值
day 星期几。 “Friday”
“Monday”
“Saturday”
“星期日”
“星期四”
“Tuesday”
“星期三”
hourSlots 每个整数小时表示从下一小时结束的 0m 开始的时间范围， (非非非独占) 。 0 表示 00：00 UTC，23 表示 23：00 UTC。 指定 [0， 1] 表示 00：00 - 02：00 UTC 时间范围。 int[]

约束：
最小值 = 0
最大值 = 23

ARM 模板资源定义

managedClusters/maintenanceConfigurations 资源类型可以通过针对以下操作进行部署：

有关每个 API 版本中更改的属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.ContainerService/managedClusters/maintenanceConfigurations 资源，请将以下 JSON 添加到模板。

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

属性值

managedClusters/maintenanceConfigurations

名称 说明 Value
type 资源类型 “Microsoft.ContainerService/managedClusters/maintenanceConfigurations”
apiVersion 资源 API 版本 “2023-01-02-preview”
name 资源名称

了解如何在 JSON ARM 模板中为子资源设置名称和类型。		 字符串 (必需)
properties 默认维护配置的属性。 MaintenanceConfigurationProperties

MaintenanceConfigurationProperties

名称 说明 值
maintenanceWindow 维护配置的维护时段。 MaintenanceWindow
notAllowedTime 不允许升级的时间段。 TimeSpan[]
timeInWeek 如果两个数组条目指定了一周中的同一天，则应用的配置是两个条目中时间的并集。 TimeInWeek[]

MaintenanceWindow

名称 说明 值
durationHours 维护时段的时长从 4 小时到 24 小时不等。 int (必需)

约束：
最小值 = 4
最大值 = 24
notAllowedDates 不允许升级的日期范围。 “utcOffset”适用于此字段。 例如，将“utcOffset： +02：00”和“dateSpan”设置为“2022-12-23”到“2023-01-03”， 将在 UTC 时间的“2022-12-22 22：00”到“2023-01-03 22：00”之间阻止维护。 DateSpan[]
schedule 维护时段的定期计划。 需要计划 ()
startDate 维护时段激活的日期。 如果当前日期早于此日期，则维护时段处于非活动状态，不会用于升级。 如果未指定，维护时段将立即处于活动状态。 字符串
startTime 维护时段的开始时间。 接受的值为“00：00”到“23：59”。 “utcOffset”适用于此字段。 例如：“02：00”与“utcOffset： +02：00”表示 UTC 时间“00：00”。 字符串 (必需)

约束：
模式 = ^\d{2}:\d{2}$
utcOffset 格式为 +/-HH：mm 的 UTC 偏移量。 例如，“+05：30”用于 IST，“-07：00”用于 PST。 如果未指定，则默认值为“+00：00”。 字符串

约束：
模式 = ^(-|\+)[0-9]{2}:[0-9]{2}$

DateSpan

名称 说明 值
end 日期范围的结束日期。 字符串 (必需)
start 日期范围的开始日期。 字符串 (必需)

计划

名称 说明 值
absoluteMonthly 对于如下计划：“每月 15 日重复”或“20 日每 3 个月重复一次”。 AbsoluteMonthlySchedule
每日一次 对于如下计划：“每天重复”或“每 3 天重复一次”。 DailySchedule
relativeMonthly 对于如下计划：“每月第一个星期一重复”或“上周五每 3 个月重复一次”。 RelativeMonthlySchedule
weekly 对于如下计划：“每周一重复”或“周三每 3 周重复一次”。 WeeklySchedule

AbsoluteMonthlySchedule

名称 说明 值
dayOfMonth 月份的日期。 int (必需)

约束：
最小值 = 1
最大值 = 31
intervalMonths 指定每组匹配项之间的月数。 int (必需)

约束：
最小值 = 1
最大值 = 6

DailySchedule

名称 说明 值
intervalDays 指定每组匹配项之间的天数。 int (必需)

约束：
最小值 = 1
最大值 = 7

RelativeMonthlySchedule

名称 说明 值
dayOfWeek 指定在一周中的哪一天进行维护。 “Friday”
“Monday”
“Saturday”
“星期日”
“星期四”
“Tuesday”
需要“星期三” ()
intervalMonths 指定每组匹配项之间的月数。 int (必需)

约束：
最小值 = 1
最大值 = 6
weekIndex 指定维护发生在 daysOfWeek 中指定的允许天数实例。 'First'
“Fourth”
“Last”
'Second'
“third” (必需)

WeeklySchedule

名称 说明 值
dayOfWeek 指定在一周中的哪一天进行维护。 “Friday”
“Monday”
“Saturday”
“星期日”
“星期四”
“Tuesday”
需要“星期三” ()
intervalWeeks 指定每组匹配项之间的周数。 int (必需)

约束：
最小值 = 1
最大值 = 4

TimeSpan

名称 说明 值
end 时间跨度的结束 字符串
start 时间跨度的开始 字符串

TimeInWeek

名称 说明 值
day 星期几。 “Friday”
“Monday”
“Saturday”
“星期日”
“星期四”
“Tuesday”
“Wednesday”
hourSlots 每个整数小时表示一个从 0m 开始的时间范围，该小时在下一小时结束 (非独占) 。 0 对应于 00：00 UTC，23 对应于 23：00 UTC。 指定 [0， 1] 表示 00：00 - 02：00 UTC 时间范围。 int[]

约束：
最小值 = 0
最大值 = 23

Terraform (AzAPI 提供程序) 资源定义

可以使用面向以下操作部署 managedClusters/maintenanceConfigurations 资源类型：

  • 资源组

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.ContainerService/managedClusters/maintenanceConfigurations 资源，请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/managedClusters/maintenanceConfigurations@2023-01-02-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    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
          ]
        }
      ]
    }
  })
}

属性值

managedClusters/maintenanceConfigurations

名称 说明 Value
type 资源类型 “Microsoft.ContainerService/managedClusters/maintenanceConfigurations@2023-01-02-preview”
name 资源名称 字符串 (必需)
parent_id 此资源的父资源的 ID。 类型为：managedClusters 的资源的 ID
properties 默认维护配置的属性。 MaintenanceConfigurationProperties

MaintenanceConfigurationProperties

名称 说明 值
maintenanceWindow 维护配置的维护时段。 MaintenanceWindow
notAllowedTime 不允许升级的时间段。 TimeSpan[]
timeInWeek 如果两个数组条目指定一周中的同一天，则应用的配置是两个条目中的时间的并集。 TimeInWeek[]

MaintenanceWindow

名称 说明 值
durationHours 维护时段的时长从 4 小时到 24 小时不等。 int (必需)

约束：
最小值 = 4
最大值 = 24
notAllowedDates 不允许升级的日期范围。 “utcOffset”应用于此字段。 例如，将“utcOffset： +02：00”和“dateSpan”设置为“2022-12-23”到“2023-01-03”， 从 UTC 时间的“2022-12-22 22：00”到“2023-01-03 22：00”，将阻止维护。 DateSpan[]
schedule 维护时段的定期计划。 计划 所需的 ()
startDate 维护时段的激活日期。 如果当前日期在此日期之前，则维护时段处于非活动状态，不会用于升级。 如果未指定，维护时段将立即处于活动状态。 字符串
startTime 维护时段的开始时间。 接受的值从“00：00”到“23：59”。 “utcOffset”应用于此字段。 例如：“02：00”与“utcOffset： +02：00”表示 UTC 时间“00：00”。 字符串 (必需)

约束：
Pattern = ^\d{2}:\d{2}$
utcOffset 格式为 +/-HH：mm 的 UTC 偏移量。 例如，“+05：30”用于 IST，“-07：00”用于 PST。 如果未指定，则默认值为“+00：00”。 字符串

约束：
Pattern = ^(-|\+)[0-9]{2}:[0-9]{2}$

DateSpan

名称 说明 值
end 日期范围的结束日期。 字符串 (必需)
start 日期范围的开始日期。 字符串 (必需)

计划

名称 说明 值
absoluteMonthly 对于如下计划：“每月 15 日重复”或“20 日每 3 个月重复一次”。 AbsoluteMonthlySchedule
每日一次 对于如下计划：“每天重复”或“每 3 天重复一次”。 DailySchedule
relativeMonthly 对于如下计划：“每个月在第一个星期一重复”或“上周五每 3 个月重复一次”。 RelativeMonthlySchedule
weekly 对于如下计划：“每周一重复”或“每 3 周在周三重复一次”。 WeeklySchedule

AbsoluteMonthlySchedule

名称 说明 值
dayOfMonth 月份的日期。 int (必需)

约束：
最小值 = 1
最大值 = 31
intervalMonths 指定每组匹配项之间的月数。 int (必需)

约束：
最小值 = 1
最大值 = 6

DailySchedule

名称 说明 值
intervalDays 指定每组匹配项之间的天数。 int (必需)

约束：
最小值 = 1
最大值 = 7

RelativeMonthlySchedule

名称 说明 值
dayOfWeek 指定维护发生在一周中的哪一天。 "Friday"
“星期一”
“星期六”
"Sunday"
"Thursday"
"Tuesday"
需要“星期三” ()
intervalMonths 指定每组匹配项之间的月数。 int (必需)

约束：
最小值 = 1
最大值 = 6
weekIndex 指定维护发生在 daysOfWeek 中指定的允许天数实例。 “First”
“Fourth”
“Last”
“Second”
需要“第三个” ()

WeeklySchedule

名称 说明 值
dayOfWeek 指定在一周中的哪一天进行维护。 "Friday"
“星期一”
“星期六”
"Sunday"
"Thursday"
"Tuesday"
需要“星期三” ()
intervalWeeks 指定每组匹配项之间的周数。 int (必需)

约束：
最小值 = 1
最大值 = 4

TimeSpan

名称 说明 值
end 时间跨度的结束 字符串
start 时间跨度的开始 字符串

TimeInWeek

名称 说明 值
day 星期几。 "Friday"
“星期一”
“星期六”
"Sunday"
"Thursday"
"Tuesday"
"Wednesday"
hourSlots 每个整数小时表示一个从 0m 开始的时间范围，该小时在下一小时结束 (非独占) 。 0 对应于 00：00 UTC，23 对应于 23：00 UTC。 指定 [0， 1] 表示 00：00 - 02：00 UTC 时间范围。 int[]

约束：
最小值 = 0
最大值 = 23