VMware Engine ネットワークの作成
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 Output: 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
シェルで次のコマンドを実行して、アプリケーションのデフォルト認証情報を構成する
gcloud auth application-default login
または、サービス アカウント キー ファイルを使用する
export GOOGLE_APPLICATION_CREDENTIALS="FILE_PATH"
ライブラリの詳細については、リファレンス ページまたは GitHub のコードサンプルをご覧ください。
VMware Engine ネットワークの作成
gcloud CLI または VMware Engine API を使用して 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 ネットワークを更新する
gcloud CLI または VMware Engine API を使用して 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"