REST Resource: projects.locations.global.connectivityTests

資源:ConnectivityTest

用於網路可連線性分析的連線能力測試。

JSON 表示法
{
  "name": string,
  "description": string,
  "source": {
    object (Endpoint)
  },
  "destination": {
    object (Endpoint)
  },
  "protocol": string,
  "relatedProjects": [
    string
  ],
  "displayName": string,
  "labels": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "reachabilityDetails": {
    object (ReachabilityDetails)
  },
  "probingDetails": {
    object (ProbingDetails)
  },
  "roundTrip": boolean,
  "returnReachabilityDetails": {
    object (ReachabilityDetails)
  },
  "bypassFirewallChecks": boolean
}
欄位
name

string

ID。資源的專屬名稱,格式為:projects/{projectId}/locations/global/connectivityTests/{test}

description

string

使用者提供的連線能力測試說明。長度上限為 512 個半形字元。

source

object (Endpoint)

這是必要旗標,連線能力測試的來源規格。

您可以結合來源 IP 位址、支援端點的 URI、專案 ID 或虛擬私有雲網路,識別來源位置。

即使來源位置不明確,可達性分析仍可能會繼續進行。不過,測試結果可能包含您不打算測試的端點或來源。

destination

object (Endpoint)

這是必要旗標,連線能力測試的目的地規格。

您可以結合目的地 IP 位址、支援端點的 URI、專案 ID 或 VPC 網路,識別目的地位置。

即使目的地位置不明確,可達性分析仍會繼續進行。不過,測試結果可能包含您不打算測試的端點或目的地。

protocol

string

測試的 IP 通訊協定。如未提供,系統會假設為「TCP」。

relatedProjects[]

string

可能與可及性分析相關的其他專案。這適用於測試可跨越專案界線的情況。

displayName

string

僅供輸出。連線測試的顯示名稱。

labels

map (key: string, value: string)

代表使用者提供中繼資料的資源標籤。

包含 "key": value 組合清單的物件。範例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

createTime

string (Timestamp format)

僅供輸出。測試的建立時間。

使用 RFC 3339,產生的輸出內容一律會經過 Z 標準化,並使用 0、3、6 或 9 個小數位數。系統也接受「Z」以外的偏移量。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

updateTime

string (Timestamp format)

僅供輸出。測試設定的更新時間。

使用 RFC 3339,產生的輸出內容一律會經過 Z 標準化,並使用 0、3、6 或 9 個小數位數。系統也接受「Z」以外的偏移量。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

reachabilityDetails

object (ReachabilityDetails)

僅供輸出。最新一次執行這項測試時的可連線詳細資料。建立新測試、更新現有測試或觸發現有測試的單次重新執行時,系統會更新詳細資料。

probingDetails

object (ProbingDetails)

僅供輸出。這項測試在最近一次執行時的探查詳細資料 (僅適用於適用的測試)。建立新測試、更新現有測試或觸發現有測試的單次重新執行時,系統會更新詳細資料。

roundTrip

boolean

是否要對從目的地到來源的路徑執行分析。預設值是 false。

returnReachabilityDetails

object (ReachabilityDetails)

僅供輸出。最近一次執行回傳路徑測試時,這項測試的可連線詳細資料。建立新測試、更新現有測試或觸發現有測試的單次重新執行時,系統會更新詳細資料。

bypassFirewallChecks

boolean

分析是否應略過防火牆檢查。預設值是 false。

端點

連線能力測試的來源或目的地。

JSON 表示法
{
  "ipAddress": string,
  "port": integer,
  "instance": string,
  "forwardingRule": string,
  "gkeMasterCluster": string,
  "fqdn": string,
  "cloudSqlInstance": string,
  "redisInstance": string,
  "redisCluster": string,
  "alloyDbInstance": string,
  "cloudFunction": {
    object (CloudFunctionEndpoint)
  },
  "appEngineVersion": {
    object (AppEngineVersionEndpoint)
  },
  "cloudRunRevision": {
    object (CloudRunRevisionEndpoint)
  },
  "network": string,
  "networkType": enum (NetworkType),
  "projectId": string,
  "forwardingRuleTarget": enum (ForwardingRuleTarget),
  "loadBalancerId": string,
  "loadBalancerType": enum (LoadBalancerType)
}
欄位
ipAddress

string

端點的 IP 位址,可以是外部或內部 IP。

port

integer

端點的 IP 通訊協定連接埠。僅適用於 TCP 或 UDP 通訊協定。

instance

string

Compute Engine 執行個體 URI。

forwardingRule

string

轉送規則及其對應的 IP 位址代表 Google Cloud 負載平衡器的前端設定。轉送規則也用於通訊協定轉送、Private Service Connect 和其他網路服務,以在控制層中提供轉送資訊。僅適用於目的地端點。格式:projects/{project}/global/forwardingRules/{id} 或 projects/{project}/regions/{region}/forwardingRules/{id}

gkeMasterCluster

string

Google Kubernetes Engine 叢集控制層的叢集 URI。

fqdn

string

Google Kubernetes Engine 叢集控制層的 DNS 端點。必須設定 gkeMasterCluster,且無法同時使用 ipAddress 或 network。僅適用於目的地端點。

cloudSqlInstance

string

Cloud SQL 執行個體 URI。

redisInstance

string

Redis 執行個體 URI。僅適用於目的地端點。

redisCluster

string

Redis 叢集 URI。僅適用於目的地端點。

alloyDbInstance

string

AlloyDB 執行個體 URI。

cloudFunction

object (CloudFunctionEndpoint)

Cloud 函式。僅適用於來源端點。

appEngineVersion

object (AppEngineVersionEndpoint)

App Engine 服務版本。僅適用於來源端點。

cloudRunRevision

object (CloudRunRevisionEndpoint)

Cloud Run 修訂版本。僅適用於來源端點。

network

string

虛擬私有雲網路 URI。

networkType

enum (NetworkType)

端點所在的網路類型。僅適用於來源端點,因為目的地網路類型可從來源推斷。

projectId

string

端點所在的專案 ID。如果您提供端點或網路 URI,專案 ID 可以從 URI 衍生而來。以下是兩種可能需要提供專案 ID 的情況:1. 只指定 IP 位址,且該 IP 位址位於 Google Cloud 專案中。2. 使用共用虛擬私有雲,且您提供的 IP 位址來自服務專案。在本例中,IP 位址所在的網路是在主專案中定義。

forwardingRuleTarget

enum (ForwardingRuleTarget)

僅供輸出。指定轉送規則目標的類型。

loadBalancerId

string

僅供輸出。轉送規則指向的負載平衡器 ID。如果轉送規則與負載平衡器無關,則為空白。

loadBalancerType

enum (LoadBalancerType)

僅供輸出。轉送規則指向的負載平衡器類型。

ForwardingRuleTarget

轉送規則目標的類型。

列舉
FORWARDING_RULE_TARGET_UNSPECIFIED 轉送規則目標不明。
INSTANCE 用於通訊協定轉送的 Compute Engine 執行個體。
LOAD_BALANCER 負載平衡器。特定類型可從 loadBalancerType 找到。
VPN_GATEWAY 傳統版 Cloud VPN 閘道。
PSC 轉送規則是 Private Service Connect 端點。

LoadBalancerType

負載平衡器類型。詳情請參閱 Google Cloud 負載平衡器摘要

列舉
LOAD_BALANCER_TYPE_UNSPECIFIED 轉送規則指向的目標與負載平衡器不同,或負載平衡器類型不明。
HTTPS_ADVANCED_LOAD_BALANCER 全域外部 HTTP(S) 負載平衡器。
HTTPS_LOAD_BALANCER 全域外部 HTTP(S) 負載平衡器 (傳統版)
REGIONAL_HTTPS_LOAD_BALANCER 區域型外部 HTTP(S) 負載平衡器。
INTERNAL_HTTPS_LOAD_BALANCER 內部 HTTP(S) 負載平衡器。
SSL_PROXY_LOAD_BALANCER 外部 SSL Proxy 負載平衡器。
TCP_PROXY_LOAD_BALANCER 外部 TCP Proxy 負載平衡器。
INTERNAL_TCP_PROXY_LOAD_BALANCER 內部區域性 TCP Proxy 負載平衡器。
NETWORK_LOAD_BALANCER 外部 TCP/UDP 網路負載平衡器。
LEGACY_NETWORK_LOAD_BALANCER 以目標集區為基礎的外部 TCP/UDP 網路負載平衡器。
TCP_UDP_INTERNAL_LOAD_BALANCER 內部 TCP/UDP 負載平衡器。

CloudFunctionEndpoint

Cloud Functions 屬性的包裝函式。

JSON 表示法
{
  "uri": string
}
欄位
uri

string

Cloud 函式名稱。

AppEngineVersionEndpoint

App Engine 服務版本屬性的包裝函式。

JSON 表示法
{
  "uri": string
}
欄位
uri

string

App Engine 服務版本名稱。

CloudRunRevisionEndpoint

Cloud Run 修訂版本屬性的包裝函式。

JSON 表示法
{
  "uri": string,
  "serviceUri": string
}
欄位
uri

string

Cloud Run 修訂版本 URI。格式為:projects/{project}/locations/{location}/revisions/{revision}

serviceUri

string

僅供輸出。修訂版本所屬的 Cloud Run 服務 URI。格式為:projects/{project}/locations/{location}/services/{service}

NetworkType

端點網路的型別定義。請使用下列其中一種方式:

列舉
NETWORK_TYPE_UNSPECIFIED 如未指定,則為預設類型。
GCP_NETWORK Google Cloud 內託管的網路。如要取得更詳細的輸出內容,請指定來源或目的地網路的 URI。
NON_GCP_NETWORK 在 Google Cloud 外部代管的網路。可以是內部部署網路、網際網路資源,或是由其他雲端供應商託管的網路。

ReachabilityDetails

上次執行測試時的設定分析結果。

JSON 表示法
{
  "result": enum (Result),
  "verifyTime": string,
  "error": {
    object (Status)
  },
  "traces": [
    {
      object (Trace)
    }
  ]
}
欄位
result

enum (Result)

測試設定分析的整體結果。

verifyTime

string (Timestamp format)

設定分析的時間。

使用 RFC 3339,產生的輸出內容一律會經過 Z 標準化,並使用 0、3、6 或 9 個小數位數。系統也接受「Z」以外的偏移量。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

error

object (Status)

可連線性分析失敗或取消的詳細資料。

traces[]

object (Trace)

如果測試在網路中有多個可能路徑,例如目的地端點是具有多個後端的負載平衡器,結果可能會包含追蹤清單。

結果

測試設定分析的整體結果。

列舉
RESULT_UNSPECIFIED 未指定結果。
REACHABLE

可能的情境包括:

  • 設定分析判定來自來源的封包應會抵達目的地。
  • 由於使用者缺少追蹤記錄中部分資源的權限,因此分析未完成。不過,在使用者權限不足時,追蹤作業已成功完成。
UNREACHABLE 預計來自來源的封包會在抵達目的地前遭捨棄。
AMBIGUOUS 來源和目的地端點無法在網路中唯一識別測試位置,且可連性結果包含多個追蹤記錄。部分追蹤記錄可能會傳送封包,其他則不會。如果傳回路徑本身應為「可連線」,但轉送路徑的設定分析結果為「不明」,系統也會將此結果指派給傳回路徑的設定分析。
UNDETERMINED

設定分析未完成。可能原因如下:

  • 發生權限錯誤,例如使用者可能沒有測試中所有資源的讀取權限。
  • 發生內部錯誤。
  • 分析器收到無效或不支援的引數,或無法識別已知端點。

