共有 VPC のプロビジョニング

共有 VPC を使用すると、ホストプロジェクトの VPC ネットワークから、同じ組織内の別のサービスプロジェクトにサブネットをエクスポートできます。サービスプロジェクトのインスタンスは、ホストプロジェクトの共有サブネットでネットワーク接続を得ることができます。このページでは、組織にとって必要ないくつかの管理上の準備など、共有 VPC を設定して使用する方法について説明します。

割り当て、上限、適格なリソース

開始する前に、共有 VPC の概要と IAM の概要を理解しておく必要があります。具体的には、次のシナリオです。

共有 VPC に関係する割り当てと上限を把握しておきます。
共有できるリソースと共有できないリソースについて、よく理解しておきます。
ホストプロジェクトとそれに接続するすべてのサービスプロジェクトで、Compute Engine API と課金が有効になっていることを確認します。

組織の準備

管理者と IAM

組織の準備、共有 VPC ホストプロジェクトの設定、および共有 VPC ネットワークの使用を行うには、少なくとも 3 種類の管理 IAM 役割が必要です。各役割の詳細と、オプションの役割については、共有 VPC の概要の管理者と IAM のセクションをご覧ください。

共有 VPC の組織のポリシー

組織ポリシーの制約により、共有 VPC リソースをプロジェクト、フォルダ、組織レベルで保護できます。以下では、各ポリシーについて説明します。

ホストプロジェクトの誤削除の防止

ホストプロジェクトを誤って削除してしまうと、それに接続されているすべてのサービスプロジェクトが停止します。共有 VPC ホストプロジェクトになるようプロジェクトが構成されている場合は、リーエンと呼ばれる特殊なロックがプロジェクトに適用されます。リーエンが設定されていれば、プロジェクトが誤って削除されることがなくなります。リーエンは、共有 VPC から解除されると、ホストプロジェクトから自動的に削除されます。

組織管理者、または orgpolicy.policyAdmin 役割を持つその他のユーザーは、組織レベルのポリシーを定義して、リーエンの削除を行えるユーザーを、組織オーナーと resourcemanager.lienModifier 役割を持つその他のユーザーのみに限定できます。そのようにすると、組織オーナーではないプロジェクトオーナーや、resourcemanager.lienModifier 役割を持たないプロジェクトオーナーが誤って共有 VPC ホストプロジェクトを削除することを、効果的に防止できます。resourcemanager.lienModifier 役割に関連付けられている権限の詳細については、Resource Manager ドキュメントのプロジェクトにリーエンを適用するをご覧ください。

組織ポリシーは組織内のすべてのプロジェクトに適用されるため、リーエンの削除を制限するには、これらの手順を一度行うだけで済みます。

組織管理者、または orgpolicy.policyAdmin 役割を持つ IAM メンバーとして gcloud への認証を行います。ORG_ADMIN は、組織管理者の名前で置き換えます。
```
    gcloud auth login ORG_ADMIN
    
```
以下のコマンドの出力を調べて、自分の組織 ID 番号を確認します。
```
    gcloud organizations list
    
```
次のコマンドを実行して、組織に compute.restrictXpnProjectLienRemoval ポリシーを適用します。ORG_ID は、前の手順で確認した組織 ID 番号に置き換えます。
```
    gcloud beta resource-manager org-policies enable-enforce \
        --organization ORG_ID compute.restrictXpnProjectLienRemoval
    
```
組織管理者としてアカウントを保護する作業が完了したら、gcloud からログアウトします。
```
    gcloud auth revoke ORG_ADMIN
    
```

ホストプロジェクトの接続を制限する

デフォルトでは、共有 VPC 管理者は、同じ組織内の任意のホストプロジェクトに非ホストプロジェクトを接続できます。組織ポリシー管理者は、非ホストプロジェクトを接続できるホストプロジェクトを制限できます。また、フォルダまたは組織内の非ホストプロジェクトを接続できるホストプロジェクトも制限できます。詳細については、constraints/compute.restrictSharedVpcHostProject 制約をご覧ください。

サービスプロジェクトで使用できるホストプロジェクトのサブネットを制限する

デフォルトでは、共有 VPC を構成した後、サービスプロジェクトの IAM メンバーは適切な IAM 権限を持つホストプロジェクトのサブネットを使用できます。組織ポリシー管理者は、個々のユーザー権限を管理するだけでなく、ポリシーを設定して特定のプロジェクトからアクセス可能なサブネットのセットを定義できます。また、フォルダや組織内のプロジェクトからアクセス可能なサブネットのセットも定義できます。詳細については、constraints/compute.restrictSharedVpcSubnetworks の制約をご覧ください。

共有 VPC 管理者の指名

組織管理者は、1 人以上の IAM メンバーに共有 VPC 管理者とプロジェクト IAM 管理者の役割を付与できます。プロジェクト IAM 管理者の役割は、個々のサブネットだけでなく、すべてのサブネット（今後作成されるものも含む）を共有する権限を共有 VPC 管理者に付与します。この付与により、プロジェクトレベルではなく、組織レベルまたはフォルダレベルでバインディングが作成されます。そのため、IAM メンバーはプロジェクト内だけではなく、組織で定義する必要があります。

Console

組織レベルで共有 VPC 管理者の役割を付与するには

Google Cloud Console に組織管理者としてログインし、IAM ページに移動します。
[IAM] ページに移動
プロジェクトメニューから組織を選択します。
プロジェクトを選択すると、[役割] メニューに正しいエントリが表示されなくなります。
[追加] をクリックします。
[メンバー] のメールアドレスを入力します。
[役割] のプルダウンメニューで、[Compute Engine] > [Compute Shared VPC 管理者] を選択します。
注: オプションとして Compute Shared VPC 管理者役割が表示されていない場合は、組織管理者として Google Cloud Console にログインしていないか、組織全体ではなくプロジェクトを選択している可能性があります。
[別の役割を追加] をクリックします。
[役割] プルダウンで、[Resource Manager] > [プロジェクト IAM 管理者] を選択します。
[保存] をクリックします。

フォルダレベルで共有 VPC 管理者の役割を付与するには

Google Cloud Console に組織管理者としてログインし、IAM ページに移動します。
[IAM] ページに移動
プロジェクトメニューからフォルダを選択します。
プロジェクトや組織を選択すると、正しいオプションが表示されなくなります。
[メンバー] ページで、[追加] をクリックします。
[新しいメンバー] のメールアドレスを入力します。
[役割を選択] で、[Compute Engine] > [Compute Shared VPC 管理者] を選択します。
[別の役割を追加] をクリックします。
[役割] プルダウンで、[Resource Manager] > [プロジェクト IAM 管理者] を選択します。
[保存] をクリックします。

gcloud

組織管理者として、gcloud で認証します。ORG_ADMIN は、組織管理者の名前で置き換えます。
```
    gcloud auth login ORG_ADMIN
    
```
次のコマンドの出力を調べて、自分の組織 ID 番号を確認します。
```
    gcloud organizations list
    
```
組織レベルで共有 VPC 管理者の役割を割り当てる場合、次の手順を実施します。
1. 既存の IAM メンバーに共有 VPC 管理者の役割を適用します。ORG_ID は、前の手順の組織 ID 番号で置き換えます。EMAIL_ADDRESS は、共有 VPC 管理者役割に割り当てるユーザーのメールアドレスで置き換えます。
```
    gcloud organizations add-iam-policy-binding ORG_ID \
      --member='user:EMAIL_ADDRESS' \
      --role="roles/compute.xpnAdmin"
    
```
```
    gcloud organizations add-iam-policy-binding ORG_ID \
      --member='user:EMAIL_ADDRESS' \
      --role="roles/resourcemanager.projectIamAdmin"
    
```
フォルダレベルで共有 VPC 管理者の役割を割り当てる場合、次の手順を実施します。
1. このコマンドの出力を調べて、フォルダ ID を確認します。
```
    gcloud beta resource-manager folders list --organization=ORG_ID
    
```
2. 既存の IAM メンバーに共有 VPC 管理者の役割を適用します。ORG_ID は、前の手順の組織 ID 番号で置き換えます。EMAIL_ADDRESS は、共有 VPC 管理者役割に割り当てるユーザーのメールアドレスで置き換えます。
```
    gcloud beta resource-manager folders add-iam-policy-binding FOLDER_ID \
       --member='user:EMAIL_ADDRESS' \
       --role="roles/compute.xpnAdmin"
    
```
```
    gcloud beta resource-manager folders add-iam-policy-binding FOLDER_ID \
       --member='user:EMAIL_ADDRESS' \
       --role="roles/resourcemanager.projectIamAdmin"
    
```
アカウントを保護する作業が完了したら、gcloud コマンドラインツールで組織管理者のアカウントからログアウトします。
```
    gcloud auth revoke ORG_ADMIN
    
```

