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