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

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. gcloud CLI のインストールと初期化を行います。これにより、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 は、検索する場所です。プロジェクト内の任意のロケーションのすべてのインスタンスを検索するには、- を使用します。

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 は 1024³ バイトに相当します。
• name: Filestore ファイル共有の名前。ipAddresses 値で識別される IP アドレスを含むファイル共有名を使用して、ファイル共有をクライアントにマウントします。
• name: インスタンスの完全修飾名。
• ipAddresses: インスタンスの IP アドレス。Filestore ファイル共有をクライアントにマウントするには、この値をファイル共有名とともに使用します。
• network: インスタンスが使用する VPC ネットワークの名前。
• reservedIpRange: インスタンスを使用するために予約される IP アドレス ブロック。
• state: インスタンスの状態。
• tier: インスタンスの Filestore サービス階層。

例

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

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

REST API

1. gcloud CLI のインストールと初期化を行います。これにより、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