手順 3 - V3 REST API またはクライアント SDK に移行するための設定

---

重要

V2 API の廃止は Azure Media Services の廃止と一致するため、Azure Media Service v2 から v3 に移行する必要はなくなりました。 詳細については、 Azure Media Services の提供終了ガイド を参照してください。

ここでは、Media Services V3 API を使用するように環境を設定する手順について説明します。

SDK モデル

V2 API では、2 つの異なるクライアント SDK がありました。1 つは管理 API 用で、アカウントをプログラムで作成することができ、もう 1 つはリソース管理用でした。

以前は、開発者は Azure サービス プリンシパルのクライアント ID とクライアント シークレットを、AMS アカウントの特定の V2 REST API エンドポイントと共に使用していました。

V3 API は、Azure Resource Management (ARM) に基づいています。 これは、Azure Active Directory (Azure AD) のサービス プリンシパル ID とキーを使用して API に接続します。 開発者は、API に接続するために、サービス プリンシパルまたはマネージド ID を作成する必要があります。 V3 API では、API は標準の ARM エンドポイントを使用し、他のすべての Azure サービスと同様の一貫性のあるモデルを使用します。

これまで 2015-10-01 バージョンの ARM 管理 API で V2 アカウントを管理していたお客様は、V3 API アクセスをサポートしている 2020-05-01 以降のバージョンの ARM 管理 API を使用する必要があります。

テスト用の新しいメディア サービス アカウントを作成する

ポータルでテナントとサブスクリプションの ID を見つけて、Media Services アカウントを作成します。 次に、API アクセスとサービス プリンシパル認証を選択して、このテスト アカウントで使用する新しい Azure AD アプリケーション ID とシークレットを生成します。

メディア サービス アカウントを作成する。 Media Services API にアクセスするための資格情報を取得する。

任意のクライアント SDK をダウンロードして環境を設定する

• .NET、.NET Core、Node.js、Python、Java、Go で利用できる SDK。
• 単純なスクリプト サポートのための Azure CLI 統合。

Note

V3 の Azure Media Services では、コミュニティの PHP SDK を利用できなくなりました。 V2 で PHP を使用している場合は、コード内で直接 REST API に移行する必要があります。

Open API 仕様

• V3 は、Azure Resource Manager 上に構築された管理と操作の両方の機能を公開する統一された API サーフェスに基づいています。 Azure Resource Manager テンプレートを使って、変換、ストリーミング エンドポイント、ライブ イベントなどを作成してデプロイできます。

• OpenAPI 仕様 (旧称 Swagger) ドキュメントでは、すべてのサービス コンポーネントのスキーマについて説明しています。

• すべてのクライアント SDK は、GitHub で公開されている Open API 仕様から派生し、生成されます。 この記事の公開時点では、最新の Open API 仕様は GitHub で公開管理されています。 2020-05-01 バージョンは、最新の安定版リリースです。

REST

REST API リファレンス ページを参照してください。

2020-05-01 (またはそれ以降) のバージョンを使用する必要があります。

.NET

.NET を使用した Media Services v3 API への接続に関する記事を参照して、環境を設定します。

PackageManager を使用して最新の SDK をインストールするだけの場合は、次のコマンドを使用します。

Install-Package Microsoft.Azure.Management.Media

または、.NET CLI を使用して最新の SDK をインストールするには、次のコマンドを使用します。

dotnet add package Microsoft.Azure.Management.Media

また、さまざまなシナリオについての .NET のサンプル一式は、Azure-Samples/media-services-v3-dotnet で入手できます。 このリポジトリ内のプロジェクトでは、v3 バージョンを使用してさまざまな Azure Media Services シナリオを実装する方法が示されています。

コードの調整を開始する

V3 API へのアップグレード プロセスを開始するには、コード ベースで CloudMediaContext の使用例を見つけます。

次のコードは、v2 API が以前 v2 .NET SDK を使用してどのようにアクセスされていたかを示しています。 開発者はまず CloudMediaContext を作成し、AzureAdTokenCredentials オブジェクトを使用してインスタンスを作成します。

class Program
	{
	    // Read values from the App.config file.
        private static readonly string _AADTenantDomain =
            ConfigurationManager.AppSettings["AMSAADTenantDomain"];
        private static readonly string _RESTAPIEndpoint =
            ConfigurationManager.AppSettings["AMSRESTAPIEndpoint"];
        private static readonly string _AMSClientId =
            ConfigurationManager.AppSettings["AMSClientId"];
        private static readonly string _AMSClientSecret =
            ConfigurationManager.AppSettings["AMSClientSecret"];

	    private static CloudMediaContext _context = null;

	    static void Main(string[] args)
	    {
        try
        {
            AzureAdTokenCredentials tokenCredentials =
                new AzureAdTokenCredentials(_AADTenantDomain,
                    new AzureAdClientSymmetricKey(_AMSClientId, _AMSClientSecret),
                    AzureEnvironments.AzureCloudEnvironment);

            var tokenProvider = new AzureAdTokenProvider(tokenCredentials);

            _context = new CloudMediaContext(new Uri(_RESTAPIEndpoint), tokenProvider);

Python

Azure Media Services v3 API への接続 - Python に関する記事を参照して、環境を設定します。

Node.js

Azure Media Services v3 API への接続 - Node.js に関する記事を参照して、環境を設定します。

Go

Go SDK をダウンロードします。

ヘルプとサポート

質問がある場合は Media Services に問い合わせるか、次のいずれかの方法で更新内容に従ってください。

• Q & A
• Stack Overflow。 質問に タグを付けます azure-media-services。
• @MSFTAzureMedia するか 、@AzureSupport を使用してサポートを要求します。
• Azure portalからサポート チケットを開きます。