Bare Metal Solution 環境のメンテナンス

Bare Metal Solution 環境が稼働したら、このガイドの情報を使用して、Bare Metal Solution サーバー、ストレージ、ネットワークのメンテナンスを行います。

Bare Metal Solution 環境で SAP HANA を実行している場合は、Bare Metal Solution の SAP HANA のプランニングガイドをご覧ください。

Google Cloud プロジェクトを設定して Bare Metal Solution API を使用する

Bare Metal Solution API には、Bare Metal Solution 環境のモニタリングとメンテナンスに使用できる多くのツールが用意されています。通常、この手順は、Bare Metal Solution API を初めて使用する場合にのみ必要です。ただし、API が期待どおりに応答しない場合に備えて、必要に応じてこの手順を再利用してください。

Bare Metal Solution 管理者または Bare Metal Solution 編集者の IAM 事前定義ロールをプリンシパルに割り当てます。IAM ロールをマッピングする方法については、IAM ロールを付与するをご覧ください。
Cloud プロジェクトで Bare Metal Solution API を有効にします。

注: API サービスを有効にするには、サービスを有効にする権限を付与する IAM ロール（オーナー、Service Usage 管理者など）が必要です。詳細については、アクセス制御をご覧ください。
コンソール
1. Google Cloud Console ダッシュボードで [Bare Metal Solution API] に移動します。また [API とサービス] > [ライブラリ] にアクセスして、API ライブラリの Bare Metal Solution API を検索することもできます。
2. [Bare Metal Solution API] ページで、[有効にする] をクリックします。
3. ブラウザの [戻る] ボタンをクリックします。[API が有効です] の横に緑色のチェックマークが表示されていれば、API を使用できます。
gcloud
- gcloud を使用して Bare Metal Solution API を有効にするには、次のコマンドに gcloud CLI プロジェクト ID を入力します。このコマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。
```
 gcloud services enable baremetalsolution.googleapis.com --project=PROJECT_ID
 
```
Google Cloud CLI が Cloud プロジェクトと連携できるようにします。
1. Cloud Shell ウィンドウで、gcloud auth login コマンドを入力します。
```
gcloud auth login
```
2. 表示された URL をコピーし、別のブラウザのタブまたはウィンドウに貼り付けます。
3. Cloud プロジェクトに関連付けられたユーザー名を使用して、ページにログインします。
4. [許可] をクリックして gcloud CLI を有効にします。
5. 認証コードをコピーします。
6. コードを Cloud Shell クライアントコマンドラインに貼り付けます。
7. Enter キーまたは Return キーを押します。

Google Cloud で API を設定するために必要な一般的な手順の詳細については、Google Cloud APIs スタートガイドをご覧ください。

Bare Metal Solution サーバーの操作

Bare Metal Solution サーバーで次の操作を実行できます。

起動 - サーバーの電源をオンにします。
停止 - サーバーの電源をオフにします。
リセット - サーバーを再起動します。

コンソール

サーバーでこれらの操作を行う手順は次のとおりです。

[Compute Engine] > [Bare Metal Solution] > [サーバー] ページに移動します。
起動、停止、またはリセットするサーバーでをクリックします。
手順は次のとおりです。
- サーバーの電源をオンにするには、[起動] をクリックします。
- サーバーの電源をオフにするには、[停止] をクリックします。
- サーバーを再起動するには、[リセット] をクリックします。

gcloud

Bare Metal Solution サーバーの電源を切って再起動するには、次の操作を行います。
1. API の設定手順が完了していることを確認します。
  
  サーバーを再起動するには、Bare Metal Solution API と gcloud CLI を有効にする必要があります。また、Bare Metal Solution 管理者または Bare Metal Solution 編集者の IAM ロールをプリンシパルに付与する必要があります。設定手順を完了するには、Google Cloud プロジェクトを設定して Bare Metal Solution API を使用するをご覧ください。
2. Bare Metal Solution サーバーの電源を切って再起動するには、gcloud bms instances reset コマンドを実行します。
  
  注: デフォルトでは、このコマンドは同期モードで実行されます。再起動オペレーションが完了するまで、他のコマンドは実行できません。自動環境を使用している場合や、再起動時に他のタスクを実行する必要がある場合は、--async オプションを追加して、このコマンドを非同期モードで実行してください。
```
gcloud bms instances reset SERVER_NAME --project=PROJECT_ID --region=REGION
```
  サーバーの再起動リクエストのステータスが出力に表示されます。
```
Reset request issued for: [SERVER_NAME]

Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.
```
  コマンドを入力すると、Bare Metal Solution サーバーが再起動します。サーバーの構成によっては、再起動が完了するまでに 15～60 分ほどかかります。
  
  このコマンド出力からオペレーション ID を調べて、再起動のステータスを確認します。オペレーション ID を使用して再起動のステータスを確認するには、長時間実行オペレーションのステータスの表示をご覧ください。
サーバーの電源をオンにするには、gcloud bms instances start コマンドを使用します。

注: デフォルトでは、このコマンドは同期モードで実行されます。起動オペレーションが完了するまで、他のコマンドは実行できません。自動環境を使用している場合や、起動時に他のタスクを実行する必要がある場合は、--async オプションを追加して、このコマンドを非同期モードで実行してください。
```
gcloud bms instances start SERVER_NAME --project=PROJECT_ID --region=REGION
```
サーバーの再起動リクエストのステータスが出力に表示されます。
```
Start request issued for: [SERVER_NAME]

Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.
```
ほとんどの場合、サーバーの電源はオンのままです。電源をオフにする必要がある場合は、次のオプションを使用します。
- サーバーのオペレーティングシステムのシャットダウンコマンドを使用します。
- 一部のアプリケーションでは、再イメージ後にサーバーの電源が自動的にオフになります。
サーバーの電源をオフにするには、gcloud bms instances stop コマンドを使用します。
```
gcloud bms instances stop --project=PROJECT_ID --region=REGION SERVER_NAME
```

API

Bare Metal Solution サーバーの電源を切って再起動するには、次の操作を行います。
1. API の設定手順が完了していることを確認します。
  
  サーバーを再起動するには、Bare Metal Solution API と gcloud CLI を有効にする必要があります。また、Bare Metal Solution 管理者または Bare Metal Solution 編集者の IAM ロールを付与する必要があります。設定手順を完了するには、Google Cloud プロジェクトを設定して Bare Metal Solution API を使用するをご覧ください。
2. Bare Metal Solution サーバーにログインしてサーバーの再起動を監視します。
  - Google Cloud コンソールウィンドウを開きます。
  - [Compute Engine] > [VM インスタンス] の順に選択して、踏み台ホスト VM インスタンスに移動します。
  - [SSH] ボタンをクリックして、踏み台ホスト VM インスタンスに接続します。
  - Bare Metal Solution サーバーにログインするには、踏み台ホストのコマンドラインで SSH コマンドを入力します。
```
[username@instance-jump-host ~]$ ssh customeradmin@bms-ip-address>
customeradmin@bms-ip-address's password: bms-password
Last login: Mon Mar 15 22:43:19 2022 from bms-ip-address
[customeradmin@BMS_SERVER_NAME ~]$
```
  - top コマンドを入力して、サーバーが稼働していることを確認します。このウィンドウで再起動の進行状況をモニタリングできます。
3. 再起動コマンドを実行します。
  - Cloud Shell ウィンドウを開きます。
  - 次のコマンドに、Cloud プロジェクト ID、リージョン、Bare Metal Solution サーバー名を追加します。
```
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/BMS_SERVER_NAME:reset"
```
    注: このコマンドの V2 バージョンは、V1 バージョンに代わるものです。このコマンドの V2 バージョンを使用することをおすすめします。
  - コマンドをコピーして Cloud Shell ウィンドウに貼り付け、Enter キーまたは Return キーを押します。
    
    Bare Metal Solution サーバーが再起動します。サーバーの構成によっては、再起動が完了するまでに 15～60 分ほどかかります。
    
    このコマンド出力からオペレーション ID を調べて、再起動のステータスを確認します。オペレーション ID を使用してステータスを表示するには、長時間実行オペレーションのステータスの表示をご覧ください。
```
{
 "name": "operations/5c0c8b3f-5edc-4117-be9f-812af9740aaf"
}
```
    サーバーの再起動中は、ping または SSH を使用して踏み台ホスト VM インスタンスから Bare Metal Solution サーバーにアクセスすることはできません。数分後、Bare Metal Solution サーバーはオンラインに戻ります。
    
    サーバーがオンラインに戻ったら、ping を正常に発行できます。また、SSH を使用して踏み台ホスト VM インスタンスから Bare Metal Solution サーバーにアクセスできます。
    
    注: 再起動が完了するまでに 15～60 分ほどかかります。サーバーの準備ができる前に再起動コマンドを再発行しようとすると、エラーメッセージが表示されます。サーバーがオンラインになってから、コマンドを再度実行してください。
Bare Metal Solution サーバーの再起動の詳細については、Bare Metal Solution API をご覧ください。
サーバーの電源をオンにするには、プロジェクト ID、リージョン、サーバー名を入力し、次の curl コマンドを実行します。
```
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME:start"
```
ほとんどの場合、サーバーの電源はオンのままです。電源をオフにする必要がある場合は、次のオプションを使用します。
- サーバーのオペレーティングシステムのシャットダウンコマンドを使用します。
- 一部のアプリケーションでは、再イメージ後にサーバーの電源が自動的にオフになります。

サーバーの電源をオフにするには、プロジェクト ID、リージョン、サーバー名を入力し、次の curl コマンドを実行します。

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME:stop"

サーバーの起動、停止、再起動が完了するまでに時間がかかるため、長時間実行オペレーションのステータスを表示するの手順でステータスを確認できます。

サーバーのステータスを確認する

サーバーはライフサイクルを通じて多くの状態に遷移します。サーバーを起動すると、Bare Metal Solution はサーバーのリソースをプロビジョニングします。次に、サーバーが起動シーケンスの準備をします。サーバーが起動すると、サーバーは実行状態になります。通常のオペレーションでは、実行中のサーバーを停止して再起動できます。

サーバーは次のいずれかの状態になります。

プロビジョニング : サーバーにリソースが割り当てられます。サーバーはまだ実行されていません。
開始中 : リソースが取得されました。サーバーを起動しています。
実行中 : サーバーは稼働しています。
停止中 : サーバーは停止しています。
シャットダウン : サーバーが停止し、電源がオフになります。
削除済み : サーバーは削除されています。

コンソール

[Compute Engine] > [Bare Metal Solution] > [サーバー] ページに移動します。
[ステータス] 列で、サーバーのステータスを確認できます。

gcloud

サーバーのステータスを確認するには、gcloud bms instances describe コマンドを実行します。

