ターゲットプロキシの使用

ターゲットプロキシは 1 つ以上の転送ルールから参照されます。外部 HTTP(S) ロードバランサと内部 HTTP(S) ロードバランサの場合、プロキシは受信リクエストを URL マップに転送します。SSL プロキシロードバランサ、TCP プロキシロードバランサの場合、ターゲットプロキシは受信リクエストを直接バックエンドサービスに転送します。

ターゲットプロキシのプロパティ

REST API でのターゲットプロキシ操作時に使用できるプロパティとメソッドについては、次のページをご覧ください。

gcloud コマンドラインツールを使用したターゲットプロキシの操作時に使用できるプロパティとメソッドの説明については、次のページをご覧ください。

ターゲットプロキシの追加

次の種類の負荷分散用のターゲットプロキシを追加できます。

外部 HTTP(S) 負荷分散
内部 HTTP(S) 負荷分散
SSL プロキシ負荷分散
TCP プロキシ負荷分散

外部 HTTP(S) ロードバランサの場合

グローバルターゲット HTTP(S) プロキシを追加するには、次の手順に従います。

Console: HTTP

[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] ページに移動
[ターゲットプロキシを作成] をクリックします。
[名前] を入力します。
（省略可）[説明] を入力します。
[種類] に HTTP Proxy を選択します。
[URL マップ] を選択します。
[作成] をクリックします。

Console: HTTPS

[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] ページに移動
[ターゲットプロキシを作成] をクリックします。
[名前] を入力します。
（省略可）[説明] を入力します。
[種類] に HTTPS Proxy を選択します。
プライマリ SSL 証明書として使用する SSL 証明書リソースがすでに存在する場合は、[証明書] プルダウンメニューからそれを選択します。使用するリソースが存在しない場合は、[新しい証明書の作成] を選択します。
1. [名前] を入力します。
2. 次のファイルをアップロードするか（推奨）、ファイルの内容をコピーして適切なフィールドに貼り付けます。
  - 公開鍵証明書（.crt ファイル）
  - 証明書チェーン（.csr ファイル）
  - 秘密鍵（key ファイル）
前述の手順を繰り返して、追加証明書を追加します。
[URL マップ] を選択します。
[作成] をクリックします。

gcloud: HTTP

gcloud compute target-http-proxies create HTTP_PROXY_NAME \
  --global \
  --url-map URL_MAP \
  --global-url-map \
  [--description DESCRIPTION]

gcloud: HTTPS

次のコマンドを実行する前に、各証明書の SSL 証明書リソースを作成する必要があります。

 gcloud compute target-https-proxies create HTTPS_PROXY_NAME \
   --global \
   --url-map URL_MAP \
   --global-url-map \
   --ssl-certificates SSL_CERT_1[,SSL_CERT_2,...] \
   --global-ssl-certificates \
   [--ssl-policy POLICY_NAME] \
   [--quic-override=ENABLE|DISABLE|NONE]

API: HTTP

POST https://www.googleapis.com/v1/compute/projects/PROJECT_ID/global/targetHttpProxies

{
  "name": HTTP_PROXY_NAME,
  "urlMap": /projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME
}

API: HTTPS

POST https://www.googleapis.com/v1/compute/projects/PROJECT_ID/global/targetHttpsProxies

{
  "name": HTTPS_PROXY_NAME,
  "urlMap": /projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME,
  "sslCertificates": /projects/PROJECT_ID/global/sslCertificates/SSL_CERT_NAME
}

内部 HTTP(S) ロードバランサの場合

リージョンターゲット HTTP(S) プロキシを追加するには、次の手順に従います。

Console

Cloud Console を使用したスタンドアロンのリージョンターゲット HTTP(S) プロキシの作成はサポートされていません。

gcloud: HTTP

gcloud compute target-http-proxies create HTTP_PROXY_NAME \
    --url-map URL_MAP \
    --url-map-region REGION \
    --region REGION \
    [--description DESCRIPTION]

gcloud: HTTPS

次のコマンドを実行する前に、各証明書の SSL 証明書リソースを作成する必要があります。

 gcloud compute target-https-proxies create HTTPS_PROXY_NAME \
     --url-map URL_MAP \
     --url-map-region REGION \
     --region REGION \
     --ssl-certificates SSL_CERT_NAME \
     --ssl-certificates-region REGION

