Management Groups - Create Or Update
建立或更新管理群組。 如果已建立管理群組,且後續的建立要求會以不同的屬性發出,則會更新管理群組屬性。
PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}?api-version=2020-05-01
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
group
|
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 |
詳細資料 |
|
properties.displayName |
string |
管理群組的易記名稱。 如果未傳遞任何值,此字段將會設定為 groupId。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
確定 |
|
202 Accepted |
已接受 標題
|
|
Other Status Codes |
錯誤 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
類型:
oauth2
Flow:
implicit
授權 URL:
https://login.microsoftonline.com/common/oauth2/authorize
範圍
名稱 | Description |
---|---|
user_impersonation | 模擬您的用戶帳戶 |
範例
PutManagementGroup
範例要求
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"
}
}
}
}
範例回覆
{
"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"
}
定義
名稱 | Description |
---|---|
Azure |
Azure-AsyncOperation 的結果。 |
Create |
建立期間所使用之管理群組的子資訊。 |
Create |
建立期間使用之管理群組的詳細數據。 |
Create |
管理群組建立參數。 |
Create |
(選擇性) 建立期間使用的父管理群組標識碼。 |
Error |
錯誤的詳細數據。 |
Error |
錯誤物件。 |
Management |
管理群組詳細數據。 |
Management |
管理群組的子資訊。 |
Management |
子資源的型別。 |
Management |
管理群組的詳細數據。 |
Management |
管理群組上階的路徑專案。 |
Parent |
(選擇性) 父管理群組的標識碼。 |
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 |
子系列表。 |
|
displayName |
string |
子資源的易記名稱。 |
id |
string |
子資源 (管理群組或訂用帳戶) 的完整標識符。 例如,/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000 |
name |
string |
子實體的名稱。 |
type |
子資源的型別。 |
CreateManagementGroupDetails
建立期間使用之管理群組的詳細數據。
名稱 | 類型 | Description |
---|---|---|
parent |
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 |
子系列表。 |
|
properties.details |
詳細資料 |
|
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 |
錯誤 |
ManagementGroup
管理群組詳細數據。
名稱 | 類型 | Description |
---|---|---|
id |
string |
管理群組的完整標識碼。 例如,/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000 |
name |
string |
管理群組的名稱。 例如,00000000-0000-0000-0000-0000000000000 |
properties.children |
子系列表。 |
|
properties.details |
詳細資料 |
|
properties.displayName |
string |
管理群組的易記名稱。 |
properties.tenantId |
string |
與管理群組相關聯的 AAD 租用戶標識碼。 例如,00000000-0000-0000-0000-0000000000000 |
type |
string |
資源類型。 例如,Microsoft.Management/managementGroups |
ManagementGroupChildInfo
管理群組的子資訊。
名稱 | 類型 | Description |
---|---|---|
children |
子系列表。 |
|
displayName |
string |
子資源的易記名稱。 |
id |
string |
子資源 (管理群組或訂用帳戶) 的完整標識符。 例如,/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000 |
name |
string |
子實體的名稱。 |
type |
子資源的型別。 |
ManagementGroupChildType
子資源的型別。
名稱 | 類型 | Description |
---|---|---|
/subscriptions |
string |
|
Microsoft.Management/managementGroups |
string |
ManagementGroupDetails
管理群組的詳細數據。
名稱 | 類型 | Description |
---|---|---|
parent |
Parent |
|
path |
從根目錄到目前群組的路徑。 |
|
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 |
父管理群組的名稱 |