gcloud bms instances describe --project=PROJECT_ID --region=REGION SERVER_NAME

サーバーのステータスは、出力の state フィールドで確認できます。次に例を示します。

state: RUNNING

API

サーバーのステータスを確認するには、次の curl コマンドにプロジェクト ID、リージョン、サーバー名を入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME"

サーバーのステータスは、出力の state フィールドで確認できます。次に例を示します。

"state" : "RUNNING"

Bare Metal Solution 環境のリソースを管理する

サーバー、ネットワーキング、ストレージなどの Bare Metal Solution 環境内のリソースのステータスを表示するには、Bare Metal Solution 管理 API、gcloud コマンド、Google Cloud Console を使用します。

Bare Metal Solution API の設定を確認する

リソースのステータスを表示するには、Bare Metal Solution API と gcloud CLI を有効にする必要があります。また、Bare Metal Solution 管理者や Bare Metal Solution 編集者などの Bare Metal Solution の IAM ロールをプリンシパルに付与する必要があります。リソースを管理する前に API の設定手順を完了するには、Bare Metal Solution API を使用するように Google Cloud プロジェクトを設定するをご覧ください。

サーバーを管理する

Bare Metal Solution 環境のサーバーは、次の方法で管理できます。

Bare Metal Solution 環境のサーバーを表示する

Bare Metal Solution 管理 API を呼び出すコマンドを発行すると、Bare Metal Solution 環境内のデバイスのステータスを確認できます。現在のステータスを表示するには、次のいずれかのオプションを選択します。

コンソール

Bare Metal Solution サーバーのステータスと、関連するコンポーネントとストレージコンポーネントを確認するには、Google Cloud コンソールを使用します。

[Compute Engine] > [Bare Metal Solution] > [サーバー] の順に移動します。

利用可能な情報を表示します。

フィールド	説明	例
ステータス	サーバーの可用性を示します。	チェックマークが付いた緑の円は、サーバーがプロビジョニングされて使用可能であることを示しています。
ID	サーバーに割り当てられた ID。 ID をクリックすると、サーバーに関する基本情報が表示されます。このリソースのトラブルシューティングを行う場合は、ID を Google Cloud サポートと共有してください。	`at-1234567-svr001`
名前	サーバー名。名前をクリックすると、サーバーに関する追加情報が表示されます。注: サーバーのプロビジョニング時に名前を入力しなかった場合は、このフィールドに ID が表示されます。	`server-1`
ロケーション	Bare Metal Solution のリージョン	`asia-southeast1`
サーバーの種類	サーバーの仕様	`o2-standard-32-metal`
クライアント IP	Google Virtual Private Cloud に接続するサーバー IP アドレス	`10.200.0.5`
プライベート IP	他の Bare Metal Solution 環境リソースに接続するサーバー IP アドレス	`192.168.2.5`
ラベル	このサーバーに追加したラベルが表示されます。ラベルのテキストをコピーし、[ステータス] フィールドのすぐ上にある [フィルタ] ボックスに貼り付けることで、コンソールの出力をフィルタリングできます。	`environment:test`

サーバー、そのネットワーク機能、ストレージ機能に関する追加情報を表示するには、サーバーの名前をクリックします。
- [基本情報] では、サーバーがハイパースレッドをサポートしているかどうかを確認できます。
- [ネットワーキング] では、ネットワークインターフェース名、インターフェースタイプ（クライアントまたはプライベート）、IP アドレス、MAC アドレスを確認できます。
- [ストレージ] では、状態、名前、ボリューム、サイズ、タイプなど、論理ユニット番号（LUN）の情報を確認できます。また、LUN が共有可能で起動可能かどうかも確認できます。

gcloud

Bare Metal Solution 環境内のサーバーを一覧表示してステータスを確認するには、プロジェクト ID を入力して gcloud bms instances list コマンドを発行します。
```
gcloud bms instances list --project=PROJECT_ID
```
次の出力例は、サーバー情報（サーバー名、種類、IP アドレス、状態など）を示しています。
```
NAME               PROJECT              REGION           MACHINE_TYPE          IP_ADDRESSES             STATE
SERVER_NAME      PROJECT_ID        REGION         o2-standard-32-metal  192.168.1.1,192.168.2.1  RUNNING
```
その他のコマンドオプション:
- --region: 特定の Google Cloud リージョン内のデバイスを表示します。
- --limit: 特定のデバイス数のみを表示するように出力を制限します。

Bare Metal Solution 環境内の特定のサーバーのネットワークとストレージの情報を取得するには、サーバー名、プロジェクト ID、リージョンを入力して、gcloud bms instances describe コマンドを実行します。

gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION

次の出力例は、12 個の LUN、192.168.1.1 のクライアントネットワーク、192.168.2.1 のプライベートネットワークを持つ運用サーバーを示しています。

luns:
- bootLun: true
  name: SERVER_NAME-lun000-b1
  sizeGb: '200'
  state: READY
  storageVolume: SERVER_NAME-vol000-b1
- name: STORAGE_DEVICE_NAME-lun001
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun002
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun003
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun004
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun005
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun006
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun007
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun008
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun009
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun010
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun011
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun012
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
machineType: o2-standard-32-metal
name: projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME
networks:
- ipAddress: 192.168.1.1
  macAddress:
  - 34:80:0D:52:AF:28
  - 34:80:0D:15:3E:0D
  network: STORAGE_DEVICE_NAME-vlan001
- ipAddress: 192.168.2.1
  macAddress:
  - 34:80:0D:52:AF:38
  - 34:80:0D:15:3E:1D
  network: STORAGE_DEVICE_NAME-vlan002
state: RUNNING

API

Google Cloud Console で Cloud Shell ターミナルウィンドウを開きます。
Bare Metal Solution 環境のサーバーを一覧表示してステータスを確認するには、次の curl コマンドにプロジェクト ID とリージョンを入力します。このコマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。
```
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances"
```

Bare Metal Solution 環境のサーバーのネットワークとストレージの情報を取得するには、次のコマンドを実行します。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME"

ラベルを使用してサーバーを整理する

サーバーを整理するために、ラベルを使用できます。ラベルは Key-Value ペアで、各サーバーに設定し、ラベルに基づいてサーバーをフィルタリングできます。たとえば、ラベルを使用して、サーバーを目的、環境、場所、部門などでグループ化できます。ラベルはオプションです。

サーバーのラベルを追加または更新する

既存のサーバーのラベルを追加または更新できます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [サーバー] ページに移動します。
ラベルを付けるサーバーで、[] をクリックします。
[ラベルを編集] をクリックします。
[ラベルエディタ] ページで次の操作を行います。
1. [ラベルを追加] をクリックして、Key-Value ペアを追加します。
2. ラベルを更新するには、既存のラベルを選択して値を変更します。
3. [送信] をクリックします。
[サーバー] ページに戻り、ページを更新して変更を表示します。

gcloud

サーバーのラベルを追加または更新するには、gcloud bms instances update コマンドを使用して、--update-labels オプションを指定します。

次のサンプルコマンドでは、environment = dev ラベルと location = branch ラベルを追加します。

gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

既存のラベルに新しい値を指定すると、既存のラベルが新しいラベル値で更新されます。新しいラベルを指定すると、新しいラベルがラベルのリストに追加されます。

API

サーバーのラベルを追加または更新するには、次の curl コマンドでプロジェクト ID、リージョン、サーバー名、ラベルのリストを入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

次のサンプルコマンドでは、environment = test というラベルを割り当てます。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

サーバーからラベルを削除する

サーバーからラベルを削除できます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [サーバー] ページに移動します。
削除するラベルを持つサーバーのをクリックします。
[ラベルを編集] をクリックします。
[ラベルエディタ] ページで次の操作を行います。
1. ラベルを削除するには、をクリックします。
2. [送信] をクリックします。
[サーバー] ページに戻り、ページを更新して変更を表示します。

gcloud

サーバーからラベルを削除するには、次のオプションを指定して gcloud bms instances update コマンドを使用します。

--remove-labels: 指定したラベルを削除します。
--clear-labels: すべてのラベルを削除します。

次のサンプルコマンドは、ラベル department をサーバーから削除します。

gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

次のサンプルコマンドは、サーバーからすべてのラベルを削除します。

gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

サーバーからラベルを削除するには、次の curl コマンドにプロジェクト ID、リージョン、サーバー名を入力します。すべてのラベルを削除するには、ラベルの空のリストを指定します。あるいは、削除しないラベルのリストを指定します（削除するラベルは指定しない）。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

次のサンプルコマンドは、environment = test 以外のすべてのラベルを削除します。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

ラベルを使用してサーバーをフィルタリングする

ラベルを使用してサーバーを検索し、結果をフィルタリングできます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [サーバー] ページに移動します。
サーバーのリストの上にある [フィルタ] バーをクリックします。
[プロパティ] リストから [ラベル] を選択します。
ラベルのキー、値、または Key-Value ペアを入力します。

たとえば、env:dev というラベルのサーバーのみを表示するには、次のように入力します。
- キー env を入力します。
- 値 dev を入力します。
- Key-Value ペア env:dev を入力します。
ラベルフィルタを適用するには、フィルタバーの外側をクリックします。

gcloud

ラベルを使用してサーバーをフィルタリングするには、--filter オプションを指定して gcloud bms instances list コマンドを使用します。

--filter オプションの値は、labels.KEY=VALUE 形式にする必要があります。たとえば、キーが env、値が dev のラベルでフィルタリングする場合は、次のコマンドを実行します。

gcloud bms instances list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

gcloud CLI のフィルタ構文の詳細については、gcloud topic filters のドキュメントをご覧ください。

API

ラベルを使用してサーバーをフィルタリングするには、プロジェクト ID、リージョン、filter=labels、Key-Value ペアのラベルを入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

次のサンプルコマンドは、Key-Value ペアのラベルが environment = test であるサーバーを探すため出力を制限しています。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances"?filter=labels.environment=test

サーバーの初期パスワードを取得する

Bare Metal Solution サーバーを初めて受領するか、オペレーティングシステムを変更すると、サーバーはデフォルトの状態で開始し、初期パスワードが設定されます。このパスワードは、初めてサーバーにアクセスするときに使用する必要があります。初期パスワードを入力すると、パスワードを変更するように求められます。

初期パスワードを確認するには:

gcloud

パスワードを取得する前に、Google Cloud から提供されたサービスアカウントが有効になっていることを確認してください。
Bare Metal Solution リソースを含むプロジェクトで、Cloud Shell をアクティブにして gcloud bms instances describe コマンドを実行します。
```
gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION
```
出力で loginInfo フィールドを探し、手順に沿って操作します。
loginInfo フィールドに gcloud beta secrets versions access コマンドが含まれている場合は、コマンドをコピーしてコマンドラインプロンプトに貼り付け、Enter または Return キーを押します。
ユーザー名（通常は customeradmin）とパスワードを取得します。
これらの認証情報を使用してサーバーにログインします。
パスワードを変更します。

