Bagikan melalui

Mendapatkan persetujuan pelanggan sebagai Vendor Panel Kontrol

  • Artikel

Sebagai Vendor Panel Kontrol (CPV), Anda dapat menggunakan REST API untuk mendapatkan dan mencabut persetujuan dari pelanggan CSP Anda agar memperoleh izin ke tenant mereka.

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

Nota

Batas tarif adalah 50 permintaan per detik (RPS) untuk setiap applicationId (ID Aplikasi mitra CPV).

Parameter URI

Nama Di Diperlukan Jenis Deskripsi
ID pelanggan jalan Benar benang ID pelanggan yang dihasilkan di Partner Center

Header permintaan

Jenis media: application/json

Nama Diperlukan Jenis Deskripsi
Otorisasi Benar benang Token Akses untuk audiens https://api.partnercenter.microsoft.com
Terima Benar benang Tipe isi yang dapat diterima; aplikasi/json jenis yang diterima secara luas
ms-correlationid benang Digunakan untuk melacak permintaan secara internal. Jika ms-correlationid tidak disediakan, server menghasilkan yang baru untuk setiap permintaan
ms-requestid benang Digunakan untuk idempotensi permintaan. Jika ms-requestid tidak disediakan, server menghasilkan yang baru untuk setiap permintaan

Isi permintaan

Jenis media: application/json

Nama Jenis Deskripsi
applicationId benang ID aplikasi mitra CPV
applicationGrants Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] Daftar izin aplikasi untuk memberikan akses kepada pelanggan Anda di tenant mereka

Tanggapan

Nama Jenis Deskripsi
200 OK Permintaan berhasil. Jenis Media: application/json, application/xml, text/xml, text/json
201 Dibuat Persetujuan aplikasi sudah dibuat. Jenis Media: application/json, application/xml, text/xml, text/json
400 Permintaan Tidak Valid Ada input yang hilang atau tidak valid. Isi respons berisi detail kesalahan. Jenis Media: application/json, application/xml, text/xml, text/json
401 Tidak Sah Permintaan tidak diautentikasi. Klien perlu meneruskan token akses yang valid untuk audiens yang valid. Jenis Media: application/json, application/xml, text/xml, text/json
403 Terlarang Permintaan diautentikasi tetapi ditolak karena pemanggil tidak memiliki hak untuk memanggilnya. Jenis Media: application/json, application/xml, text/xml, text/json
404 Tidak Ditemukan Sumber daya tidak ditemukan atau tidak tersedia dengan parameter input yang diberikan. Jenis Media: application/json, application/xml, text/xml, text/json
Kesalahan Server Internal 500 Layanan API mitra atau salah satu dependensinya gagal memenuhi permintaan. Penelepon dapat mencoba kembali permintaan. Jenis Media: application/json, application/xml, text/xml, text/json

Definisi

Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant

Nama Jenis Deskripsi
enterpriseApplicationId benang Representasi GUID dari sumber daya yang mendapatkan akses
ruang lingkup benang Nilai cakupan yang dipisahkan dengan tanda koma untuk mendapatkan akses 
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}

Nota

Batas tarif adalah 50 permintaan per detik (RPS) untuk setiap applicationId (ID Aplikasi mitra CPV).

Parameter URI

Nama Di Diperlukan Jenis Deskripsi
ID pelanggan jalan Benar benang ID pelanggan yang dihasilkan di Partner Center
Application_id jalan Benar benang ID aplikasi CPV Anda

Header permintaan

Jenis media: application/json

Nama Diperlukan Jenis Deskripsi
Otorisasi Benar benang Token akses untuk audiens https://api.partnercenter.microsoft.com
Terima Benar benang Jenis konten yang dapat diterima, biasanya ketik aplikasi/json
ms-correlationid benang Digunakan untuk melacak permintaan secara internal. Jika ms-correlationid tidak disediakan, server akan menghasilkan yang baru untuk setiap permintaan
ms-requestid benang Digunakan untuk idempotensi permintaan. Jika ms-requestid tidak disediakan, server menghasilkan yang baru untuk setiap permintaan

Tanggapan

Nama Jenis Deskripsi
200 OK Permintaan berhasil. Jenis Media: application/json, application/xml, text/xml, text/json
201 Dibuat Persetujuan aplikasi dihapus. Jenis Media: application/json, application/xml, text/xml, text/json
400 Permintaan Tidak Valid Ada input yang hilang atau tidak valid. Isi respons berisi detail kesalahan. Jenis Media: application/json, application/xml, text/xml, text/json
401 Tidak Sah Permintaan tidak diautentikasi. Pelanggan perlu meneruskan token akses yang valid untuk audiens yang sesuai. Jenis Media: application/json, application/xml, text/xml, text/json
403 Terlarang Permintaan diautentikasi tetapi ditolak karena pemanggil tidak memiliki hak untuk memanggilnya. Jenis Media: application/json, application/xml, text/xml, text/json
404 Tidak Ditemukan Sumber daya tidak ditemukan atau tidak tersedia dengan parameter input yang diberikan. Jenis Media: application/json, application/xml, text/xml, text/json
Kesalahan Server Internal 500 Layanan API mitra atau salah satu dependensinya gagal memenuhi permintaan. Penelepon dapat mencoba kembali permintaan. Jenis Media: application/json, application/xml, text/xml, text/json

Konten terkait