Azure AI コンテナーに関するよくあるご質問

一般的な質問

何を利用できますか。

Azure AI コンテナーを使用すると、開発者は Azure で利用できるものと同じインテリジェントな API を使用できますが、それに加えてコンテナ化のベネフィットも得られます。 一部のコンテナーは制限プレビューとして提供され、利用するには申請が必要になる場合があります。 他のコンテナーは、ゲートなしプレビューとして公開されているか、一般提供されています。 コンテナーとその可用性の完全な一覧については、Azure AI サービスでのコンテナーのサポートに関する記事を参照してください。 Microsoft Container Registry (MCR) でコンテナーを表示することもできます。

Azure AI サービス クラウドとコンテナーには違いがありますか?

Azure AI コンテナーは Azure AI サービス クラウドの代替物です。 コンテナーからは、それに対応するクラウド サービスと同じ機能が提供されます。 お客様はオンプレミスまたは Azure でコンテナーをデプロイできます。 中心となる AI テクノロジ、価格レベル、API キー、API 署名は、コンテナーとそれに対応するクラウドサービスの間で同じです。 それに対応するクラウド サービスではなく、コンテナーを選択すると、次のような機能と利点が与えられます。

限定的なプレビュー コンテナーにアクセスして使用するにはどうすればよいですか?

これまで、限定的なプレビュー コンテナーは containerpreview.azurecr.io リポジトリでホストされていました。 2020 年 9 月 22 日現在、これらのコンテナーは Microsoft Container Registry でホストされています。 それらをダウンロードするために、docker login コマンドを使用する必要はありません。 承認済みの Azure サブスクリプション ID を使用して Azure リソースが作成されている場合は、限定的なプレビュー コンテナーを実行できます。 要求フォームへの入力が完了しても、Azure サブスクリプションが承認されていない場合は、コンテナーを実行することはできません。

コンテナーはすべての Azure AI サービス オファリングで利用できますか? また、次に期待できるコンテナー セットは何ですか?

Microsoft では、より多くの Azure AI サービス オファリングをコンテナーとして利用できるようにしたいと考えています。 新しいコンテナーのリリースに関する最新情報や Azure AI サービス関連のその他のお知らせについては、お住まいの地域の Microsoft アカウント マネージャーにお問い合わせください。

Azure AI コンテナーのサービス レベル アグリーメント (SLA) は何ですか?

重要

Azure AI サービスのサービスレベル アグリーメントの詳細については、Microsoft の SLA のページを参照してください。

Azure AI には、クラウドでホストされるサービスに関する SLA が用意されており、SLA のページで確認することができます。

ただし、コンテナー内の Azure AI サービスはオンプレミス ソフトウェアであるため、SLA は提供されません。 Azure AI サービス コンテナーのリソース構成はお客様が管理します。そのため、Microsoft では一般提供 (GA) のための SLA を提供することはできません。 お客様がオンプレミスでコンテナーを自由にデプロイし、ホスト環境を定義します。

これらのコンテナーはソブリン クラウドで利用できますか。

標準の Azure AI コンテナーは、ソブリン クラウドで使用できます。 コンテナーは認可されると、これらのクラウド内で実行でき、課金エンドポイントに接続できますが、コンテナー イメージはパブリック クラウド コンテナー レジストリからプルする必要があります。 Translator やカスタム音声テキスト変換など、実行時にダウンロードされた言語モデルに依存するコンテナーも、パブリック エンドポイントからモデルをプルするように構成されます。

現在、ソブリン クラウドでは、切断されたコンテナーの購入はサポートされていません。 切断されたコンテナーとすべての依存関係をパブリック クラウドで購入し、ソブリン クラウドに転送して、ソブリン クラウド インフラストラクチャで実行することができます。

バージョン管理

コンテナーはどのような方法で最新バージョンに更新されますか。

お客様は、自分がデプロイしたコンテナーを更新するタイミングを選択できます。 最新のバージョンを示すために、コンテナーには latest のような標準 Docker タグのマークが付けられます。 最新バージョンのコンテナーがリリースされたら、それらをプルすることをお勧めします。 イメージが更新されたときに通知を受け取る方法について詳しくは、Azure Container Registry Webhook に関するページを参照してください。

コンテナー ライセンス ファイルは、各コンテナー イメージ内の特定のファイルを復号化するためのキーとして使用されます。 これらの暗号化されたファイルが新しいコンテナー イメージ内で誤って更新された場合、お使いのライセンス ファイルは、コンテナー イメージの以前のバージョンでは動作していた場合でも、コンテナーの起動に失敗する可能性があります。 この問題を回避するには、mcr.microsoft.com から新しいイメージ バージョンをプルした後、Azure portal で提供されるコンテナーのリソース エンドポイントから新しいライセンス ファイルをダウンロードすることをお勧めします。