API

パスワードを取得する前に、Google Cloud から提供されたサービスアカウントが有効になっていることを確認してください。
Bare Metal Solution リソースを含むプロジェクトで、Cloud Shell にアクセスします。
次の curl コマンドにプロジェクト ID、リージョン、サーバー名を入力し、コマンドをコピーしてコマンドラインプロンプトに貼り付け、Enter キーまたは Return キーを押します。
```
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME"
```
出力で loginInfo フィールドを探し、手順に沿って操作します。
loginInfo フィールドに gcloud beta secrets versions access コマンドが含まれている場合は、コマンドをコピーしてコマンドラインプロンプトに貼り付け、Enter または Return キーを押します。
ユーザー名（通常は customeradmin）とパスワードを取得します。
これらの認証情報を使用してサーバーにログインします。
パスワードを変更します。

サーバーのオペレーティングシステムを変更する

別の OS イメージで Bare Metal Solution サーバーを再イメージ化できます。OS イメージの変更は完了するまでに時間がかかります。また、サーバーの電源をオフにしてオンにする必要があります。使用可能な OS イメージのいずれかを選択するには、オペレーティングシステムをご覧ください。

コンソール

Bare Metal Solution サーバーは、Google Cloud コンソールからイメージを再適用できます。

[Compute Engine] > [Bare Metal Solution] > [サーバー] の順に移動します。
イメージを再適用するサーバーのメニューをクリックします。
[編集] をクリックします。
[サーバーの編集] ページで次の操作を行います。
- [サーバーの再イメージ] チェックボックスをオンにします。
- [OS イメージ] リストで、インストールする OS イメージを選択します。
- [保存] をクリックします。

gcloud

gcloud bms instances update コマンドを実行して、サーバーの OS イメージを変更します。

gcloud bms instances update SERVER_NAME --region REGION --os-image=OS_IMAGE

API

Bare Metal Solution サーバーの OS イメージを更新するには、プロジェクト ID、リージョン、サーバー名、OS イメージを入力してから、次の curl コマンドを発行します。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME?updateMask=os_image"
 -d "{
  'osImage' : 'OS_IMAGE'
}"

この変更が完了するまでにはしばらく時間がかかります。ステータスは、長時間実行オペレーションのステータスの表示の手順で確認できます。

サーバーでハイパースレッディングを有効にする

ハイパースレッディングは、Bare Metal Solution サーバーで有効または無効にできます。この操作は完了までに時間がかかります。サーバーの電源をオフにして再度オンにする必要があります。

コンソール

Google Cloud コンソールで Bare Metal Solution サーバーのハイパースレッディングを有効または無効にできます。

[Compute Engine] > [Bare Metal Solution] > [サーバー] の順に移動します。
ハイパースレッディングを有効または無効にするサーバーのメニューをクリックします。
[編集] をクリックします。
[サーバーの編集] ページで次の操作を行います。
- ハイパースレッディングを有効にするには、[ハイパースレッディングを有効にする] チェックボックスをオンにします。
- ハイパースレッディングを無効にするには、[ハイパースレッディングを有効にする] チェックボックスをオフにします。
- [保存] をクリックします。

gcloud

gcloud bms instances update コマンドを実行して、ハイパースレッディングを有効または無効にします。

有効にするには、–enable-hyperthreading オプションを指定します。
無効にするには、–no-enable-hyperthreading オプションを指定します。

gcloud bms instances update SERVER_NAME --region REGION --enable-hyperthreading

API

サーバーの現在のハイパースレッディング機能を変更するには、プロジェクト ID、リージョン、サーバー名を指定して次の curl コマンドを実行します。ハイパースレッディングを有効にする場合は true を指定し、無効にする場合は false を追加します。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME?updateMask=hyperthreading_enabled"
 -d "{
  'hyperthreadingEnabled' : 'HYPERTHREADING_VALUE'
}"

この変更が完了するまでにはしばらく時間がかかります。ステータスは、長時間実行オペレーションのステータスの表示の手順で確認できます。

ネットワークを管理する

Bare Metal Solution 環境内のネットワークは、次の方法で管理できます。

Bare Metal Solution 環境のネットワークを表示する

Bare Metal Solution 環境でネットワークリソースをモニタリングすると、サーバーが他のリソースにどのように接続するかを確認できます。ネットワークのステータスを表示するには、次のいずれかのオプションを選択します。

コンソール

Google Cloud Console で、[Compute Engine] > [Bare Metal Solution] > [ネットワーク] の順に移動します。

利用可能な情報を表示します。

フィールド	説明	例
ステータス	ネットワークの可用性を示します。	チェックマークが付いた緑の円は、ネットワークがプロビジョニングされて使用可能であることを示しています。
ID	ネットワークに割り当てられている ID。 ID をクリックすると、ネットワークに関する基本情報が表示されます。このリソースのトラブルシューティングを行う場合は、ID を Google Cloud サポートと共有してください。	`at-1234567-vlan001`
名前	ネットワーク名。名前をクリックすると、ネットワークに関する追加情報が表示されます。注: ネットワークのプロビジョニング時に名前を入力しなかった場合は、このフィールドに ID が表示されます。	`network-1`
ロケーション	ネットワークが配置されているリージョン	`asia-southeast1`
タイプ	クライアントまたはプライベートネットワーク	`Client`
CIDR	ネットワークの IP アドレス範囲	`192.168.1.0/24`
VLAN ID	Google Cloud によって割り当てられた VLAN ID	`100`
ラベル	このネットワークリソースに追加したラベルが表示されます。ラベルのテキストをコピーし、[ステータス] フィールドのすぐ上にある [フィルタ] ボックスに貼り付けることで、コンソールの出力をフィルタリングできます。	`environment:test`

gcloud

Bare Metal Solution 環境内のすべてのネットワークを表示してステータスを確認するには、プロジェクト ID を入力して gcloud bms networks list コマンドを実行します。
```
gcloud bms networks list --project=PROJECT_ID
```
次の出力例は、各ネットワークのネットワーク名、リージョン、IP アドレス範囲、ネットワークタイプ、VLAN ID を示しています。
```
NAME                REGION           RANGE           TYPE     VLAN_ID
at-1111111-vlan001  REGION         192.168.1.0/24  CLIENT   122
at-1111111-vlan002  REGION         192.168.2.0/24  PRIVATE  123
```
1 つのネットワークの詳細を表示するには、プロジェクト ID、リージョン、ネットワーク名を入力して、gcloud bms networks describe コマンドを発行します。
```
gcloud bms networks describe NETWORK_NAME --project=PROJECT_ID --region=REGION
```
次の出力例は、IP アドレス範囲、ネットワーク名、状態、ネットワークタイプ、VLAN ID、仮想ルーティングと転送（VRF）の詳細を示しています。
```
cidr: 192.168.1.0/24
name: projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME
state: PROVISIONED
type: CLIENT
vlanId: '122'
vrf:
  autonomousSystemNumber: '65500'
  juniperAlias: g00000-at-1111111-ic001
  name: at-1111111-ic001
  routeTarget: '282'
  state: PROVISIONED
```

API

Google Cloud コンソールで Cloud Shell ターミナルウィンドウを開きます。
Bare Metal Solution 環境内のすべてのネットワークを表示してステータスを表示するには、次の curl コマンドにプロジェクト ID とリージョンを入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。
```
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks"
```

1 つのネットワークの詳細を表示するには、プロジェクト ID、リージョン、ネットワーク名を入力して、次のコマンドを実行します。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME"

ラベルを使用してネットワークを整理する

ネットワークを整理するには、ラベルを使用します。ラベルは Key-Value ペアで、各ネットワークに設定し、ラベルに基づいてネットワークをフィルタリングできます。たとえば、ラベルを使用して、ネットワークを目的、環境、場所、部門などでグループ化できます。ラベルはオプションです。

ネットワークのラベルを追加または更新する

既存のネットワークのラベルを追加または更新できます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [ネットワーク] ページに移動します。
ラベルを付けるネットワークのをクリックします。
[ラベルを編集] をクリックします。
[ラベルエディタ] ページで次の操作を行います。
1. [ラベルを追加] をクリックして、Key-Value ペアを追加します。
2. ラベルを更新するには、既存のラベルを選択して値を変更します。
3. [送信] をクリックします。
[ネットワーク] ページに戻り、ページを更新して変更を表示します。

gcloud

ネットワークのラベルを追加または更新するには、gcloud bms networks update コマンドを使用して、--update-labels オプションを指定します。

次のサンプルコマンドでは、environment = dev ラベルと location = branch ラベルを追加します。

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

既存のラベルに新しい値を指定すると、既存のラベルが新しい値で更新されます。新しいラベルを指定すると、新しいラベルがラベルのリストに追加されます。

API

ネットワークのラベルを追加または更新するには、次の curl コマンドでプロジェクト ID、リージョン、ネットワーク名、ラベルのリストを入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

次のサンプルコマンドでは、environment = test というラベルを割り当てます。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

ネットワークからラベルを削除する

ネットワークからラベルを削除できます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [ネットワーク] ページに移動します。
削除するラベルを持つネットワークに対して、をクリックします。
[ラベルを編集] をクリックします。
[ラベルエディタ] ページで次の操作を行います。
1. ラベルを削除するには、をクリックします。
2. [送信] をクリックします。
[ネットワーク] ページに戻り、ページを更新して変更を表示します。

gcloud

ネットワークからラベルを削除するには、gcloud bms networks update コマンドと次のオプションを使用します。

--remove-labels: 指定したラベルを削除します。
--clear-labels: すべてのラベルを削除します。

次のサンプルコマンドは、ネットワークからラベル department を削除します。

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

次のサンプルコマンドは、ネットワークからすべてのラベルを削除します。

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

ネットワークからラベルを削除するには、次の curl コマンドにプロジェクト ID、リージョン、ネットワーク名を入力します。すべてのラベルを削除するには、ラベルの空のリストを指定します。あるいは、削除しないラベルのリストを指定します（削除するラベルは指定しない）。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

次のサンプルコマンドは、environment = test 以外のすべてのラベルを削除します。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

ラベルを使用してネットワークをフィルタリングする

ラベルを使用してネットワークを検索し、結果をフィルタリングできます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [ネットワーク] ページに移動します。
ネットワークのリストの上にある [フィルタ] バーをクリックします。
[プロパティ] リストから [ラベル] を選択します。
ラベルのキー、値、または Key-Value ペアを入力します。

たとえば、env:dev というラベルのネットワークのみを表示するには、次のように入力します。
- キー env を入力します。
- 値 dev を入力します。
- Key-Value ペア env:dev を入力します。
ラベルフィルタを適用するには、フィルタバーの外側をクリックします。

