Management Groups - Get Descendants

參考

Service:: Management Groups

API Version:: 2020-05-01

列出從管理群組遞減的所有實體。

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

With optional parameters:

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/descendants?api-version=2020-05-01&$skiptoken={$skiptoken}&$top={$top}

URI 參數

名稱	位於	必要	類型	Description
groupId	path	True	string	管理群組標識碼。
api-version	query	True	string	要與用戶端要求搭配使用的 API 版本。目前的版本為 2018-01-01-preview。
$skiptoken	query		string	只有在先前的作業傳回部分結果時，才會使用頁面接續令牌。如果先前的回應包含 nextLink 元素，nextLink 元素的值會包含 token 參數，指定後續呼叫要使用的起點。
$top	query		integer	擷取結果時要傳回的項目數目。傳入此檔案將會覆寫$skipToken。

回應

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

範例

GetDescendants

Sample Request

HTTP

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/20000000-0000-0000-0000-000000000000/descendants?api-version=2020-05-01

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "/providers/Microsoft.Management/managementGroups/20000000-0001-0000-0000-000000000000",
      "type": "Microsoft.Management/managementGroups",
      "name": "20000000-0001-0000-0000-000000000000",
      "properties": {
        "displayName": "Group 1",
        "parent": {
          "id": "/providers/Microsoft.Management/managementGroups/20000000-0000-0000-0000-000000000000"
        }
      }
    },
    {
      "id": "/subscriptions/20000000-0004-0000-0000-000000000000",
      "type": "Microsoft.Management/managementGroups/subscriptions",
      "name": "20000000-0004-0000-0000-000000000000",
      "properties": {
        "displayName": "Subscription 4",
        "parent": {
          "id": "/providers/Microsoft.Management/managementGroups/20000000-0000-0000-0000-000000000000"
        }
      }
    }
  ],
  "nextLink": null
}

定義

名稱	Description
DescendantInfo	子代。
DescendantListResult	描述檢視子系之要求的結果。
DescendantParentGroupInfo	父管理群組的標識碼。
ErrorDetails	錯誤的詳細數據。
ErrorResponse	錯誤物件。

DescendantInfo

子代。

名稱	類型	Description
id	string	子系的完整標識碼。例如，/providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000 或 /subscriptions/0000000-00000-0000-000000000000000000000000000000000000
name	string	子代的名稱。例如，00000000-0000-0000-0000-0000000000000
properties.displayName	string	管理群組的易記名稱。
properties.parent	DescendantParentGroupInfo	Parent 父管理群組的標識碼。
type	string	資源類型。例如，Microsoft.Management/managementGroups 或 /subscriptions

DescendantListResult

描述檢視子系之要求的結果。

名稱	類型	Description
nextLink	string	用於取得下一組結果的 URL。
value	DescendantInfo[]	子系的清單。

DescendantParentGroupInfo

父管理群組的標識碼。

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

ErrorDetails

錯誤的詳細數據。

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

ErrorResponse

錯誤物件。

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

Share via