Azure 媒体服务 V2 与 V3 API 之间的 API 访问差异API access differences between Azure Media Services V2 to v3 API

迁移指南徽标


迁移步骤 2

本文介绍 Azure 媒体服务 V2 与 V3 之间的 API 访问差异。This article describes the API access differences between Azure Media Services V2 to V3.

API 访问API Access

所有媒体服务帐户都将有权访问 V3 API。All Media Services accounts will have access to the V3 API. 但是,我们强烈建议在将更新的代码应用到现有 V2 帐户之前,在新帐户上进行迁移开发。However, we strongly recommend migration development on a fresh account before applying updated code to an existing V2 account. 这是因为 V3 实体不向后兼容 V2。This is because V3 entities aren't backwards compatible with V2. 某些 V2 实体(如资产)可以向前兼容 V3。Some V2 entities like Assets are forward compatible with V3. 如果不混合使用 V2 和 V3 API,然后尝试返回 V2,则可以继续使用现有帐户,但是不建议这样做。You can continue to use existing accounts if you don’t mix the V2 and V3 APIs and then try to go back to V2, but this is discouraged.

在 2024 年 V2 API 停用前都可以对其进行访问。Access to the V2 API will be available until it is retired in 2024.

迁移时,可以创建仍有权访问 V2 的 V3 帐户。While you are migrating, you can create a V3 account that still has access to V2. 可以通过以下方式创建帐户:Creating the account can be done with:

  • REST API 和更早版本The REST API and older version
  • 选择门户中的复选框。Selecting the checkbox in the portal.

所有 .NET、CLI 和其他 SDK 都将面向最新的 2020-05-01 API,因此请查找或配置较旧的 API 版本。All the .NET, CLI, and other SDKs will be targeting the latest 2020-05-01 API, so find or configure the older API versions.

备注

使用 2020-05-01 API 创建的新帐户不能使用 V2 API。New accounts created with the 2020-05-01 API cannot use V2 APIs.

后续步骤Next steps

步骤 1Step 1

了解迁移到媒体服务 API V3 的优势Understand the benefits of migrating to Media Services API V3.

步骤 2Step 2

了解媒体服务 V2 API 与 V3 API 之间的区别。Understand the differences between Media Services V2 API and the V3 API.

步骤 3Step 3

了解 SDK 区别,并进行设置以迁移到 V3 REST API 或客户端 SDKUnderstand the SDK differences and set up to migrate to the V3 REST API or client SDK.

步骤 4Step 4

你的媒体服务 V2 的应用程序可能是唯一的。Your application of Media Services V2 may be unique. 因此,我们基于你过去可能使用媒体服务的方式以及该服务每个功能的步骤提供了指导,例如:Therefore, we have provided guidance based on how you may have used media services in the past and the steps for each feature of the service such as: