创建和管理 Private Service Connect 接口

控制台

创建虚拟机实例

1. 在 Google Cloud 控制台中，前往虚拟机实例页面：

   进入“虚拟机实例”

2. 点击创建实例。

3. 输入名称。

4. 点击区域，然后选择您希望连接到的网络连接所在的区域。

5. 选择一个可用区。

6. 如需配置虚拟机的默认网络接口，请执行以下操作：

   1. 点击网络。
   2. 在网络接口部分中，点击第一个网络接口（即默认网络接口）。
   3. 请选择一个网络。
   4. 选择与 Private Service Connect 接口的网络连接位于同一区域的子网。
   5. 选择 IP 栈类型。

7. 点击完成。

添加 Private Service Connect 接口

您可以针对要添加的每个接口重复上述步骤。

添加虚拟 Private Service Connect 接口

1. 点击添加网络接口。
2. 对于接口类型，选择 Private Service Connect。
3. 输入相应接口的网络连接的网址。
4. 为接口选择 IP 栈类型。网络连接的子网决定了可能的堆栈类型。
5. 可选：如需添加别名 IP 范围，请执行以下操作：
   1. 在别名 IP 范围部分中，点击添加 IP 范围。
   2. 在前缀长度框中，输入前缀长度，例如 /30。您可以通过点击添加 IP 范围，然后输入您希望添加的每个额外别名 IP 范围的前缀长度，来添加多个别名 IP 范围。
6. 点击完成。

添加动态 Private Service Connect 接口

1. 点击添加 Dynamic Network Interface。
2. 对于接口类型，选择 Private Service Connect。
3. 选择父级网络接口。
4. 输入 VLAN ID。
5. 为接口选择 IP 栈类型。网络连接的子网决定了可能的堆栈类型。
6. 可选：如需添加别名 IP 范围，请执行以下操作：
   1. 在别名 IP 范围部分中，点击添加 IP 范围。
   2. 在前缀长度框中，输入前缀长度，例如 /30。您可以通过点击添加 IP 范围，然后输入您希望添加的每个额外别名 IP 范围的前缀长度，来添加多个别名 IP 范围。
7. 点击完成。

如需创建虚拟机，请点击创建。

gcloud

• 如需创建具有虚拟 Private Service Connect 接口的虚拟机，请使用 gcloud compute instances create 命令。

  gcloud compute instances create INSTANCE_NAME \
      --zone=ZONE \
      --machine-type=MACHINE_TYPE \
      --image-project=IMAGE_PROJECT \
      --image-family=IMAGE_FAMILY \
      --network-interface='subnet=PRODUCER_SUBNET,no-address' \
      --network-interface='network-attachment=ATTACHMENT_URI,stack-type=STACK_TYPE
  

  替换以下内容：

  • INSTANCE_NAME：新实例的名称
  • ZONE：新实例的可用区
  • MACHINE_TYPE：实例的机器类型，可以是预定义，也可以是自定义，例如 n1-standard-1

  • IMAGE_PROJECT：映像系列所属的项目

    例如，如果您将 debian-12 指定为映像系列，请将 debian-cloud 指定为映像项目。您可以使用 gcloud compute images list 命令查看可用映像、映像项目和映像系列的列表。

  • IMAGE_FAMILY：实例所属的映像系列

    这会使用映像系列中最新的未弃用操作系统映像创建虚拟机。例如，如果您指定 debian-12，Compute Engine 会使用 Debian 12 映像系列中最新版本的操作系统映像。

  • PRODUCER_SUBNET：虚拟机主要网络接口的子网

    此子网必须与 Private Service Connect 接口的网络连接位于同一区域。

  • ATTACHMENT_URI：网络连接的 URI，例如：projects/CONSUMER_PROJECT_ID/regions/REGION/networkAttachments/ATTACHMENT_NAME

  • STACK_TYPE：动态 Private Service Connect 接口的堆栈类型

    如需创建使用 IPv4 地址的接口，请指定 IPV4_ONLY（默认值）。如需创建同时使用 IPv4 和 IPv6 地址（双栈）的接口，请指定 IPV4_IPV6。对于仅限 IPv6 的情况，请指定 IPV6_ONLY。

    该接口的堆栈类型必须与网络连接的子网的堆栈类型兼容。

