以主控台廠商的身分取得客戶同意
身為主控台廠商 (CPV) ，您可以使用 REST API 來取得和移除 CSP 客戶的同意，以取得其租使用者的許可權。
POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents
取得同意
URI 參數
| 名稱 |
位於 |
必要 |
類型 |
描述 |
| customer_id |
path |
True |
字串 |
合作夥伴中心產生的客戶識別碼 |
媒體類型： application/json
| 名稱 |
必要 |
類型 |
描述 |
| 授權 |
True |
字串 |
物件存取權杖 https://api.partnercenter.microsoft.com |
| 接受 |
True |
字串 |
可接受的內容類型;廣泛接受的類型 application/json |
| ms-correlationid |
|
string |
用於在內部追蹤要求。 如果未提供 ms-correlationid，伺服器將會為每個要求產生新的識別碼 |
| ms-requestid |
|
string |
用於要求的等冪性。 如果未提供 ms-requestid，伺服器將會為每個要求產生新的要求 |
要求本文
媒體類型： application/json
| 名稱 |
類型 |
描述 |
| applicationId |
string |
CPV 合作夥伴的應用程式識別碼 |
| applicationGrants |
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] |
應用程式授與清單，以取得客戶在其租使用者中的存取權 |
回應
| 名稱 |
類型 |
描述 |
| 200 確定 |
|
要求成功。 媒體類型：「application/json」、「application/xml」、「text/xml」、「text/json」 |
| 201 Created |
|
系統會建立應用程式同意。 媒體類型：「application/json」、「application/xml」、「text/xml」、「text/json」 |
| 400 不正確的要求 |
|
輸入遺失或無效。 回應本文包含錯誤詳細資料。 媒體類型：「application/json」、「application/xml」、「text/xml」、「text/json」 |
| 401 未經授權 |
|
要求未經驗證。 用戶端必須為有效的物件傳遞有效的存取權杖。 媒體類型：「application/json」、「application/xml」、「text/xml」、「text/json」 |
| 403 禁止 |
|
要求已經過驗證，但因為呼叫端沒有叫用要求的許可權而遭到拒絕。 媒體類型：「application/json」、「application/xml」、「text/xml」、「text/json」 |
| 404 找不到 |
|
找不到資源，或無法使用指定的輸入參數。 媒體類型：「application/json」、「application/xml」、「text/xml」、「text/json」 |
| 500 內部伺服器錯誤 |
|
合作夥伴 API 服務或其其中一個相依性無法滿足要求。 呼叫端可以重試要求。 媒體類型：「application/json」、「application/xml」、「text/xml」、「text/json」 |
定義
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant
| 名稱 |
類型 |
描述 |
| enterpriseApplicationId |
string |
取得存取權之資源的 GUID 標記法 |
| scope |
字串 |
用於取得存取權之範圍的逗號分隔值 |
移除同意
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}
URI 參數
| 名稱 |
位於 |
必要 |
類型 |
描述 |
| customer_id |
path |
True |
字串 |
合作夥伴中心產生的客戶識別碼 |
| Application_id |
path |
True |
字串 |
CPV 應用程式的識別碼 |
媒體類型： application/json
| 名稱 |
必要 |
類型 |
描述 |
| 授權 |
True |
字串 |
物件存取權杖 https://api.partnercenter.microsoft.com |
| 接受 |
True |
字串 |
可接受的內容類型，通常輸入 application/json |
| ms-correlationid |
|
string |
用於在內部追蹤要求。 ms-correlationid如果未提供 ，伺服器會為每個要求產生新的要求 |
| ms-requestid |
|
string |
用於要求的等冪性。 如果未提供 ms-requestid，伺服器就會為每個要求產生新的要求 |
回應
| 名稱 |
類型 |
描述 |
| 200 確定 |
|
要求成功。 媒體類型：「application/json」、「application/xml」、「text/xml」、「text/json」 |
| 201 Created |
|
刪除應用程式同意。 媒體類型：「application/json」、「application/xml」、「text/xml」、「text/json」 |
| 400 不正確的要求 |
|
輸入遺失或無效。 回應本文包含錯誤詳細資料。 媒體類型：「application/json」、「application/xml」、「text/xml」、「text/json」 |
| 401 未經授權 |
|
要求未通過驗證。 用戶端必須為有效的物件傳遞有效的存取權杖。 媒體類型：「application/json」、「application/xml」、「text/xml」、「text/json」 |
| 403 禁止 |
|
要求已經過驗證，但因為呼叫端沒有叫用它的許可權而遭到拒絕。 媒體類型：「application/json」、「application/xml」、「text/xml」、「text/json」 |
| 404 找不到 |
|
找不到資源，或無法使用指定的輸入參數。 媒體類型：「application/json」、「application/xml」、「text/xml」、「text/json」 |
| 500 內部伺服器錯誤 |
|
合作夥伴 API 服務或其其中一個相依性無法滿足要求。 呼叫端可以重試要求。 媒體類型：「application/json」、「application/xml」、「text/xml」、「text/json」 |
下一步