新しいライセンス ファイルをダウンロードするには、ライセンス マウント、API キー、課金エンドポイントと共に docker run コマンドに DownloadLicense=True を追加します。 詳しい手順については、コンテナーのドキュメントをご覧ください。

どのバージョンがサポートされていますか?

通常、コンテナーの現在のバージョンのみがサポートされます。 お客様には、常に最新のパッチとテクノロジを入手することをお勧めしています。

更新プログラムはどのようにバージョン管理されますか?

メジャー バージョンの変更は、API 署名に破壊的変更があることを示します。 通常、この指示は、対応する Azure AI サービス クラウド オファリングのメジャー バージョン変更と一致すると予想されます。 マイナー バージョンの変更は、バグ修正、モデル更新、または API 署名に破壊的変更を加えない新機能を示します。

技術的なご質問

デプロイ環境で発生する可能性のあるエラーはどのようにして診断できますか?

Azure AI サービス コンテナーの実行で問題が発生している場合は、Microsoft 診断コンテナーを使用してみることができます。 このコンテナーを使用して、Azure AI コンテナーが想定どおりに機能しなくなる可能性がある、展開環境での一般的なエラーを診断します。

コンテナーを取得するには、次の docker pull コマンドを使用します。

docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic

その後で、コンテナーを実行します。 {ENDPOINT_URI} をエンドポイントに置き換え、{API_KEY} をリソースへのキーに置き換えます。

docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

コンテナーは、課金エンドポイントへのネットワーク接続をテストします。

Azure AI コンテナーを IoT デバイスで実行するにはどうすればいいですか?

信頼性の高いインターネット接続が利用できない場合、帯域幅コストを節約したい場合、低遅延の要件がある場合、オンサイトで分析する必要がある機密データを扱っている場合のいずれであっても、Azure IoT Edge と Azure AI コンテナーを使用することでクラウドとの一貫性を確保できます。

これらのコンテナーは OpenShift と互換性がありますか?

OpenShift ではコンテナーをテストしませんが、通常、Azure AI コンテナーは Docker イメージをサポートする任意のプラットフォームで実行する必要があります。 OpenShift を使用している場合は、root-user としてコンテナーを実行することをお勧めします。

製品フィードバックや機能推奨はどのような方法で提供しますか?

お客様には公の場で懸念を表明することと、同じ問題を投稿した他のユーザーに賛成票を投じることをお勧めしています。 フィードバック ツールは、製品フィードバックと機能推奨の両方にご利用いただけます。

Azure AI コンテナーから返されるステータス メッセージとエラーとは?

ステータス メッセージとエラーを次に示します。

Status 説明
Valid API キーは有効です。 対処は必要ありません。
Invalid API キーが無効です。 コンテナーを実行するには、有効な API キーを指定する必要があります。 Azure portal の Azure AI サービス リソースの [Keys and Endpoint](キーとエンドポイント) セクションで、API キーとサービス リージョンを確認してください。
Mismatch 別の種類の Azure AI サービス リソースの API キーまたはエンドポイントが指定されました。 Azure portal の Azure AI サービス リソースの [Keys and Endpoint](キーとエンドポイント) セクションで、API キーとサービス リージョンを確認してください。
CouldNotConnect コンテナーは課金エンドポイントに接続できませんでした。 Retry-After 値を確認し、この期間が終了するまで待ってから、追加の要求を行ってください。
OutOfQuota API キーがクォータを超えました。 価格レベルをアップグレードすることも、追加のクォータが使用可能になるまで待つこともできます。 Azure portal の Azure AI サービス リソースの [価格レベル] セクションで、お使いのレベルを見つけます。
BillingEndpointBusy 課金エンドポイントが現在ビジー状態です。 Retry-After 値を確認し、この期間が終了するまで待ってから、追加の要求を行ってください。
ContainerUseUnauthorized 指定された API キーは、このコンテナーでの使用が承認されていません。 限定的なコンテナーを使用している可能性があるため、オンライン リクエストを送信して、Azure サブスクリプション ID が承認されていることを確認してください。
[ERROR] Failed to download: context deadline exceeded サーバーへのモデル ファイルのダウンロード要求がタイムアウトしました。必要なすべてのファイルを 1 時間以内にダウンロードできる強力なインターネット接続があることを確認してください。 モデルのダウンロードは、テキスト翻訳と一部の音声サービス コンテナーに適用されます。
The provided license path was not found. Please ensure a volume is mounted and a directory exists at the location specified by Mounts:License 切断されたコンテナーのみ。 docker run コマンドで指定された場所に、ローカルに保存されているライセンス ファイルがありません。 ライセンス ボリュームを誤ってマウントしている可能性があります。 docker run コマンドで -v 引数を使用して、ローカル ファイル システムをチェックし、目的のライセンス ファイルのローカルの保存場所への有効なファイルパスを指定するようにしてください。
Unknown 現在、サーバーは課金要求を処理することができません。

