通过

以控制面板供应商身份获取客户同意

  • 项目

作为控制面板供应商（CPV），可以使用 REST API 获取和删除 CSP 客户的同意，以便获取其租户的权限。

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

注意

速率限制是每个 applicationId（CPV 合作伙伴的应用程序 ID）每秒 50 个请求（RPS）。

URI 参数

名称 在 必需 类型​​ 描述
customer_id path 正确 string 在合作伙伴中心生成的客户的 ID

请求头文件

媒体类型： application/json

名称 必需 类型​​ 说明
授权 True string 访问群体的访问令牌 https://api.partnercenter.microsoft.com
Accept True string 可接受的内容类型;广泛接受的类型应用程序/json
ms-correlationid string 用于在内部跟踪请求。 如果未提供 ms-correlationid，则服务器会为每个请求生成一个新请求
ms-requestid string 用于请求的幂等性。 如果未提供 ms-requestid，则服务器会为每个请求生成一个新请求

请求正文

媒体类型： application/json

名称 Type 说明
applicationId string CPV 合作伙伴的应用程序 ID
applicationGrants Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] 应用程序授予列表，以获取客户在其租户中的访问权限

响应

名称 Type 说明
200 OK 请求成功。 媒体类型：application/json、、application/xml、 text/xmltext/json
201 已创建 创建应用程序同意。 媒体类型：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

名称 Type 描述
enterpriseApplicationId string 获取访问权限的资源的 GUID 表示形式
scope string 用于获取访问权限的范围的逗号分隔值 
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}

注意

速率限制是每个 applicationId（CPV 合作伙伴的应用程序 ID）每秒 50 个请求（RPS）。

URI 参数

名称 在 必需 类型​​ 描述
customer_id path 正确 string 在合作伙伴中心生成的客户的 ID
Application_id path 正确 string CPV 应用程序的 ID

请求头文件

媒体类型： application/json

名称 必需 类型​​ 说明
授权 True string 访问群体的访问令牌 https://api.partnercenter.microsoft.com
Accept True string 可接受的内容类型，通常键入 application/json
ms-correlationid string 用于在内部跟踪请求。 如果未提供 a ms-correlationid ，服务器会为每个请求生成一个新请求
ms-requestid string 用于请求的幂等性。 如果未提供 ms-requestid，则服务器会为每个请求生成一个新请求

响应

名称 Type 说明
200 OK 请求成功。 媒体类型：application/json、、application/xml、 text/xmltext/json
201 已创建 删除应用程序同意。 媒体类型：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

相关内容