このページでは、Distributed Cloud 接続ゾーンで Google Distributed Cloud サブネットワーク リソースを作成して管理する方法について説明します。
Distributed Cloud サブネットワークの詳細については、 Distributed Cloud 接続の仕組みをご覧ください。
次の点にご注意ください。
- Distributed Cloud ゾーンごとに最大 138 個のサブネットワークを作成できます。
- サブネットワークは、親ネットワーク内の VLAN です。そのため、各サブネットワークにはグローバルに一意の VLAN ID が必要です。Distributed Cloud 接続では、VLAN ID を再利用できません。
- Distributed Cloud 接続で未使用の VLAN ID をランダムに割り当てるには、サブネットワークの作成時に VLAN ID として
0を指定します。 - サブネットワークには、Distributed Cloud 接続ゾーン内のすべてのノードからアクセスできます。
サブネットワークを作成
Distributed Cloud サブネットワークを作成するには、このセクションの手順を行います。
このタスクを完了するには、プロジェクトに対する
Edge ネットワーク管理者ロール
（roles/edgenetwork.admin）が必要です。 Google Cloud
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: このサブネットワークがカバーする IPv4 アドレス範囲（IP アドレス/プレフィックス形式）。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: このサブネットワークがカバーする IPv4 アドレス範囲（IP アドレス/プレフィックス形式）。VLAN_ID: このサブネットワークのターゲット VLAN ID。
サブネットワークの一覧取得
Distributed Cloud 接続ゾーン内にプロビジョニングされたサブネットワークを一覧表示するには、このセクションの手順を行います。
このタスクを完了するには、 プロジェクトに対する
Edge ネットワーク閲覧者ロール
（roles/edgenetwork.viewer）が必要です。 Google Cloud
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 サブネットワークに関する情報を取得するには、このセクションの手順を行います。
このタスクを完了するには、 プロジェクトに対する
Edge ネットワーク閲覧者ロール
（roles/edgenetwork.viewer）が必要です。 Google Cloud
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 サブネットワークを削除するには、このセクションの手順を行います。
このタスクを完了するには、プロジェクトに対する
Edge ネットワーク管理者ロール
（roles/edgenetwork.admin）が必要です。 Google Cloud
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: ターゲット サブネットワークの名前。