Hierarchy Settings - List

服務:

Management Groups

API 版本:

2020-05-01

取得在管理群組層級定義的所有階層設定。 設定只能設定在階層的根管理群組上。

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

URI 參數

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

回應

名稱	類型	Description
200 OK	HierarchySettingsList	確定
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	模擬您的用戶帳戶

範例

ListGroupSettings

範例要求

HTTP

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

範例回覆

狀態碼:

200

{
  "value": [
    {
      "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
      }
    }
  ],
  "@nextLink": null
}

定義

名稱	Description
ErrorDetails	錯誤的詳細數據。
ErrorResponse	錯誤物件。
HierarchySettingsInfo	階層設定資源。
HierarchySettingsList	清單 所有階層設定。

ErrorDetails

錯誤的詳細數據。

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

ErrorResponse

錯誤物件。

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

HierarchySettingsInfo

階層設定資源。

名稱	類型	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。

HierarchySettingsList

清單 所有階層設定。

名稱	類型	Description
@nextLink	string	用於取得下一組結果的 URL。
value	HierarchySettingsInfo[]	階層設定的清單。