API

組織レベルで共有 VPC 管理者の役割を割り当てるには、次の操作を行います。
1. 組織 ID 番号を特定します。
```
    POST https://cloudresourcemanager.googleapis.com/v1/organizations
    
```
2. 既存の組織ポリシーの詳細を記述し、記録します。
```
    POST https://cloudresourcemanager.googleapis.com/v1/organizations/ORG_ID:getIamPolicy
    
```
  ORG_ID は、組織の ID で置き換えます。
3. 共有 VPC 管理者の役割を割り当てます。
```
    POST https://cloudresourcemanager.googleapis.com/v1/organizations/ORG_ID:setIamPolicy
    {
      "bindings": [
        ...copy existing bindings
        {
          "members": [
            "user:EMAIL_ADDRESS"
          ],
          "role": "roles/compute.xpnAdmin"
        },
        {
          "members": [
            "user:EMAIL_ADDRESS"
          ],
          "role": "roles/resourcemanager.projectIamAdmin"
        }
      ],
      "etag": "ETAG",
      "version": 1,
      ...other exisitng policy details
    }
    
```
  プレースホルダを有効な値に置き換えます。
  - ORG_IDは、共有 VPC 管理者役割を付与するユーザーの組織 ID です。
  - EMAIL_ADDRESS はユーザーのメールアドレスです。
  - ETAG は、既存のポリシーを記述するときに取得した固有の ID です。これにより、複数の更新リクエストが同時に送信された場合の競合を回避します。
  詳細については、organizations.setIamPolicy メソッドをご覧ください。
フォルダレベルで共有 VPC 管理者の役割を割り当てるには、次のリクエストを使用します。
1. 組織 ID 番号を特定します。
```
    POST https://cloudresourcemanager.googleapis.com/v1/organizations
    
```
2. フォルダ ID を探します。
```
    GET https://cloudresourcemanager.googleapis.com/v2/folders?parent=organizations/ORG_ID
    
```
  ORG_ID は、組織の ID で置き換えます。
3. 既存のフォルダポリシーの詳細を記述して、記録します。
```
    POST https://cloudresourcemanager.googleapis.com/v2/folders/FOLDER_ID:getIamPolicy
    
```
  FOLDER_ID はフォルダの ID に置き換えます。
4. 共有 VPC 管理者の役割を割り当てます。
```
    POST https://cloudresourcemanager.googleapis.com/v1/organizations/FOLDER_ID:setIamPolicy
    {
      "bindings": [
        ...copy existing bindings
        {
          "members": [
            "user:EMAIL_ADDRESS"
          ],
          "role": "roles/compute.xpnAdmin"
        },
        {
          "members": [
            "user:EMAIL_ADDRESS"
          ],
          "role": "roles/resourcemanager.projectIamAdmin"
        }
      ],
      "etag": "ETAG",
      "version": 1,
      ...other existing policy details
    }
    
```
  プレースホルダを有効な値に置き換えます。
  - FOLDER_IDは、共有 VPC 管理者役割を付与するユーザーの組織 ID です。
  - EMAIL_ADDRESS はユーザーのメールアドレスです。
  - ETAG は、既存のポリシーを記述するときに取得した固有の ID です。これにより、複数の更新リクエストが同時に送信された場合の競合を回避します。
  詳細については、folders.setIamPolicy メソッドをご覧ください。

共有 VPC の設定

このセクションのタスクはすべて、共有 VPC 管理者が行う必要があります。

ホストプロジェクトの有効化

共有 VPC 管理者は組織内で、割り当てと上限に従ってプロジェクトを共有 VPC ホストプロジェクトとして指定できます。手順は以下のとおりです。組織の resourcemanager.projectCreator と resourcemanager.projectDeleter の役割があれば、共有 VPC 管理者はプロジェクトの作成や削除も行うことができます。

Console

Google Cloud Console で [共有 VPC] ページに移動します。
[共有 VPC] ページに移動
共有 VPC 管理者としてログインします。
プロジェクト選択ツールから、共有 VPC ホストプロジェクトとして有効にするプロジェクトを選択します。
[共有 VPC を設定] をクリックします。
次のページの [ホストプロジェクトを有効にする] で、[保存して続行] をクリックします。
[サブネットを選択する] で、次のいずれかを行います。
1. ホストプロジェクトの VPC ネットワーク内の現在および将来のすべてのサブネットを、次の手順で指定するサービスプロジェクトおよびサービスプロジェクト管理者と共有する必要がある場合は、[すべてのサブネットを共有する（プロジェクトレベルの権限）] をクリックします。
2. ホストプロジェクトの VPC ネットワークのサブネットの一部を、サービスプロジェクトおよびサービスプロジェクト管理者と共有する必要がある場合は、[個々のサブネット（サブネットレベルの権限）] をクリックします。次に、[共有するサブネット] を選択します。
[続行] をクリックします。
その次の画面が表示されます。
[プロジェクト名] で、ホストプロジェクトに接続するサービスプロジェクトを指定します。サービスプロジェクトを接続しても、サービスプロジェクト管理者は定義されません。これは、次の手順で行います。
[役割別にユーザーを選択する] セクションで、サービスプロジェクト管理者を追加します。これらのユーザーには、共有サブネットの IAM 役割 compute.networkUser が付与されます。共有 VPC ホストプロジェクトのサブネットでリソースを作成できるのは、サービスプロジェクト管理者のみです。
[保存] をクリックします。

gcloud

共有 VPC 管理者として gcloud への認証を行います。SHARED_VPC_ADMIN を共有 VPC 管理者の名前に置き換えます。
```
    gcloud auth login SHARED_VPC_ADMIN
    
```
ホストプロジェクトにする必要のあるプロジェクトに対して、共有 VPC を有効にします。HOST_PROJECT_ID をプロジェクトの ID に置き換えます。

組織レベルで共有 VPC 管理者の役割を持っている場合
```
    gcloud compute shared-vpc enable HOST_PROJECT_ID
    
```
フォルダレベルで共有 VPC 管理者の役割を持っている場合
```
    gcloud beta compute shared-vpc enable HOST_PROJECT_ID
    
```
組織のホストプロジェクトとしてプロジェクトがリストされていることを確認します。ORG_ID を組織 ID（gcloud organizations list で確認）に置き換えます。
```
    gcloud compute shared-vpc organizations list-host-projects ORG_ID
    
```
ホストプロジェクトを有効にするだけでよい場合は、gcloud からログアウトして、共有 VPC 管理者アカウントの認証情報を保護できます。それ以外の場合、この手順をスキップして、サービスプロジェクトを接続する手順に進みます。
```
    gcloud auth revoke SHARED_VPC_ADMIN
    
```

API

プロジェクトの共有 VPC を有効にするには、共有 VPC 管理者の権限を持つ認証情報を使用します。
- 組織レベルで共有 VPC 管理者の役割が割り当てられている場合は、v1 API を使用します。
```
    POST https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/enableXpnHost
    
```
- フォルダレベルで共有 VPC 管理者の役割が割り当てられている場合は、ベータ API を使用します。
```
    POST https://www.googleapis.com/compute/beta/projects/HOST_PROJECT_ID/enableXpnHost
    
```
HOST_PROJECT_ID は、共有 VPC ホストプロジェクトにするプロジェクトの ID で置き換えます。

