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

Maintenance Configurations - Create Or Update

服务:: AKS

API 版本:: 2025-03-01

在指定的托管群集中创建或更新维护配置。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/maintenanceConfigurations/{configName}?api-version=2025-03-01

URI 参数

名称	在	必需	类型	说明
configName	path	True	string	维护配置的名称。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。此名称不区分大小写。
resourceName	path	True	string minLength: 1 maxLength: 63 pattern: ^[a-zA-Z0-9]$\|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$	托管群集资源的名称。
subscriptionId	path	True	string (uuid)	目标订阅的 ID。该值必须是 UUID。
api-version	query	True	string minLength: 1	用于此操作的 API 版本。

请求正文

名称	类型	说明
properties.maintenanceWindow	MaintenanceWindow	维护配置的维护时段。
properties.notAllowedTime	TimeSpan[]	不允许升级的时间段。
properties.timeInWeek	TimeInWeek[]	允许计划内维护继续的一周中的时间段。如果两个数组条目指定一周中的同一天，则应用的配置是这两个条目中的时间联合。

响应

名称	类型	说明
200 OK	MaintenanceConfiguration	已成功更新现有的维护配置。
201 Created	MaintenanceConfiguration	已成功创建新的维护配置。
Other Status Codes	CloudError	描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Create/Update Maintenance Configuration

Create/Update Maintenance Configuration with Maintenance Window

Create/Update Maintenance Configuration

示例请求

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/maintenanceConfigurations/default?api-version=2025-03-01

