Microsoft. Kaynak dağıtımları

Açıklamalar

Bicep için, bu kaynak türü yerine using modules düşünün.

Bicep kaynak tanımı

Dağıtım kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Kiracı - Kiracı dağıtım komutlarını Yönetim* gruplarını Gör - Yönetim grubu dağıtım komutlarını* Abonelik - Abonelik dağıtım komutlarını* görKaynak grupları - Kaynak grubu dağıtım komutlarını gör - Kaynak grubu dağıtım komutlarını gör

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kullanım Örnekleri

Bicep Örnekleri

Şablon Dağıtımı dağıtımına ilişkin temel bir örnek.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource deployment 'Microsoft.Resources/deployments@2020-06-01' = {
  name: resourceName
  properties: {
    mode: 'Complete'
    template: {
      '$schema': 'https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#'
      contentVersion: '1.0.0.0'
      parameters: {
        storageAccountType: {
          allowedValues: [
            'Standard_LRS'
            'Standard_GRS'
            'Standard_ZRS'
          ]
          defaultValue: 'Standard_LRS'
          metadata: {
            description: 'Storage Account type'
          }
          type: 'string'
        }
      }
      resources: [
        {
          apiVersion: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
          location: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
          name: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
          properties: {
            accountType: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
          }
          type: 'Microsoft.Storage/storageAccounts'
        }
        {
          apiVersion: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
          location: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
          name: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
          properties: {
            dnsSettings: {
              domainNameLabel: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
            }
            publicIPAllocationMethod: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
          }
          type: 'Microsoft.Network/publicIPAddresses'
        }
      ]
      variables: {
        apiVersion: '2015-06-15'
        dnsLabelPrefix: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
        location: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
        publicIPAddressName: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
        publicIPAddressType: 'Dynamic'
        storageAccountName: /* ERROR: Unparsed HCL syntax in LiteralNode */ {}
      }
    }
  }
}

Kaynak biçimi

Bir Microsoft yaratmak için. Kaynak/dağıtım kaynağı, aşağıdaki Bicep'i şablonunuza ekleyin.

resource symbolicname 'Microsoft.Resources/deployments@2025-04-01' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    debugSetting: {
      detailLevel: 'string'
    }
    expressionEvaluationOptions: {
      scope: 'string'
    }
    extensionConfigs: {
      {customized property}: {
        {customized property}: {
          keyVaultReference: {
            keyVault: {
              id: 'string'
            }
            secretName: 'string'
            secretVersion: 'string'
          }
          value: any(...)
        }
      }
    }
    externalInputDefinitions: {
      {customized property}: {
        config: any(...)
        kind: 'string'
      }
    }
    externalInputs: {
      {customized property}: {
        value: any(...)
      }
    }
    mode: 'string'
    onErrorDeployment: {
      deploymentName: 'string'
      type: 'string'
    }
    parameters: {
      {customized property}: {
        expression: 'string'
        reference: {
          keyVault: {
            id: 'string'
          }
          secretName: 'string'
          secretVersion: 'string'
        }
        value: any(...)
      }
    }
    parametersLink: {
      contentVersion: 'string'
      uri: 'string'
    }
    template: any(...)
    templateLink: {
      contentVersion: 'string'
      id: 'string'
      queryString: 'string'
      relativePath: 'string'
      uri: 'string'
    }
    validationLevel: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Özellik Değerleri

Microsoft. Kaynaklar/dağıtımlar

İsim	Açıklama	Değer
kimlik	Bir dağıtım için Yönetilen Kimlik yapılandırması.	DeploymentIdentity (Dağıtım Kimliği)
konum	Dağıtım verilerini depolama konumu.	String
isim	Kaynak adı	karakter dizisi Kısıtlama -ları: En az uzunluk = 1 Maksimum uzunluk = 64 Desen = `^[-\w\._]+$` (gerekli)
özellikler	Dağıtım özellikleri.	DeploymentPropertiesOrDeploymentPropertiesExtended (gerekli)
kapsam	Dağıtım kapsamından farklı bir kapsamda kaynak oluştururken kullanın.	uzantısı kaynağınıuygulamak için bu özelliği kaynağın sembolik adı olarak ayarlayın.
Etiketler	Kaynak etiketleri	Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri

Hata Ayıklama Ayarı

İsim	Açıklama	Değer
detailLevel	Hata ayıklama için günlüğe kaydedilecek bilgi türünü belirtir. İzin verilen değerler hiçbiri, requestContent, responseContent veya hem requestContent hem de responseContent virgülle ayrılmış değerlerdir. Varsayılan değer yoktur. Bu değeri ayarlarken, dağıtım sırasında geçirdiğiniz bilgi türünü dikkatle göz önünde bulundurun. İstek veya yanıt hakkındaki bilgileri günlüğe kaydederek, dağıtım işlemleri aracılığıyla alınan hassas verileri kullanıma sunma olasılığınız vardır.	String

DeploymentExtensionConfigItem

İsim	Açıklama	Değer
keyVaultReference (Anahtar KasasıBaşvurusu)	Azure Key Vault referansı, uzantı yapılandırma özelliğinin gizli değerini almak için kullanılır.	KeyVaultParameterReference
değer	Uzantı config özelliğinin değeri.	herhangi

DeploymentExternalInput

İsim	Açıklama	Değer
değer	Harici giriş değeri.	herhangi biri (gerekli)

DeploymentExternalInputDefinition

İsim	Açıklama	Değer
konfigürasyon	Harici giriş için yapılandırma.	herhangi
tür	Harici girdi türü.	dize (gerekli)

DeploymentIdentity (Dağıtım Kimliği)

İsim	Açıklama	Değer
tür	Kimlik türü.	'Hiçbiri' 'UserAssigned' (gerekli)
kullanıcı tarafından atanan kimlikler	Kaynakla ilişkili kullanıcı tarafından atanan kimlik kümesi.	DeploymentIdentityUserAssignedIdentities

DeploymentIdentityUserAssignedIdentities

İsim	Açıklama	Değer

DeploymentParameter

İsim	Açıklama	Değer
ifade	Parametreye ifade girin.	String
referans	Azure Key Vault parametre başvurusu.	KeyVaultParameterReference
değer	Parametreye değer girin.	herhangi

DeploymentPropertiesExtensionConfigs

İsim	Açıklama	Değer

DeploymentPropertiesExternalInputDefinitions

İsim	Açıklama	Değer

DeploymentPropertiesExternalInputs

İsim	Açıklama	Değer

DeploymentPropertiesVeyaDeploymentPropertiesExtended

İsim	Açıklama	Değer
hata ayıklama ayarı	Dağıtımın hata ayıklama ayarı.	Hata Ayıklama Ayarı
expressionEvaluationOptions	Şablon ifadelerinin üst şablon kapsamında mı yoksa iç içe şablon mu kapsamında değerlendirileceğini belirtir. Yalnızca iç içe şablonlar için geçerlidir. Belirtilmezse, varsayılan değer dıştır.	İfadeDeğerlendirme Seçenekleri
extensionConfigs (uzantı Yapılandırmaları)	Dağıtım uzantıları için kullanılacak yapılandırmalar. Bu nesnenin anahtarları, dağıtım şablonunda tanımlandığı gibi dağıtım uzantısı diğer adlarıdır.	DeploymentPropertiesExtensionConfigs
externalInputDefinitions	Beklenen harici giriş değerlerini tanımlamak için harici araçlar tarafından kullanılan harici giriş tanımları.	DeploymentPropertiesExternalInputDefinitions
externalInput'lar	Parametre değerlendirmesi için harici araçlar tarafından kullanılan harici giriş değerleri.	DeploymentPropertiesExternalInputs
mod	Kaynakları dağıtmak için kullanılan mod. Bu değer Artımlı veya Tamamlandı olabilir. Artımlı modda, kaynaklar şablona dahil olmayan mevcut kaynaklar silinmeden dağıtılır. Tamamlandı modunda kaynaklar dağıtılır ve şablona dahil olmayan kaynak grubundaki mevcut kaynaklar silinir. İstenmeyen bir şekilde kaynakları silebileceği için Complete modunu kullanırken dikkatli olun.	'Tamamlandı' 'Artımlı' (gerekli)
onErrorDeployment	Hata davranışında dağıtım.	OnErrorDeploymentOrOnErrorDeploymentExtended
Parametreler	Şablon için dağıtım parametrelerini tanımlayan ad ve değer çiftleri. Parametre değerlerini mevcut parametre dosyasına bağlamak yerine doğrudan istekte sağlamak istediğinizde bu öğeyi kullanırsınız. parametersLink özelliğini veya parameters özelliğini kullanın, ancak ikisini birden kullanmayın. Bir JObject veya iyi biçimlendirilmiş bir JSON dizesi olabilir.	DeploymentPropertiesParameters
parametrelerBağlantı	Parametre dosyasının URI'sini. Var olan bir parametre dosyasına bağlanmak için bu öğeyi kullanırsınız. parametersLink özelliğini veya parameters özelliğini kullanın, ancak ikisini birden kullanmayın.	Parametreler Bağlantısı
şablon	Şablon içeriği. Şablon söz dizimini var olan bir şablona bağlamak yerine doğrudan istekte geçirmek istediğinizde bu öğeyi kullanırsınız. JObject veya iyi biçimlendirilmiş bir JSON dizesi olabilir. templateLink özelliğini veya şablon özelliğini kullanın, ancak ikisini birden kullanmayın.	herhangi
şablon bağlantısı	Şablonun URI'sini. templateLink özelliğini veya şablon özelliğini kullanın, ancak ikisini birden kullanmayın.	Şablon Bağlantısı
validationLevel	Dağıtımın doğrulama düzeyi	'Sağlayıcı' 'SağlayıcıNoRbac' 'Şablon'

