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 검증된 모듈 이 자원 유형을 배포하는 데 사용할 수 있습니다.
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
ConfigurationAssignmentFilterProperties
| 이름 |
Description |
Value |
| locations |
쿼리 범위를 지정하는 위치 목록입니다. |
string[] |
| osTypes |
허용되는 운영 체제 목록입니다. |
string[] |
| 리소스 그룹 |
허용되는 리소스 그룹 목록입니다. |
string[] |
| resourceTypes |
허용되는 리소스 목록입니다. |
string[] |
| 태그 설정 |
VM에 대한 태그 설정입니다. |
태그 설정속성 |
ConfigurationAssignmentProperties
| 이름 |
Description |
Value |
| filter연산자 |
지정된 태그를 모두 또는 모두 사용하여 VM을 필터링합니다. |
'All' '어떤' |
| tags |
값 목록이 있는 태그의 사전입니다. |
TagSettingsProperties태그 |
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연산자 |
지정된 태그를 모두 또는 모두 사용하여 VM을 필터링합니다. |
'All' '어떤' |
| tags |
값 목록이 있는 태그의 사전입니다. |
TagSettingsProperties태그 |
configurationAssignments 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
-
구독* 자원 그룹 각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
사용 예제
유지 관리 할당 배포의 기본 예입니다.
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연산자 |
지정된 태그를 모두 또는 모두 사용하여 VM을 필터링합니다. |
'All' '어떤' |
| tags |
값 목록이 있는 태그의 사전입니다. |
TagSettingsProperties태그 |