Trace

追蹤記錄代表一個模擬封包轉送路徑。

  • 每項追蹤記錄都包含多個依序執行的步驟。
  • 每個步驟都處於特定狀態,並具有相關聯的設定。
  • 狀態可分為最終狀態和非最終狀態。
  • 每個最終狀態都有相關聯的原因。
  • 每項追蹤記錄都必須以最終狀態 (最後一個步驟) 結尾。
  |---------------------Trace----------------------|
  Step1(State) Step2(State) ---  StepN(State(final))
JSON 表示法
{
  "endpointInfo": {
    object (EndpointInfo)
  },
  "steps": [
    {
      object (Step)
    }
  ],
  "forwardTraceId": integer
}
欄位
endpointInfo

object (EndpointInfo)

衍生自使用者要求指定的來源和目的地端點定義,並由資料平面模型驗證。如果有多個追蹤記錄從不同來源位置開始,則追蹤記錄之間的 endpointInfo 可能會有所不同。

steps[]

object (Step)

測試的追蹤記錄包含從初始狀態到最終狀態 (已傳送、已捨棄、已轉送或已中止) 的多個步驟。

這些步驟是根據模擬網路狀態機的處理順序排列。請務必保留步驟順序,避免重新排序或排序步驟。

forwardTraceId

integer

追蹤記錄的 ID。如果是正向追蹤,這個 ID 是每個追蹤記錄的專屬 ID。如果是回傳追蹤記錄,則會與相關聯轉送追蹤記錄的 ID 相符。單一轉送追蹤記錄可能沒有、有一或多個回程追蹤記錄。

EndpointInfo

僅供顯示。測試端點的規格。EndpointInfo 是從來源和目的地端點衍生而來,並由後端資料平面模型驗證。

JSON 表示法
{
  "sourceIp": string,
  "destinationIp": string,
  "protocol": string,
  "sourcePort": integer,
  "destinationPort": integer,
  "sourceNetworkUri": string,
  "destinationNetworkUri": string,
  "sourceAgentUri": string
}
欄位
sourceIp

string

來源 IP 位址。

destinationIp

string

目的地 IP 位址。

protocol

string

字串格式的 IP 通訊協定,例如:「TCP」、「UDP」、「ICMP」。

sourcePort

integer

來源通訊埠。僅在通訊協定為 TCP 或 UDP 時有效。

destinationPort

integer

目的地通訊埠。僅在通訊協定為 TCP 或 UDP 時有效。

sourceNetworkUri

string

這個封包的來源網路 URI。

destinationNetworkUri

string

封包傳送至的網路 URI。

sourceAgentUri

string

這個封包的來源遙測代理程式 URI。

步驟

模擬轉送路徑由多個步驟組成。每個步驟都有明確定義的狀態和相關聯的設定。

JSON 表示法
{
  "description": string,
  "state": enum (State),
  "causesDrop": boolean,
  "projectId": string,

  // Union field step_info can be only one of the following:
  "instance": {
    object (InstanceInfo)
  },
  "firewall": {
    object (FirewallInfo)
  },
  "route": {
    object (RouteInfo)
  },
  "endpoint": {
    object (EndpointInfo)
  },
  "googleService": {
    object (GoogleServiceInfo)
  },
  "forwardingRule": {
    object (ForwardingRuleInfo)
  },
  "vpnGateway": {
    object (VpnGatewayInfo)
  },
  "vpnTunnel": {
    object (VpnTunnelInfo)
  },
  "vpcConnector": {
    object (VpcConnectorInfo)
  },
  "directVpcEgressConnection": {
    object (DirectVpcEgressConnectionInfo)
  },
  "serverlessExternalConnection": {
    object (ServerlessExternalConnectionInfo)
  },
  "deliver": {
    object (DeliverInfo)
  },
  "forward": {
    object (ForwardInfo)
  },
  "abort": {
    object (AbortInfo)
  },
  "drop": {
    object (DropInfo)
  },
  "loadBalancer": {
    object (LoadBalancerInfo)
  },
  "network": {
    object (NetworkInfo)
  },
  "gkeMaster": {
    object (GKEMasterInfo)
  },
  "cloudSqlInstance": {
    object (CloudSQLInstanceInfo)
  },
  "redisInstance": {
    object (RedisInstanceInfo)
  },
  "redisCluster": {
    object (RedisClusterInfo)
  },
  "cloudFunction": {
    object (CloudFunctionInfo)
  },
  "appEngineVersion": {
    object (AppEngineVersionInfo)
  },
  "cloudRunRevision": {
    object (CloudRunRevisionInfo)
  },
  "nat": {
    object (NatInfo)
  },
  "proxyConnection": {
    object (ProxyConnectionInfo)
  },
  "loadBalancerBackendInfo": {
    object (LoadBalancerBackendInfo)
  },
  "storageBucket": {
    object (StorageBucketInfo)
  },
  "serverlessNeg": {
    object (ServerlessNegInfo)
  }
  // End of list of possible types for union field step_info.
}
欄位
description

string

步驟說明,通常是狀態摘要。

state

enum (State)

每個步驟都處於預先定義的狀態。

causesDrop

boolean

這是導致最終狀態「捨棄」的步驟。

projectId

string

包含這個步驟要驗證的設定的專案 ID。

聯集欄位 step_info。與每個步驟相關的設定或中繼資料。系統會根據檢視者的權限篩選設定。如果檢視者沒有權限查看這個步驟中的設定,對於非最終狀態,系統會填入特殊狀態 (VIEWER_PERMISSION_MISSING),對於最終狀態,系統則會清除設定。step_info 只能是下列其中一項:
instance

object (InstanceInfo)

顯示 Compute Engine 執行個體的資訊。

firewall

object (FirewallInfo)

顯示 Compute Engine 防火牆規則的資訊。

route

object (RouteInfo)

顯示 Compute Engine 路由的資訊。

endpoint

object (EndpointInfo)

顯示所分析來源和目的地的資訊。中繼狀態的端點資訊可能與初始輸入內容不同,因為這些資訊可能會受到 NAT 或連線 Proxy 等狀態修改。

googleService

object (GoogleServiceInfo)

顯示 Google 服務的資訊

forwardingRule

object (ForwardingRuleInfo)

顯示 Compute Engine 轉送規則的資訊。

vpnGateway

object (VpnGatewayInfo)

顯示 Compute Engine VPN 閘道的資訊。

vpnTunnel

object (VpnTunnelInfo)

顯示 Compute Engine VPN 通道的資訊。

vpcConnector

object (VpcConnectorInfo)

顯示虛擬私有雲連接器的資訊。

directVpcEgressConnection

object (DirectVpcEgressConnectionInfo)

顯示無伺服器直接虛擬私有雲 egress 連線的資訊。

serverlessExternalConnection

object (ServerlessExternalConnectionInfo)

顯示無伺服器公開 (外部) 連線的資訊。

deliver

object (DeliverInfo)

顯示最終狀態「交付」的資訊和原因。

forward

object (ForwardInfo)

顯示最終狀態「轉寄」和原因的資訊。

abort

object (AbortInfo)

顯示最終狀態「中止」的資訊和原因。

drop

object (DropInfo)

顯示最終狀態「drop」的資訊和原因。

loadBalancer
(deprecated)

object (LoadBalancerInfo)

顯示負載平衡器的資訊。已淘汰,並改用 loadBalancerBackendInfo 欄位,不會用於新測試。

network

object (NetworkInfo)

顯示 Google Cloud 網路的資訊。

gkeMaster

object (GKEMasterInfo)

顯示 Google Kubernetes Engine 叢集主節點的資訊。

cloudSqlInstance

object (CloudSQLInstanceInfo)

顯示 Cloud SQL 執行個體的資訊。

redisInstance

object (RedisInstanceInfo)

顯示 Redis 執行個體的資訊。

redisCluster

object (RedisClusterInfo)

顯示 Redis 叢集的資訊。

cloudFunction

object (CloudFunctionInfo)

顯示 Cloud Function 的資訊。

appEngineVersion

object (AppEngineVersionInfo)

顯示 App Engine 服務版本的資訊。

cloudRunRevision

object (CloudRunRevisionInfo)

顯示 Cloud Run 修訂版本的資訊。

nat

object (NatInfo)

顯示 NAT 的資訊。

proxyConnection

object (ProxyConnectionInfo)

顯示 ProxyConnection 的資訊。

loadBalancerBackendInfo

object (LoadBalancerBackendInfo)

顯示特定負載平衡器後端的資訊。

storageBucket

object (StorageBucketInfo)

顯示 Storage Bucket 的資訊。僅用於回傳追蹤記錄。

serverlessNeg

object (ServerlessNegInfo)

顯示無伺服器網路端點群組後端的資訊。僅用於回傳追蹤記錄。

狀態

網路狀態機中定義的狀態類型。封包追蹤中的每個步驟都處於特定狀態。

列舉
STATE_UNSPECIFIED 未指定狀態。
START_FROM_INSTANCE 初始狀態:封包來自 Compute Engine 執行個體。InstanceInfo 會填入啟動執行個體資訊。
START_FROM_INTERNET 初始狀態:來自網際網路的封包。系統會填入端點資訊。
START_FROM_GOOGLE_SERVICE 初始狀態:封包源自 Google 服務。系統會填入 googleService 資訊。
START_FROM_PRIVATE_NETWORK 初始狀態:封包來自虛擬私有雲或內部部署網路,且具有內部來源 IP。如果來源是使用者可見的 VPC 網路,NetworkInfo 會填入網路詳細資料。
START_FROM_GKE_MASTER 初始狀態:封包來自 Google Kubernetes Engine 叢集主節點。系統會填入啟動執行個體資訊的 GKEMasterInfo。
START_FROM_CLOUD_SQL_INSTANCE 初始狀態:封包來自 Cloud SQL 執行個體。系統會填入 CloudSQLInstanceInfo,其中包含啟動執行個體的資訊。
START_FROM_REDIS_INSTANCE 初始狀態:封包來自 Redis 執行個體。RedisInstanceInfo 會填入啟動執行個體資訊。
START_FROM_REDIS_CLUSTER 初始狀態:封包來自 Redis 叢集。RedisClusterInfo 會填入起始叢集資訊。
START_FROM_CLOUD_FUNCTION 初始狀態:封包來自 Cloud Functions。系統會填入起始函式資訊的 CloudFunctionInfo。
START_FROM_APP_ENGINE_VERSION 初始狀態:封包來自 App Engine 服務版本。系統會填入起始版本資訊的 AppEngineVersionInfo。
START_FROM_CLOUD_RUN_REVISION 初始狀態:封包來自 Cloud Run 修訂版本。系統會填入 CloudRunRevisionInfo,其中包含起始修訂版本資訊。
START_FROM_STORAGE_BUCKET 初始狀態:封包來自 Storage Bucket。僅用於傳回追蹤記錄。系統會填入 storageBucket 資訊。
START_FROM_PSC_PUBLISHED_SERVICE 初始狀態:封包來自使用 Private Service Connect 的已發布服務。僅用於傳回追蹤記錄。
START_FROM_SERVERLESS_NEG 初始狀態:封包來自無伺服器網路端點群組後端。僅用於傳回追蹤記錄。系統會填入無伺服器 NEG 資訊。
APPLY_INGRESS_FIREWALL_RULE 設定檢查狀態:驗證輸入防火牆規則。
APPLY_EGRESS_FIREWALL_RULE 設定檢查狀態:驗證輸出防火牆規則。
APPLY_ROUTE 設定檢查狀態:驗證路徑。
APPLY_FORWARDING_RULE 設定檢查狀態:符合轉送規則。
ANALYZE_LOAD_BALANCER_BACKEND 檢查設定狀態:驗證負載平衡器後端設定。
SPOOFING_APPROVED 設定檢查狀態:傳送或接收具備外部 IP 位址的封包,且允許這麼做。
ARRIVE_AT_INSTANCE 轉送狀態:抵達 Compute Engine 執行個體。
ARRIVE_AT_INTERNAL_LOAD_BALANCER

