以控制面板供应商身份获取客户同意
作为控制面板供应商（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 |