Erőforrások telepítése ARM Azure Resource Manager REST API-val

Ebből a cikkből megtudhatja, hogy az Azure Resource Manager REST API-jának használatával hogyan telepítheti az erőforrásokat az Azure ARM sablonokkal.

A sablont be is foglalhatja a kérelem törzsébe, vagy hivatkozhat egy fájlra. Fájl használata esetén ez lehet egy helyi fájl vagy egy URI-n keresztül elérhető külső fájl. Amikor a sablon egy tárfiókban van, korlátozhatja a sablonhoz való hozzáférést, és megosztott hozzáférési aláírást (SAS-) jogkivonatot nyújthat a telepítés során.

Telepítés hatóköre

A központi telepítést egy erőforráscsoportra, Azure-előfizetésre, felügyeleti csoportra vagy bérlői fiókracélként használhatja. A telepítés hatókörétől függően különböző parancsokat kell használnia.

  • Egy erőforráscsoportbanvaló telepítéshez használja a Telepítések - Létrehozás gombra. A kérelem a következőnek lesz elküldve:

    PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2020-10-01
    
  • Az előfizetésbe való telepítéshezhasználja a Telepítések – Létrehozás az előfizetés hatókörében lehetőséget. A kérelem a következőnek lesz elküldve:

    PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2020-10-01
    

    Az előfizetési szintű telepítésekkel kapcsolatos további információkért lásd: Erőforráscsoportok és erőforrások létrehozása az előfizetési szinten.

  • Ha egy felügyeleti csoportban üzembehelyez egy csoportot, használja a Telepítések – Létrehozás felügyeleti csoport hatókörében használhatja. A kérelem a következőnek lesz elküldve:

    PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2020-10-01
    

    A felügyeleti csoportszintű telepítésekkel kapcsolatos további információkért lásd: Erőforrások létrehozása a felügyeleti csoport szintjén.

  • Bérlői fiókban való telepítéshezhasználja a Telepítések – Létrehozás vagy frissítés bérlői hatókörben 2010- et. A kérelem a következőnek lesz elküldve:

    PUT https://management.azure.com/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2020-10-01
    

    A bérlői szintű telepítésekkel kapcsolatos további információkért lásd: Erőforrások létrehozása bérlői szinten.

A cikkben látható példák erőforráscsoportok telepítését használják.

Üzembe helyezés a REST API-val

  1. Adja meg az általános paramétereket és fejléceket,beleértve a hitelesítési jogkivonatokat.

  2. Ha nem létező erőforráscsoportban telepíti az üzembe helyezést, hozza létre az erőforráscsoportot. Adja meg az előfizetés azonosítóját, az új erőforráscsoport nevét és a megoldáshoz szükséges helyet. További információ: Erőforráscsoport létrehozása.

    PUT https://management.azure.com/subscriptions/<YourSubscriptionId>/resourcegroups/<YourResourceGroupName>?api-version=2020-06-01
    

    A kérelem törzsében:

    {
     "location": "West US",
     "tags": {
       "tagname1": "tagvalue1"
     }
    }
    
  3. A sablon telepítése előtt megtekintheti a környezetében végrehajtott módosítások előnézetét. A what-if művelettel ellenőrizze, hogy a sablon az elvárt módosításokat végrehajtotta-e. A What-if ezenkívül ellenőrzi, hogy a sablon tartalmaz-e hibákat.

  4. Sablon telepítéséhez adja meg az előfizetés azonosítóját, az erőforráscsoport nevét, a telepítés nevét a kérés URI azonosítóján.

    PUT https://management.azure.com/subscriptions/<YourSubscriptionId>/resourcegroups/<YourResourceGroupName>/providers/Microsoft.Resources/deployments/<YourDeploymentName>?api-version=2020-10-01
    

    A kérelem törzsében adja meg a sablon és a paraméterfájl hivatkozását. A paraméterfájlról további információt az Erőforrás-kezelő paraméterfájl létrehozása.

    Figyelje mode meg, hogy a Növekményes beállítás mode A teljes telepítés futtatásához állítsa a mode Complete (Kész) mode Legyen óvatos a teljes mód használata esetén, mivel véletlenül törölhet olyan erőforrásokat, amelyek nem a sablonban vannak.

    {
     "properties": {
       "templateLink": {
         "uri": "http://mystorageaccount.blob.core.windows.net/templates/template.json",
         "contentVersion": "1.0.0.0"
       },
       "parametersLink": {
         "uri": "http://mystorageaccount.blob.core.windows.net/templates/parameters.json",
         "contentVersion": "1.0.0.0"
       },
       "mode": "Incremental"
     }
    }
    

    Ha választartalmat szeretne naplózni, tartalmat szeretne kérni, vagy mindkettőt, foglalja bele a debugSetting kérelembe.

    {
     "properties": {
       "templateLink": {
         "uri": "http://mystorageaccount.blob.core.windows.net/templates/template.json",
         "contentVersion": "1.0.0.0"
       },
       "parametersLink": {
         "uri": "http://mystorageaccount.blob.core.windows.net/templates/parameters.json",
         "contentVersion": "1.0.0.0"
       },
       "mode": "Incremental",
       "debugSetting": {
         "detailLevel": "requestContent, responseContent"
       }
     }
    }
    

    A tárfiókot megosztott hozzáférés-aláírás (SAS) használatára is beállíthatja. További információt a Hozzáférés delegálása megosztott hozzáférés-aláírással .

    Ha bizalmas értéket kell megadnia egy paraméterhez (például jelszóhoz), vegye fel azt egy kulcstárba. Az előző példában látható módon lekérheti a kulcstárat a telepítés során. További információ: Biztonságos paraméterérték megadása az Azure-kulcstárhasználatával telepítés közben.

  5. Ahelyett, hogy a sablon fájljaihoz és a paraméterekhez csatolta volna őket, felhasználhatja őket a kérés törzsébe. Az alábbi példa a kérés törzsét mutatja be a sablonnal és a paraméterrel a szövegben:

    {
       "properties": {
       "mode": "Incremental",
       "template": {
         "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
         "contentVersion": "1.0.0.0",
         "parameters": {
           "storageAccountType": {
             "type": "string",
             "defaultValue": "Standard_LRS",
             "allowedValues": [
               "Standard_LRS",
               "Standard_GRS",
               "Standard_ZRS",
               "Premium_LRS"
             ],
             "metadata": {
               "description": "Storage Account type"
             }
           },
           "location": {
             "type": "string",
             "defaultValue": "[resourceGroup().location]",
             "metadata": {
               "description": "Location for all resources."
             }
           }
         },
         "variables": {
           "storageAccountName": "[concat(uniquestring(resourceGroup().id), 'standardsa')]"
         },
         "resources": [
           {
             "type": "Microsoft.Storage/storageAccounts",
             "apiVersion": "2018-02-01",
             "name": "[variables('storageAccountName')]",
             "location": "[parameters('location')]",
             "sku": {
               "name": "[parameters('storageAccountType')]"
             },
             "kind": "StorageV2",
             "properties": {}
           }
         ],
         "outputs": {
           "storageAccountName": {
             "type": "string",
             "value": "[variables('storageAccountName')]"
           }
         }
       },
       "parameters": {
         "location": {
           "value": "eastus2"
         }
       }
     }
    }
    
  6. A sablon telepítésének állapotának lekértéhez használja a Központi telepítés – Bej.

    GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2020-10-01
    