轉送狀態:抵達 Compute Engine 內部負載平衡器。已淘汰,並改用 ANALYZE_LOAD_BALANCER_BACKEND 狀態,不會用於新測試。

ARRIVE_AT_EXTERNAL_LOAD_BALANCER

轉送狀態:抵達 Compute Engine 外部負載平衡器。已淘汰,並改用 ANALYZE_LOAD_BALANCER_BACKEND 狀態,不會用於新測試。

ARRIVE_AT_VPN_GATEWAY 轉送狀態:抵達 Cloud VPN 閘道。
ARRIVE_AT_VPN_TUNNEL 轉送狀態:抵達 Cloud VPN 通道。
ARRIVE_AT_VPC_CONNECTOR 轉送狀態:抵達虛擬私有雲連接器。
DIRECT_VPC_EGRESS_CONNECTION 轉送狀態:適用於透過直接虛擬私有雲輸出轉送的無伺服器端點封包。
SERVERLESS_EXTERNAL_CONNECTION 轉送狀態:適用於透過公用 (外部) 連線轉送的無伺服器端點封包。
NAT 過渡狀態:封包標頭已翻譯。
PROXY_CONNECTION 轉換狀態:原始連線終止,並啟動新的 Proxy 連線。
DELIVER 最終狀態:封包可能已傳送。
DROP 最終狀態:封包可能遭到捨棄。
FORWARD 最終狀態:封包可能會轉送至設定不明的網路。
ABORT 最終狀態:分析已取消。
VIEWER_PERMISSION_MISSING 特殊狀態:測試結果檢視者沒有權限查看這個步驟的設定。

InstanceInfo

僅供顯示。與 Compute Engine 執行個體相關聯的中繼資料。

JSON 表示法
{
  "displayName": string,
  "uri": string,
  "interface": string,
  "networkUri": string,
  "internalIp": string,
  "externalIp": string,
  "networkTags": [
    string
  ],
  "serviceAccount": string,
  "pscNetworkAttachmentUri": string,
  "running": boolean,
  "status": enum (Status)
}
欄位
displayName

string

Compute Engine 執行個體的名稱。

uri

string

Compute Engine 執行個體的 URI。

interface

string

Compute Engine 執行個體的網路介面名稱。

networkUri

string

Compute Engine 網路的 URI。

internalIp

string

網路介面的內部 IP 位址。

externalIp

string

網路介面的外部 IP 位址。

networkTags[]

string

在執行個體上設定的網路標記。

serviceAccount
(deprecated)

string

執行個體已授權的服務帳戶。

pscNetworkAttachmentUri

string

NIC 所連結的 PSC 網路連結 URI (如適用)。

running
(deprecated)

boolean

指出 Compute Engine 執行個體是否正在執行。已淘汰:請改用 status 欄位。

status

enum (Status)

執行個體的狀態。

狀態

執行個體的狀態。我們會將「RUNNING」以外的所有狀態視為未執行。

列舉
STATUS_UNSPECIFIED 預設未指定的值。
RUNNING 執行個體正在執行。
NOT_RUNNING 執行個體處於「RUNNING」以外的任何狀態。

FirewallInfo

僅供顯示。與虛擬私有雲防火牆規則、默示虛擬私有雲防火牆規則或防火牆政策規則相關聯的元資料。

JSON 表示法
{
  "displayName": string,
  "uri": string,
  "direction": string,
  "action": string,
  "priority": integer,
  "networkUri": string,
  "targetTags": [
    string
  ],
  "targetServiceAccounts": [
    string
  ],
  "policy": string,
  "policyUri": string,
  "firewallRuleType": enum (FirewallRuleType),
  "policyPriority": integer
}
欄位
displayName

string

防火牆規則的顯示名稱。防火牆政策規則的這項欄位可能為空白。

uri

string

防火牆規則的 URI。這個欄位不適用於隱含的虛擬私有雲防火牆規則。

direction

string

可能的值:INGRESS、EGRESS

action

string

可能的值:ALLOW、DENY、APPLY_SECURITY_PROFILE_GROUP

priority

integer

防火牆規則的優先順序。

networkUri

string

防火牆規則相關聯的虛擬私有雲網路 URI。這個欄位不適用於階層式防火牆政策規則。

targetTags[]

string

虛擬私有雲防火牆規則定義的目標標記。這個欄位不適用於防火牆政策規則。

targetServiceAccounts[]

string

防火牆規則指定的目標服務帳戶。

policy

string

這項規則相關聯的防火牆政策名稱。這個欄位不適用於虛擬私有雲防火牆規則和隱含的虛擬私有雲防火牆規則。

policyUri

string

這項規則相關聯的防火牆政策 URI。這個欄位不適用於虛擬私有雲防火牆規則和隱含的虛擬私有雲防火牆規則。

firewallRuleType

enum (FirewallRuleType)

防火牆規則的類型。

policyPriority

integer

這項規則所屬防火牆政策的優先順序。這個欄位不適用於虛擬私有雲防火牆規則和隱含的虛擬私有雲防火牆規則。

FirewallRuleType

防火牆規則的類型。

列舉
FIREWALL_RULE_TYPE_UNSPECIFIED 未指定類型。
HIERARCHICAL_FIREWALL_POLICY_RULE 階層式防火牆政策規則。詳情請參閱階層式防火牆政策總覽
VPC_FIREWALL_RULE 虛擬私有雲防火牆規則。詳情請參閱 VPC 防火牆規則總覽
IMPLIED_VPC_FIREWALL_RULE 默示虛擬私有雲防火牆規則。詳情請參閱隱含規則
SERVERLESS_VPC_ACCESS_MANAGED_FIREWALL_RULE 由無伺服器虛擬私有雲存取權管理的隱含防火牆規則,可允許輸入存取權。Google Cloud 控制台不會顯示這些項目。詳情請參閱 VPC 連接器的隱含規則
NETWORK_FIREWALL_POLICY_RULE 全域網路防火牆政策規則。詳情請參閱網路防火牆政策
NETWORK_REGIONAL_FIREWALL_POLICY_RULE 區域網路防火牆政策規則。詳情請參閱區域網路防火牆政策
UNSUPPORTED_FIREWALL_POLICY_RULE 防火牆政策規則包含 Connectivity Tests 尚未支援的屬性。如果這類規則可能相符,系統就會略過防火牆分析。請參閱不支援的設定清單
TRACKING_STATE 追蹤要求流量通過允許防火牆規則時建立的回應流量狀態。詳情請參閱防火牆規則規格
ANALYSIS_SKIPPED 由於連線能力測試是在 BypassFirewallChecks 模式下執行,因此略過防火牆分析

RouteInfo

僅供顯示。與 Compute Engine 路由相關聯的中繼資料。

JSON 表示法
{
  "routeType": enum (RouteType),
  "nextHopType": enum (NextHopType),
  "routeScope": enum (RouteScope),
  "displayName": string,
  "uri": string,
  "region": string,
  "destIpRange": string,
  "nextHop": string,
  "networkUri": string,
  "priority": integer,
  "instanceTags": [
    string
  ],
  "srcIpRange": string,
  "destPortRanges": [
    string
  ],
  "srcPortRanges": [
    string
  ],
  "protocols": [
    string
  ],
  "nextHopUri": string,
  "nextHopNetworkUri": string,
  "originatingRouteUri": string,
  "originatingRouteDisplayName": string,
  "nccHubRouteUri": string,
  "nccHubUri": string,
  "nccSpokeUri": string,
  "advertisedRouteSourceRouterUri": string,
  "advertisedRouteNextHopUri": string
}
欄位
routeType

enum (RouteType)

路線類型。

nextHopType

enum (NextHopType)

下一個躍點的類型。

routeScope
(deprecated)

enum (RouteScope)

指出路線適用範圍。已淘汰,新測試的追蹤記錄中不會包含 NCC_HUB 範圍的路由。

displayName

string

路線名稱。

uri

string

路線的 URI。僅限 SUBNET、STATIC、PEERING_SUBNET (僅適用於對等互連網路) 和 POLICY_BASED 路徑。

region

string

路線的區域。僅限 DYNAMIC、PEERING_DYNAMIC、POLICY_BASED 和 ADVERTISED 路徑。如果為 POLICY_BASED 路由設定,這是 Cloud Interconnect 的 VLAN 連結區域,路由會套用至該區域。

destIpRange

string

路徑的目的地 IP 範圍。

nextHop
(deprecated)

string

路徑下一個躍點的字串類型 (例如「VPN 通道」)。已淘汰,改用 nextHopType 和 nextHopUri 欄位,新測試不會使用。

networkUri

string

路徑所在的虛擬私有雲網路 URI。

priority

integer

路徑的優先順序。

instanceTags[]

string

路徑的執行個體標記。

srcIpRange

string

路徑的來源 IP 位址範圍。僅限 POLICY_BASED 路由。

destPortRanges[]

string

路徑的目的地通訊埠範圍。僅限 POLICY_BASED 路由。

srcPortRanges[]

string

路徑的來源通訊埠範圍。僅限 POLICY_BASED 路由。

protocols[]

string

路線的通訊協定。僅限 POLICY_BASED 路由。

nextHopUri

string

下一個躍點資源的 URI。

nextHopNetworkUri

string

下一個躍點資源所在的虛擬私有雲網路 URI。

originatingRouteUri

string

如果是 PEERING_SUBNET 和 PEERING_STATIC 路徑,則為原始 SUBNET/STATIC 路徑的 URI。

originatingRouteDisplayName

string

如果是 PEERING_SUBNET、PEERING_STATIC 和 PEERING_DYNAMIC 路徑,則為原始 SUBNET/STATIC/DYNAMIC 路徑的名稱。

nccHubRouteUri

string

如果是 NCC 中樞通告的 PEERING_SUBNET 和 PEERING_DYNAMIC 路由,則為 NCC 中樞路由表中的對應路由 URI。

nccHubUri

string

路徑通告的 NCC 中樞 URI。僅由 NCC 中樞通告的 PEERING_SUBNET 和 PEERING_DYNAMIC 路由。

nccSpokeUri

string

目的地 NCC 輪輻的 URI。僅由 NCC 中樞通告的 PEERING_SUBNET 和 PEERING_DYNAMIC 路由。

advertisedRouteSourceRouterUri

string

如果是「已通告」的動態路徑,則為通告對應 IP 前置字串的 Cloud Router URI。

advertisedRouteNextHopUri
(deprecated)

string

如果是 ADVERTISED 路由,則為下一個躍點的 URI,也就是通告前置字串所透過的混合式端點 (VPN 通道、互連網路連結、NCC 路由器設備) URI,或是來源對等互連網路的 URI。已淘汰,改用 nextHopUri 欄位,新測試不會使用。

RouteType

路線類型:

