Správa prostředků Azure pomocí rozhraní REST API

  • Článek

Naučte se používat rozhraní REST API pro Azure Resource Manager ke správě prostředků Azure. Komplexní referenční informace o tom, jak strukturovat volání Azure REST, najdete v tématu Začínáme s REST. Další podrobnosti o dostupnýchoperacích

Získání přístupového tokenu

Abyste mohli volat rozhraní REST API do Azure, musíte nejprve získat přístupový token. Tento přístupový token zahrňte do hlaviček volání rozhraní Azure REST API pomocí hlavičky Autorizace a nastavte hodnotu na Bearer {access-token}.

Pokud potřebujete v rámci aplikace programově načíst nové tokeny, můžete získat přístupový token registrací klientské aplikace pomocí Microsoft Entra ID.

Pokud začínáte a chcete otestovat rozhraní Azure REST API pomocí individuálního tokenu, můžete aktuální přístupový token rychle načíst pomocí Azure PowerShellu nebo Azure CLI.

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

Rozsah operace

Mnoho operací Azure Resource Manageru můžete volat v různých oborech:

Typ Obor
Skupina pro správu providers/Microsoft.Management/managementGroups/{managementGroupId}
Předplatné subscriptions/{subscriptionId}
Skupina prostředků subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}
Prostředek subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderName}/{resourceType}/{resourceName}

Výpis prostředků

Následující operace REST vrátí prostředky v zadané skupině prostředků.

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

Tady je příklad příkazu cURL, který můžete použít k výpisu všech prostředků ve skupině prostředků pomocí rozhraní API Azure Resource Manageru:

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'

V kroku ověřování vypadá tento příklad takto:

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'

Nasazení prostředků do existující skupiny prostředků

Prostředky Azure můžete nasadit přímo pomocí rozhraní REST API nebo nasadit šablonu Resource Manageru pro vytvoření prostředků Azure.

Nasazení prostředku

Následující operace REST vytvoří účet úložiště. Podrobnější informace o tomto příkladu najdete v tématu Vytvoření účtu služby Azure Storage pomocí rozhraní REST API. Kompletní referenční dokumentace a ukázky pro poskytovatele prostředků úložiště jsou k dispozici v referenčních informacích k rozhraní REST API poskytovatele prostředků úložiště.

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",
}

Nasazení šablony

Následující operace nasadí šablonu rychlého startu pro vytvoření účtu úložiště. Další informace najdete v tématu Rychlý start: Vytvoření šablon Azure Resource Manageru pomocí editoru Visual Studio Code. Referenční informace k rozhraní API tohoto volání najdete v tématu Nasazení – Vytvoření nebo aktualizace.

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"
  }
}

Pro rozhraní REST API nemůže být hodnota uri místního souboru ani souboru, který je dostupný jenom v místní síti. Azure Resource Manager musí mít přístup k šabloně. Zadejte hodnotu identifikátoru URI, která se dá stáhnout jako HTTP nebo HTTPS. Další informace najdete v tématu Nasazení prostředků pomocí šablon Resource Manageru a Azure PowerShellu.

Nasazení skupiny prostředků a prostředků

Pomocí šablony můžete vytvořit skupinu prostředků a nasadit do této skupiny prostředky. Další informace najdete v tématu Vytvoření skupiny prostředků a nasazení prostředků.

Nasazení prostředků do několika předplatných nebo skupin prostředků

Obvykle nasadíte všechny prostředky v šabloně do jedné skupiny prostředků. Existují však scénáře, ve kterých chcete nasadit sadu prostředků dohromady, ale umístit je do různých skupin prostředků nebo předplatných. Další informace najdete v tématu Nasazení prostředků Azure do několika předplatných nebo skupin prostředků.

Odstranění prostředků

Následující operace ukazuje, jak odstranit účet úložiště.

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

Další informace o tom, jak Azure Resource Manager objednává odstranění prostředků, najdete v tématu Odstranění skupiny prostředků Azure Resource Manageru.

Správa přístupu k prostředkům

Řízení přístupu na základě role v Azure (Azure RBAC) je způsob, jakým spravujete přístup k prostředkům v Azure. Další informace najdete v tématu Přidání nebo odebrání přiřazení rolí Azure pomocí REST.

Další kroky