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
Nota
Il limite di velocità è 50 richieste al secondo (RPS) per ogni applicationId (ID applicazione del partner CPV).
Acquisire il consenso
Parametri URI
| Nome | Tra | Richiesto | Type | Descrizione |
|---|---|---|---|---|
| customer_id | path | Vero | string | ID del cliente generato nel Centro per i partner |
Intestazione della richiesta
Tipi di supporti: application/json
| Nome | Obbligatorio | Type | Descrizione |
|---|---|---|---|
| Autorizzazione | Vero | string | Token di accesso per destinatari https://api.partnercenter.microsoft.com |
| Accept | Vero | 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 ne genera uno nuovo per ogni richiesta | |
| ms-requestid | string | Usato per l'idempotenza delle richieste. Se non viene specificato un ms-requestid, il server ne genera uno nuovo per ogni richiesta |
Corpo 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 di supporti: application/json, application/xml, text/xml, text/json |
|
| 201 Creato | Viene creato il consenso dell'applicazione. Tipi di supporti: 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 di supporti: 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 di supporti: application/json, application/xml, text/xml, text/json |
|
| 403 Negato | La richiesta è stata autenticata ma è stata rifiutata perché il chiamante non dispone dei diritti per richiamarlo. Tipi di supporti: application/json, application/xml, text/xml, text/json |
|
| 404 Not Found | La risorsa non viene trovata o non è disponibile con i parametri di input specificati. Tipi di supporti: 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 ritentare la richiesta. Tipi di supporti: 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 |
| ambito | string | Valori delimitati da virgole dell'ambito per ottenere l'accesso |
Rimuovere il consenso
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}
Nota
Il limite di velocità è 50 richieste al secondo (RPS) per ogni applicationId (ID applicazione del partner CPV).
Parametri URI
| Nome | Tra | Richiesto | Type | Descrizione |
|---|---|---|---|---|
| customer_id | path | Vero | string | ID del cliente generato nel Centro per i partner |
| Application_id | path | Vero | string | ID dell'applicazione CPV |
Intestazione della richiesta
Tipi di supporti: application/json
| Nome | Obbligatorio | Type | Descrizione |
|---|---|---|---|
| Autorizzazione | Vero | string | Token di accesso per destinatari https://api.partnercenter.microsoft.com |
| Accept | Vero | string | Tipo di contenuto accettabile, in genere digitare application/json |
| ms-correlationid | string | Usato per tenere traccia delle richieste internamente. Se non viene specificato , ms-correlationid il server genera un nuovo per ogni richiesta |
|
| ms-requestid | string | Usato per l'idempotenza delle richieste. Se non viene specificato un ms-requestid, il server ne genera uno nuovo per ogni richiesta |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK | La richiesta è stata completata. Tipi di supporti: application/json, application/xml, text/xml, text/json |
|
| 201 Creato | Il consenso dell'applicazione viene eliminato. Tipi di supporti: 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 di supporti: 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 di supporti: application/json, application/xml, text/xml, text/json |
|
| 403 Negato | La richiesta è stata autenticata ma è stata rifiutata perché il chiamante non dispone dei diritti per richiamarlo. Tipi di supporti: application/json, application/xml, text/xml, text/json |
|
| 404 Not Found | La risorsa non viene trovata o non è disponibile con i parametri di input specificati. Tipi di supporti: 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 ritentare la richiesta. Tipi di supporti: application/json, application/xml, text/xml, text/json |