Hızlı Başlangıç: REST API ile yönetim grubu oluşturma

Yönetim grupları, birden çok abonelikte erişimi, ilkeyi ve uyumluluğu yönetmenize yardımcı olan kapsayıcılardır. Azure İlkesi ve Azure Rol Tabanlı Erişim Denetimleri ile kullanılabilecek etkili ve verimli bir hiyerarşi oluşturmak için bu kapsayıcıları oluşturun. Yönetim grupları hakkında daha fazla bilgi için bkz . Kaynaklarınızı Azure yönetim gruplarıyla düzenleme.

Dizinde oluşturulan ilk yönetim grubunun tamamlanması 15 dakika kadar sürebilir. Dizininiz için Azure'da yönetim grupları hizmetini ayarlamak için ilk kez çalışan işlemler vardır. İşlem tamamlandığında bir bildirim alırsınız. Daha fazla bilgi için bkz . yönetim gruplarının ilk kurulumu.

Önkoşullar

• Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

• Henüz yapmadıysanız ARMClient'ı yükleyin. Azure Resource Manager tabanlı REST API'lerine HTTP istekleri gönderen bir araçtır. Bunun yerine, REST belgelerinde veya PowerShell'in Invoke-RestMethod veya Postman gibi araçlarda "Deneyin" özelliğini kullanabilirsiniz.

• Kiracıdaki herhangi bir Azure AD kullanıcısı, hiyerarşi koruması etkinleştirilmemişse bu kullanıcıya yönetim grubu yazma izni atanmadan bir yönetim grubu oluşturabilir. Bu yeni yönetim grubu Kök Yönetim Grubu'nun veya varsayılan yönetim grubunun alt öğesi olur ve oluşturucuya "Sahip" rol ataması verilir. Yönetim grubu hizmeti, rol atamalarına kök düzeyde ihtiyaç duyulmaması için bu özelliği sağlar. Kök Yönetim Grubu oluşturulduğunda hiçbir kullanıcının erişimi yoktur. Yönetim gruplarını kullanmaya başlamak için Azure AD Genel Yöneticilerini bulma engelini önlemek için, kök düzeyde ilk yönetim gruplarının oluşturulmasına izin veririz.

Azure Cloud Shell

Azure, tarayıcınız aracılığıyla kullanabileceğiniz etkileşimli bir kabuk ortamı olan Azure Cloud Shell'i barındırıyor. Azure hizmetleriyle çalışmak için Cloud Shell ile Bash veya PowerShell kullanabilirsiniz. Yerel ortamınıza herhangi bir şey yüklemek zorunda kalmadan bu makaledeki kodu çalıştırmak için Cloud Shell önceden yüklenmiş komutlarını kullanabilirsiniz.

Azure Cloud Shell'i başlatmak için:

Seçenek	Örnek/Bağlantı
Kodun veya komut bloğunun sağ üst köşesindeki Deneyin'i seçin. Deneyin seçildiğinde kod veya komut otomatik olarak Cloud Shell'e kopyalanmaz.
https://shell.azure.comadresine gidin veya Cloud Shell'i tarayıcınızda açmak için Cloud Shell'i Başlat düğmesini seçin.
Azure portalının sağ üst kısmındaki menü çubuğunda Cloud Shell düğmesini seçin.

Azure Cloud Shell'i kullanmak için:

1. Cloud Shell'i başlatın.

2. Kodu veya komutu kopyalamak için kod bloğundaki (veya komut bloğundaki) Kopyala düğmesini seçin.

3. Windows ve Linux'ta Ctrl+Shift V'yi seçerek veya macOS üzerinde Cmd+Shift++V'yi seçerek kodu veya komutu Cloud Shell oturumuna yapıştırın.

4. Kodu veya komutu çalıştırmak için Enter'ı seçin.

REST API'de oluşturma

REST API için Yönetim Grupları - Oluştur veya Güncelleştir uç noktasını kullanarak yeni bir yönetim grubu oluşturun. Bu örnekte, yönetim grubu groupId değeri Contoso'dur.

• REST API URI'si

  PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/Contoso?api-version=2020-05-01
  

• İstek Gövdesi Yok

groupId, oluşturulan benzersiz bir tanımlayıcıdır. Bu kimlik, bu gruba başvurmak için diğer komutlar tarafından kullanılır ve daha sonra değiştirilemez.

Yönetim grubunun Azure portalında farklı bir ad göstermesini istiyorsanız, istek gövdesine properties.displayName özelliğini ekleyin. Örneğin, Contoso groupId ve Contoso Group görünen adıyla bir yönetim grubu oluşturmak için aşağıdaki uç noktayı ve istek gövdesini kullanın:

• REST API URI'si

  PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/Contoso?api-version=2020-05-01
  

• İstek Gövdesi

  {
    "properties": {
      "displayName": "Contoso Group"
    }
  }
  

Yukarıdaki örneklerde, yeni yönetim grubu kök yönetim grubu altında oluşturulur. Üst grup olarak farklı bir yönetim grubu belirtmek için properties.parent.id özelliğini kullanın.

• REST API URI'si

  PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/Contoso?api-version=2020-05-01
  

• İstek Gövdesi

  {
    "properties": {
      "displayName": "Contoso Group",
      "parent": {
        "id": "/providers/Microsoft.Management/managementGroups/HoldingGroup"
      }
    }
  }
  

Kaynakları temizleme

Yukarıda oluşturulan yönetim grubunu kaldırmak için Yönetim Grupları - Uç noktayı sil'i kullanın:

• REST API URI'si

  DELETE https://management.azure.com/providers/Microsoft.Management/managementGroups/Contoso?api-version=2020-05-01
  

• İstek Gövdesi Yok

Sonraki adımlar

Bu hızlı başlangıçta, kaynak hiyerarşinizi düzenlemek için bir yönetim grubu oluşturdunuz. Yönetim grubu abonelikleri veya diğer yönetim gruplarını barındırabilir.

Yönetim grupları ve kaynak hiyerarşinizi yönetme hakkında daha fazla bilgi edinmek için devam edin:

Yönetim gruplarıyla kaynaklarınızı yönetme