Translator リソースを作成する

この記事では、Azure portal で Translator リソースを作成する方法について説明します。 Azure Translator は、クラウドベースの機械翻訳サービスであり、REST API の Azure Cognitive Services ファミリに含まれます。 Azure リソースは、作成するサービスのインスタンスです。 Azure サービスに対するすべての API 要求には、アクセスを認証するために、エンドポイント URL と読み取り専用の サブスクリプション キー が必要です。

前提条件

開始するには、アクティブな Azure アカウントが必要です。 お持ちでない場合は、無料の 12 か月のサブスクリプションを作成できます。

Translator リソースの種類

Translator サービスには、2 つの異なるリソースの種類を使用してアクセスできます。

  • 単一サービス リソースの種類を使用すると、1 つのサービス API キーとエンドポイントにアクセスできます。

  • マルチサービス リソースの種類を使用すると、1 つの API キーとエンドポイントを使用して複数の Cognitive Services にアクセスできます。 現在、Cognitive Services リソースは次のサービスで使用できます。

リソースを作成する

ヒント

必要に応じて、Azure portal のホーム ページから、次のように 作成 プロセスを開始できます。

  1. Azure portal のホーム ページに移動します。
  2. Azure サービス メニューから ➕ [リソースの作成] を選択します。
  3. [Marketplace を検索] 検索ボックスに、「Translator」(単一サービス リソース) または「Cognitive Services」(マルチサービス リソース) と入力し、選択します。 上記の リソースの種類の選択に関する記述を "参照" してください。
  4. [作成] を選択すると、プロジェクトの詳細ページが表示されます。

プロジェクトとインスタンスの詳細を入力する

  1. [サブスクリプション]。 使用できる Azure サブスクリプションのいずれかを選択します。

  2. [リソース グループ]。 選択した Azure リソース グループは、新しいリソースの仮想コンテナーとして機能します。 新しいリソース グループを作成するか、同じライフサイクル、アクセス許可、ポリシーを共有する既存のリソース グループにリソースを追加することができます。

  3. [リソース リージョン] . ご自身のビジネスまたはアプリケーションが特定のリージョンを必要としない限り、 [グローバル] を選択します。 Translator は、非リージョン サービスです。特定の Azure リージョンンに依存することはありません。 「Azure のリージョンと Availability Zones」を "参照" してください。

  4. [名前]。 自分のリソースに対して選択した名前を入力します。 選択した名前は Azure 内で一意である必要があります。

注意

カスタム ドメイン エンドポイントを必要とする Translator 機能を使用する場合は、[名前] フィールドに入力する値が、エンドポイントのカスタム ドメイン名パラメーターになります。

  1. 価格レベル。 自分のニーズに合った価格レベルを選択します。

    • 各サブスクリプションに Free レベルがあります。
    • Free レベルは有料プランと同じ機能を備えており、有効期限がありません。
    • アカウントごとに 1 つだけ無料サブスクリプションが許可されます。
  2. マルチサービス リソースを作成した場合は、チェック ボックスを使用して追加の使用状況の詳細を確認する必要があります。

  3. [確認および作成] を選択します。

  4. サービス条件を確認し、 [作成] を選択してリソースをデプロイします。

  5. リソースが正常にデプロイされた後、 [リソースに移動] を選択します。

認証キーとエンドポイント URL

すべての Cognitive Services API 要求には、認証のためにエンドポイント URL と読み取り専用キーが必要です。

  • 認証キー。 自分のキーは、Translation サービスへの要求ごとに渡される一意の文字列です。 自分のキーは、クエリ文字列パラメーターを使用するか、HTTP 要求ヘッダーで指定して渡すことができます。

  • エンドポイント URL。 特定の Azure リージョンが必要な場合を除き、API 要求ではグローバル エンドポイントを使用します。 「ベース URL」を "参照" してください。 グローバル エンドポイント URL は api.cognitive.microsofttranslator.com です。

認証キーとエンドポイントを取得する

  1. 新しいリソースがデプロイされた後、 [リソースに移動] を選択するか、自分のリソース ページに直接移動します。
  2. 左側のレールの [リソース管理] で、 [キーとエンドポイント] を選択します。
  3. 自分のサブスクリプション キーとエンドポイント URL をコピーして、Microsoft Notepad などのアクセスしやすい場所に貼り付けます。

キーとエンドポイントを取得します。

リソースまたはリソース グループを削除する方法

警告

リソース グループを削除すると、そのグループに含まれるすべてのリソースも削除されます。

Cognitive Services または Translator リソースを削除するには、リソースを削除 するか、リソース グループを削除 します。

リソースを削除するには:

  1. Azure portal で、リソース グループに移動します。
  2. 隣接するチェック ボックスをオンにして、削除するリソースを選択します。
  3. 右端近くの上部メニューから [削除] を選択します。
  4. [Deleted Resources](削除対象のリソース) ダイアログ ボックスに "はい" と入力します。
  5. [削除] を選択します。

リソース グループを削除するには:

  1. Azure portal で、リソース グループに移動します。
  2. 左端近くの上部メニュー バーから、 [リソース グループの削除] を選択します。
  3. リソース グループ名を入力し、 [削除] を選択して、削除要求を確定します。

Translator の使用を開始する方法

このクイックスタートでは、REST API で Translator サービスを使用する方法について説明します。

その他のリソース