エージェントのフリートを効果的に管理するには、エンドポイントのネットワークを正確に維持する必要があります。このドキュメントでは、使用可能なエンドポイントを検出する方法、接続の詳細を更新する方法、使用しなくなったエンドポイントを削除する方法について説明します。
始める前に
エンドポイントを管理する前に、 Agent Registry にエンドポイントを登録します。 これらのタスクを実行するには、 プロジェクト ID も必要です。
このドキュメントの gcloud CLI コマンドを使用するには、Google Cloud CLI 環境を 設定していることを確認してください。
必要なロール
Agent Registry でエンドポイントを管理するために必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。
-
エンドポイントの検出:
Agent Registry API 閲覧者 （
roles/agentregistry.viewer） -
エンドポイントの更新と削除:
Agent Registry API 編集者 （
roles/agentregistry.editor）
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
必要な権限は、カスタム ロールや他の事前定義 ロールから取得することもできます。
エンドポイントを検出する
環境に登録されているターゲット URL と REST API を参照するには、使用可能なエンドポイント リソースを一覧表示します。
すべてのエンドポイントを一覧表示する
環境に登録されているすべてのエンドポイントを一覧表示します。
コンソール
gcloud
特定のロケーションにあるすべてのエンドポイントを一覧表示するには、endpoints list コマンドを使用します。
gcloud alpha agent-registry endpoints list \
--project=PROJECT_ID \
--location=REGION
次のように置き換えます。
PROJECT_ID: プロジェクト ID。REGION: レジストリ リージョン。
登録済みエンドポイントをフィルタする
複数のエンドポイントがある場合は、エンドポイントのメタデータでリストをフィルタできます。
コンソール
コンソールで [Agent Registry] に移動します。 Google Cloud
プロジェクト選択ツールから、Agent Registry を設定した Google Cloud プロジェクトを 選択します。
[エンドポイント] タブを選択します。
このページには、登録されているすべてのエンドポイントとその詳細（名前、説明、ロケーションなど）のリストが表示されます。
ロケーションでフィルタするには、[ロケーション] メニューをクリックし、フィルタするロケーションを選択して [適用] をクリックします。
このページには、選択した条件に一致する登録済みエンドポイントのフィルタされたリストが表示されます。
gcloud
--filter フラグを使用して、特定のメタデータに一致するリソースのみを返すようにリストをフィルタします。
gcloud alpha agent-registry endpoints list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
FILTER_EXPRESSION は、フィルタするエンドポイントのフィルタ式に置き換えます。たとえば、表示
名でフィルタするには、displayName='DISPLAY_NAME' を使用します。
エンドポイントの詳細を表示する
特定のエンドポイントの詳細（接続の詳細やプロトコル バインディングなど）を表示します。
コンソール
コンソールで [Agent Registry] に移動します。 Google Cloud
プロジェクト選択ツールから、Agent Registry を設定した Google Cloud プロジェクトを 選択します。
[エンドポイント] タブを選択します。
このページには、登録されているすべてのエンドポイントとその詳細（名前、説明、ロケーションなど）のリストが表示されます。
表示するエンドポイントの名前をクリックします。
[概要] ページには、エンドポイントの名前、説明、ロケーション、接続の詳細（リンク先 URL やプロトコル バインディングなど）が表示されます。
gcloud
特定のエンドポイントの詳細なメタデータ（完全なインターフェース URL やプロトコル バインディングなど）を取得します。
gcloud alpha agent-registry endpoints describe ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION
次のように置き換えます。
PROJECT_ID: プロジェクト ID。REGION: レジストリ リージョン。ENDPOINT_NAME: エンドポイントの名前（my-external-apiなど）。
エンドポイントを更新する
外部ターゲット エンドポイントの基盤となる URL が変更された場合は、エンドポイント インターフェースの詳細を更新できます。
エンドポイントを更新する手順は次のとおりです。
コンソール
コンソールで [Agent Registry] に移動します。 Google Cloud
プロジェクト選択ツールから、Agent Registry を設定した Google Cloud プロジェクトを 選択します。
[エンドポイント] タブを選択します。
このページには、登録されているすべてのエンドポイントとその詳細（名前、説明、ロケーションなど）のリストが表示されます。
更新するエンドポイントの名前をクリックします。
[概要] ページには、エンドポイントの名前、説明、ロケーション、接続の詳細（リンク先 URL やプロトコル バインディングなど）が表示されます。
[ Edit] をクリックします。
[サービスの編集] パネルで、エンドポイントの更新された情報（表示名、説明、リンク先 URL など）を入力します。このパネルからエンドポイントへの接続をテストできます。
[保存] をクリックします。
gcloud
Agent Registry API では、検出に Endpoint リソースが使用されます。そのため、登録されている Service リソースを直接更新する必要があります。
--interfaces フラグを使用して、新しいターゲット URL を指定します。
gcloud alpha agent-registry services update ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION \
--interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL
次のように置き換えます。
ENDPOINT_NAME: エンドポイントの名前（my-external-apiなど）。PROJECT_ID: プロジェクト ID。REGION: レジストリ リージョン。ENDPOINT_URL: 新しいターゲット URL（https://new-api.example.com/v1/dataなど）。PROTOCOL: インターフェースのプロトコル バインディング。 有効な値はHTTP_JSON、GRPC、JSONRPCです。
エンドポイントを削除する
レジストリからエンドポイントを削除するには、基盤となる Service リソースを削除する必要があります。この操作を行うと、検出検索結果からエンドポイントがすぐに削除されます。
レジストリからエンドポイントを削除する手順は次のとおりです。
コンソール
コンソールで [Agent Registry] に移動します。 Google Cloud
プロジェクト選択ツールから、Agent Registry を設定した Google Cloud プロジェクトを 選択します。
[エンドポイント] タブを選択します。
このページには、登録されているすべてのエンドポイントとその詳細（名前、説明、ロケーションなど）のリストが表示されます。
削除するエンドポイントの名前をクリックします。
[概要] ページには、エンドポイントの名前、説明、ロケーション、接続の詳細（リンク先 URL やプロトコル バインディングなど）が表示されます。
[ [Delete]] をクリックします。
[エンドポイントの削除] ウィンドウで、「 DELETE 」と入力して操作を確定します。
[削除] をクリックします。
gcloud
gcloud alpha agent-registry services delete ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION