Hierarchy Settings - Create Or Update

Hizmet:

Management Groups

API Sürümü:

2020-05-01

Yönetim Grubu düzeyinde tanımlanan hiyerarşi ayarlarını oluşturur veya güncelleştirir.

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/settings/default?api-version=2020-05-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
groupId	path	True	string	Yönetim Grubu Kimliği.
api-version	query	True	string	İstemci isteğiyle kullanılacak API'nin sürümü. Geçerli sürüm 2018-01-01-preview sürümüdür.

İstek Gövdesi

Name	Tür	Description
properties.defaultManagementGroup	string	Bu kiracıya yeni aboneliklerin eklendiği varsayılan Yönetim Grubunu ayarlayan ayarlar. Örneğin, /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Kök Yönetim Grubu altında grup oluşturma işleminde RBAC erişiminin gerekli olup olmadığını gösterir. true olarak ayarlanırsa, kullanıcı doğrudan kök altında yeni Gruplar oluşturmak için kök Yönetim Grubu kapsamında Microsoft.Management/managementGroups/write eylemi gerektirir. Bu, erişim verilmediği sürece yeni kullanıcıların yeni Yönetim Grupları oluşturmasını engeller.

Yanıtlar

Name	Tür	Description
200 OK	HierarchySettings	Tamam
Other Status Codes	ErrorResponse	Hata

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

GetGroupSettings

Örnek isteği

HTTP

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

{
  "properties": {
    "defaultManagementGroup": "/providers/Microsoft.Management/managementGroups/DefaultGroup",
    "requireAuthorizationForGroupCreation": true
  }
}

Örnek yanıt

Durum kodu:

200

{
  "id": "/providers/Microsoft.Management/managementGroups/root/settings/default",
  "type": "Microsoft.Management/managementGroups/settings",
  "name": "root",
  "properties": {
    "tenantId": "20000000-0000-0000-0000-000000000000",
    "defaultManagementGroup": "/providers/Microsoft.Management/managementGroups/DefaultGroup",
    "requireAuthorizationForGroupCreation": true
  }
}

Tanımlar

Name	Description
CreateOrUpdateSettingsRequest	Yönetim Grubu ayarlarını oluşturma veya güncelleştirme parametreleri
ErrorDetails	Hatanın ayrıntıları.
ErrorResponse	Hata nesnesi.
HierarchySettings	Yönetim Grubu kapsamında tanımlanan ayarlar.

CreateOrUpdateSettingsRequest

Object

Yönetim Grubu ayarlarını oluşturma veya güncelleştirme parametreleri

Name	Tür	Description
properties.defaultManagementGroup	string	Bu kiracıya yeni aboneliklerin eklendiği varsayılan Yönetim Grubunu ayarlayan ayarlar. Örneğin, /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Kök Yönetim Grubu altında grup oluşturma işleminde RBAC erişiminin gerekli olup olmadığını gösterir. true olarak ayarlanırsa, kullanıcı doğrudan kök altında yeni Gruplar oluşturmak için kök Yönetim Grubu kapsamında Microsoft.Management/managementGroups/write eylemi gerektirir. Bu, erişim verilmediği sürece yeni kullanıcıların yeni Yönetim Grupları oluşturmasını engeller.

ErrorDetails

Object

Hatanın ayrıntıları.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
details	string	Hatanın ayrıntılarının insan tarafından okunabilir bir gösterimi.
message	string	Hatanın insan tarafından okunabilir bir gösterimi.

ErrorResponse

Object

Hata nesnesi.

Name	Tür	Description
error	ErrorDetails	Hata Hatanın ayrıntıları.

HierarchySettings

Object

Yönetim Grubu kapsamında tanımlanan ayarlar.

Name	Tür	Description
id	string	Ayarlar nesnesinin tam kimliği. Örneğin, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000000000000/settings/default.
name	string	Nesnenin adı. Bu durumda, varsayılandır.
properties.defaultManagementGroup	string	Bu kiracıya yeni aboneliklerin eklendiği varsayılan Yönetim Grubunu ayarlayan ayarlar. Örneğin, /providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	Kök Yönetim Grubu altında grup oluşturma işleminde RBAC erişiminin gerekli olup olmadığını gösterir. true olarak ayarlanırsa, kullanıcı doğrudan kök altında yeni Gruplar oluşturmak için kök Yönetim Grubu kapsamında Microsoft.Management/managementGroups/write eylemi gerektirir. Bu, erişim verilmediği sürece yeni kullanıcıların yeni Yönetim Grupları oluşturmasını engeller.
properties.tenantId	string	Hiyerarşi ayarlarıyla ilişkili AAD Kiracı Kimliği. Örneğin, 000000000-0000-0000-0000-000000000000
type	string	Kaynağın türü. Örneğin, Microsoft.Management/managementGroups/settings.