次の方法で共有

Microsoft.ContainerService マネージドクラスター/メンテナンス構成 2025-02-01

Bicep リソース定義

managedClusters/maintenanceConfigurations リソースの種類は、次を対象とする操作と共にデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.ContainerService/managedClusters/maintenanceConfigurations リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.ContainerService/managedClusters/maintenanceConfigurations@2025-02-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 (英語)

名前 説明 価値
名前 リソース名 string (必須)
親 Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。

詳細については、「親リソースの外部 子リソース」を参照してください。		 種類のリソースのシンボリック名: managedClusters
プロパティ 既定のメンテナンス構成のプロパティ。 MaintenanceConfigurationProperties (メンテナンス構成プロパティ)

絶対的な月次スケジュール

名前 説明 価値
dayOfMonth (日付の月) 月の日付。 int

制約：
最小値 = 1
最大値 = 31 (必須)
インターバル月 各出現回数の間の月数を指定します。 int

制約：
最小値 = 1
最大値 = 6 (必須)

デイリースケジュール

名前 説明 価値
インターバルDays 各出現回数の間の日数を指定します。 int

制約：
最小値 = 1
最大値 = 7 (必須)

日付スパン

名前 説明 価値
終了 日付範囲の終了日。 string (必須)
始める 日付範囲の開始日。 string (必須)

MaintenanceConfigurationProperties (メンテナンス構成プロパティ)

名前 説明 価値
メンテナンスウィンドウ メンテナンス構成のメンテナンス期間。 メンテナンスウィンドウ
notAllowedTime(ノット・ロバデッド・タイム) アップグレードが許可されていないタイム スロット。 タイムスパン[]
timeInWeek (タイム・イン・ウィーク) 2 つの配列エントリが同じ曜日を指定する場合、適用される構成は両方のエントリの時間の和集合です。 TimeInWeek[]

メンテナンスウィンドウ

名前 説明 価値
durationHours (期間時間) メンテナンス期間の長さは 4 時間から 24 時間です。 int

制約：
最小値 = 4
最大値 = 24 (必須)
notAllowed日付 アップグレードが許可されていない日付範囲。 'utcOffset' はこのフィールドに適用されます。 たとえば、'utcOffset: +02:00' と 'dateSpan' が '2022-12-23' から '2023-01-03' の場合、 メンテナンスは、UTC 時刻の '2022-12-22 22:00' から '2023-01-03 22:00' にブロックされます。 日付スパン[]
スケジュール メンテナンス期間の繰り返しスケジュール。 スケジュール (必須)
開始日 メンテナンス期間がアクティブ化される日付。 現在の日付がこの日付より前の場合、メンテナンス期間は非アクティブであり、アップグレードには使用されません。 指定しない場合、メンテナンス期間はすぐにアクティブになります。 文字列
開始時間 メンテナンス期間の開始時刻。 指定できる値は、'00:00' から '23:59' までです。 'utcOffset' はこのフィールドに適用されます。 たとえば、'utcOffset: +02:00' の '02:00' は UTC 時刻 '00:00' を意味します。 糸

制約：
パターン = ^\d{2}:\d{2}$ (必須)
utcオフセット 形式 +/-HH:mm の UTC オフセット。 たとえば、IST の場合は '+05:30'、PST の場合は '-07:00' などです。 指定しない場合、既定値は '+00:00' です。 糸

制約：
パターン = ^(-|\+)[0-9]{2}:[0-9]{2}$

RelativeMonthlyスケジュール

名前 説明 価値
dayOfWeekの メンテナンスが行われる曜日を指定します。 「フライデー」
「月曜日」
「サタデー」
「サンデー」
「木曜日」
「火曜日」
'Wednesday' (必須)
インターバル月 各出現回数の間の月数を指定します。 int

制約：
最小値 = 1
最大値 = 6 (必須)
weekインデックス dayOfWeek が適用される月の週を指定します。 「最初」
「4番目」
「ラスト」
「セカンド」
'Third' (必須)

スケジュール

