Ottenere i partner di un cliente

Articolo
12/16/2024

si applica a: Centro per i partner

Come ottenere un elenco dei rivenditori indiretti o dei provider indiretti che hanno una relazione con un cliente specificato.

Prerequisiti

Essere attivamente registrati nel programma CSP come provider indiretto o rivenditore indiretto.
Credenziali descritte nella autenticazione di Partner Center. Questo scenario supporta l'autenticazione solo con le credenziali app+utente.
Un ID cliente (customer-tenant-id). Se non conosci l'ID del cliente, puoi cercarlo nel Centro per i Partner. Selezionare l'area di lavoro clienti nella home page del Centro per i partner. Selezionare il cliente dall'elenco Cliente, quindi selezionare Conto. Nella pagina Account del cliente, cercare l'ID Microsoft nella sezione Dettagli del'Account Cliente . L'ID Microsoft corrisponde all'ID cliente (customer-tenant-id).

C#

Per recuperare un elenco di rivenditori e fornitori indiretti con cui il cliente specificato ha una relazione, è necessario prima ottenere un'interfaccia per le operazioni di raccolta dei clienti del cliente specifico dalla proprietà partnerOperations.Customers, fornendo l'ID del cliente per identificarlo. Chiamare quindi il metodo Relationships.Get o Get_Async per ottenere l'elenco dei rivenditori indiretti.

// IAggregatePartner partnerOperations;
// string customerId;

 var partnerRelationships = partnerOperations.Customers[customerId].Relationships.Get();

Richiesta REST

Ecco le informazioni sulla richiesta REST e sulla risposta.

Sintassi della richiesta

Metodo	URI della richiesta
GET	{baseURL}/v1/customers/{customer-id}/relationships HTTP/1.1

Parametro URI

Usare il parametro path seguente per identificare il cliente.

Nome	Digitare	Obbligatorio	Descrizione
ID cliente	corda	Sì	Una stringa formattata in GUID che identifica il cliente.

Intestazioni della richiesta

Per ulteriori informazioni, vedere le intestazioni REST del Centro per i partner .

Corpo della richiesta

Nessuno.

Esempio di richiesta

GET https://api.partnercenter.microsoft.com/v1/customers/c501c3c4-d776-40ef-9ecf-9cefb59442c1/relationships HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c9251710-5a30-4cd3-891a-c42d550af9a8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

Risposta REST

In caso di esito positivo, il corpo della risposta contiene un insieme di risorse di tipo PartnerRelationship per identificare i rivenditori.

Codici di errore e esito positivo della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere il codice, il tipo di errore e i parametri aggiuntivi. Per l'elenco completo, vedere codici di errore del Partner Center.

Esempio di risposta

HTTP/1.1 200 OK
Content-Length: 264
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: c9251710-5a30-4cd3-891a-c42d550af9a8
MS-CV: plJP3ufU0UqXMeuh.0
MS-ServerId: 020021921
Date: Fri, 07 Apr 2017 23:42:11 GMT

{
    "totalCount": 1,
    "items": [{
            "id": "aaaa0000-aa11-2222-33cc-444444bbbbbb",
            "name": "First Up Consultants",
            "relationshipType": "is_indirect_cloud_solution_provider_of",
            "mpnId": "4847383",
            "attributes": {
                "objectType": "PartnerRelationship"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}

Condividi tramite