インスタンス情報を取得する

このページでは、Filestore インスタンスについての情報を取得する方法を示します。

始める前に

このページのコマンドラインの例を使用する場合は、gcloud CLI をインストールして gcloud コマンドライン ツールを有効にします。

プロジェクト内のすべてのインスタンスを表示する

Google Cloud コンソール

Filestore インスタンスに関する情報を取得し、プロジェクト内のすべてのインスタンスを表示するには、Filestore インスタンス ページにアクセスします。

Filestore インスタンス ページに移動

gcloud

Filestore インスタンスに関する情報を取得し、プロジェクト内のすべてのインスタンスを表示するには、instances list コマンドを実行します。

  gcloud filestore instances list --project=project-id --zone=zone

ここで

  • project-id は、Filestore インスタンスを含む Google Cloud プロジェクトのプロジェクト ID です。Filestore インスタンスが gcloud デフォルト プロジェクトにある場合は、このフラグを省略できます。デフォルトのプロジェクトを設定するには、次のコマンドを実行します。

      gcloud config set project project-id
    
  • zone は、Filestore インスタンスを一覧表示するゾーンです。 このフラグを省略すると、すべてのゾーンのインスタンスが返されます。 サポートされているゾーンのリストを取得するには、gcloud filestore zones list コマンドを実行します。

instances list コマンドに対するレスポンスは次のようになります。

INSTANCE_NAME  ZONE            TIER       CAPACITY_GB  FILE_SHARE_NAME  IP_ADDRESS  STATE   CREATE_TIME
nfs-loc        europe-west1-b  BASIC_HDD  1024         nfs1             10.0.5.2    READY   2017-10-09T22:11:28
nfs3           us-central1-c   BASIC_HDD  1024         acme             10.0.6.2    READY   2017-11-06T09:37:18

次のコマンドでは、プロジェクト myproject 内の Filestore インスタンスを一覧表示します。

  gcloud filestore instances list --project=myproject

REST API

  1. Authorization ヘッダーのアクセス トークンを生成するには、gcloud CLI のインストールと初期化を行います。

    OAuth 2.0 Playground を使用してアクセス トークンを作成し、Authorization ヘッダーに含めることもできます。

  2. cURL を使用して Filestore API を呼び出します。

    curl -s \
      --header "Authorization: Bearer $(gcloud auth print-access-token)" \
      --header "Content-Type: application/json" \
      GET "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances"

    ここで

    • PROJECT は、インスタンスが配置されているプロジェクトの名前です。例: my-genomics-project
    • LOCATION は、検索する場所です。プロジェクト内の任意のロケーションにあるすべてのインスタンスを検索するには、- を使用します。

特定のインスタンスに関する情報を取得する

特定の Filestore インスタンスに関する情報を取得するには、次のいずれかの手順を使用します。

Google Cloud コンソール

  1. Filestore インスタンス ページに移動

    Filestore インスタンス ページに移動

  2. インスタンス ID をクリックして、インスタンスの詳細ページを開きます。

gcloud

instances describe コマンドを実行して、Filestore インスタンスに関する情報を取得します。

    gcloud filestore instances describe instance-id --project=project-id --location=location

instances describe コマンドに対するレスポンスは次のようになります。

createTime: '2021-10-11T17:28:23.340943077Z'
fileShares:
- capacityGb: '1024'
 name: vol1
kmsKeyName: projects/example-project/locations/us-central1/keyRings/example-ring/cryptoKeys/example-key
labels:
 key:val
name: projects/yourproject/locations/us-central1-c/instances/nfs-server
networks:
- ipAddresses:
 - 10.0.0.2
 network: default
 reservedIpRange: 10.0.0.0/26
state: READY
tier: ENTERPRISE

これらのフィールドは、次の値を表します。

  • createTime: インスタンスが作成された時間(RFC3339 形式)。
  • fileShares:
  • capacityGb: バイナリ ギガバイト(GB)を単位とする Filestore ファイル共有のサイズ。1 GB は 10243 バイトに相当します。
  • name: Filestore ファイル共有の名前。ipAddresses 値で識別される IP アドレスを含むファイル共有名を使用して、ファイル共有をクライアントにマウントします。
  • name: インスタンスの完全修飾名。
  • ipAddresses: インスタンスの IP アドレス。Filestore ファイル共有をクライアントにマウントするには、この値をファイル共有名とともに使用します。
  • network: インスタンスが使用する VPC ネットワークの名前。
  • reservedIpRange: インスタンスを使用するために予約される IP アドレス ブロック。
  • state: インスタンスの状態。
  • tier: インスタンスの Filestore サービス階層。

次のコマンドを実行すると、ゾーン us-central1-c にあるプロジェクト myprojecttest-nfs インスタンスに関する情報を得られます。

gcloud filestore instances describe test-nfs --project=myproject --zone=us-central1-c

REST API

  1. Authorization ヘッダーのアクセス トークンを生成するには、gcloud CLI のインストールと初期化を行います。

    OAuth 2.0 Playground を使用してアクセス トークンを作成し、Authorization ヘッダーに含めることもできます。

  2. cURL を使用して Filestore API を呼び出します。

    curl -s \
      --header "Authorization: Bearer $(gcloud auth print-access-token)" \
      --header "Content-Type: application/json" \
      GET "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/INSTANCE_NAME"

    ここで

    • PROJECT は、インスタンスが配置されているプロジェクトの名前です。例: my-genomics-project
    • LOCATION は、インスタンスが存在するロケーションです。例: us-west1-a
    • INSTANCE_NAME は、表示するインスタンスの名前です。例: my-genomics-instance

Filestore インスタンスのマウントについての情報を取得する

以降のセクションでは、さまざまな種類のインスタンスのマウント情報を取得する方法について説明します。

インスタンスのマウント ポイントを一覧表示する

次を実行すると、Filestore インスタンスがマウントされているすべてのマウント ポイントを一覧表示できます。

    sudo showmount -a INSTANCE_IP

次のコマンドは、IP アドレスが 10.77.67.226 である Filestore インスタンスのすべてのマウント ポイントを一覧表示します。

    sudo showmount -a 10.77.67.226

応答は次のようになります。

All mount points on 10.77.67.226:
10.128.0.1:/fileshare
10.128.0.2:/fileshare
10.128.0.3:/fileshare

インスタンスのマウント ポイント数の取得

次を実行して、Filestore インスタンスのマウント ポイントの合計数を取得できます。

    sudo showmount -a INSTANCE_IP --no-headers | wc -l

次のコマンドは、IP アドレスが 10.77.67.226 のインスタンスのマウント ポイントの数を表示します。

    sudo showmount -a 10.77.67.226 --no-headers | wc -l

次のステップ