詳細については、projects.enableXpnHost メソッドをご覧ください。
プロジェクトがホストプロジェクトとして表示されていることを確認します。
```
    POST https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/listXpnHosts
    
```
HOST_PROJECT_ID は、共有 VPC ホストプロジェクトの ID で置き換えます。

詳細については、projects.listXpnHosts メソッドをご覧ください。

サービスプロジェクトの接続

サービスプロジェクトの管理者が共有 VPC を使用するには、サービスプロジェクトがホストプロジェクトに接続されている必要があります。共有 VPC 管理者は以下の手順に従って、接続を完了する必要があります。

サービスプロジェクトは 1 つのホストプロジェクトにのみ接続できますが、ホストプロジェクトは複数のサービスプロジェクトの接続をサポートしています。詳細については、VPC 割り当てページの共有 VPC に固有の制限をご覧ください。

Console

共有 VPC 管理者として Google Cloud Console にログインします。
Google Cloud Console で [共有 VPC] ページに移動します。
[共有 VPC] ページに移動
[接続されたプロジェクト] タブをクリックします。
[接続されたプロジェクト] タブで、[プロジェクトを接続] ボタンをクリックします。
[プロジェクト名] セクションで、接続するサービスプロジェクトのチェックボックスをオンにします。サービスプロジェクトを接続しても、サービスプロジェクト管理者は定義されません。これは、次の手順で行います。
[VPC ネットワークの権限] セクションで、compute.networkUser 役割を付与するメンバーの役割を選択します。Cloud IAM メンバーには、VPC ネットワーク共有モードに基づいて、ホストプロジェクト全体またはホストプロジェクト内の特定のサブネットに対するネットワークユーザー役割が付与されます。これらのメンバーは、それぞれのサービスプロジェクトのサービスプロジェクト管理者と呼ばれます。
[VPC ネットワーク共有モード] セクションで、次のいずれかを選択します。
1. ホストプロジェクトの VPC ネットワーク内の現在および将来のすべてのサブネットを、すべてのサービスプロジェクトおよびサービスプロジェクト管理者と共有するには、[すべてのサブネットを共有する（プロジェクトレベルの権限）] をクリックします。
2. ホストプロジェクトの VPC ネットワークからのサブネットを、サービスプロジェクトおよびサービスプロジェクト管理者と選択的に共有する必要がある場合、[個々のサブネット（サブネットレベルの権限）] をクリックします。次に、[共有するサブネット] を選択します。
[保存] をクリックします。

gcloud

まだ共有 VPC 管理者として gcloud の認証を行っていない場合は、認証を行います。SHARED_VPC_ADMIN を共有 VPC 管理者の名前に置き換えます。
```
    gcloud auth login SHARED_VPC_ADMIN
    
```
以前に有効にしたホストプロジェクトにサービスプロジェクトを接続します。SERVICE_PROJECT_ID をサービスプロジェクトのプロジェクト ID に、HOST_PROJECT_ID をホストプロジェクトのプロジェクト ID に置き換えます。

組織レベルで共有 VPC 管理者の役割を持っている場合
```
    gcloud compute shared-vpc associated-projects add SERVICE_PROJECT_ID \
        --host-project HOST_PROJECT_ID
    
```
フォルダレベルで共有 VPC 管理者の役割を持っている場合
```
    gcloud beta compute shared-vpc associated-projects add SERVICE_PROJECT_ID \
        --host-project HOST_PROJECT_ID
    
```
サービスプロジェクトが接続されていることを確認します。
```
    gcloud compute shared-vpc get-host-project SERVICE_PROJECT_ID
    
```
必要に応じて、ホストプロジェクトに接続されているサービスプロジェクトの一覧を表示できます。
```
    gcloud compute shared-vpc list-associated-resources HOST_PROJECT_ID
    
```
サービスプロジェクトを接続するだけでよい場合、gcloud からログアウトして、共有 VPC 管理者アカウントの認証情報を保護できます。それ以外の場合、この手順をスキップして、すべてのサブネットまたは一部のサブネットのみに対してサービスプロジェクト管理者を定義します。
```
    gcloud auth revoke SHARED_VPC_ADMIN
    
```

API

サービスプロジェクトを共有 VPC ホストプロジェクトに接続します。
- 組織レベルで共有 VPC 管理者の役割が割り当てられている場合は、v1 API を使用します。
```
    POST https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/enableXpnResource
    {
    "xpnResource": {
      "id": "SERVICE_PROJECT"
    }
    }
    
```
- フォルダレベルで共有 VPC 管理者の役割が割り当てられている場合は、ベータ API を使用します。
```
    POST https://www.googleapis.com/compute/beta/projects/HOST_PROJECT_ID/enableXpnResource
    {
    "xpnResource": {
      "id": "SERVICE_PROJECT"
    }
    }
    
```
プレースホルダを有効な値に置き換えます。
- HOST_PROJECT_ID は、共有 VPC ホストプロジェクトの ID です。
- SERVICE_PROJECT は、接続するサービスプロジェクトの ID です。
詳細については、projects.enableXpnResource メソッドをご覧ください。
サービスプロジェクトがホストプロジェクトに接続していることを確認します。
```
    GET https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/getXpnResources
    
```
プレースホルダを有効な値に置き換えます。
- HOST_PROJECT_ID は、共有 VPC ホストプロジェクトの ID です。
詳細については、projects.getXpnResources メソッドをご覧ください。

すべてのサブネットのサービスプロジェクト管理者

共有 VPC 管理者は、サービスプロジェクトの Cloud IAM メンバーをサービスプロジェクト管理者に割り当て、ホストプロジェクト内のすべてのサブネットへのアクセスを許可できます。この種のサービスプロジェクト管理者には、ホストプロジェクト全体に対する compute.networkUser の役割が付与されます。つまり、現在ホストプロジェクトに定義されているサブネットだけでなく、今後作成されるサブネットにもアクセスできます。

Console

Cloud Console で、サービスプロジェクトの IAM メンバーをサービスプロジェクト管理者として定義し、ホストプロジェクトのすべてのサブネットにアクセスできるようにするには、サービスプロジェクトの接続をご覧ください。

gcloud

この手順には、ホストプロジェクト内のすべてのサブネットに対するアクセス権を持つサービスプロジェクト管理者としてサービスプロジェクトから IAM メンバーを定義する方法が含まれています。この手順を行うには、事前にホストプロジェクトを有効にして、ホストプロジェクトにサービスプロジェクトを接続しておく必要があります。

まだ共有 VPC 管理者として gcloud の認証を行っていない場合は、認証を行います。SHARED_VPC_ADMIN を共有 VPC 管理者の名前に置き換えます。
```
    gcloud auth login SHARED_VPC_ADMIN
    
```
サービスプロジェクト内の IAM メンバーをサービスプロジェクト管理者にするポリシーバインディングを作成します。HOST_PROJECT_ID はホストプロジェクトのプロジェクト ID で、SERVICE_PROJECT_ADMIN はサービスプロジェクト管理者ユーザーのメールアドレスで置き換えます。
```
    gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
    --member "user:SERVICE_PROJECT_ADMIN" \
    --role "roles/compute.networkUser"
    
```
次のように --member 引数の形式を変更することで、さまざまな種類のメンバーを指定できます。
- group: を使用して、Google グループをメンバーとして指定します（メールアドレスを使用）。
- domain: を使用して、Google ドメインをメンバーとして指定します。
- serviceAccount: を使用してサービスアカウントを指定します。この使用法の詳細については、サービスプロジェクト管理者としてのサービスアカウントをご覧ください。
定義する必要のあるその他のサービスプロジェクト管理者に対して、前の手順を繰り返します。
サービスプロジェクト管理者の定義が完了している場合は、gcloud からログアウトして、共有 VPC 管理者アカウントの認証情報を保護できます。
```
    gcloud auth revoke SHARED_VPC_ADMIN
    
```

API

