Bicep için dağıtım işlevleri
Bu makalede, geçerli dağıtımla ilgili değerleri almaya yönelik Bicep işlevleri açıklanmaktadır.
dağıtım
deployment()
Geçerli dağıtım işlemi hakkındaki bilgileri döndürür.
Ad alanı: az.
Dönüş değeri
Bu işlev, dağıtım sırasında geçirilen nesneyi döndürür. Döndürülen nesnedeki özellikler, aşağıdakilerden farklı olup olmadığınız temelinde değişir:
- yerel bicep dosyası dağıtma.
- bir kaynak grubuna dağıtma veya diğer kapsamlardan birine dağıtma (Azure aboneliği, yönetim grubu veya kiracı).
Yerel bicep dosyasını bir kaynak grubuna dağıtırken işlev aşağıdaki biçimi döndürür:
{
"name": "",
"properties": {
"template": {
"$schema": "",
"contentVersion": "",
"parameters": {},
"variables": {},
"resources": [],
"outputs": {}
},
"templateHash": "",
"parameters": {},
"mode": "",
"provisioningState": ""
}
}
Bir Azure aboneliğine, yönetim grubuna veya kiracıya dağıttığınızda, dönüş nesnesi bir location
özellik içerir. location
Özelliği yerel bicep dosyası dağıtılırken dahil değildir. Biçim:
{
"name": "",
"location": "",
"properties": {
"template": {
"$schema": "",
"contentVersion": "",
"resources": [],
"outputs": {}
},
"templateHash": "",
"parameters": {},
"mode": "",
"provisioningState": ""
}
}
Örnek
Aşağıdaki örnek dağıtım nesnesini döndürür:
output deploymentOutput object = deployment()
Yukarıdaki örnek aşağıdaki nesneyi döndürür:
{
"name": "deployment",
"properties": {
"template": {
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [],
"outputs": {
"deploymentOutput": {
"type": "Object",
"value": "[deployment()]"
}
}
},
"templateHash": "13135986259522608210",
"parameters": {},
"mode": "Incremental",
"provisioningState": "Accepted"
}
}
ortamı
environment()
Dağıtım için kullanılan Azure ortamı hakkındaki bilgileri döndürür. environment()
İşlev, kaynak yapılandırmalarının farkında değildir. Her kaynak türü için yalnızca tek bir varsayılan DNS son eki döndürebilir.
Ad alanı: az.
Açıklamalar
Hesabınız için kayıtlı ortamların listesini görmek için az cloud list veya Get-AzEnvironment kullanın.
Dönüş değeri
Bu işlev, geçerli Azure ortamının özelliklerini döndürür. Aşağıdaki örnekte genel Azure'ın özellikleri gösterilmektedir. Bağımsız bulutlar biraz farklı özellikler döndürebilir.
{
"name": "",
"gallery": "",
"graph": "",
"portal": "",
"graphAudience": "",
"activeDirectoryDataLake": "",
"batch": "",
"media": "",
"sqlManagement": "",
"vmImageAliasDoc": "",
"resourceManager": "",
"authentication": {
"loginEndpoint": "",
"audiences": [
"",
""
],
"tenant": "",
"identityProvider": ""
},
"suffixes": {
"acrLoginServer": "",
"azureDatalakeAnalyticsCatalogAndJob": "",
"azureDatalakeStoreFileSystem": "",
"azureFrontDoorEndpointSuffix": "",
"keyvaultDns": "",
"sqlServerHostname": "",
"storage": ""
}
}
Örnek
Aşağıdaki örnek Bicep dosyası ortam nesnesini döndürür.
output environmentOutput object = environment()
Yukarıdaki örnek, genel Azure'a dağıtıldığında aşağıdaki nesneyi döndürür:
{
"name": "AzureCloud",
"gallery": "https://gallery.azure.com/",
"graph": "https://graph.windows.net/",
"portal": "https://portal.azure.com",
"graphAudience": "https://graph.windows.net/",
"activeDirectoryDataLake": "https://datalake.azure.net/",
"batch": "https://batch.core.windows.net/",
"media": "https://rest.media.azure.net",
"sqlManagement": "https://management.core.windows.net:8443/",
"vmImageAliasDoc": "https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/arm-compute/quickstart-templates/aliases.json",
"resourceManager": "https://management.azure.com/",
"authentication": {
"loginEndpoint": "https://login.microsoftonline.com/",
"audiences": [ "https://management.core.windows.net/", "https://management.azure.com/" ],
"tenant": "common",
"identityProvider": "AAD"
},
"suffixes": {
"acrLoginServer": ".azurecr.io",
"azureDatalakeAnalyticsCatalogAndJob": "azuredatalakeanalytics.net",
"azureDatalakeStoreFileSystem": "azuredatalakestore.net",
"azureFrontDoorEndpointSuffix": "azurefd.net",
"keyvaultDns": ".vault.azure.net",
"sqlServerHostname": ".database.windows.net",
"storage": "core.windows.net"
}
}
Sonraki adımlar
- Kaynaklardan, kaynak gruplarından veya aboneliklerden değer almak için bkz . Kaynak işlevleri.