Hierarchy Settings - List

管理グループ レベルで定義されているすべての階層設定を取得します。 設定は、階層のルート管理グループでのみ設定できます。

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

URI パラメーター

名前 / 必須 説明
groupId
path True

string

管理グループ ID。

api-version
query True

string

クライアント要求で使用される API のバージョン。 現在のバージョンは 2018-01-01-preview です。

応答

名前 説明
200 OK

HierarchySettingsList

OK

Other Status Codes

ErrorResponse

エラー

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントの借用

ListGroupSettings

要求のサンプル

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

応答のサンプル

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

定義

名前 説明
ErrorDetails

エラーの詳細。

ErrorResponse

error オブジェクト。

HierarchySettingsInfo

階層設定リソース。

HierarchySettingsList

すべての階層設定をListsします。

ErrorDetails

エラーの詳細。

名前 説明
code

string

サーバー定義のエラー コードのセットの 1 つ。

details

string

エラーの詳細を人間が判読できる表現。

message

string

エラーの人間が判読できる表現。

ErrorResponse

error オブジェクト。

名前 説明
error

ErrorDetails

エラー
エラーの詳細。

HierarchySettingsInfo

階層設定リソース。

名前 説明
id

string

settings オブジェクトの完全修飾 ID。 たとえば、/providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-000000000000000/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 テナント ID。 たとえば、00000000-0000-0000-0000-000000000000000000

type

string

リソースの型。 たとえば、Microsoft.Management/managementGroups/settings などです。

HierarchySettingsList

すべての階層設定をListsします。

名前 説明
@nextLink

string

次の結果セットを取得するために使用する URL。

value

HierarchySettingsInfo[]

階層設定の一覧。