API: HTTP

POST https://www.googleapis.com/v1/compute/projects/PROJECT_ID/regions/REGION/targetHttpProxies

{
  "name": HTTP_PROXY_NAME,
  "urlMap": /projects/PROJECT_ID/regions/REGION/urlMaps/URL_MAP_NAME,
  "region": REGION
}

API: HTTPS

POST https://www.googleapis.com/v1/compute/projects/PROJECT_ID/region/REGION/targetHttpsProxies

{
  "name": HTTPS_PROXY_NAME,
  "urlMap": /projects/PROJECT_ID/regions/REGION/urlMaps/URL_MAP_NAME,
  "region": REGION
  "sslCertificates": /projects/PROJECT_ID/regions/REGION/sslCertificates/SSL_CERT_NAME
}

SSL プロキシロードバランサの場合

グローバルターゲット SSL プロキシを追加するには、次の手順を実施します。

Console

[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] ページに移動
[ターゲットプロキシを作成] をクリックします。
[名前] を入力します。
（省略可）[説明] を入力します。
[種類] に SSL Proxy を選択します。
プライマリ SSL 証明書として使用する SSL 証明書リソースがすでに存在する場合は、[証明書] プルダウンメニューからそれを選択します。使用するリソースが存在しない場合は、[新しい証明書の作成] を選択します。
1. [名前] を入力します。
2. 次のファイルをアップロードするか（推奨）、ファイルの内容をコピーして適切なフィールドに貼り付けます。
  - 公開鍵証明書（.crt ファイル）
  - 証明書チェーン（.csr ファイル）
  - 秘密鍵（key ファイル）
前述の手順を繰り返して、追加証明書を追加します。
バックエンドサービスを選択します。
（省略可）プロキシプロトコルを有効にします。
[作成] をクリックします。

gcloud

次のコマンドを実行する前に、各証明書の SSL 証明書リソースを作成する必要があります。

 gcloud compute target-ssl-proxies create SSL_PROXY_NAME \
   --backend-service BACKEND_SERVICE \
   --ssl-certificates SSL_CERT_1[,SSL_CERT_2,...] \
   [--ssl-policy POLICY_NAME] \
   [--quic-override=ENABLE|DISABLE|NONE] \
   [--proxy-header=(NONE | PROXY_V1)]

API

POST https://www.googleapis.com/v1/compute/projects/PROJECT_ID/global/targetSslProxies

{
  "name": SSL_PROXY_NAME,
  "proxyHeader": ("NONE" | "PROXY_V1"),
  "service": "projects/PROJECT/global/backendServices/BACKEND_SERVICE"
  "sslCertificates": /projects/PROJECT_ID/global/sslCertificates/SSL_CERT_NAME
}

TCP プロキシロードバランサの場合

グローバルターゲット TCP プロキシを追加するには、次の手順を実施します。

Console

[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] ページに移動
[ターゲットプロキシを作成] をクリックします。
[名前] を入力します。
（省略可）[説明] を入力します。
[種類] に TCP Proxy を選択します。
バックエンドサービスを選択します。
（省略可）プロキシプロトコルを有効にします。
[作成] をクリックします。

gcloud

 gcloud compute target-tcp-proxies create TCP_PROXY_NAME \
   --backend-service BACKEND_SERVICE \
   --proxy-header=(NONE | PROXY_V1)

API

POST https://www.googleapis.com/v1/compute/projects/PROJECT_ID/global/targetTcpProxies

{
  "name": TCP_PROXY_NAME,
  "proxyHeader": ("NONE" | "PROXY_V1"),
  "service": "projects/PROJECT/global/backendServices/BACKEND_SERVICE"
}

ターゲットプロキシの一覧表示

ターゲットプロキシを一覧表示するには、次の手順を実施します。

外部 HTTP(S) ロードバランサの場合

Console

[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] ページに移動

gcloud: HTTP

gcloud compute target-http-proxies list --global

gcloud: HTTPS

gcloud compute target-https-proxies list --global

API: HTTP

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetHttpProxies

API: HTTPS

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetHttpsProxies

内部 HTTP(S) ロードバランサの場合

Console

[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] ページに移動

gcloud: HTTP

gcloud compute target-http-proxies list \
    --filter="region:(COMMA_DELIMITED_LIST_OF_REGIONS)"

gcloud: HTTPS

