Share via

Ügyfélszervezet lekérése

  • Cikk

A következőre vonatkozik: Partnerközpont

Ügyfélszervezeti erőforrást kap.

Előfeltételek

  • Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja az alkalmazás+felhasználói hitelesítő adatokat vagy az alkalmazásalapú hitelesítést.

  • Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, keresse meg a Partnerközpontban. Válassza ki az Ügyfelek munkaterületet a Partnerközpont kezdőlapján. Válassza ki az ügyfelet az Ügyfél listából, majd válassza a Fiók lehetőséget. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók részletei szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).

Fontos

Az API meghívásához GDAP-szerepkörök szükségesek. A DAP nem támogatott. A partnerhitelesítés továbbra is szükséges (AdminAgent/HelpDeskAgent/SalesAgent)

GDAP-szerepkörök

A következő GDAP-szerepkörök közül legalább egyre lesz szüksége:

  • Globális rendszergazda
  • Címtár-író
  • Globális olvasó

REST-kérés

Kérés szintaxisa

Metódus Kérés URI-ja
GET {baseURL}/v1/customers/{customer-tenant-id}/organization HTTP/1.1

URI-paraméter

Használja a következő lekérdezési paramétert egy adott ügyfélhez.

Név Típus Kötelező Leírás
ügyfél-bérlő-azonosító Guid Y Az érték egy GUID formátumú ügyfél-bérlő azonosító , amely lehetővé teszi, hogy a viszonteladó szűrje a viszonteladóhoz tartozó adott ügyfél eredményeit.

Kérelemfejlécek

További információ: Partnerközpont – REST fejlécek.

A kérés törzse

Nincs.

Példa kérése

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/organization HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: a176c585-b5de-4d65-824c-67a6deb45cd9
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

REST-válasz

Ha sikeres, ez a metódus egy ügyfélerőforrást ad vissza a válasz törzsében.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Hibakódok című témakörben találja.

Példa válaszra

HTTP/1.1 200 OK
Content-Length: 1530
Content-Type: application/json; charset=utf-8
MS-CorrelationId: a176c585-b5de-4d65-824c-67a6deb45cd9
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

[
  {
    "street": "1 Microsoft Way",
    "countryLetterCode": "US",
    "postalCode": "98052-8300",
    "city": "Redmond",
    "state": "WA",
    "displayName": "Contoso",
    "technicalNotificationMails": [
      "test@contoso.com"
    ]
  }
]

Következő lépések