ロケーション

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

AutoML Natural Language では、プロジェクトのリソース（データセットとモデル）が保存、処理される場所をある程度制御できます。たとえば、EU でのみ保存データを保存して、機械学習処理を実行するように AutoML Natural Language を構成できます。

デフォルトでは、AutoML Natural Language はリソースをグローバル ロケーションに保存して処理します。つまり、AutoML Natural Language は、リソースが特定のロケーションやリージョンに留まることを保証しません。EU ロケーションを選択すると、データの保存と機械学習の実行が EU 内で行われます。ユーザーはどこからでもデータにアクセスできます。

AutoML Natural Language UI におけるロケーションの設定

新しいデータセットを作成するときは、データセット名を入力するテキスト ボックスのすぐ下のプルダウン リストを使用してデータセットのロケーションを指定します。そのデータセットを使用してトレーニングされたモデルは、同じロケーションに作成されます。

データセットとモデルのリスティング ページには [ロケーション] プルダウン リストがあり、これを使用して、選択したロケーションのリソースを表示できます。

API を使用してロケーションを設定する

AutoML Natural Language は、グローバル API エンドポイント（automl.googleapis.com）と EU エンドポイント（eu-automl.googleapis.com）の両方をサポートします。EU 内に限定してデータの保存と処理を行うには、REST API 呼び出しで URI に automl.googleapis.com ではなく eu-automl.googleapis.com を使用します。

AutoML API を使用する場合は、ロケーションと一意の ID を含む完全なリソース名を使用してリソースを識別します。たとえば、データセットのリソース名の形式は、projects/{project-id}/locations/{location}/datasets/{dataset-id} となります。グローバル ロケーションに保存されているリソースの場合は、{location} 変数を値 us-central1 で置き換えます。EU ロケーションに保存されているリソースの場合は、{location} 変数を値 eu で置き換えます。

クライアント ライブラリを使用してロケーションを設定する

AutoML クライアント ライブラリは、デフォルトでグローバル API エンドポイント（automl.googleapis.com）にアクセスします。EU でのみデータを保存して処理するには、エンドポイントを明示的に設定する必要があります。下のコードサンプルで、この設定方法を示します。

Python

from google.cloud import automl_v1beta1 as automl

# You must first create a dataset, using the `eu` endpoint, before you can
# call other operations such as: list, get, import, delete, etc.
client_options = {'api_endpoint': 'eu-automl.googleapis.com:443'}

# Instantiates a client
client = automl.AutoMlClient(client_options=client_options)

# A resource that represents Google Cloud Platform location.
# project_id = 'YOUR_PROJECT_ID'
project_location = f"projects/{project_id}/locations/eu"

Java

AutoMlSettings settings =
    AutoMlSettings.newBuilder().setEndpoint("eu-automl.googleapis.com:443").build();

// Initialize client that will be used to send requests. This client only needs to be created
// once, and can be reused for multiple requests. After completing all of your requests, call
// the "close" method on the client to safely clean up any remaining background resources.
AutoMlClient client = AutoMlClient.create(settings);

// A resource that represents Google Cloud Platform location.
LocationName projectLocation = LocationName.of(projectId, "eu");

Node.js

const automl = require('@google-cloud/automl').v1beta1;

// You must first create a dataset, using the `eu` endpoint, before you can
// call other operations such as: list, get, import, delete, etc.
const clientOptions = {apiEndpoint: 'eu-automl.googleapis.com'};

// Instantiates a client
const client = new automl.AutoMlClient(clientOptions);

// A resource that represents Google Cloud Platform location.
const projectLocation = client.locationPath(projectId, 'eu');