建立及管理 Private Service Connect 介面

主控台

1. 前往 Trusted Cloud 控制台的「VM instances」(VM 執行個體) 頁面：

   前往 VM 執行個體

2. 點選「建立執行個體」。

3. 輸入名稱。

4. 選取與要連線的網路附件區域相符的區域。

5. 選取「區域」。

6. 點選「進階選項」。

7. 點選「網路」。

8. 在「Network interfaces」(網路介面) 專區中，按一下第一個網路介面 (即主要網路介面)，然後執行下列操作：

   1. 選取主要網路介面的「Network」(網路)。
   2. 選取主要網路介面的「子網路」。這個子網路必須與 Private Service Connect 介面的網路連結位於相同區域。

9. 按一下「新增網路介面」。

10. 在「介面類型」部分，選取「Private Service Connect」。

11. 輸入「網路連結網址」。

12. 選取 IP 堆疊類型。如要建立雙重堆疊 Private Service Connect 介面，網路附件的子網路必須是雙重堆疊。

13. 選用：如要新增別名 IP 範圍，請在「前置字串長度」方塊中輸入前置字串長度，例如 /30。如要新增多個別名 IP 範圍，請按一下「新增 IP 範圍」，然後輸入要新增的每個別名 IP 範圍的前置字元長度。

14. 按一下 [完成]。

15. 點選「建立」。

gcloud

• 如要建立具有虛擬 Private Service Connect 介面的 VM，請使用 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：執行個體的映像檔系列

    這樣一來，系統就會使用映像檔系列中未淘汰的最新 OS 映像檔建立 VM。舉例來說，如果您指定 debian-12，Compute Engine 會使用 Debian 12 映像檔系列中的最新版 OS 映像檔。

  • PRODUCER_SUBNET：VM 主要網路介面的子網路

    這個子網路必須與 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。只有在介面的網路附件與雙重堆疊子網路建立關聯時，才能建立雙重堆疊介面。

• 如要建立具有動態 Private Service Connect 介面 (預先發布版) 的 VM，請使用 gcloud beta compute instances create 指令。加入 VLAN ID，指定建立動態 Private Service Connect 介面。

  gcloud beta 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 相關聯的其他動態介面。

• 如要將別名 IP 範圍指派給 Private Service Connect 介面，請傳送下列要求：

  gcloud beta 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 介面的 VM，請為每個介面分別加入 --network-interface 標記，每個標記都參照不同的網路附件。

  如果是動態 Private Service Connect 介面，上層 vNIC 會依指令中的旗標順序決定。上層 vNIC 是您在動態介面前指定的第一個 vNIC。

  您可以在同一個 VM 上建立動態和虛擬 Private Service Connect 介面，舉例來說，下列指令會建立 VM，並同時包含虛擬和動態 Private Service Connect 介面。

  具有 VLAN ID 2 和 3 的動態 Private Service Connect 介面，其父項是連線至 producer-subnet 的第一個 vNIC。VLAN ID 為 4 的動態介面父項是連線至 producer-subnet-2 的 vNIC。最後一個介面是虛擬 Private Service Connect 介面。

  gcloud beta 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 介面的 VM，請傳送要求至 instances.insert 方法。

  HTTP 方法和網址：

  POST https://compute.s3nsapis.fr/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.s3nsapis.fr/compute/v1/projects/PRODUCER_PROJECT_ID/global/networks/PRODUCER_NETWORK",
        "subnetwork": "https://compute.s3nsapis.fr/compute/v1/projects/PRODUCER_PROJECT_ID/regions/SUBNET_REGION/subnetworks/PRODUCER_SUBNET"
      },
      {
        "networkAttachment": "ATTACHMENT_URI",
        "stackType": "STACK_TYPE"
      }
    ]
  }
  

  更改下列內容：

  • PRODUCER_PROJECT_ID：VM 專案的 ID
  • INSTANCE_ZONE：新執行個體的可用區
  • MACHINE_TYPE_ZONE：機器類型的可用區
  • MACHINE_TYPE：執行個體的機器類型，可以是預先定義或自訂，例如 n1-standard-1
  • VM_NAME：VM 執行個體名稱

  • IMAGE_PROJECT：映像檔系列的專案

    舉例來說，如果您指定 debian-12 做為映像檔系列，請指定 debian-cloud 做為映像檔專案。您可以使用 gcloud compute images list 指令，查看可用映像檔、映像檔專案和映像檔系列清單。

  • IMAGE_FAMILY：執行個體的映像檔系列

    這樣一來，系統就會使用映像檔系列中未淘汰的最新 OS 映像檔建立 VM。舉例來說，如果您指定 debian-12，Compute Engine 會使用 Debian 12 映像檔系列中的最新版 OS 映像檔。

  • PRODUCER_NETWORK：VM 主要網路介面的網路

  • SUBNET_REGION：虛擬機主要網路介面子網路的區域

  • PRODUCER_SUBNET：VM 主要網路介面的子網路

    這個子網路必須與 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。只有在介面的網路附件與雙重堆疊子網路建立關聯時，才能建立雙重堆疊介面。

• 如要建立具有動態 Private Service Connect 介面 (預先發布版) 的 VM，請將要求傳送至 instances.insert 方法的 Beta 版。在網路介面物件中加入 VLAN ID，指定要建立動態 Private Service Connect 介面。

  HTTP 方法和網址：

  POST https://compute.s3nsapis.fr/compute/beta/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.s3nsapis.fr/compute/beta/projects/PRODUCER_PROJECT_ID/global/networks/PRODUCER_NETWORK",
        "subnetwork": "https://compute.s3nsapis.fr/compute/beta/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 相關聯的其他動態介面。

• 如要將別名 IP 範圍指派給 Private Service Connect 介面，請加入 aliasesIpRanges 欄位。

  HTTP 方法和網址：

  POST https://compute.s3nsapis.fr/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.s3nsapis.fr/compute/v1/projects/PRODUCER_PROJECT_ID/global/networks/PRODUCER_NETWORK",
        "subnetwork": "https://compute.s3nsapis.fr/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 介面的 VM，請在 networkInterfaces 陣列中為每個介面加入個別物件，每個介面物件都會參照不同的網路附件。

  如果是動態 Private Service Connect 介面，上層 vNIC 會依陣列中的物件順序決定。上層 vNIC 是您在動態介面前指定的第一個 vNIC。

  您可以在同一個 VM 上建立動態和虛擬 Private Service Connect 介面，舉例來說，下列要求會建立具有虛擬和動態 Private Service Connect 介面的 VM。

  具有 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/beta/projects/producer-project-id/global/networks/producer-vpc-1",
        "subnetwork": "https://www.googleapis.com/compute/beta/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/beta/projects/producer-project-id/global/networks/producer-vpc-2",
        "subnetwork": "https://www.googleapis.com/compute/beta/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"
      }
    ]
  }
  ```
  

gcloud

如要為現有 VM 新增單一動態 Private Service Connect 介面，請使用 gcloud beta compute instances network-interfaces add 指令。

如要新增多個動態 Private Service Connect 介面，請針對要新增的每個介面重複執行指令。

gcloud beta 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 介面新增至現有 VM，請將要求傳送至 instances.addNetworkInterface 方法的 Beta 版。

如要新增多個動態 Private Service Connect 介面，請針對要新增的每個介面重複提出要求。

HTTP 方法和網址：

POST https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/addNetworkInterface

JSON 要求內文：

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

更改下列內容：

• PROJECT_ID：VM 專案的 ID
• ZONE：VM 所在可用區

• INSTANCE_NAME：要更新的 VM 名稱

• 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. 前往 Trusted Cloud 控制台的「Instance templates」(執行個體範本) 頁面：

   前往「Instance templates」(執行個體範本) 頁面

2. 點選「建立執行個體範本」。

3. 在「Name」(名稱) 中輸入執行個體範本的名稱。

4. 點選「進階選項」。

5. 點選「網路」。

6. 在「Network interfaces」(網路介面) 區段中，按一下expand_more展開箭頭。

7. 為執行個體範本的主要網路介面選取「網路」和「子網路」。

8. 按一下 [完成]。

9. 按一下「新增網路介面」。

10. 按一下「Private Service Connect」。

11. 為 Private Service Connect 介面選取「網路」和「子網路」。

12. 按一下 [完成]。

13. 點選「建立」。

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：執行個體的映像檔系列

    這樣一來，系統就會使用映像檔系列中未淘汰的最新 OS 映像檔建立 VM。舉例來說，如果您指定 debian-12，Compute Engine 會使用 Debian 12 映像檔系列中的最新版 OS 映像檔。

  • REGION：執行個體範本的生產者子網路區域。

  • PRODUCER_SUBNET：執行個體範本的子網路

    使用這個執行個體範本建立 VM 時，系統會從這個子網路為 VM 的主要網路介面指派內部 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。只有在介面的網路附件與雙重堆疊子網路建立關聯時，才能建立雙重堆疊介面。

• 如要建立具有動態 Private Service Connect 介面的執行個體範本，請使用 gcloud beta compute instance-templates create 指令。

  gcloud beta 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.s3nsapis.fr/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.s3nsapis.fr/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：執行個體的映像檔系列

    這樣一來，系統就會使用映像檔系列中未淘汰的最新 OS 映像檔建立 VM。舉例來說，如果您指定 debian-12，Compute Engine 會使用 Debian 12 映像檔系列中的最新版 OS 映像檔。

  • MACHINE_TYPE：執行個體的機器類型，可以是預先定義或自訂，例如 n1-standard-1

  • SUBNET_REGION：執行個體範本生產者子網路的區域。

  • PRODUCER_SUBNET：執行個體範本的子網路

    使用這個執行個體範本建立 VM 時，系統會從這個子網路為 VM 的主要網路介面指派內部 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。只有在介面的網路附件與雙重堆疊子網路建立關聯時，才能建立雙重堆疊介面。

• 如要使用動態 Private Service Connect 介面建立執行個體範本，請對 instanceTemplates.insert 方法的 Beta 版發出要求。

  HTTP 方法和網址：

  POST https://compute.s3nsapis.fr/compute/beta/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.s3nsapis.fr/compute/beta/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. 前往 Trusted Cloud 控制台的「VM instances」(VM 執行個體) 頁面。

   前往 VM 執行個體

2. 按一下具有 Private Service Connect 介面的 VM。

3. 在「網路介面」部分，查看 Private Service Connect 介面的詳細資料。

gcloud

gcloud beta compute instances describe VM_NAME
    --zone=ZONE

更改下列內容：

• VM_NAME：介面 VM 的名稱。
• ZONE：VM 的可用區。

API

GET https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME

更改下列內容：

• PROJECT_ID：VM 的專案 ID。
• ZONE：VM 所在的可用區。
• VM_NAME：VM 名稱。

gcloud

使用 gcloud beta compute instances network-interfaces delete 指令。

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

更改下列內容：

• INSTANCE_NAME：介面的 VM 執行個體名稱
• ZONE：介面 VM 執行個體的可用區

• INTERFACE_NAME：要刪除的動態 Private Service Connect 介面名稱 Trusted Cloud

  舉例來說，nic0.10 是動態 Private Service Connect 介面的名稱，其中 nic0 是父項，10 則是 VLAN ID。

API

對 instances.deleteNetworkInterface 方法的 Beta 版發出要求。

HTTP 方法和網址：

POST https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/deleteNetworkInterface?networkInterfaceName=INTERFACE_NAME

更改下列內容：

• PROJECT_ID：介面 VM 的專案 ID
• ZONE：介面 VM 的可用區
• INSTANCE_NAME：介面 VM 的名稱

• INTERFACE_NAME：要刪除的動態 Private Service Connect 介面名稱 Trusted Cloud

  舉例來說，nic0.10 是動態 Private Service Connect 介面的名稱，其中 nic0 是上層 vNIC 名稱，10 則是 VLAN ID。