名前 説明 価値
絶対月次 "15 日に毎月繰り返す" や "20 日に 3 か月ごとに繰り返す" などのスケジュールの場合。 絶対的な月次スケジュール
日毎 "毎日繰り返し" や "3 日おきに繰り返す" などのスケジュールの場合。 デイリースケジュール
relative月次 "最初の月曜日に毎月繰り返す" や "先週の金曜日に 3 か月ごとに繰り返す" などのスケジュールの場合。 RelativeMonthlyスケジュール
ウィークリー "毎週月曜日に繰り返す" や "水曜日に 3 週間ごとに繰り返す" などのスケジュールの場合。 ウィークリースケジュール

タイムインウィーク

名前 説明 価値
日 曜日。 「フライデー」
「月曜日」
「サタデー」
「サンデー」
「木曜日」
「火曜日」
「水曜日」
アワースロット 各整数時間は、次の時間で終わる時間の後の 0m から始まる時間範囲を表します (非包括)。 0 は 00:00 UTC に対応し、23 は 23:00 UTC に対応します。 [0, 1] を指定すると、00:00 から 02:00 UTC の時間範囲が意味されます。 int

制約：
最小値 = 0
最大値 = 23[]

タイムスパン

名前 説明 価値
終了 期間の終わり 文字列
始める 期間の開始 文字列

ウィークリースケジュール

名前 説明 価値
dayOfWeekの メンテナンスが行われる曜日を指定します。 「フライデー」
「月曜日」
「サタデー」
「サンデー」
「木曜日」
「火曜日」
'Wednesday' (必須)
インターバルウィーク 各出現回数の間の週数を指定します。 int

制約：
最小値 = 1
最大値 = 4 (必須)

ARM テンプレート リソース定義

managedClusters/maintenanceConfigurations リソースの種類は、次を対象とする操作と共にデプロイできます。

  • リソース グループの - リソース グループのデプロイ コマンド 参照

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.ContainerService/managedClusters/maintenanceConfigurations リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.ContainerService/managedClusters/maintenanceConfigurations",
  "apiVersion": "2025-02-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 (英語) API のバージョン '2025-02-01'
名前 リソース名 string (必須)
プロパティ 既定のメンテナンス構成のプロパティ。 MaintenanceConfigurationProperties (メンテナンス構成プロパティ)
型 リソースの種類 'Microsoft.ContainerService/managedClusters/maintenanceConfigurations'

絶対的な月次スケジュール

名前 説明 価値
dayOfMonth (日付の月) 月の日付。 int

制約：
最小値 = 1
最大値 = 31 (必須)
インターバル月 各出現回数の間の月数を指定します。 int

制約：
最小値 = 1
最大値 = 6 (必須)

デイリースケジュール

名前 説明 価値
インターバルDays 各出現回数の間の日数を指定します。 int

制約：
最小値 = 1
最大値 = 7 (必須)

日付スパン

名前 説明 価値
終了 日付範囲の終了日。 string (必須)
始める 日付範囲の開始日。 string (必須)

MaintenanceConfigurationProperties (メンテナンス構成プロパティ)

名前 説明 価値
メンテナンスウィンドウ メンテナンス構成のメンテナンス期間。 メンテナンスウィンドウ
notAllowedTime(ノット・ロバデッド・タイム) アップグレードが許可されていないタイム スロット。 タイムスパン[]
timeInWeek (タイム・イン・ウィーク) 2 つの配列エントリが同じ曜日を指定する場合、適用される構成は両方のエントリの時間の和集合です。 TimeInWeek[]

メンテナンスウィンドウ

名前 説明 価値
durationHours (期間時間) メンテナンス期間の長さは 4 時間から 24 時間です。 int

制約：
最小値 = 4
最大値 = 24 (必須)
notAllowed日付 アップグレードが許可されていない日付範囲。 'utcOffset' はこのフィールドに適用されます。 たとえば、'utcOffset: +02:00' と 'dateSpan' が '2022-12-23' から '2023-01-03' の場合、 メンテナンスは、UTC 時刻の '2022-12-22 22:00' から '2023-01-03 22:00' にブロックされます。 日付スパン[]
スケジュール メンテナンス期間の繰り返しスケジュール。 スケジュール (必須)
開始日 メンテナンス期間がアクティブ化される日付。 現在の日付がこの日付より前の場合、メンテナンス期間は非アクティブであり、アップグレードには使用されません。 指定しない場合、メンテナンス期間はすぐにアクティブになります。 文字列
開始時間 メンテナンス期間の開始時刻。 指定できる値は、'00:00' から '23:59' までです。 'utcOffset' はこのフィールドに適用されます。 たとえば、'utcOffset: +02:00' の '02:00' は UTC 時刻 '00:00' を意味します。 糸

