Condividi tramite


Ottenere il consenso del cliente come fornitore Pannello di controllo

In qualità di fornitore Pannello di controllo (CPV), è possibile usare le API REST per acquisire e rimuovere il consenso dai clienti CSP per ottenere le autorizzazioni nei tenant.

POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents

Parametri URI

Nome In Obbligatoria Tipo Descrizione
customer_id path True string ID del cliente generato nel Centro per i partner

Intestazione della richiesta

Tipi di supporti: application/json

Nome Obbligatorio Tipo Descrizione
Autorizzazione True string Token di accesso per destinatari https://api.partnercenter.microsoft.com
Accetta True string Tipo di contenuto accettabile; applicazione/json di tipo ampiamente accettato
ms-correlationid string Usato per tenere traccia delle richieste internamente. Se non viene specificato un ms-correlationid, il server genererà un nuovo valore per ogni richiesta
ms-requestid string Usato per l'idempotenza delle richieste. Se non viene specificato un ms-requestid, il server genererà uno nuovo per ogni richiesta

Testo della richiesta

Tipi di supporti: application/json

Nome Tipo Descrizione
applicationId string ID applicazione del partner CPV
applicationGrants Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] Elenco delle concessioni dell'applicazione per ottenere l'accesso per i clienti nel tenant

Risposte

Nome Tipo Descrizione
200 - OK La richiesta è stata completata. Tipi multimediali: "application/json", "application/xml", "text/xml", "text/json"
201 Creato Viene creato il consenso dell'applicazione. Tipi multimediali: "application/json", "application/xml", "text/xml", "text/json"
400 - Richiesta non valida Input mancante o non valido. Il corpo della risposta contiene i dettagli dell'errore. Tipi multimediali: "application/json", "application/xml", "text/xml", "text/json"
401 - Non autorizzato La richiesta non è stata autenticata. Il client deve passare un token di accesso valido per un gruppo di destinatari valido. Tipi multimediali: "application/json", "application/xml", "text/xml", "text/json"
403 - Accesso negato La richiesta è stata autenticata ma è stata rifiutata perché il chiamante non dispone dei diritti per richiamarlo. Tipi multimediali: "application/json", "application/xml", "text/xml", "text/json"
404 - Non trovato La risorsa non viene trovata o non è disponibile con i parametri di input specificati. Tipi multimediali: "application/json", "application/xml", "text/xml", "text/json"
500 - Errore interno del server Il servizio API partner o una delle relative dipendenze non è riuscito a soddisfare la richiesta. I chiamanti possono ripetere la richiesta. Tipi multimediali: "application/json", "application/xml", "text/xml", "text/json"

Definizioni

Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant

Nome Tipo Descrizione
enterpriseApplicationId string Rappresentazione GUID della risorsa che ottiene l'accesso
scope string Valori delimitati da virgole dell'ambito per ottenere l'accesso
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}

Parametri URI

Nome In Obbligatoria Tipo Descrizione
customer_id path True string ID del cliente generato nel Centro per i partner
Application_id path True string ID dell'applicazione CPV

Intestazione della richiesta

Tipi di supporti: application/json

Nome Obbligatorio Tipo Descrizione
Autorizzazione True string Token di accesso per i destinatari https://api.partnercenter.microsoft.com
Accetta True string Tipo di contenuto accettabile, in genere digitare applicazione/json
ms-correlationid string Usato per il rilevamento delle richieste internamente. Se un ms-correlationid oggetto non è specificato, il server genererà un nuovo per ogni richiesta
ms-requestid string Usato per la idempotenza delle richieste. Se non viene fornito un ms-requestid, il server genererà un nuovo oggetto per ogni richiesta

Risposte

Nome Tipo Descrizione
200 - OK La richiesta è stata completata. Tipi di supporto: "application/json", "application/xml", "text/xml", "text/json"
201 Creato Il consenso dell'applicazione viene eliminato. Tipi di supporto: "application/json", "application/xml", "text/xml", "text/json"
400 - Richiesta non valida Manca o non è valido l'input. Il corpo della risposta contiene i dettagli dell'errore. Tipi di supporto: "application/json", "application/xml", "text/xml", "text/json"
401 - Non autorizzato La richiesta non è stata autenticata. Il client deve passare un token di accesso valido per il pubblico valido. Tipi di supporto: "application/json", "application/xml", "text/xml", "text/json"
403 - Accesso negato La richiesta è stata autenticata, ma è stata rifiutata perché il chiamante non ha i diritti per richiamarlo. Tipi di supporto: "application/json", "application/xml", "text/xml", "text/json"
404 - Non trovato La risorsa non viene trovata o non disponibile con i parametri di input specificati. Tipi di supporto: "application/json", "application/xml", "text/xml", "text/json"
500 - Errore interno del server Il servizio API partner o una delle relative dipendenze non è riuscita a soddisfare la richiesta. I chiamanti possono ripetere la richiesta. Tipi di supporto: "application/json", "application/xml", "text/xml", "text/json"

Passaggi successivi