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 パラメーター

名前	/	必須	型	説明
groupId	path	True	string	管理グループ ID。
api-version	query	True	string	クライアント要求で使用される API のバージョン。現在のバージョンは 2018-01-01-preview です。

要求本文

名前	型	説明
properties.defaultManagementGroup	string	このテナントに新しいサブスクリプションを追加する既定の管理グループを設定する設定。たとえば、/providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	ルート管理グループでグループを作成したときに RBAC アクセスが必要かどうかを示します。 true に設定すると、ユーザーはルートの直下に新しいグループを作成するために、ルート管理グループスコープに対して Microsoft.Management/managementGroups/write アクションを要求します。これにより、アクセス権が付与されない限り、新しいユーザーが新しい管理グループを作成できなくなります。

応答

名前	型	説明
200 OK	HierarchySettings	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	ユーザーアカウントの借用

例

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

定義

名前	説明
CreateOrUpdateSettingsRequest	管理グループ設定を作成または更新するためのパラメーター
ErrorDetails	エラーの詳細。
ErrorResponse	error オブジェクト。
HierarchySettings	管理グループスコープで定義された設定。

CreateOrUpdateSettingsRequest

管理グループ設定を作成または更新するためのパラメーター

名前	型	説明
properties.defaultManagementGroup	string	このテナントに新しいサブスクリプションを追加する既定の管理グループを設定する設定。たとえば、/providers/Microsoft.Management/managementGroups/defaultGroup
properties.requireAuthorizationForGroupCreation	boolean	ルート管理グループでグループを作成したときに RBAC アクセスが必要かどうかを示します。 true に設定すると、ユーザーはルートの直下に新しいグループを作成するために、ルート管理グループスコープに対して Microsoft.Management/managementGroups/write アクションを要求します。これにより、アクセス権が付与されない限り、新しいユーザーが新しい管理グループを作成できなくなります。

ErrorDetails

エラーの詳細。

名前	型	説明
code	string	サーバー定義のエラーコードのセットの 1 つ。
details	string	エラーの詳細を人間が判読できる表現。
message	string	エラーの人間が判読できる表現。

ErrorResponse

error オブジェクト。

名前	型	説明
error	ErrorDetails	エラーエラーの詳細。

HierarchySettings

管理グループスコープで定義された設定。

名前	型	説明
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 などです。

次の方法で共有