Megosztás a következőn keresztül:

Ügyfél-hozzájárulás lekérése Vezérlőpult szállítóként

  • Cikk

Vezérlőpult Szállítóként (CPV) REST API-k használatával szerezheti be és távolíthatja el a CSP-ügyfelek hozzájárulását az engedélyek bérlőkbe való beolvasásához.

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

URI-paraméterek

Name In Kötelező Típus Leírás
customer_id path True (Igaz) sztring A Partnerközpontban létrehozott ügyfél azonosítója

Kérelem fejléce

Médiatípusok: application/json

Name Kötelező Típus Leírás
Engedélyezés True (Igaz) sztring Hozzáférési jogkivonat a célközönség számára https://api.partnercenter.microsoft.com
Elfogadás True (Igaz) sztring Elfogadható tartalomtípus; széles körben elfogadott típusú alkalmazás/json
ms-correlationid sztring A kérések belső nyomon követésére szolgál. Ha nincs megadva ms-correlationid, a kiszolgáló minden kéréshez létrehoz egy újat
ms-requestid sztring A kérések idempotensségére szolgál. Ha nincs megadva ms-requestid, a kiszolgáló minden kéréshez újat hoz létre

A kérés törzse

Médiatípusok: application/json

Név Típus Leírás
applicationId sztring A CPV-partner alkalmazásazonosítója
applicationGrants Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] Alkalmazástámogatások listája az ügyfelek bérlői hozzáférésének beszerzéséhez

Válaszok

Név Típus Leírás
200 OK A kérés sikeres volt. Médiatípusok: "application/json", "application/xml", "text/xml", "text/json"
201 Létrehozva Létrejön az alkalmazás jóváhagyása. Médiatípusok: "application/json", "application/xml", "text/xml", "text/json"
400 – Hibás kérés Hiányzó vagy érvénytelen bemenet volt. A válasz törzse tartalmazza a hiba részleteit. Médiatípusok: "application/json", "application/xml", "text/xml", "text/json"
401 Nem engedélyezett A kérés hitelesítése nem történt meg. Az ügyfélnek érvényes hozzáférési jogkivonatot kell átadnia az érvényes célközönség számára. Médiatípusok: "application/json", "application/xml", "text/xml", "text/json"
403 – Tiltott A kérés hitelesítése megtörtént, de a rendszer elutasította, mert a hívónak nincs jogosultsága meghívni. Médiatípusok: "application/json", "application/xml", "text/xml", "text/json"
404 Nem található Az erőforrás nem található vagy nem érhető el a megadott bemeneti paraméterekkel. Médiatípusok: "application/json", "application/xml", "text/xml", "text/json"
500 Belső kiszolgálóhiba A partner API-szolgáltatás vagy annak egyik függősége nem tudta teljesíteni a kérést. A hívók újra megpróbálhatják a kérést. Médiatípusok: "application/json", "application/xml", "text/xml", "text/json"

Definíciók

Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant

Név Típus Leírás
enterpriseApplicationId sztring A hozzáférést kapó erőforrás GUID-reprezentációja
scope sztring A hozzáférés-szerzés hatókörének vesszővel tagolt értékei 
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}

URI-paraméterek

Name In Kötelező Típus Leírás
customer_id path True (Igaz) sztring A Partnerközpontban létrehozott ügyfél azonosítója
Application_id path True (Igaz) sztring A CPV-alkalmazás azonosítója

Kérelem fejléce

Médiatípusok: application/json

Name Kötelező Típus Leírás
Engedélyezés True (Igaz) sztring Hozzáférési jogkivonat a célközönség számára https://api.partnercenter.microsoft.com
Elfogadás True (Igaz) sztring Elfogadható tartalomtípus, általában az alkalmazás/json típus
ms-correlationid sztring A kérések belső nyomon követésére szolgál. ms-correlationid Ha a nincs megadva, a kiszolgáló minden kéréshez létrehoz egy újat
ms-requestid sztring A kérések idempotensségére szolgál. Ha nincs megadva ms-requestid, a kiszolgáló minden kéréshez újat hoz létre

Válaszok

Név Típus Leírás
200 OK A kérés sikeres volt. Médiatípusok: "application/json", "application/xml", "text/xml", "text/json"
201 Létrehozva Az alkalmazás beleegyezése törlődik. Médiatípusok: "application/json", "application/xml", "text/xml", "text/json"
400 – Hibás kérés Hiányzó vagy érvénytelen bemenet volt. A válasz törzse tartalmazza a hiba részleteit. Médiatípusok: "application/json", "application/xml", "text/xml", "text/json"
401 Nem engedélyezett A kérés hitelesítése nem történt meg. Az ügyfélnek érvényes hozzáférési jogkivonatot kell átadnia az érvényes célközönség számára. Médiatípusok: "application/json", "application/xml", "text/xml", "text/json"
403 – Tiltott A kérés hitelesítése megtörtént, de a rendszer elutasította, mert a hívónak nincs jogosultsága meghívni. Médiatípusok: "application/json", "application/xml", "text/xml", "text/json"
404 Nem található Az erőforrás nem található vagy nem érhető el a megadott bemeneti paraméterekkel. Médiatípusok: "application/json", "application/xml", "text/xml", "text/json"
500 Belső kiszolgálóhiba A partner API-szolgáltatás vagy annak egyik függősége nem tudta teljesíteni a kérést. A hívók újra megpróbálhatják a kérést. Médiatípusok: "application/json", "application/xml", "text/xml", "text/json"

Következő lépések