マシンを管理する

このページでは、Distributed Cloud 接続ゾーンで Google Distributed Cloud マシンリソースを管理する方法について説明します。

Distributed Cloud コネクテッド マシンの詳細については、Distributed Cloud コネクテッドの仕組みをご覧ください。

ゾーン内のマシンを一覧表示する

Distributed Cloud 接続ゾーンで Distributed Cloud 接続マシンを一覧表示するには、このセクションの手順を完了します。

このタスクを完了するには、 Google Cloud プロジェクトに対する Edge コンテナ閲覧者ロールroles/edgecontainer.viewer)が必要です。

コンソール

  1. Google Cloud コンソールで、[エッジゾーン] ページに移動します。

    [エッジゾーン] に移動

  2. 目的のゾーンをクリックします。

    Google Cloud コンソールには、選択したゾーンの詳細情報が表示されます。これには、そのゾーンに存在するマシンのリストが含まれます。

gcloud

gcloud edge-cloud container machines list コマンドを使用します。

gcloud edge-cloud container machines list \
    --project=PROJECT_ID \
    --location=REGION

次のように置き換えます。

  • PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
  • REGION: ターゲットの Distributed Cloud コネクテッド ゾーンが作成された Google Cloud リージョン。

API

projects.locations.machines.list メソッドに GET リクエストを送信します。

GET /v1/PROJECT_ID/locations/REGION?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

次のように置き換えます。

  • PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
  • REGION: ターゲットの Distributed Cloud コネクテッド ゾーンが作成された Google Cloud リージョン。
  • FILTER: 返される結果を特定の値に制限する式。
  • PAGE_SIZE: ページごとに返す結果の数
  • SORT_BY: 返される結果の並べ替えの基準とするフィールド名のカンマ区切りリストデフォルトの並べ替え順は昇順です。降順で並べ替えるには、目的のフィールドに ~ という接頭辞を付けます。
  • PAGE_TOKEN: レスポンスの nextPageToken フィールドで、最後のリスト リクエストのレスポンスで受け取ったトークン。このトークンを送信して、結果のページを受け取ります。

マシンに関する情報を取得する

Distributed Cloud コネクテッド ゾーン内の Distributed Cloud コネクテッド マシンの情報を取得するには、このセクションの手順を完了します。

このタスクを完了するには、 Google Cloud プロジェクトに対する Edge コンテナ閲覧者ロールroles/edgecontainer.viewer)が必要です。

コンソール

  1. Google Cloud コンソールで、[エッジゾーン] ページに移動します。

    [エッジゾーン] に移動

  2. 目的のゾーンをクリックします。

    Google Cloud コンソールには、選択したゾーンの詳細情報が表示されます。これには、そのゾーンに存在するマシンのリストが含まれます。

  3. マシンのリストで、目的のマシンをクリックします。

    Google Cloud コンソールに、選択したマシンの詳細情報が表示されます。

gcloud

gcloud edge-cloud container machines describe コマンドを使用します。

gcloud edge-cloud container machines describe MACHINE_ID \
    --location=REGION \
    --project=PROJECT_ID

次のように置き換えます。

  • MACHINE_ID: ターゲット マシンリソースの ID。
  • REGION: ターゲットの Distributed Cloud ゾーンが作成された Google Cloud リージョン。
  • PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。

API

projects.locations.machines.get メソッドに GET リクエストを送信します。

GET /v1/PROJECT_ID/locations/REGION/machines/MACHINE_NAME

次のように置き換えます。

  • PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
  • REGION: ターゲットの Distributed Cloud 接続ゾーンが作成された Google Cloud リージョン。
  • MACHINE_NAME: ターゲット マシンリソースの名前。

次のステップ