サブネットワークを作成して管理する

このページでは、Distributed Cloud 接続ゾーンで Google Distributed Cloud サブネットワーク リソースを作成して管理する方法について説明します。

Distributed Cloud 接続サーバーでは、VLAN ID を使用したサブネットワークのみを構成できます。CIDR ベースのサブネットワークは、Distributed Cloud 接続サーバーではサポートされていません。

Distributed Cloud サブネットワークの詳細については、Distributed Cloud 接続の仕組みをご覧ください。

次の点にご注意ください。

  • 各ネットワーク内に最大 20 個のサブネットワークを作成できます。
  • サブネットワークは、親ネットワーク内の VLAN です。そのため、各サブネットワークにはグローバルに一意の VLAN ID が必要です。Distributed Cloud Connected では、VLAN ID の再利用はできません。
  • Distributed Cloud Connected に未使用の VLAN ID をランダムに割り当てるには、サブネットワークの作成時に VLAN ID として 0 を指定します。
  • サブネットワークは、Distributed Cloud の接続ゾーン内のすべてのノードからアクセスできます。

サブネットワークを作成

Distributed Cloud サブネットワークを作成するには、このセクションの手順を行います。

このタスクを完了するには、 Google Cloud プロジェクトに対する Edge ネットワーク管理者ロール（roles/edgenetwork.admin）が必要です。

gcloud

gcloud edge-cloud networking subnets create コマンドを使用します。

gcloud edge-cloud networking subnets create SUBNETWORK_NAME \
    --network=NETWORK_NAME \
    --ipv4-range=IPV4_RANGE \
    --vlan-id=VLAN_ID \
    --location=REGION \
    --zone=ZONE_NAME

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

  • SUBNETWORK_NAME: このサブネットワークを一意に識別する説明的な名前。
  • NETWORK_NAME: このサブネットワークをカプセル化するネットワーク。
  • IPV4_RANGE: このサブネットワークが IP アドレス/プレフィックス形式でカバーする IPv4 アドレス範囲。
  • VLAN_ID: このサブネットワークのターゲット VLAN ID。
  • REGION: ターゲットの Distributed Cloud ゾーンが属する Google Cloud リージョン。
  • ZONE_NAME: ターゲットの Distributed Cloud 接続ゾーンの名前。

API

projects.locations.zones.subnets.create メソッドに POST リクエストを送信します。

 POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets?subnetId=SUBNETWORK_ID
 {
  "labels": { LABELS,
   },
  "network": { NETWORK_NAME,
   },
  "ipv4Cidr": { IPV4_RANGE,
   },
  "vlanId": { VLAN_ID,
   },
 }

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

  • PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
  • REGION: ターゲットの Distributed Cloud 接続ゾーンが属する Google Cloud リージョン。
  • ZONE_NAME: ターゲットの Distributed Cloud 接続ゾーンの名前。
  • SUBNETWORK_ID: このサブネットワークを一意に識別する ID。
  • LABELS: このサブネットワーク リソースに適用するラベルのリスト。
  • NETWORK_NAME: このサブネットワークをカプセル化するネットワーク。
  • IPV4_RANGE: このサブネットワークが IP アドレス/プレフィックス形式でカバーする IPv4 アドレス範囲。
  • VLAN_ID: このサブネットワークのターゲット VLAN ID。

サブネットワークの一覧取得

Distributed Cloud 接続ゾーン内にプロビジョニングされたサブネットワークを一覧表示するには、このセクションの手順を行います。

このタスクを完了するには、 Google Cloud プロジェクトに対する Edge ネットワーク閲覧者ロール（roles/edgenetwork.viewer）が必要です。

gcloud

gcloud edge-cloud networking subnets list コマンドを使用します。

gcloud edge-cloud networking subnets list \
    --location=REGION \
    --zone=ZONE_NAME

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

  • REGION: ターゲットの Distributed Cloud 接続ゾーンが属する Google Cloud リージョン。
  • ZONE_NAME: ターゲットの Distributed Cloud 接続ゾーンの名前。

API

projects.locations.zones.subnets.list メソッドに GET リクエストを送信します。

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

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

  • PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
  • REGION: ターゲットの Distributed Cloud 接続ゾーンが属する Google Cloud リージョン。
  • ZONE_NAME: ターゲットの Distributed Cloud 接続ゾーンの名前。
  • FILTER: 返される結果を特定の値に制限する式。
  • PAGE_SIZE: ページごとに返す結果の数
  • SORT_BY: 返される結果の並べ替えの基準とするフィールド名のカンマ区切りリストデフォルトの並べ替え順は昇順です。降順で並べ替えるには、目的のフィールドに ~ という接頭辞を付けます。
  • PAGE_TOKEN: レスポンスの nextPageToken フィールドで、最後のリスト リクエストのレスポンスで受け取ったトークン。このトークンを送信して、結果のページを受け取ります。

サブネットワークに関する情報を取得する

Distributed Cloud サブネットワークに関する情報を取得するには、このセクションの手順を行います。

このタスクを完了するには、 Google Cloud プロジェクトに対する Edge ネットワーク閲覧者ロール（roles/edgenetwork.viewer）が必要です。

gcloud

gcloud edge-cloud networking subnets describe コマンドを使用します。

gcloud edge-cloud networking subnets describe SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

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

  • SUBNETWORK_NAME: ターゲット サブネットワークの名前。
  • REGION: ターゲットの Distributed Cloud 接続ゾーンが属する Google Cloud リージョン。
  • ZONE_NAME: ターゲットの Distributed Cloud 接続ゾーンの名前。

API

projects.locations.zones.subnets.get メソッドに GET リクエストを送信します。

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets/SUBNETWORK_ID

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

  • PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
  • REGION: ターゲットの Distributed Cloud 接続ゾーンが属する Google Cloud リージョン。
  • ZONE_NAME: ターゲットの Distributed Cloud 接続ゾーンの名前。
  • SUBNETWORK_NAME: ターゲット サブネットワークの名前。

このオペレーションは、リソースの詳細情報（プロビジョニング状態など）を返します。

  • PENDING: リソースのプロビジョニングがまだ開始されておらず、ゾーン全体にまだ伝播されていません。
  • PROVISIONING: リソースがプロビジョニングされています。ゾーン全体に伝播されるまで待つ必要があります。
  • RUNNING: リソースは正常にプロビジョニングされ、ゾーン全体に伝播されています。使用する準備が整っています。
  • FAILED: リソースのプロビジョニングが成功しませんでした。リソースはゾーン全体に伝播されていません。

サブネットワークの削除

Distributed Cloud サブネットワークを削除するには、このセクションの手順を行います。

このタスクを完了するには、 Google Cloud プロジェクトに対する Edge ネットワーク管理者ロール（roles/edgenetwork.admin）が必要です。

gcloud

gcloud edge-cloud networking subnets delete コマンドを使用します。

gcloud edge-cloud networking subnets delete SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

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

  • SUBNETWORK_NAME: ターゲット サブネットワークの名前。
  • REGION: ターゲットの Distributed Cloud 接続ゾーンが属する Google Cloud リージョン。
  • ZONE_NAME: ターゲットの Distributed Cloud 接続ゾーンの名前。

API

projects.locations.zones.subnets.delete メソッドに DELETE リクエストを送信します。

 DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/subnets/SUBNETWORK_ID

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

  • PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
  • REGION: ターゲットの Distributed Cloud 接続ゾーンが属する Google Cloud リージョン。
  • ZONE_NAME: ターゲットの Distributed Cloud 接続ゾーンの名前。
  • SUBNETWORK_NAME: ターゲット サブネットワークの名前。

次のステップ