Management Groups - List

Başvuru

Service:: Management Groups

API Version:: 2020-05-01

Kimliği doğrulanmış kullanıcının yönetim gruplarını listeleyin.

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

With optional parameters:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
api-version	query	True	string	İstemci isteğiyle kullanılacak API sürümü. Geçerli sürüm 2018-01-01-preview sürümüdür.
$skiptoken	query		string	Sayfa devamı belirteci yalnızca önceki bir işlem kısmi bir sonuç döndürdüğünde kullanılır. Önceki bir yanıt bir nextLink öğesi içeriyorsa, nextLink öğesinin değeri sonraki çağrılar için kullanılacak bir başlangıç noktasını belirten bir belirteç parametresi içerir.

İstek Başlığı

Name	Gerekli	Tür	Description
Cache-Control		string	İsteğin önbellek kullanmaması gerektiğini gösterir.

Yanıtlar

Name	Tür	Description
200 OK	ManagementGroupListResult	Tamam
Other Status Codes	ErrorResponse	Hata

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

ListManagementGroups

Sample Request

HTTP

GET https://management.azure.com/providers/Microsoft.Management/managementGroups?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": {
        "tenantId": "20000000-0000-0000-0000-000000000000",
        "displayName": "Group 1 Tenant 2"
      }
    },
    {
      "id": "/providers/Microsoft.Management/managementGroups/20000000-0004-0000-0000-000000000000",
      "type": "Microsoft.Management/managementGroups",
      "name": "20000000-0004-0000-0000-000000000000",
      "properties": {
        "tenantId": "20000000-0000-0000-0000-000000000000",
        "displayName": "Group 4 Tenant 2"
      }
    }
  ],
  "@nextLink": null
}

Tanımlar

Name	Description
ErrorDetails	Hatanın ayrıntıları.
ErrorResponse	Hata nesnesi.
ManagementGroupInfo	Yönetim grubu kaynağı.
ManagementGroupListResult	Yönetim gruplarını listeleme isteğinin sonucunu açıklar.

ErrorDetails

Hatanın ayrıntıları.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
details	string	Hatanın ayrıntılarının insanlar tarafından okunabilir bir gösterimi.
message	string	Hatanın insanlar tarafından okunabilir bir gösterimi.

ErrorResponse

Hata nesnesi.

Name	Tür	Description
error	ErrorDetails	Hata Hatanın ayrıntıları.

ManagementGroupInfo

Yönetim grubu kaynağı.

Name	Tür	Description
id	string	Yönetim grubunun tam kimliği. Örneğin, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000
name	string	Yönetim grubunun adı. Örneğin, 000000000-0000-0000-0000-0000000000000
properties.displayName	string	Yönetim grubunun kolay adı.
properties.tenantId	string	Yönetim grubuyla ilişkili AAD Kiracı Kimliği. Örneğin, 000000000-0000-0000-0000-0000000000000
type	string	Kaynağın türü. Örneğin, Microsoft.Management/managementGroups

ManagementGroupListResult

Yönetim gruplarını listeleme isteğinin sonucunu açıklar.

Name	Tür	Description
@nextLink	string	Sonraki sonuç kümesini almak için kullanılacak URL.
value	ManagementGroupInfo[]	Yönetim gruplarının listesi.

Share via