Hierarchy Settings - Create Or Update

服務:

Management Groups

API 版本:

2020-05-01

建立或更新在管理群組層級定義的階層設定。

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

URI 參數

名稱	位於	必要	類型	Description
groupId	path	True	string	管理群組標識碼。
api-version	query	True	string	要與用戶端要求搭配使用的 API 版本。 目前的版本為 2018-01-01-preview。

要求本文

名稱	類型	Description
properties.defaultManagementGroup	string	設定設定預設管理群組，在此租使用者中新增訂用帳戶。 例如，/providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	指出在根管理群組下建立群組時，是否需要 RBAC 存取權。 如果設定為 true，使用者將需要根管理群組範圍的 Microsoft.Management/managementGroups/write 動作，才能直接在根目錄下建立新的群組。 除非有存取權，否則這可防止新使用者建立新的管理群組。

回應

名稱	類型	Description
200 OK	HierarchySettings	確定
Other Status Codes	ErrorResponse	錯誤

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

GetGroupSettings

範例要求

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

範例回覆

狀態碼:

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

定義

名稱	Description
CreateOrUpdateSettingsRequest	用於建立或更新管理群組設定的參數
ErrorDetails	錯誤的詳細數據。
ErrorResponse	錯誤物件。
HierarchySettings	在管理群組範圍中定義的設定。

CreateOrUpdateSettingsRequest

用於建立或更新管理群組設定的參數

名稱	類型	Description
properties.defaultManagementGroup	string	設定設定預設管理群組，在此租使用者中新增訂用帳戶。 例如，/providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	指出在根管理群組下建立群組時，是否需要 RBAC 存取權。 如果設定為 true，使用者將需要根管理群組範圍的 Microsoft.Management/managementGroups/write 動作，才能直接在根目錄下建立新的群組。 除非有存取權，否則這可防止新使用者建立新的管理群組。

ErrorDetails

錯誤的詳細數據。

名稱	類型	Description
code	string	其中一組伺服器定義的錯誤碼。
details	string	人類看得懂的錯誤詳細數據表示法。
message	string	人類看得懂的錯誤表示法。

ErrorResponse

錯誤物件。

名稱	類型	Description
error	ErrorDetails	錯誤 錯誤的詳細數據。

HierarchySettings

在管理群組範圍中定義的設定。

名稱	類型	Description
id	string	設定物件的完整標識碼。 例如，/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000/settings/default。
name	string	物件的名稱。 在這裡情況下，預設值為 。
properties.defaultManagementGroup	string	設定設定預設管理群組，在此租使用者中新增訂用帳戶。 例如，/providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	指出在根管理群組下建立群組時，是否需要 RBAC 存取權。 如果設定為 true，使用者將需要根管理群組範圍的 Microsoft.Management/managementGroups/write 動作，才能直接在根目錄下建立新的群組。 除非有存取權，否則這可防止新使用者建立新的管理群組。
properties.tenantId	string	與階層設定相關聯的 AAD 租用戶標識碼。 例如，00000000-0000-0000-0000-0000000000000
type	string	資源類型。 例如，Microsoft.Management/managementGroups/settings。