gcloud compute target-https-proxies list \
   --filter="region:(COMMA_DELIMITED_LIST_OF_REGIONS)"

API: HTTP

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetHttpProxies

API: HTTPS

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetHttpsProxies

SSL プロキシロードバランサの場合

Console

[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] ページに移動

gcloud

gcloud compute target-ssl-proxies list

API

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetSslProxies

TCP プロキシロードバランサの場合

Console

[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] ページに移動

gcloud

gcloud compute target-tcp-proxies list

API

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetTcpProxies

ターゲットプロキシに関する情報の取得

1 つのターゲット HTTP プロキシまたは HTTPS プロキシに関する情報を取得するには、次の手順を実施します。

外部 HTTP(S) ロードバランサの場合

Console

[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] ページに移動
[ターゲット名] を選択します。
[ターゲットの詳細] 画面を表示します。[負荷分散] 画面に戻るには、画面の上部にある左向き矢印をクリックします。

gcloud: HTTP

gcloud compute target-http-proxies describe HTTP_PROXY_NAME \
   --global

gcloud: HTTPS

gcloud compute target-https-proxies describe HTTPS_PROXY_NAME \
   --global

API: HTTP

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetHttpProxies/HTTP_PROXY_NAME

API: HTTPS

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetHttpsProxies/HTTPS_PROXY_NAME

内部 HTTP(S) ロードバランサの場合

Console

[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] ページに移動
[ターゲット名] を選択します。
[ターゲットの詳細] 画面を表示します。[負荷分散] 画面に戻るには、画面の上部にある左向き矢印をクリックします。

gcloud: HTTP

gcloud compute target-http-proxies describe HTTP_PROXY_NAME \
   --region=REGION

gcloud: HTTPS

gcloud compute target-https-proxies describe HTTPS_PROXY_NAME \
   --region=REGION

API: HTTP

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetHttpProxies/HTTP_PROXY_NAME

API: HTTPS

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetHttpsProxies/HTTPS_PROXY_NAME

SSL プロキシロードバランサの場合

Console

[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] ページに移動
[ターゲット名] を選択します。
[ターゲットの詳細] 画面を表示します。[負荷分散] 画面に戻るには、画面の上部にある左向き矢印をクリックします。

gcloud

gcloud compute target-ssl-proxies describe SSL_PROXY_NAME

API

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetSslProxies/SSL_PROXY_NAME

TCP プロキシロードバランサの場合

Console

[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] ページに移動
[ターゲット名] を選択します。
[ターゲットの詳細] 画面を表示します。[負荷分散] 画面に戻るには、画面の上部にある左向き矢印をクリックします。

gcloud

gcloud compute target-tcp-proxies describe TCP_PROXY_NAME

API

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetTcpProxies/TCP_PROXY_NAME

別の URL マップを指し示すようにターゲットプロキシを更新する

ターゲットプロキシを更新して、別の URL マップを指し示すようにするには、次の手順を実施します。

外部 HTTP(S) ロードバランサの場合

ターゲットプロキシに関連付けられた URL マップを更新するには、次の手順を実施します。

Console

HTTP(S) プロキシは Cloud Console では編集できません。編集する代わりに、ターゲットプロキシを削除してから再度追加してください。また、gcloud または API を使用してターゲットプロキシを編集することもできます。

gcloud: HTTP

gcloud compute target-http-proxies update HTTP_PROXY_NAME \
    --url-map URL_MAP \
    --global \
    --global-url-map

gcloud: HTTPS

gcloud compute target-https-proxies update HTTPS_PROXY_NAME \
    --url-map URL_MAP \
    --global \
    --global-url-map

API: HTTP

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetHttpProxies/HTTP_PROXY_NAME/setUrlMap

{
  "urlMap": /projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME
}

API: HTTPS

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetHttpsProxies/HTTPS_PROXY_NAME/setUrlMap

{
  "urlMap": "urlMap": /projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME
}

内部 HTTP(S) ロードバランサの場合

ターゲットプロキシに関連付けられた URL マップを更新するには、次の手順を実施します。

Console

gcloud: HTTP

gcloud compute target-http-proxies update HTTP_PROXY_NAME \
    --url-map URL_MAP \
    --region=REGION \
    --url-map-region=REGION

gcloud: HTTPS

