Hierarchy Settings - Create Or Update

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 In Required Type Description
groupId
path True
  • string

Yönetim grubu KIMLIĞI.

api-version
query True
  • string

İstemci isteğiyle kullanılacak API sürümü. Geçerli sürüm 2018-01-01-Preview ' dir.

İstek Gövdesi

Name Type 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şiminin gerekip gerekmediğini 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 verilmedikleri takdirde yeni kullanıcıların yeni Yönetim Grupları oluşturmasını engeller.

Yanıtlar

Name Type Description
200 OK

Tamam

Other Status Codes

Hata

Güvenlik

azure_auth

OAuth2 Flow Azure Active Directory.

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ün

Örnekler

GetGroupSettings

Sample Request

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

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

CreateOrUpdateSettingsRequest

Yönetim grubu ayarlarını oluşturmaya veya güncelleştirmeye yönelik parametreler

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şturmaya veya güncelleştirmeye yönelik parametreler

Name Type 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şiminin gerekip gerekmediğini 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 verilmedikleri takdirde yeni kullanıcıların yeni Yönetim Grupları oluşturmasını engeller.

ErrorDetails

Hatanın ayrıntıları.

Name Type Description
code
  • string

Sunucu tanımlı bir hata kodları kümesinden biri.

details
  • string

Hatanın ayrıntılarının okunabilir bir gösterimi.

message
  • string

Hatanın okunabilir bir gösterimi.

ErrorResponse

Hata nesnesi.

Name Type Description
error

Hata
Hatanın ayrıntıları.

HierarchySettings

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

Name Type Description
id
  • string

Ayarlar nesnesi için tam KIMLIK. Örneğin,/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000/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şiminin gerekip gerekmediğini 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 verilmedikleri takdirde 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-000000000000

type
  • string

Kaynağın türü. Örneğin, Microsoft. Management/managementGroups/Settings.