{
  "properties": {
    "timeInWeek": [
      {
        "day": "Monday",
        "hourSlots": [
          1,
          2
        ]
      }
    ],
    "notAllowedTime": [
      {
        "start": "2020-11-26T03:00:00Z",
        "end": "2020-11-30T12:00:00Z"
      }
    ]
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.containerservice import ContainerServiceClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-containerservice
# USAGE
    python maintenance_configurations_create_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ContainerServiceClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.maintenance_configurations.create_or_update(
        resource_group_name="rg1",
        resource_name="clustername1",
        config_name="default",
        parameters={
            "properties": {
                "notAllowedTime": [{"end": "2020-11-30T12:00:00Z", "start": "2020-11-26T03:00:00Z"}],
                "timeInWeek": [{"day": "Monday", "hourSlots": [1, 2]}],
            }
        },
    )
    print(response)


# x-ms-original-file: specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-03-01/examples/MaintenanceConfigurationsCreate_Update.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Creates or updates a maintenance configuration in the specified managed cluster.
 *
 * @summary Creates or updates a maintenance configuration in the specified managed cluster.
 * x-ms-original-file: specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-03-01/examples/MaintenanceConfigurationsCreate_Update.json
 */
async function createOrUpdateMaintenanceConfiguration() {
  const subscriptionId =
    process.env["CONTAINERSERVICE_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["CONTAINERSERVICE_RESOURCE_GROUP"] || "rg1";
  const resourceName = "clustername1";
  const configName = "default";
  const parameters = {
    notAllowedTime: [
      {
        end: new Date("2020-11-30T12:00:00Z"),
        start: new Date("2020-11-26T03:00:00Z"),
      },
    ],
    timeInWeek: [{ day: "Monday", hourSlots: [1, 2] }],
  };
  const credential = new DefaultAzureCredential();
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.maintenanceConfigurations.createOrUpdate(
    resourceGroupName,
    resourceName,
    configName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

示例响应

状态代码:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/maintenanceConfigurations/default",
  "type": "Microsoft.ContainerService/managedClusters/maintenanceConfigurations",
  "name": "default",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "timeInWeek": [
      {
        "day": "Monday",
        "hourSlots": [
          1,
          2
        ]
      }
    ],
    "notAllowedTime": [
      {
        "start": "2020-11-26T03:00:00Z",
        "end": "2020-11-30T12:00:00Z"
      }
    ]
  }
}

状态代码:: 201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/maintenanceConfigurations/default",
  "type": "Microsoft.ContainerService/managedClusters/maintenanceConfigurations",
  "name": "default",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "timeInWeek": [
      {
        "day": "Monday",
        "hourSlots": [
          1,
          2
        ]
      }
    ],
    "notAllowedTime": [
      {
        "start": "2020-11-26T03:00:00Z",
        "end": "2020-11-30T12:00:00Z"
      }
    ]
  }
}

Create/Update Maintenance Configuration with Maintenance Window

示例请求

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/maintenanceConfigurations/aksManagedAutoUpgradeSchedule?api-version=2025-03-01

{
  "properties": {
    "maintenanceWindow": {
      "schedule": {
        "relativeMonthly": {
          "intervalMonths": 3,
          "weekIndex": "First",
          "dayOfWeek": "Monday"
        }
      },
      "durationHours": 10,
      "utcOffset": "+05:30",
      "startDate": "2023-01-01",
      "startTime": "08:30",
      "notAllowedDates": [
        {
          "start": "2023-02-18",
          "end": "2023-02-25"
        },
        {
          "start": "2023-12-23",
          "end": "2024-01-05"
        }
      ]
    }
  }
}

from azure.identity import DefaultAzureCredential

from azure.mgmt.containerservice import ContainerServiceClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-containerservice
# USAGE
    python maintenance_configurations_create_update_maintenance_window.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ContainerServiceClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.maintenance_configurations.create_or_update(
        resource_group_name="rg1",
        resource_name="clustername1",
        config_name="aksManagedAutoUpgradeSchedule",
        parameters={
            "properties": {
                "maintenanceWindow": {
                    "durationHours": 10,
                    "notAllowedDates": [
                        {"end": "2023-02-25", "start": "2023-02-18"},
                        {"end": "2024-01-05", "start": "2023-12-23"},
                    ],
                    "schedule": {"relativeMonthly": {"dayOfWeek": "Monday", "intervalMonths": 3, "weekIndex": "First"}},
                    "startDate": "2023-01-01",
                    "startTime": "08:30",
                    "utcOffset": "+05:30",
                }
            }
        },
    )
    print(response)


# x-ms-original-file: specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-03-01/examples/MaintenanceConfigurationsCreate_Update_MaintenanceWindow.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Creates or updates a maintenance configuration in the specified managed cluster.
 *
 * @summary Creates or updates a maintenance configuration in the specified managed cluster.
 * x-ms-original-file: specification/containerservice/resource-manager/Microsoft.ContainerService/aks/stable/2025-03-01/examples/MaintenanceConfigurationsCreate_Update_MaintenanceWindow.json
 */
async function createOrUpdateMaintenanceConfigurationWithMaintenanceWindow() {
  const subscriptionId =
    process.env["CONTAINERSERVICE_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["CONTAINERSERVICE_RESOURCE_GROUP"] || "rg1";
  const resourceName = "clustername1";
  const configName = "aksManagedAutoUpgradeSchedule";
  const parameters = {
    maintenanceWindow: {
      durationHours: 10,
      notAllowedDates: [
        { end: new Date("2023-02-25"), start: new Date("2023-02-18") },
        { end: new Date("2024-01-05"), start: new Date("2023-12-23") },
      ],
      schedule: {
        relativeMonthly: {
          dayOfWeek: "Monday",
          intervalMonths: 3,
          weekIndex: "First",
        },
      },
      startDate: new Date("2023-01-01"),
      startTime: "08:30",
      utcOffset: "+05:30",
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new ContainerServiceClient(credential, subscriptionId);
  const result = await client.maintenanceConfigurations.createOrUpdate(
    resourceGroupName,
    resourceName,
    configName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

示例响应

状态代码:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/maintenanceConfigurations/aksManagedAutoUpgradeSchedule",
  "name": "aksManagedAutoUpgradeSchedule",
  "properties": {
    "maintenanceWindow": {
      "schedule": {
        "weekly": {
          "intervalWeeks": 3,
          "dayOfWeek": "Monday"
        }
      },
      "durationHours": 10,
      "utcOffset": "+05:30",
      "startDate": "2023-01-01",
      "startTime": "08:30",
      "notAllowedDates": [
        {
          "start": "2023-02-18",
          "end": "2023-02-25"
        },
        {
          "start": "2023-12-23",
          "end": "2024-01-05"
        }
      ]
    }
  }
}

状态代码:: 201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/maintenanceConfigurations/aksManagedAutoUpgradeSchedule",
  "name": "aksManagedAutoUpgradeSchedule",
  "properties": {
    "maintenanceWindow": {
      "schedule": {
        "weekly": {
          "intervalWeeks": 3,
          "dayOfWeek": "Monday"
        }
      },
      "durationHours": 10,
      "utcOffset": "+05:30",
      "startDate": "2023-01-01",
      "startTime": "08:30",
      "notAllowedDates": [
        {
          "start": "2023-02-18",
          "end": "2023-02-25"
        },
        {
          "start": "2023-12-23",
          "end": "2024-01-05"
        }
      ]
    }
  }
}

定义

名称	说明
AbsoluteMonthlySchedule	对于计划，例如：“15 日每月递归”或“20 日每 3 个月递归一次”。
CloudError	容器服务的错误响应。
CloudErrorBody	容器服务的错误响应。
createdByType	创建资源的标识的类型。
DailySchedule	对于计划，例如：“每天递归”或“每 3 天递归一次”。
DateSpan	日期范围。
MaintenanceConfiguration	计划内维护配置，用于配置何时可以将更新部署到托管群集。
MaintenanceWindow	用于为托管群集配置计划的自动升级的维护时段。
RelativeMonthlySchedule	对于计划，例如：“在第一个星期一每月递归”或“上周五每 3 个月递归一次”。
Schedule	应指定一种和仅一种计划类型。为维护计划选择“daily”、“weekly”、“absoluteMonthly”或“relativeMonthly”。
systemData	与创建和上次修改资源相关的元数据。
TimeInWeek	一周内的时间。
TimeSpan	时间范围。
type	周索引。
WeekDay	工作日枚举。
WeeklySchedule	对于计划，例如：“每周一递归”或“周三每 3 周重复一次”。

AbsoluteMonthlySchedule

Object

对于计划，例如：“15 日每月递归”或“20 日每 3 个月递归一次”。

名称	类型	说明
dayOfMonth	integer (int32) minimum: 1 maximum: 31	月份的日期。
intervalMonths	integer (int32) minimum: 1 maximum: 6	指定每个匹配项集之间的月数。

CloudError

Object

容器服务的错误响应。

名称	类型	说明
error	CloudErrorBody	有关错误的详细信息。

CloudErrorBody

Object

容器服务的错误响应。

名称	类型	说明
code	string	错误的标识符。代码是固定的，旨在以编程方式使用。
details	CloudErrorBody[]	有关错误的其他详细信息的列表。
message	string	描述错误的消息，旨在适合在用户界面中显示。
target	string	特定错误的目标。例如，错误属性的名称。

createdByType

枚举

创建资源的标识的类型。

值	说明
Application
Key
ManagedIdentity
User

DailySchedule

Object

对于计划，例如：“每天递归”或“每 3 天递归一次”。

名称	类型	说明
intervalDays	integer (int32) minimum: 1 maximum: 7	指定每个匹配项集之间的天数。

DateSpan

Object

日期范围。

名称	类型	说明
end	string (date)	日期范围的结束日期。
start	string (date)	日期范围的开始日期。