制約：
パターン = ^\d{2}:\d{2}$ (必須)
utcオフセット 形式 +/-HH:mm の UTC オフセット。 たとえば、IST の場合は '+05:30'、PST の場合は '-07:00' などです。 指定しない場合、既定値は '+00:00' です。 糸

制約：
パターン = ^(-|\+)[0-9]{2}:[0-9]{2}$

RelativeMonthlyスケジュール

名前 説明 価値
dayOfWeekの メンテナンスが行われる曜日を指定します。 「フライデー」
「月曜日」
「サタデー」
「サンデー」
「木曜日」
「火曜日」
'Wednesday' (必須)
インターバル月 各出現回数の間の月数を指定します。 int

制約：
最小値 = 1
最大値 = 6 (必須)
weekインデックス dayOfWeek が適用される月の週を指定します。 「最初」
「4番目」
「ラスト」
「セカンド」
'Third' (必須)

スケジュール

名前 説明 価値
絶対月次 "15 日に毎月繰り返す" や "20 日に 3 か月ごとに繰り返す" などのスケジュールの場合。 絶対的な月次スケジュール
日毎 "毎日繰り返し" や "3 日おきに繰り返す" などのスケジュールの場合。 デイリースケジュール
relative月次 "最初の月曜日に毎月繰り返す" や "先週の金曜日に 3 か月ごとに繰り返す" などのスケジュールの場合。 RelativeMonthlyスケジュール
ウィークリー "毎週月曜日に繰り返す" や "水曜日に 3 週間ごとに繰り返す" などのスケジュールの場合。 ウィークリースケジュール

タイムインウィーク

名前 説明 価値
日 曜日。 「フライデー」
「月曜日」
「サタデー」
「サンデー」
「木曜日」
「火曜日」
「水曜日」
アワースロット 各整数時間は、次の時間で終わる時間の後の 0m から始まる時間範囲を表します (非包括)。 0 は 00:00 UTC に対応し、23 は 23:00 UTC に対応します。 [0, 1] を指定すると、00:00 から 02:00 UTC の時間範囲が意味されます。 int

制約：
最小値 = 0
最大値 = 23[]

タイムスパン

名前 説明 価値
終了 期間の終わり 文字列
始める 期間の開始 文字列

ウィークリースケジュール

名前 説明 価値
dayOfWeekの メンテナンスが行われる曜日を指定します。 「フライデー」
「月曜日」
「サタデー」
「サンデー」
「木曜日」
「火曜日」
'Wednesday' (必須)
インターバルウィーク 各出現回数の間の週数を指定します。 int

制約：
最小値 = 1
最大値 = 4 (必須)

使用例

Terraform (AzAPI プロバイダー) リソース定義

managedClusters/maintenanceConfigurations リソースの種類は、次を対象とする操作と共にデプロイできます。

  • リソース グループ

各 API バージョンで変更されたプロパティの一覧については、変更ログの参照してください。

リソースの形式

Microsoft.ContainerService/managedClusters/maintenanceConfigurations リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/managedClusters/maintenanceConfigurations@2025-02-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 (英語)

名前 説明 価値
名前 リソース名 string (必須)
parent_id このリソースの親であるリソースの ID。 種類のリソースの ID: managedClusters
プロパティ 既定のメンテナンス構成のプロパティ。 MaintenanceConfigurationProperties (メンテナンス構成プロパティ)
型 リソースの種類 "Microsoft.ContainerService/managedClusters/maintenanceConfigurations@2025-02-01"

絶対的な月次スケジュール

名前 説明 価値
dayOfMonth (日付の月) 月の日付。 int

制約：
最小値 = 1
最大値 = 31 (必須)
インターバル月 各出現回数の間の月数を指定します。 int

制約：
最小値 = 1
最大値 = 6 (必須)

デイリースケジュール

名前 説明 価値
インターバルDays 各出現回数の間の日数を指定します。 int

制約：
最小値 = 1
最大値 = 7 (必須)

日付スパン

名前 説明 価値
終了 日付範囲の終了日。 string (必須)
始める 日付範囲の開始日。 string (必須)

MaintenanceConfigurationProperties (メンテナンス構成プロパティ)

