Dela via

Skaffa en kundorganisation

  • Artikel

Gäller för: Partnercenter

Hämtar en kundorganisationsresurs .

Förutsättningar

  • Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentiseringsuppgifter för app+användare eller endast appautentisering.

  • Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du leta upp det i Partnercenter. Välj arbetsytan Kunder på startsidan för Partnercenter. Välj kunden i kundlistan och välj sedan Konto. På kundens kontosida letar du efter Microsoft-ID:t i avsnittet Kundkontoinformation. Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id).

Viktigt!

GDAP-roller krävs för att anropa det här API:et. DAP stöds inte. Partnerautentisering krävs fortfarande (AdminAgent/HelpDeskAgent/SalesAgent)

GDAP-roller

Du behöver minst en av följande GDAP-roller:

  • Global administratör för
  • Katalogskrivare
  • Global läsare

REST-begäran

Syntax för begäran

Metod URI för förfrågan
GET {baseURL}/v1/customers/{customer-tenant-id}/organization HTTP/1.1

URI-parameter

Använd följande frågeparameter för en specifik kund.

Namn Typ Obligatoriskt Beskrivning
customer-tenant-id Guid Y Värdet är ett GUID-formaterat kund-klient-ID som gör att återförsäljaren kan filtrera resultatet för en viss kund som tillhör återförsäljaren.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Ingen.

Exempel på begäran

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-svar

Om det lyckas returnerar den här metoden en kundresurs i svarstexten.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Felkoder.

Svarsexempel

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"
    ]
  }
]

Nästa steg