gcloud

ラベルを使用してネットワークをフィルタリングするには、--filter オプションを指定して gcloud bms networks list コマンドを使用します。

gcloud bms networks list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

gcloud CLI のフィルタ構文の詳細については、gcloud topic filters のドキュメントをご覧ください。

API

ラベルを使用してネットワークをフィルタリングするには、プロジェクト ID とリージョン、filter=labels、Key-Value ペアのラベルを入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

次のサンプルコマンドは、Key-Value ペアのラベルが environment = test であるネットワークを探すため出力を制限しています。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks"?filter=labels.environment=test

ネットワークを追加してサーバーに接続する

Bare Metal Solution では、次の 2 つの方法でネットワークを追加できます。

新しいネットワークを作成してサーバーに接続する

新しいネットワークを作成して接続するには:

コンソール

[Compute Engine] > [Bare Metal Solution] > [サーバー] ページに移動します。
サーバー名をクリックします。
[サーバーの詳細] ページで、[ネットワークを接続] をクリックします。
[ネットワークを接続] ページで、[新しいネットワーク] を選択します。
[名前] フィールドに、新しいネットワークの名前を入力します。
ネットワークの種類を選択します。
1. クライアントネットワークを作成するには、[クライアント] を選択します。
2. プライベートネットワークを作成するには、[プライベート] を選択します。
（ネットワークの種類に [クライアント] を選択した場合にのみ）VLAN アタッチメントを追加するには、[項目を追加] をクリックします。

注: 新しい VLAN アタッチメントを作成するための帯域幅がない場合は、既存の VLAN アタッチメントを削除するか、Google Cloud セールスに追加の帯域幅をリクエストしてください。
1. 現在のプロジェクトから VLAN アタッチメントを追加するには:
  1. [現在のプロジェクトの VLAN アタッチメントを選択します] オプションをオンにします。
  2. [VLAN アタッチメント] リストから、追加する VLAN アタッチメントを選択します。
2. 別のプロジェクトから VLAN アタッチメントを追加するには:
  1. [現在のプロジェクトの VLAN アタッチメントを選択します] チェックボックスをオフにします。
  2. [VLAN アタッチメントのペアリングキー] フィールドに、ペアリングキーを入力します。
    
    ペアリングキーの詳細については、Cloud Interconnect 接続用の VLAN アタッチメントを作成するをご覧ください。
3. [帯域幅] リストで、VLAN アタッチメントに割り当てる帯域幅の量を選択します。
4. [完了] をクリックします。
[ネットワーク IP アドレス範囲] フィールドに、ネットワークの IP アドレス範囲を入力します。
（省略可）[サービスの IP アドレス範囲] フィールドに、ネットワークのサービス IP アドレス範囲を入力します。

注: サービス IP アドレス範囲は、ネットワーク IP アドレス範囲がリージョン内の組織の他の Bare Metal Solution ネットワークと重複していない場合にのみ定義できます。
ネットワークの MTU を選択します。
1. 1,500 - 標準サイズのフレームの場合。
2. 9,000 - ジャンボフレーム用。
インターフェース構成を設定します。

注: ここで設定した構成に加えて、サーバーでインターフェースを構成する必要があります。OS のドキュメントをご覧ください。
1. [インターフェース] リストから、このネットワークのボンドインターフェースを選択します。
  
  ほとんどの場合、クライアントネットワークには bond0、プライベートネットワークには bond1 を選択します。
2. [IP アドレス] フィールドに、接続するネットワークの IP アドレスを入力します。
（省略可）このネットワークをデフォルトゲートウェイにするには、[デフォルトゲートウェイ] チェックボックスをオンにします。
[ネットワークを接続] をクリックします。

サーバーのステータスが「プロビジョニング」に変わります。ネットワークの接続が完了するまでに時間がかかるため、長時間実行オペレーションのステータスを表示するの手順でステータスを確認できます。オペレーションが完了すると、サーバーのステータスは「実行中」に変わります。

既存のネットワークをサーバーに接続する

既存のネットワークは、次の 2 つの条件でサーバーに接続できます。

ネットワークがまだサーバーに接続されていない。
ネットワークの IP アドレス範囲が、サーバーに接続されている別のネットワークと重複していない。

既存のネットワークを接続するには:

コンソール

[Compute Engine] > [Bare Metal Solution] > [サーバー] ページに移動します。
サーバー名をクリックします。
[サーバーの詳細] ページで、[ネットワークを接続] をクリックします。
[ネットワークを接続] ページで、[既存のネットワーク] を選択します。
ネットワークを選択します。
1. 現在のプロジェクトからネットワークを選択するには:
  1. [組織内の他のプロジェクトからネットワークを選択します] オプションがオンになっていないことを確認します。
  2. [既存のネットワークの選択] リストから、サーバーに接続するネットワークを選択します。
2. 組織内の他のプロジェクトからネットワークを選択するには:
  1. [組織内の他のプロジェクトからネットワークを選択します] オプションを選択します。
  2. [既存のネットワークの選択] リストから、サーバーに接続するネットワークを選択します。
インターフェース構成を設定します。

注: ここで設定した構成に加えて、サーバーでインターフェースを構成する必要があります。OS のドキュメントをご覧ください。
1. [インターフェース] リストから、このネットワークのボンドインターフェースを選択します。
  
  ほとんどの場合、クライアントネットワークには bond0、プライベートネットワークには bond1 を選択します。
2. [IP アドレス] フィールドに、接続するネットワークの IP アドレスを入力します。
（省略可）このネットワークをデフォルトゲートウェイにするには、[デフォルトゲートウェイ] チェックボックスをオンにします。
[ネットワークを接続] をクリックします。

サーバーからネットワークの接続を解除する

サーバーから一度に接続解除できるネットワークは 1 つのみです。また、サーバーは実行中でも電源がオフでもかまいません。

コンソール

[Compute Engine] > [Bare Metal Solution] > [サーバー] ページに移動します。
サーバー名をクリックします。
[サーバーの詳細] ページで、切断するネットワークを選択します。
[ネットワークの接続を解除] をクリックします。
確認メッセージが表示されたら、[確認] をクリックします。

サーバーのステータスが「プロビジョニング」に変わります。ネットワークの切断が完了するまでに時間がかかるため、長時間実行オペレーションのステータスを表示するの手順でステータスを確認できます。オペレーションが完了すると、サーバーのステータスは「実行中」に変わります。

ネットワークを削除する

ネットワークを削除するには:

コンソール

[Compute Engine] > [Bare Metal Solution] > [ネットワーク] ページに移動します。
削除するネットワークを選択します。
[削除] をクリックします。
確認メッセージが表示されたら、[確認] をクリックします。

ネットワークの削除が完了するまでに時間がかかるため、長時間実行オペレーションのステータスを表示するの手順でステータスを確認できます。

VLAN アタッチメントを管理する

VLAN アタッチメントは次の方法で管理できます。

VLAN アタッチメントを追加する

クライアントネットワークに 1 つ以上の VLAN アタッチメントを追加できます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [ネットワーク] ページに移動します。
ネットワーク名をクリックします。
[ネットワークの詳細] ページの [VLAN アタッチメント] セクションで、[接続] をクリックします。
[新しい VLAN をネットワークにアタッチします] ページで、次の操作を行います。
1. [項目を追加] をクリックします。
2. 現在のプロジェクトから VLAN アタッチメントを追加するには:
  1. [現在のプロジェクトの VLAN アタッチメントを選択します] オプションをオンにします。
  2. [VLAN アタッチメント] リストから、追加する VLAN アタッチメントを選択します。
3. 別のプロジェクトから VLAN アタッチメントを追加するには:
  1. [現在のプロジェクトの VLAN アタッチメントを選択します] チェックボックスをオフにします。
  2. [VLAN アタッチメントのペアリングキー] フィールドに、ペアリングキーを入力します。
    
    ペアリングキーの詳細については、Cloud Interconnect 接続用の VLAN アタッチメントを作成するをご覧ください。
4. [帯域幅] リストで、VLAN アタッチメントに割り当てる帯域幅の量を選択します。
5. 冗長性と高可用性のために別の VLAN アタッチメントを追加するには、[項目を追加] をクリックして、上記の手順を繰り返します。
6. [完了] をクリックします。
[作成] をクリックします。

VLAN アタッチメントの作成には時間がかかるため、長時間実行オペレーションのステータスを表示するの手順でステータスを確認できます。

VLAN アタッチメントを更新する

VLAN アタッチメントの帯域幅を更新できます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [ネットワーク] ページに移動します。
ネットワーク名をクリックします。
[ネットワークの詳細] ページで、更新する VLAN アタッチメントを選択します。
[更新] をクリックします。
[VLAN アタッチメントの更新] ページで、次の操作を行います。
1. 更新する VLAN アタッチメントを開きます。
2. 帯域幅を変更します。
3. [完了] をクリックします。
[更新] をクリックします。

VLAN アタッチメントの更新には時間がかかるため、長時間実行オペレーションのステータスを表示するの手順でステータスを確認できます。

VLAN アタッチメントを削除する

VLAN アタッチメントを削除できます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [ネットワーク] ページに移動します。
ネットワーク名をクリックします。
[ネットワークの詳細] ページで、削除する VLAN アタッチメントを選択します。
[削除] をクリックします。

VLAN アタッチメントの削除には時間がかかるため、長時間実行オペレーションのステータスを表示するの手順でステータスを確認できます。

Bare Metal Solution 環境の高度なネットワーキング情報を表示する

Bare Metal Solution 環境での複雑なデプロイに高度なネットワーキングオプションを選択した場合は、次のサーバーコマンドを使用してこの情報を表示できます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [サーバー] ページに移動します。
サーバー名をクリックします。
[サーバーの詳細] ページで、次の情報を確認できます。
1. 基本情報でネットワークテンプレートを表示できます。
2. [ネットワーク] セクションでは、次の情報を確認できます。
  - ネットワーク名
  - ネットワークの種類
  - IP アドレス
  - デフォルトゲートウェイ
  - インターフェース名

gcloud

gcloud bms instances describe コマンドを実行して、サーバーの詳細設定を表示します。

gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION

API

サーバーの詳細設定を表示するには、プロジェクト ID、リージョン、サーバー名を入力してから、次の curl コマンドを実行します。出力の network セクションには、各インターフェースに割り当てられたネットワークテンプレート、論理インターフェース、ボンディングインターフェース、ネットワークタイプが表示されます。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME"

Bare Metal Solution 環境で IP アドレス管理を実装する

Bare Metal Solution 環境内でネットワークトポロジを管理できるようにする必要があります。IP アドレス管理を使用すると、リソースの IP アドレスの作成、表示、削除を行うことができます。この情報を使用して、IP アドレスの重複を防ぎ、新しいリソースをリクエストする際の競合を解決できます。

