Condividi tramite

Ottenere la qualifica di un cliente in modo asincrono

  • Articolo

Come ottenere le qualifiche di un cliente in modo asincrono.

Prerequisiti

  • Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.

  • ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina Account del cliente cercare l'ID Microsoft nella sezione Informazioni sull'account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).

C#

Per ottenere le qualifiche di un cliente, chiamare il metodo IAggregatePartner.Customers.ById con l'identificatore del cliente. Usare quindi la proprietà Qualification per recuperare un'interfaccia ICustomerQualification. Infine, chiamare GetQualifications() o GetQualificationsAsync() per recuperare le qualifiche del cliente.

// IAggregatePartner partnerOperations;
// string customerId;
var customerQualifications = partnerOperations.Customers.ById(customerId).Qualification.GetQualifications();

Esempio: App di esempio console. Project: SdkSamples Class: GetCustomerQualifications.cs

Richiesta REST

Sintassi della richiesta

Method URI della richiesta
GET {baseURL}/v1/customers/{customer-tenant-id}/qualifications HTTP/1.1

Parametro URI

Questa tabella elenca il parametro di query necessario per ottenere tutte le qualificazioni.

Nome Digita Richiesto Descrizione
customer-tenant-id string Sì Stringa in formato GUID che identifica il cliente.

Intestazioni delle richieste

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Corpo della richiesta

Nessuno.

Esempio di richiesta

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/qualifications HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68

Risposta REST

In caso di esito positivo, questo metodo restituisce una raccolta di qualifiche nel corpo della risposta. Di seguito sono riportati esempi di chiamata GET su un cliente con qualifica education .

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Esempi di risposta

Approvata

HTTP/1.1 200 OK
Content-Length:
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
[
    {
        "qualification": "Education",
        "vettingStatus": "Approved",
    }
]

In revisione

HTTP/1.1 200 OK
Content-Length:
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
[
    {
        "qualification": "Education",
        "vettingStatus": "InReview",
        "vettingCreatedDate": "2020-12-03T10:37:38.885Z" // UTC
    }
]

Non consentito

HTTP/1.1 200 OK
Content-Length:
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 037db222-6d8e-4d7f-ba78-df3dca33fb68
[
    {
        "qualification": "Education",
        "vettingStatus": "Denied",
        "vettingReason": "Not an Education Customer", // example Vetting Reason
        "vettingCreatedDate": "2020-12-03T10:37:38.885Z" // UTC
    }
]

Esempi di entità di proprietà dello stato

Entità di proprietà dello stato tramite l'esempio POST


//SOE
POST {customer_id}/qualifications
{
"qualification": "StateOwnedEntity"
}

//

Esempio di entità di proprietà dello stato tramite Get Qualifications


//SOE:
GET {customer_id}/qualifications
[
    {
        "qualification": "StateOwnedEntity"
    }
]

Entità di proprietà dello stato tramite Ottenere qualifiche con l'istruzione


GET {customer_id}/qualifications
[
    {
        "qualification": "Education",
        "vettingStatus": "Approved"
    },
{
        "qualification": "StateOwnedEntity"
    }
]

Entità di proprietà dello stato tramite Ottenere qualifiche con GCC


GET {customer_id}/qualifications
[
    {
        "qualification": "GovernmentCommunityCloud",
        "vettingStatus": "Approved",
        "vettingCreateDate": "2021-05-06T19:59:56.6832021+00:00"
    },
{
        "qualification": "StateOwnedEntity"
    }
]