gcloud compute target-https-proxies update HTTPS_PROXY_NAME \
    --url-map URL_MAP \
    --region=REGION \
    --url-map-region=REGION

API: HTTP

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetHttpProxies/HTTP_PROXY_NAME/setUrlMap

{
  "urlMap": /projects/PROJECT_ID/regions/REGIONurlMaps/URL_MAP_NAME
}

API: HTTPS

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetHttpsProxies/HTTPS_PROXY_NAME/setUrlMap

{
  "urlMap": /projects/PROJECT_ID/regions/REGION/urlMaps/URL_MAP_NAME
}

ターゲット HTTPS プロキシの SSL 証明書リソースの更新

この手順を使用して、HTTPS プロキシの SSL 証明書を置き換えます。必要な SSL 証明書リソースがすでに作成されている必要があります。

Console

Google Cloud Console の [負荷分散] ページに移動します。

[負荷分散] ページに移動
ロードバランサの隣にある [編集] をクリックします。
[フロントエンドの構成] をクリックします。
[証明書] プルダウンメニューで、新しい証明書を選択します。
証明書をさらに追加する場合は、Add certificate をクリックします。
[完了] をクリックします。

gcloud

ターゲット HTTPS プロキシごとに、SSL 証明書のドキュメント番号を構成できます。

gcloud compute target-https-proxies update PROXY_NAME \
    --ssl-certificates=SSL_CERT_1,SSL_CERT_2,...

API: HTTPS

DELETE [https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetHttpsProxies/HTTPS_PROXY_NAME]

POST [https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetHttpsProxies]

{
  "name": HTTPS_PROXY_NAME,
  "sslCertificates": [
    SSL_CERT_1,SSL_CERT_2
  ]
}

ターゲットプロキシの削除

ターゲット HTTP または HTTPS プロキシを削除するには、次の手順を実施します。

外部 HTTP(S) ロードバランサの場合

Console

[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] を選択します。
削除する [ターゲット名] のチェックボックスをクリックします。
[削除] をクリックします。

gcloud: HTTP

gcloud compute target-http-proxies delete HTTP_PROXY_NAME \
   --global

gcloud: HTTPS

gcloud compute target-https-proxies delete HTTPS_PROXY_NAME \
   --global

API: HTTP

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetHttpProxies/HTTP_PROXY_NAME

API: HTTPS

DELETE https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetHttpsProxies/HTTPS_PROXY_NAME

内部 HTTP(S) ロードバランサの場合

Console

[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] を選択します。
削除する [ターゲット名] のチェックボックスをクリックします。
[削除] をクリックします。

gcloud: HTTP

gcloud compute target-http-proxies delete HTTP_PROXY_NAME \
   --region=REGION

gcloud: HTTPS

gcloud compute target-https-proxies delete HTTPS_PROXY_NAME \
   --region=REGION

API: HTTP

DELETE https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetHttpProxies/HTTP_PROXY_NAME

API: HTTPS

DELETE https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/targetHttpsProxies/HTTPS_PROXY_NAME

SSL プロキシロードバランサの場合

Console

[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] を選択します。
削除する [ターゲット名] のチェックボックスをクリックします。
[削除] をクリックします。

gcloud

gcloud compute target-ssl-proxies delete SSL_PROXY_NAME

API

DELETE https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetSslProxies/SSL_PROXY_NAME

TCP プロキシロードバランサの場合

Console

[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] ページに移動
[ターゲットプロキシ] を選択します。
削除する [ターゲット名] のチェックボックスをクリックします。
[削除] をクリックします。

gcloud

gcloud compute target-tcp-proxies delete TCP_PROXY_NAME

API

DELETE https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/targetTcpProxies/TCP_PROXY_NAME

QUIC プロトコル設定の更新

ターゲット HTTPS プロキシでは、オプションのフラグ --quic-override を設定することによって QUIC 転送プロトコルの使用をサポートされます。

Console: HTTPS

QUIC ネゴシエーションの設定は現在、[ターゲットプロキシ] ページでサポートされていません。負荷分散リソースの構成に示すように、新しいロードバランサを設定する際には、Cloud Console を使用して QUIC 設定を構成できます。

gcloud: HTTPS

次のコマンドを実行する前に、各証明書の SSL 証明書リソースを作成する必要があります。

 gcloud compute target-https-proxies create HTTPS_PROXY_NAME \
   --global \
   --quic-override=QUIC_SETTING

