Share via

Azure-erőforrások kezelése a REST API használatával

  • Cikk

Megtudhatja, hogyan kezelheti azure-erőforrásait az Azure Resource Manager REST API-jának használatával. Az Azure REST-hívások szerkezetének átfogó bemutatásáért tekintse meg a REST használatának első lépéseit. Az elérhető műveletekkel kapcsolatos további részletekért tekintse meg a Resource Management REST API-referenciát .

Hozzáférési jogkivonat beszerzése

Ahhoz, hogy REST API-hívást kezdeményezhessen az Azure-ba, először be kell szereznie egy hozzáférési jogkivonatot. Vegye fel ezt a hozzáférési jogkivonatot az Azure REST API-hívások fejléceibe az "Engedélyezés" fejléc használatával, és állítsa az értéket "Bearer {access-token}" értékre.

Ha az alkalmazás részeként programozott módon kell lekérnie az új jogkivonatokat, a hozzáférési jogkivonatot úgy szerezheti be, hogy regisztrálja az ügyfélalkalmazást a Microsoft Entra-azonosítóval.

Ha első lépésként szeretné tesztelni az Azure REST API-kat az egyéni jogkivonatával, gyorsan lekérheti az aktuális hozzáférési jogkivonatot az Azure PowerShell vagy az Azure CLI használatával.

token=$(az account get-access-token --query accessToken --output tsv)

Művelet hatóköre

Számos Azure Resource Manager-műveletet hívhat meg különböző hatókörökben:

Type Scope
Felügyeleti csoport providers/Microsoft.Management/managementGroups/{managementGroupId}
Előfizetés subscriptions/{subscriptionId}
Erőforráscsoport subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}
Resource subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderName}/{resourceType}/{resourceName}

Erőforrások listázása

Az alábbi REST-művelet egy megadott erőforráscsoporton belül adja vissza az erőforrásokat.

GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/resources?api-version=2021-04-01 HTTP/1.1
Authorization: Bearer <bearer-token>
Host: management.azure.com

Íme egy példa cURL-parancsra, amellyel egy erőforráscsoport összes erőforrását listázhatja az Azure Resource Manager API használatával:

curl  -H "Authorization: Bearer $token" -H 'Content-Type: application/json' -X GET 'https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/resources?api-version=2021-04-01'

A hitelesítési lépéssel ez a példa a következőképpen néz ki:

token=$(az account get-access-token --query accessToken --output tsv)
curl  -H "Authorization: Bearer $token" -H 'Content-Type: application/json' -X GET 'https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/resources?api-version=2021-04-01'

Erőforrások üzembe helyezése meglévő erőforráscsoportban

Az Azure-erőforrásokat közvetlenül a REST API-val helyezheti üzembe, vagy egy Resource Manager-sablont is üzembe helyezhet Azure-erőforrások létrehozásához.

Erőforrás üzembe helyezése

A következő REST-művelet létrehoz egy tárfiókot. A példa részletesebb megtekintéséhez lásd : Azure Storage-fiók létrehozása a REST API-val. A tárolási erőforrás-szolgáltató teljes referenciadokumentációja és mintái elérhetők a storage-erőforrás-szolgáltató REST API-referenciaanyagában.

PUT /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}?api-version=2018-02-01 HTTP/1.1
Authorization: Bearer <bearer-token>
Content-Type: application/json
Host: management.azure.com

{
  "sku": {
    "name": "Standard_GRS"
  },
  "kind": "StorageV2",
  "location": "eastus2",
}

Sablon üzembe helyezése

Az alábbi műveletek üzembe helyeznek egy gyorsútmutató-sablont egy tárfiók létrehozásához. További információ : Rövid útmutató: Azure Resource Manager-sablonok létrehozása a Visual Studio Code használatával. A hívás API-referenciáját lásd : Üzembe helyezés – Létrehozás vagy frissítés.

PUT /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/my-deployment?api-version=2021-04-01 HTTP/1.1
Authorization: Bearer <bearer-token>
Content-Type: application/json
Host: management.azure.com

{
  "properties": {
    "templateLink": {
      "uri": "https://example.com/azuretemplates/azuredeploy.json"
    },
    "parametersLink": {
        "uri": "https://example.com/azuretemplates/azuredeploy.parameters.json"
    },
    "mode": "Incremental"
  }
}

A REST API-k értéke uri nem lehet helyi fájl vagy olyan fájl, amely csak a helyi hálózaton érhető el. Az Azure Resource Managernek hozzá kell tudnia férni a sablonhoz. Adjon meg egy HTTP-ként vagy HTTPS-ként letölthető URI-értéket. További információ: Erőforrások üzembe helyezése Resource Manager-sablonokkal és Azure PowerShell-lel.

Erőforráscsoport és erőforrások üzembe helyezése

Létrehozhat egy erőforráscsoportot, és sablonnal helyezhet üzembe erőforrásokat a csoportban. További információ: Erőforráscsoport létrehozása és erőforrások üzembe helyezése.

Erőforrások üzembe helyezése több előfizetésben vagy erőforráscsoportban

A sablonban lévő összes erőforrást általában egyetlen erőforráscsoportban helyezi üzembe. Vannak azonban olyan helyzetek, amikor egy erőforráskészletet szeretne üzembe helyezni, de különböző erőforráscsoportokba vagy előfizetésekbe szeretné helyezni őket. További információ: Azure-erőforrások üzembe helyezése több előfizetésben vagy erőforráscsoportban.

Erőforrások törlése

Az alábbi művelet bemutatja, hogyan törölhet egy tárfiókot.

DELETE /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}?api-version=2022-09-01 HTTP/1.1
Authorization: Bearer <bearer-token>
Host: management.azure.com

További információ arról, hogy az Azure Resource Manager hogyan rendeli meg az erőforrások törlését, lásd: Azure Resource Manager-erőforráscsoport törlése.

Az erőforrásokhoz való hozzáférés kezelése

Az Azure szerepköralapú hozzáférés-vezérlése (Azure RBAC) az Azure-beli erőforrásokhoz való hozzáférés kezelése. További információ: Azure-szerepkör-hozzárendelések hozzáadása vagy eltávolítása REST használatával.

Következő lépések