Klanttoestemming krijgen als Configuratiescherm Leverancier
Als Configuratiescherm Leverancier (CPV) kunt u REST API's gebruiken om toestemming van uw CSP-klanten te verkrijgen en te verwijderen om machtigingen in hun tenants te krijgen.
POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents
Notitie
De frequentielimiet is 50 aanvragen per seconde (RPS) voor elke applicationId (toepassings-id van de CPV-partner).
Toestemming verkrijgen
URI-parameters
| Naam | In | Vereist | Type | Description |
|---|---|---|---|---|
| klant_id | path | Waar | tekenreeks | Id van de klant die is gegenereerd in partnercentrum |
Aanvraagheader
Mediatypen: application/json
| Naam | Vereist | Type | Description |
|---|---|---|---|
| Autorisatie | Waar | tekenreeks | Toegangstoken voor doelgroep https://api.partnercenter.microsoft.com |
| Accepteren | Waar | tekenreeks | Acceptabel inhoudstype; algemeen geaccepteerde typetoepassing/json |
| ms-correlationid | tekenreeks | Wordt intern gebruikt voor het bijhouden van aanvragen. Als er geen ms-correlationid wordt opgegeven, genereert de server een nieuwe voor elke aanvraag | |
| ms-requestid | tekenreeks | Wordt gebruikt voor idempotentie van aanvragen. Als er geen ms-requestid is opgegeven, genereert de server een nieuwe voor elke aanvraag |
Aanvraagtekst
Mediatypen: application/json
| Name | Type | Description |
|---|---|---|
| applicationId | tekenreeks | Toepassings-id van de CPV-partner |
| applicationGrants | Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] | Lijst met toepassingstoelagen om de toegang voor uw klanten in hun tenant te krijgen |
Antwoorden
| Name | Type | Description |
|---|---|---|
| 200 OK | De aanvraag is voltooid. Mediatypen: application/json, application/xml, , text/xmltext/json |
|
| 201 Gemaakt | De toepassingstoestemming wordt gemaakt. Mediatypen: application/json, application/xml, , text/xmltext/json |
|
| 400 Ongeldige aanvraag | Er ontbreekt of er is ongeldige invoer. De hoofdtekst van het antwoord bevat de foutdetails. Mediatypen: application/json, application/xml, , text/xmltext/json |
|
| 401 Onbevoegd | De aanvraag is niet geverifieerd. De client moet een geldig toegangstoken doorgeven voor een geldig publiek. Mediatypen: application/json, application/xml, , text/xmltext/json |
|
| 403 Verboden | De aanvraag is geverifieerd, maar is geweigerd omdat de beller niet over de rechten beschikt om deze aan te roepen. Mediatypen: application/json, application/xml, , text/xmltext/json |
|
| 404 Niet gevonden | De resource is niet gevonden of niet beschikbaar met de opgegeven invoerparameters. Mediatypen: application/json, application/xml, , text/xmltext/json |
|
| 500 Interne serverfout | De partner-API-service of een van de bijbehorende afhankelijkheden kan niet voldoen aan de aanvraag. Bellers kunnen de aanvraag opnieuw proberen. Mediatypen: application/json, application/xml, , text/xmltext/json |
Definities
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant
| Name | Type | Description |
|---|---|---|
| EnterpriseApplicationId | tekenreeks | De GUID-weergave van de resource die toegang krijgt |
| bereik | tekenreeks | Door komma's gescheiden waarden van het bereik voor het verkrijgen van toegang |
Toestemming verwijderen
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}
Notitie
De frequentielimiet is 50 aanvragen per seconde (RPS) voor elke applicationId (toepassings-id van de CPV-partner).
URI-parameters
| Naam | In | Vereist | Type | Description |
|---|---|---|---|---|
| klant_id | path | Waar | tekenreeks | Id van de klant die is gegenereerd in partnercentrum |
| Application_id | path | Waar | tekenreeks | Id van uw CPV-toepassing |
Aanvraagheader
Mediatypen: application/json
| Naam | Vereist | Type | Description |
|---|---|---|---|
| Autorisatie | Waar | tekenreeks | Toegangstoken voor doelgroep https://api.partnercenter.microsoft.com |
| Accepteren | Waar | tekenreeks | Acceptabel inhoudstype, meestal type toepassing/json |
| ms-correlationid | tekenreeks | Wordt intern gebruikt voor het bijhouden van aanvragen. Als er geen is ms-correlationid opgegeven, genereert de server een nieuwe voor elke aanvraag |
|
| ms-requestid | tekenreeks | Wordt gebruikt voor idempotentie van aanvragen. Als er geen ms-requestid is opgegeven, genereert de server een nieuwe voor elke aanvraag |
Antwoorden
| Name | Type | Description |
|---|---|---|
| 200 OK | De aanvraag is voltooid. Mediatypen: application/json, application/xml, , text/xmltext/json |
|
| 201 Gemaakt | De toestemming van de toepassing wordt verwijderd. Mediatypen: application/json, application/xml, , text/xmltext/json |
|
| 400 Ongeldige aanvraag | Er ontbreekt of er is ongeldige invoer. De hoofdtekst van het antwoord bevat de foutdetails. Mediatypen: application/json, application/xml, , text/xmltext/json |
|
| 401 Onbevoegd | De aanvraag is niet geverifieerd. De client moet een geldig toegangstoken doorgeven voor een geldig publiek. Mediatypen: application/json, application/xml, , text/xmltext/json |
|
| 403 Verboden | De aanvraag is geverifieerd, maar is geweigerd omdat de beller niet over de rechten beschikt om deze aan te roepen. Mediatypen: application/json, application/xml, , text/xmltext/json |
|
| 404 Niet gevonden | De resource is niet gevonden of niet beschikbaar met de opgegeven invoerparameters. Mediatypen: application/json, application/xml, , text/xmltext/json |
|
| 500 Interne serverfout | De partner-API-service of een van de bijbehorende afhankelijkheden kan niet voldoen aan de aanvraag. Bellers kunnen de aanvraag opnieuw proberen. Mediatypen: application/json, application/xml, , text/xmltext/json |