IP アドレスの予約を表示する

既存の予約の IP アドレスを表示するには:

gcloud

gcloud bms Networks list-ip-reservations コマンドを実行します。

gcloud bms networks list-ip-reservations --project=PROJECT_ID --region REGION

API

既存のリソースの IP アドレスの予約を表示するには、プロジェクト ID、リージョン、ネットワーク名を入力してから、次の curl コマンドを発行します。出力の reservations セクションに、予約済みの IP アドレス範囲が表示されます。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME"

IP アドレスの予約を作成および更新する

新しい IP アドレス予約を作成するか、既存の IP アドレス予約を更新するには:

gcloud

IP アドレスの予約を管理するには、gcloud bms Networks update コマンドを実行します。

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region REGION --add-ip-range-reservation=start-address=START_ADDRESS,end-address=END_ADDRESS,note="NOTE"

すべての IP アドレス予約を削除するには、--clear-ip-range-reservations オプションを追加します。
予約済みのアドレスブロックの 1 つを削除するには、--remove-ip-range-reservation オプションを追加して、予約済み IP アドレスブロックの開始アドレスと終了アドレスを指定します。

gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region REGION --remove-ip-range-reservation=start-address=START_ADDRESS,end-address=END_ADDRESS

API

新しい IP アドレス予約を作成するか、既存の IP アドレス予約を更新するには、次のコマンドにプロジェクト ID、リージョン、ネットワーク名を入力します。予約する IP アドレスのブロックごとに、開始アドレス、終了アドレス、メモを追加し、curl コマンドを発行します。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME?updateMask=reservations"
 -d "{
  'reservations' : [
    {
      'startAddress' : 'START_ADDRESS_1',
      'endAddress' : 'END_ADDRESS_1',
      'note' : 'NOTES_1'
    },
    {
      'startAddress' : 'START_ADDRESS_2',
      'endAddress' : 'END_ADDRESS_2',
      'note' : 'NOTES_2'
    }
  ]
}"

IP アドレス予約ブロックは、ターゲットネットワークの CIDR 範囲内にある必要があります。
予約ブロックでは .1（ゲートウェイ IP アドレス）を使用しないでください。
この curl コマンドを実行するたびに、以前の予約セットが上書きされます。更新する必要がある場合は、コマンドを発行する前に、すべての予約ブロックを含める必要があります。
すべての予約を消去するには、コマンドの末尾を次のコードに置き換えます。
```
-d "{
'reservations' : []
}"
```

ストレージを管理する

Bare Metal Solution 環境のストレージは、次の方法で管理できます。

Bare Metal Solution 環境のストレージを表示する

Bare Metal Solution 環境のストレージリソースを調査すると、アプリケーションとワークロードに十分なストレージ容量がサーバーにあるかどうかを判断できます。ストレージのステータスを表示するには、次のいずれかのオプションを選択します。

コンソール

Google Cloud コンソールで、[Compute Engine] > [Bare Metal Solution] > [ボリューム] に移動します。

利用可能な情報を表示します。

フィールド	説明	例
ステータス	ストレージボリュームの可用性を示します。	チェックマークが付いた緑の円は、ストレージボリュームの準備が整ったことを示しています。
ID	ストレージボリュームに割り当てられている ID。 ID をクリックすると、LUN やスナップショットなど、ストレージボリュームに関する基本情報が表示されます。このリソースのトラブルシューティングを行う場合は、ID を Google Cloud サポートと共有してください。	ブートボリューム: `at-1234567-svr001-vol000-b1` ファイバーチャネルボリューム: `at-1111111-vol001` NFS 共有: `at-2222222-nfs001-vol000`
名前	ストレージボリューム名。名前をクリックすると、LUN やスナップショットなど、ストレージボリュームに関する追加情報が表示されます。注: ストレージボリュームのプロビジョニング時に名前を入力しなかった場合は、このフィールドに ID が表示されます。	ブートボリューム: `boot-volume-1` ファイバーチャネルボリューム: `fibre-channel-volume-5` NFS 共有: `nfs-share-7`
ロケーション	ストレージボリュームが配置されているリージョン	`asia-southeast1`
タイプ	ハードドライブまたはソリッドステートドライブ	`HDD - Hard drive`
ラベル	このストレージリソースに追加したラベルが表示されます。ラベルのテキストをコピーし、[ステータス] フィールドのすぐ上にある [フィルタ] ボックスに貼り付けることで、コンソールの出力をフィルタリングできます。	`environment:test`

gcloud

Bare Metal Solution 環境内のすべてのストレージボリュームを表示してステータスを確認するには、プロジェクト ID を入力して gcloud bms volumes list コマンドを実行します。

gcloud bms volumes list --project=PROJECT_ID

次の出力例は、プロジェクト ID、リージョン、ボリュームサイズ、ストレージタイプの 3 つのストレージボリュームを示しています。

NAME                         PROJECT              REGION           REQUESTED_SIZE_GIB  STORAGE_TYPE  STATE
at-1234567-svr001-vol000-b1  PROJECT_ID         REGION         200                 SSD           READY
at-1111111-vol001            PROJECT_ID         REGION         1024                SSD           READY
at-2222222-nfs001-vol000     PROJECT_ID         REGION         400                 HDD           READY

1 つのストレージボリュームを表示するには、ストレージボリューム名、プロジェクト ID、リージョンを入力して、gcloud bms volumes describe コマンドを実行します。
```
gcloud bms volumes describe VOLUME_NAME --project=PROJECT_ID --region=REGION
```
次の出力例は、ストレージボリュームサイズ、名前、スナップショット自動削除ポリシー、状態、ストレージタイプを示しています。
```
currentSizeGib: '250'
name: projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME
requestedSizeGib: '250'
snapshotAutoDeleteBehavior: OLDEST_FIRST
snapshotReservationDetail:
  reservedSpaceGib: '50'
  reservedSpaceRemainingGib: '50'
state: READY
storageType: SSD
```
ストレージボリュームのすべての LUN を表示するには、プロジェクト ID、リージョン、ストレージボリューム名を入力して、gcloud bms volumes luns list コマンドを実行します。
```
gcloud bms volumes luns list --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME
```
次の出力例は、LUN の名前、リージョン、ストレージボリューム名、ボリュームサイズ、状態を示しています。
```
NAME                         REGION           VOLUME       SIZE_GB  STATE
at-11111111-vol001-lun000    REGION        VOLUME_NAME 200      READY
```
1 つの LUN の詳細を表示するには、プロジェクト ID、リージョン、LUN の名前を入力して、gcloud bms volumes luns describe コマンドを実行します。
```
gcloud bms volumes luns describe LUN_NAME --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME
```
次の出力例は、LUN 名とストレージボリューム情報（サイズ、状態、ストレージタイプ、名前、ID など）を示しています。
```
bootLun: true
name: projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/luns/LUN_NAME
sizeGb: '200'
state: READY
storageType: SSD
storageVolume: VOLUME_NAME
wwid: 600a09803831434434244f774d616b94
```

API

Google Cloud コンソールで Cloud Shell ターミナルウィンドウを開きます。
Bare Metal Solution 環境内のすべてのストレージボリュームを表示してステータスを表示するには、次の curl コマンドにプロジェクト ID とリージョンを入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。
```
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes"
```
注: ボリュームの更新が進行中の場合、状態フィールドは「作成中」と表示されます。ボリュームの更新が完了すると、状態フィールドは「準備完了」と表示されます。

単一のストレージボリュームを表示するには、プロジェクト ID、リージョン、ストレージボリューム名を入力して、次のコマンドを実行します。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME"

ストレージボリュームのすべての論理ユニット番号（LUN）を表示するには、プロジェクト ID、リージョン、ストレージボリューム名を入力してから、次のコマンドを実行します。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/luns

1 つの LUN の詳細を表示するには、プロジェクト ID、リージョン、ストレージボリューム名、LUN 名を入力し、次のコマンドを実行します。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/luns/LUN_NAME"

ラベルを使用してストレージボリュームを整理する

ストレージボリュームを整理するには、ラベルを使用します。ラベルとは、各ストレージボリュームに添付して、ラベルに基づいてストレージボリュームをフィルタリングできる Key-Value ペアのことです。たとえば、ラベルを使用して、目的、環境、ロケーション、部門などでストレージボリュームをグループ化できます。ラベルはオプションです。

ストレージボリュームのラベルを追加または更新する

既存のストレージボリュームのラベルを追加または更新できます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [ボリューム] のページに移動します。
ラベルを付けるストレージボリュームでをクリックします。
[ラベルを編集] をクリックします。
[ラベルエディタ] ページで次の操作を行います。
1. [ラベルを追加] をクリックして、Key-Value ペアを追加します。
2. ラベルを更新するには、既存のラベルを選択して値を変更します。
3. [送信] をクリックします。
[ボリューム] ページに戻り、ページを更新して変更を表示します。

gcloud

ストレージボリュームのラベルを追加または更新するには、--update-labels オプションを指定して gcloud bms volumes update コマンドを使用します。

次のサンプルコマンドでは、environment = dev ラベルと location = branch ラベルを追加します。

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

API

ストレージボリュームのラベルを追加または更新するには、次の curl コマンドにプロジェクト ID、リージョン、ボリューム名、ラベルのリストを入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

次のサンプルコマンドでは、environment = test というラベルを割り当てます。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

ストレージボリュームからラベルを削除する

ストレージボリュームからラベルを削除できます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [ボリューム] のページに移動します。
削除するラベルがあるストレージボリュームのをクリックします。
[ラベルを編集] をクリックします。
[ラベルエディタ] ページで次の操作を行います。
1. ラベルを削除するには、をクリックします。
2. [送信] をクリックします。
[ボリューム] ページに戻り、ページを更新して変更を表示します。

gcloud

ストレージボリュームからラベルを削除するには、次のオプションを指定して gcloud bms volumes update コマンドを使用します。

--remove-labels: 指定したラベルを削除します。
--clear-labels: すべてのラベルを削除します。

次のサンプルコマンドは、ストレージボリュームからラベル department を削除します。

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

次のサンプルコマンドは、ストレージボリュームからすべてのラベルを削除します。

gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

ストレージボリュームからラベルを削除するには、次の curl コマンドにプロジェクト ID、リージョン、ストレージボリュームの名前を入力します。すべてのラベルを削除するには、ラベルの空のリストを指定します。あるいは、削除しないラベルのリストを指定します（削除するラベルは指定しない）。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

次のサンプルコマンドは、environment = test 以外のすべてのラベルを削除します。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

ラベルを使用してストレージボリュームをフィルタリングする

