Management Groups - Update

參考

Service:: Management Groups

API Version:: 2020-05-01

更新管理群組。

PATCH 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
displayName	string	管理群組的易記名稱。
parentGroupId	string	(選擇性) 父管理群組的完整標識符。例如，/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000

回應

名稱	類型	Description
200 OK	ManagementGroup	確定
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	模擬您的用戶帳戶

範例

PatchManagementGroup

Sample Request

HTTP

PATCH https://management.azure.com/providers/Microsoft.Management/managementGroups/ChildGroup?api-version=2020-05-01


{
  "displayName": "AlternateDisplayName",
  "parentGroupId": "/providers/Microsoft.Management/managementGroups/AlternateRootGroup"
}

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": "AlternateDisplayName",
    "details": {
      "version": 2,
      "updatedTime": "2018-01-25T02:46:59.0545645Z",
      "updatedBy": "bd490e30-04cb-433e-b8c8-6066959a8bab",
      "parent": {
        "id": "/providers/Microsoft.Management/managementGroups/AlternateRootGroup",
        "name": "AlternateRootGroup",
        "displayName": "AlternateRootGroup"
      }
    }
  }
}

定義

名稱	Description
ErrorDetails	錯誤的詳細數據。
ErrorResponse	error 物件。
ManagementGroup	管理群組詳細數據。
ManagementGroupChildInfo	管理群組的子資訊。
ManagementGroupChildType	子資源的類型。
ManagementGroupDetails	管理群組的詳細數據。
ManagementGroupPathElement	管理群組上階的路徑專案。
ParentGroupInfo	(選擇性) 父管理群組的標識碼。
PatchManagementGroupRequest	管理群組修補程序參數。

ErrorDetails

錯誤的詳細數據。

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

ErrorResponse

error 物件。

名稱	類型	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	父管理群組的名稱

PatchManagementGroupRequest

管理群組修補程序參數。

名稱	類型	Description
displayName	string	管理群組的易記名稱。
parentGroupId	string	(選擇性) 父管理群組的完整標識符。例如，/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000

Share via