Dela via

Få kundmedgivande som kontrollpanelsleverantör

  • Artikel

Som kontrollpanelsleverantör (CPV) kan du använda REST-API:er för att hämta och ta bort medgivande från dina CSP-kunder för att få behörigheter till sina klienter.

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

Not

Hastighetsgränsen är 50 begäranden per sekund (RPS) för varje applicationId (program-ID för CPV-partnern).

URI-parametrar

Namn I Krävs Typ Beskrivning
kund-id stig Sann sträng ID för kunden som genererats i Partnercenter

Begärandehuvud

Medietyper: application/json

Namn Krävs Typ Beskrivning
Tillstånd Sann sträng Åtkomsttoken för målgrupp https://api.partnercenter.microsoft.com
Acceptera Sann sträng Godkänd innehållstyp; allmänt accepterad typprogram/json
ms-correlationid sträng Används för att spåra begäranden internt. Om ett ms-correlationid inte tillhandahålls genererar servern en ny för varje begäran
ms-requestid sträng Används för begärandens idempotens. Om ett ms-requestid inte har angetts genererar servern en ny för varje begäran

Begärandetext

Medietyper: application/json

Namn Typ Beskrivning
applicationId sträng Program-ID för CPV-partnern
applicationGrants Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] Lista över behörigheter för applikationer för att ge åtkomst för dina kunder i deras tenantmiljö

Svaren

Namn Typ Beskrivning
200 OK Begäran lyckades. Medietyper: application/json, application/xml, text/xml, text/json
201 Skapad Applikationens medgivande har skapats. Medietyper: application/json, application/xml, text/xml, text/json
400 Felaktig begäran Det saknades eller ogiltiga indata. Svarstexten innehåller felinformationen. Medietyper: application/json, application/xml, text/xml, text/json
401 Ej auktoriserad Begäran autentiserades inte. Klienten måste ange en giltig åtkomsttoken för den avsedda målgruppen. Medietyper: application/json, application/xml, text/xml, text/json
403 Förbjudet Begäran autentiserades men nekades eftersom anroparen inte har behörighet att anropa den. Medietyper: application/json, application/xml, text/xml, text/json
404 Hittades inte Resursen hittas inte eller är inte tillgänglig med de angivna indataparametrarna. Medietyper: application/json, application/xml, text/xml, text/json
500 Internt serverfel Partner-API-tjänsten eller något av dess beroenden kunde inte uppfylla begäran. Anropare kan försöka begäran igen. Medietyper: application/json, application/xml, text/xml, text/json

Definitioner

Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant

Namn Typ Beskrivning
företagsapplikations-id sträng GUID-representationen av resursen som får åtkomst
omfattning sträng Kommaavgränsade värden av behörighet för att få åtkomst 
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}

Not

Hastighetsgränsen är 50 begäranden per sekund (RPS) för varje applicationId (program-ID för CPV-partnern).

URI-parametrar

Namn I Krävs Typ Beskrivning
kund-id stig Sann sträng ID för kunden som genererats i Partnercenter
Applikation_ID stig Sann sträng ID för ditt CPV-program

Begärandehuvud

Medietyper: application/json

Namn Krävs Typ Beskrivning
Tillstånd Sann sträng Åtkomsttoken för målgrupp https://api.partnercenter.microsoft.com
Acceptera Sann sträng Acceptabel innehållstyp, skriv vanligtvis program/json
ms-correlationid sträng Används för att spåra begäranden internt. Om en ms-correlationid inte tillhandahålls genererar servern en ny för varje begäran
ms-requestid sträng Används för förfrågningars idempotens. Om ett ms-requestid inte har angetts genererar servern en ny för varje begäran

Svaren

Namn Typ Beskrivning
200 OK Begäran lyckades. Medietyper: application/json, application/xml, text/xml, text/json
201 Skapad Applikationens medgivande har raderats. Medietyper: application/json, application/xml, text/xml, text/json
400 Felaktig begäran Det saknades eller ogiltiga indata. Svarstexten innehåller felinformationen. Medietyper: application/json, application/xml, text/xml, text/json
401 Ej auktoriserad Begäran autentiserades inte. Klienten måste skicka en giltig åtkomsttoken till en målgrupp som uppfyller giltighetskriterierna. Medietyper: application/json, application/xml, text/xml, text/json
403 Förbjudet Begäran autentiserades men nekades eftersom anroparen inte har behörighet att anropa den. Medietyper: application/json, application/xml, text/xml, text/json
404 Hittades inte Resursen hittas inte eller är inte tillgänglig med de angivna indataparametrarna. Medietyper: application/json, application/xml, text/xml, text/json
500 Internt serverfel Partner-API-tjänsten eller något av dess beroenden kunde inte uppfylla begäran. Anropare kan försöka begäran igen. Medietyper: application/json, application/xml, text/xml, text/json

Relaterat innehåll