サポートを利用するにはどうすればよいですか?

カスタマー サポート チャネルは、Azure AI サービスのクラウドベースの API の場合と同じです。 すべての Azure AI コンテナーには、Microsoft やコミュニティがお客様をサポートする際に役立つログ機能が含まれています。 その他のサポートのオプションを次に示します。

請求のしくみを教えてください。

Azure AI サービス クラウドと同様に、お客様には、使用量に基づいて料金が請求されます。 コンテナーは、Azure に測定データを送信するように構成する必要があります。構成後、トランザクションに対して適宜課金されます。 ホステッド サービスとオンプレミス サービスの間で使用されるリソースは、価格が階層化された単一クォータに追加されます。集計は両方の使用量に対して行われます。 詳細については、使用しているコンテナーの課金に関するセクションを参照してください。

重要

Azure AI コンテナーには、Azure に接続せずに計測を実行するための "ライセンスが与えられていません"。 お客様は、課金情報をコンテナーから測定サービスに常に送信できるようにする必要があります。 Azure AI コンテナーが顧客データを Microsoft に送信することはありません。

コンテナーが計測のために伝える情報の例を次に示します。

usageRequestBody": {
  "id": "1234abcd-1234-56ab-ab12-1234abcd",
  "containerType": "<container-type>",
  "containerVersion": "<container-version>",
  "containerId": "<contianer-id>",
  "meter": {
    "name": "<meter-name>",
    "quantity": 0.0
  },
  "requestTime": 12345687890,
  "apiType": "<api-type>"
},

コンテナーの現在のサポート保証はどのようになっていますか?

Microsoft のエンタープライズ ソフトウェアに対する標準保証は、一般提供 (GA) として正式に発表されたすべてのコンテナーに適用されます。 プレビューには保証はありません。

インターネット接続が失われると、Azure AI コンテナーはどうなりますか?

Azure AI コンテナーには、Azure に接続せずに計測を実行するための "ライセンスが与えられていません"。 お客様は、コンテナーと測定サービスが常に通信できるようにする必要があります。

Azure に接続されていない状態でどのくらいの時間、コンテナーを運用できますか?

Azure AI コンテナーには、Azure に接続せずに計測を実行するための "ライセンスが与えられていません"。 お客様は、コンテナーと測定サービスが常に通信できるようにする必要があります。

これらのコンテナーを実行するために必要なハードウェアは何ですか?

Azure AI コンテナーは、x64 Linux Docker コンテナーをサポートする互換性のある Linux ノード、VM、エッジ デバイスを実行できる x64 ベースのコンテナーです。 それらすべてで CPU プロセッサを必要とします。 詳細については、使用しているコンテナーのコンテナーの要件と推奨事項に関するセクションを参照してください。

これらのコンテナーは Windows で現在サポートされていますか?

Azure AI コンテナーは Linux コンテナーですが、Windows では Linux コンテナーがサポートされています。 Windows で Linux コンテナーを実行する方法については、Docker ドキュメントを参照してください。

Azure AI コンテナーは、AWS や Google のオファリングと比べてどうですか?

Microsoft は、事前にトレーニングした AI モデルをコンテナーに導入した最初のクラウド プロバイダーです。トランザクション単位の簡単な請求機能を採用し、まるで 1 つのクラウド サービスを利用しているような印象をお客様に与えます。 Microsoft は、ハイブリッド クラウドはお客様に与える選択肢を増やすものと考えています。

コンテナーにはどのようなコンプライアンス認定がありますか?

Azure AI コンテナーにはコンプライアンス認定がありません。

Azure AI コンテナーはどのリージョンで利用できますか?

コンテナーはあらゆるリージョンのあらゆる場所で実行できますが、キーを必要とし、また、測定のために Azure にコールバックする必要があります。 クラウド サービスでサポートされているリージョンはすべて、コンテナーの測定呼び出しでサポートされています。