DeploymentPropertiesParameters

İsim	Açıklama	Değer

DeploymentTags

İsim	Açıklama	Değer

DictionaryOfDeploymentExtensionConfigItem

İsim	Açıklama	Değer

İfadeDeğerlendirme Seçenekleri

İsim	Açıklama	Değer
kapsam	İç içe geçmiş bir şablondaki parametrelerin, değişkenlerin ve işlevlerin değerlendirilmesi için kullanılacak kapsam.	'İç' 'Belirtilmedi' 'Dış'

KeyVaultParameterReference

İsim	Açıklama	Değer
Anahtar Kasası	Azure Key Vault referansı.	KeyVaultReference (gerekli)
gizliAd	Azure Key Vault secret name.	dize (gerekli)
gizliVersiyon	Azure Key Vault gizli versiyonu.	String

KeyVaultReference

İsim	Açıklama	Değer
kimlik	Azure Key Vault resource id.	dize (gerekli)

OnErrorDeploymentOrOnErrorDeploymentExtended

İsim	Açıklama	Değer
dağıtımAdı	Hata durumunda kullanılacak dağıtım.	String
tür	Hata davranışı türündeki dağıtım. Olası değerler LastSuccessful ve SpecificDeployment değerleridir.	'Son Başarılı' 'SpecificDeployment'

Parametreler Bağlantısı

İsim	Açıklama	Değer
içerikSürümü	Varsa, şablondaki ContentVersion ile eşleşmelidir.	String
URI	Parametre dosyasının URI'sini.	dize (gerekli)

Şablon Bağlantısı

İsim	Açıklama	Değer
içerikSürümü	Varsa, şablondaki ContentVersion ile eşleşmelidir.	String
kimlik	Şablon Belirtiminin kaynak kimliği. Kimlik veya uri özelliğini kullanın, ancak ikisini birden kullanmayın.	String
queryString	templateLink URI'siyle kullanılacak sorgu dizesi (örneğin, sas belirteci).	String
relativePath (göreli Yol)	relativePath özelliği, bağlı şablonu üst şablona göre bir konuma dağıtmak için kullanılabilir. Üst şablon bir TemplateSpec ile bağlantılıysa bu, TemplateSpec içindeki bir yapıta başvurur. Üst öğe bir URI ile bağlantılıysa, alt dağıtım üst ve relativePath URI'lerinin bir bileşimi olacaktır	String
URI	Dağıtılacak şablonun URI'sini. Uri veya id özelliğini kullanın, ancak ikisini birden kullanmayın.	String

Kullanıcı Atanmış Kimlik

İsim	Açıklama	Değer

ARM şablonu kaynak tanımı

Dağıtım kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Kiracı - Kiracı dağıtım komutlarını Yönetim* gruplarını gör - Yönetim grubu dağıtım komutlarını* gör Abonelik - Abonelik dağıtım komutlarını* görKaynak grupları - Kaynak grubu dağıtım komutlarını gör Her API sürümünde değişen özelliklerin listesi için değişiklik günlüğüne bakınız.

Kullanım Örnekleri

Kaynak biçimi

Bir Microsoft yaratmak için. Kaynak/dağıtım kaynağı, aşağıdaki JSON'u şablonunuza ekleyin.

