Management Groups - Create Or Update

管理グループを作成または更新します。 管理グループが既に作成されていて、後続の作成要求が異なるプロパティで発行された場合、管理グループのプロパティが更新されます。

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

URI パラメーター

名前 / 必須 説明
groupId
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

CreateManagementGroupDetails

詳細
作成時に使用される管理グループの詳細。

properties.displayName

string

管理グループのフレンドリ名。 値が渡されない場合、このフィールドは groupId に設定されます。

応答

名前 説明
200 OK

ManagementGroup

OK

202 Accepted

AzureAsyncOperationResults

同意

Headers

  • Location: string
  • Azure-AsyncOperation: string
Other Status Codes

ErrorResponse

エラー

セキュリティ

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

定義

名前 説明
AzureAsyncOperationResults

Azure-AsyncOperation の結果。

CreateManagementGroupChildInfo

作成時に使用される管理グループの子情報。

CreateManagementGroupDetails

作成時に使用される管理グループの詳細。

CreateManagementGroupRequest

管理グループの作成パラメーター。

CreateParentGroupInfo

(省略可能)作成時に使用される親管理グループの ID。

ErrorDetails

エラーの詳細。

ErrorResponse

error オブジェクト。

ManagementGroup

管理グループの詳細。

ManagementGroupChildInfo

管理グループの子情報。

ManagementGroupChildType

子リソースの種類。

ManagementGroupDetails

管理グループの詳細。

ManagementGroupPathElement

管理グループの先祖の path 要素。

ParentGroupInfo

(省略可能)親管理グループの 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

CreateManagementGroupChildInfo[]

子の一覧。

displayName

string

子リソースのフレンドリ名。

id

string

子リソース (管理グループまたはサブスクリプション) の完全修飾 ID。 たとえば、/providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-00000000000

name

string

子エンティティの名前。

type

ManagementGroupChildType

子リソースの種類。
プロバイダー名前空間を含む完全修飾リソースの種類 (Microsoft.Management/managementGroups など)

CreateManagementGroupDetails

作成時に使用される管理グループの詳細。

名前 説明
parent

CreateParentGroupInfo

Parent
(省略可能)作成時に使用される親管理グループの ID。

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

CreateManagementGroupChildInfo[]

子の一覧。

properties.details

CreateManagementGroupDetails

詳細
作成時に使用される管理グループの詳細。

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

ErrorDetails

エラー
エラーの詳細。

ManagementGroup

管理グループの詳細。

名前 説明
id

string

管理グループの完全修飾 ID。 たとえば、/providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-00000000000

name

string

管理グループの名前。 たとえば、00000000-0000-0000-0000-000000000000000000

properties.children

ManagementGroupChildInfo[]

子の一覧。

properties.details

ManagementGroupDetails

詳細
管理グループの詳細。

properties.displayName

string

管理グループのフレンドリ名。

properties.tenantId

string

管理グループに関連付けられている AAD テナント ID。 たとえば、00000000-0000-0000-0000-000000000000000000

type

string

リソースの型。 たとえば、Microsoft.Management/managementGroups

ManagementGroupChildInfo

管理グループの子情報。

名前 説明
children

ManagementGroupChildInfo[]

子の一覧。

displayName

string

子リソースのフレンドリ名。

id

string

子リソース (管理グループまたはサブスクリプション) の完全修飾 ID。 たとえば、/providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-00000000000

name

string

子エンティティの名前。

type

ManagementGroupChildType

子リソースの種類。
プロバイダー名前空間を含む完全修飾リソースの種類 (Microsoft.Management/managementGroups など)

ManagementGroupChildType

子リソースの種類。

名前 説明
/subscriptions

string

Microsoft.Management/managementGroups

string

ManagementGroupDetails

管理グループの詳細。

名前 説明
parent

ParentGroupInfo

Parent
(省略可能)親管理グループの ID。

path

ManagementGroupPathElement[]

ルートから現在のグループへのパス。

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

親管理グループの名前