ラベルを使用して、ストレージボリュームを検索し、結果をフィルタリングできます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [ボリューム] のページに移動します。
ストレージボリュームのリストの上にある [フィルタ] バーをクリックします。
[プロパティ] リストから [ラベル] を選択します。
ラベルのキー、値、または Key-Value ペアを入力します。

たとえば、env:dev というラベルのストレージボリュームのみを表示するには、次のように入力します。
- キー env を入力します。
- 値 dev を入力します。
- Key-Value ペア env:dev を入力します。
ラベルフィルタを適用するには、フィルタバーの外側をクリックします。

gcloud

ラベルを使用してストレージボリュームをフィルタリングするには、--filter オプションを指定して gcloud bms volumes list コマンドを使用します。

gcloud bms volumes list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

gcloud CLI のフィルタ構文の詳細については、gcloud topic filters のドキュメントをご覧ください。

API

ラベルを使用してストレージボリュームをフィルタリングするには、プロジェクト ID とリージョン、filter=labels、Key-Value ペアのラベルを入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

次のサンプルコマンドは、Key-Value ペアのラベルが environment = test のストレージボリュームを探すため出力を制限しています。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes"?filter=labels.environment=test

Bare Metal Solution 環境でストレージボリュームリソースをプロビジョニングする

Bare Metal Solution 環境用のストレージリソースを注文し、そのリソースが使用可能になったらプロビジョニングできます。次のセルフサービスオプションをプロビジョニングできます。

新しいファイバーチャネルストレージボリュームを作成する
ボリュームに LUN を作成する
新しく作成した LUN を選択してサーバーに接続する

新しいストレージボリュームを作成する

新しいストレージボリュームを作成するには:

コンソール

Google Cloud コンソールで、[Compute Engine] > [Bare Metal Solution] > [ボリューム] メニューに移動します。
[作成] をクリックします。

次の情報を入力します。

フィールド	説明	例
リージョン	Bare Metal Solution 環境に最も近い Google Cloud リージョン。	`us-central1`
名前	ストレージボリュームの名前を作成します。	`volume-1`
種類	ストレージの種類を選択します。 SSD - ソリッドステートドライブ HDD - ハードドライブ	`SSD`
サイズ	1,024 GiB = 1 TiB である GiB でドライブのサイズを選択します。100 GiB～16 TiB の範囲でサイズを指定します。16 TiB を超えるボリュームが必要な場合は、必要に応じて追加のボリュームを作成します。	`16384`
スナップショット有効	1 日に 1 回、ストレージボリュームのバックアップコピーを保存します。カスタムスナップショットの場合は必須ですが、デフォルトでは無効になっています。注: スナップショットを有効にすると、Google Cloud はリクエストされたストレージボリュームの 20% を予約します。たとえば、ボリュームサイズが 1 TiB（1,024 GiB）の場合、データストレージに 819 GiB、スナップショットに 205 GiB を使用できます。	スナップショットを有効にするチェックボックスがオンになっています
構成	必要な LUN 構成のタイプを選択します。デフォルト構成 - 同じサイズの LUN を作成します（推奨）。カスタム構成 – さまざまなサイズの LUN を作成します。	`Default configuration`
ターゲットサーバー	サーバーを選択してストレージボリュームを接続します。	`server-1`

[作成] をクリックします。
リクエストしたストレージボリュームに十分な空き容量があるかどうか確認されます。容量に余裕がある場合は、変更が実装されます。オペレーションを実行できない場合はアラートが表示されます。ストレージボリュームリクエストが成功した場合、追加ストレージに対する課金が自動的に開始します。
ストレージボリュームをプロビジョニングしたら、追加サーバーと共有できます。

注: ストレージボリューム内の既存の LUN を拡張することはできません。代わりに、新しいストレージボリュームで新しい LUN を作成し、古い LUN を新しいストレージボリュームに移行して、古い LUN を廃止します。

ストレージボリューム用の LUN を作成する

ストレージボリューム用の LUN を作成するには:

コンソール

Google Cloud コンソールで、[Compute Engine] > [Bare Metal Solution] > [ボリューム] メニューに移動します。
[LUN] セクションの横にある [作成] をクリックします。

次の情報を入力します。

フィールド	説明	例
LUN 数	特定のサイズで作成する LUN の合計数。	`4`
サイズ	LUN のサイズを GiB 単位で選択します。ここで 1,024 GiB は 1 TiB です。	`1024`

LUN のセットを 2 つ以上作成する必要がある場合は、[項目を追加] をクリックします。
[作成] をクリックして、新しい LUN をデプロイします。

注: 既存のストレージボリュームに新しい LUN を追加する場合は、新しい LUN を稼働できるように、LUN を再スキャンする必要があります。詳細については、ストレージの選択をご覧ください。

ストレージボリュームをサーバーに接続する

既存のストレージボリュームを既存のサーバーに接続するには:

コンソール

[Compute Engine] > [Bare Metal Solution] > [サーバー] ページに移動します。
ストレージボリュームが必要なサーバーの名前をクリックします。
[LUN] セクションの横にある [Attach Volume] をクリックします。
メニューからストレージボリュームを選択し、[アタッチ] をクリックします。
同じストレージボリュームを別のサーバーにアタッチするには、[サーバーの詳細] ページに戻り、この手順を繰り返します。

Bare Metal Solution 環境でストレージボリュームリソースを削除する

特定のストレージボリュームリソースが不要になった場合は削除できます。ストレージリソースは次の順序で削除する必要があります。

サーバーからストレージボリュームを切断する
ストレージボリュームから LUN を削除する
ストレージボリュームを削除する

サーバーからストレージボリュームを切断する

サーバーからストレージボリュームを切断するには:

コンソール

[Compute Engine] > [Bare Metal Solution] > [サーバー] ページに移動し、ストレージボリュームがアタッチされているサーバーをクリックします。
[LUN] セクションまで下にスクロールし、[ボリュームを切断] をクリックします。
[ターゲットボリューム] リストから、切断するストレージボリュームを選択します。
（省略可）デフォルトでは、ストレージボリュームを切断すると、サーバーが再起動されます。サーバーを再起動しない場合は、[サーバーの再起動をスキップする] チェックボックスをオンにします。

注意: 切断する前にすべてのサーバーからストレージボリュームのマウントを解除しないと、データが破損し、次の再起動でサーバーで問題が発生する可能性があります。これを回避するには、変更に合わせてホスト構成を更新します。
[ボリュームを切断] をクリックします。

ステップ 4 で [サーバーの再起動をスキップする] オプションを選択しなかった場合は、サーバーが再起動し、サーバーからストレージボリュームとその LUN が削除されます。

ストレージボリュームから LUN を削除する

ストレージボリュームから LUN を削除するには:

コンソール

[Compute Engine] > [Bare Metal Solution] > [ボリューム] のページに移動します。
削除する LUN を含むストレージボリュームの名前をクリックします。
[LUNs] セクションで、削除する LUN のチェックボックスをオンにして、[削除] をクリックします。
注:
- サーバーに接続している LUN は削除できません。サーバーから LUN を切断してから LUN を削除します。
- LUN が誤って削除されるのを防ぐため、Google Cloud ではクールオフ期間（LUN 削除後 7 日間）がデフォルトで設定されています。この期間中は、削除された LUN のストレージ容量は再利用できません。まれに、LUN のクールオフ期間の短縮が必要になることがあります。その場合は、Cloud カスタマーケアにお問い合わせください。

ストレージボリュームを削除する

ストレージボリュームを削除するには:

コンソール

[Compute Engine] > [Bare Metal Solution] > [ボリューム] のページに移動します。
削除するストレージボリュームのチェックボックスをオンにして、[削除] をクリックします。

注: 接続している LUN が残っていると、ストレージボリュームを削除できません。まず LUN を削除してからストレージボリュームを削除します。

ブートボリュームのスナップショットを管理する

ブートボリュームのスナップショットは、次の方法で管理できます。

ブートボリュームのスナップショットとその詳細を表示する

ブートボリュームのスナップショットのリストと、次の情報を確認できます。

ID
名前
説明
作成時間
関連するボリューム
種類

コンソール

[Compute Engine] > [Bare Metal Solution] > [ボリューム] のページに移動します。
ボリューム名をクリックします。
[ボリュームの詳細] ページの [スナップショット] セクションで、スナップショットのリストとその詳細を確認できます。

gcloud

ブートボリュームのすべてのスナップショットを一覧表示するには、gcloud bms volumes snapshots list コマンドを実行します。

gcloud bms volumes snapshots list --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME

ブートボリュームの特定のスナップショットの詳細を表示するには、gcloud bms volumes snapshots describe コマンドを実行します。

gcloud bms volumes snapshots describe --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME --snapshot-name=SNAPSHOT_NAME

API

すべてのブートボリュームのスナップショットを一覧表示するには、次の curl コマンドにプロジェクト ID、リージョン、ボリューム名を入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots"

ブートボリュームスナップショットの詳細を表示するには、次の curl コマンドにプロジェクト ID、リージョン、ボリューム名、スナップショット名を入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME"

ブートボリュームのスナップショットを作成する

ブートボリュームのスナップショットを作成できます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [ボリューム] のページに移動します。
ボリューム名をクリックします。
[ボリュームの詳細] ページの [スナップショット] セクションで、[作成] をクリックします。
[新しいボリュームスナップショットの作成] ページで、次の操作を行います。
1. [名前] フィールドに、スナップショットの一意の名前を入力します。
2. [説明] フィールドに、スナップショットの説明を入力します。
[作成] をクリックします。

gcloud

ブートボリュームのスナップショットを作成するには、gcloud bms volumes snapshot コマンドを実行します。

gcloud bms volumes snapshot --project=PROJECT_ID --region=REGION VOLUME_NAME --snapshot-name=SNAPSHOT_NAME --description=DESCRIPTION

API

ブートボリュームのスナップショットを作成するには、次の curl コマンドにプロジェクト ID、リージョン、ボリューム名、スナップショット名、スナップショットの説明を入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots"
 -d \
'{\''name\'':
\''projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME\'', \''description\'': \''DESCRIPTION\''}' \

ブートボリュームのスナップショットを削除する

ブートボリュームのスナップショットを削除できます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [ボリューム] のページに移動します。
ボリューム名をクリックします。
[ボリュームの詳細] ページの [スナップショット] セクションで、削除するスナップショットを選択します。
[削除] をクリックします。
確認メッセージが表示されたら、[確認] をクリックします。

gcloud

ブートボリュームのスナップショットを削除するには、gcloud bms volumes snapshots delete コマンドを実行します。

gcloud bms volumes snapshots delete --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME SNAPSHOT_NAME

プロンプトが表示されたら、「Y」と入力して Enter キーまたは Return キーを押します。

API