{
  "type": "Microsoft.Resources/deployments",
  "apiVersion": "2025-04-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "debugSetting": {
      "detailLevel": "string"
    },
    "expressionEvaluationOptions": {
      "scope": "string"
    },
    "extensionConfigs": {
      "{customized property}": {
        "{customized property}": {
          "keyVaultReference": {
            "keyVault": {
              "id": "string"
            },
            "secretName": "string",
            "secretVersion": "string"
          },
          "value": {}
        }
      }
    },
    "externalInputDefinitions": {
      "{customized property}": {
        "config": {},
        "kind": "string"
      }
    },
    "externalInputs": {
      "{customized property}": {
        "value": {}
      }
    },
    "mode": "string",
    "onErrorDeployment": {
      "deploymentName": "string",
      "type": "string"
    },
    "parameters": {
      "{customized property}": {
        "expression": "string",
        "reference": {
          "keyVault": {
            "id": "string"
          },
          "secretName": "string",
          "secretVersion": "string"
        },
        "value": {}
      }
    },
    "parametersLink": {
      "contentVersion": "string",
      "uri": "string"
    },
    "template": {},
    "templateLink": {
      "contentVersion": "string",
      "id": "string",
      "queryString": "string",
      "relativePath": "string",
      "uri": "string"
    },
    "validationLevel": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Özellik Değerleri

Microsoft. Kaynaklar/dağıtımlar

İsim	Açıklama	Değer
apiVersiyonu	API sürümü	'2025-04-01'
kimlik	Bir dağıtım için Yönetilen Kimlik yapılandırması.	DeploymentIdentity (Dağıtım Kimliği)
konum	Dağıtım verilerini depolama konumu.	String
isim	Kaynak adı	karakter dizisi Kısıtlama -ları: En az uzunluk = 1 Maksimum uzunluk = 64 Desen = `^[-\w\._]+$` (gerekli)
özellikler	Dağıtım özellikleri.	DeploymentPropertiesOrDeploymentPropertiesExtended (gerekli)
Etiketler	Kaynak etiketleri	Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri
tür	Kaynak türü	'Microsoft. Kaynaklar/dağıtımlar'

Hata Ayıklama Ayarı

İsim	Açıklama	Değer
detailLevel	Hata ayıklama için günlüğe kaydedilecek bilgi türünü belirtir. İzin verilen değerler hiçbiri, requestContent, responseContent veya hem requestContent hem de responseContent virgülle ayrılmış değerlerdir. Varsayılan değer yoktur. Bu değeri ayarlarken, dağıtım sırasında geçirdiğiniz bilgi türünü dikkatle göz önünde bulundurun. İstek veya yanıt hakkındaki bilgileri günlüğe kaydederek, dağıtım işlemleri aracılığıyla alınan hassas verileri kullanıma sunma olasılığınız vardır.	String

DeploymentExtensionConfigItem

İsim	Açıklama	Değer
keyVaultReference (Anahtar KasasıBaşvurusu)	Azure Key Vault referansı, uzantı yapılandırma özelliğinin gizli değerini almak için kullanılır.	KeyVaultParameterReference
değer	Uzantı config özelliğinin değeri.	herhangi

DeploymentExternalInput

İsim	Açıklama	Değer
değer	Harici giriş değeri.	herhangi biri (gerekli)

DeploymentExternalInputDefinition

İsim	Açıklama	Değer
konfigürasyon	Harici giriş için yapılandırma.	herhangi
tür	Harici girdi türü.	dize (gerekli)

DeploymentIdentity (Dağıtım Kimliği)

İsim	Açıklama	Değer
tür	Kimlik türü.	'Hiçbiri' 'UserAssigned' (gerekli)
kullanıcı tarafından atanan kimlikler	Kaynakla ilişkili kullanıcı tarafından atanan kimlik kümesi.	DeploymentIdentityUserAssignedIdentities

DeploymentIdentityUserAssignedIdentities

İsim	Açıklama	Değer

DeploymentParameter

İsim	Açıklama	Değer
ifade	Parametreye ifade girin.	String
referans	Azure Key Vault parametre başvurusu.	KeyVaultParameterReference
değer	Parametreye değer girin.	herhangi

DeploymentPropertiesExtensionConfigs

İsim	Açıklama	Değer

DeploymentPropertiesExternalInputDefinitions

İsim	Açıklama	Değer

DeploymentPropertiesExternalInputs

İsim	Açıklama	Değer

DeploymentPropertiesVeyaDeploymentPropertiesExtended