既存のプロジェクトポリシーの詳細を記述し、記録します。既存のポリシーと etag 値が必要です。
```
    POST https://cloudresourcemanager.googleapis.com/v2/projects/HOST_PROJECT_ID:getIamPolicy
    
```
HOST_PROJECT_ID は、共有 VPC ネットワークを含むホストプロジェクトの ID で置き換えます。
サービスプロジェクトの IAM メンバーをサービスプロジェクト管理者に指定するポリシーバインディングを作成します。
```
    POST https://cloudresourcemanager.googleapis.com/v1/projects/HOST_PROJECT_ID:setIamPolicy
    {
      "bindings": [
        ...copy existing bindings
        {
          "members": [
            MEMBER,
            ...additional members
          ],
          "role": "roles/compute.networkUser"
        },
      ],
      "etag": "ETAG",
      "version": 1,
      ...other existing policy details
    }
    
```
プレースホルダを有効な値に置き換えます。
- HOST_PROJECT_ID は、共有 VPC ネットワークを含むホストプロジェクトの ID です。
- MEMBERは、役割が関連付けられているユーザー、グループ、ドメイン、サービスアカウントなどの ID です。詳細については、Resource Manager のドキュメントで members フィールドの説明をご覧ください。
- ETAG は、既存のポリシーを記述するときに取得した固有の ID です。これにより、複数の更新リクエストが同時に送信された場合の競合を回避します。
詳細については、projects.setIamPolicy メソッドをご覧ください。

一部のサブネットのサービスプロジェクト管理者

共有 VPC 管理者は、サービスプロジェクトの IAM メンバーをサービスプロジェクト管理者に割り当て、ホストプロジェクトの一部のサブネットのみにアクセスを許可できます。このオプションを使用すると、ホストプロジェクト内の一部のサブネットのみに対する compute.networkUser 役割をサービスプロジェクト管理者に付与することで、管理者をさらに詳細に定義できます。

Console

Cloud Console で、サービスプロジェクトの IAM メンバーをサービスプロジェクト管理者として定義し、ホストプロジェクトの一部のサブネットにのみアクセスできるようにするには、サービスプロジェクトの接続をご覧ください。

gcloud

この手順には、ホストプロジェクト内の一部のサブネットのみに対するアクセス権を持つサービスプロジェクト管理者としてサービスプロジェクトから IAM メンバーを定義する方法が含まれています。管理者を定義するには、事前にホストプロジェクトを有効にして、ホストプロジェクトにサービスプロジェクトを接続しておく必要があります。

まだ共有 VPC 管理者として gcloud の認証を行っていない場合は、認証を行います。SHARED_VPC_ADMIN を共有 VPC 管理者の名前に置き換えます。
```
    gcloud auth login SHARED_VPC_ADMIN
    
```
サービスプロジェクト管理者がアクセスできる必要のあるホストプロジェクト内のサブネットを選択します。現在の IAM ポリシーを JSON 形式で取得します。SUBNET_NAME はホストプロジェクトのサブネット名で置き換え、HOST_PROJECT_ID はホストプロジェクトのプロジェクト ID で置き換えます。
```
    gcloud beta compute networks subnets get-iam-policy SUBNET_NAME \
        --region SUBNET_REGION \
        --project HOST_PROJECT_ID \
        --format json
    
```
前の手順で得た JSON 出力をコピーし、任意のファイルに保存します。わかりやすくするため、ここでは subnet-policy.json という名前のファイルに出力を保存します。
subnet-policy.json ファイルを変更します。サービスプロジェクト管理者にし、サブネットへのアクセスを許可する IAM メンバーを追加します。各 SERVICE_PROJECT_ADMIN は、サービスプロジェクトの IAM ユーザーのメールアドレスで置き換えます。
```
    {
      "bindings": [
      {
         "members": [
               "user:[SERVICE_PROJECT_ADMIN]",
               "user:[SERVICE_PROJECT_ADMIN]"
            ],
            "role": "roles/compute.networkUser"
      }
      ],
      "etag": "[ETAG_STRING]"
    }
    
```
次のようにして、ポリシーには、さまざまな種類の IAM メンバー（ユーザー以外）を指定できます。
- user: を group: に変更して、Google グループをメンバーとして指定します（メールアドレスを使用）。
- user: を domain: に変更して、Google ドメインをメンバーとして指定します。
- serviceAccount: を使用してサービスアカウントを指定します。この使用法の詳細については、サービスプロジェクト管理者としてのサービスアカウントをご覧ください。

subnet-policy.json ファイルの内容を使用して、サブネットのポリシーバインディングを更新します。

    gcloud beta compute networks subnets set-iam-policy SUBNET_NAME subnet-policy.json \
        --region SUBNET_REGION \
        --project HOST_PROJECT_ID

サービスプロジェクト管理者の定義が完了している場合は、gcloud からログアウトして、共有 VPC 管理者アカウントの認証情報を保護できます。
```
    gcloud auth revoke SHARED_VPC_ADMIN
    
```

API

既存のサブネットポリシーの詳細を記述し、記録します。既存のポリシーと etag 値が必要です。
```
    GET https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/SUBNET_REGION/subnetworks/SUBNET_NAME/getIamPolicy
    
```
プレースホルダを有効な値に置き換えます。
- HOST_PROJECT_ID は、共有 VPC ネットワークを含むホストプロジェクトの ID です。
- SUBNET_NAME は、共有するサブネットの名前です。
- SUBNET_REGION は、サブネットが配置されているリージョンです。
サブネットポリシーを更新して、ホストプロジェクトのサブネットに対するアクセス権をサービスプロジェクト管理者に付与します。
```
    POST https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/SUBNET_REGION/subnetworks/SUBNET_NAME/setIamPolicy
    {
      "bindings": [
        ...copy existing bindings
        {
          "members": [
            MEMBER,
            ...additional members
          ],
          "role": "roles/compute.networkUser"
        },
      ],
      "etag": "ETAG",
      "version": 1,
      ...other existing policy details
    }
    
```
プレースホルダを有効な値に置き換えます。
- ETAG は、既存のポリシーを記述するときに取得した固有の ID です。これにより、複数の更新リクエストが同時に送信された場合の競合を回避します。
- HOST_PROJECT_ID は、共有 VPC ネットワークを含むホストプロジェクトの ID です。
- MEMBERは、役割が関連付けられているユーザー、グループ、ドメイン、サービスアカウントなどの ID です。詳細については、Resource Manager のドキュメントで members フィールドの説明をご覧ください。
- SUBNET_NAME は、共有するサブネットの名前です。
- SUBNET_REGION は、サブネットが配置されているリージョンです。
詳細については、subnetworks.setIamPolicy メソッドをご覧ください。

サービスプロジェクト管理者としてのサービスアカウント

共有 VPC 管理者は、サービスプロジェクト管理者として、サービスプロジェクトからサービスアカウントを定義することもできます。このセクションでは、サービスプロジェクト管理者として 2 種類のサービスアカウントを定義する方法を説明します。

次の形式のユーザー管理サービスアカウント: USER_ID@SERVICE_PROJECT_ID.iam.gserviceaccount.com
次の形式の Google API サービスアカウント: SERVICE_PROJECT_NUMBER@cloudservices.gserviceaccount.com

他の IAM メンバーと同様に、サービスプロジェクト管理者（compute.networkUser）の役割は、ホストプロジェクトのすべてのサブネットまたは一部のサブネットのみに付与できます。ただし、このセクションではわかりやすくするために、ホストプロジェクトのすべてのサブネットに対するサービスプロジェクト管理者として、2 種類のサービスアカウントをそれぞれ定義する方法を説明します。

サービスプロジェクト管理者としてのユーザー管理サービスアカウント

ここでは、共有 VPC ホストプロジェクトのすべてのサブネットに対するサービスプロジェクト管理者としてユーザー管理サービスアカウントを定義する方法について説明します。

Console

