Microsoft. 유지보수 구성 할당 2025-10-01-미리보기

Bicep 자원 정의

configurationAssignments 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

사용 예제

Bicep 샘플

유지 관리 할당 배포의 기본 예입니다.

param resourceName string = 'acctest0001'
param location string = 'westeurope'
@secure()
@description('The administrator password for the virtual machine')
param adminPassword string

resource virtualMachine 'Microsoft.Compute/virtualMachines@2023-03-01' = {
  name: resourceName
  location: location
  properties: {
    additionalCapabilities: {}
    applicationProfile: {
      galleryApplications: []
    }
    diagnosticsProfile: {
      bootDiagnostics: {
        enabled: false
        storageUri: ''
      }
    }
    extensionsTimeBudget: 'PT1H30M'
    hardwareProfile: {
      vmSize: 'Standard_F2'
    }
    networkProfile: {
      networkInterfaces: [
        {
          id: networkInterface.id
          properties: {
            primary: true
          }
        }
      ]
    }
    osProfile: {
      adminPassword: adminPassword
      adminUsername: 'adminuser'
      allowExtensionOperations: true
      computerName: resourceName
      linuxConfiguration: {
        disablePasswordAuthentication: false
        patchSettings: {
          assessmentMode: 'ImageDefault'
          patchMode: 'ImageDefault'
        }
        provisionVMAgent: true
        ssh: {
          publicKeys: []
        }
      }
      secrets: []
    }
    priority: 'Regular'
    storageProfile: {
      dataDisks: []
      imageReference: {
        offer: 'UbuntuServer'
        publisher: 'Canonical'
        sku: '16.04-LTS'
        version: 'latest'
      }
      osDisk: {
        caching: 'ReadWrite'
        createOption: 'FromImage'
        managedDisk: {
          storageAccountType: 'Standard_LRS'
        }
        osType: 'Linux'
        writeAcceleratorEnabled: false
      }
    }
  }
}

resource virtualNetwork 'Microsoft.Network/virtualNetworks@2022-07-01' = {
  name: resourceName
  location: location
  properties: {
    addressSpace: {
      addressPrefixes: [
        '10.0.0.0/16'
      ]
    }
    dhcpOptions: {
      dnsServers: []
    }
    subnets: []
  }
}

resource subnet 'Microsoft.Network/virtualNetworks/subnets@2022-07-01' = {
  name: 'internal'
  parent: virtualNetwork
  properties: {
    addressPrefix: '10.0.2.0/24'
    delegations: []
    privateEndpointNetworkPolicies: 'Enabled'
    privateLinkServiceNetworkPolicies: 'Enabled'
    serviceEndpointPolicies: []
    serviceEndpoints: []
  }
}

resource configurationAssignment 'Microsoft.Maintenance/configurationAssignments@2022-07-01-preview' = {
  name: resourceName
  scope: virtualMachine
  properties: {
    maintenanceConfigurationId: maintenanceConfiguration.id
    resourceId: virtualMachine.id
  }
}

resource maintenanceConfiguration 'Microsoft.Maintenance/maintenanceConfigurations@2022-07-01-preview' = {
  name: resourceName
  location: location
  properties: {
    extensionProperties: {}
    maintenanceScope: 'SQLDB'
    namespace: 'Microsoft.Maintenance'
    visibility: 'Custom'
  }
}

resource networkInterface 'Microsoft.Network/networkInterfaces@2022-07-01' = {
  name: resourceName
  location: location
  properties: {
    enableAcceleratedNetworking: false
    enableIPForwarding: false
    ipConfigurations: [
      {
        name: 'testconfiguration1'
        properties: {
          primary: true
          privateIPAddressVersion: 'IPv4'
          privateIPAllocationMethod: 'Dynamic'
          subnet: {
            id: subnet.id
          }
        }
      }
    ]
  }
}

Azure 확인된 모듈

다음 Azure 검증된 모듈 이 자원 유형을 배포하는 데 사용할 수 있습니다.

모듈 Description
유지 관리 구성 할당 유지 관리 구성 할당을 위한 AVM 리소스 모듈

리소스 형식

Microsoft.Maintenance/configurationAssignments 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.Maintenance/configurationAssignments@2025-10-01-preview' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    filter: {
      locations: [
        'string'
      ]
      osTypes: [
        'string'
      ]
      resourceGroups: [
        'string'
      ]
      resourceTypes: [
        'string'
      ]
      tagSettings: {
        filterOperator: 'string'
        tags: {
          {customized property}: [
            'string'
          ]
        }
      }
    }
    maintenanceConfigurationId: 'string'
    resourceId: 'string'
  }
}