İsim	Açıklama	Değer
hata ayıklama ayarı	Dağıtımın hata ayıklama ayarı.	Hata Ayıklama Ayarı
expressionEvaluationOptions	Şablon ifadelerinin üst şablon kapsamında mı yoksa iç içe şablon mu kapsamında değerlendirileceğini belirtir. Yalnızca iç içe şablonlar için geçerlidir. Belirtilmezse, varsayılan değer dıştır.	İfadeDeğerlendirme Seçenekleri
extensionConfigs (uzantı Yapılandırmaları)	Dağıtım uzantıları için kullanılacak yapılandırmalar. Bu nesnenin anahtarları, dağıtım şablonunda tanımlandığı gibi dağıtım uzantısı diğer adlarıdır.	DeploymentPropertiesExtensionConfigs
externalInputDefinitions	Beklenen harici giriş değerlerini tanımlamak için harici araçlar tarafından kullanılan harici giriş tanımları.	DeploymentPropertiesExternalInputDefinitions
externalInput'lar	Parametre değerlendirmesi için harici araçlar tarafından kullanılan harici giriş değerleri.	DeploymentPropertiesExternalInputs
mod	Kaynakları dağıtmak için kullanılan mod. Bu değer Artımlı veya Tamamlandı olabilir. Artımlı modda, kaynaklar şablona dahil olmayan mevcut kaynaklar silinmeden dağıtılır. Tamamlandı modunda kaynaklar dağıtılır ve şablona dahil olmayan kaynak grubundaki mevcut kaynaklar silinir. İstenmeyen bir şekilde kaynakları silebileceği için Complete modunu kullanırken dikkatli olun.	'Tamamlandı' 'Artımlı' (gerekli)
onErrorDeployment	Hata davranışında dağıtım.	OnErrorDeploymentOrOnErrorDeploymentExtended
Parametreler	Şablon için dağıtım parametrelerini tanımlayan ad ve değer çiftleri. Parametre değerlerini mevcut parametre dosyasına bağlamak yerine doğrudan istekte sağlamak istediğinizde bu öğeyi kullanırsınız. parametersLink özelliğini veya parameters özelliğini kullanın, ancak ikisini birden kullanmayın. Bir JObject veya iyi biçimlendirilmiş bir JSON dizesi olabilir.	DeploymentPropertiesParameters
parametrelerBağlantı	Parametre dosyasının URI'sini. Var olan bir parametre dosyasına bağlanmak için bu öğeyi kullanırsınız. parametersLink özelliğini veya parameters özelliğini kullanın, ancak ikisini birden kullanmayın.	Parametreler Bağlantısı
şablon	Şablon içeriği. Şablon söz dizimini var olan bir şablona bağlamak yerine doğrudan istekte geçirmek istediğinizde bu öğeyi kullanırsınız. JObject veya iyi biçimlendirilmiş bir JSON dizesi olabilir. templateLink özelliğini veya şablon özelliğini kullanın, ancak ikisini birden kullanmayın.	herhangi
şablon bağlantısı	Şablonun URI'sini. templateLink özelliğini veya şablon özelliğini kullanın, ancak ikisini birden kullanmayın.	Şablon Bağlantısı
validationLevel	Dağıtımın doğrulama düzeyi	'Sağlayıcı' 'SağlayıcıNoRbac' 'Şablon'

DeploymentPropertiesParameters

İsim	Açıklama	Değer

DeploymentTags

İsim	Açıklama	Değer

DictionaryOfDeploymentExtensionConfigItem

İsim	Açıklama	Değer

İfadeDeğerlendirme Seçenekleri

İsim	Açıklama	Değer
kapsam	İç içe geçmiş bir şablondaki parametrelerin, değişkenlerin ve işlevlerin değerlendirilmesi için kullanılacak kapsam.	'İç' 'Belirtilmedi' 'Dış'

KeyVaultParameterReference

İsim	Açıklama	Değer
Anahtar Kasası	Azure Key Vault referansı.	KeyVaultReference (gerekli)
gizliAd	Azure Key Vault secret name.	dize (gerekli)
gizliVersiyon	Azure Key Vault gizli versiyonu.	String

KeyVaultReference

İsim	Açıklama	Değer
kimlik	Azure Key Vault resource id.	dize (gerekli)

OnErrorDeploymentOrOnErrorDeploymentExtended

İsim	Açıklama	Değer
dağıtımAdı	Hata durumunda kullanılacak dağıtım.	String
tür	Hata davranışı türündeki dağıtım. Olası değerler LastSuccessful ve SpecificDeployment değerleridir.	'Son Başarılı' 'SpecificDeployment'

Parametreler Bağlantısı

İsim	Açıklama	Değer
içerikSürümü	Varsa, şablondaki ContentVersion ile eşleşmelidir.	String
URI	Parametre dosyasının URI'sini.	dize (gerekli)

Şablon Bağlantısı

