Management Groups - Create Or Update

參考

Service:: Management Groups

API Version:: 2020-05-01

建立或更新管理群組。如果已建立管理群組，且後續的建立要求會以不同的屬性發出，則會更新管理群組屬性。

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

URI 參數

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

要求標頭

名稱	必要	類型	Description
Cache-Control		string	表示要求不應使用任何快取。

要求本文

名稱	類型	Description
name	string	管理群組的名稱。例如，00000000-0000-0000-0000-0000000000000
properties.details	CreateManagementGroupDetails	詳細資料建立期間使用之管理群組的詳細數據。
properties.displayName	string	管理群組的易記名稱。如果未傳遞任何值，此字段將會設定為 groupId。

回應

名稱	類型	Description
200 OK	ManagementGroup	確定
202 Accepted	AzureAsyncOperationResults	已接受 Headers Location: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	錯誤

名稱

類型

Description

200 OK

ManagementGroup

確定

202 Accepted

AzureAsyncOperationResults

已接受

Headers

Location: string
Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

錯誤

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

PutManagementGroup

Sample Request

HTTP

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

Status code:: 200

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

Status code:: 202

{
  "id": "/providers/Microsoft.Management/managementGroups/ChildGroup",
  "type": "Microsoft.Management/managementGroups",
  "name": "ChildGroup",
  "status": "NotStarted"
}

定義

名稱	Description
AzureAsyncOperationResults	Azure-AsyncOperation 的結果。
CreateManagementGroupChildInfo	建立期間所使用之管理群組的子資訊。
CreateManagementGroupDetails	建立期間使用之管理群組的詳細數據。
CreateManagementGroupRequest	管理群組建立參數。
CreateParentGroupInfo	(選擇性) 建立期間使用的父管理群組標識碼。
ErrorDetails	錯誤的詳細數據。
ErrorResponse	錯誤物件。
ManagementGroup	管理群組詳細數據。
ManagementGroupChildInfo	管理群組的子資訊。
ManagementGroupChildType	子資源的型別。
ManagementGroupDetails	管理群組的詳細數據。
ManagementGroupPathElement	管理群組上階的路徑專案。
ParentGroupInfo	(選擇性) 父管理群組的標識碼。

AzureAsyncOperationResults

Azure-AsyncOperation 的結果。

名稱	類型	Description
id	string	管理群組的完整標識碼。例如，/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000
name	string	管理群組的名稱。例如，00000000-0000-0000-0000-0000000000000
properties.displayName	string	管理群組的易記名稱。
properties.tenantId	string	與管理群組相關聯的 AAD 租用戶標識碼。例如，00000000-0000-0000-0000-0000000000000
status	string	執行之異步操作的目前狀態。例如，執行中、成功、失敗
type	string	資源類型。例如，Microsoft.Management/managementGroups

CreateManagementGroupChildInfo

建立期間所使用之管理群組的子資訊。

名稱	類型	Description
children	CreateManagementGroupChildInfo[]	子系列表。
displayName	string	子資源的易記名稱。
id	string	子資源 (管理群組或訂用帳戶) 的完整標識符。例如，/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000
name	string	子實體的名稱。
type	ManagementGroupChildType	子資源的型別。包含提供者命名空間的完整資源類型 (，例如 Microsoft.Management/managementGroups)

CreateManagementGroupDetails

建立期間使用之管理群組的詳細數據。

名稱	類型	Description
parent	CreateParentGroupInfo	Parent (選擇性) 建立期間使用的父管理群組標識碼。
updatedBy	string	更新物件之主體或進程的識別。
updatedTime	string	上次更新此物件的日期和時間。
version	number	物件的版本號碼。

CreateManagementGroupRequest

管理群組建立參數。

名稱	類型	Description
id	string	管理群組的完整標識碼。例如，/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000
name	string	管理群組的名稱。例如，00000000-0000-0000-0000-0000000000000
properties.children	CreateManagementGroupChildInfo[]	子系列表。
properties.details	CreateManagementGroupDetails	詳細資料建立期間使用之管理群組的詳細數據。
properties.displayName	string	管理群組的易記名稱。如果未傳遞任何值，此字段將會設定為 groupId。
properties.tenantId	string	與管理群組相關聯的 AAD 租用戶標識碼。例如，00000000-0000-0000-0000-0000000000000
type	string	資源類型。例如，Microsoft.Management/managementGroups

CreateParentGroupInfo

(選擇性) 建立期間使用的父管理群組標識碼。

名稱	類型	Description
displayName	string	父管理群組的易記名稱。
id	string	父管理群組的完整標識碼。例如，/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000
name	string	父管理群組的名稱

ErrorDetails

錯誤的詳細數據。

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

ErrorResponse

錯誤物件。

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

ManagementGroup

管理群組詳細數據。

名稱	類型	Description
id	string	管理群組的完整標識碼。例如，/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000
name	string	管理群組的名稱。例如，00000000-0000-0000-0000-0000000000000
properties.children	ManagementGroupChildInfo[]	子系列表。
properties.details	ManagementGroupDetails	詳細資料管理群組的詳細數據。
properties.displayName	string	管理群組的易記名稱。
properties.tenantId	string	與管理群組相關聯的 AAD 租用戶標識碼。例如，00000000-0000-0000-0000-0000000000000
type	string	資源類型。例如，Microsoft.Management/managementGroups

ManagementGroupChildInfo

管理群組的子資訊。

名稱	類型	Description
children	ManagementGroupChildInfo[]	子系列表。
displayName	string	子資源的易記名稱。
id	string	子資源 (管理群組或訂用帳戶) 的完整標識符。例如，/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000
name	string	子實體的名稱。
type	ManagementGroupChildType	子資源的型別。包含提供者命名空間的完整資源類型 (，例如 Microsoft.Management/managementGroups)

ManagementGroupChildType

子資源的型別。

名稱	類型	Description
/subscriptions	string
Microsoft.Management/managementGroups	string

ManagementGroupDetails

管理群組的詳細數據。

名稱	類型	Description
parent	ParentGroupInfo	Parent (選擇性) 父管理群組的標識碼。
path	ManagementGroupPathElement[]	從根目錄到目前群組的路徑。
updatedBy	string	更新物件之主體或進程的識別。
updatedTime	string	上次更新此物件的日期和時間。
version	number	物件的版本號碼。

ManagementGroupPathElement

管理群組上階的路徑專案。

名稱	類型	Description
displayName	string	群組的易記名稱。
name	string	群組的名稱。

ParentGroupInfo

(選擇性) 父管理群組的標識碼。

名稱	類型	Description
displayName	string	父管理群組的易記名稱。
id	string	父管理群組的完整標識碼。例如，/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000
name	string	父管理群組的名稱

Share via

Management Groups - Create Or Update

URI 參數

要求標頭

要求本文

回應

安全性

azure_auth

Scopes

範例

PutManagementGroup

Sample Request

Sample Response

定義

AzureAsyncOperationResults

CreateManagementGroupChildInfo

CreateManagementGroupDetails

CreateManagementGroupRequest

CreateParentGroupInfo

ErrorDetails

ErrorResponse

ManagementGroup

ManagementGroupChildInfo

ManagementGroupChildType

ManagementGroupDetails

ManagementGroupPathElement

ParentGroupInfo

其他資源