Media Services v3 API に接続する - Python

  • [アーティクル]

Media Services ロゴ v3

警告

Azure Media Services は、2024 年 6 月 30 日に廃止されます。 詳細については、 AMS 廃止ガイドを参照してください。

この記事では、サービス プリンシパルによるサインイン方式を使用して Azure Media Services v3 Python SDK に接続する方法を説明します。

前提条件

  • python.org から Python をダウンロードします
  • PATH 環境変数を必ず設定します
  • Media Services アカウントを作成する リソース グループ名と Media Services アカウント名を覚えておいてください。
  • 「API にアクセスする」トピックの手順に従って、サービス プリンシパルの認証方法を選択します。 後の手順で必要になるので、サブスクリプション ID、アプリケーション クライアント ID、認証キー、およびテナント ID を控えておいてください。

重要

命名規則を確認してください。

モジュールをインストールする

Python を使用して Azure Media Services を操作するには、以下のモジュールをインストールする必要があります。

  • azure-identity モジュール。これには、Active Directory 用の Azure モジュールが含まれています。

  • azure-mgmt-media モジュール。これには、Media Services エンティティが含まれています。

    Media Services SDK for Python の最新バージョンを取得していることを確認してください。

コマンド ライン ツールを開き、以下のコマンドを使用してモジュールをインストールします。

pip3 install azure-identity
pip3 install azure-mgmt-media

Python クライアントに接続する

  1. .py という拡張子でファイルを作成します

  2. 使い慣れたエディターでファイルを開きます

  3. 次のコードをファイルに追加します。 このコードによって、必要なモジュールがインポートされ、Media Services への接続に必要な Active Directory 資格情報オブジェクトが作成されます。

    変数の値を、API へのアクセスに関するページで取得した値に設定します。 ACCOUNT_NAME および RESOURCE_GROUP_NAME 変数を、Media Services アカウント名とリソース グループ名 (それらのリソースを作成するときに使用されたもの) に更新します。

    from azure.identity import ClientSecretCredential
from azure.mgmt.media import AzureMediaServices

# Tenant ID for your Azure Subscription
TENANT_ID = "(update-this-value)"

# Your Application Client ID of your Service Principal
CLIENT_ID = "(update-this-value)"

# Your Service Principal secret key
CLIENT_SECRET = "(update-this-value)"

# Your Azure Subscription ID
SUBSCRIPTION_ID = "(update-this-value)"

# Your Resource Group name
RESOURCE_GROUP_NAME = "(update-this-value)"

# Your Azure Media Service account name
ACCOUNT_NAME = "(update-this-value)"

credentials = ClientSecretCredential(TENANT_ID, CLIENT_ID, CLIENT_SECRET)

# The Azure Media Services Client
client = AzureMediaServices(credentials, SUBSCRIPTION_ID)

# Now that you are authenticated, you can manipulate the entities.
# For example, list assets in your Media Services account
assets = client.assets.list(RESOURCE_GROUP_NAME, ACCOUNT_NAME)

for i, r in enumerate(assets):
    print(r)

  4. ファイルを実行します

その他のサンプル

その他のサンプルは GitHub の Azure Media Services v3 Python サンプル リポジトリに用意されています。

ヘルプとサポート

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