İsim	Açıklama	Değer
içerikSürümü	Varsa, şablondaki ContentVersion ile eşleşmelidir.	String
kimlik	Şablon Belirtiminin kaynak kimliği. Kimlik veya uri özelliğini kullanın, ancak ikisini birden kullanmayın.	String
queryString	templateLink URI'siyle kullanılacak sorgu dizesi (örneğin, sas belirteci).	String
relativePath (göreli Yol)	relativePath özelliği, bağlı şablonu üst şablona göre bir konuma dağıtmak için kullanılabilir. Üst şablon bir TemplateSpec ile bağlantılıysa bu, TemplateSpec içindeki bir yapıta başvurur. Üst öğe bir URI ile bağlantılıysa, alt dağıtım üst ve relativePath URI'lerinin bir bileşimi olacaktır	String
URI	Dağıtılacak şablonun URI'sini. Uri veya id özelliğini kullanın, ancak ikisini birden kullanmayın.	String

Kullanıcı Atanmış Kimlik

İsim	Açıklama	Değer

Terraform (AzAPI sağlayıcısı) kaynak tanımı

Dağıtım kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Kiracı* Yönetim grupları* Abonelik* Kaynak grupları Her API sürümünde değişen özelliklerin listesi için bkz. Değişiklik günlüğü.

Kullanım Örnekleri

Terraform Örnekleri

Şablon Dağıtımı dağıtımına ilişkin temel bir örnek.

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"
}

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

resource "azapi_resource" "deployment" {
  type      = "Microsoft.Resources/deployments@2020-06-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  body = {
    properties = {
      mode = "Complete"
      template = {
        "$schema"      = "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#"
        contentVersion = "1.0.0.0"
        parameters = {
          storageAccountType = {
            allowedValues = [
              "Standard_LRS",
              "Standard_GRS",
              "Standard_ZRS",
            ]
            defaultValue = "Standard_LRS"
            metadata = {
              description = "Storage Account type"
            }
            type = "string"
          }
        }
        resources = [
          {
            apiVersion = "[variables('apiVersion')]"
            location   = "[variables('location')]"
            name       = "[variables('storageAccountName')]"
            properties = {
              accountType = "[parameters('storageAccountType')]"
            }
            type = "Microsoft.Storage/storageAccounts"
          },
          {
            apiVersion = "[variables('apiVersion')]"
            location   = "[variables('location')]"
            name       = "[variables('publicIPAddressName')]"
            properties = {
              dnsSettings = {
                domainNameLabel = "[variables('dnsLabelPrefix')]"
              }
              publicIPAllocationMethod = "[variables('publicIPAddressType')]"
            }
            type = "Microsoft.Network/publicIPAddresses"
          },
        ]
        variables = {
          apiVersion          = "2015-06-15"
          dnsLabelPrefix      = "[concat('terraform-tdacctest', uniquestring(resourceGroup().id))]"
          location            = "[resourceGroup().location]"
          publicIPAddressName = "[concat('myPublicIp', uniquestring(resourceGroup().id))]"
          publicIPAddressType = "Dynamic"
          storageAccountName  = "[concat(uniquestring(resourceGroup().id), 'storage')]"
        }
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Kaynak biçimi

Bir Microsoft yaratmak için. Kaynaklar/dağıtım kaynakları, aşağıdaki Terraform'u şablonunuza ekleyin.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Resources/deployments@2025-04-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      debugSetting = {
        detailLevel = "string"
      }
      expressionEvaluationOptions = {
        scope = "string"
      }
      extensionConfigs = {
        {customized property} = {
          {customized property} = {
            keyVaultReference = {
              keyVault = {
                id = "string"
              }
              secretName = "string"
              secretVersion = "string"
            }
            value = ?
          }
        }
      }
      externalInputDefinitions = {
        {customized property} = {
          config = ?
          kind = "string"
        }
      }
      externalInputs = {
        {customized property} = {
          value = ?
        }
      }
      mode = "string"
      onErrorDeployment = {
        deploymentName = "string"
        type = "string"
      }
      parameters = {
        {customized property} = {
          expression = "string"
          reference = {
            keyVault = {
              id = "string"
            }
            secretName = "string"
            secretVersion = "string"
          }
          value = ?
        }
      }
      parametersLink = {
        contentVersion = "string"
        uri = "string"
      }
      template = ?
      templateLink = {
        contentVersion = "string"
        id = "string"
        queryString = "string"
        relativePath = "string"
        uri = "string"
      }
      validationLevel = "string"
    }
  }
}

Özellik Değerleri

Microsoft. Kaynaklar/dağıtımlar