• 如需创建具有动态 Private Service Connect 接口的虚拟机，请使用以下命令：

  gcloud compute instances create INSTANCE_NAME \
      --zone=ZONE \
      --machine-type=MACHINE_TYPE \
      --image-project=IMAGE_PROJECT \
      --image-family=IMAGE_FAMILY \
      --network-interface='subnet=PRODUCER_SUBNET,no-address' \
      --network-interface='network-attachment=ATTACHMENT_URI,vlan=VLAN_ID,stack-type=STACK_TYPE'
  

  将 VLAN_ID 替换为动态 Private Service Connect 接口的 VLAN ID，该 ID 必须是介于 2 到 255 之间的整数。

  共用父级 vNIC 的每个动态接口的 VLAN ID 必须是唯一的。您可以将同一 ID 重复用于与不同 vNIC 关联的其他动态接口。

• 如需为 Private Service Connect 接口分配别名 IP 范围，请使用以下命令：

  gcloud compute instances create INSTANCE_NAME \
      --zone=ZONE \
      --machine-type=MACHINE_TYPE \
      --image-project=IMAGE_PROJECT \
      --image-family=IMAGE_FAMILY \
      --network-interface='subnet=PRODUCER_SUBNET,no-address' \
      --network-interface='network-attachment=ATTACHMENT_URI,vlan=VLAN_ID,stack-type=STACK_TYPE,aliases=ALIAS_IP_RANGES'
  

  将 ALIAS_IP_RANGES 替换为要分配给接口的一个或多个别名 IP 范围。您可以输入特定范围 (192.168.100.0/24)、特定 IP 地址 (192.168.100.1) 或 CIDR 格式的前缀长度 (/24)。您可以在以英文分号分隔的列表中输入多个值。您无法输入多个不同类型的值。例如，不支持 192.168.100.0/24;/28。

• 如需创建具有多个 Private Service Connect 接口的虚拟机，请为每个接口添加单独的 --network-interface 标志，其中每个标志都指向不同的网络连接。

  对于动态 Private Service Connect 接口，父级 vNIC 由命令中标志的顺序决定。父级 vNIC 是您在动态接口之前指定的第一个 vNIC。

  您可以创建共存于同一虚拟机上的动态和虚拟 Private Service Connect 接口。例如，以下命令会创建一个同时具有虚拟 Private Service Connect 接口和动态 Private Service Connect 接口的虚拟机。

  VLAN ID 为 2 和 3 的动态 Private Service Connect 接口的父级是连接到 producer-subnet 的第一个 vNIC。VLAN ID 为 4 的动态接口的父级是连接到 producer-subnet-2 的 vNIC。最后一个接口是虚拟 Private Service Connect 接口。

  gcloud compute instances create producer-vm \
      --zone=us-west-1a \
      --network-interface='subnet=producer-subnet,no-address' \
      --network-interface='network-attachment=projects/consumer-project/regions/us-west-1/networkAttachments/consumer-1-network-attachment,vlan=2' \
      --network-interface='network-attachment=projects/consumer-project/regions/us-west-1/networkAttachments/consumer-2-network-attachment,vlan=3' \
      --network-interface='network=producer-vpc-2,subnet=producer-subnet-2' \
      --network-interface='network-attachment=projects/consumer-project/regions/us-west-1/networkAttachments/consumer-3-network-attachment,vlan=4' \
      --network-interface='network-attachment=projects/consumer-project/regions/us-west-1/networkAttachments/consumer-4-network-attachment'
  

API