ブートボリュームのスナップショットを削除するには、次の curl コマンドにプロジェクト ID、リージョン、ボリューム名、スナップショット名を入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME"

ブートボリュームのスナップショットを復元する

スナップショットからブートボリュームを復元できます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [サーバー] ページに移動します。
復元するボリュームにアタッチされているサーバーを停止します。Bare Metal Solution サーバーの操作をご覧ください。

シャットダウンが完了するまで待ってから、次のステップに進みます。
[Compute Engine] > [Bare Metal Solution] > [ボリューム] のページに移動します。
復元するボリュームのボリューム名をクリックします。
[ボリュームの詳細] ページで、次の操作を行います。
1. 復元するスナップショットのをクリックします。
2. [復元] をクリックします。
3. 確認メッセージが表示されたら、[確認] をクリックします。

gcloud

ブートボリュームのスナップショットを復元するには、gcloud bms volumes restore コマンドを実行します。

gcloud bms volumes restore --project=PROJECT_ID --region=REGION VOLUME_NAME --snapshot-name=SNAPSHOT_NAME

API

ブートボリュームのスナップショットを復元するには、次の curl コマンドにプロジェクト ID、リージョン、ボリューム名、スナップショット名を入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
-H "Content-Length:0" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/snapshots/SNAPSHOT_NAME:restoreVolumeSnapshot"

ブートボリュームの復元が完了するまでに時間がかかるため、長時間実行オペレーションのステータスを表示するの手順でステータスを確認できます。

NFS ファイルストレージを管理する

NFS ファイルストレージは、次の方法で管理できます。

Bare Metal Solution 環境の NFS ファイルストレージを表示する

Bare Metal Solution 用に NFS を注文してプロビジョニングすると、NFS ファイルストレージのステータスを表示し、Google Cloud が想定どおりの構成を実装していることを確認できます。現在のステータスを表示するには、次のいずれかのオプションを選択します。

コンソール

Google Cloud コンソールで、[Compute Engine] > [Bare Metal Solution] > [NFS 共有] に移動します。

利用可能な情報を表示します。

フィールド	説明	例
ステータス	NFS ボリュームの可用性を示します。	チェックマークが付いた緑の円は、NFS ボリュームがプロビジョニングされていることを示します。
ID	ボリュームをホストする NFS ストレージデバイスに割り当てられた ID。 ID をクリックすると、ストレージボリュームに関する追加情報（許可されたクライアントや NFS プロパティなど）が表示されます。このリソースのトラブルシューティングを行う場合は、ID を Google Cloud サポートと共有してください。	`at-2222222-nfs001`
名前	ボリュームをホストする NFS ストレージデバイスの名前。名前をクリックすると、ストレージボリュームに関する追加情報（許可されたクライアントや NFS プロパティなど）が表示されます。注: NFS ストレージデバイスのプロビジョニング時に名前を入力しなかった場合は、このフィールドに ID が表示されます。	`nfs-share-7`
ロケーション	NFS ストレージボリュームのリージョン	`asia-southeast1`
ボリューム	NFS ストレージボリュームの名前。名前をクリックすると、NFS ストレージボリュームに関する追加情報（スナップショットなど）が表示されます。	`at-2222222-nfs001-vol000`
ラベル	この NFS ファイルストレージリソースに追加したラベルが表示されます。ラベルのテキストをコピーし、[ステータス] フィールドのすぐ上にある [フィルタ] ボックスに貼り付けることで、コンソールの出力をフィルタリングできます。	`environment:test`

gcloud

Bare Metal Solution 環境内の NFS ファイルストレージのステータスを表示するには、gcloud bms nfs-shares list コマンドを実行します。
```
gcloud bms nfs-shares list --project=PROJECT_ID --region=REGION
```
その他のコマンドオプション:
- --limit:: 特定のデバイス数のみを表示するように出力を制限します。
- --filter:: 特定のラベルまたは他のフィルタパラメータを持つデバイスを表示するように出力を制限します。
出力には、名前、ID、ボリューム、許可されたクライアントなど、NFS ファイルストレージに関する詳細が表示されます。
```
NAME: nfs-share-7
ID: at-2222222-nfs001
PROJECT: PROJECT_ID
REGION: REGION
VOLUME_NAME: at-2222222-nfs001-vol000
STATE: PROVISIONED
ALLOWED_CLIENTS: [{"allowedCidr": "192.168.1.1/32", "networkName": "at-1111111-vlan001", "shareIp": "192.168.1.240"}]
```

特定の NFS ファイルストレージデバイスのステータスを表示するには、gcloud bms nfs-shares describe コマンドを実行します。NFS_SHARE 変数として NFS 共有名または ID を使用できます。

gcloud bms nfs-shares describe NFS_SHARE --project=PROJECT_ID --region=REGION

出力には、許可されたクライアント、NFS 設定、NFS サーバーとその状態、ストレージボリュームの詳細が表示されます。

allowedClients:
– allowDev: true
  allowedClientsCidr: 192.168.1.1/32
  mountPermissions: READ_WRITE
  network: projects/PROJECT_ID/locations/REGION/networks/at-1111111-vlan001
  noRootSquash: true
  shareIp: 192.168.1.240
name: projects/PROJECT_ID/locations/REGION/nfsShares/NFS_SHARE
nfsShareId: at-2222222-nfs001
state: PROVISIONED
volume: projects/PROJECT_ID/locations/REGION/volumes/at-2222222-nfs001-vol000

API

許可されたクライアントと NFS プロパティを含む、Bare Metal Solution 環境内の NFS ファイルストレージのステータスを表示するには、プロジェクト ID とリージョンを入力して、次の curl コマンドを実行します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。
```
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares"
```

特定の NFS ファイルストレージデバイスのステータスを表示するには、プロジェクト ID、リージョン、NFS サーバー名または ID を入力して、次のコマンドを実行します。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_SHARE"

ラベルを使用して NFS ファイルストレージを整理する

NFS ファイルストレージの整理には、ラベルを使用できます。ラベルとは、各 NFS ボリュームに設定して、ラベルに基づいて NFS ボリュームをフィルタリングできる Key-Value ペアのことです。たとえば、ラベルを使用して、NFS ボリュームを目的、環境、ロケーション、部門などでグループ化できます。ラベルはオプションです。

NFS ボリュームのラベルを追加または更新する

既存の NFS ボリュームのラベルを追加または更新できます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [NFS 共有] ページに移動します。
ラベルを付ける NFS ボリュームのをクリックします。
[ラベルを編集] をクリックします。
[ラベルエディタ] ページで次の操作を行います。
1. [ラベルを追加] をクリックして、Key-Value ペアを追加します。
2. ラベルを更新するには、既存のラベルを選択して値を変更します。
3. [送信] をクリックします。
[NFS 共有] ページに戻り、ページを更新して変更を表示します。

gcloud

NFS ボリュームのラベルを追加または更新するには、--update-labels オプションを指定して gcloud bms nfs-shares update コマンドを使用します。

次のサンプルコマンドでは、environment = dev ラベルと location = branch ラベルを追加します。

gcloud bms nfs-shares update NFS_VOLUME_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch

API

NFS ボリュームのラベルを追加または更新するには、次の curl コマンドにプロジェクト ID、リージョン、NFS ボリューム名、ラベルのリストを入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

次のサンプルコマンドでは、environment = test というラベルを割り当てます。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

NFS ボリュームからラベルを削除する

NFS ボリュームからラベルを削除できます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [NFS 共有] ページに移動します。
削除するラベルがある NFS ボリュームのをクリックします。
[ラベルを編集] をクリックします。
[ラベルエディタ] ページで次の操作を行います。
1. ラベルを削除するには、をクリックします。
2. [送信] をクリックします。
[NFS 共有] ページに戻り、ページを更新して変更を表示します。

gcloud

NFS ボリュームからラベルを削除するには、次のオプションを指定して gcloud bms nfs-shares update コマンドを使用します。

--remove-labels: 指定したラベルを削除します。
--clear-labels: すべてのラベルを削除します。

次のサンプルコマンドでは、NFS ボリュームからラベル department を削除します。

gcloud bms nfs-shares update NFS_VOLUME_NAME --project=PROJECT_ID --region=REGION --remove-labels=department

次のサンプルコマンドは、NFS ボリュームからすべてのラベルを削除します。

gcloud bms nfs-shares update NFS_VOLUME_NAME --project=PROJECT_ID --region=REGION --clear-labels

API

NFS ボリュームからラベルを削除するには、次の curl コマンドにプロジェクト ID、リージョン、NFS ボリューム名を入力します。すべてのラベルを削除するには、ラベルの空のリストを指定します。あるいは、削除しないラベルのリストを指定します（削除するラベルは指定しない）。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

次のサンプルコマンドは、environment = test 以外のすべてのラベルを削除します。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

ラベルまたは値を指定せずに curl コマンドを実行すると、すべてのラベルがクリアされます。

'labels' : {
}

ラベルに新しい値を指定して curl コマンドを実行すると、以前の値が新しい値で上書きされます。

'labels' : {
     'user': 'production',
     'env': 'production',
     'purpose': 'shared_data_store'
}

ラベルを使用して NFS ボリュームをフィルタリングする

ラベルを使用して、NFS ボリュームを検索し、結果をフィルタリングできます。

コンソール

[Compute Engine] > [Bare Metal Solution] > [NFS 共有] ページに移動します。
NFS ボリュームのリストの上にある [フィルタ] バーをクリックします。
[プロパティ] リストから [ラベル] を選択します。
ラベルの Key-Value ペアまたは Key-Value ペアを入力します。

たとえば、env:dev というラベルの NFS ボリュームのみを表示するには、次のように入力します。
- キー env を入力します。
- 値 dev を入力します。
- Key-Value ペア env:dev を入力します。
ラベルフィルタを適用するには、フィルタバーの外側をクリックします。

gcloud

ラベルを使用して NFS ボリュームをフィルタリングするには、--filter オプションを指定して gcloud bms nfs-shares list コマンドを使用します。

gcloud bms nfs-shares list --project=PROJECT_ID --region=REGION --filter labels.environment=dev

gcloud CLI のフィルタ構文の詳細については、gcloud topic filters のドキュメントをご覧ください。

API

ラベルを使用して NFS ボリュームをフィルタリングするには、プロジェクト ID とリージョン、filter=labels、Key-Value ペアのラベルを入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

次のサンプルコマンドは、Key-Value ペアのラベルが environment = test の NFS ボリュームを探すため出力を制限します。

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares"?filter=labels.environment=test

NFS ボリュームを作成する

1 つ以上の許可されたクライアントを使用して NFS ボリュームを作成できます。

gcloud

NFS ボリュームを作成するには、gcloud bms nfs-shares create コマンドを実行します。--allowed-client オプションを使用して、許可するクライアントを指定します。複数の許可されたクライアントを指定するには、--allowed-client オプションを繰り返します。

