相互接続のアタッチメントを作成して管理する

このページでは、Distributed Cloud 接続ゾーンで Google Distributed Cloud 相互接続アタッチメント リソースを作成して管理する方法について説明します。

この機能は、Distributed Cloud 接続ラックでのみ使用できます。 Distributed Cloud 接続サーバーは、相互接続アタッチメント リソースをサポートしていません。

Distributed Cloud 相互接続 アタッチメントの詳細については、Distributed Cloud の仕組みをご覧ください。

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

  • 相互接続アタッチメントとその対応するルーターを同時に作成することをおすすめします。詳細については、 ルーターを作成するをご覧ください。
  • 必要に応じて、相互接続アタッチメントを通過するパケットにタグを付ける VLAN ID を指定できます。
  • パケット タギングに指定する VLAN ID は、相互接続アタッチメントに対してローカルです。つまり、特定の相互接続アタッチメントは、他の相互接続に関連付けられた相互接続アタッチメントや、相互接続アタッチメントに関連付けられていないサブネットワークと同じレイヤ 2 ドメインの一部ではありません。したがって、パケット タギングに指定する VLAN ID は、ターゲット相互接続で作成されたすべての相互接続アタッチメントで一意である必要がありますが、他の相互接続や、相互接続アタッチメントに関連付けられていないサブネットワークで再利用できます。

相互接続のアタッチメントを作成

Distributed Cloud 相互接続アタッチメントを作成するには、このセクションの手順を行います。

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

gcloud

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

gcloud edge-cloud networking interconnects attachments dedicated create ATTACHMENT_NAME \
    --interconnect=INTERCONNECT_NAME \
    --network=NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME \
    --vlan-id=VLAN_ID \
    --mtu=MTU_SIZE

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

  • ATTACHMENT_NAME: この相互接続アタッチメントを一意に識別する説明的な名前。
  • INTERCONNECT_NAME: この相互接続アタッチメントが接続する相互接続の名前。
  • NETWORK_NAME: この相互接続アタッチメント リソースが提供する Distributed Cloud ネットワークの名前。
  • REGION: ターゲットの Distributed Cloud ゾーンが属する Google Cloud リージョン 。
  • ZONE_NAME: ターゲットの Distributed Cloud ゾーンの名前。
  • VLAN_ID （省略可）: この相互接続アタッチメントを通過するパケットにタグ付けする VLAN ID。 有効な値は 2 ～ 4095 です。この値を省略するか 0 に設定すると、パケットにタグは付けられません。
  • MTU_SIZE: この相互接続アタッチメントがインスタンス化するサブネットワークの最大伝送単位（MTU）サイズ。有効な値は 1500 と 9000 です。

API

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

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnectAttachments?interconnectAttachmentId=ATTACHMENT_ID
 {
  "labels": { LABELS,
   },
  "interconnect": { INTERCONNECT_NAME,
   },
  "network": { NETWORK_NAME,
   },
  "vlanId": { VLAN_ID,
   },
  "mtu": { MTU_SIZE,
   },       
 }

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

  • PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
  • REGION: ターゲットの Distributed Cloud ゾーンが属する Google Cloud リージョン 。
  • ZONE_NAME: ターゲットの Distributed Cloud ゾーンの名前。
  • ATTACHMENT_ID: この相互接続アタッチメントを一意に識別する ID。
  • LABELS: この相互接続アタッチメント リソースに適用するラベルのリスト。
  • INTERCONNECT_NAME: この相互接続アタッチメントが接続する相互接続の名前。
  • NETWORK_NAME: この相互接続アタッチメント リソースが提供するネットワーク。
  • VLAN_ID: この相互接続アタッチメントがルーターでインスタンス化するサブネットワークの VLAN ID。 有効な値は 2 ～ 4095 です。値 0 は、サブネットワークをタグなしとして構成します。
  • MTU_SIZE: この相互接続アタッチメントがインスタンス化するサブネットワークの最大伝送単位（MTU）サイズ。 有効な値は 1500 と 9000 です。

相互接続のアタッチメントの一覧取得

Distributed Cloud 接続ゾーンの Distributed Cloud 相互接続アタッチメントを一覧表示するには、このセクションの手順を行います。

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

gcloud

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

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

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

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

API

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

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnectAttachments?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 interconnects attachments describe コマンドを使用します。

gcloud edge-cloud networking interconnects attachments describe ATTACHMENT_NAME \
    --location=REGION \
    --zone=ZONE_NAME

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

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

API

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

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnectAttachments/ATTACHMENT_ID

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

  • PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
  • ATTACHMENT_ID: ターゲットの相互接続アタッチメントの名前。
  • REGION: ターゲットの Distributed Cloud 接続ゾーンが属する Google Cloud リージョン。
  • ZONE_NAME: ターゲットの Distributed Cloud ゾーンの名前。

このオペレーションは、リソースの詳細情報を返します。これには、次のようなプロビジョニング状態が含まれます。

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

相互接続のアタッチメントを削除する

Distributed Cloud 相互接続アタッチメントを削除するには、このセクションの手順を行います。

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

gcloud

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

gcloud edge-cloud networking interconnects attachments delete ATTACHMENT_NAME \
    --location=REGION \
    --zone=ZONE_NAME

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

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

API

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

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

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

  • PROJECT_ID: ターゲット Google Cloud プロジェクトの ID。
  • ATTACHMENT_NAME: ターゲットの相互接続アタッチメントの名前。
  • REGION: ターゲットの Distributed Cloud 接続ゾーンが属する Google Cloud リージョン。
  • ZONE_NAME: ターゲットの Distributed Cloud 接続ゾーンの名前。

次のステップ