手順 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 つはプログラムによるアカウントの作成を許可し、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 アクセスでサポートされている ARM 管理 API の 2020-05-01 (またはそれ以降) バージョンを使用する必要があります。

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

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

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

選択したクライアント SDK をダウンロードし、環境を設定する

• .NET、.NET Core、Node.js、Python、Java、および Goで使用できる SDK。
• Azure CLI 統合を して、簡単なスクリプト作成をサポートします。

手記

コミュニティ PHP SDK は、V3 上の Azure Media Services では使用できなくなりました。 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 を使用して Media Services v3 API に接続して環境を設定する」を参照してください。

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

Install-Package Microsoft.Azure.Management.Media

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

dotnet add package Microsoft.Azure.Management.Media

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

コードの調整を開始する

コード ベースで CloudMediaContext 使用状況のインスタンスを検索して、V3 API へのアップグレード プロセスを開始します。

次のコードは、v2 .NET SDK を使用して v2 API に以前にアクセスした方法を示しています。 開発者は、まず 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 からサポート チケットを開きます。