• 如需创建具有虚拟 Private Service Connect 接口的虚拟机，请向 instances.insert 方法发送请求。

  HTTP 方法和网址：

  POST https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/zones/INSTANCE_ZONE/instances
  

  请求 JSON 正文：

  {
    "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
    "name": "VM_NAME",
    "disks": [
      {
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
        },
        "boot": true
      }
    ],
    "networkInterfaces": [
      {
        "network": "https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/global/networks/PRODUCER_NETWORK",
        "subnetwork": "https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/regions/SUBNET_REGION/subnetworks/PRODUCER_SUBNET"
      },
      {
        "networkAttachment": "ATTACHMENT_URI",
        "stackType": "STACK_TYPE"
      }
    ]
  }
  

  替换以下内容：

  • PRODUCER_PROJECT_ID：虚拟机的项目 ID
  • INSTANCE_ZONE：新实例的可用区
  • MACHINE_TYPE_ZONE：机器类型的可用区
  • MACHINE_TYPE：实例的机器类型，可以是预定义，也可以是自定义，例如 n1-standard-1
  • VM_NAME：虚拟机实例的名称

  • IMAGE_PROJECT：映像系列所属的项目

    例如，如果您将 debian-12 指定为映像系列，请将 debian-cloud 指定为映像项目。您可以使用 gcloud compute images list 命令查看可用映像、映像项目和映像系列的列表。

  • IMAGE_FAMILY：实例所属的映像系列

    这会使用映像系列中最新的未弃用操作系统映像创建虚拟机。例如，如果您指定 debian-12，Compute Engine 会使用 Debian 12 映像系列中最新版本的操作系统映像。

  • PRODUCER_NETWORK：虚拟机主要网络接口的网络

  • SUBNET_REGION：虚拟机主要网络接口的子网所属的区域

  • PRODUCER_SUBNET：虚拟机主要网络接口的子网

    此子网必须与 Private Service Connect 接口的网络连接位于同一区域。

  • ATTACHMENT_URI：网络连接的 URI，例如：projects/CONSUMER_PROJECT_ID/regions/REGION/networkAttachments/ATTACHMENT_NAME

  • STACK_TYPE：动态 Private Service Connect 接口的堆栈类型。

    如需创建使用 IPv4 地址的接口，请指定 IPV4_ONLY（默认值）。如需创建同时使用 IPv4 和 IPv6 地址（双栈）的接口，请指定 IPV4_IPV6。对于仅限 IPv6 的情况，请指定 IPV6_ONLY。

    该接口的堆栈类型必须与网络连接的子网的堆栈类型兼容。

• 如需创建具有动态 Private Service Connect 接口的虚拟机，请发送以下请求。在网络接口对象中添加 VLAN ID，以指定创建动态 Private Service Connect 接口。

  HTTP 方法和网址：

  POST https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/zones/INSTANCE_ZONE/instances
  

  请求 JSON 正文：

  {
    "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
    "name": "VM_NAME",
    "disks": [
      {
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
        },
        "boot": true
      }
    ],
    "networkInterfaces": [
      {
        "network": "https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/global/networks/PRODUCER_NETWORK",
        "subnetwork": "https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/regions/SUBNET_REGION/subnetworks/PRODUCER_SUBNET"
      },
      {
        "networkAttachment": "ATTACHMENT_URI",
        "vlan": VLAN_ID,
        "stackType": "IPV4_IPV6"
      }
    ]
  }
  

  将 VLAN_ID 替换为动态 Private Service Connect 接口的 VLAN ID，该 ID 必须是介于 2 到 255 之间的整数。

  共用父级 vNIC 的每个动态接口的 VLAN ID 必须是唯一的。您可以将同一 ID 重复用于与不同 vNIC 关联的其他动态接口。

• 如需为 Private Service Connect 接口分配别名 IP 范围，请发送以下请求。添加 aliasesIpRanges 字段。

  HTTP 方法和网址：

  POST https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/zones/INSTANCE_ZONE/instances
  

  请求 JSON 正文：

  {
    "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
    "name": "VM_NAME",
    "disks": [
      {
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        },
        "boot": true
      }
    ],
    "networkInterfaces": [
      {
        "network": "https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/global/networks/PRODUCER_NETWORK",
        "subnetwork": "https://compute.googleapis.com/compute/v1/projects/PRODUCER_PROJECT_ID/regions/SUBNET_REGION/subnetworks/PRODUCER_SUBNET"
      },
      {
        "aliasIpRanges": [
          {
            "ipCidrRange": "ALIAS_IP_RANGE"
          }
        ],
        "networkAttachment": "ATTACHMENT_URI"
      }
    ]
  }
  

  将 ALIAS_IP_RANGE 替换为要分配给接口的别名 IP 范围。您可以输入特定范围 (192.168.100.0/24)、特定 IP 地址 (192.168.100.1) 或 CIDR 格式的前缀长度 (/24)。

  您可以在 aliasIpRanges 数组中指定多个别名 IP 范围。每个范围都必须以相同的形式指定：

  "aliasIpRanges": [
    {
      "ipCidrRange": "/28"
    },
    {
      "ipCidrRange": "/30"
    }
  ]
  