Üzembe helyezés neve

A telepítésnek nevet is adhat ( például ExampleDeployment .

Minden alkalommal, amikor futtat egy telepítést, a rendszer hozzáad egy bejegyzést az erőforráscsoport telepítési előzményeihez az üzembe helyezés nevével. Ha másik telepítést futtat, és ugyanazt a nevet adja neki, a korábbi bejegyzést lecseréli az aktuális telepítésre. Ha egyedi bejegyzéseket szeretne megőrizni a telepítési előzményekben, adjon minden telepítésnek egy egyedi nevet.

Egyedi név létrehozásához véletlenszerű számot rendelhet hozzá. Vagy adjon meg egy dátumértéket.

Ha egyidejű telepítéseket futtat ugyanazokkal az erőforráscsoporttal, és a központi telepítés neve megegyezik, akkor csak az utolsó telepítés befejeződik. Az azonos nevű telepítéseket a rendszer a legutóbbi telepítésre cseréli. Ha például futtat egy üzembe helyezést ,, amely üzembe helyez egy , nevű tárfiókot, és ezzel egyidejűleg futtat egy másik, a nevű tárfiókot üzembe helyező központi telepítést, akkor csak egy tárfiókot kell newStoragestorage1 üzembe newStoragestorage2 helyeznie. Az eredményül kapott tárfiók neve storage2 .

Ha azonban futtat egy olyan telepítést, amely telepíti a () nevű tárfiókot, és közvetlenül a befejeződása után futtat egy másik, a nevű tárfiókot üzembe helyező központi telepítést, akkor két tárfiókja newStoragestorage1newStoragestorage2 van. Az egyik neve storage1 , a másik pedig storage2 . A telepítési előzményekben azonban csak egy bejegyzés látható.

Ha egyedi nevet ad meg az egyes telepítések számára, azok egyidejűleg, ütközés nélkül futtathatók. Ha futtat egy telepítést, amely telepíti a () nevű tárfiókot, és egyidejűleg futtat egy másik telepítést is, amely a () nevű tárfiókot telepíti, akkor két tárfiókja és két bejegyzése van a telepítési newStorage1storage1newStorage2storage2 előzményekben.

Az egyidejű telepítésekkel való ütközések elkerülése és az egyedi bejegyzések biztosítása érdekében minden telepítéshez adjon egyedi nevet.

További lépések