İsim	Açıklama	Değer
kimlik	Bir dağıtım için Yönetilen Kimlik yapılandırması.	DeploymentIdentity (Dağıtım Kimliği)
konum	Dağıtım verilerini depolama konumu.	String
isim	Kaynak adı	karakter dizisi Kısıtlama -ları: En az uzunluk = 1 Maksimum uzunluk = 64 Desen = `^[-\w\._]+$` (gerekli)
ebeveyn_kimlik	Bu uzantı kaynağının uygulanacağı kaynağın kimliği.	dize (gerekli)
özellikler	Dağıtım özellikleri.	DeploymentPropertiesOrDeploymentPropertiesExtended (gerekli)
Etiketler	Kaynak etiketleri	Etiket adları ve değerleri sözlüğü.
tür	Kaynak türü	"Microsoft. Kaynaklar/deployments@2025-04-01"

Hata Ayıklama Ayarı

İsim	Açıklama	Değer
detailLevel	Hata ayıklama için günlüğe kaydedilecek bilgi türünü belirtir. İzin verilen değerler hiçbiri, requestContent, responseContent veya hem requestContent hem de responseContent virgülle ayrılmış değerlerdir. Varsayılan değer yoktur. Bu değeri ayarlarken, dağıtım sırasında geçirdiğiniz bilgi türünü dikkatle göz önünde bulundurun. İstek veya yanıt hakkındaki bilgileri günlüğe kaydederek, dağıtım işlemleri aracılığıyla alınan hassas verileri kullanıma sunma olasılığınız vardır.	String

DeploymentExtensionConfigItem

İsim	Açıklama	Değer
keyVaultReference (Anahtar KasasıBaşvurusu)	Azure Key Vault referansı, uzantı yapılandırma özelliğinin gizli değerini almak için kullanılır.	KeyVaultParameterReference
değer	Uzantı config özelliğinin değeri.	herhangi

DeploymentExternalInput

İsim	Açıklama	Değer
değer	Harici giriş değeri.	herhangi biri (gerekli)

DeploymentExternalInputDefinition

İsim	Açıklama	Değer
konfigürasyon	Harici giriş için yapılandırma.	herhangi
tür	Harici girdi türü.	dize (gerekli)

DeploymentIdentity (Dağıtım Kimliği)

İsim	Açıklama	Değer
tür	Kimlik türü.	'Hiçbiri' 'UserAssigned' (gerekli)
kullanıcı tarafından atanan kimlikler	Kaynakla ilişkili kullanıcı tarafından atanan kimlik kümesi.	DeploymentIdentityUserAssignedIdentities

DeploymentIdentityUserAssignedIdentities

İsim	Açıklama	Değer

DeploymentParameter

İsim	Açıklama	Değer
ifade	Parametreye ifade girin.	String
referans	Azure Key Vault parametre başvurusu.	KeyVaultParameterReference
değer	Parametreye değer girin.	herhangi

DeploymentPropertiesExtensionConfigs

İsim	Açıklama	Değer

DeploymentPropertiesExternalInputDefinitions

İsim	Açıklama	Değer

DeploymentPropertiesExternalInputs

İsim	Açıklama	Değer

DeploymentPropertiesVeyaDeploymentPropertiesExtended