名前 説明 価値
メンテナンスウィンドウ メンテナンス構成のメンテナンス期間。 メンテナンスウィンドウ
notAllowedTime(ノット・ロバデッド・タイム) アップグレードが許可されていないタイム スロット。 タイムスパン[]
timeInWeek (タイム・イン・ウィーク) 2 つの配列エントリが同じ曜日を指定する場合、適用される構成は両方のエントリの時間の和集合です。 TimeInWeek[]

メンテナンスウィンドウ

名前 説明 価値
durationHours (期間時間) メンテナンス期間の長さは 4 時間から 24 時間です。 int

制約：
最小値 = 4
最大値 = 24 (必須)
notAllowed日付 アップグレードが許可されていない日付範囲。 'utcOffset' はこのフィールドに適用されます。 たとえば、'utcOffset: +02:00' と 'dateSpan' が '2022-12-23' から '2023-01-03' の場合、 メンテナンスは、UTC 時刻の '2022-12-22 22:00' から '2023-01-03 22:00' にブロックされます。 日付スパン[]
スケジュール メンテナンス期間の繰り返しスケジュール。 スケジュール (必須)
開始日 メンテナンス期間がアクティブ化される日付。 現在の日付がこの日付より前の場合、メンテナンス期間は非アクティブであり、アップグレードには使用されません。 指定しない場合、メンテナンス期間はすぐにアクティブになります。 文字列
開始時間 メンテナンス期間の開始時刻。 指定できる値は、'00:00' から '23:59' までです。 'utcOffset' はこのフィールドに適用されます。 たとえば、'utcOffset: +02:00' の '02:00' は UTC 時刻 '00:00' を意味します。 糸

制約：
パターン = ^\d{2}:\d{2}$ (必須)
utcオフセット 形式 +/-HH:mm の UTC オフセット。 たとえば、IST の場合は '+05:30'、PST の場合は '-07:00' などです。 指定しない場合、既定値は '+00:00' です。 糸

制約：
パターン = ^(-|\+)[0-9]{2}:[0-9]{2}$

RelativeMonthlyスケジュール

名前 説明 価値
dayOfWeekの メンテナンスが行われる曜日を指定します。 「フライデー」
「月曜日」
「サタデー」
「サンデー」
「木曜日」
「火曜日」
'Wednesday' (必須)
インターバル月 各出現回数の間の月数を指定します。 int

制約：
最小値 = 1
最大値 = 6 (必須)
weekインデックス dayOfWeek が適用される月の週を指定します。 「最初」
「4番目」
「ラスト」
「セカンド」
'Third' (必須)

スケジュール

名前 説明 価値
絶対月次 "15 日に毎月繰り返す" や "20 日に 3 か月ごとに繰り返す" などのスケジュールの場合。 絶対的な月次スケジュール
日毎 "毎日繰り返し" や "3 日おきに繰り返す" などのスケジュールの場合。 デイリースケジュール
relative月次 "最初の月曜日に毎月繰り返す" や "先週の金曜日に 3 か月ごとに繰り返す" などのスケジュールの場合。 RelativeMonthlyスケジュール
ウィークリー "毎週月曜日に繰り返す" や "水曜日に 3 週間ごとに繰り返す" などのスケジュールの場合。 ウィークリースケジュール

タイムインウィーク

名前 説明 価値
日 曜日。 「フライデー」
「月曜日」
「サタデー」
「サンデー」
「木曜日」
「火曜日」
「水曜日」
アワースロット 各整数時間は、次の時間で終わる時間の後の 0m から始まる時間範囲を表します (非包括)。 0 は 00:00 UTC に対応し、23 は 23:00 UTC に対応します。 [0, 1] を指定すると、00:00 から 02:00 UTC の時間範囲が意味されます。 int

制約：
最小値 = 0
最大値 = 23[]

タイムスパン

名前 説明 価値
終了 期間の終わり 文字列
始める 期間の開始 文字列

ウィークリースケジュール

名前 説明 価値
dayOfWeekの メンテナンスが行われる曜日を指定します。 「フライデー」
「月曜日」
「サタデー」
「サンデー」
「木曜日」
「火曜日」
'Wednesday' (必須)
インターバルウィーク 各出現回数の間の週数を指定します。 int

制約：
最小値 = 1
最大値 = 4 (必須)