속성 값

Microsoft.Maintenance/configurationAssignments

이름 Description Value
location 리소스의 위치 string
name 리소스 이름 string(필수)
properties 구성 할당의 속성 ConfigurationAssignmentProperties
scope 배포 범위와 다른 범위에서 리소스를 만들 때 사용합니다. 이 속성을 자원의 상징 이름에 설정하여 extension resource를 적용하세요.

ConfigurationAssignmentFilterProperties

이름 Description Value
locations 쿼리 범위를 지정하는 위치 목록입니다. string[]
osTypes 허용되는 운영 체제 목록입니다. string[]
리소스 그룹 허용되는 리소스 그룹 목록입니다. string[]
resourceTypes 허용되는 리소스 목록입니다. string[]
태그 설정 VM에 대한 태그 설정입니다. 태그 설정속성

ConfigurationAssignmentProperties

이름 Description Value
filter 구성 할당의 속성 ConfigurationAssignmentFilterProperties
maintenanceConfigurationId 유지 관리 구성 ID string
resourceId 고유한 resourceId string

태그 설정속성

이름 Description Value
filter연산자 지정된 태그를 모두 또는 모두 사용하여 VM을 필터링합니다. 'All'
'어떤'
tags 값 목록이 있는 태그의 사전입니다. TagSettingsProperties태그

TagSettingsProperties태그

이름 Description Value

ARM 템플릿 리소스 정의

configurationAssignments 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

사용 예제

리소스 형식

Microsoft.Maintenance/configurationAssignments 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.Maintenance/configurationAssignments",
  "apiVersion": "2025-10-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "filter": {
      "locations": [ "string" ],
      "osTypes": [ "string" ],
      "resourceGroups": [ "string" ],
      "resourceTypes": [ "string" ],
      "tagSettings": {
        "filterOperator": "string",
        "tags": {
          "{customized property}": [ "string" ]
        }
      }
    },
    "maintenanceConfigurationId": "string",
    "resourceId": "string"
  }
}

속성 값

Microsoft.Maintenance/configurationAssignments

이름 Description Value
API버전 api 버전 '2025-10-01-미리보기'
location 리소스의 위치 string
name 리소스 이름 string(필수)
properties 구성 할당의 속성 ConfigurationAssignmentProperties
type 리소스 종류 'Microsoft.Maintenance/configurationAssignments'

ConfigurationAssignmentFilterProperties

이름 Description Value
locations 쿼리 범위를 지정하는 위치 목록입니다. string[]
osTypes 허용되는 운영 체제 목록입니다. string[]
리소스 그룹 허용되는 리소스 그룹 목록입니다. string[]
resourceTypes 허용되는 리소스 목록입니다. string[]
태그 설정 VM에 대한 태그 설정입니다. 태그 설정속성

ConfigurationAssignmentProperties

이름 Description Value
filter 구성 할당의 속성 ConfigurationAssignmentFilterProperties
maintenanceConfigurationId 유지 관리 구성 ID string
resourceId 고유한 resourceId string

태그 설정속성

이름 Description Value
filter연산자 지정된 태그를 모두 또는 모두 사용하여 VM을 필터링합니다. 'All'
'어떤'
tags 값 목록이 있는 태그의 사전입니다. TagSettingsProperties태그

TagSettingsProperties태그

이름 Description Value

Terraform(AzAPI 공급자) 리소스 정의

configurationAssignments 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

  • 구독* 자원 그룹 각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

사용 예제

Terraform 샘플

유지 관리 할당 배포의 기본 예입니다.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