次のコマンドを実行する前に、次の値を入力します。

NFS_VOLUME_NAME: NFS ボリュームの名前。
REGION: NFS ボリュームのリージョン。
SIZE_GIB: NFS ボリュームのサイズ（GiB）。
STORAGE_TYPE: 基盤となるボリュームのストレージタイプ。
NETWORK_NAME: 許可するネットワークの名前。
（省略可）PROJECT_ID: 許可されるクライアントネットワークのプロジェクト ID。プロジェクト ID を指定しない場合は、NFS ボリュームが属するプロジェクトが使用されます。
IP_ADDRESS_RANGE: NFS ボリュームへのアクセスを許可された IP アドレスのサブネット。通常はクライアントネットワークです。
MOUNT_PERMISSIONS: 許可されるクライアントネットワークのマウント権限。
ALLOW_DEV: デバイスの作成を許可する（はい / いいえ）。
ALLOW_SUID: SUID を許可する（はい / いいえ）。
ENABLE_ROOT_SQUASH: ルートスカッシュを有効にする（はい / いいえ）。

gcloud bms nfs-shares create --project=PROJECT_ID --region=REGION NFS_VOLUME_NAME \
--size-gib=SIZE_GIB --storage-type=STORAGE_TYPE \
--allowed-client=network=NETWORK_NAME,\
network-project-id=PROJECT_ID,cidr=IP_ADDRESS_RANGE,\
mount-permissions=MOUNT_PERMISSIONS,allow-dev=ALLOW_DEV,allow-suid=ALLOW_SUID,\
enable-root-squash=ENABLE_ROOT_SQUASH \

API

NFS ボリュームを作成するには、次の curl コマンドに変数の値を入力します。allowedClients リストを使用して、許可するクライアントを指定できます。

次のコマンドを実行する前に、次の値を入力します。

NFS_VOLUME_NAME: NFS ボリュームの名前。
REGION: NFS ボリュームのリージョン。
SIZE_GIB: NFS ボリュームのサイズ（GiB）。
STORAGE_TYPE: 基盤となるボリュームのストレージタイプ。
NETWORK_NAME: 許可するネットワークの名前。
（省略可）PROJECT_ID: 許可されるクライアントネットワークのプロジェクト ID。プロジェクト ID を指定しない場合は、NFS ボリュームが属するプロジェクトが使用されます。
IP_ADDRESS_RANGE: NFS ボリュームへのアクセスを許可された IP アドレスのサブネット。通常はクライアントネットワークです。
MOUNT_PERMISSIONS: 許可されるクライアントネットワークのマウント権限。
ALLOW_DEV: デバイスの作成を許可する（はい / いいえ）。
ALLOW_SUID: SUID を許可する（はい / いいえ）。
ENABLE_ROOT_SQUASH: ルートスカッシュを有効にする（はい / いいえ）。

コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares"
 -d \
'{
  "name": "projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME",
  "labels": {
    "nfsKey1": "some_value",
    "key2": "another_value",
  },
  "requestedSizeGib": "SIZE_GIB",
  "storageType": "STORAGE_TYPE",
  "allowedClients": [
    {
      "network": "projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME",
      "allowedClientsCidr": "IP_ADDRESS_RANGE",
      "mountPermissions": "MOUNT_PERMISSIONS",
      "allowDev": ALLOW_DEV,
      "allowSuid": ALLOW_SUID,
      "noRootSquash": ENABLE_ROOT_SQUASH,
    }
  ],
}'

NFS ボリュームの作成には時間がかかるため、長時間実行オペレーションのステータスを表示するの手順でステータスを確認できます。

NFS ボリュームを更新する

NFS ボリュームで許可されるクライアントのリストとその属性を更新できます。

gcloud

NFS ボリュームに対して許可されるクライアントのリストを更新するには、次のオプションを指定して gcloud bms nfs-shares update コマンドを使用します。

--add-allowed-client: 許可されるクライアントを追加します。複数の許可されたクライアントを追加するには、このオプションを繰り返します。
--remove-allowed-client: 許可されたクライアントを削除します。このオプションでは、NETWORK_NAME と IP_ADDRESS_RANGE の値を指定する必要があります。複数の許可されたクライアントを削除するには、この手順を繰り返します。
--clear-allowed-client: 許可されたすべてのクライアントを削除します。

NFS ボリュームを更新するには、適切なオプションを指定して gcloud bms nfs-shares update コマンドを実行します。例:

gcloud bms nfs-shares update --project=PROJECT_ID --region=REGION NFS_VOLUME_NAME --remove-allowed-client=network=NETWORK_NAME,network-project-id=PROJECT_ID,cidr=IP_ADDRESS_RANGE

許可されたクライアントの属性を更新するには、--remove-allowed-client オプションを使用してそのクライアントを削除してから、--add-allowed-client オプションを使用して属性を再度追加します。

API

NFS ボリュームを更新するには、次の curl コマンドに変数の値を入力します。変数の完全なリストについては、NFS ボリュームを作成するをご覧ください。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME?updateMask=allowed_clients%2Clabels"
 -d \
'{
  "name": "projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME",
  "labels": {
    "newKey": "newVal",
  },
  "allowedClients": [
    {
      "network": "projects/PROJECT_ID/locations/REGION/networks/NFS_VOLUME_NAME",
      "allowedClientsCidr": "IP_ADDRESS_RANGE",
      "mountPermissions": "MOUNT_PERMISSIONS",
      "allowDev": ALLOW_DEV,
      "allowSuid": ALLOW_SUID,
      "noRootSquash": ENABLE_ROOT_SQUASH,
    }
  ],
}'

NFS ボリュームの更新には時間がかかるため、長時間実行オペレーションのステータスを表示するの手順でステータスを確認できます。

NFS ボリュームを削除する

NFS ボリュームを削除できます。

gcloud

NFS ボリュームを削除するには、gcloud bms nfs-shares delete コマンドを実行します。

gcloud bms nfs-shares delete --project=PROJECT_ID --region=REGION NFS_VOLUME_NAME

API

NFS ボリュームを削除するには、次の curl コマンドにプロジェクト ID、リージョン、NFS ボリュームの名前を入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_VOLUME_NAME"

NFS ボリュームの削除には時間がかかるため、長時間実行オペレーションのステータスを表示するの手順でステータスを確認できます。

長時間実行オペレーションのステータスを表示する

一部の gcloud または API コマンド（サーバーリセットなど）は、完了するまでに時間がかかる場合があります。長時間実行オペレーションを生成するコマンドでも、オペレーション ID を含む出力が生成されます。オペレーション ID を使用して、長時間実行オペレーションのステータスを確認できます。

出力の name フィールドで、operations ディレクトリの後にあるオペレーション ID を確認できます。たとえば、次の reset API コマンドの出力では、オペレーション ID が eb0056e2-b6f6-4792-8255-59cd79d5c686 として表示されます。

{
"name": "projects/PROJECT_ID/locations/REGION/operations/eb0056e2-b6f6-4792-8255-59cd79d5c686",
"done": true
}

長時間実行オペレーションのステータスを確認するには、次のオプションを使用します。

gcloud

長時間実行オペレーションのステータスを表示するには、gcloud bms operations describe コマンドを使用します。

gcloud bms operations describe --project=PROJECT_ID --region=REGION OPERATION_ID

API

Google Cloud コンソールで Cloud Shell ターミナルウィンドウを開きます。
Bare Metal Solution 環境での長時間実行オペレーションのステータスを表示するには、次の curl コマンドにプロジェクト ID、リージョン、オペレーション ID を入力します。コマンドをコピーして Cloud Shell プロンプトに貼り付け、Enter または Return キーを押します。
```
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID"
```
オペレーションが完了すると、出力の done フィールドに true が表示されます。
```
{
  "name": "operations/OPERATION_ID",
  "done": true
}
```

Bare Metal Solution 環境のメンテナンス

Google Cloud プロジェクトを設定して Bare Metal Solution API を使用する

コンソール

gcloud

Bare Metal Solution サーバーの操作

コンソール

gcloud

API

サーバーのステータスを確認する

コンソール

gcloud

API

Bare Metal Solution 環境のリソースを管理する

Bare Metal Solution API の設定を確認する

サーバーを管理する

Bare Metal Solution 環境のサーバーを表示する

コンソール

gcloud

API

ラベルを使用してサーバーを整理する

サーバーのラベルを追加または更新する

コンソール

gcloud

API

サーバーからラベルを削除する

コンソール

gcloud

API

ラベルを使用してサーバーをフィルタリングする

コンソール

gcloud

API

サーバーの初期パスワードを取得する

gcloud

API

サーバーのオペレーティング システムを変更する

コンソール

gcloud

API

サーバーでハイパースレッディングを有効にする

コンソール

gcloud

API

ネットワークを管理する

Bare Metal Solution 環境のネットワークを表示する

コンソール

gcloud

API

ラベルを使用してネットワークを整理する

ネットワークのラベルを追加または更新する

コンソール

gcloud

API

ネットワークからラベルを削除する

コンソール

gcloud

API

ラベルを使用してネットワークをフィルタリングする

コンソール

gcloud

API

ネットワークを追加してサーバーに接続する

新しいネットワークを作成してサーバーに接続する

コンソール

既存のネットワークをサーバーに接続する

コンソール

サーバーからネットワークの接続を解除する

コンソール

ネットワークを削除する

コンソール

VLAN アタッチメントを管理する

VLAN アタッチメントを追加する

コンソール

VLAN アタッチメントを更新する

コンソール

VLAN アタッチメントを削除する

コンソール

Bare Metal Solution 環境の高度なネットワーキング情報を表示する

コンソール

gcloud

サーバーのオペレーティングシステムを変更する

ラベルを使用してストレージボリュームを整理する

ストレージボリュームのラベルを追加または更新する

ストレージボリュームからラベルを削除する

ラベルを使用してストレージボリュームをフィルタリングする

Bare Metal Solution 環境でストレージボリュームリソースをプロビジョニングする

新しいストレージボリュームを作成する

ストレージボリューム用の LUN を作成する

ストレージボリュームをサーバーに接続する

Bare Metal Solution 環境でストレージボリュームリソースを削除する

サーバーからストレージボリュームを切断する

ストレージボリュームから LUN を削除する

ストレージボリュームを削除する

ブートボリュームのスナップショットを管理する

ブートボリュームのスナップショットとその詳細を表示する

ブートボリュームのスナップショットを作成する

ブートボリュームのスナップショットを削除する

ブートボリュームのスナップショットを復元する

NFS ファイルストレージを管理する

Bare Metal Solution 環境の NFS ファイルストレージを表示する

ラベルを使用して NFS ファイルストレージを整理する