列舉
ROUTE_TYPE_UNSPECIFIED 未指定類型。預設值。
SUBNET 路徑是系統自動建立的子網路路徑。
STATIC 使用者建立的靜態路徑,包括連往網際網路的預設路徑。
DYNAMIC 在 BGP 對等互連之間交換的動態路徑。
PEERING_SUBNET 從對等互連網路或 NCC 中樞收到的子網路路徑。
PEERING_STATIC 從對等互連網路收到的靜態路徑。
PEERING_DYNAMIC 從對等互連網路或 NCC 中樞收到的動態路徑。
POLICY_BASED 策略路徑。
ADVERTISED Advertise 路由。用於從連線能力測試中的 StartFromPrivateNetwork 狀態轉換的合成路徑。

NextHopType

下一個躍點類型:

列舉
NEXT_HOP_TYPE_UNSPECIFIED 未指定類型。預設值。
NEXT_HOP_IP 下一個躍點是 IP 位址。
NEXT_HOP_INSTANCE 下一個躍點是 Compute Engine 執行個體。
NEXT_HOP_NETWORK 下一個躍點是虛擬私有雲網路閘道。
NEXT_HOP_PEERING 下一個躍點是對等互連的虛擬私有雲。只有在使用者沒有下一個躍點資源所在專案的權限時,才會發生這種情況。
NEXT_HOP_INTERCONNECT 下一個躍點是互連網路。
NEXT_HOP_VPN_TUNNEL 下一個躍點是 VPN 通道。
NEXT_HOP_VPN_GATEWAY 下一個躍點是 VPN 閘道。只有在透過 VPN 從地端部署網路追蹤連線至 Google Cloud 時,才會發生這種情況。這項分析會模擬封包透過 VPN 通道從內部部署網路傳輸,並抵達 Cloud VPN 閘道。
NEXT_HOP_INTERNET_GATEWAY 下一個躍點是網際網路閘道。
NEXT_HOP_BLACKHOLE 下一個躍點為黑洞,也就是下一個躍點不存在或無法使用。
NEXT_HOP_ILB 下一個躍點是內部負載平衡器的轉送規則。
NEXT_HOP_ROUTER_APPLIANCE 下一個躍點是路由器設備執行個體
NEXT_HOP_NCC_HUB 下一個躍點是 NCC 中樞。只有在使用者沒有下一個躍點資源所在專案的權限時,才會發生這種情況。
SECURE_WEB_PROXY_GATEWAY 下一個躍點是 Secure Web Proxy 閘道。

RouteScope

指出適用路徑的位置。

列舉
ROUTE_SCOPE_UNSPECIFIED 未指定範圍。預設值。
NETWORK 路徑適用於網路中的封包。
NCC_HUB 此路由適用於使用 NCC 中樞路由資料表的封包。

GoogleServiceInfo

僅供顯示。Google 服務將封包傳送至虛擬私有雲網路的詳細資料。雖然來源 IP 可能是可公開路由傳送的位址,但部分 Google 服務會使用 Google 生產基礎架構內的特殊路徑,連線至 Compute Engine 執行個體。https://cloud.google.com/vpc/docs/routes#special_return_paths

JSON 表示法
{
  "sourceIp": string,
  "googleServiceType": enum (GoogleServiceType)
}
欄位
sourceIp

string

來源 IP 位址。

googleServiceType

enum (GoogleServiceType)

Google 服務的已辨識類型。

GoogleServiceType

Google 服務的已辨識類型。

列舉
GOOGLE_SERVICE_TYPE_UNSPECIFIED 未指定 Google 服務。
IAP Identity-Aware Proxy。https://cloud.google.com/iap/docs/using-tcp-forwarding
GFE_PROXY_OR_HEALTH_CHECK_PROBER 與兩個服務共用 IP 範圍:* 負載平衡器 Proxy * 集中式健康狀態檢查探測器 https://cloud.google.com/load-balancing/docs/firewall-rules
CLOUD_DNS 從 Cloud DNS 連線至使用私人路由的轉送目標或替代名稱伺服器。https://cloud.google.com/dns/docs/zones/forwarding-zones#firewall-rules https://cloud.google.com/dns/docs/policies#firewall-rules
GOOGLE_API private.googleapis.com 和 restricted.googleapis.com
GOOGLE_API_PSC 透過 Private Service Connect 存取 Google API。https://cloud.google.com/vpc/docs/configure-private-service-connect-apis
GOOGLE_API_VPC_SC 透過 VPC Service Controls 使用 Google API。https://cloud.google.com/vpc/docs/configure-private-service-connect-apis
SERVERLESS_VPC_ACCESS 透過無伺服器 VPC 存取使用 Google API。https://cloud.google.com/vpc/docs/serverless-vpc-access

ForwardingRuleInfo

僅供顯示。與 Compute Engine 轉送規則相關聯的中繼資料。

JSON 表示法
{
  "displayName": string,
  "uri": string,
  "matchedProtocol": string,
  "matchedPortRange": string,
  "vip": string,
  "target": string,
  "networkUri": string,
  "region": string,
  "loadBalancerName": string,
  "pscServiceAttachmentUri": string,
  "pscGoogleApiTarget": string
}
欄位
displayName

string

轉送規則的名稱。

uri

string

轉送規則的 URI。

matchedProtocol

string

與封包相符的轉送規則中定義的通訊協定。

matchedPortRange

string

與封包相符的轉送規則中定義的通訊埠範圍。

vip

string

轉送規則的 VIP。

target

string

轉送規則的目標類型。

networkUri

string

網路 URI。

region

string

轉送規則的區域。僅適用於區域轉送規則。

loadBalancerName

string

轉送規則所屬的負載平衡器名稱。如果轉送規則與負載平衡器無關 (例如 PSC 轉送規則),則為空白。

pscServiceAttachmentUri

string

這項轉送規則的目標 PSC 服務連結 URI (如適用)。

pscGoogleApiTarget

string

這項轉送規則的 PSC Google API 目標 (如適用)。

VpnGatewayInfo

僅供顯示。與 Compute Engine VPN 閘道相關聯的中繼資料。

JSON 表示法
{
  "displayName": string,
  "uri": string,
  "networkUri": string,
  "ipAddress": string,
  "vpnTunnelUri": string,
  "region": string
}
欄位
displayName

string

VPN 閘道的名稱。

uri

string

VPN 閘道的 URI。

networkUri

string

設定 VPN 閘道的 Compute Engine 網路 URI。

ipAddress

string

VPN 閘道的 IP 位址。

vpnTunnelUri

string

與這個 VPN 閘道相關聯的 VPN 通道。VPN 閘道上可能設定了多個 VPN 通道,但系統只會顯示與測試相關的通道。

region

string

設定這個 VPN 閘道的 Google Cloud 地區名稱。

VpnTunnelInfo

僅供顯示。與 Compute Engine VPN 通道相關聯的中繼資料。

JSON 表示法
{
  "displayName": string,
  "uri": string,
  "sourceGateway": string,
  "remoteGateway": string,
  "remoteGatewayIp": string,
  "sourceGatewayIp": string,
  "networkUri": string,
  "region": string,
  "routingType": enum (RoutingType)
}
欄位
displayName

string

VPN 通道的名稱。

uri

string

VPN 通道的 URI。

sourceGateway

string

通道本機端的 VPN 閘道 URI。

remoteGateway

string

通道遠端 VPN 閘道的 URI。

remoteGatewayIp

string

遠端 VPN 閘道的 IP 位址。

sourceGatewayIp

string

本機 VPN 閘道的 IP 位址。

networkUri

string

設定 VPN 通道的 Compute Engine 網路 URI。

region

string

設定這個 VPN 通道的 Google Cloud 地區名稱。

routingType

enum (RoutingType)

轉送政策類型。

RoutingType

VPN 轉送政策類型。詳情請參閱「網路和通道轉送」。

列舉
ROUTING_TYPE_UNSPECIFIED 未指定類型。預設值。
ROUTE_BASED 依據路徑的 VPN。
POLICY_BASED 依據政策的轉送。
DYNAMIC 動態 (BGP) 轉送。

VpcConnectorInfo

僅供顯示。與虛擬私有雲連接器相關聯的中繼資料。

JSON 表示法
{
  "displayName": string,
  "uri": string,
  "location": string
}
欄位
displayName

string

虛擬私有雲連接器的名稱。

uri

string

虛擬私有雲連接器的 URI。

location

string

部署虛擬私有雲連接器的位置。

DirectVpcEgressConnectionInfo

僅供顯示。與無伺服器直接虛擬私有雲 egress 連線相關聯的中繼資料。

JSON 表示法
{
  "networkUri": string,
  "subnetworkUri": string,
  "selectedIpRange": string,
  "selectedIpAddress": string,
  "region": string
}
欄位
networkUri

string

直接存取網路的 URI。

subnetworkUri

string

直接存取子網路的 URI。

selectedIpRange

string

選取的 IP 範圍。

selectedIpAddress

string

所選 IP 範圍的起始 IP 位址。

region

string

部署直接虛擬私有雲輸出流量的區域。

ServerlessExternalConnectionInfo

僅供顯示。與無伺服器公開連線相關聯的中繼資料。

JSON 表示法
{
  "selectedIpAddress": string
}
欄位
selectedIpAddress

string

從 Google 動態位址集區選取的起始 IP 位址。

DeliverInfo

最終狀態「交付」的詳細資料和相關聯的資源。

JSON 表示法
{
  "target": enum (Target),
  "resourceUri": string,
  "ipAddress": string,
  "storageBucket": string,
  "pscGoogleApiTarget": string,
  "googleServiceType": enum (GoogleServiceType)
}
欄位
target

enum (Target)

封包傳送至的目標類型。

resourceUri

string

封包傳送至的資源 URI。

ipAddress

string

目標的 IP 位址 (如適用)。

storageBucket

string

封包傳送至的 Cloud Storage Bucket 名稱 (如適用)。

pscGoogleApiTarget

string

封包傳送至的 PSC Google API 目標 (如適用)。

googleServiceType

enum (GoogleServiceType)

封包傳送至的 Google 服務類型 (如適用)。

目標

放送目標類型:

列舉
TARGET_UNSPECIFIED 未指定目標。
INSTANCE 目標是 Compute Engine 執行個體。
INTERNET 目標是網際網路。
GOOGLE_API 目標是 Google API。
GKE_MASTER 目標是 Google Kubernetes Engine 叢集主節點。
CLOUD_SQL_INSTANCE 目標是 Cloud SQL 執行個體。
PSC_PUBLISHED_SERVICE 目標是使用 Private Service Connect 發布的服務。
PSC_GOOGLE_API 目標是使用 Private Service Connect 的 Google API。
PSC_VPC_SC 目標是使用 Private Service Connect 的 VPC-SC。
SERVERLESS_NEG 目標是無伺服器網路端點群組。
STORAGE_BUCKET 目標是 Cloud Storage 值區。
PRIVATE_NETWORK 目標是私人網路。僅用於傳回追蹤記錄。
CLOUD_FUNCTION 目標是 Cloud Function。僅用於傳回追蹤記錄。
APP_ENGINE_VERSION 目標是 App Engine 服務版本。僅用於傳回追蹤記錄。
CLOUD_RUN_REVISION 目標是 Cloud Run 修訂版本。僅用於傳回追蹤記錄。
GOOGLE_MANAGED_SERVICE Target 是由 Google 代管的服務。僅用於傳回追蹤記錄。
REDIS_INSTANCE 目標是 Redis 執行個體。
REDIS_CLUSTER 目標是 Redis 叢集。

GoogleServiceType

Google 服務的已辨識類型。

