Hierarchy Settings - Create Or Update

Başvuru

Service:: Management Groups

API Version:: 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 sırasında RBAC erişimi gerekip gerekmediğini gösterir. True olarak ayarlanırsa, kullanıcının doğrudan kök altında yeni Gruplar oluşturmak için kök Yönetim Grubu kapsamında Microsoft.Management/managementGroups/write eylemi gerekir. 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 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

Örnekler

GetGroupSettings

Sample Request

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

Sample Response

Status code:: 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

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 sırasında RBAC erişimi gerekip gerekmediğini gösterir. True olarak ayarlanırsa, kullanıcının doğrudan kök altında yeni Gruplar oluşturmak için kök Yönetim Grubu kapsamında Microsoft.Management/managementGroups/write eylemi gerekir. Bu, erişim verilmediği sürece yeni kullanıcıların yeni Yönetim Grupları oluşturmasını engeller.

ErrorDetails

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 okunabilen bir gösterimi.
message	string	Hatanın insan tarafından okunabilen bir gösterimi.

ErrorResponse

Hata nesnesi.

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

HierarchySettings

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ılan.
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 sırasında RBAC erişimi gerekip gerekmediğini gösterir. True olarak ayarlanırsa, kullanıcının doğrudan kök altında yeni Gruplar oluşturmak için kök Yönetim Grubu kapsamında Microsoft.Management/managementGroups/write eylemi gerekir. 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, 00000000-0000-0000-0000-0000000000000
type	string	Kaynağın türü. Örneğin, Microsoft.Management/managementGroups/settings.