VMware Engine ネットワークの作成
このドキュメントでは、VMware Engine ポータル、gcloud CLI、または API を使用して、標準の VMware Engine ネットワークを作成する方法について説明します。複数の VMware Engine ネットワークを作成してプライベート クラウドを分離し、一意の VPC ネットワーク ピアリングを定義できます。VMware Engine ネットワークは、個別に定義したネットワーク ポリシーに従って、プライベート クラウドとの接続を処理します。
始める前に
Google Cloud CLI と API の要件
gcloud
コマンドライン ツールまたは API を使用して VMware Engine リソースを管理するには、以下で説明するようにツールを構成することをおすすめします。
gcloud
デフォルトのプロジェクト ID を設定します。
gcloud config set project PROJECT_ID
デフォルトのリージョンとゾーンを設定します。
gcloud config set compute/region REGION
gcloud config set compute/zone ZONE
gcloud vmware
ツールの詳細については、Cloud SDK リファレンス ドキュメントをご確認ください。
API
このドキュメント セットの API の例では、cURL
コマンドライン ツールを使用して API がクエリされています。cURL
リクエストには、有効なアクセス トークンが必要です。有効なアクセス トークンを取得するにはさまざまな方法があります。次の手順では、gcloud
ツールを使用してアクセス トークンを生成します。
Google Cloud にログインします。
gcloud auth login
アクセス トークンを生成して TOKEN にエクスポートします。
export TOKEN=`gcloud auth print-access-token`
TOKEN が正しく設定されていることを確認します。
echo $TOKEN
API へのリクエストで認証トークンを使用します。次に例を示します。
curl -X GET -H "Authorization: Bearer \"$TOKEN\"" -H "Content-Type: application/json; charset=utf-8" https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations
Python
このドキュメントの Python コードサンプルは、VMware Engine ライブラリを使用して API と通信します。このアプローチを使用するには、ライブラリをインストールし、アプリケーションのデフォルト認証情報を構成する必要があります。
Python ライブラリをダウンロードしてインストールします。
pip install google-cloud-vmwareengine
シェルで次のコマンドを実行して、ADC 情報を構成します。
gcloud auth application-default login
または、サービス アカウント キー ファイルを使用します。
export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"
ライブラリの詳細については、リファレンス ページまたは GitHub のコードサンプルをご覧ください。
VMware Engine ネットワークの作成
Google Cloud コンソール、gcloud CLI、または VMware Engine API を使用して VMware Engine ネットワークを作成します。
コンソール
VMware Engine を使用して VMware Engine ネットワークを作成するには:
Google Cloud コンソールで、[VMware Engine ネットワーク] ページに移動します。
[作成] をクリックします。VMware Engine ネットワーク作成フォームが開きます。
VMware Engine ネットワーク名を入力します。
ネットワークの説明(「My standard VEN 1」など)を入力し、[作成] をクリックします。
省略可: [VMware Engine ネットワーク] メニュー項目に移動して、ネットワークの作成を確認します。すべての VMware Engine ネットワークがこのページの表に一覧表示されています。
以下に、ネットワーク作成時の各フィールドの詳細を示します。
- 名前: VMware Engine ネットワークの永続的な一意の識別子。
- 説明: VMware Engine ネットワークの詳細ページに表示される追加情報。
- ネットワークの種類: ネットワークのユースケースと従来のプライベート クラウドのデプロイをサポートするために使用されるネットワーク タイプの識別子です。
リージョン: これは、標準の VMware Engine ネットワークとレガシー VMware Engine ネットワークのどちらを使用するかによって異なります。
- 以前のネットワークの場合、これはネットワークが接続性を持つリージョンです。
- 標準ネットワークの場合、このフィールドは常にグローバルに設定されます。
gcloud
gcloud CLI を使用して VMware Engine ネットワークを作成するには:
gcloud vmware networks create
コマンドを実行します。gcloud vmware networks create NETWORK_ID \ --type=STANDARD \ --description="DESCRIPTION"
以下のように置き換えます。
NETWORK_ID
: このリクエストのネットワーク名。DESCRIPTION
: このネットワークの説明。
省略可: 新しいネットワークの作成を確認するために、すべての VMware Engine ネットワークを一覧表示する場合は、
gcloud vmware networks list
コマンドを使用します。gcloud vmware networks list \ --location=global
API
VMware Engine API を使用して VMware Engine ネットワークを作成するには、次の操作を行います。
VMware Engine ネットワークを作成するには、
POST
リクエストを行います。POST "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/vmwareEngineNetworks?vmware_engine_network_id=NETWORKD_ID" '{ "type": "standard", "description": "DESCRIPTION" }'
以下のように置き換えます。
PROJECT_ID
: このリクエストのプロジェクト ID。NETWORK_ID
: このリクエストのネットワーク名。DESCRIPTION
: このネットワークの説明。
省略可: すべての VMware Engine ネットワークを一覧表示して新しいネットワークの作成を確認するには、
GET
リクエストを行います。PROJECT_ID
は、このリクエストのプロジェクト ID で置き換えます。GET https://vmwareengine.googleapis.com/v1/projects/
/locations/global/vmwareEngineNetworks
VMware Engine ネットワークを更新する
Google Cloud コンソール、gcloud CLI、または VMware Engine API を使用して VMware Engine ネットワークを更新します。
コンソール
Google Cloud コンソールで、[VMware Engine ネットワーク] ページに移動します。
更新するネットワークの名前をクリックします。
ネットワークの詳細ページで、説明を編集し、[保存] をクリックします。
省略可: 更新された説明を表示するには、[VMware Engine ネットワーク] メニュー項目に移動し、ネットワークをクリックして詳細を表示します。
gcloud
gcloud CLI を使用して VMware Engine ネットワークを更新するには、次の手順を行います。
gcloud vmware networks update
コマンドを実行して、VMware Engine ネットワークの説明を更新します。gcloud vmware networks update NETWORK_ID \ --description='DESCRIPTION'
以下のように置き換えます。
NETWORK_ID
: このリクエストのネットワーク名。DESCRIPTION
: このネットワークの更新された説明。
省略可: 更新された属性を表示するには、
gcloud vmware networks describe
コマンドを使用します。gcloud vmware networks describe NETWORK_ID
NETWORK_ID
は、このリクエストのネットワーク名に置き換えます。
API
VMware Engine API を使用して VMware Engine ネットワークを更新するには、次の操作を行います。
VMware Engine ネットワークの説明を更新するには、
PATCH
リクエストを行います。PATCH "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/vmwareEngineNetworks/NETWORK_ID?update_mask=description" '{ "description":"DESCRIPTION" }'
以下のように置き換えます。
PROJECT_ID
: このリクエストのプロジェクトLOCATION
: ネットワークのロケーション(レガシー ネットワークの場合はglobal
、標準ネットワークの場合はリージョン)。NETWORK_ID
: このリクエストのネットワーク名。DESCRIPTION
: このネットワークの更新された説明。
省略可: 更新された属性を表示するには、
GET
リクエストを行います。GET "https://vmwareengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/vmwareEngineNetworks/NETWORK_ID"