共有 VPC 管理者として Google Cloud Console にログインします。
Google Cloud Console で [設定] ページに移動します。
[設定] ページに移動
プロジェクトを、サービスプロジェクト管理者として定義する必要のあるサービスアカウントを含むサービスプロジェクトに変更します。
サービスプロジェクトのプロジェクト ID をコピーします。説明をわかりやすくするため、この手順ではサービスプロジェクト ID を SERVICE_PROJECT_ID と示しています。
プロジェクトを共有 VPC ホストプロジェクトに変更します。
Google Cloud Console で [IAM] ページに移動します。
[IAM] ページに移動
[追加] をクリックします。
SERVICE_ACCOUNT_NAME@SERVICE_PROJECT_ID.iam.gserviceaccount.com を [メンバー] フィールドに追加します。SERVICE_ACCOUNT_NAME は、サービスアカウントの名前で置き換えます。
[役割] メニューから、[Compute Engine] > [Compute ネットワークユーザー] を選択します。
[追加] をクリックします。

gcloud

まだ共有 VPC 管理者として gcloud の認証を行っていない場合は、認証を行います。SHARED_VPC_ADMIN を共有 VPC 管理者の名前に置き換えます。
```
    gcloud auth login SHARED_VPC_ADMIN
    
```
サービスプロジェクトのプロジェクト ID が不明な場合、組織内のすべてのプロジェクトを一覧表示すると確認できます。この一覧には、それぞれのプロジェクト ID が示されています。
```
    gcloud projects list
    
```
サービスアカウントをサービスプロジェクト管理者にするポリシーバインディングを作成します。HOST_PROJECT_ID はホストプロジェクトのプロジェクト ID で、SERVICE_ACCOUNT_NAME はサービスアカウントの名前で置き換えます。また、SERVICE_PROJECT_ID はサービスプロジェクトの ID で置き換えます。
```
    gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
        --member "serviceAccount:SERVICE_ACCOUNT_NAME@SERVICE_PROJECT_ID.iam.gserviceaccount.com" \
        --role "roles/compute.networkUser"
    
```

API

既存のプロジェクトポリシーの詳細を記述し、記録します。既存のポリシーと etag 値が必要です。
```
    POST https://cloudresourcemanager.googleapis.com/v2/projects/HOST_PROJECT_ID:getIamPolicy
    
```
HOST_PROJECT_ID は、共有 VPC ネットワークを含むホストプロジェクトの ID で置き換えます。
サービスアカウントをサービスプロジェクト管理者として指定するポリシーバインドを作成します。
```
    POST https://cloudresourcemanager.googleapis.com/v1/projects/HOST_PROJECT_ID:setIamPolicy
    {
      "bindings": [
        ...copy existing bindings
        {
          "members": [
            "serviceAccount:SERVICE_ACCOUNT_NAME@SERVICE_PROJECT_ID.iam.gserviceaccount.com",
            ...include additional service accounts
          ],
          "role": "roles/compute.networkUser"
        },
      ],
      "etag": "ETAG",
      "version": 1,
      ...other existing policy details
    }
    
```
プレースホルダを有効な値に置き換えます。
- HOST_PROJECT_ID は、共有 VPC ネットワークを含むホストプロジェクトの ID です。
- SERVICE_ACCOUNT_NAME は、サービスアカウントの名前です。
- SERVICE_PROJECT_ID は、サービスアカウントを含むサービスプロジェクトの ID です。
- ETAG は、既存のポリシーを記述するときに取得した固有の ID です。これにより、複数の更新リクエストが同時に送信された場合の競合を回避します。
詳細については、projects.setIamPolicy メソッドをご覧ください。

サービスプロジェクト管理者としての Google API サービスアカウント

ここでは、共有 VPC ホストプロジェクトのすべてのサブネットに対するサービスプロジェクト管理者として、Google API サービスアカウントを定義する方法を説明します。共有 VPC で使用されるマネージドインスタンスグループに対して、Google API サービスアカウントをサービスプロジェクト管理者にする必要があります。インスタンスの作成のようなタスクは、この種のサービスアカウントによって実行されるからです。この関係の詳細については、マネージドインスタンスグループと IAM をご覧ください。

Console

共有 VPC 管理者として Google Cloud Console にログインします。
Google Cloud Console で [設定] ページに移動します。
[設定] ページに移動
プロジェクトを、サービスプロジェクト管理者として定義する必要のあるサービスアカウントを含むサービスプロジェクトに変更します。
サービスプロジェクトの [プロジェクト番号] をコピーします。説明をわかりやすくするため、この手順ではサービスプロジェクト番号を SERVICE_PROJECT_NUMBER と示しています。
プロジェクトを共有 VPC ホストプロジェクトに変更します。
Google Cloud Console で [IAM] ページに移動します。
[IAM] ページに移動
[追加] をクリックします。
SERVICE_PROJECT_NUMBER@cloudservices.gserviceaccount.com を [メンバー] フィールドに追加します。
[役割] メニューから、[Compute Engine] > [Compute ネットワークユーザー] を選択します。
[追加] をクリックします。

gcloud

まだ共有 VPC 管理者として gcloud の認証を行っていない場合は、認証を行います。SHARED_VPC_ADMIN を共有 VPC 管理者の名前に置き換えます。
```
    gcloud auth login SHARED_VPC_ADMIN
    
```
サービスプロジェクトのプロジェクト番号を確認します。説明をわかりやすくするため、この手順ではサービスプロジェクト番号を SERVICE_PROJECT_NUMBER と示しています。SERVICE_PROJECT_ID は、サービスプロジェクトのプロジェクト ID で置き換えます。
```
    gcloud projects describe SERVICE_PROJECT_ID --format='get(projectNumber)'
    
```
- サービスプロジェクトのプロジェクト ID が不明な場合は、組織内のすべてのプロジェクトを一覧表示すると確認できます。このリストには、それぞれのプロジェクト番号が示されています。
```
    gcloud projects list
    
```
サービスアカウントをサービスプロジェクト管理者にするポリシーバインディングを作成します。HOST_PROJECT_ID はホストプロジェクトのプロジェクト ID に、SERVICE_PROJECT_NUMBER はサービスプロジェクト番号に置き換えます。
```
    gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
        --member "serviceAccount:SERVICE_PROJECT_NUMBER@cloudservices.gserviceaccount.com" \
        --role "roles/compute.networkUser"
    
```

API

既存のプロジェクトポリシーの詳細を記述し、記録します。既存のポリシーと etag 値が必要です。
```
    POST https://cloudresourcemanager.googleapis.com/v2/projects/HOST_PROJECT_ID:getIamPolicy
    
```
HOST_PROJECT_ID は、共有 VPC ネットワークを含むホストプロジェクトの ID で置き換えます。
プロジェクトのリストを取得して、プロジェクト番号を探します。
```
    GET https://cloudresourcemanager.googleapis.com/v1/projects?filter=projectId="SERVICE_PROJECT_ID"
    
```
SERVICE_PROJECT_ID は、サービスアカウントがあるサービスプロジェクトの ID に置き換えます。
サービスアカウントをサービスプロジェクト管理者として指定するポリシーバインドを作成します。
```
    POST https://cloudresourcemanager.googleapis.com/v1/projects/HOST_PROJECT_ID:setIamPolicy
    {
      "bindings": [
        ...copy existing bindings
        {
          "members": [
            "serviceAccount:SERVICE_PROJECT_NUMBER@cloudservices.gserviceaccount.com"
          ],
          "role": "roles/compute.networkUser"
        },
      ],
      "etag": "ETAG",
      "version": 1,
      ...other existing policy details
    }
    
```
プレースホルダを有効な値に置き換えます。
- HOST_PROJECT_ID は、共有 VPC ネットワークを含むホストプロジェクトの ID です。
- SERVICE_PROJECT_NUMBER は、サービスアカウントを含むサービスプロジェクトの番号です。
- ETAG は、既存のポリシーを記述するときに取得した固有の ID です。これにより、複数の更新リクエストが同時に送信された場合の競合を回避します。
詳細については、projects.setIamPolicy メソッドをご覧ください。

共有 VPC の使用

