静的内部 IP アドレスを予約する

コンソール

1. Google Cloud コンソールで、[IP アドレス] ページに移動します。

   [IP アドレス] に移動

2. [内部静的 IP アドレスの予約] をクリックします。このボタンを表示するには、その他の操作メニュー more_vert をクリックする必要があります。
3. [名前] フィールドに IP アドレス名を入力します。
4. [IP バージョン] リストで、必要な IP バージョンを選択します。
   • 静的内部 IPv4 アドレスを予約するには、[IPv4] を選択します。
   • 静的内部 IPv6 アドレスを予約するには、[IPv6] を選択します。
5. [ネットワーク] リストと [サブネットワーク] リストで、VPC ネットワークとサブネットをそれぞれ選択します。
6. IP アドレスの予約方法を指定します。
   • IPv4 アドレスの場合、予約する静的内部 IPv4 アドレスを指定するには、[静的 IP アドレス] に [ユーザー指定] を選択し、カスタム IP アドレスを入力します。それ以外の場合、サブネットの静的内部 IPv4 アドレスはシステムによって自動的に割り当てられます。
   • IPv6 アドレスの場合、静的内部 IPv6 アドレスはサブネットの内部 IPv6 アドレス範囲から自動的に割り当てられます。

7. 省略可: 異なるフロントエンドで静的内部 IPv4 アドレスを共有する場合は、[目的] リストで [共有] を選択します。デフォルトでは、[共有しない] が選択されています。

8. [予約] をクリックします。

gcloud

• 内部 IPv4 アドレスを予約するには、compute addresses create コマンドを使用します。

  gcloud compute addresses create ADDRESS_NAMES \
      --region REGION --subnet SUBNETWORK \
      --addresses IP_ADDRESS
  

  次のように置き換えます。

  • ADDRESS_NAMES: 作成する 1 つ以上の [--purpose=SHARED_LOADBALANCER_VIP] アドレスの名前。複数のアドレスの場合は、各アドレスをスペースで区切ったリストで指定します（例: example-address-1 example-address-2 example-address-3）。
  • REGION: このリクエストのリージョン。
  • SUBNETWORK: この内部 IP アドレスのサブネット。
  • IP_ADDRESS: 予約する IP アドレス。サブネットのプライマリ IP 範囲内になければなりません。指定しない場合、サブネットから IP アドレスが自動的に割り振られます。

• 内部 IPv6 アドレスを予約するには、compute addresses create コマンドを使用します。--ip-version の値として IPV6 を指定します。

  gcloud compute addresses create ADDRESS_NAMES \
      --region REGION --subnet SUBNETWORK \
      --ip-version IPV6
  

  次のように置き換えます。

  • ADDRESS_NAMES: 予約する 1 つ以上のアドレスの名前。複数のアドレスの場合は、各アドレスをスペースで区切ったリストで指定します（例: example-address-1 example-address-2 example-address-3）。
  • REGION: このリクエストのリージョン。
  • SUBNETWORK: この内部 IPv6 アドレスのサブネット。

  内部 IPv4 の予約とは異なり、内部 IPv6 の予約では、サブネットワークからの特定の IP アドレスの予約をサポートしていません。代わりに、/96 の内部 IPv6 アドレスは、サブネットの /64 の内部 IPv6 アドレス範囲から自動的に割り振られます。

例

• サブネットから自動的に割り振られた内部 IPv4 アドレスを予約るす場合。

  gcloud compute addresses create example-address-1 \
      --region us-central1 \
      --subnet subnet-1
  

• サブネットから特定の内部 IPv4 アドレスを予約する場合。

  gcloud compute addresses create example-address-1 \
      --region us-central1 \
      --subnet subnet-1 \
      --addresses 10.128.0.12
  

• サブネットから静的内部 IPv6 アドレスを予約する場合。

  gcloud compute addresses create example-address-1 \
      --region us-central1 \
      --subnet subnet-1 \
      --ip-version IPV6
  

• 複数の IPv4 アドレス名を渡すことで、複数の IPv4 アドレスを作成し、すべてのアドレスが同じサブネットで予約される場合。

  gcloud compute addresses create example-address-1 example-address-2 \
      --region us-central1 \
      --subnet subnet-1 \
      --addresses 10.128.0.12,10.128.0.13
  

Terraform

Terraform モジュールを使用して内部 IP アドレスを作成できます。

次の例では、Terraform の引数に変更可能なサンプル値が含まれています。この例では、2 つの内部 IP アドレスを作成します。

module "address" {
  source     = "terraform-google-modules/address/google"
  version    = "~> 4.0"
  project_id = var.project_id # Replace this with your project ID in quotes
  region     = "asia-east1"
  subnetwork = "my-subnet"
  names      = ["internal-address1", "internal-address2"]
  addresses  = ["10.0.0.3", "10.0.0.4"]
}

次の例では、動的に割り振られる 2 つの内部 IP アドレスを作成します。

