Aracılığıyla paylaş


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 İç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.

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

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

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