共有 VPC 管理者がホストプロジェクトの有効化、それに対する必要なサービスプロジェクトの接続、ホストプロジェクトサブネットのすべてまたは一部に対するサービスプロジェクト管理者の定義という各タスクを完了すると、サービスプロジェクト管理者がホストプロジェクトのサブネットを使用して、サービスプロジェクト内にインスタンス、テンプレート、内部ロードバランサを作成できるようになります。

このセクションのすべてのタスクは、サービスプロジェクト管理者が行う必要があります。

共有 VPC 管理者がサービスプロジェクト管理者に付与できるのは、ホストプロジェクト全体または一部のサブネットのみに対する compute.networkUser 役割のみです。サービスプロジェクト管理者は、各サービスプロジェクトを管理するために必要なその他の役割も持つ必要があります。たとえば、サービスプロジェクト管理者をプロジェクトオーナーにすることも、プロジェクトに対して少なくとも compute.instanceAdmin 役割を持つようにすることもできます。

使用可能なサブネットの一覧表示

サービスプロジェクト管理者は、次の手順に従って、自分に権限が付与されているサブネットを一覧表示できます。

Console

Google Cloud Console で [共有 VPC] ページに移動します。
[共有 VPC] ページに移動

gcloud

まだサービスプロジェクト管理者として gcloud の認証を行っていない場合は、認証を行います。SERVICE_PROJECT_ADMIN は、サービスプロジェクト管理者の名前に置き換えます。
```
    gcloud auth login SERVICE_PROJECT_ADMIN
    
```

次のコマンドを実行します。HOST_PROJECT_ID は、共有 VPC ホストプロジェクトのプロジェクト ID で置き換えます。

    gcloud compute networks subnets list-usable --project HOST_PROJECT_ID

次の例では、project-1 ホストプロジェクトで使用可能なサブネットの一覧を取得します。

    $ gcloud compute networks subnets list-usable --project project-1

    PROJECT    REGION       NETWORK  SUBNET    RANGE          SECONDARY_RANGES
    project-1  us-west1     net-1    subnet-1  10.138.0.0/20
    project-1  us-central1  net-1    subnet-2  10.128.0.0/20  r-1 192.168.2.0/24
                                                              r-2 192.168.3.0/24
    project-1  us-east1     net-1    subnet-3  10.142.0.0/20

詳細については、SDK のドキュメントの list-usage コマンドをご覧ください。

API

ホストプロジェクトで使用可能なサブネットをリストを取得します。サービスプロジェクト管理者としてリクエストを行います。

    GET https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/aggregated/subnetworks/listUsable

HOST_PROJECT_ID は、共有 VPC ネットワークを含むホストプロジェクトの ID で置き換えます。

詳細については、subnetworks.listUsable メソッドをご覧ください。

静的内部 IP アドレスの予約

サービスプロジェクト管理者は、共有 VPC ネットワークのサブネットに内部 IP アドレスを予約できます。IP アドレス構成オブジェクトはサービスプロジェクト内で作成されますが、その値は選択した共有サブネットで使用可能なアドレス範囲から取得されます。

gcloud

まだサービスプロジェクト管理者として gcloud の認証を行っていない場合は、認証を行います。SERVICE_PROJECT_ADMIN は、サービスプロジェクト管理者の名前に置き換えます。
```
    gcloud auth login SERVICE_PROJECT_ADMIN
    
```

次のコマンドを実行します。HOST_PROJECT_ID は、共有 VPC ホストプロジェクトのプロジェクト ID で置き換えます。

    gcloud compute addresses create IP_ADDR_NAME \
    --project SERVICE_PROJECT_ID \
    --subnet projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET \
    --region=REGION

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

IP_ADDR_NAME は、IP アドレスオブジェクトの名前で置き換えます。
SERVICE_PROJECT_ID は、サービスプロジェクトの ID で置き換えます。
HOST_PROJECT_ID は、共有 VPC ホストプロジェクトの ID で置き換えます。
REGION は、共有サブネットを含むリージョンで置き換えます。
SUBNET は、共有サブネットの名前で置き換えます。

IP アドレスの作成の詳細は、SDK のドキュメントに記載されています。

API

サービスプロジェクト管理者として静的内部 IP アドレスを予約します。

    POST https://www.googleapis.com/compute/v1/projects/SERVICE_PROJECT_ID/regions/REGION/addresses
    {
      "name": "ADDRESS_NAME",
      "subnetwork": "projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME",
      "addressType": "INTERNAL"
    }

プレースホルダを有効な値に置き換えます。

ADDRESS_NAME は、予約された内部 IP アドレスの名前です。
HOST_PROJECT_ID は、共有 VPC ネットワークを含むプロジェクトの ID です。
REGION は、予約された IP アドレスが存在し、共有サブネットのあるリージョンです。
SERVICE_PROJECT_ID は、IP アドレスを予約するサービスプロジェクトの ID です。
SUBNET_NAME は、共有サブネットの名前です。

詳細については、addresses.insert メソッドをご覧ください。

インスタンスの作成

共有 VPC を使用してインスタンスを作成するときは、次の点に注意してください。

インスタンスを作成するための基本的なプロセスには、ゾーン、ネットワーク、サブネットの選択が含まれています。選択したサブネットと選択したゾーンの両方が同じリージョン内に存在する必要があります。サービスプロジェクト管理者が共有 VPC ネットワークのサブネットを使用してインスタンスを作成する場合、そのインスタンス用に選択されたゾーンは、選択したサブネットと同じリージョン内に存在する必要があります。
- 予約された静的内部 IP アドレスを持つインスタンスを作成する場合、その静的 IP アドレスが作成された時点で、サブネット（およびリージョン）は選択済みとなっています。ここでは、静的内部 IP アドレスを持つインスタンスを作成する gcloud の例について説明します。
サービスプロジェクト管理者は、権限が付与されているサブネットを使用する場合のみ、インスタンスを作成できます。使用可能なサブネットを確認するには、使用可能なサブネットのリストをご覧ください。
Google Cloud は、共有 VPC ネットワークのサブネットにインスタンスを作成するリクエストを受信すると、リクエストを送信した IAM メンバーがその共有サブネットを使用する権限を持っているかどうかを確認します。チェックが失敗した場合、インスタンスは作成されず、Google Cloud は権限エラーを返します。共有 VPC 管理者に連絡してください。

Console

Google Cloud Console の [VM インスタンス] ページに移動します。
[VM インスタンス] ページに移動
[作成] をクリックします。
インスタンスの名前を指定します。
[管理、セキュリティ、ディスク、ネットワーク、単一テナンシー] をクリックします。
[ネットワーキング] をクリックします。
[共有ネットワーク] ラジオボタンをクリックします。
インスタンスを作成する共有サブネットを選択します。
インスタンスに必要な他のパラメータを指定します。
[作成] をクリックします。

gcloud

共有 VPC ネットワークの共有サブネット内にある内部エフェメラル IP アドレスでインスタンスを作成するには、次のようにします。
```
    gcloud compute instances create INSTANCE_NAME \
    --project SERVICE_PROJECT_ID \
    --subnet projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET \
    --zone ZONE
    
```
次のように置き換えます。
- INSTANCE_NAME は、インスタンスの名前で置き換えます。
- SERVICE_PROJECT_ID は、サービスプロジェクトの ID で置き換えます。
- HOST_PROJECT_ID は、共有 VPC ホストプロジェクトの ID で置き換えます。
- REGION は、共有サブネットを含むリージョンで置き換えます。
- SUBNET は、共有サブネットの名前で置き換えます。
- ZONE は、指定されたリージョンのゾーンで置き換えます。
共有 VPC ネットワーク内の予約済み静的内部 IP アドレスを使用してインスタンスを作成するには、次のようにします。
1. ホストプロジェクトで静的内部 IP アドレスを予約します。
2. インスタンスを作成します。
```
    gcloud compute instances create INSTANCE_NAME \
    --project SERVICE_PROJECT_ID \
    --private-network-ip IP_ADDR_NAME \
    --zone ZONE
    --subnet projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET
    
```
  次のように置き換えます。
  - INSTANCE_NAME は、インスタンスの名前で置き換えます。
  - SERVICE_PROJECT_ID は、サービスプロジェクトの ID で置き換えます。
  - HOST_PROJECT_ID は、共有 VPC ホストプロジェクトの ID で置き換えます。
  - IP_ADDR_NAME は、静的 IP アドレスの名前で置き換えます。
  - ZONE は、IP_ADDR_NAME と同じリージョンのゾーンで置き換えます。
  - SUBNET は、静的内部 IP アドレスに関連付けられた共有サブネットの名前で置き換えます。

