共用方式為


以控制面板廠商身分取得客戶同意

身為控制面板廠商(CPV),您可以使用 REST API 取得和移除 CSP 客戶的同意,以取得其租用戶的許可權。

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

注意

每個 applicationId 的速率限製為每秒 50 個要求 (RPS) (CPV 合作夥伴的應用程式識別碼)。

URI 參數

名字 必填 類型 描述
客戶識別碼 路徑 字串 合作夥伴中心產生的客戶標識碼

要求標題

媒體類型:application/json

名字 必填 類型 描述
授權 字串 針對對象 https://api.partnercenter.microsoft.com 的存取令牌
接受 字串 可接受的內容類型;廣泛接受的類型應用程式/json
ms-correlationid 字串 用於內部追蹤請求。 如果未提供 ms-correlationid,伺服器會為每個請求產生一個新的識別碼
ms-requestid 字串 用於保證請求的等冪性,即保證重複執行相同請求會產生相同的結果。 如果未提供 ms-requestid,伺服器會為每個要求產生一個新的識別碼。

請求正文

媒體類型:application/json

名字 類型 描述
applicationId 字串 CPV 合作夥伴的應用程式識別碼
applicationGrants Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] 應用程式許可清單,以取得客戶在其租戶中的存取權

反應

名字 類型 描述
200 確定 要求成功。 媒體類型:application/jsonapplication/xmltext/xmltext/json
201 已建立 應用程式同意已建立。 媒體類型:application/jsonapplication/xmltext/xmltext/json
400 錯誤請求 輸入遺失或無效。 回應主體包含錯誤詳情。 媒體類型:application/jsonapplication/xmltext/xmltext/json
401 未經授權 要求未通過驗證。 客戶端需要為目標用戶傳遞有效的存取令牌。 媒體類型:application/jsonapplication/xmltext/xmltext/json
403 禁止存取 要求已通過驗證,但遭到拒絕,因為呼叫端沒有叫用它的許可權。 媒體類型:application/jsonapplication/xmltext/xmltext/json
404 找不到 找不到資源,或無法使用指定的輸入參數。 媒體類型:application/jsonapplication/xmltext/xmltext/json
500 內部伺服器錯誤 合作夥伴 API 服務或其其中一個相依性無法滿足要求。 呼叫者可以重試請求。 媒體類型:application/jsonapplication/xmltext/xmltext/json

定義

Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant

名字 類型 描述
企業應用程式ID 字串 獲得存取權的資源的 GUID 表示法
範圍 字串 取得存取權之範圍的逗號分隔值
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}

注意

每個 applicationId 的速率限製為每秒 50 個要求 (RPS) (CPV 合作夥伴的應用程式識別碼)。

URI 參數

名字 必填 類型 描述
客戶識別碼 路徑 字串 合作夥伴中心產生的客戶標識碼
應用程式識別碼 路徑 字串 CPV 應用程式的識別碼

請求標頭

媒體類型:application/json

名字 必填 類型 描述
授權 字串 受眾 https://api.partnercenter.microsoft.com 的存取令牌
接受 字串 可接受的內容類型,通常輸入application/json
ms-correlationid 字串 用於內部追蹤請求。 如果未提供 ms-correlationid,伺服器會為每個要求產生新的要求
ms-requestid 字串 用於保證請求的等冪性,即保證重複執行相同請求會產生相同的結果。 如果未提供 ms-requestid,伺服器會為每個要求產生一個新的識別碼。

反應

名字 類型 描述
200 確定 要求成功。 媒體類型:application/jsonapplication/xmltext/xmltext/json
201 已建立 應用程式同意會遭到刪除。 媒體類型:application/jsonapplication/xmltext/xmltext/json
400 錯誤請求 輸入遺失或無效。 回應主體包含錯誤詳情。 媒體類型:application/jsonapplication/xmltext/xmltext/json
401 未經授權 要求未通過驗證。 客戶端必須針對有效的對象傳遞有效的存取令牌。 媒體類型:application/jsonapplication/xmltext/xmltext/json
403 禁止存取 要求已通過驗證,但遭到拒絕,因為呼叫端沒有叫用它的許可權。 媒體類型:application/jsonapplication/xmltext/xmltext/json
404 找不到 找不到資源,或無法使用指定的輸入參數。 媒體類型:application/jsonapplication/xmltext/xmltext/json
500 內部伺服器錯誤 合作夥伴 API 服務或其其中一個相依性無法滿足要求。 呼叫者可以重試請求。 媒體類型:application/jsonapplication/xmltext/xmltext/json