Bicep tartozékkezelők
A kiegészítő operátorok a gyermekerőforrásokhoz, az objektumok tulajdonságaihoz és a tömb elemeihez való hozzáférésre szolgálnak. A tulajdonságkiegészítőt egyes függvények használatára is használhatja.
Operátor | Name |
---|---|
[] |
Index tartozék |
. |
Függvény tartozéka |
:: |
Beágyazott erőforrás-kiegészítő |
. |
Tulajdonság tartozéka |
Index tartozék
array[integerIndex]
object['stringIndex']
Az index tartozékával tömbből vagy objektumból származó tulajdonságot kérhet le.
Tömb esetén adja meg az indexet egész számként. Az egész szám megegyezik a lekérni kívánt elem nullaalapú pozíciójával.
Objektum esetén adja meg az indexet sztringként. A sztring megegyezik a lekérni kívánt objektum nevével.
Az alábbi példa egy tömb egyik elemét kapja meg.
var arrayVar = [
'Coho'
'Contoso'
'Fabrikan'
]
output accessorResult string = arrayVar[1]
Kimenet a példából:
Név | Típus | Érték |
---|---|---|
accessorResult | sztring | "Contoso" |
A következő példa egy objektum tulajdonságát kapja meg.
var environmentSettings = {
dev: {
name: 'Development'
}
prod: {
name: 'Production'
}
}
output accessorResult string = environmentSettings['dev'].name
Kimenet a példából:
Név | Típus | Érték |
---|---|---|
accessorResult | sztring | "Fejlesztés" |
Függvény tartozéka
resourceName.functionName()
Két függvény – getSecret és list* – támogatja a kiegészítő operátort a függvény meghívásához. Ez a két függvény az egyetlen függvény, amely támogatja a kiegészítő operátort.
Példa
Az alábbi példa egy meglévő kulcstartóra hivatkozik, majd egy getSecret
titkos kulcsot ad át egy modulnak.
resource kv 'Microsoft.KeyVault/vaults@2023-02-01' existing = {
name: kvName
scope: resourceGroup(subscriptionId, kvResourceGroup )
}
module sql './sql.bicep' = {
name: 'deploySQL'
params: {
sqlServerName: sqlServerName
adminLogin: adminLogin
adminPassword: kv.getSecret('vmAdminPassword')
}
}
Beágyazott erőforrás-kiegészítő
parentResource::nestedResource
A beágyazott erőforrás egy másik erőforráson belül deklarált erőforrás. A beágyazott erőforrás-tartozék ::
használatával a beágyazott erőforrásokat a szülőerőforráson kívülről érheti el.
A szülőerőforráson belül csak a szimbolikus névvel hivatkozhat a beágyazott erőforrásra. A beágyazott erőforrás-tartozékot csak akkor kell használnia, ha a beágyazott erőforrásra a szülőerőforráson kívülről hivatkozik.
Példa
Az alábbi példa bemutatja, hogyan hivatkozhat beágyazott erőforrásra a szülőerőforráson belülről és a szülőerőforráson kívülről.
resource demoParent 'demo.Rp/parentType@2023-01-01' = {
name: 'demoParent'
location: 'West US'
// Declare a nested resource within 'demoParent'
resource demoNested 'childType' = {
name: 'demoNested'
properties: {
displayName: 'The nested instance.'
}
}
// Declare another nested resource
resource demoSibling 'childType' = {
name: 'demoSibling'
properties: {
// Use symbolic name to reference because this line is within demoParent
displayName: 'Sibling of ${demoNested.properties.displayName}'
}
}
}
// Use nested accessor to reference because this line is outside of demoParent
output displayName string = demoParent::demoNested.properties.displayName
Tulajdonság tartozéka
objectName.propertyName
Tulajdonság-tartozékokkal érheti el egy objektum tulajdonságait. A tulajdonságkiegészítők bármilyen objektummal használhatók, beleértve az objektumnak minősülő paramétereket és változókat is. Hibaüzenet jelenik meg, ha olyan kifejezésen használja a tulajdonsághozzáférést, amely nem objektum.
Példa
Az alábbi példa egy objektumváltozót és a tulajdonságok elérését mutatja be.
var x = {
y: {
z: 'Hello'
a: true
}
q: 42
}
output outputZ string = x.y.z
output outputQ int = x.q
Kimenet a példából:
Név | Típus | Érték |
---|---|---|
outputZ |
sztring | "Hello" |
outputQ |
egész szám | 42 |
A tulajdonságtartozékot általában a Bicep-fájlban üzembe helyezett erőforrással használja. Az alábbi példa létrehoz egy nyilvános IP-címet, és tulajdonság-tartozékokkal ad vissza egy értéket az üzembe helyezett erőforrásból.
resource publicIp 'Microsoft.Network/publicIPAddresses@2022-11-01' = {
name: publicIpResourceName
location: location
properties: {
publicIPAllocationMethod: dynamicAllocation ? 'Dynamic' : 'Static'
dnsSettings: {
domainNameLabel: publicIpDnsLabel
}
}
}
// Use property accessor to get value
output ipFqdn string = publicIp.properties.dnsSettings.fqdn
Következő lépések
- A példák futtatásához használja az Azure CLI-t vagy a Azure PowerShell egy Bicep-fájl üzembe helyezéséhez.
- Bicep-fájl létrehozásához lásd : Rövid útmutató: Bicep-fájlok létrehozása a Visual Studio Code-tal.
- A Bicep-típus hibáinak megoldásáról további információt a Bicep bármely függvénye című témakörben talál.