步骤 3 - 进行设置,以迁移到 V3 REST API 或客户端 SDK

migration guide logo


migration steps 2

下文描述了将环境设置为使用媒体服务 V3 API 需要执行的步骤。

SDK 模型

V2 API 中有两个不同的客户端 SDK,一个用于管理 API,可同构它以编程方式创建帐户,而另一个用于管理资源。

以前,除了 AMS 帐户的特定 V2 REST API 终结点,开发人员还会使用 Azure 服务主体客户端 ID 和客户端密码。

V3 API 基于 Azure 资源管理 (ARM)。 它使用 Azure Active Directory (Azure AD) 服务主体 ID 和密钥连接到 API。 开发人员将需要创建服务主体或托管标识才能连接到 API。 在 V3 API 中,API 会使用标准 ARM 终结点,对其他所有 Azure 服务使用相似且一致的模型。

以前使用 2015-10-01 版本的 ARM 管理 API 来管理其 V2 帐户的客户应使用 2020-05-01(或更新)版本的 ARM 管理 API,新版本支持 V3 API 访问。

创建新的媒体服务帐户进行测试

在门户中查找租户和订阅 ID,并创建媒体服务帐户。 然后,选择 API 访问和服务主体身份验证,来生成用于此测试帐户的新的 Azure AD 应用程序 ID 和机密。

创建媒体服务帐户获取用于访问媒体服务 API 的凭据

下载所选的客户端 SDK 并设置环境

注意

社区 PHP SDK 无法再用于 V3 上的 Azure 媒体服务。 如果正在 V2 中使用 PHP,应直接在代码中迁移到 REST API。

Open API 规范

  • V3 基于统一的 API 接口,该接口公开了在 Azure 资源管理器之上构建的管理和操作功能。 Azure 资源管理器模板可用于创建和部署转换、流式处理终结点、直播活动等等。

  • OpenAPI 规范(之前称为 Swagger)文档说明了所有服务组件的架构。

  • 所有客户端 SDK 都是从 GitHub 上发布的 Open API 规范派生和生成的。 在本文发布时,最新的 Open API 规范在 GitHub 中公开进行维护。 2020-05-01 版本是最新的稳定版本

请阅读 REST API 参考页面

应使用 2020-05-01(或更高版本)版本。