API

サービスプロジェクト管理者としてエフェメラル内部 IP アドレスを持つインスタンスを作成する場合は、サブネットのみを指定します。
```
    POST https://www.googleapis.com/compute/v1/projects/SERVICE_PROJECT_ID/zones/ZONE/instances
    {
      "machineType": "MACHINE_TYPE",
      "name": "INSTANCE_NAME",
      "networkInterfaces": [
        {
          "subnetwork": "projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
        }
      ],
      "disks": [
        {
          "boot": true,
          "initializeParams": {
            "sourceImage": "SOURCE_IMAGE"
          }
        }
      ]
    }
    
```
プレースホルダを有効な値に置き換えます。
- INSTANCE_NAME はインスタンスの名前です。
- HOST_PROJECT_ID は、共有 VPC ネットワークを含むプロジェクトの ID です。
- MACHINE_TYPE はインスタンスのマシンタイプです。
- REGION は共有サブネットを含むリージョンです。
- SERVICE_PROJECT_IDはサービスプロジェクトの ID です。
- SOURCE_IMAGEはインスタンスのイメージです。
- SUBNETは共有サブネットの名前です。
- ZONEは、指定されたリージョンのゾーンです。
詳細については、instances.insert メソッドをご覧ください。
サービスプロジェクト管理者として予約済みの内部 IP アドレスを持つインスタンスを作成する場合は、サブネットと予約済み IP アドレスの名前を指定します。
```
    POST https://www.googleapis.com/compute/v1/projects/SERVICE_PROJECT_ID/zones/ZONE/instances
    {
      "machineType": "MACHINE_TYPE",
      "name": "INSTANCE_NAME",
      "networkInterfaces": [
        {
          "subnetwork": "projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME",
          "networkIP": "projects/SERVICE_PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME"
        }
      ],
      "disks": [
        {
          "boot": true,
          "initializeParams": {
            "sourceImage": "SOURCE_IMAGE"
          }
        }
      ]
    }
    
```
プレースホルダを有効な値に置き換えます。
- ADDRESS_NAMEは、予約された内部 IP アドレスの名前です。
- INSTANCE_NAME はインスタンスの名前です。
- HOST_PROJECT_ID は、共有 VPC ネットワークを含むプロジェクトの ID です。
- MACHINE_TYPE はインスタンスのマシンタイプです。
- REGION は共有サブネットを含むリージョンです。
- SERVICE_PROJECT_IDはサービスプロジェクトの ID です。
- SOURCE_IMAGEはインスタンスのイメージです。
- SUBNETは共有サブネットの名前です。
- ZONEは、指定されたリージョンのゾーンです。
詳細については、instances.insert メソッドをご覧ください。

インスタンステンプレートの作成

共有 VPC を使用してインスタンステンプレートを作成する場合は、次の点に注意してください。

インスタンステンプレートを作成するプロセスで、ネットワークとサブネットを選択します。
- カスタムモードの共有 VPC ネットワークで使用するために作成されたテンプレートで、ネットワークとサブネットの両方を指定する必要があります。
- 自動モードの共有 VPC ネットワークで使用するために作成されたテンプレートでは、あとでサブネットを選択することもできます。このような場合、サブネットは、テンプレートを使用するいずれかのマネージドインスタンスグループと同じリージョンで自動的に選択されます（定義上、自動モードのネットワークはすべてのリージョンごとに 1 つのサブネットを持ちます）。
IAM メンバーがインスタンステンプレートを作成したときに、Google Cloud は、メンバーが指定されたサブネットを使用できるかどうかを確認する権限チェックを実行しません。この権限チェックは、テンプレートを使用しているマネージドインスタンスグループが要求されるときまで、必ず延期されます。

Console

Google Cloud Console で [インスタンステンプレート] ページに移動します。
[インスタンステンプレート] ページに移動
[インスタンステンプレートを作成] をクリックします。
インスタンステンプレートの名前を指定します。
[管理、セキュリティ、ディスク、ネットワーク、単一テナンシー] をクリックします。
[ネットワーキング] をクリックします。
[共有ネットワーク] ラジオボタンをクリックします。
インスタンステンプレートを作成する共有サブネットを選択します。
インスタンステンプレートに必要な他のパラメータを指定します。
[作成] をクリックします。

gcloud

自動モードの共有 VPC ネットワークの自動的に作成されたサブネットで使用するようにインスタンステンプレートを作成するには、次のようにします。
```
    gcloud compute instance-templates create TEMPLATE_NAME \
    --project SERVICE_PROJECT_ID \
    --network projects/HOST_PROJECT_ID/global/networks/NETWORK
    
```
次のように置き換えます。
- TEMPLATE_NAME はテンプレートの名前で置き換えます。
- SERVICE_PROJECT_ID は、サービスプロジェクトの ID で置き換えます。
- HOST_PROJECT_ID は、共有 VPC ホストプロジェクトの ID で置き換えます。
- NETWORK は共有 VPC ネットワークの名前で置き換えます。
共有 VPC ネットワーク（自動モードまたはカスタムモードのいずれか）で、手動で作成されたサブネット用にインスタンステンプレートを作成するには、次のようにします。
```
    gcloud compute instance-templates create TEMPLATE_NAME \
    --project SERVICE_PROJECT_ID \
    --region REGION \
    --subnet projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET
    
```
次のように置き換えます。
- TEMPLATE_NAME はテンプレートの名前で置き換えます。
- SERVICE_PROJECT_ID は、サービスプロジェクトの ID で置き換えます。
- HOST_PROJECT_ID は、共有 VPC ホストプロジェクトの ID で置き換えます。
- REGION は、共有サブネットを含むリージョンで置き換えます。
- SUBNET は、共有サブネットの名前で置き換えます。

API

自動モードの共有 VPC ネットワークで自動生成のサブネットを使用するインスタンステンプレートを作成するには、VPC ネットワークを指定します。
```
    POST https://www.googleapis.com/compute/v1/projects/SERVICE_PROJECT_ID/global/instanceTemplates
    {
    "properties": {
      "networkInterfaces": [
        {
          "network": "projects/HOST_PROJECT_ID/global/networks/NETWORK"
        }
      ]
    ...
    }
    
```
プレースホルダを有効な値に置き換えます。
- HOST_PROJECT_ID は、共有 VPC ネットワークを含むプロジェクトの ID です。
- SERVICE_PROJECT_IDはサービスプロジェクトの ID です。
- NETWORK は共有 VPC ネットワークの名前です。
詳細については、instanceTemplates.insert メソッドをご覧ください。
共有 VPC ネットワーク（自動モードまたはカスタムモード）で手動で作成したサブネットを使用するインスタンステンプレートを作成するには、サブネットを指定します。
```
    POST https://www.googleapis.com/compute/v1/projects/SERVICE_PROJECT_ID/global/instanceTemplates
    {
    "properties": {
      "networkInterfaces": [
        {
          "subnetwork": "projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME"
        }
      ]
    ...
    }
    
```
プレースホルダを有効な値に置き換えます。
- HOST_PROJECT_ID は、共有 VPC ネットワークを含むプロジェクトの ID です。
- REGION は共有サブネットを含むリージョンです。
- SERVICE_PROJECT_IDはサービスプロジェクトの ID です。
- SUBNET_NAME は、共有サブネットの名前です。
詳細については、instanceTemplates.insert メソッドをご覧ください。

マネージドインスタンスグループを作成する