ここで、QUIC_SETTING は次のいずれかです。

NONE（デフォルト）: QUIC がネゴシエートされる際に、Google が制御できるようにします。現在、NONE を選択すると QUIC は無効になります。このオプションを選択することで、今後このロードバランサの QUIC ネゴシエーションと HTTP/3 は自動的に有効になります。Cloud Console で、このオプションは自動（デフォルト）と呼ばれます。
ENABLED: ロードバランサが QUIC をクライアントとネゴシエートできるようにします。
DISABLED: ロードバランサが QUIC をクライアントとネゴシエートできないようにします。

API: HTTPS

POST https://www.googleapis.com/v1/compute/projects/PROJECT_ID/global/targetHttpsProxies/TARGET_PROXY_NAME/setQuicOverride

{
  "quicOverride": QUIC_SETTING
}

ここで、QUIC_SETTING は次のいずれかです。

NONE（デフォルト）: QUIC がネゴシエートされる際に、Google が制御できるようにします。現在、NONE を選択すると QUIC は無効になります。このオプションを選択することで、今後このロードバランサの QUIC ネゴシエーションと HTTP/3 は自動的に有効になります。Cloud Console で、このオプションは自動（デフォルト）と呼ばれます。
ENABLED: ロードバランサが QUIC をクライアントとネゴシエートできるようにします。
DISABLED: ロードバランサが QUIC をクライアントとネゴシエートできないようにします。

次のステップ

QUIC 転送プロトコルの詳細については、HTTPS 負荷分散の QUIC プロトコルサポートをご覧ください。
ターゲットプロキシが指し示している SSL 証明書を更新するには、以下をご覧ください。
- セルフマネージド SSL 証明書の置き換え
- Google マネージド SSL 証明書の置き換え

ターゲット プロキシの使用

ターゲット プロキシのプロパティ

ターゲット プロキシの追加

外部 HTTP(S) ロードバランサの場合

Console: HTTP

Console: HTTPS

gcloud: HTTP

gcloud: HTTPS

API: HTTP

API: HTTPS

内部 HTTP(S) ロードバランサの場合

Console

gcloud: HTTP

gcloud: HTTPS

API: HTTP

API: HTTPS

SSL プロキシ ロードバランサの場合

Console

gcloud

API

TCP プロキシ ロードバランサの場合

Console

gcloud

API

ターゲット プロキシの一覧表示

外部 HTTP(S) ロードバランサの場合

Console

gcloud: HTTP

gcloud: HTTPS

API: HTTP

API: HTTPS

内部 HTTP(S) ロードバランサの場合

Console

gcloud: HTTP

gcloud: HTTPS

API: HTTP

API: HTTPS

SSL プロキシ ロードバランサの場合

Console

gcloud

API

TCP プロキシ ロードバランサの場合

Console

gcloud

API

ターゲット プロキシに関する情報の取得

外部 HTTP(S) ロードバランサの場合

Console

gcloud: HTTP

gcloud: HTTPS

API: HTTP

API: HTTPS

内部 HTTP(S) ロードバランサの場合

Console

gcloud: HTTP

gcloud: HTTPS

API: HTTP

API: HTTPS

SSL プロキシ ロードバランサの場合

Console

gcloud

API

TCP プロキシ ロードバランサの場合

Console

gcloud

API

別の URL マップを指し示すようにターゲット プロキシを更新する

外部 HTTP(S) ロードバランサの場合

Console

gcloud: HTTP

gcloud: HTTPS

API: HTTP

API: HTTPS

内部 HTTP(S) ロードバランサの場合

Console

gcloud: HTTP

gcloud: HTTPS

API: HTTP

API: HTTPS

ターゲット HTTPS プロキシの SSL 証明書リソースの更新

ターゲットプロキシの使用

ターゲットプロキシのプロパティ

ターゲットプロキシの追加

SSL プロキシロードバランサの場合

TCP プロキシロードバランサの場合

ターゲットプロキシの一覧表示

SSL プロキシロードバランサの場合

TCP プロキシロードバランサの場合

ターゲットプロキシに関する情報の取得

SSL プロキシロードバランサの場合

TCP プロキシロードバランサの場合

別の URL マップを指し示すようにターゲットプロキシを更新する

ターゲットプロキシの削除

SSL プロキシロードバランサの場合

TCP プロキシロードバランサの場合