列舉
GOOGLE_SERVICE_TYPE_UNSPECIFIED 未指定 Google 服務。
IAP Identity-Aware Proxy。https://cloud.google.com/iap/docs/using-tcp-forwarding
GFE_PROXY_OR_HEALTH_CHECK_PROBER 與兩個服務共用 IP 範圍:* 負載平衡器 Proxy * 集中式健康狀態檢查探測器 https://cloud.google.com/load-balancing/docs/firewall-rules
CLOUD_DNS 從 Cloud DNS 連線至使用私人路由的轉送目標或替代名稱伺服器。https://cloud.google.com/dns/docs/zones/forwarding-zones#firewall-rules https://cloud.google.com/dns/docs/policies#firewall-rules
PRIVATE_GOOGLE_ACCESS private.googleapis.com 和 restricted.googleapis.com
SERVERLESS_VPC_ACCESS 透過無伺服器 VPC 存取使用 Google API。https://cloud.google.com/vpc/docs/serverless-vpc-access

ForwardInfo

最終狀態「轉送」和相關聯資源的詳細資料。

JSON 表示法
{
  "target": enum (Target),
  "resourceUri": string,
  "ipAddress": string
}
欄位
target

enum (Target)

封包轉送至的目標類型。

resourceUri

string

封包轉送目的地的資源 URI。

ipAddress

string

目標的 IP 位址 (如適用)。

目標

轉送目標類型。

列舉
TARGET_UNSPECIFIED 未指定目標。
PEERING_VPC 轉送至虛擬私有雲對等互連網路。
VPN_GATEWAY 轉送至 Cloud VPN 閘道。
INTERCONNECT 轉送至 Cloud Interconnect 連線。
GKE_MASTER

轉送至 Google Kubernetes Engine 容器叢集主節點。

IMPORTED_CUSTOM_ROUTE_NEXT_HOP 已轉送至自訂路徑的下一個躍點,這個自訂路徑是從對等互連虛擬私有雲匯入。
CLOUD_SQL_INSTANCE

轉送至 Cloud SQL 執行個體。

ANOTHER_PROJECT 轉送至其他專案中的虛擬私有雲網路。
NCC_HUB 轉送至 NCC 中樞。
ROUTER_APPLIANCE 轉送至路由器設備。
SECURE_WEB_PROXY_GATEWAY 轉送至 Secure Web Proxy 閘道。

AbortInfo

最終狀態「中止」和相關聯資源的詳細資料。

JSON 表示法
{
  "cause": enum (Cause),
  "resourceUri": string,
  "ipAddress": string,
  "projectsMissingPermission": [
    string
  ]
}
欄位
cause

enum (Cause)

分析作業遭終止的原因。

resourceUri

string

導致中止的資源 URI。

ipAddress

string

導致中止的 IP 位址。

projectsMissingPermission[]

string

使用者在要求中指定但無權存取的專案 ID 清單。在這種情況下,系統會因 PERMISSION_DENIED 原因而中止分析。

原因

中止原因類型:

列舉
CAUSE_UNSPECIFIED 原因不明。
UNKNOWN_NETWORK

因不明網路而中止。已淘汰,新測試不會使用。

UNKNOWN_PROJECT

無法從測試輸入內容取得專案資訊,因此作業已取消。已淘汰,新測試不會使用。

NO_EXTERNAL_IP

流量是從公開 IP 傳送至沒有外部 IP 的執行個體,因此作業已取消。已淘汰,新測試不會使用。

UNINTENDED_DESTINATION

沒有任何追蹤記錄符合輸入測試要求中指定的目的地資訊,因此作業已取消。已淘汰,新測試不會使用。

SOURCE_ENDPOINT_NOT_FOUND

找不到來源端點,因此作業已取消。已淘汰,新測試不會使用。

MISMATCHED_SOURCE_NETWORK

來源網路與來源端點不符,因此作業已取消。已淘汰,新測試不會使用。

DESTINATION_ENDPOINT_NOT_FOUND

找不到目的地端點,因此作業已取消。已淘汰,新測試不會使用。

MISMATCHED_DESTINATION_NETWORK

目的地網路與目的地端點不符,因此作業已取消。已淘汰,新測試不會使用。

UNKNOWN_IP 找不到含有封包目的地 IP 位址的端點,因此已取消作業。
GOOGLE_MANAGED_SERVICE_UNKNOWN_IP Google 代管的專案中找不到封包目的地 IP 的端點,因此已取消作業。
SOURCE_IP_ADDRESS_NOT_IN_SOURCE_NETWORK 來源 IP 位址不屬於來源虛擬私有雲網路的任何子網路,因此已取消作業。
PERMISSION_DENIED 使用者的權限不足,無法存取執行測試所需的所有或部分網路設定,因此已取消作業。
PERMISSION_DENIED_NO_CLOUD_NAT_CONFIGS 使用者的權限不足,無法存取執行測試所需的 Cloud NAT 設定,因此作業已取消。
PERMISSION_DENIED_NO_NEG_ENDPOINT_CONFIGS 使用者的權限不足,無法存取執行測試所需的網路端點群組端點設定,因此作業已取消。
PERMISSION_DENIED_NO_CLOUD_ROUTER_CONFIGS 使用者的權限不足,無法存取執行測試所需的 Cloud Router 設定,因此作業已取消。
NO_SOURCE_LOCATION 無法從輸入測試要求取得有效的來源或目的地端點,因此作業已取消。
INVALID_ARGUMENT 要求中指定的來源或目的地端點無效,因此作業已取消。舉例來說,要求可能含有格式錯誤的資源 URI、專案 ID 或 IP 位址。- 要求可能包含不一致的資訊 (例如,要求可能同時包含執行個體和網路,但執行個體可能沒有該網路中的 NIC)。
TRACE_TOO_LONG 追蹤記錄中的步驟數量超出特定上限,因此作業已取消。這可能是因為轉送迴圈。
INTERNAL_ERROR 發生內部伺服器錯誤,因此作業已取消。
UNSUPPORTED 因為測試環境不受支援而取消。
MISMATCHED_IP_VERSION 來源和目的地資源沒有共通的 IP 版本,因此模擬作業已取消。
GKE_KONNECTIVITY_PROXY_UNSUPPORTED 由於控制層與來源叢集節點之間的連線是由節點啟動,並由 Konnectivity Proxy 管理,因此已取消模擬。
RESOURCE_CONFIG_NOT_FOUND 缺少預期的資源設定,因此已取消。
VM_INSTANCE_CONFIG_NOT_FOUND 缺少應有的 VM 執行個體設定,因此已取消作業。
NETWORK_CONFIG_NOT_FOUND 缺少應有的網路設定,因此已取消作業。
FIREWALL_CONFIG_NOT_FOUND 缺少應有的防火牆設定,因此已取消作業。
ROUTE_CONFIG_NOT_FOUND 缺少應有的路徑設定,因此已取消作業。
GOOGLE_MANAGED_SERVICE_AMBIGUOUS_PSC_ENDPOINT Google 代管服務的 PSC 端點選項不明確 (數個 PSC 端點符合測試輸入內容),因此作業已取消。
GOOGLE_MANAGED_SERVICE_AMBIGUOUS_ENDPOINT 為 Google 代管服務選取的端點不明確 (數個端點符合測試輸入內容),因此作業已取消。
SOURCE_PSC_CLOUD_SQL_UNSUPPORTED 測試來源是以 PSC 為基礎的 Cloud SQL 執行個體,但系統不支援這類測試,因此作業已取消。
SOURCE_REDIS_CLUSTER_UNSUPPORTED 不支援來源為 Redis 叢集的測試,因此已取消作業。
SOURCE_REDIS_INSTANCE_UNSUPPORTED 不支援來源為 Redis 執行個體的測試,因此已取消作業。
SOURCE_FORWARDING_RULE_UNSUPPORTED 系統不支援測試以轉送規則做為來源,因此作業已取消。
NON_ROUTABLE_IP_ADDRESS 已取消模擬作業,因為某個端點為無法轉送的 IP 位址 (回送、連結本機等)。
UNKNOWN_ISSUE_IN_GOOGLE_MANAGED_PROJECT Google 代管的專案發生不明問題,模擬作業已取消。
UNSUPPORTED_GOOGLE_MANAGED_PROJECT_CONFIG Google 代管的專案不支援特定設定,模擬作業已取消。
NO_SERVERLESS_IP_RANGES 來源端點是啟用直接虛擬私有雲存取的 Cloud Run 修訂版本,但沒有保留的無伺服器 IP 範圍,因此作業已取消。

DropInfo

最終狀態「drop」和相關聯資源的詳細資料。

JSON 表示法
{
  "cause": enum (Cause),
  "resourceUri": string,
  "sourceIp": string,
  "destinationIp": string,
  "region": string
}
欄位
cause

enum (Cause)

導致封包遭到捨棄。

resourceUri

string

導致捨棄的資源 URI。

sourceIp

string

遭捨棄封包的來源 IP 位址 (如適用)。

destinationIp

string

遭捨棄封包的目的地 IP 位址 (如適用)。

region

string

丟棄封包的區域 (如適用)。

原因

捨棄原因類型:

列舉
CAUSE_UNSPECIFIED 原因不明。
UNKNOWN_EXTERNAL_ADDRESS 無法將目的地外部位址解析為已知的目標。如果該地址用於 Google Cloud 專案,請提供專案 ID 做為測試輸入內容。
FOREIGN_IP_DISALLOWED 「ip_forward」啟用之後,Compute Engine 執行個體只能傳送或接收具備外部 IP 位址的封包。
FIREWALL_RULE 因防火牆規則而捨棄,除非基於連線追蹤允許。
NO_ROUTE 因沒有相符路徑而捨棄封包。
ROUTE_BLACKHOLE 因路徑無效而捨棄封包,路徑的下一個躍點為黑洞。
ROUTE_WRONG_NETWORK 封包已傳送至錯誤 (非預期) 的網路。舉例來說,您從 VM1:Network1 追蹤封包到 VM2:Network2,但 Network1 中設定的路徑會將目的地為 VM2 IP 位址的封包傳送到 Network3。
ROUTE_NEXT_HOP_IP_ADDRESS_NOT_RESOLVED 無法將路徑的下一個躍點 IP 位址解析為 GCP 資源。
ROUTE_NEXT_HOP_RESOURCE_NOT_FOUND 找不到路徑的下一個躍點資源。
ROUTE_NEXT_HOP_INSTANCE_WRONG_NETWORK 路由的下一個躍點執行個體沒有位於路由網路的 NIC。
ROUTE_NEXT_HOP_INSTANCE_NON_PRIMARY_IP 路徑的下一個躍點 IP 位址並非下一個躍點執行個體的主要 IP 位址。
ROUTE_NEXT_HOP_FORWARDING_RULE_IP_MISMATCH 路徑的下一個躍點轉送規則不符合下一個躍點 IP 位址。
ROUTE_NEXT_HOP_VPN_TUNNEL_NOT_ESTABLISHED 路徑的下一個躍點 VPN 通道停止運作 (缺少有效的 IKE SA)。
ROUTE_NEXT_HOP_FORWARDING_RULE_TYPE_INVALID 路徑的下一個躍點轉送規則類型無效 (並非內部直通式負載平衡器的轉送規則)。
NO_ROUTE_FROM_INTERNET_TO_PRIVATE_IPV6_ADDRESS 封包從網際網路或 Google 服務傳送至私人 IPv6 位址。
NO_ROUTE_FROM_EXTERNAL_IPV6_SOURCE_TO_PRIVATE_IPV6_ADDRESS 封包是從執行個體的外部 IPv6 來源位址傳送至執行個體的私人 IPv6 位址。
VPN_TUNNEL_LOCAL_SELECTOR_MISMATCH 封包與政策型 VPN 通道的本機選取器不符。
VPN_TUNNEL_REMOTE_SELECTOR_MISMATCH 封包與政策型 VPN 通道的遠端選取器不符。
PRIVATE_TRAFFIC_TO_INTERNET 已將具備內部目的地位址的封包傳送至網際網路閘道。
PRIVATE_GOOGLE_ACCESS_DISALLOWED 僅具備內部 IP 位址的端點試著存取 Google API 和服務,不過子網路中未啟用 Private Google Access 或不適用。
PRIVATE_GOOGLE_ACCESS_VIA_VPN_TUNNEL_UNSUPPORTED 來源端點嘗試透過連至另一個網路的 VPN 通道存取 Google API 和服務,不過來源端點網路必須啟用私人 Google 存取權。
NO_EXTERNAL_ADDRESS 僅具備內部 IP 位址的端點試著存取外部主機,不過子網路中沒有相符的 Cloud NAT 閘道。
UNKNOWN_INTERNAL_ADDRESS 無法將目的地內部位址解析為已知的目標。如果是共用虛擬私有雲情境,請確認服務專案 ID 是否做為測試輸入內容提供。否則,請確認專案是否正在使用該 IP 位址。
FORWARDING_RULE_MISMATCH 轉送規則的通訊協定和通訊埠與封包標頭不符。
FORWARDING_RULE_NO_INSTANCES 轉送規則未設定後端。
FIREWALL_BLOCKING_LOAD_BALANCER_BACKEND_HEALTH_CHECK 防火牆會封鎖對後端的健康狀態檢查探測,導致後端無法接收來自負載平衡器的流量。詳情請參閱健康狀態檢查防火牆規則
INGRESS_FIREWALL_TAGS_UNSUPPORTED_BY_DIRECT_VPC_EGRESS 針對透過無伺服器虛擬私有雲直接 egress 傳送的封包,不支援依據網路標記比對 ingress 防火牆規則。未定義要執行的操作。https://cloud.google.com/run/docs/configuring/vpc-direct-vpc#limitations
INSTANCE_NOT_RUNNING 收發封包的 Compute Engine 執行個體未處於執行中狀態。
GKE_CLUSTER_NOT_RUNNING 收發封包的 GKE 叢集未處於執行中狀態。
CLOUD_SQL_INSTANCE_NOT_RUNNING 收發封包的 Cloud SQL 執行個體未處於執行中狀態。
REDIS_INSTANCE_NOT_RUNNING 收發封包的 Redis 執行個體未處於執行中狀態。
REDIS_CLUSTER_NOT_RUNNING 收發封包的 Redis 叢集未處於執行中狀態。
TRAFFIC_TYPE_BLOCKED 流量類型遭到封鎖,使用者無法設定防火牆規則來加以啟用。詳情請參閱「一律封鎖的流量」一節。
GKE_MASTER_UNAUTHORIZED_ACCESS 未經授權,無法存取 Google Kubernetes Engine 叢集主要執行個體的端點。詳情請參閱「叢集端點存取權」。
CLOUD_SQL_INSTANCE_UNAUTHORIZED_ACCESS 未經授權,無法存取 Cloud SQL 執行個體端點。詳情請參閱「透過授權網路授權」一文。
DROPPED_INSIDE_GKE_SERVICE 封包已在 Google Kubernetes Engine 服務中捨棄。
DROPPED_INSIDE_CLOUD_SQL_SERVICE 封包已在 Cloud SQL 服務中遭到捨棄。
GOOGLE_MANAGED_SERVICE_NO_PEERING 來源網路與 Google 代管服務網路之間並未對等互連,因此封包已遭捨棄。
GOOGLE_MANAGED_SERVICE_NO_PSC_ENDPOINT 封包遭到捨棄,因為 Google 代管服務使用 Private Service Connect (PSC),但在專案中找不到 PSC 端點。
GKE_PSC_ENDPOINT_MISSING 封包遭到捨棄,因為 GKE 叢集使用 Private Service Connect (PSC),但在專案中找不到 PSC 端點。
CLOUD_SQL_INSTANCE_NO_IP_ADDRESS 封包遭到捨棄,因為 Cloud SQL 執行個體沒有私人或公開 IP 位址。
GKE_CONTROL_PLANE_REGION_MISMATCH 封包遭到捨棄,因為無法從叢集所在區域以外的區域連線至 GKE 叢集私人端點。
PUBLIC_GKE_CONTROL_PLANE_TO_PRIVATE_DESTINATION 封包從公開 GKE 叢集控制層傳送至私人 IP 位址。
GKE_CONTROL_PLANE_NO_ROUTE 封包遭到捨棄,因為 GKE 叢集控制層與目的地網路之間沒有路徑。
CLOUD_SQL_INSTANCE_NOT_CONFIGURED_FOR_EXTERNAL_TRAFFIC 系統不允許從 Cloud SQL 執行個體傳送封包至外部 IP 位址。Cloud SQL 執行個體未設為將封包傳送至外部 IP 位址。
PUBLIC_CLOUD_SQL_INSTANCE_TO_PRIVATE_DESTINATION 封包從只有公開 IP 位址的 Cloud SQL 執行個體傳送至私人 IP 位址。
CLOUD_SQL_INSTANCE_NO_ROUTE 封包遭到捨棄,因為 Cloud SQL 執行個體與目的地網路之間沒有路徑。
CLOUD_SQL_CONNECTOR_REQUIRED 封包遭到捨棄,因為 Cloud SQL 執行個體要求所有連線使用 Cloud SQL 連接器,並以 Cloud SQL Proxy 通訊埠 3307 為目標。
CLOUD_FUNCTION_NOT_ACTIVE 封包可能遭到捨棄,因為 Cloud 函式未處於有效狀態。
VPC_CONNECTOR_NOT_SET 封包可能遭到捨棄,因為未設定任何虛擬私有雲連接器。
VPC_CONNECTOR_NOT_RUNNING 封包可能遭到捨棄,因為虛擬私有雲連接器未處於運作中狀態。
VPC_CONNECTOR_SERVERLESS_TRAFFIC_BLOCKED 系統不允許從無伺服器服務傳送至虛擬私有雲連接器的流量,封包可能遭到捨棄。
VPC_CONNECTOR_HEALTH_CHECK_TRAFFIC_BLOCKED 系統不允許傳送至虛擬私有雲連接器的健康狀態檢查流量,封包可能遭到捨棄。
FORWARDING_RULE_REGION_MISMATCH 封包可能遭到捨棄,因為封包是從不同區域傳送至沒有全域存取權的區域轉送。
PSC_CONNECTION_NOT_ACCEPTED Private Service Connect 端點位於未獲准連線至服務的專案中。
PSC_ENDPOINT_ACCESSED_FROM_PEERED_NETWORK 封包是透過對等互連傳送至 Private Service Connect 端點,但系統不支援這種做法。
PSC_NEG_PRODUCER_ENDPOINT_NO_GLOBAL_ACCESS 封包會傳送至 Private Service Connect 後端 (網路端點群組),但生產端 PSC 轉送規則未啟用全域存取權。
PSC_NEG_PRODUCER_FORWARDING_RULE_MULTIPLE_PORTS 封包會傳送至 Private Service Connect 後端 (網路端點群組),但服務供應商的 PSC 轉送規則指定了多個通訊埠。
CLOUD_SQL_PSC_NEG_UNSUPPORTED 封包會傳送至 Private Service Connect 後端 (網路端點群組),目標是 Cloud SQL 服務連結,但系統不支援這項設定。
NO_NAT_SUBNETS_FOR_PSC_SERVICE_ATTACHMENT 未為 PSC 服務連結定義任何 NAT 子網路。
PSC_TRANSITIVITY_NOT_PROPAGATED 透過 NCC 存取 PSC 端點,但 PSC 遞移性設定尚未傳播。
HYBRID_NEG_NON_DYNAMIC_ROUTE_MATCHED 從混合式 NEG Proxy 傳出的封包與非動態路徑相符,但系統不支援這類設定。
HYBRID_NEG_NON_LOCAL_DYNAMIC_ROUTE_MATCHED 從混合式 NEG Proxy 傳送的封包與下一個躍點位於不同區域的動態路徑相符,但系統不支援這類設定。
CLOUD_RUN_REVISION_NOT_READY 封包是從未準備就緒的 Cloud Run 修訂版本傳送。
DROPPED_INSIDE_PSC_SERVICE_PRODUCER 封包是在 Private Service Connect 服務供應商內部遭到捨棄。
LOAD_BALANCER_HAS_NO_PROXY_SUBNET 封包傳送至負載平衡器,但系統找不到負載平衡器所需的 Proxy 專用子網路。
CLOUD_NAT_NO_ADDRESSES 封包傳送至 Cloud NAT,但沒有有效的 NAT IP。
ROUTING_LOOP 封包陷入轉送迴圈。
DROPPED_INSIDE_GOOGLE_MANAGED_SERVICE 封包在 Google 代管的服務中遭到捨棄,因為封包在回程追蹤中傳送至的端點,與封包在去程追蹤中傳送至的端點不符。僅用於傳回追蹤記錄。
LOAD_BALANCER_BACKEND_INVALID_NETWORK 封包遭到捨棄,因為負載平衡器後端執行個體在負載平衡器預計使用的網路沒有網路介面。
BACKEND_SERVICE_NAMED_PORT_NOT_DEFINED 封包遭到捨棄,因為未在執行個體群組層級定義具名的後端服務通訊埠。
DESTINATION_IS_PRIVATE_NAT_IP_RANGE 封包遭到捨棄,因為目的地 IP 範圍屬於 Private NAT IP 範圍。
DROPPED_INSIDE_REDIS_INSTANCE_SERVICE 封包在 Redis 執行個體服務專案中遭到捨棄的一般原因。
REDIS_INSTANCE_UNSUPPORTED_PORT 封包遭到捨棄,因為連線至 Redis 執行個體時使用的通訊埠不受支援。連線至 Redis 執行個體時,應使用通訊埠 6379。
REDIS_INSTANCE_CONNECTING_FROM_PUPI_ADDRESS 由於從 PUPI 位址連線至以 PSA 為基礎的 Redis 執行個體,封包遭到捨棄。
REDIS_INSTANCE_NO_ROUTE_TO_DESTINATION_NETWORK 封包遭到捨棄,因為沒有通往目的地網路的路徑。
REDIS_INSTANCE_NO_EXTERNAL_IP Redis 執行個體沒有外部 IP 位址。
REDIS_INSTANCE_UNSUPPORTED_PROTOCOL 封包遭到捨棄,因為系統使用不支援的通訊協定連線至 Redis 執行個體。Redis 執行個體只接受 TCP 連線。
DROPPED_INSIDE_REDIS_CLUSTER_SERVICE 封包在 Redis 叢集服務專案中遭到捨棄的一般原因。
REDIS_CLUSTER_UNSUPPORTED_PORT 封包遭到捨棄,因為連線至 Redis 叢集時使用的通訊埠不受支援。連線至 Redis 叢集時,應使用通訊埠 6379 和 11000 至 13047。
REDIS_CLUSTER_NO_EXTERNAL_IP Redis 叢集沒有外部 IP 位址。
REDIS_CLUSTER_UNSUPPORTED_PROTOCOL 封包遭到捨棄,因為連線至 Redis 叢集時使用的通訊協定不受支援。Redis 叢集只接受 TCP 連線。
NO_ADVERTISED_ROUTE_TO_GCP_DESTINATION 來自非 GCP (內部部署) 或不明 GCP 網路的封包遭到捨棄,因為目的地 IP 位址不屬於 Cloud Router 透過 BGP 宣傳的任何 IP 前置字串。
NO_TRAFFIC_SELECTOR_TO_GCP_DESTINATION 來自非 GCP (內部部署) 或不明 GCP 網路的封包遭到捨棄,因為目的地 IP 位址所屬的 IP 前置字串並未包含於 VPN 通道的本機流量選取器。
NO_KNOWN_ROUTE_FROM_PEERED_NETWORK_TO_DESTINATION 來自不明對等互連網路的封包遭到捨棄,因為沒有從來源網路連至目的地 IP 位址的已知路由。
PRIVATE_NAT_TO_PSC_ENDPOINT_UNSUPPORTED 系統不支援將 Private NAT 閘道處理的封包傳送至 Private Service Connect 端點。
PSC_PORT_MAPPING_PORT_MISMATCH 封包傳送至 PSC 通訊埠對應服務,但目標通訊埠不符合任何通訊埠對應規則。
PSC_PORT_MAPPING_WITHOUT_PSC_CONNECTION_UNSUPPORTED 不支援繞過 PSC 連線,直接將封包傳送至 PSC 通訊埠對應服務。
UNSUPPORTED_ROUTE_MATCHED_FOR_NAT64_DESTINATION 目的地 IP 位址在保留的 NAT64 範圍內,封包因符合不支援類型的路徑而遭到捨棄。
TRAFFIC_FROM_HYBRID_ENDPOINT_TO_INTERNET_DISALLOWED 封包可能遭到捨棄,因為 VPN 閘道或互連網路等混合式端點不得將流量傳送至網際網路。
NO_MATCHING_NAT64_GATEWAY 子網路中沒有相符的 NAT 閘道,因此目的地 IP 位址位於保留的 NAT64 範圍內的封包遭到捨棄。
LOAD_BALANCER_BACKEND_IP_VERSION_MISMATCH 封包遭到捨棄,因為封包傳送至直通式負載平衡器的後端,而該後端的 IP 版本與前端不同。
NO_KNOWN_ROUTE_FROM_NCC_NETWORK_TO_DESTINATION 來自不明 NCC 網路的封包遭到捨棄,因為沒有從來源網路通往目的地 IP 位址的已知路由。

