Denetim Masası Satıcısı olarak müşteri onayı alma
Denetim Masası Satıcısı (CPV) olarak, CSP müşterilerinizin kiracılarına erişim izinlerini almak veya kaldırmak için REST API'lerini kullanabilirsiniz.
POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents
Not
Her bir uygulama kimliği (CPV iş ortağının Uygulama ID'si) için hız limiti saniyede 50 istektir (RPS).
Onay alma
URI parametreleri
| İsim | İçinde | Gerekli | Tür | Açıklama |
|---|---|---|---|---|
| müşteri_kimliği | yol | Doğru | karakter dizisi | Ortak Merkezi'nde oluşturulan müşterinin ID'si |
İstek üst bilgisi
Medya türleri: application/json
| İsim | Gerekli | Tür | Açıklama |
|---|---|---|---|
| İzin | Doğru | dizgi | Hedef Kitle https://api.partnercenter.microsoft.com için Erişim Anahtarı |
| Kabul Etmek | Doğru | dizgi | Kabul edilebilir içerik türü; yaygın olarak kabul edilen tür uygulaması/json |
| ms-correlationid | dizgi | İstekleri dahili olarak izlemek için kullanılır. Ms-correlationid sağlanmadıysa, sunucu her istek için yeni bir tane oluşturur | |
| ms-requestid | dizgi | İsteklerin idempotent olması için kullanılır. Bir ms-requestid sağlanmazsa, sunucu her istek için yeni bir tane oluşturur |
İstek gövdesi
Medya türleri: application/json
| Ad | Tür | Açıklama |
|---|---|---|
| applicationId | dizgi | CPV iş ortağının Uygulama Kimliği |
| applicationGrants | Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] | Müşterilerinize kiracı ortamlarında erişim sağlamak için uygulama izinlerinin listesi |
Yanıt
| Adı | Tür | Açıklama |
|---|---|---|
| 200 Tamam | İstek başarılı oldu. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 201 Oluşturuldu | Uygulama onayı oluşturulur. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 400 Hatalı İstek | Eksik veya geçersiz giriş vardı. Yanıt gövdesi hata ayrıntılarını içerir. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 401 Yetkisiz | İstek doğrulanmadı. İstemcinin, hedeflenen kitleye yönelik doğrulanmış bir erişim jetonu sağlaması gerekir. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 403 Yasak | İstek kimliği doğrulandı, ancak çağıranın yetkisi olmadığı için geri çevrildi. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 404 Bulunamadı | Kaynak bulunamadı veya verilen giriş parametreleriyle kullanılamıyor. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 500 İç Sunucu Hatası | İş ortağı API hizmeti veya bağımlılıklarından biri isteği yerine getiremedi. Arayanlar isteği yeniden deneyebilir. Medya Türleri: application/json, application/xml, text/xml, text/json |
Tanımlar
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant
| Ad | Tür | Açıklama |
|---|---|---|
| kurumsalUygulamaKimliği | dizgi | Erişim kazanan kaynağın GUID gösterimi |
| kapsam | dizgi | Erişim kazanmak için kapsamın virgülle ayrılmış değerleri |
Onayı kaldırma
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}
Not
Her bir Uygulama Kimliği (CPV iş ortağının Application ID'si) için hız sınırı saniyede 50 istektir (RPS).
URI parametreleri
| Ad | İçinde | Gerekli | Tür | Açıklama |
|---|---|---|---|---|
| müşteri_kimliği | yol | Doğru | dizgi | İş Ortağı Merkezi'nde oluşturulan müşteri kimliği |
| Application_id | yol | Doğru | dizgi | CPV uygulamanızın kimliği |
İstek üst bilgisi
Medya türleri: application/json
| İsim | Gerekli | Tür | Açıklama |
|---|---|---|---|
| İzin | Doğru | dizgi | hedef kitle https://api.partnercenter.microsoft.com için erişim belirteci |
| Kabul Etmek | Doğru | dizgi | Kabul edilebilir içerik türü, genellikle application/json türü |
| ms-correlationid | dizgi | İstekleri dahili olarak izlemek için kullanılır. Eğer bir ms-correlationid sağlanmazsa, sunucu her istek için yenisini oluşturur. |
|
| ms-requestid - İstek Tanımlayıcı | dizgi | İsteklerin idempotent olmasını sağlamak için kullanılır. Bir ms-requestid sağlanmazsa, sunucu her istek için yeni bir tane oluşturur |
Yanıt
| İsim | Tür | Açıklama |
|---|---|---|
| 200 Tamam | İstek başarılı oldu. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 201 Oluşturuldu | Uygulama onayı silinir. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 400 Hatalı İstek | Eksik veya geçersiz giriş vardı. Yanıt gövdesi hata ayrıntılarını içerir. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 401 Yetkisiz | İstek doğrulanmadı. İstemcinin, hedeflenen kitleye yönelik doğrulanmış bir erişim jetonu sağlaması gerekir. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 403 Yasak | İstek kimliği doğrulandı, ancak çağıranın yetkisi olmadığı için reddedildi. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 404 Bulunamadı | Kaynak bulunamadı veya verilen giriş parametreleriyle kullanılamıyor. Medya Türleri: application/json, application/xml, text/xml, text/json |
|
| 500 İç Sunucu Hatası | İş ortağı API hizmeti veya bağımlılıklarından biri isteği yerine getiremedi. Arayanlar isteği yeniden deneyebilir. Medya Türleri: application/json, application/xml, text/xml, text/json |