Udostępnij za pośrednictwem

Zarządzanie zasobami platformy Azure przy użyciu interfejsu API REST

  • Artykuł

Dowiedz się, jak zarządzać zasobami platformy Azure przy użyciu interfejsu API REST dla usługi Azure Resource Manager . Aby uzyskać kompleksowe informacje na temat struktury wywołań REST platformy Azure, zobacz Wprowadzenie do interfejsu REST. Aby uzyskać więcej informacji na temat dostępnych operacji, zobacz dokumentację interfejsu API REST zarządzania zasobami.

Uzyskiwanie tokenu dostępu

Aby wykonać wywołanie interfejsu API REST na platformie Azure, należy najpierw uzyskać token dostępu. Uwzględnij ten token dostępu w nagłówkach wywołań interfejsu API REST platformy Azure przy użyciu nagłówka "Autoryzacja" i ustawić wartość "Bearer {access-token}".

Jeśli musisz programowo pobrać nowe tokeny w ramach aplikacji, możesz uzyskać token dostępu, rejestrując aplikację kliencją przy użyciu identyfikatora Entra firmy Microsoft.

Jeśli rozpoczynasz pracę i chcesz przetestować interfejsy API REST platformy Azure przy użyciu indywidualnego tokenu, możesz szybko pobrać bieżący token dostępu za pomocą programu Azure PowerShell lub interfejsu wiersza polecenia platformy Azure.

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

Zakres operacji

Wiele operacji usługi Azure Resource Manager można wywołać w różnych zakresach:

Typ Scope
Grupa zarządzania providers/Microsoft.Management/managementGroups/{managementGroupId}
Subskrypcja subscriptions/{subscriptionId}
Grupa zasobów subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}
Zasób subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderName}/{resourceType}/{resourceName}

Wyświetlanie listy zasobów

Poniższa operacja REST zwraca zasoby w ramach podanej grupy zasobów.

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

Oto przykładowe polecenie cURL, za pomocą którego można wyświetlić listę wszystkich zasobów w grupie zasobów przy użyciu interfejsu API usługi Azure Resource Manager:

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'

W kroku uwierzytelniania ten przykład wygląda następująco:

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'

Wdrażanie zasobów w istniejącej grupie zasobów

Zasoby platformy Azure można wdrażać bezpośrednio przy użyciu interfejsu API REST lub wdrażać szablon usługi Resource Manager w celu utworzenia zasobów platformy Azure.

Wdrażanie zasobu

Poniższa operacja REST tworzy konto magazynu. Aby wyświetlić ten przykład bardziej szczegółowo, zobacz Tworzenie konta usługi Azure Storage przy użyciu interfejsu API REST. Pełna dokumentacja referencyjna i przykłady dla dostawcy zasobów magazynu są dostępne w dokumentacji interfejsu API REST dostawcy zasobów magazynu.

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

Wdrażanie szablonu

Następujące operacje umożliwiają wdrożenie szablonu szybkiego startu w celu utworzenia konta magazynu. Aby uzyskać więcej informacji, zobacz Szybki start: tworzenie szablonów usługi Azure Resource Manager przy użyciu programu Visual Studio Code. Aby zapoznać się z dokumentacją interfejsu API tego wywołania, zobacz Wdrożenia — tworzenie lub aktualizowanie.

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

W przypadku interfejsów API REST wartość uri nie może być plikiem lokalnym ani plikiem dostępnym tylko w sieci lokalnej. Usługa Azure Resource Manager musi mieć dostęp do szablonu. Podaj wartość identyfikatora URI, która można pobrać jako HTTP lub HTTPS. Aby uzyskać więcej informacji, zobacz Wdrażanie zasobów przy użyciu szablonów usługi Resource Manager i programu Azure PowerShell.

Wdrażanie grupy zasobów i zasobów

Grupę zasobów można utworzyć i wdrożyć zasoby w grupie przy użyciu szablonu. Aby uzyskać więcej informacji, zobacz Tworzenie grupy zasobów i wdrażanie zasobów.

Wdrażanie zasobów w wielu subskrypcjach lub grupach zasobów

Zazwyczaj wszystkie zasoby w szablonie są wdrażane w jednej grupie zasobów. Istnieją jednak scenariusze, w których chcesz wdrożyć zestaw zasobów razem, ale umieszczać je w różnych grupach zasobów lub subskrypcjach. Aby uzyskać więcej informacji, zobacz Wdrażanie zasobów platformy Azure w wielu subskrypcjach lub grupach zasobów.

Usuwanie zasobów

Poniższa operacja pokazuje, jak usunąć konto magazynu.

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

Aby uzyskać więcej informacji na temat sposobu zamawiania usuwania zasobów przez usługę Azure Resource Manager, zobacz Usuwanie grupy zasobów usługi Azure Resource Manager.

Zarządzanie dostępem do zasobów

Kontrola dostępu oparta na rolach (RBAC) platformy Azure to sposób zarządzania dostępem do zasobów na platformie Azure. Aby uzyskać więcej informacji, zobacz Dodawanie lub usuwanie przypisań ról platformy Azure przy użyciu interfejsu REST.

Następne kroki

  • Aby dowiedzieć się więcej na temat usługi Azure Resource Manager, zobacz Omówienie usługi Azure Resource Manager.
  • Aby dowiedzieć się więcej na temat obsługiwanych operacji REST usługi Azure Resource Manager, zobacz Dokumentacja REST usługi Azure Resource Manager.
  • Aby poznać składnię szablonu usługi Resource Manager, zobacz Omówienie struktury i składni szablonów usługi Azure Resource Manager.
  • Aby dowiedzieć się, jak opracowywać szablony, zobacz samouczki krok po kroku.
  • Aby wyświetlić schematy szablonów usługi Azure Resource Manager, zobacz dokumentację szablonu.