在合作伙伴中心使用“合作伙伴中心提交 API”加入 Azure 应用

  • 项目

使用“合作伙伴中心提交 API”能够以编程方式查询、发布 Azure 产品/服务并为其创建提交内容。 如果你的帐户需要管理多个产品/服务，而你想要自动化和优化这些产品/服务的提交过程，那么此 API 非常有用。

API 先决条件

需要准备好几个编程资产才能对 Azure 产品使用合作伙伴中心 API：

  • Microsoft Entra 应用程序。
  • Microsoft Entra 访问令牌。

步骤 1：完成使用合作伙伴中心提交 API 的先决条件

在开始编写代码以调用合作伙伴中心提交 API 之前，请确保已完成以下先决条件。

  • （或组织）必须具有 Microsoft Entra 目录，并且必须具有 目录的全局管理员 权限。 如果已在 Microsoft 中使用 Microsoft 365 或其他业务服务，则已有 Microsoft Entra 目录。 否则，可以在 合作伙伴中心 创建新的 Microsoft Entra ID，无需额外付费。

  • 必须将 Microsoft Entra 应用程序与合作伙伴中心帐户 相关联，并获取租户 ID、客户端 ID 和密钥。 需要这些值才能获取 Microsoft Entra 访问令牌，该令牌将在调用 Microsoft Store 提交 API 时使用。

如何将 Microsoft Entra 应用程序与合作伙伴中心帐户相关联

若要使用 Microsoft Store 提交 API，必须将 Microsoft Entra 应用程序与合作伙伴中心帐户相关联，检索应用程序的租户 ID 和客户端 ID，并生成密钥。 Microsoft Entra 应用程序表示要从中调用合作伙伴中心提交 API 的应用或服务。 需要租户 ID、客户端 ID 和密钥才能获取传递给 API 的 Microsoft Entra 访问令牌。

注意

此任务只需执行一次。 拥有租户 ID、客户端 ID 和密钥后，可以随时重复使用它们，以创建新的 Microsoft Entra 访问令牌。

  1. 在合作伙伴中心， 将组织的合作伙伴中心帐户与组织的 Microsoft Entra 目录相关联。
  2. 接下来，从合作伙伴中心的“帐户设置”部分的“用户”页面，添加表示将用于访问合作伙伴中心帐户提交的应用或服务的 Microsoft Entra 应用程序。 确保为此应用程序分配“管理者”角色。 如果 Microsoft Entra 目录中尚不存在该应用程序，可以在 合作伙伴中心创建新的 Microsoft Entra 应用程序。
  3. 返回到 “用户 ”页，单击 Microsoft Entra 应用程序的名称转到应用程序设置，并复制 租户 ID 和 客户端 ID 值。
  4. 单击“添加新密钥”。 在下一个屏幕上，复制“密钥”值。 离开此页后，不再可以访问此信息。 有关详细信息，请参阅 管理 Microsoft Entra 应用程序的密钥。

步骤 2：获取 Microsoft Entra 访问令牌

在合作伙伴中心提交 API 中调用任何方法之前，必须先获取传递到 API 中每个方法的 授权 标头的 Microsoft Entra 访问令牌。 获取访问令牌后，在它到期前，你有 60 分钟的使用时间。 令牌过期后，可以刷新该令牌，以便可以在将来的 API 调用中继续使用它。

若要获取访问令牌，请按照使用客户端凭据进行服务到服务的调用中的说明，将 HTTP POST 发送到 https://login.microsoftonline.com/<tenant_id>/oauth2/token 终结点。 下面是一个示例请求：

JSONCopy

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8

grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource= https://api.partner.microsoft.com

对于 POST URI 中的 tenant_id 值以及 client_id 和 client_secret 参数，请指定在上一部分从合作伙伴中心检索的应用程序的租户 ID、客户端 ID 和密钥。 对于 resource 参数，必须指定 https://api.partner.microsoft.com。

第 3 步：使用Microsoft Store 提交 API

获得 Microsoft Entra 访问令牌后，可以在合作伙伴中心提交 API 中调用方法。 若要创建或更新提交内容，通常需要按特定的顺序调用“合作伙伴中心提交 API”中的多个方法。 有关每个场景和每个方法的语法的信息，请参见 Ingestion API Swagger。

https://ingestionapi-swagger.azureedge.net/#/

后续步骤