variable "admin_password" {
  type        = string
  description = "The administrator password for the virtual machine"
  sensitive   = true
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "maintenanceConfiguration" {
  type      = "Microsoft.Maintenance/maintenanceConfigurations@2022-07-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      extensionProperties = {
      }
      maintenanceScope = "SQLDB"
      namespace        = "Microsoft.Maintenance"
      visibility       = "Custom"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "virtualNetwork" {
  type      = "Microsoft.Network/virtualNetworks@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      addressSpace = {
        addressPrefixes = [
          "10.0.0.0/16",
        ]
      }
      dhcpOptions = {
        dnsServers = [
        ]
      }
      subnets = [
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
  lifecycle {
    ignore_changes = [body.properties.subnets]
  }
}

resource "azapi_resource" "subnet" {
  type      = "Microsoft.Network/virtualNetworks/subnets@2022-07-01"
  parent_id = azapi_resource.virtualNetwork.id
  name      = "internal"
  body = {
    properties = {
      addressPrefix = "10.0.2.0/24"
      delegations = [
      ]
      privateEndpointNetworkPolicies    = "Enabled"
      privateLinkServiceNetworkPolicies = "Enabled"
      serviceEndpointPolicies = [
      ]
      serviceEndpoints = [
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "networkInterface" {
  type      = "Microsoft.Network/networkInterfaces@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      enableAcceleratedNetworking = false
      enableIPForwarding          = false
      ipConfigurations = [
        {
          name = "testconfiguration1"
          properties = {
            primary                   = true
            privateIPAddressVersion   = "IPv4"
            privateIPAllocationMethod = "Dynamic"
            subnet = {
              id = azapi_resource.subnet.id
            }
          }
        },
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "virtualMachine" {
  type      = "Microsoft.Compute/virtualMachines@2023-03-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      additionalCapabilities = {
      }
      applicationProfile = {
        galleryApplications = [
        ]
      }
      diagnosticsProfile = {
        bootDiagnostics = {
          enabled    = false
          storageUri = ""
        }
      }
      extensionsTimeBudget = "PT1H30M"
      hardwareProfile = {
        vmSize = "Standard_F2"
      }
      networkProfile = {
        networkInterfaces = [
          {
            id = azapi_resource.networkInterface.id
            properties = {
              primary = true
            }
          },
        ]
      }
      osProfile = {
        adminPassword            = var.admin_password
        adminUsername            = "adminuser"
        allowExtensionOperations = true
        computerName             = var.resource_name
        linuxConfiguration = {
          disablePasswordAuthentication = false
          patchSettings = {
            assessmentMode = "ImageDefault"
            patchMode      = "ImageDefault"
          }
          provisionVMAgent = true
          ssh = {
            publicKeys = [
            ]
          }
        }
        secrets = [
        ]
      }
      priority = "Regular"
      storageProfile = {
        dataDisks = [
        ]
        imageReference = {
          offer     = "UbuntuServer"
          publisher = "Canonical"
          sku       = "16.04-LTS"
          version   = "latest"
        }
        osDisk = {
          caching      = "ReadWrite"
          createOption = "FromImage"
          managedDisk = {
            storageAccountType = "Standard_LRS"
          }
          osType                  = "Linux"
          writeAcceleratorEnabled = false
        }
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "configurationAssignment" {
  type      = "Microsoft.Maintenance/configurationAssignments@2022-07-01-preview"
  parent_id = azapi_resource.virtualMachine.id
  name      = var.resource_name
  body = {
    location = "westeurope"
    properties = {
      maintenanceConfigurationId = azapi_resource.maintenanceConfiguration.id
      resourceId                 = azapi_resource.virtualMachine.id
    }
  }
  ignore_casing             = true
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

리소스 형식

Microsoft.Maintenance/configurationAssignments 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Maintenance/configurationAssignments@2025-10-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  body = {
    properties = {
      filter = {
        locations = [
          "string"
        ]
        osTypes = [
          "string"
        ]
        resourceGroups = [
          "string"
        ]
        resourceTypes = [
          "string"
        ]
        tagSettings = {
          filterOperator = "string"
          tags = {
            {customized property} = [
              "string"
            ]
          }
        }
      }
      maintenanceConfigurationId = "string"
      resourceId = "string"
    }
  }
}

속성 값

Microsoft.Maintenance/configurationAssignments

이름 Description Value
location 리소스의 위치 string
name 리소스 이름 string(필수)
parent_id 이 확장 리소스를 적용할 리소스의 ID입니다. string(필수)
properties 구성 할당의 속성 ConfigurationAssignmentProperties
type 리소스 종류 "Microsoft. 유지보수/configurationAssignments@2025-10-01-미리보기"

ConfigurationAssignmentFilterProperties

이름 Description Value
locations 쿼리 범위를 지정하는 위치 목록입니다. string[]
osTypes 허용되는 운영 체제 목록입니다. string[]
리소스 그룹 허용되는 리소스 그룹 목록입니다. string[]
resourceTypes 허용되는 리소스 목록입니다. string[]
태그 설정 VM에 대한 태그 설정입니다. 태그 설정속성

ConfigurationAssignmentProperties

이름 Description Value
filter 구성 할당의 속성 ConfigurationAssignmentFilterProperties
maintenanceConfigurationId 유지 관리 구성 ID string
resourceId 고유한 resourceId string

태그 설정속성

이름 Description Value
filter연산자 지정된 태그를 모두 또는 모두 사용하여 VM을 필터링합니다. 'All'
'어떤'
tags 값 목록이 있는 태그의 사전입니다. TagSettingsProperties태그

TagSettingsProperties태그

이름 Description Value