module "address" {
  source     = "terraform-google-modules/address/google"
  version    = "~> 4.0"
  project_id = var.project_id # Replace this with your project ID in quotes
  region     = "asia-east1"
  subnetwork = "my-subnet"
  names      = ["internal-address1", "internal-address2"]
}

API

addresses.insert メソッドを使用します。

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

IPv4 アドレスと IPv6 アドレスの両方について、リクエストの本文には addressType フィールド（INTERNAL）、アドレスの name、subnetwork を含める必要があります。リクエストの本文には、必要に応じて内部 IP アドレスの purpose を含めることができます。

内部 IPv4 アドレスの場合は、システムによって IP アドレスが自動的に割り振られるようにすることも、address を使用して内部 IPv4 アドレスを指定することもできます。IPv4 アドレスは、サブネットのプライマリ IP 範囲内になければなりません。

{
  "addressType": "INTERNAL",
  "name": "IPV4_ADDRESS_NAME",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK",
  "address": "IPV4_ADDRESS"
  "purpose": "GCE_ENDPOINT"
}

例:

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses
{
  "addressType": "INTERNAL",
  "name": "example-ipv4-address-1",
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet",
  "address": "10.128.0.12"
  "purpose": "GCE_ENDPOINT"
}

内部 IPv6 アドレスの場合は、ipVersion を IPV6 として指定する必要があります。システムによって、サブネットの内部 IPv6 アドレス範囲から、静的内部 IPv6 アドレスが自動的に割り当てられます。

{
  "addressType": "INTERNAL",
  "name": "IPV6_ADDRESS_NAME",
  "ipVersion": "IPV6",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK",
  "purpose": "GCE_ENDPOINT"
}

例:

POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses
{
  "addressType": "INTERNAL",
  "name": "example-ipv6-address-1",
  "ipVersion": "IPV6"
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet",
  "purpose": "GCE_ENDPOINT"
}

コンソール

1. Google Cloud コンソールで、[IP アドレス] ページに移動します。

   [IP アドレス] に移動

2. [内部 IP アドレス] をクリックします。
3. （省略可）[フィルタ] フィールドに「ephemeral」と入力し、プルダウン リストから [エフェメラル: タイプ] を選択して、エフェメラル IP アドレスを検索します。
4. 昇格する内部 IP アドレスを選択します。
5. 選択した IP アドレスの表示行の末尾にあるその他の操作メニュー（more_vert）で、[静的 IP アドレスに昇格] を選択します。
6. 新しい静的 IP アドレスの名前を入力し、[予約] をクリックします。

gcloud

1. 既存のエフェメラル内部 IPv6 アドレスを昇格させる前に、その IP アドレスの値を確認する必要があります。Google Cloud CLI を使用してリソースに describe リクエストを行い、IP アドレス値を取得します。

   • IPv4 アドレスを持つインスタンスの場合は、次のコマンドを使用します。

     gcloud compute instances describe INSTANCE_NAME --zone ZONE | grep "networkIP"
     

   • IPv6 アドレスを持つインスタンスの場合は、次のコマンドを使用します。

     gcloud compute instances describe INSTANCE_NAME --zone ZONE | grep "ipv6Address"
     

   • リージョン転送ルールの場合は、次のコマンドを使用します。

     gcloud compute forwarding-rules describe FORWARDING_RULE_NAME --region REGION | grep "IPAddress"
     

     グローバル転送ルールの場合は、--region フラグではなく --global フラグを使用します。

