Ügyfél lekérése azonosító alapján

Cikk
09/20/2024

A következőre vonatkozik: Partnerközpont | A 21Vianet által üzemeltetett Partnerközpont | Partnerközpont a Microsoft Cloud for US Government számára

Lekéri az ügyfél-azonosítónak megfelelő ügyfélerőforrást .

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 Ügyfélazonosító lekérése API-hívás nem adja vissza a következő attribútumokat a válaszban, ha a partner nem rendelkezik DAP-hozzáféréssel az ügyfélbérlén. Ellenkező esetben a válaszmintában felsorolt összes attribútumot visszaadja.

CompanyProfileAddress
CompanyProfileEmail
CustomDomain

GDAP-szerepkörök

A Következő GDAP-szerepkörök közül legalább egyre lesz szüksége a VállalatiprofileAddress ügyfélszervezet, a CompanyProfileEmail és a CustomDomain ügyfél-egyéni tartományának lekéréséhez:

Címtár-író
Globális olvasó
Tartományi rendszergazda

C#

Ha azonosító alapján szeretne lekérni egy ügyfelet, használja az IAggregatePartner.Customers gyűjteményt, hívja meg a ById() metódust, majd hívja meg a Get() vagy a GetAsync() metódust.

// IAggregatePartner partnerOperations;
// string customerIdToRetrieve;

Customer customerInfo = partnerOperations.Customers.ById(customerIdToRetrieve).Get();

Példa: Konzoltesztelő alkalmazás. Projekt: PartnerSDK.FeatureSamples osztály: CustomerInformation.cs

Java

A Partnerközpont Java SDK-val kezelheti a Partnerközpont erőforrásait. Ez egy nyílt forráskódú projekt, amelyet a partnerközösség tart fenn, és amelyet a Microsoft hivatalosan nem támogat. Ha problémát tapasztal, segítséget kérhet a közösségtől, vagy problémákat nyithat meg a GitHubon.

Ha azonosító alapján szeretne lekérni egy ügyfelet, használja az IAggregatePartner.getCustomers függvényt, hívja meg a byId() függvényt, majd hívja meg a get() függvényt.

// IAggregatePartner partnerOperations;
// String customerIdToRetrieve;

Customer customerInfo = partnerOperations.getCustomers().byId(customerIdToRetrieve).get();

PowerShell

A Partnerközpont PowerShell-modulja a Partnerközpont erőforrásainak kezelésére használható. Ez egy nyílt forráskódú projekt, amelyet a partnerközösség tart fenn, és amelyet a Microsoft hivatalosan nem támogat. Ha problémát tapasztal, segítséget kérhet a közösségtől, vagy problémákat nyithat meg a GitHubon.

Ha azonosító alapján szeretne lekérni egy ügyfelet, hajtsa végre a Get-PartnerCustomer parancsot, és adja meg a CustomerId paramétert.

Get-PartnerCustomer -CustomerId '2ca7de6c-c05c-46b5-b689-32e53573a97a'

REST-kérés

Kérés szintaxisa

Metódus	Kérés URI-ja
GET	{baseURL}/v1/customers/{customer-tenant-id} 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	I	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érésfejlécek

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

Kérés törzse

Nincs.

Példa kérése

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id> HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

{
  "id": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "commerceId": "99e6a635-48e7-424d-9059-c9db944e3c54",
  "companyProfile": {
    "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "domain": "abcdefgh1234.onmicrosoft.com",
    "companyName": "1kl as kjk",
    "address": {
      "country": "US",
      "region": "wa",
      "city": "redmond",
      "addressLine1": "1 ms way",
      "postalCode": "98052",
      "phoneNumber": "1234567890"
    },
    "email": "a@a.com",
    "links": {
      "self": {
        "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/profiles/company",
        "method": "GET",
        "headers": []
      }
    },
    "attributes": {
      "objectType": "CustomerCompanyProfile"
    }
  },
  "billingProfile": {
    "id": "eeada110-69d6-4cc9-b093-75feb7ca9d3f",
    "firstName": "d0d89d776d03471c819bf772191ed728",
    "lastName": "kjkAJJAAAAAAAAAAAAAAAAAAAA",
    "email": "a@a.com",
    "culture": "en-US",
    "language": "en",
    "companyName": "1kl as kjkAAAAAAAAAAAAAAAJJJJJJJJJJJAAAAAJJJJJJJJJJJAAJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJAJJJJJAJJAAAAJAJJAAAAAAAAAAAAAAAAAAAA",
    "defaultAddress": {
      "country": "US",
      "city": "redmond",
      "state": "WA",
      "addressLine1": "1 ms way",
      "postalCode": "98052",
      "firstName": "1kl as",
      "lastName": "kjk",
      "phoneNumber": "1234567890"
    },
    "links": {
      "self": {
        "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/profiles/billing",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "etag": "-4242348048554929329",
      "objectType": "CustomerBillingProfile"
    }
  },
  "relationshipToPartner": "reseller",
  "allowDelegatedAccess": true,
  "customDomains": [
    "abcdefgh1234.onmicrosoft.com"
  ],
  tags": [
    "TestCustomer",
    "USCustomer"
  ],
  "links": {
    "self": {
      "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee",
      "method": "GET",
      "headers": []
    }
  },
  "attributes": {
    "objectType": "Customer"
  }
}

Megosztás a következőn keresztül: