您可以將標籤附加至下列 Cloud VPN 資源:
關於代碼
標記是可附加至Google Cloud內資源的鍵/值組合。您可以將資源是否具備特定標記設為條件,並按照這項條件允許或拒絕政策。舉例來說,您可以根據資源是否具備特定標記,有條件地授予 Identity and Access Management (IAM) 角色。如要進一步瞭解標記,請參閱「標記總覽」。
如要將標記附加至資源,請建立標記繫結資源,將值連結至 Google Cloud 資源。
所需權限
如要取得管理標記所需的權限,請要求管理員授予您下列 IAM 角色:
- 標記檢視者 (
roles/resourcemanager.tagViewer) 附加標記的資源 -
在機構層級查看及管理標記:
機構檢視者 (
roles/resourcemanager.organizationViewer) 機構 -
建立、更新及刪除標記定義:
您要建立、更新或刪除標記的資源必須具備標記管理員 (
roles/resourcemanager.tagAdmin) 權限 -
在資源中附加及移除標記:
標記使用者 (
roles/resourcemanager.tagUser) 在標記值和要附加或移除標記值的資源上
如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
如要將標記附加至 Cloud VPN 資源,您需要 Compute Network Admin 角色 (roles/compute.networkAdmin)。
建立標記鍵和值
您必須先建立代碼並設定其值,才能附加代碼。 如要建立標記鍵和標記值,請參閱「建立標記」和「新增標記值」一文。
在建立資源時新增標記
您可以在建立 VPN 資源時新增標記。 新增標記後,您就能立即為 VPN 資源提供必要的中繼資料,並有效整理資源、追蹤費用,以及自動套用政策。
gcloud
如要在建立資源時將標記附加至 VPN 閘道,請將 --resource-manager-tags 標記新增至 gcloud compute vpn-gateways create 指令:
gcloud compute vpn-gateways create VPN_GATEWAY_NAME \
--network=NETWORK_NAME \
--resource-manager-tags=tagKeys/TAGKEY_ID=tagValues/TAGVALUE_ID
更改下列內容:
VPN_GATEWAY_NAME:VPN 閘道的名稱NETWORK_NAME:VPN 閘道所屬的網路名稱TAGKEY_ID:標記鍵編號數值 IDTAGVALUE_ID:附加標記值的永久數值 ID,例如4567890123
如要指定多個標記,請以半形逗號分隔,例如 TAGKEY1=TAGVALUE1,TAGKEY2=TAGVALUE2
API
將 POST 要求傳送至下列網址:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/vpnGateways在要求主體中提供下列 JSON:
{
"name": "VPN_GATEWAY_NAME",
"network": "projects/PROJECT/global/networks/NETWORK_NAME",
"params": {
"resourceManagerTags": {
"tagKeys/TAGKEY_ID": "tagValues/TAGVALUE_ID"
},
}
// Other fields omitted
}更改下列內容:
VPN_GATEWAY_NAME:VPN 閘道的名稱NETWORK_NAME:VPN 閘道所屬的網路名稱TAGKEY_ID:標記鍵編號數值 IDTAGVALUE_ID:附加標記值的永久數值 ID,例如4567890123
為現有資源新增標記
如要為現有 Cloud VPN 資源新增標記,請按照下列步驟操作:
控制台
- 前往 Google Cloud 控制台的「Cloud VPN」頁面。
- 選取要附加標記的 Cloud VPN 資源。
- 按一下「代碼」。
- 如果「標記」面板中未顯示貴機構,請按一下「選取範圍」。選取機構,然後按一下「開啟」。
- 按一下「新增代碼」。
- 從清單中選取要附加的代碼金鑰。輸入關鍵字即可篩選清單。
- 從清單中選取要附加的標記值。輸入關鍵字即可篩選清單。
- 按一下 [儲存]。
- 在「確認」對話方塊中,按一下「確認」即可附加標記。
系統會發送通知,確認代碼已更新。
gcloud
如要將標記附加至 Cloud VPN 資源,您必須使用 gcloud resource-manager tags bindings create 指令建立標記繫結資源:
gcloud resource-manager tags bindings create \
--tag-value=TAGVALUE_NAME \
--parent=RESOURCE_ID \
--location=LOCATION
更改下列內容:
TAGVALUE_NAME:附加至資源的標記值永久 ID 或命名空間名稱,例如tagValues/567890123456。-
RESOURCE_ID:資源的完整 ID,包括用於識別資源類型的 API 網域名稱 (//compute.googleapis.com/)。您必須使用資源的數字 ID,而非名稱。例如:
- 全域資源的資源 ID,例如
projects/7890123456中的外部 VPN 閘道 REST 資源,如下所示://compute.googleapis.com/projects/7890123456/global/externalVpnGateways/4567891234 - 區域資源的資源 ID,例如
projects/7890123456中的 VPN 通道 REST 資源,如下所示://compute.googleapis.com/projects/7890123456/regions/REGION/vpnTunnels/6789012345
- 全域資源的資源 ID,例如
LOCATION:資源的位置。如要將標記附加至全域資源 (例如資料夾或專案),請省略這個旗標。如要將標記附加至區域或可用區資源,必須指定位置,例如us-central1(區域) 或us-central1-a(可用區)。
列出附加至資源的標記
您可以查看直接附加至 Cloud VPN 資源或由該資源沿用的標記繫結清單。
控制台
- 前往 Google Cloud 控制台的「Cloud VPN」頁面。
- 選取資源即可查看詳細資料。標記會顯示在「標記」列中。
gcloud
如要取得附加至資源的標記繫結清單,請使用 gcloud resource-manager tags bindings list 指令:
gcloud resource-manager tags bindings list \
--parent=RESOURCE_ID \
--location=LOCATION
更改下列內容:
-
RESOURCE_ID:資源的完整 ID,包括用於識別資源類型的 API 網域名稱 (//compute.googleapis.com/)。您必須使用資源的數字 ID,而非名稱。例如:
- 全域資源的資源 ID,例如
projects/7890123456中的外部 VPN 閘道 REST 資源,如下所示://compute.googleapis.com/projects/7890123456/global/externalVpnGateways/4567891234 - 區域資源的資源 ID,例如
projects/7890123456中的 VPN 通道 REST 資源,如下所示://compute.googleapis.com/projects/7890123456/regions/REGION/vpnTunnels/6789012345
- 全域資源的資源 ID,例如
LOCATION:資源的位置。如果您要查看附加至資料夾或專案等全域性資源的標記,請省略這個旗標。如果查看附加至區域或可用區資源的標記,您必須指定位置,例如us-central1(區域) 或us-central1-a(可用區)。
您應該會收到類似以下的回覆:
name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
tagValue: tagValues/567890123456
resource:
//compute.googleapis.com/projects/7890123456/global/externalVpnGateways/4567891234
從資源中卸離標記
您可以將直接附加至 Cloud VPN 資源的標記分離。如要覆寫繼承的標記,請附加具有相同鍵和不同值的標記,但無法卸離。
控制台
- 前往 Google Cloud 控制台的「Cloud VPN」頁面。
- 選取要移除標記的 Cloud VPN 資源。
- 按一下「代碼」。
- 在「標記」面板中,找出要取消連結的標記,然後按一下旁邊的「刪除項目」。
- 按一下 [儲存]。
- 在「確認」對話方塊中,按一下「確認」即可卸離代碼。
系統會發送通知,確認代碼已更新。
gcloud
如要刪除標記繫結,請使用 gcloud resource-manager tags bindings delete 指令:
gcloud resource-manager tags bindings delete \
--tag-value=TAGVALUE_NAME \
--parent=RESOURCE_ID \
--location=LOCATION
更改下列內容:
TAGVALUE_NAME:附加標記值的永久 ID 或命名空間名稱,例如tagValues/567890123456。-
RESOURCE_ID:資源的完整 ID,包括用於識別資源類型的 API 網域名稱 (//compute.googleapis.com/)。您必須使用資源的數字 ID,而非名稱。例如:
- 全域資源的資源 ID,例如
projects/7890123456中的外部 VPN 閘道 REST 資源,如下所示://compute.googleapis.com/projects/7890123456/global/externalVpnGateways/4567891234 - 區域資源的資源 ID,例如
projects/7890123456中的 VPN 通道 REST 資源,如下所示://compute.googleapis.com/projects/7890123456/regions/REGION/vpnTunnels/6789012345
- 全域資源的資源 ID,例如
LOCATION:資源的位置。如要將標記附加至全域資源 (例如資料夾或專案),請省略這個旗標。如要將標記附加至區域或可用區資源,必須指定位置,例如us-central1(區域) 或us-central1-a(可用區)。
刪除標記鍵和值
移除標記鍵或值定義時,請務必將標記從 Cloud VPN 資源中分離。您必須先刪除現有的標記附件 (稱為標記繫結),才能刪除標記定義本身。如要刪除標記鍵和標記值,請參閱「刪除標記」。
身分與存取權管理條件和標記
您可以使用標記和 IAM 條件,有條件地將角色繫結授予階層中的使用者。如果已套用具有條件式角色繫結的 IAM 政策,變更或刪除附加至資源的標記,可能會移除使用者對該資源的存取權。詳情請參閱「身分與存取權管理條件和標記」。