Ottenere il consenso del cliente come fornitore del Pannello di controllo
In qualità di fornitore del 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 | In | Obbligatorio | Digitare | Descrizione |
|---|---|---|---|---|
| ID cliente | sentiero | Vero | corda | ID del cliente generato nel Centro per i partner |
Intestazione della richiesta
Tipi di supporti: application/json
| Nome | Obbligatorio | Digitare | Descrizione |
|---|---|---|---|
| Autorizzazione | Vero | corda | Token di accesso per il pubblico https://api.partnercenter.microsoft.com |
| Accettare | Vero | corda | Tipo di contenuto accettabile; applicazione/json di tipo ampiamente accettato |
| ms-correlationid | corda | 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 | corda | 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 media: application/json
| Nome | Tipo | Descrizione |
|---|---|---|
| applicationId | corda | ID applicazione del partner CPV |
| applicationGrants | Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] | Elenco delle autorizzazioni delle applicazioni per ottenere l'accesso dei clienti nel loro ambiente. |
Risposte
| Nome | Digitare | Descrizione |
|---|---|---|
| 200 OK | Richiesta riuscita. 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 Vietato | 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 Non trovato | 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 | Digitare | Descrizione |
|---|---|---|
| enterpriseApplicationId | corda | Rappresentazione GUID della risorsa che ottiene l'accesso |
| ambito | corda | 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 | In | Obbligatorio | Digitare | Descrizione |
|---|---|---|---|---|
| ID cliente | sentiero | Vero | corda | ID del cliente generato nel Centro per i partner |
| ID_applicazione | sentiero | Vero | corda | ID dell'applicazione CPV |
Intestazione della richiesta
Tipi di supporti: application/json
| Nome | Obbligatorio | Digitare | Descrizione |
|---|---|---|---|
| Autorizzazione | Vero | corda | Token di accesso per il pubblico https://api.partnercenter.microsoft.com |
| Accettare | Vero | corda | Tipo di contenuto accettabile, in genere digitare application/json |
| ms-correlationid | corda | Usato per tenere traccia delle richieste internamente. Se non viene specificata una ms-correlationid, il server genera un nuovo per ogni richiesta |
|
| ms-requestid | corda | Usato per l'idempotenza delle richieste. Se non viene specificato un ms-requestid, il server ne genera uno nuovo per ogni richiesta |
Risposte
| Nome | Digitare | Descrizione |
|---|---|---|
| 200 OK | Richiesta riuscita. 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 Vietato | 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 Non trovato | 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 |