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

Az ügyfelek listájának lekérése

  • Cikk

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

Ez a cikk azt ismerteti, hogyan szerezhet be olyan erőforrásgyűjteményt, amely egy partner összes ügyfelet képviseli.

Tipp

Ezt a műveletet a Partnerközpontban is végrehajthatja. A Kezdőlapon válassza az Ügyfelek munkaterületet, majd tekintse meg az ügyfeleket a menü Ügyfelek listájával .

Előfeltételek

  • Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja a különálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.

C#

Az összes ügyfél listájának lekérése:

  1. Az IAggregatePartner.Customers gyűjtemény használatával hozzon létre egy IPartner-objektumot .

  2. Kérje le az ügyféllistát a Query() vagy a QueryAsync() metódussal. (A lekérdezés létrehozásával kapcsolatos utasításokért tekintse meg a QueryFactory osztályt .)

// IAggregatePartner partnerOperations;

// All the operations executed on this partner operation instance will share the same correlation Id but will differ in request Id
IPartner scopedPartnerOperations = partnerOperations.With(RequestContextFactory.Instance.Create(Guid.NewGuid()));

// read customers into chunks of 40s
var customersBatch = scopedPartnerOperations.Customers.Query(QueryFactory.Instance.BuildIndexedQuery(40));
var customersEnumerator = scopedPartnerOperations.Enumerators.Customers.Create(customersBatch);

Példaként tekintse meg a következőt:

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 megnyithat egy problémát a GitHubon .

Az összes ügyfél listájának lekérése:

  1. Használja az [IAggregatePartner.getCustomers] függvényt az ügyfélműveletek hivatkozásának lekéréséhez.

  2. Kérje le az ügyféllistát a query() függvénnyel.

// Query the customers, get the first page if a page size was set, otherwise get all customers
SeekBasedResourceCollection<Customer> customersPage = partnerOperations.getCustomers().query(QueryFactory.getInstance().buildIndexedQuery(40));

// Create a customer enumerator which will aid us in traversing the customer pages
IResourceCollectionEnumerator<SeekBasedResourceCollection<Customer>> customersEnumerator =
    partnerOperations.getEnumerators().getCustomers().create( customersPage );

int pageNumber = 1;

while (customersEnumerator.hasValue())
{
    /*
     * Use the customersEnumerator.getCurrent() function to
     * access the current page of customers.
     */

    // Get the next page of customers
    customersEnumerator.next();
}

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 megnyithat egy problémát a GitHubon .

Futtassa a Get-PartnerCustomer parancsot paraméterek nélkül az ügyfelek teljes listájának lekéréséhez.

Get-PartnerCustomer

REST-kérelem

Kérés szintaxisa

Metódus Kérés URI-ja
GET {baseURL}/v1/customers?size={size} HTTP/1.1

URI-paraméter

Az ügyfelek listájának lekéréséhez használja a következő lekérdezési paramétert.

Név Típus Kötelező Leírás
Méret Int Y Az egyszerre megjelenítendő eredmények száma.

Kérésfejlécek

További információ: Partnerközpont REST-fejlécei.

A kérés törzse

Nincsenek.

Példa kérésre

GET https://api.partnercenter.microsoft.com/v1/customers?size=40 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 3705fc6d-4127-4a87-bdba-9658f73fe019
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST-válasz

Ha sikerült, ez a metódus ügyfélerőforrások gyűjteményét adja vissza a válasz törzsében.

Sikeres válasz é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. Használja a hálózati nyomkövetési eszközt a kód, a hibatípus és a további paraméterek olvasásához. 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: 15650
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 3705fc6d-4127-4a87-bdba-9658f73fe019
Date: Fri, 20 Nov 2015 01:08:23 GMT

{
    "totalCount": 2,
    "items": [{
        "id": "b44bb1fb-c595-45b0-9e09-d657365580bf",
        "companyProfile": {
            "tenantId": "<guid>",
            "domain": "domain",
            "companyName": "companyName",
            "attributes": {
                "objectType": "CustomerCompanyProfile"
            }
        },
        "relationshipToPartner": "reseller",
        "attributes": {
            "objectType": "Customer"
        }
    },
    {
        "id": "45c44870-ef77-4fdd-b6fe-3dacb075cff2",
        "companyProfile": {
            "tenantId": "<guid>",
            "domain": "domain",
            "companyName": "companyName",
            "attributes": {
                "objectType": "CustomerCompanyProfile"
            }
        },
        "relationshipToPartner": "reseller",
        "attributes": {
            "objectType": "Customer"
        }
    }],
    "links": {
        "self": {
            "uri": "/v1/customers?size=40",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}