Kimeneti iteráció ARM-sablonokban

Ez a cikk bemutatja, hogyan hozhat létre egynél több értéket egy kimenethez a Azure Resource Manager sablonban (ARM-sablon). Ha másolási hurkot ad hozzá a sablon outputs szakaszához, az üzembe helyezés során dinamikusan adhat vissza elemeket.

A másolási ciklust erőforrásokkal, egy erőforrás tulajdonságaival és változókkal is használhatja.

Syntax

Adja hozzá a elemet a sablon copy kimeneti szakaszához, hogy több elemet adjon vissza. A másolási elem általános formátuma a következő:

"copy": {
  "count": <number-of-iterations>,
  "input": <values-for-the-output>
}

A tulajdonság határozza meg a kimeneti értékhez count kívánt iterációk számát.

A input tulajdonság határozza meg az ismételni kívánt tulajdonságokat. A tulajdonságban található értékből létrehozott elemek tömbje lesz input létrehozva. Ez lehet egyetlen tulajdonság (például egy sztring), vagy egy objektum több tulajdonsággal.

Másolási korlátok

A szám nem haladhatja meg a 800-at.

A szám nem lehet negatív szám. Nulla lehet, ha a sablont az Azure CLI, a PowerShell vagy a REST API. Pontosabban a következőt kell használnia:

  • Azure PowerShell 2.6-os vagy újabb
  • Azure CLI 2.0.74 vagy újabb
  • REST API 2019. 05. 10. vagy újabb verziója
  • A csatolt üzemelő példányok az api 2019-05-10-es vagy újabb verzióját kell használniuk az üzembe helyezési erőforrástípushoz

A PowerShell, a parancssori felület és a REST API korábbi verziói nem támogatják a nullát a darabszámhoz.

Kimenetek iterációja

Az alábbi példa változó számú tárfiókot hoz létre, és minden tárfiókhoz visszaad egy végpontot:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageCount": {
      "type": "int",
      "defaultValue": 2
    }
  },
  "variables": {
    "baseName": "[concat('storage', uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2019-04-01",
      "name": "[concat(copyIndex(), variables('baseName'))]",
      "location": "[resourceGroup().location]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "properties": {},
      "copy": {
        "name": "storagecopy",
        "count": "[parameters('storageCount')]"
      }
    }
  ],
  "outputs": {
    "storageEndpoints": {
      "type": "array",
      "copy": {
        "count": "[parameters('storageCount')]",
        "input": "[reference(concat(copyIndex(), variables('baseName'))).primaryEndpoints.blob]"
      }
    }
  }
}

A fenti sablon egy tömböt ad vissza a következő értékekkel:

[
  "https://0storagecfrbqnnmpeudi.blob.core.windows.net/",
  "https://1storagecfrbqnnmpeudi.blob.core.windows.net/"
]

A következő példa három tulajdonságot ad vissza az új tárfiókból.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageCount": {
      "type": "int",
      "defaultValue": 2
    }
  },
  "variables": {
    "baseName": "[concat('storage', uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2019-04-01",
      "name": "[concat(copyIndex(), variables('baseName'))]",
      "location": "[resourceGroup().location]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "Storage",
      "properties": {},
      "copy": {
        "name": "storagecopy",
        "count": "[parameters('storageCount')]"
      }
    }
  ],
  "outputs": {
    "storageInfo": {
      "type": "array",
      "copy": {
        "count": "[parameters('storageCount')]",
        "input": {
          "id": "[reference(concat(copyIndex(), variables('baseName')), '2019-04-01', 'Full').resourceId]",
          "blobEndpoint": "[reference(concat(copyIndex(), variables('baseName'))).primaryEndpoints.blob]",
          "status": "[reference(concat(copyIndex(), variables('baseName'))).statusOfPrimary]"
        }
      }
    }
  }
}

Az előző példa egy tömböt ad vissza a következő értékekkel:

[
  {
    "id": "Microsoft.Storage/storageAccounts/0storagecfrbqnnmpeudi",
    "blobEndpoint": "https://0storagecfrbqnnmpeudi.blob.core.windows.net/",
    "status": "available"
  },
  {
    "id": "Microsoft.Storage/storageAccounts/1storagecfrbqnnmpeudi",
    "blobEndpoint": "https://1storagecfrbqnnmpeudi.blob.core.windows.net/",
    "status": "available"
  }
]

Következő lépések