Aracılığıyla paylaş

REST API kullanarak Azure kaynaklarını yönetme

  • Makale

Azure kaynaklarınızı yönetmek için Azure Resource Manager için REST API'yi kullanmayı öğrenin. Azure REST çağrılarını yapılandırma hakkında kapsamlı bir başvuru için bkz . REST ile Çalışmaya Başlama. Kullanılabilir işlemler hakkında daha fazla bilgi için Kaynak Yönetimi REST API başvurusunu görüntüleyin.

Erişim belirteci alma

Azure'a REST API çağrısı yapmak için önce bir erişim belirteci almanız gerekir. "Yetkilendirme" üst bilgisini kullanarak ve değeri "Taşıyıcı {access-token}" olarak ayarlayarak bu erişim belirtecini Azure REST API çağrılarınızın üst bilgilerine ekleyin.

Uygulamanızın bir parçası olarak program aracılığıyla yeni belirteçler almanız gerekiyorsa, istemci uygulamanızı Microsoft Entra Id ile kaydederek bir erişim belirteci alabilirsiniz.

Kullanmaya başlıyorsanız ve azure REST API'lerini tek tek belirtecinizi kullanarak test etmek istiyorsanız, Azure PowerShell veya Azure CLI ile geçerli erişim belirtecinizi hızla alabilirsiniz.

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

İşlem kapsamı

Farklı kapsamlarda birçok Azure Resource Manager işlemi çağırabilirsiniz:

Tür Kapsam
Yönetim grubu providers/Microsoft.Management/managementGroups/{managementGroupId}
Abonelik subscriptions/{subscriptionId}
Kaynak grubu subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}
Kaynak subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderName}/{resourceType}/{resourceName}

Kaynakları listeleme

Aşağıdaki REST işlemi, sağlanan bir kaynak grubu içindeki kaynakları döndürür.

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

Azure Resource Manager API'sini kullanarak bir kaynak grubundaki tüm kaynakları listelemek için kullanabileceğiniz örnek bir cURL komutu aşağıda verilmiştir:

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'

Kimlik doğrulama adımında bu örnek şöyle görünür:

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'

Kaynakları mevcut bir kaynak grubuna dağıtma

REST API kullanarak Azure kaynaklarını doğrudan dağıtabilir veya Azure kaynakları oluşturmak için bir Resource Manager şablonu dağıtabilirsiniz.

Kaynak dağıtma

Aşağıdaki REST işlemi bir depolama hesabı oluşturur. Bu örneği daha ayrıntılı görmek için bkz . REST API ile Azure Depolama hesabı oluşturma. Depolama Kaynağı Sağlayıcısı için eksiksiz başvuru belgeleri ve örnekleri Depolama Kaynağı Sağlayıcısı REST API Başvurusu'nda bulunabilir.

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

Şablon dağıtma

Aşağıdaki işlemler, depolama hesabı oluşturmak için bir Hızlı Başlangıç şablonu dağıtır. Daha fazla bilgi için bkz . Hızlı Başlangıç: Visual Studio Code kullanarak Azure Resource Manager şablonları oluşturma. Bu çağrının API başvurusu için bkz . Dağıtımlar - Oluşturma veya Güncelleştirme.

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

REST API'leri için değeri uri yerel bir dosya veya yalnızca yerel ağınızda kullanılabilen bir dosya olamaz. Azure Resource Manager'ın şablona erişebilmesi gerekir. HTTP veya HTTPS olarak indirilebilen bir URI değeri sağlayın. Daha fazla bilgi için bkz . Resource Manager şablonları ve Azure PowerShell ile kaynakları dağıtma.

Kaynak grubu ve kaynakları dağıtma

Şablon kullanarak bir kaynak grubu oluşturabilir ve kaynakları gruba dağıtabilirsiniz. Daha fazla bilgi için bkz . Kaynak grubu oluşturma ve kaynakları dağıtma.

Kaynakları birden çok aboneliğe veya kaynak grubuna dağıtma

Genellikle, şablonunuzdaki tüm kaynakları tek bir kaynak grubuna dağıtırsınız. Ancak, bir dizi kaynağı birlikte dağıtmak ancak bunları farklı kaynak gruplarına veya aboneliklere yerleştirmek istediğiniz senaryolar vardır. Daha fazla bilgi için bkz . Azure kaynaklarını birden çok aboneliğe veya kaynak grubuna dağıtma.

Kaynakları silme

Aşağıdaki işlemde depolama hesabının nasıl silineceği gösterilmektedir.

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

Azure Resource Manager'ın kaynakların silinmesini nasıl sipariş etti olduğu hakkında daha fazla bilgi için bkz . Azure Resource Manager kaynak grubu silme.

Kaynaklara erişimi yönetme

Azure rol tabanlı erişim denetimi (Azure RBAC), Azure'daki kaynaklara erişimi yönetme yöntemidir. Daha fazla bilgi için bkz . REST kullanarak Azure rol atamaları ekleme veya kaldırma.

Sonraki adımlar