• 如需创建具有多个 Private Service Connect 接口的虚拟机，请在 networkInterfaces 数组中为每个接口添加单独的对象，其中每个接口对象都指向不同的网络连接。

  对于动态 Private Service Connect 接口，父级 vNIC 由数组中对象的顺序决定。父级 vNIC 是您在动态接口之前指定的第一个 vNIC。

  您可以创建共存于同一虚拟机上的动态和虚拟 Private Service Connect 接口。例如，以下请求会创建一个同时具有虚拟 Private Service Connect 接口和动态 Private Service Connect 接口的虚拟机。

  VLAN ID 为 2 和 3 的动态 Private Service Connect 接口的父级是连接到 producer-subnet 的第一个 vNIC。VLAN ID 为 4 的动态接口的父级是连接到 producer-subnet-2 的 vNIC。最后一个接口是虚拟 Private Service Connect 接口。

  {
    "machineType": "zones/us-west-1a/machineTypes/e2-medium",
    "name": "producer-vm",
    "disks": [
      {
        "initializeParams": {
          "sourceImage": "projects/debian-cloud/global/images/family/debian-11"
      },
      "boot": true
    }
    ],
    "networkInterfaces": [
      {
        "network": "https://www.googleapis.com/compute/v1/projects/producer-project-id/global/networks/producer-vpc-1",
        "subnetwork": "https://www.googleapis.com/compute/v1/projects/producer-project-id/regions/us-west-1/subnetworks/producer-subnet"
      },
      {
        "networkAttachment": "projects/consumer-project1/regions/us-west-1/networkAttachments/consumer-1-network-attachment",
        "vlan": 2
      },
      {
        "networkAttachment": "projects/consumer-project2/regions/us-west-1/networkAttachments/consumer-2-network-attachment",
        "vlan": 3
      },
      {
        "network": "https://www.googleapis.com/compute/v1/projects/producer-project-id/global/networks/producer-vpc-2",
        "subnetwork": "https://www.googleapis.com/compute/v1/projects/producer-project-id/regions/us-west-1/subnetworks/producer-subnet-2"
      },
      {
        "networkAttachment": "projects/consumer-project3/regions/us-west-1/networkAttachments/consumer-3-network-attachment",
        "vlan": 4
      },
      {
        "networkAttachment": "projects/consumer-project4/regions/us-west-1/networkAttachments/consumer-4-network-attachment"
      }
    ]
  }
  ```
  

控制台

1. 在 Google Cloud 控制台中，前往虚拟机实例页面：

   进入“虚拟机实例”

2. 点击要更新的虚拟机的名称。

3. 点击修改。

4. 在网络部分中，点击添加 Dynamic Network Interface。

5. 对于接口类型，选择 Private Service Connect。

6. 选择父级网络接口。

7. 输入 VLAN ID。

8. 输入相应接口的网络连接的网址。

9. 为接口选择 IP 栈类型。网络连接的子网决定了可能的堆栈类型。

10. 可选：如需添加别名 IP 范围，请执行以下操作：

    1. 在别名 IP 范围部分中，点击添加 IP 范围。
    2. 在前缀长度框中，输入前缀长度，例如 /30。您可以通过点击添加 IP 范围，然后输入您希望添加的每个额外别名 IP 范围的前缀长度，来添加多个别名 IP 范围。

11. 点击完成。

12. 点击保存。

gcloud

如需向现有虚拟机添加单个动态 Private Service Connect 接口，请使用 gcloud compute instances network-interfaces add 命令。

如需添加多个动态 Private Service Connect 接口，请针对要添加的每个接口重复执行该命令。

gcloud compute instances network-interfaces add INSTANCE_NAME \
    --zone=ZONE \
    --vlan=VLAN_ID \
    --parent-nic-name=PARENT_NIC_NAME \
    --network-attachment=ATTACHMENT_URI
    

替换以下内容：

• INSTANCE_NAME：要更新的实例的名称
• ZONE：要更新的实例所在的可用区

• VLAN_ID：动态 Private Service Connect 接口的 ID（2 到 4094 之间的整数）

  共用父级 vNIC 的每个动态接口的 VLAN ID 必须是唯一的。您可以将同一 ID 重复用于与不同 vNIC 关联的其他动态接口。

• PARENT_NIC_NAME：新 VLAN NIC 的父级网络接口的名称，例如 nic0。

• ATTACHMENT_URI：网络连接的 URI，例如：projects/CONSUMER_PROJECT_ID/regions/REGION/networkAttachments/ATTACHMENT_NAME

API

如需向现有虚拟机添加单个动态 Private Service Connect 接口，请向 instances.addNetworkInterface 方法发送请求。

如需添加多个动态 Private Service Connect 接口，请针对要添加的每个接口重复发出该请求。

HTTP 方法和网址：

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/addNetworkInterface

请求 JSON 正文：

{
  "networkAttachment": "ATTACHMENT_URI",
  "parentNicName": "PARENT_NIC_NAME",
  "vlan": VLAN_ID
}

替换以下内容：

• PROJECT_ID：虚拟机的项目 ID
• ZONE：虚拟机所在的可用区

• INSTANCE_NAME：要更新的虚拟机的名称

• ATTACHMENT_URI：网络连接的 URI，例如：projects/CONSUMER_PROJECT_ID/regions/REGION/networkAttachments/ATTACHMENT_NAME

• PARENT_NIC_NAME：新 VLAN NIC 的父级网络接口的名称，例如 nic0

• VLAN_ID：VLAN NIC Private Service Connect 接口的 ID（2 到 4094 之间的整数）

  父级网络接口下每个 VLAN NIC 的 VLAN NIC 接口 ID 必须是唯一的，但您可以将同一 ID 重复用于与不同父级网络接口关联的其他 VLAN NIC。

控制台

1. 在 Google Cloud 控制台中，前往实例模板页面：

   转到“实例模板”

2. 点击创建实例模板。

3. 输入实例模板的名称。

4. 点击高级选项。

5. 点击网络。

6. 在网络接口部分中，点击 expand_more展开箭头。

7. 为实例模板的主要网络接口选择网络和子网。

8. 点击完成。

9. 如需添加 Private Service Connect 接口，请执行以下操作。您可以针对要添加的每个接口重复执行上述步骤：

   • 对于虚拟 Private Service Connect 接口，请执行以下操作：
     1. 点击添加网络接口。
     2. 对于接口类型，选择 Private Service Connect。
   • 对于动态 Private Service Connect 接口，请执行以下操作：
     1. 点击添加 Dynamic Network Interface。
     2. 对于接口类型，选择 Private Service Connect。
     3. 选择父级网络接口。
     4. 输入 VLAN ID。

10. 如需完成 Private Service Connect 接口的配置，请执行以下操作：

    1. 输入相应接口的网络连接的网址。
    2. 为接口选择 IP 栈类型。网络连接的子网决定了可能的堆栈类型。
    3. 可选：如需添加别名 IP 范围，请执行以下操作：
       1. 在别名 IP 范围部分中，点击添加 IP 范围。
       2. 在前缀长度框中，输入前缀长度，例如 /30。您可以通过点击添加 IP 范围，然后输入您希望添加的每个额外别名 IP 范围的前缀长度，来添加多个别名 IP 范围。
    4. 点击完成。

11. 如需创建虚拟机，请点击创建。

gcloud

• 如需创建具有虚拟 Private Service Connect 接口的实例模板，请使用 gcloud compute instance-templates create 命令。

  gcloud compute instance-templates create NAME \
      --machine-type=MACHINE_TYPE \
      --image-project=IMAGE_PROJECT \
      --image-family=IMAGE_FAMILY \
      --region=REGION \
      --network-interface='subnet=PRODUCER_SUBNET,no-address' \
      --network-interface='network-attachment=ATTACHMENT_URI,stack-type=STACK_TYPE'
  

  替换以下内容：

  • NAME：新实例模板的名称
  • MACHINE_TYPE：实例的机器类型，可以是预定义，也可以是自定义，例如 n1-standard-1

  • IMAGE_PROJECT：映像系列所属的项目

    例如，如果您将 debian-12 指定为映像系列，请将 debian-cloud 指定为映像项目。您可以使用 gcloud compute images list 命令查看可用映像、映像项目和映像系列的列表。

  • IMAGE_FAMILY：实例所属的映像系列

    这会使用映像系列中最新的未弃用操作系统映像创建虚拟机。例如，如果您指定 debian-12，Compute Engine 会使用 Debian 12 映像系列中最新版本的操作系统映像。

  • REGION：实例模板制作者子网所在的区域。

  • PRODUCER_SUBNET：实例模板的子网

    使用此实例模板创建虚拟机时，系统会为虚拟机的主要网络接口分配此子网的内部 IP 地址。此子网必须与 Private Service Connect 接口的网络连接位于同一区域。

  • ATTACHMENT_URI：网络连接的 URI，例如：projects/CONSUMER_PROJECT_ID/regions/REGION/networkAttachments/ATTACHMENT_NAME

  • STACK_TYPE：实例模板的动态 Private Service Connect 接口的堆栈类型。

    如需创建使用 IPv4 地址的接口，请指定 IPV4_ONLY（默认值）。如需创建同时使用 IPv4 和 IPv6 地址（双栈）的接口，请指定 IPV4_IPV6。对于仅限 IPv6 的情况，请指定 IPV6_ONLY。

    该接口的堆栈类型必须与网络连接的子网的堆栈类型兼容。

• 如需创建具有动态 Private Service Connect 接口的实例模板，请使用以下命令。

  gcloud compute instance-templates create NAME \
      --machine-type=MACHINE_TYPE \
      --image-project=IMAGE_PROJECT \
      --image-family=IMAGE_FAMILY \
      --region=REGION \
      --network-interface='subnet=PRODUCER_SUBNET,no-address' \
      --network-interface='network-attachment=ATTACHMENT_URI,vlan=VLAN_ID,stack-type=STACK_TYPE'
  

  将 VLAN_ID 替换为动态 Private Service Connect 接口的 VLAN ID，该 ID 必须是介于 2 到 255 之间的整数。

  共用父级 vNIC 的每个动态接口的 VLAN ID 必须是唯一的。您可以将同一 ID 重复用于与不同 vNIC 关联的其他动态接口。

API

• 如需创建具有虚拟 Private Service Connect 接口的实例模板，请向 instanceTemplates.insert 方法发出请求。

  HTTP 方法和网址：

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/instanceTemplates
  

  请求 JSON 正文：

  {
    "name": "NAME",
    "properties": {
      "disks": [
        {
          "boot": true,
          "initializeParams": {
            "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
          }
        }
      ],
      "machineType": "MACHINE_TYPE",
      "networkInterfaces": [
        {
          "subnetwork": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/SUBNET_REGION/subnetworks/PRODUCER_SUBNET"
        },
        {
          "networkAttachment": "ATTACHMENT_URI",
          "stackType": "STACK_TYPE"
        }
      ]
    }
  }
  

  替换以下内容：

  • PROJECT_ID：实例模板的项目 ID
  • NAME：新实例模板的名称

  • IMAGE_PROJECT：映像系列所属的项目

    例如，如果您将 debian-12 指定为映像系列，请将 debian-cloud 指定为映像项目。您可以使用 gcloud compute images list 命令查看可用映像、映像项目和映像系列的列表。

  • IMAGE_FAMILY：实例所属的映像系列

    这会使用映像系列中最新的未弃用操作系统映像创建虚拟机。例如，如果您指定 debian-12，Compute Engine 会使用 Debian 12 映像系列中最新版本的操作系统映像。

  • MACHINE_TYPE：实例的机器类型，可以是预定义，也可以是自定义，例如 n1-standard-1

  • SUBNET_REGION：实例模板制作者子网所在的区域。

  • PRODUCER_SUBNET：实例模板的子网

    使用此实例模板创建虚拟机时，系统会为虚拟机的主要网络接口分配此子网的内部 IP 地址。此子网必须与 Private Service Connect 接口的网络连接位于同一区域。

  • ATTACHMENT_URI：网络连接的 URI，例如：projects/CONSUMER_PROJECT_ID/regions/REGION/networkAttachments/ATTACHMENT_NAME

  • STACK_TYPE：实例模板的动态 Private Service Connect 接口的堆栈类型

    如需创建使用 IPv4 地址的接口，请指定 IPV4_ONLY（默认值）。如需创建同时使用 IPv4 和 IPv6 地址（双栈）的接口，请指定 IPV4_IPV6。对于仅限 IPv6 的情况，请指定 IPV6_ONLY。

    该接口的堆栈类型必须与网络连接的子网的堆栈类型兼容。

• 如需创建具有动态 Private Service Connect 接口的实例模板，请发出以下请求。

  HTTP 方法和网址：

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/instanceTemplates
  

  请求 JSON 正文：

  {
    "name": "NAME",
    "properties": {
      "disks": [
        {
          "boot": true,
          "initializeParams": {
            "sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
          }
        }
      ],
      "machineType": "MACHINE_TYPE",
      "networkInterfaces": [
        {
          "subnetwork": "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/SUBNET_REGION/subnetworks/PRODUCER_SUBNET"
        },
        {
          "networkAttachment": "ATTACHMENT_URI",
          "vlan": VLAN_ID,
          "stackType": "STACK_TYPE"
        }
      ]
    }
  }
  

  将 VLAN_ID 替换为动态 Private Service Connect 接口的 VLAN ID，该 ID 必须是介于 2 到 255 之间的整数。

  共用父级 vNIC 的每个动态接口的 VLAN ID 必须是唯一的。您可以将同一 ID 重复用于与不同 vNIC 关联的其他动态接口。

控制台

1. 在 Google Cloud 控制台中，前往虚拟机实例页面。

   进入“虚拟机实例”

2. 点击具有 Private Service Connect 接口的虚拟机。

3. 在网络接口部分中，查看 Private Service Connect 接口的详细信息。

gcloud

gcloud compute instances describe VM_NAME
    --zone=ZONE

替换以下内容：

• VM_NAME：您的接口的虚拟机的名称。
• ZONE：您的虚拟机所在的可用区。

API

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME

替换以下内容：

• PROJECT_ID：虚拟机的项目 ID。
• ZONE：虚拟机的可用区。
• VM_NAME：虚拟机的名称。

控制台

1. 在 Google Cloud 控制台中，前往虚拟机实例页面：

   进入“虚拟机实例”

2. 点击要更新的虚拟机的名称。

3. 点击修改。

4. 在 Dynamic Network Interface 部分中，点击要删除的接口旁边的 delete 删除。

gcloud

使用 gcloud compute instances network-interfaces delete 命令。

gcloud compute instances network-interfaces delete INSTANCE_NAME \
    --zone=ZONE \
    --network-interface=INTERFACE_NAME

替换以下内容：

• INSTANCE_NAME：接口的虚拟机实例的名称
• ZONE：接口的虚拟机实例所在的可用区

• INTERFACE_NAME：要删除的动态 Private Service Connect 接口的 Google Cloud 名称

  例如，nic0.10 是动态 Private Service Connect 接口的名称，其中 nic0 是父级，10 是 VLAN ID。

API

向 instances.deleteNetworkInterface 方法发送请求。

HTTP 方法和网址：

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/deleteNetworkInterface?networkInterfaceName=INTERFACE_NAME

替换以下内容：

• PROJECT_ID：接口虚拟机的项目 ID
• ZONE：接口的虚拟机所在的可用区
• INSTANCE_NAME：接口的虚拟机的名称

• INTERFACE_NAME：要删除的动态 Private Service Connect 接口的 Google Cloud 名称

  例如，nic0.10 是动态 Private Service Connect 接口的名称，其中 nic0 是父级 vNIC 名称，10 是 VLAN ID。