共有 VPC を使用してマネージドインスタンスグループを作成するときは、次の点に注意してください。

共有 VPC で使用されるマネージドインスタンスグループでは、Google API サービスアカウントをサービスプロジェクト管理者にする必要があります。これは、自動スケーリングを使用した自動インスタンス作成のようなタスクが、そのサービスアカウントによって実行されるからです。
マネージドインスタンスグループを作成するための基本的なプロセスには、グループの種類と、インスタンステンプレートに応じて、ゾーンまたはリージョンを選択する作業が含まれています（ネットワークとサブネットの詳細は、インスタンステンプレートに関連付けられています）。適格なインスタンステンプレートは、マネージドインスタンスグループによって使用されているリージョンと同じリージョン内のサブネットを参照しているテンプレートのみです。
サービスプロジェクト管理者は、権限が付与されているサブネットをメンバーインスタンスが使用するマネージドインスタンスグループのみを作成できます。ネットワークとサブネットの詳細はインスタンステンプレートに関連付けられているため、サービスプロジェクト管理者が使用できるのは、使用が許可されているサブネットを参照しているテンプレートのみです。
Google Cloud は、マネージドインスタンスグループの作成リクエストを受信すると、リクエストを送信した IAM メンバーがインスタンステンプレートで指定されたサブネット（グループと同じリージョン）で使用する権限を持っているかどうかを確認します。チェックが失敗した場合、マネージドインスタンスグループは作成されず、Google Cloud は権限エラーを返します。使用可能なサブネットを一覧表示してどれを使用できるか確認し、共有 VPC 管理者に連絡してください。

詳細については、Compute Engine のドキュメントでマネージドインスタンスのグループを作成するをご覧ください。

内部 TCP / UDP ロードバランサの作成

次の例では、共有 VPC ネットワークで内部 TCP / UDP ロードバランサを作成する際の考慮事項について説明します。サービスプロジェクト管理者は、ホストプロジェクトでアクセス権のあるサブネットを使用する内部 TCP / UDP ロードバランサを作成できます。ロードバランサの内部転送ルールはサービスプロジェクトで定義されますが、サブネット参照はホストプロジェクトの共有 VPC ネットワーク内のサブネットを参照します。

共有 VPC 環境で内部 TCP / UDP ロードバランサを作成する前に、次のドキュメントを確認してください。

Console

Google Cloud Console で [負荷分散] ページに移動します。
[負荷分散] ページに移動
内部 TCP / UDP ロードバランサを作成して、次の調整を行います。[フロントエンドサービスの構成] セクションに移動し、[サブネット] メニューの [他のプロジェクトで共有されるネットワーク] セクションから必要な共有 VPC サブネットを選択します。
ロードバランサの作成を完了します。

gcloud

内部転送ルールを作成する場合は、--subnet フラグを使用してホストプロジェクトのサブネットを指定します。

    gcloud compute forwarding-rules create FR_NAME \
        --project SERVICE_PROJECT_ID \
        --load-balancing-scheme internal \
        --region REGION \
        --ip-protocol IP_PROTOCOL \
        --ports PORT,PORT,… \
        --backend-service BACKEND_SERVICE_NAME \
        --subnet projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET \
        --address INTERNAL_IP

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

FR_NAME は転送ルールの名前で置き換えます。
SERVICE_PROJECT_ID は、サービスプロジェクトの ID で置き換えます。
REGION は、共有サブネットを含むリージョンで置き換えます。
IP_PROTOCOL は、ロードバランサのバックエンドサービスのプロトコルに合わせて TCP または UDP で置き換えます。
PORT は、ロードバランサのポート番号またはポートのリストで置き換えます。
BACKEND_SERVICE_NAME は、バックエンドサービスの名前で置き換えます（このバックエンドサービスは、内部 TCP/UDP ロードバランサの作成の一般的な手順で作成されています）。
HOST_PROJECT_ID は、共有 VPC ホストプロジェクトの ID で置き換えます。
SUBNET は、共有サブネットの名前で置き換えます。
INTERNAL_IP は、共有サブネットの内部 IP アドレスで置き換えます（指定しない場合、使用可能なアドレスが選択されます）。

gcloud compute forwarding-rules create で使用可能なオプションの詳細については、こちらのページをご覧ください。

API

内部転送ルールを作成し、ホストプロジェクトのサブネットを指定します。

    POST https://www.googleapis.com/compute/v1/projects/SERVICE_PROJECT_ID/regions/REGION/forwardingRules
    {
      "name": "FR_NAME",
      "IPAddress": "IP_ADDRESS",
      "IPProtocol": "PROTOCOL",
      "ports": [ "PORT", ... ],
      "loadBalancingScheme": "INTERNAL",
      "subnetwork": "https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET",
      "network": "https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/global/networks/NETWORK_NAME",
      "backendService": "https://www.googleapis.com/compute/v1/projects/SERVICE_PROJECT_ID/regions/us-west1/backendServices/BE_NAME",
      "networkTier": "PREMIUM"
    }

プレースホルダを有効な値に置き換えます。

BE_NAME はバックエンドサービスの名前です（このバックエンドサービスは、内部 TCP/UDP ロードバランサの作成の一般的な手順で作成されています）。
FR_NAME は転送ルールの名前です。
HOST_PROJECT_ID は、共有 VPC ホストプロジェクトの ID です。
IP_ADDRESS は共有サブネットの内部 IP アドレスです。
IP_PROTOCOL は、ロードバランサのバックエンドサービスのプロトコルに応じて TCP または UDP のいずれかになります。
PORT は、ロードバランサのポート番号またはポートのリストです。
REGION は、共有サブネットを含むリージョンです。
SERVICE_PROJECT_IDはサービスプロジェクトの ID です。
SUBNET は共有サブネットの名前です。

詳細については、forwardingRules.insert メソッドをご覧ください。

次のステップ

共有 VPC の詳細について、共有 VPC の概要を参照する。
共有 VPC を使用した Kubernetes Engine クラスタの設定手順を共有 VPC を使用したクラスタの設定で確認する。
共有 VPC 設定の削除手順を共有 VPC のデプロビジョニングで確認する。

共有 VPC のプロビジョニング

割り当て、上限、適格なリソース

組織の準備

管理者と IAM

共有 VPC の組織のポリシー

ホスト プロジェクトの誤削除の防止

ホスト プロジェクトの接続を制限する

サービス プロジェクトで使用できるホスト プロジェクトのサブネットを制限する

共有 VPC 管理者の指名

Console

gcloud

API

共有 VPC の設定

ホスト プロジェクトの有効化

Console

gcloud

API

サービス プロジェクトの接続

Console

gcloud

API

すべてのサブネットのサービス プロジェクト管理者

Console

gcloud

API

一部のサブネットのサービス プロジェクト管理者

Console

gcloud

API

サービス プロジェクト管理者としてのサービス アカウント

サービス プロジェクト管理者としてのユーザー管理サービス アカウント

Console

gcloud

API

サービス プロジェクト管理者としての Google API サービス アカウント

Console

gcloud

API

共有 VPC の使用

使用可能なサブネットの一覧表示

Console

gcloud

API

静的内部 IP アドレスの予約

gcloud

API

インスタンスの作成

Console

gcloud

API

インスタンス テンプレートの作成

Console

gcloud

API

マネージド インスタンス グループを作成する

内部 TCP / UDP ロードバランサの作成

Console

gcloud

API

次のステップ

ホストプロジェクトの誤削除の防止

ホストプロジェクトの接続を制限する

サービスプロジェクトで使用できるホストプロジェクトのサブネットを制限する

ホストプロジェクトの有効化

サービスプロジェクトの接続

すべてのサブネットのサービスプロジェクト管理者

一部のサブネットのサービスプロジェクト管理者

サービスプロジェクト管理者としてのサービスアカウント

サービスプロジェクト管理者としてのユーザー管理サービスアカウント

サービスプロジェクト管理者としての Google API サービスアカウント

インスタンステンプレートの作成

マネージドインスタンスグループを作成する