Management Groups - Create Or Update
管理グループを作成または更新します。 管理グループが既に作成されていて、後続の作成要求が異なるプロパティで発行された場合、管理グループのプロパティが更新されます。
PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}?api-version=2020-05-01
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
group
|
path | True |
string |
管理グループ ID。 |
api-version
|
query | True |
string |
クライアント要求で使用される API のバージョン。 現在のバージョンは 2018-01-01-preview です。 |
要求ヘッダー
名前 | 必須 | 型 | 説明 |
---|---|---|---|
Cache-Control |
string |
要求でキャッシュを使用しないことを示します。 |
要求本文
名前 | 型 | 説明 |
---|---|---|
name |
string |
管理グループの名前。 たとえば、00000000-0000-0000-0000-000000000000000000 |
properties.details |
詳細 |
|
properties.displayName |
string |
管理グループのフレンドリ名。 値が渡されない場合、このフィールドは groupId に設定されます。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
OK |
|
202 Accepted |
同意 Headers
|
|
Other Status Codes |
エラー |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー。
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントの借用 |
例
PutManagementGroup
Sample Request
PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/ChildGroup?api-version=2020-05-01
{
"properties": {
"displayName": "ChildGroup",
"details": {
"parent": {
"id": "/providers/Microsoft.Management/managementGroups/RootGroup"
}
}
}
}
Sample Response
{
"id": "/providers/Microsoft.Management/managementGroups/ChildGroup",
"type": "Microsoft.Management/managementGroups",
"name": "ChildGroup",
"properties": {
"tenantId": "20000000-0000-0000-0000-000000000000",
"displayName": "ChildGroup",
"details": {
"version": 1,
"updatedTime": "2018-01-01T00:00:00.00Z",
"updatedBy": "16b8ef21-5c9f-420c-bcc9-e4f8c9f30b4b",
"parent": {
"id": "/providers/Microsoft.Management/managementGroups/RootGroup",
"name": "RootGroup",
"displayName": "RootGroup"
}
}
}
}
{
"id": "/providers/Microsoft.Management/managementGroups/ChildGroup",
"type": "Microsoft.Management/managementGroups",
"name": "ChildGroup",
"status": "NotStarted"
}
定義
名前 | 説明 |
---|---|
Azure |
Azure-AsyncOperation の結果。 |
Create |
作成時に使用される管理グループの子情報。 |
Create |
作成時に使用される管理グループの詳細。 |
Create |
管理グループの作成パラメーター。 |
Create |
(省略可能)作成時に使用される親管理グループの ID。 |
Error |
エラーの詳細。 |
Error |
error オブジェクト。 |
Management |
管理グループの詳細。 |
Management |
管理グループの子情報。 |
Management |
子リソースの種類。 |
Management |
管理グループの詳細。 |
Management |
管理グループの先祖の path 要素。 |
Parent |
(省略可能)親管理グループの ID。 |
AzureAsyncOperationResults
Azure-AsyncOperation の結果。
名前 | 型 | 説明 |
---|---|---|
id |
string |
管理グループの完全修飾 ID。 たとえば、/providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-00000000000 |
name |
string |
管理グループの名前。 たとえば、00000000-0000-0000-0000-000000000000000000 |
properties.displayName |
string |
管理グループのフレンドリ名。 |
properties.tenantId |
string |
管理グループに関連付けられている AAD テナント ID。 たとえば、00000000-0000-0000-0000-000000000000000000 |
status |
string |
非同期操作が実行された現在の状態。 たとえば、実行中、成功、失敗 |
type |
string |
リソースの型。 たとえば、Microsoft.Management/managementGroups |
CreateManagementGroupChildInfo
作成時に使用される管理グループの子情報。
名前 | 型 | 説明 |
---|---|---|
children |
子の一覧。 |
|
displayName |
string |
子リソースのフレンドリ名。 |
id |
string |
子リソース (管理グループまたはサブスクリプション) の完全修飾 ID。 たとえば、/providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-00000000000 |
name |
string |
子エンティティの名前。 |
type |
子リソースの種類。 |
CreateManagementGroupDetails
作成時に使用される管理グループの詳細。
名前 | 型 | 説明 |
---|---|---|
parent |
Parent |
|
updatedBy |
string |
オブジェクトを更新したプリンシパルまたはプロセスの ID。 |
updatedTime |
string |
このオブジェクトが最後に更新された日時。 |
version |
number |
オブジェクトのバージョン番号。 |
CreateManagementGroupRequest
管理グループの作成パラメーター。
名前 | 型 | 説明 |
---|---|---|
id |
string |
管理グループの完全修飾 ID。 たとえば、/providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-00000000000 |
name |
string |
管理グループの名前。 たとえば、00000000-0000-0000-0000-000000000000000000 |
properties.children |
子の一覧。 |
|
properties.details |
詳細 |
|
properties.displayName |
string |
管理グループのフレンドリ名。 値が渡されない場合、このフィールドは groupId に設定されます。 |
properties.tenantId |
string |
管理グループに関連付けられている AAD テナント ID。 たとえば、00000000-0000-0000-0000-000000000000000000 |
type |
string |
リソースの型。 たとえば、Microsoft.Management/managementGroups |
CreateParentGroupInfo
(省略可能)作成時に使用される親管理グループの ID。
名前 | 型 | 説明 |
---|---|---|
displayName |
string |
親管理グループのフレンドリ名。 |
id |
string |
親管理グループの完全修飾 ID。 たとえば、/providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-00000000000 |
name |
string |
親管理グループの名前 |
ErrorDetails
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
code |
string |
サーバー定義のエラー コードのセットの 1 つ。 |
details |
string |
エラーの詳細を人間が判読できる表現。 |
message |
string |
エラーの人間が判読できる表現。 |
ErrorResponse
error オブジェクト。
名前 | 型 | 説明 |
---|---|---|
error |
エラー |
ManagementGroup
管理グループの詳細。
名前 | 型 | 説明 |
---|---|---|
id |
string |
管理グループの完全修飾 ID。 たとえば、/providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-00000000000 |
name |
string |
管理グループの名前。 たとえば、00000000-0000-0000-0000-000000000000000000 |
properties.children |
子の一覧。 |
|
properties.details |
詳細 |
|
properties.displayName |
string |
管理グループのフレンドリ名。 |
properties.tenantId |
string |
管理グループに関連付けられている AAD テナント ID。 たとえば、00000000-0000-0000-0000-000000000000000000 |
type |
string |
リソースの型。 たとえば、Microsoft.Management/managementGroups |
ManagementGroupChildInfo
管理グループの子情報。
名前 | 型 | 説明 |
---|---|---|
children |
子の一覧。 |
|
displayName |
string |
子リソースのフレンドリ名。 |
id |
string |
子リソース (管理グループまたはサブスクリプション) の完全修飾 ID。 たとえば、/providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-00000000000 |
name |
string |
子エンティティの名前。 |
type |
子リソースの種類。 |
ManagementGroupChildType
子リソースの種類。
名前 | 型 | 説明 |
---|---|---|
/subscriptions |
string |
|
Microsoft.Management/managementGroups |
string |
ManagementGroupDetails
管理グループの詳細。
名前 | 型 | 説明 |
---|---|---|
parent |
Parent |
|
path |
ルートから現在のグループへのパス。 |
|
updatedBy |
string |
オブジェクトを更新したプリンシパルまたはプロセスの ID。 |
updatedTime |
string |
このオブジェクトが最後に更新された日時。 |
version |
number |
オブジェクトのバージョン番号。 |
ManagementGroupPathElement
管理グループの先祖の path 要素。
名前 | 型 | 説明 |
---|---|---|
displayName |
string |
グループのフレンドリ名。 |
name |
string |
グループの名前。 |
ParentGroupInfo
(省略可能)親管理グループの ID。
名前 | 型 | 説明 |
---|---|---|
displayName |
string |
親管理グループのフレンドリ名。 |
id |
string |
親管理グループの完全修飾 ID。 たとえば、/providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-00000000000 |
name |
string |
親管理グループの名前 |