LoadBalancerInfo

僅供顯示。與負載平衡器相關聯的中繼資料。

JSON 表示法
{
  "loadBalancerType": enum (LoadBalancerType),
  "healthCheckUri": string,
  "backends": [
    {
      object (LoadBalancerBackend)
    }
  ],
  "backendType": enum (BackendType),
  "backendUri": string
}
欄位
loadBalancerType

enum (LoadBalancerType)

負載平衡器類型。

healthCheckUri
(deprecated)

string

負載平衡器的健康狀態檢查 URI。已淘汰,且不再填入,因為不同負載平衡器後端可能會有不同的健康狀態檢查。

backends[]

object (LoadBalancerBackend)

負載平衡器後端的資訊。

backendType

enum (BackendType)

負載平衡器後端設定的類型。

backendUri

string

後端設定 URI。

LoadBalancerType

負載平衡器的型別定義:

列舉
LOAD_BALANCER_TYPE_UNSPECIFIED 未指定類型。
INTERNAL_TCP_UDP 內部 TCP/UDP 負載平衡器。
NETWORK_TCP_UDP 網路 TCP/UDP 負載平衡器。
HTTP_PROXY HTTP(S) Proxy 負載平衡器。
TCP_PROXY TCP Proxy 負載平衡器。
SSL_PROXY SSL Proxy 負載平衡器。

LoadBalancerBackend

僅供顯示。與特定負載平衡器後端相關聯的中繼資料。

JSON 表示法
{
  "displayName": string,
  "uri": string,
  "healthCheckFirewallState": enum (HealthCheckFirewallState),
  "healthCheckAllowingFirewallRules": [
    string
  ],
  "healthCheckBlockingFirewallRules": [
    string
  ]
}
欄位
displayName

string

Compute Engine 執行個體或網路端點的名稱。

uri

string

Compute Engine 執行個體或網路端點的 URI。

healthCheckFirewallState

enum (HealthCheckFirewallState)

健康狀態檢查防火牆設定的狀態。

healthCheckAllowingFirewallRules[]

string

允許健康狀態檢查 IP 範圍探測器的防火牆規則 URI 清單。

healthCheckBlockingFirewallRules[]

string

封鎖探測器從健康狀態檢查 IP 範圍傳送流量的防火牆規則 URI 清單。

HealthCheckFirewallState

健康狀態檢查防火牆設定的狀態:

列舉
HEALTH_CHECK_FIREWALL_STATE_UNSPECIFIED 未指定狀態。如未填入,則為預設狀態。
CONFIGURED 已設定防火牆規則,允許健康狀態檢查探測器連線至後端。
MISCONFIGURED 已設定防火牆規則,允許部分健康狀態檢查範圍,或封鎖所有健康狀態檢查範圍。如果健康狀態檢查探測是從遭拒的 IP 範圍傳送,後端的健康狀態檢查就會失敗。接著,後端會標示為不健康,且不會接收傳送至負載平衡器的流量。

BackendType

負載平衡器後端設定的型別定義:

列舉
BACKEND_TYPE_UNSPECIFIED 未指定類型。
BACKEND_SERVICE 後端服務做為負載平衡器的後端。
TARGET_POOL 目標集區做為負載平衡器的後端。
TARGET_INSTANCE 目標執行個體做為負載平衡器的後端。

NetworkInfo

僅供顯示。與 Compute Engine 網路相關聯的中繼資料。

JSON 表示法
{
  "displayName": string,
  "uri": string,
  "matchedSubnetUri": string,
  "matchedIpRange": string,
  "region": string
}
欄位
displayName

string

Compute Engine 網路名稱。

uri

string

Compute Engine 網路的 URI。

matchedSubnetUri

string

與測試來源 IP 位址相符的子網路 URI。

matchedIpRange

string

與測試來源 IP 位址相符的子網路 IP 範圍。

region

string

與測試來源 IP 位址相符的子網路區域。

GKEMasterInfo

僅供顯示。與 Google Kubernetes Engine (GKE) 叢集主節點相關聯的中繼資料。

JSON 表示法
{
  "clusterUri": string,
  "clusterNetworkUri": string,
  "internalIp": string,
  "externalIp": string,
  "dnsEndpoint": string
}
欄位
clusterUri

string

GKE 叢集的 URI。

clusterNetworkUri

string

GKE 叢集網路的 URI。

internalIp

string

GKE 叢集控制層的內部 IP 位址。

externalIp

string

GKE 叢集控制層的外部 IP 位址。

dnsEndpoint

string

GKE 叢集控制層的 DNS 端點。

CloudSQLInstanceInfo

僅供顯示。與 Cloud SQL 執行個體相關聯的中繼資料。

JSON 表示法
{
  "displayName": string,
  "uri": string,
  "networkUri": string,
  "internalIp": string,
  "externalIp": string,
  "region": string
}
欄位
displayName

string

Cloud SQL 執行個體的名稱。

uri

string

Cloud SQL 執行個體的 URI。

networkUri

string

Cloud SQL 執行個體網路的 URI,如果執行個體沒有網路,則為空字串。

internalIp

string

Cloud SQL 執行個體的內部 IP 位址。

externalIp

string

Cloud SQL 執行個體的外部 IP 位址。

region

string

Cloud SQL 執行個體執行的區域。

RedisInstanceInfo

僅供顯示。與 Cloud Redis 執行個體相關聯的中繼資料。

JSON 表示法
{
  "displayName": string,
  "uri": string,
  "networkUri": string,
  "primaryEndpointIp": string,
  "readEndpointIp": string,
  "region": string
}
欄位
displayName

string

Cloud Redis 執行個體的名稱。

uri

string

Cloud Redis 執行個體的 URI。

networkUri

string

Cloud Redis 執行個體網路的 URI。

primaryEndpointIp

string

Cloud Redis 執行個體的主要端點 IP 位址。

readEndpointIp

string

讀取 Cloud Redis 執行個體的端點 IP 位址 (如適用)。

region

string

定義 Cloud Redis 執行個體的區域。

RedisClusterInfo

僅供顯示。與 Redis 叢集相關聯的中繼資料。

JSON 表示法
{
  "displayName": string,
  "uri": string,
  "networkUri": string,
  "discoveryEndpointIpAddress": string,
  "secondaryEndpointIpAddress": string,
  "location": string
}
欄位
displayName

string

Redis 叢集的名稱。

uri

string

Redis 叢集的 URI,格式為「projects/{projectId}/locations/{location}/clusters/{cluster_id}」

networkUri

string

包含 Redis 叢集端點的網路 URI,格式為「projects/{projectId}/global/networks/{network_id}」。

discoveryEndpointIpAddress

string

Redis 叢集的探索端點 IP 位址。

secondaryEndpointIpAddress

string

Redis 叢集的次要端點 IP 位址。

location

string

定義 Redis Cluster 的區域名稱。例如「us-central1」。

CloudFunctionInfo

僅供顯示。與 Cloud Function 相關聯的中繼資料。

JSON 表示法
{
  "displayName": string,
  "uri": string,
  "location": string,
  "versionId": string
}
欄位
displayName

string

Cloud 函式名稱。

uri

string

Cloud 函式的 URI。

location

string

部署 Cloud 函式的位置。

versionId

string (int64 format)

Cloud Functions 最新成功部署的版本 ID。

AppEngineVersionInfo

僅供顯示。與 App Engine 版本相關聯的中繼資料。

JSON 表示法
{
  "displayName": string,
  "uri": string,
  "runtime": string,
  "environment": string
}
欄位
displayName

string

App Engine 版本的名稱。

uri

string

App Engine 版本的 URI。

runtime

string

App Engine 版本的執行階段。

environment

string

版本的 App Engine 執行環境。

CloudRunRevisionInfo

僅供顯示。與 Cloud Run 修訂版本相關聯的中繼資料。

JSON 表示法
{
  "displayName": string,
  "uri": string,
  "location": string,
  "serviceUri": string
}
欄位
displayName

string

Cloud Run 修訂版本的名稱。

uri

string

Cloud Run 修訂版本的 URI。

location

string

部署此修訂版本的位置。

serviceUri

string

這個修訂版本所屬的 Cloud Run 服務 URI。

NatInfo

僅供顯示。與 NAT 相關聯的中繼資料。

JSON 表示法
{
  "type": enum (Type),
  "protocol": string,
  "networkUri": string,
  "oldSourceIp": string,
  "newSourceIp": string,
  "oldDestinationIp": string,
  "newDestinationIp": string,
  "oldSourcePort": integer,
  "newSourcePort": integer,
  "oldDestinationPort": integer,
  "newDestinationPort": integer,
  "routerUri": string,
  "natGatewayName": string
}
欄位
type

enum (Type)

NAT 類型。

protocol

string

字串格式的 IP 通訊協定,例如:「TCP」、「UDP」、「ICMP」。

networkUri

string

執行 NAT 轉譯的網路 URI。

oldSourceIp

string

NAT 轉譯前的來源 IP 位址。

newSourceIp

string

網路位址轉譯 (NAT) 轉譯後的來源 IP 位址。

oldDestinationIp

string

NAT 轉譯前的目的地 IP 位址。

newDestinationIp