2. アドレスを昇格させます。

   • 1 つまたは複数の既存の内部 IPv4 アドレスを昇格させるには、compute addresses create コマンドを使用し、昇格させる明示的な内部 IP アドレスを --addresses フラグに指定します。

     gcloud compute addresses create IPV4_ADDRESS_NAMES \
       --addresses IPV4_ADDRESSES \
       --region REGION \
       --prefix-length PREFIX_LENGTH \
       --subnet SUBNETWORK
     

     次のように置き換えます。

     • IPV4_ADDRESS_NAMES: IPv4 アドレスの名前。複数のアドレスを指定する場合は、アドレス名をスペースで区切ったリストで指定します（例: example-address-name-1 example-address-name-2 example-address-name-3）。IP アドレスの宣言と同じ順序で名前を宣言します。 たとえば、アドレス名を example-address-name-1 example-address-name-2 example-address-name-3、IPv4 アドレスを 192.0.2.0 192.0.2.1 192.0.2.2 として指定したとします。このシナリオでは、Compute Engine は次の方法で名前とアドレスをマッピングします。

       • example-address-name-1: 192.0.2.0
       • example-address-name-2: 192.0.2.1
       • example-address-name-3: 192.0.2.2

     • IPV4_ADDRESSES: 昇格させる IPv4 アドレス。複数のアドレスの場合は、すべてのアドレスをスペースで区切ったリストとして指定します（例: 192.0.2.0 192.0.2.1 192.0.2.2）。

     • REGION: このアドレスを予約するリージョン。

     • PREFIX_LENGTH: 省略可。IPv4 アドレス範囲のプレフィックスの長さ。値には 7～31 の整数を指定してください。このフィールドは、アドレス範囲を指定する場合にのみ指定します。指定された IPv4 アドレスが単一の IP アドレスの場合は、このフィールドを除外します。

     • SUBNETWORK: このリクエストのサブネットワーク。

   • 1 つ以上の既存の内部 IPv6 アドレスを昇格させるには、compute addresses create コマンドを使用し、--addresses フラグに昇格させる内部 IPv6 アドレスを明示的に指定します。

     gcloud compute addresses create IPV6_ADDRESS_NAMES \
      --addresses IPV6_ADDRESSES \
      --region REGION \
      --prefix-length PREFIX_LENGTH \
      --subnet SUBNETWORK
     

     次のように置き換えます。

     • IPV6_ADDRESS_NAMES: アドレスの名前。 IPv6 アドレスの宣言と同じ順序で名前を宣言します。この場合、IPV6_ADDRESS_NAME_1 は IPV6_ADDRESS_1 に対応し、IPV6_ADDRESS_NAME_2 は IPV6_ADDRESS_2 に対応します。
     • IPV6_ADDRESS_1,[IPV6_ADDRESS_2,...]: 昇格させる IPv6 アドレス（CIDR 形式）。
     • PREFIX_LENGTH_1,[PREFIX_LENGTH_2,...]: IPv6 アドレスのプレフィックス長。
     • REGION: このアドレスを予約するリージョン。
     • SUBNETWORK: このリクエストのサブネットワーク。

     内部 IPv6 アドレスは、静的内部 IPv6 アドレスに昇格した後も、既存のインスタンスに割り振られたままになります。新しく昇格した静的内部 IPv6 アドレスを別のリソースに割り振る必要がある場合は、まず既存のインスタンスから静的内部 IPv6 アドレスの割り振りを解除します。

API

addresses.insert メソッドを使用します。

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

IPv4 アドレスと IPv6 アドレスの両方について、リクエストの本文には、addressType（INTERNAL）、アドレスの name、昇格させる address、IP アドレスが属する subnetwork を含める必要があります。IPv6 アドレスの場合は、さらに、リクエストの本文で値として 96 を持つ prefixLength を含める必要があります。

• 内部 IPv4 アドレスを昇格させるリクエストの本文:

  {
  "name": "ADDRESS_NAME",
  "addressType": "INTERNAL",
  "address": "IP_ADDRESS",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK"
  }
  

  例:

  POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses
  {
  "name": "example-IPv4-address-1",
  "addressType": "INTERNAL",
  "address": "10.128.0.2",
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet"
  }
  

• 内部 IPv6 アドレスを昇格させるリクエストの本文:

  {
  "name": "ADDRESS_NAME",
  "addressType": "INTERNAL",
  "address": "IP_ADDRESS",
  "subnetwork": "regions/REGION/subnetworks/SUBNETWORK"
  "prefixLength": 96
  }
  

  次に例を示します。

  POST https://compute.googleapis.com/compute/v1/projects/example-project/regions/us-central1/addresses
  {
  "name": "example-IPv6-address-1",
  "addressType": "INTERNAL",
  "address": "fd20:0:0::",
  "subnetwork": "regions/us-central1/subnetworks/my-custom-subnet"
  "prefixLength": 96
  }
  

コンソール

1. Google Cloud コンソールで、[IP アドレス] ページに移動します。

   [IP アドレス] に移動

2. [内部 IP アドレス] をクリックします。

gcloud

gcloud compute addresses list コマンドを実行します。

gcloud compute addresses list

API

addresses.list メソッドを使用します。

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

次のように置き換えます。

• PROJECT_ID: このリクエストのプロジェクト ID
• REGION: このリクエストのリージョン名

すべてのリージョンのすべてのアドレスを一覧取得するには、addresses.aggregatedList メソッドを使用します。

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/addresses

コンソール

1. Google Cloud コンソールで、[IP アドレス] ページに移動します。

   [IP アドレス] に移動

2. [内部 IP アドレス] タブを選択します。
3. 省略可: [フィルタ] フィールドに「static」と入力し、プルダウン リストから [静的: タイプ] を選択します。
4. 解放する静的内部 IP アドレスを選択します。

5. [静的アドレスを解放] をクリックし、ダイアログの [解放] をクリックしてこの操作を確認します。

   このオプションが表示されない場合は、上部のメニューバーにある [その他の操作] メニュー（more_vert）をクリックし、リストから [静的アドレスを解放] を選択します。

gcloud

compute addresses delete コマンドを実行します。

gcloud compute addresses delete ADDRESS_NAME \
    --region REGION

次のように置き換えます。

• ADDRESS_NAME: 削除するアドレスの名前。
• REGION: アドレスが属しているリージョン。

次に例を示します。

gcloud compute addresses delete example-address-to-delete \
    --region us-west1

API

addresses.delete メソッドを使用します。

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME

次の例では、us-west1 リージョンのアドレスを削除します。

DELETE https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-west1/addresses/example-address-to-delete