Iteração de saída em modelos do ARM
Este artigo mostra-lhe como criar mais do que um valor para uma saída no modelo do Azure Resource Manager (modelo arm). Ao adicionar um ciclo de cópia à secção de saídas do modelo, pode devolver dinamicamente vários itens durante a implementação.
Também pode utilizar o ciclo de cópia com recursos, propriedades num recurso e variáveis.
Dica
Recomendamos o Bicep porque oferece as mesmas capacidades que os modelos do ARM e a sintaxe é mais fácil de utilizar. Para saber mais, veja ciclos.
Syntax
Adicione o copy
elemento à secção de saída do modelo para devolver vários itens. O elemento copy tem o seguinte formato geral:
"copy": {
"count": <number-of-iterations>,
"input": <values-for-the-output>
}
A count
propriedade especifica o número de iterações que pretende para o valor de saída.
A input
propriedade especifica as propriedades que pretende repetir. Pode criar uma matriz de elementos construídos a partir do valor na input
propriedade . Pode ser uma única propriedade (como uma cadeia) ou um objeto com várias propriedades.
Copiar limites
A contagem não pode exceder os 800.
A contagem não pode ser um número negativo. Pode ser zero se implementar o modelo com uma versão recente da CLI do Azure, do PowerShell ou da API REST. Especificamente, tem de utilizar:
- Azure PowerShell 2.6 ou posterior
- CLI do Azure 2.0.74 ou posterior
- Versão da API REST 2019-05-10 ou posterior
- As implementações ligadas têm de utilizar a versão de API 2019-05-10 ou posterior para o tipo de recurso de implementação
As versões anteriores do PowerShell, da CLI e da API REST não suportam zero para contagem.
Iteração de saídas
O exemplo seguinte cria um número variável de contas de armazenamento e devolve um ponto final para cada conta de armazenamento:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"storageCount": {
"type": "int",
"defaultValue": 2
},
"location": {
"type": "string",
"defaultValue": "[resourceGroup().location]"
}
},
"variables": {
"baseName": "[format('storage{0}', uniqueString(resourceGroup().id))]"
},
"resources": [
{
"copy": {
"name": "storagecopy",
"count": "[parameters('storageCount')]"
},
"type": "Microsoft.Storage/storageAccounts",
"apiVersion": "2022-09-01",
"name": "[format('{0}{1}', copyIndex(), variables('baseName'))]",
"location": "[parameters('location')]",
"sku": {
"name": "Standard_LRS"
},
"kind": "Storage",
"properties": {}
}
],
"outputs": {
"storageEndpoints": {
"type": "array",
"copy": {
"count": "[parameters('storageCount')]",
"input": "[reference(format('{0}{1}', copyIndex(), variables('baseName'))).primaryEndpoints.blob]"
}
}
}
}
O modelo anterior devolve uma matriz com os seguintes valores:
[
"https://0storagecfrbqnnmpeudi.blob.core.windows.net/",
"https://1storagecfrbqnnmpeudi.blob.core.windows.net/"
]
O exemplo seguinte devolve três propriedades das novas contas de armazenamento.
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"storageCount": {
"type": "int",
"defaultValue": 2
},
"location": {
"type": "string",
"defaultValue": "[resourceGroup().location]"
}
},
"variables": {
"baseName": "[format('storage{0}', uniqueString(resourceGroup().id))]"
},
"resources": [
{
"copy": {
"name": "storagecopy",
"count": "[length(range(0, parameters('storageCount')))]"
},
"type": "Microsoft.Storage/storageAccounts",
"apiVersion": "2022-09-01",
"name": "[format('{0}{1}', range(0, parameters('storageCount'))[copyIndex()], variables('baseName'))]",
"location": "[parameters('location')]",
"sku": {
"name": "Standard_LRS"
},
"kind": "Storage",
"properties": {}
}
],
"outputs": {
"storageInfo": {
"type": "array",
"copy": {
"count": "[length(range(0, parameters('storageCount')))]",
"input": {
"id": "[resourceId('Microsoft.Storage/storageAccounts', format('{0}{1}', copyIndex(), variables('baseName')))]",
"blobEndpoint": "[reference(format('{0}{1}', copyIndex(), variables('baseName'))).primaryEndpoints.blob]",
"status": "[reference(format('{0}{1}', copyIndex(), variables('baseName'))).statusOfPrimary]"
}
}
}
}
}
O exemplo anterior devolve uma matriz com os seguintes valores:
[
{
"id": "/subscriptions/00000000/resourceGroups/demoGroup/providers/Microsoft.Storage/storageAccounts/0storagecfrbqnnmpeudi",
"blobEndpoint": "https://0storagecfrbqnnmpeudi.blob.core.windows.net/",
"status": "available"
},
{
"id": "/subscriptions/00000000/resourceGroups/demoGroup/providers/Microsoft.Storage/storageAccounts/1storagecfrbqnnmpeudi",
"blobEndpoint": "https://1storagecfrbqnnmpeudi.blob.core.windows.net/",
"status": "available"
}
]
Passos seguintes
- Para seguir um tutorial, veja Tutorial: Criar várias instâncias de recursos com modelos do ARM.
- Para outras utilizações do ciclo de cópia, consulte:
- Se quiser saber mais sobre as secções de um modelo, veja Compreender a estrutura e a sintaxe dos modelos do ARM.
- Para saber como implementar o seu modelo, veja Implementar recursos com modelos arm e Azure PowerShell.