string

NAT 轉譯後的目的地 IP 位址。

oldSourcePort

integer

NAT 轉換前的來源通訊埠。僅在通訊協定為 TCP 或 UDP 時有效。

newSourcePort

integer

NAT 轉換後的來源通訊埠。僅在通訊協定為 TCP 或 UDP 時有效。

oldDestinationPort

integer

NAT 轉換前的目的地通訊埠。僅在通訊協定為 TCP 或 UDP 時有效。

newDestinationPort

integer

NAT 轉換後的目的地通訊埠。僅在通訊協定為 TCP 或 UDP 時有效。

routerUri

string

Cloud Router 的 URI。只有在類型為 CLOUD_NAT 時才有效。

natGatewayName

string

Cloud NAT 閘道的名稱。只有在類型為 CLOUD_NAT 時才有效。

類型

NAT 類型。

列舉
TYPE_UNSPECIFIED 未指定類型。
INTERNAL_TO_EXTERNAL 從 Compute Engine 執行個體的內部位址到外部位址。
EXTERNAL_TO_INTERNAL 從 Compute Engine 執行個體的外部位址到內部位址。
CLOUD_NAT Cloud NAT 閘道。
PRIVATE_SERVICE_CONNECT Private Service Connect NAT。

ProxyConnectionInfo

僅供顯示。與 ProxyConnection 相關聯的中繼資料。

JSON 表示法
{
  "protocol": string,
  "oldSourceIp": string,
  "newSourceIp": string,
  "oldDestinationIp": string,
  "newDestinationIp": string,
  "oldSourcePort": integer,
  "newSourcePort": integer,
  "oldDestinationPort": integer,
  "newDestinationPort": integer,
  "subnetUri": string,
  "networkUri": string
}
欄位
protocol

string

字串格式的 IP 通訊協定,例如:「TCP」、「UDP」、「ICMP」。

oldSourceIp

string

原始連線的來源 IP 位址。

newSourceIp

string

新連線的來源 IP 位址。

oldDestinationIp

string

原始連線的目的地 IP 位址

newDestinationIp

string

新連線的目的地 IP 位址。

oldSourcePort

integer

原始連線的來源通訊埠。僅在通訊協定為 TCP 或 UDP 時有效。

newSourcePort

integer

新連線的來源埠。僅在通訊協定為 TCP 或 UDP 時有效。

oldDestinationPort

integer

原始連線的目的地通訊埠。僅在通訊協定為 TCP 或 UDP 時有效。

newDestinationPort

integer

新連線的目的地埠。僅在通訊協定為 TCP 或 UDP 時有效。

subnetUri

string

Proxy 子網路的 URI。

networkUri

string

連線的 Proxy 所在網路的 URI。

LoadBalancerBackendInfo

僅供顯示。與負載平衡器後端相關聯的中繼資料。

JSON 表示法
{
  "name": string,
  "instanceUri": string,
  "backendServiceUri": string,
  "instanceGroupUri": string,
  "networkEndpointGroupUri": string,
  "backendBucketUri": string,
  "pscServiceAttachmentUri": string,
  "pscGoogleApiTarget": string,
  "healthCheckUri": string,
  "healthCheckFirewallsConfigState": enum (HealthCheckFirewallsConfigState)
}
欄位
name

string

後端的顯示名稱。舉例來說,這可能是執行個體群組後端的執行個體名稱,或是區域網路端點群組後端的 IP 位址和通訊埠。

instanceUri

string

後端執行個體的 URI (如適用)。系統會為執行個體群組後端和區域性 NEG 後端填入適當值。

backendServiceUri

string

這個後端所屬後端服務的 URI (如適用)。

instanceGroupUri

string

這個後端所屬執行個體群組的 URI (如適用)。

networkEndpointGroupUri

string

這個後端所屬網路端點群組的 URI (如適用)。

backendBucketUri

string

這個後端目標後端 bucket 的 URI (如適用)。

pscServiceAttachmentUri

string

這個 PSC NEG 後端目標的 PSC 服務連結 URI (如適用)。

pscGoogleApiTarget

string

這個 PSC NEG 後端指定的 PSC Google API 目標 (如適用)。

healthCheckUri

string

附加至這個後端的健康狀態檢查 URI (如適用)。

healthCheckFirewallsConfigState

enum (HealthCheckFirewallsConfigState)

僅供輸出。後端的健康狀態檢查防火牆設定狀態。這是靜態防火牆分析的結果 (驗證是否允許從必要 IP 範圍到後端的健康狀態檢查流量)。即使設定了這些防火牆,後端仍可能處於健康狀態不良的狀態。詳情請參閱說明文件:https://cloud.google.com/load-balancing/docs/firewall-rules

HealthCheckFirewallsConfigState

健康狀態檢查防火牆設定狀態列舉。

列舉
HEALTH_CHECK_FIREWALLS_CONFIG_STATE_UNSPECIFIED 未指定設定狀態。這通常表示後端沒有附加健康狀態檢查,或是發生非預期的設定錯誤,導致連線測試無法驗證健康狀態檢查設定。
FIREWALLS_CONFIGURED 已設定防火牆規則 (政策),允許來自所有必要 IP 範圍的健康狀態檢查流量傳送至後端。
FIREWALLS_PARTIALLY_CONFIGURED 防火牆規則 (政策) 只允許來自部分必要 IP 範圍的健康狀態檢查流量。
FIREWALLS_NOT_CONFIGURED 防火牆規則 (政策) 會拒絕從所有必要 IP 範圍傳送至後端的健康狀態檢查流量。
FIREWALLS_UNSUPPORTED 網路包含不支援的防火牆規則類型,因此 Connectivity Tests 無法驗證健康狀態檢查設定狀態。如需不支援的設定清單,請參閱說明文件:https://cloud.google.com/network-intelligence-center/docs/connectivity-tests/concepts/overview#unsupported-configs

StorageBucketInfo

僅供顯示。與儲存空間值區相關聯的中繼資料。

JSON 表示法
{
  "bucket": string
}
欄位
bucket

string

Cloud Storage 值區名稱。

ServerlessNegInfo

僅供顯示。與無伺服器網路端點群組後端相關聯的中繼資料。

JSON 表示法
{
  "negUri": string
}
欄位
negUri

string

無伺服器網路端點群組的 URI。

ProbingDetails

上次執行測試時,主動探測的結果。

JSON 表示法
{
  "result": enum (ProbingResult),
  "verifyTime": string,
  "error": {
    object (Status)
  },
  "abortCause": enum (ProbingAbortCause),
  "sentProbeCount": integer,
  "successfulProbeCount": integer,
  "endpointInfo": {
    object (EndpointInfo)
  },
  "probingLatency": {
    object (LatencyDistribution)
  },
  "destinationEgressLocation": {
    object (EdgeLocation)
  },
  "edgeResponses": [
    {
      object (SingleEdgeResponse)
    }
  ],
  "probedAllDevices": boolean
}
欄位
result

enum (ProbingResult)

主動探測的整體結果。

verifyTime

string (Timestamp format)

透過主動探測評估可連線性的時間。

使用 RFC 3339,產生的輸出內容一律會經過 Z 標準化,並使用 0、3、6 或 9 個小數位數。系統也接受「Z」以外的偏移量。例如:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

error

object (Status)

內部失敗或取消主動探查的詳細資料。

abortCause

enum (ProbingAbortCause)

探查作業中止的原因。

sentProbeCount

integer

傳送的探測次數。

successfulProbeCount

integer

抵達目的地的探測次數。

endpointInfo

object (EndpointInfo)

從測試輸入內容衍生而來,並用於主動探查的來源和目的地端點。

probingLatency

object (LatencyDistribution)

單向延遲時間,也就是從來源到目的地端點的延遲時間,是透過主動探查測得。

destinationEgressLocation

object (EdgeLocation)

封包要前往網際網路時,會從這個 EdgeLocation 離開 Google 網路。只有在連線測試具有網際網路目的地地址時,才會填入這個欄位。請勿將缺少這個欄位做為目的地屬於 Google 聯播網的指標。

edgeResponses[]

object (SingleEdgeResponse)

所有邊緣裝置的探測結果。

probedAllDevices

boolean

是否探測所有相關邊緣裝置。

ProbingResult

測試的整體探查結果。

列舉
PROBING_RESULT_UNSPECIFIED 未指定結果。
REACHABLE 至少有 95% 的封包抵達目的地。
UNREACHABLE 沒有任何封包抵達目的地。
REACHABILITY_INCONSISTENT 抵達目的地的封包少於 95%。
UNDETERMINED 無法判斷可觸及人數。可能原因包括:* 使用者缺少執行測試所需的某些網路資源存取權限。* 無法從要求取得有效的來源端點。* 發生內部錯誤。

ProbingAbortCause

中止原因類型。

列舉
PROBING_ABORT_CAUSE_UNSPECIFIED 未指定原因。
PERMISSION_DENIED 使用者沒有權限存取執行測試所需的某些網路資源。
NO_SOURCE_LOCATION 無法從要求取得有效的來源端點。

LatencyDistribution

說明測得的延遲分布情形。

JSON 表示法
{
  "latencyPercentiles": [
    {
      object (LatencyPercentile)
    }
  ]
}
欄位
latencyPercentiles[]

object (LatencyPercentile)

代表性的延遲時間百分位數。

LatencyPercentile

延遲時間百分位數排名和值。

JSON 表示法
{
  "percent": integer,
  "latencyMicros": string
}
欄位
percent

integer

這個資料點適用的樣本百分比。

latencyMicros

string (int64 format)

觀察到的延遲時間的百分位數 (以微秒為單位)。延遲時間小於或等於這個欄位值的樣本所占的百分比 (以 100 為分母)。

EdgeLocation

網路邊緣位置的表示方式,請參閱 https://cloud.google.com/vpc/docs/edge-locations

JSON 表示法
{
  "metropolitanArea": string
}
欄位
metropolitanArea

string

都會區名稱。

SingleEdgeResponse

單一邊緣裝置的探查結果。

JSON 表示法
{
  "result": enum (ProbingResult),
  "sentProbeCount": integer,
  "successfulProbeCount": integer,
  "probingLatency": {
    object (LatencyDistribution)
  },
  "destinationEgressLocation": {
    object (EdgeLocation)
  },
  "destinationRouter": string
}
欄位
result

enum (ProbingResult)

這個輸出裝置主動探測的整體結果。

sentProbeCount

integer

傳送的探測次數。

successfulProbeCount

integer

抵達目的地的探測次數。

probingLatency

object (LatencyDistribution)

單向延遲時間,也就是從來源到目的地端點的延遲時間,是透過主動探查測得。

destinationEgressLocation

object (EdgeLocation)

封包要前往網際網路時,會從這個 EdgeLocation 離開 Google 網路。只有在連線測試具有網際網路目的地地址時,才會填入這個欄位。請勿將缺少這個欄位做為目的地屬於 Google 聯播網的指標。

destinationRouter

string

路由器名稱,格式為「{router}.{metroshard}」。例如:pf01.aaa01、pr02.aaa01。

方法

create

建立新的連線能力測試。

delete

刪除特定 ConnectivityTest

get

取得特定連線能力測試的詳細資料。

getIamPolicy

取得資源的存取權控管政策。

list

列出專案擁有的所有連線測試。

patch

更新現有 ConnectivityTest 的設定。

rerun

重新執行現有的 ConnectivityTest

setIamPolicy

設定指定資源的存取權控管政策。

testIamPermissions

傳回呼叫者在指定資源上擁有的權限。