İsim	Açıklama	Değer
hata ayıklama ayarı	Dağıtımın hata ayıklama ayarı.	Hata Ayıklama Ayarı
expressionEvaluationOptions	Şablon ifadelerinin üst şablon kapsamında mı yoksa iç içe şablon mu kapsamında değerlendirileceğini belirtir. Yalnızca iç içe şablonlar için geçerlidir. Belirtilmezse, varsayılan değer dıştır.	İfadeDeğerlendirme Seçenekleri
extensionConfigs (uzantı Yapılandırmaları)	Dağıtım uzantıları için kullanılacak yapılandırmalar. Bu nesnenin anahtarları, dağıtım şablonunda tanımlandığı gibi dağıtım uzantısı diğer adlarıdır.	DeploymentPropertiesExtensionConfigs
externalInputDefinitions	Beklenen harici giriş değerlerini tanımlamak için harici araçlar tarafından kullanılan harici giriş tanımları.	DeploymentPropertiesExternalInputDefinitions
externalInput'lar	Parametre değerlendirmesi için harici araçlar tarafından kullanılan harici giriş değerleri.	DeploymentPropertiesExternalInputs
mod	Kaynakları dağıtmak için kullanılan mod. Bu değer Artımlı veya Tamamlandı olabilir. Artımlı modda, kaynaklar şablona dahil olmayan mevcut kaynaklar silinmeden dağıtılır. Tamamlandı modunda kaynaklar dağıtılır ve şablona dahil olmayan kaynak grubundaki mevcut kaynaklar silinir. İstenmeyen bir şekilde kaynakları silebileceği için Complete modunu kullanırken dikkatli olun.	'Tamamlandı' 'Artımlı' (gerekli)
onErrorDeployment	Hata davranışında dağıtım.	OnErrorDeploymentOrOnErrorDeploymentExtended
Parametreler	Şablon için dağıtım parametrelerini tanımlayan ad ve değer çiftleri. Parametre değerlerini mevcut parametre dosyasına bağlamak yerine doğrudan istekte sağlamak istediğinizde bu öğeyi kullanırsınız. parametersLink özelliğini veya parameters özelliğini kullanın, ancak ikisini birden kullanmayın. Bir JObject veya iyi biçimlendirilmiş bir JSON dizesi olabilir.	DeploymentPropertiesParameters
parametrelerBağlantı	Parametre dosyasının URI'sini. Var olan bir parametre dosyasına bağlanmak için bu öğeyi kullanırsınız. parametersLink özelliğini veya parameters özelliğini kullanın, ancak ikisini birden kullanmayın.	Parametreler Bağlantısı
şablon	Şablon içeriği. Şablon söz dizimini var olan bir şablona bağlamak yerine doğrudan istekte geçirmek istediğinizde bu öğeyi kullanırsınız. JObject veya iyi biçimlendirilmiş bir JSON dizesi olabilir. templateLink özelliğini veya şablon özelliğini kullanın, ancak ikisini birden kullanmayın.	herhangi
şablon bağlantısı	Şablonun URI'sini. templateLink özelliğini veya şablon özelliğini kullanın, ancak ikisini birden kullanmayın.	Şablon Bağlantısı
validationLevel	Dağıtımın doğrulama düzeyi	'Sağlayıcı' 'SağlayıcıNoRbac' 'Şablon'

DeploymentPropertiesParameters

İsim	Açıklama	Değer

DeploymentTags

İsim	Açıklama	Değer

DictionaryOfDeploymentExtensionConfigItem

İsim	Açıklama	Değer

İfadeDeğerlendirme Seçenekleri

İsim	Açıklama	Değer
kapsam	İç içe geçmiş bir şablondaki parametrelerin, değişkenlerin ve işlevlerin değerlendirilmesi için kullanılacak kapsam.	'İç' 'Belirtilmedi' 'Dış'

KeyVaultParameterReference

İsim	Açıklama	Değer
Anahtar Kasası	Azure Key Vault referansı.	KeyVaultReference (gerekli)
gizliAd	Azure Key Vault secret name.	dize (gerekli)
gizliVersiyon	Azure Key Vault gizli versiyonu.	String

KeyVaultReference

İsim	Açıklama	Değer
kimlik	Azure Key Vault resource id.	dize (gerekli)

OnErrorDeploymentOrOnErrorDeploymentExtended

İsim	Açıklama	Değer
dağıtımAdı	Hata durumunda kullanılacak dağıtım.	String
tür	Hata davranışı türündeki dağıtım. Olası değerler LastSuccessful ve SpecificDeployment değerleridir.	'Son Başarılı' 'SpecificDeployment'

Parametreler Bağlantısı

İsim	Açıklama	Değer
içerikSürümü	Varsa, şablondaki ContentVersion ile eşleşmelidir.	String
URI	Parametre dosyasının URI'sini.	dize (gerekli)

Şablon Bağlantısı

İsim	Açıklama	Değer
içerikSürümü	Varsa, şablondaki ContentVersion ile eşleşmelidir.	String
kimlik	Şablon Belirtiminin kaynak kimliği. Kimlik veya uri özelliğini kullanın, ancak ikisini birden kullanmayın.	String
queryString	templateLink URI'siyle kullanılacak sorgu dizesi (örneğin, sas belirteci).	String
relativePath (göreli Yol)	relativePath özelliği, bağlı şablonu üst şablona göre bir konuma dağıtmak için kullanılabilir. Üst şablon bir TemplateSpec ile bağlantılıysa bu, TemplateSpec içindeki bir yapıta başvurur. Üst öğe bir URI ile bağlantılıysa, alt dağıtım üst ve relativePath URI'lerinin bir bileşimi olacaktır	String
URI	Dağıtılacak şablonun URI'sini. Uri veya id özelliğini kullanın, ancak ikisini birden kullanmayın.	String

Kullanıcı Atanmış Kimlik

İsim	Açıklama	Değer

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-04-14