REST Resource: projects.locations.global.connectivityTests

Recurso: ConnectivityTest

Um Connectivity Test para uma análise de acessibilidade da rede.

Representação 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
}
Campos
name

string

Identificador. Nome exclusivo do recurso usando o formulário: projects/{projectId}/locations/global/connectivityTests/{test}
description

string

A descrição fornecida pelo usuário do Connectivity Test. Use no máximo 512 caracteres.
source

object (Endpoint)

Obrigatório. Especificação de origem do Connectivity Test.

Use uma combinação de endereço IP de origem, URI de um endpoint compatível, ID do projeto ou rede VPC para identificar o local de origem.

Uma análise de acessibilidade prossegue mesmo se o local de origem for ambíguo. No entanto, o resultado do teste pode incluir endpoints ou usar uma origem que você não pretende testar.
destination

object (Endpoint)

Obrigatório. Especificação de destino do Connectivity Test.

Você pode usar uma combinação de endereço IP de destino, URI de um endpoint compatível, ID do projeto ou rede VPC para identificar o local de destino.

Uma análise de acessibilidade prossegue mesmo se o local de destino for ambíguo. No entanto, o resultado do teste pode incluir endpoints ou usar um destino que você não pretende testar.
protocol

string

Protocolo IP do teste. Quando não fornecido, "TCP" é assumido.
relatedProjects[]

string

Outros projetos que podem ser relevantes para a análise de acessibilidade. Isso é aplicável a cenários em que um teste pode cruzar os limites do projeto.
displayName

string

Apenas saída. O nome para exibição de um Connectivity Test.
labels

map (key: string, value: string)

Rótulos de recursos para representar metadados fornecidos por usuários

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime

string (Timestamp format)

Apenas saída. A hora em que o teste foi criado.

Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30";
updateTime

string (Timestamp format)

Apenas saída. A hora em que a configuração do teste foi atualizada.

Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30";
reachabilityDetails

object (ReachabilityDetails)

Apenas saída. Os detalhes de acessibilidade deste teste desde a última execução. Os detalhes são atualizados ao criar um novo teste, atualizar um teste atual ou acionar uma nova execução única de um teste atual.
probingDetails

object (ProbingDetails)

Apenas saída. Os detalhes de sondagem deste teste desde a última execução, presentes apenas para testes aplicáveis. Os detalhes são atualizados ao criar um novo teste, atualizar um teste atual ou acionar uma nova execução única de um teste atual.
roundTrip

boolean

Se a análise de execução do caminho de retorno do destino para a origem. O valor padrão é falso.
returnReachabilityDetails

object (ReachabilityDetails)

Apenas saída. Os detalhes de acessibilidade deste teste desde a última execução para o caminho de retorno. Os detalhes são atualizados ao criar um novo teste, atualizar um teste atual ou acionar uma nova execução única de um teste atual.
bypassFirewallChecks

boolean

Se a análise deve ignorar a verificação de firewall. O valor padrão é falso.

Endpoint

Origem ou destino do Connectivity Test.

Representação 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)
}
Campos
ipAddress

string

O endereço IP do endpoint, que pode ser um IP externo ou interno.
port

integer

A porta do protocolo IP do endpoint. Aplicável apenas quando o protocolo é TCP ou UDP.
instance

string

Um URI de instância do Compute Engine.
forwardingRule

string

Uma regra de encaminhamento e o endereço IP correspondente a ela representam a configuração de front-end de um balanceador de carga do Google Cloud. As regras de encaminhamento também são usadas para encaminhamento de protocolo, Private Service Connect e outros serviços de rede para fornecer informações de encaminhamento no plano de controle. Aplicável somente ao endpoint de destino. Formato: projects/{project}/global/forwardingRules/{id} ou projects/{project}/regions/{region}/forwardingRules/{id}
gkeMasterCluster

string

Um URI de cluster para o plano de controle do cluster do Google Kubernetes Engine.
fqdn

string

Endpoint DNS do plano de controle do cluster do Google Kubernetes Engine. Exige que gkeMasterCluster seja definido e não pode ser usado simultaneamente com ipAddress ou network. Aplicável somente ao endpoint de destino.
cloudSqlInstance

string

Um URI de instância do Cloud SQL.
redisInstance

string

Um URI de instância do Redis. Aplicável somente ao endpoint de destino.
redisCluster

string

Um URI do cluster do Redis. Aplicável somente ao endpoint de destino.
alloyDbInstance

string

Um URI de instância do AlloyDB.
cloudFunction

object (CloudFunctionEndpoint)

Uma função do Cloud. Aplicável apenas ao endpoint de origem.
appEngineVersion

object (AppEngineVersionEndpoint)

Uma versão de serviço do App Engine. Aplicável apenas ao endpoint de origem.
cloudRunRevision

object (CloudRunRevisionEndpoint)

Uma revisão do Cloud Run. Aplicável apenas ao endpoint de origem.
network

string

Um URI de rede VPC.
networkType

enum (NetworkType)

Tipo da rede em que o endpoint está localizado. Aplicável apenas ao endpoint de origem, porque o tipo de rede de destino pode ser inferido a partir da fonte.
projectId

string

Código do projeto em que o endpoint está localizado. O ID do projeto pode ser derivado do URI se você fornecer um endpoint ou URI de rede. A seguir, dois casos em que você pode precisar fornecer o ID do projeto: 1. Somente o endereço IP é especificado e está dentro de um projeto do Google Cloud. 2. Quando você está usando a VPC compartilhada e o endereço IP que você fornece é do projeto de serviço. Nesse caso, a rede na qual o endereço IP reside é definida no projeto host.
forwardingRuleTarget

enum (ForwardingRuleTarget)

Apenas saída. Especifica o tipo de destino da regra de encaminhamento.
loadBalancerId

string

Apenas saída. ID do balanceador de carga a que a regra de encaminhamento aponta. Vazio para regras de encaminhamento não relacionadas a balanceadores de carga.
loadBalancerType

enum (LoadBalancerType)

Apenas saída. Tipo do balanceador de carga para que a regra de encaminhamento aponta.

ForwardingRuleTarget

Tipo do destino de uma regra de encaminhamento.

Enums
FORWARDING_RULE_TARGET_UNSPECIFIED O destino da regra de encaminhamento é desconhecido.
INSTANCE Instância do Compute Engine para encaminhamento de protocolo.
LOAD_BALANCER Balanceador de carga. O tipo específico pode ser encontrado em loadBalancerType.
VPN_GATEWAY Gateway do Cloud VPN clássico.
PSC Uma regra de encaminhamento é um endpoint do Private Service Connect.

LoadBalancerType

Tipo de um balanceador de carga. Para mais informações, consulte Resumo dos balanceadores de carga do Google Cloud.

Enums
LOAD_BALANCER_TYPE_UNSPECIFIED A regra de encaminhamento aponta para um destino diferente de um balanceador de carga ou o tipo de balanceador de carga é desconhecido.
HTTPS_ADVANCED_LOAD_BALANCER Balanceador de carga HTTP(S) externo global.
HTTPS_LOAD_BALANCER Balanceador de carga HTTP(S) externo global (clássico)
REGIONAL_HTTPS_LOAD_BALANCER Balanceador de carga HTTP(S) externo regional.
INTERNAL_HTTPS_LOAD_BALANCER Balanceador de carga HTTP(S) interno.
SSL_PROXY_LOAD_BALANCER Balanceador de carga de proxy SSL externo.
TCP_PROXY_LOAD_BALANCER Balanceador de carga de proxy TCP externo.
INTERNAL_TCP_PROXY_LOAD_BALANCER Balanceador de carga do proxy TCP regional interno.
NETWORK_LOAD_BALANCER Balanceador de carga de rede TCP/UDP externo.
LEGACY_NETWORK_LOAD_BALANCER Balanceador de carga de rede TCP/UDP externo baseado em pool de destino.
TCP_UDP_INTERNAL_LOAD_BALANCER Balanceador de carga TCP/UDP interno.

CloudFunctionEndpoint

Wrapper para atributos do função do Cloud.

Representação JSON 
{
  "uri": string
}
Campos
uri

string

Um nome de função do Cloud.

AppEngineVersionEndpoint

Wrapper para os atributos da versão do serviço do App Engine.

Representação JSON 
{
  "uri": string
}
Campos
uri

string

Um nome de versão de serviço do App Engine.

CloudRunRevisionEndpoint

Wrapper para atributos de revisão do Cloud Run.

Representação JSON 
{
  "uri": string,
  "serviceUri": string
}
Campos
uri

string

Um URI de revisão do Cloud Run. O formato é: projects/{project}/locations/{location}/revisions/{revision}
serviceUri

string

Apenas saída. O URI do serviço do Cloud Run a que a revisão pertence. O formato é: projects/{project}/locations/{location}/services/{service}

NetworkType

A definição de tipo da rede de um endpoint. Use uma das seguintes opções:

Enums
NETWORK_TYPE_UNSPECIFIED Tipo padrão, se não especificado.
GCP_NETWORK Uma rede hospedada no Google Cloud. Para receber uma saída mais detalhada, especifique o URI para a rede de origem ou destino.
NON_GCP_NETWORK Uma rede hospedada fora do Google Cloud. Pode ser uma rede local, um recurso da Internet ou uma rede hospedada por outro provedor de nuvem.

ReachabilityDetails

Resultados da análise de configuração da última execução do teste.

Representação JSON 
{
  "result": enum (Result),
  "verifyTime": string,
  "error": {
    object (Status)
  },
  "traces": [
    {
      object (Trace)
    }
  ]
}
Campos
result

enum (Result)

O resultado geral da análise de configuração do teste.
verifyTime

string (Timestamp format)

O horário da análise de configuração.

Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30";
error

object (Status)

Os detalhes de uma análise de falha ou cancelamento da acessibilidade.
traces[]

object (Trace)

O resultado pode conter uma lista de traces se um teste tiver vários caminhos possíveis na rede, como quando o endpoint de destino é um balanceador de carga com vários back-ends.

Resultado

O resultado geral da análise de configuração do teste.

Enums
RESULT_UNSPECIFIED Nenhum resultado foi especificado.
REACHABLE

Os cenários possíveis são:

  • A análise de configuração determinou que um pacote originário da origem deve chegar ao destino.
  • A análise não foi concluída porque o usuário não tem permissão para acessar alguns dos recursos no rastreamento. No entanto, no momento em que a permissão do usuário se tornou insuficiente, o rastreamento já havia sido concluído.
UNREACHABLE Espera-se que um pacote originário da origem seja descartado antes de chegar ao destino.
AMBIGUOUS Os endpoints de origem e destino não identificam exclusivamente o local do teste na rede, e o resultado da acessibilidade contém vários traces. Para alguns rastreamentos, um pacote pode ser entregue, e para outros, não. Esse resultado também é atribuído à análise de configuração do caminho de retorno se, por si só, ele for REACHABLE, mas a análise de configuração do caminho de encaminhamento for AMBIGUOUS.
UNDETERMINED

A análise de configuração não foi concluída. As possíveis razões são:

  • Ocorreu um erro de permissão. Por exemplo, o usuário pode não ter permissão de leitura para todos os recursos nomeados no teste.
  • Ocorreu um erro interno.
  • O analisador recebeu um argumento inválido ou incompatível ou não conseguiu identificar um endpoint conhecido.

Trace

O trace representa um caminho de encaminhamento de pacote simulado.

  • Cada um contém várias etapas ordenadas.
  • Cada etapa está em um estado específico com uma configuração associada.
  • O estado é classificado como final ou não final.
  • Cada estado final tem um motivo associado.
  • Cada trace precisa terminar com um estado final (a última etapa).
  |---------------------Trace----------------------|
  Step1(State) Step2(State) ---  StepN(State(final))
Representação JSON 
{
  "endpointInfo": {
    object (EndpointInfo)
  },
  "steps": [
    {
      object (Step)
    }
  ],
  "forwardTraceId": integer
}
Campos
endpointInfo

object (EndpointInfo)

Derivado da definição dos endpoints de origem e destino especificada pela solicitação do usuário e validado pelo modelo do plano de dados. Se houver vários traces iniciando em diferentes locais de origem, o endpointInfo poderá ser diferente entre os traces.
steps[]

object (Step)

Um trace de um teste contém várias etapas, do estado inicial ao estado final (entregue, descartado, encaminhado ou abortado).

As etapas são ordenadas pela sequência de processamento na máquina de estado de rede simulada. É essencial preservar a ordem das etapas e evitar reordenar ou classificá-las.
forwardTraceId

integer

ID do rastreamento. Para rastreamentos diretos, esse ID é exclusivo para cada rastreamento. Para traces de retorno, ele corresponde ao ID do trace de encaminhamento associado. Um único rastreamento de encaminhamento pode ser associado a nenhum, um ou mais rastreamentos de retorno.

EndpointInfo

Apenas para exibição. A especificação dos endpoints para o teste. O EndpointInfo é derivado do Endpoint de origem e destino e validado pelo modelo de plano de dados de back-end.

Representação JSON 
{
  "sourceIp": string,
  "destinationIp": string,
  "protocol": string,
  "sourcePort": integer,
  "destinationPort": integer,
  "sourceNetworkUri": string,
  "destinationNetworkUri": string,
  "sourceAgentUri": string
}
Campos
sourceIp

string

Endereço IP de origem.
destinationIp

string

Endereço IP de destino.
protocol

string

Protocolo IP no formato de sequência, por exemplo: "TCP", "UDP", "ICMP".
sourcePort

integer

Porta de origem. Válido apenas quando o protocolo é TCP ou UDP.
destinationPort

integer

Porta de destino. Válido apenas quando o protocolo é TCP ou UDP.
sourceNetworkUri

string

URI da rede de onde este pacote se origina.
destinationNetworkUri

string

URI da rede para onde este pacote é enviado.
sourceAgentUri

string

URI do agente de telemetria de origem de onde este pacote se origina.

Etapa

Um caminho de encaminhamento simulado é composto de várias etapas. Cada uma tem um estado bem definido e uma configuração associada.

Representação 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.
}
Campos
description

string

Uma descrição da etapa. Normalmente, este é um resumo do estado.
state

enum (State)

Cada etapa está em um dos estados predefinidos.
causesDrop

boolean

Esta é uma etapa que leva ao estado final Soltar.
projectId

string

Código do projeto que contém a configuração que esta etapa está validando.
Campo de união step_info. Configuração ou metadados associados a cada etapa. A configuração é filtrada com base na permissão do visualizador. Se um visualizador não tiver permissão para visualizar a configuração nesta etapa, para estados não finais, um estado especial será preenchido (VIEWER_PERMISSION_MISSING) e, para o estado final, a configuração será limpa. step_info pode ser apenas de um dos tipos a seguir:
instance

object (InstanceInfo)

Mostra informações de uma instância do Compute Engine.
firewall

object (FirewallInfo)

Mostra informações de uma regra de firewall do Compute Engine.
route

object (RouteInfo)

Mostra informações de uma rota do Compute Engine.
endpoint

object (EndpointInfo)

Mostra informações da origem e do destino em análise. As informações do endpoint em um estado intermediário podem diferir da entrada inicial, porque podem ser modificadas por estados como NAT ou proxy de conexão.
googleService

object (GoogleServiceInfo)

Mostrar informações de um serviço do Google
forwardingRule

object (ForwardingRuleInfo)

Mostra informações de uma regra de encaminhamento do Compute Engine.
vpnGateway

object (VpnGatewayInfo)

Mostra informações de um gateway de VPN do Compute Engine.
vpnTunnel

object (VpnTunnelInfo)

Mostra informações de um túnel de VPN do Compute Engine.
vpcConnector

object (VpcConnectorInfo)

Mostra informações de um conector VPC.
directVpcEgressConnection

object (DirectVpcEgressConnectionInfo)

Mostra informações de uma conexão de saída de VPC direta sem servidor.
serverlessExternalConnection

object (ServerlessExternalConnectionInfo)

Mostra informações de uma conexão pública (externa) sem servidor.
deliver

object (DeliverInfo)

Exiba informações do estado final "entregar" e o motivo.
forward

object (ForwardInfo)

Exiba informações do estado final "encaminhar" e o motivo.
abort

object (AbortInfo)

Mostra informações do estado final "interromper" e o motivo.
drop

object (DropInfo)

Exiba informações do estado final "soltar" e o motivo.
loadBalancer
(deprecated)

object (LoadBalancerInfo)

Mostra informações dos balanceadores de carga. Descontinuado em favor do campo loadBalancerBackendInfo, não usado em novos testes.
network

object (NetworkInfo)

Mostra informações de uma rede do Google Cloud.
gkeMaster

object (GKEMasterInfo)

Mostra informações de um mestre do cluster do Google Kubernetes Engine.
cloudSqlInstance

object (CloudSQLInstanceInfo)

Mostra informações de uma instância do Cloud SQL.
redisInstance

object (RedisInstanceInfo)

Mostra informações de uma instância do Redis.
redisCluster

object (RedisClusterInfo)

Mostra informações de um cluster do Redis.
cloudFunction

object (CloudFunctionInfo)

Mostrar informações de uma função do Cloud.
appEngineVersion

object (AppEngineVersionInfo)

Mostra informações de uma versão de serviço do App Engine.
cloudRunRevision

object (CloudRunRevisionInfo)

Mostra informações de uma revisão do Cloud Run.
nat

object (NatInfo)

Mostra informações de um NAT.
proxyConnection

object (ProxyConnectionInfo)

Mostra informações de uma ProxyConnection.
loadBalancerBackendInfo

object (LoadBalancerBackendInfo)

Mostra informações de um back-end de balanceador de carga específico.
storageBucket

object (StorageBucketInfo)

Mostra informações de um bucket do Storage. Usado apenas para rastreamentos de retorno.
serverlessNeg

object (ServerlessNegInfo)

Mostra informações de um back-end de grupo de endpoints de rede sem servidor. Usado apenas para rastreamentos de retorno.

Estado

Tipos de estados definidos na máquina de estado da rede. Cada etapa no trace de pacotes está em um estado específico.

Enums
STATE_UNSPECIFIED Estado não especificado.
START_FROM_INSTANCE Estado inicial: pacote originário de uma instância do Compute Engine. Um InstanceInfo é preenchido com informações da instância inicial.
START_FROM_INTERNET Estado inicial: pacote originário da Internet. As informações do endpoint são preenchidas.
START_FROM_GOOGLE_SERVICE Estado inicial: pacote originário de um serviço do Google. As informações do googleService são preenchidas.
START_FROM_PRIVATE_NETWORK Estado inicial: pacote originário de uma VPC ou rede local com IP de origem interno. Se a origem for uma rede VPC visível para o usuário, um NetworkInfo será preenchido com detalhes da rede.
START_FROM_GKE_MASTER Estado inicial: pacote originário de um mestre do cluster do Google Kubernetes Engine. Um GKEMasterInfo é preenchido com informações da instância inicial.
START_FROM_CLOUD_SQL_INSTANCE Estado inicial: pacote originário de uma instância do Cloud SQL. Um CloudSQLInstanceInfo é preenchido com informações da instância inicial.
START_FROM_REDIS_INSTANCE Estado inicial: pacote originário de uma instância do Redis. Um RedisInstanceInfo é preenchido com informações da instância inicial.
START_FROM_REDIS_CLUSTER Estado inicial: pacote originário de um cluster do Redis. Um RedisClusterInfo é preenchido com informações do cluster inicial.
START_FROM_CLOUD_FUNCTION Estado inicial: pacote originário de uma função do Cloud. Um CloudFunctionInfo é preenchido com informações da função inicial.
START_FROM_APP_ENGINE_VERSION Estado inicial: pacote originário de uma versão de serviço do App Engine. Um AppEngineVersionInfo é preenchido com informações da versão inicial.
START_FROM_CLOUD_RUN_REVISION Estado inicial: pacote originário de uma revisão do Cloud Run. Um CloudRunRevisionInfo é preenchido com informações da revisão inicial.
START_FROM_STORAGE_BUCKET Estado inicial: pacote originário de um bucket do Storage. Usado apenas para rastreamentos de retorno. As informações de storageBucket são preenchidas.
START_FROM_PSC_PUBLISHED_SERVICE Estado inicial: pacote originado de um serviço publicado que usa o Private Service Connect. Usado apenas para rastreamentos de retorno.
START_FROM_SERVERLESS_NEG Estado inicial: pacote originário de um back-end de grupo de endpoints de rede sem servidor. Usado apenas para rastreamentos de retorno. As informações de "serverlessNeg" são preenchidas.
APPLY_INGRESS_FIREWALL_RULE Estado da verificação de configuração: verifique a regra de firewall de entrada.
APPLY_EGRESS_FIREWALL_RULE Estado da verificação de configuração: verifique a regra de firewall de saída.
APPLY_ROUTE Estado da verificação de configuração: verifique a rota.
APPLY_FORWARDING_RULE Estado da verificação de configuração: corresponde à regra de encaminhamento.
ANALYZE_LOAD_BALANCER_BACKEND Estado da verificação de configuração: verifique a configuração de back-end do balanceador de carga.
SPOOFING_APPROVED Estado da verificação de configuração: pacote enviado ou recebido sob endereço IP estrangeiro e permitido.
ARRIVE_AT_INSTANCE Estado de encaminhamento: chegando a uma instância do Compute Engine.
ARRIVE_AT_INTERNAL_LOAD_BALANCER

Estado de encaminhamento: chegando a um balanceador de carga interno do Compute Engine. Descontinuado em favor do estado ANALYZE_LOAD_BALANCER_BACKEND, não usado em novos testes.
ARRIVE_AT_EXTERNAL_LOAD_BALANCER

Estado de encaminhamento: chegando a um balanceador de carga externo do Compute Engine. Descontinuado em favor do estado ANALYZE_LOAD_BALANCER_BACKEND, não usado em novos testes.
ARRIVE_AT_VPN_GATEWAY Estado de encaminhamento: chegando a um gateway de VPN do Cloud.
ARRIVE_AT_VPN_TUNNEL Estado de encaminhamento: chegando a um túnel de VPN na nuvem.
ARRIVE_AT_VPC_CONNECTOR Estado de encaminhamento: chegando a um conector de VPC.
DIRECT_VPC_EGRESS_CONNECTION Estado de encaminhamento: para pacotes originados de um endpoint sem servidor encaminhados pela saída VPC direta.
SERVERLESS_EXTERNAL_CONNECTION Estado de encaminhamento: para pacotes originados de um endpoint sem servidor encaminhados por conectividade pública (externa).
NAT Estado de transição: cabeçalho do pacote convertido.
PROXY_CONNECTION Estado de transição: a conexão original é encerrada e uma nova conexão com proxy é iniciada.
DELIVER Estado final: o pacote pode ser entregue.
DROP Estado final: o pacote pode ser descartado.
FORWARD Estado final: o pacote pode ser encaminhado para uma rede com uma configuração desconhecida.
ABORT Estado final: a análise é abortada.
VIEWER_PERMISSION_MISSING Estado especial: o visualizador do resultado do teste não tem permissão para ver a configuração nesta etapa.

InstanceInfo

Apenas para exibição. Metadados associados a uma instância do Compute Engine.

Representação JSON 
{
  "displayName": string,
  "uri": string,
  "interface": string,
  "networkUri": string,
  "internalIp": string,
  "externalIp": string,
  "networkTags": [
    string
  ],
  "serviceAccount": string,
  "pscNetworkAttachmentUri": string,
  "running": boolean,
  "status": enum (Status)
}
Campos
displayName

string

Nome de uma instância do Compute Engine.
uri

string

URI de uma instância do Compute Engine.
interface

string

Nome da interface de rede de uma instância do Compute Engine.
networkUri

string

URI de uma rede do Compute Engine.
internalIp

string

Endereço IP interno da interface de rede.
externalIp

string

Endereço IP externo da interface de rede.
networkTags[]

string

Tags de rede configuradas na instância.
serviceAccount
(deprecated)

string

Conta de serviço autorizada para a instância.
pscNetworkAttachmentUri

string

URI do anexo de rede do PSC a que a NIC está anexada (se relevante).
running
(deprecated)

boolean

Indica se a instância do Compute Engine está em execução. Descontinuado: use o campo status.
status

enum (Status)

O status da instância.

Status

O status da instância. Tratamos todos os estados diferentes de "EM EXECUÇÃO" como não em execução.

Enums
STATUS_UNSPECIFIED Valor padrão não especificado.
RUNNING A instância está em execução.
NOT_RUNNING A instância tem um status diferente de "EM EXECUÇÃO".

FirewallInfo

Apenas para exibição. Metadados associados a uma regra de firewall da VPC, uma regra de firewall implícita da VPC ou uma regra de política de firewall.

Representação 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
}
Campos
displayName

string

O nome de exibição da regra de firewall. Esse campo pode estar vazio para regras de política de firewall.
uri

string

O URI da regra de firewall. Esse campo não se aplica a regras de firewall de VPC implícitas.
direction

string

Valores possíveis: ENTRADA, SAÍDA
action

string

Valores possíveis: ALLOW, DENY, APPLY_SECURITY_PROFILE_GROUP
priority

integer

A prioridade da regra de firewall.
networkUri

string

O URI da rede VPC associada à regra de firewall. Esse campo não se aplica a regras de política de firewall hierárquicas.
targetTags[]

string

As tags de destino definidas pela regra de firewall da VPC. Esse campo não se aplica a regras de política de firewall.
targetServiceAccounts[]

string

As contas de serviço de destino especificadas pela regra de firewall.
policy

string

O nome da política de firewall a que esta regra está associada. Esse campo não se aplica a regras de firewall de VPC e regras de firewall de VPC implícitas.
policyUri

string

O URI da política de firewall a que esta regra está associada. Esse campo não se aplica a regras de firewall de VPC e regras de firewall de VPC implícitas.
firewallRuleType

enum (FirewallRuleType)

O tipo da regra de firewall.
policyPriority

integer

A prioridade da política de firewall a que esta regra está associada. Esse campo não se aplica a regras de firewall de VPC e regras de firewall de VPC implícitas.

FirewallRuleType

O tipo da regra de firewall.

Enums
FIREWALL_RULE_TYPE_UNSPECIFIED Tipo não especificado.
HIERARCHICAL_FIREWALL_POLICY_RULE Regra da política de firewall hierárquica. Para mais detalhes, consulte Visão geral das políticas de firewall hierárquicas.
VPC_FIREWALL_RULE Regra de firewall da VPC. Para mais detalhes, consulte Visão geral das regras de firewall da VPC.
IMPLIED_VPC_FIREWALL_RULE Regra de firewall implícita da VPC. Para mais detalhes, consulte Regras implícitas.
SERVERLESS_VPC_ACCESS_MANAGED_FIREWALL_RULE Regras de firewall implícitas gerenciadas pelo acesso VPC sem servidor para permitir o acesso de entrada. Elas não aparecem no console do Google Cloud. Para mais detalhes, consulte Regras implícitas do conector VPC.
NETWORK_FIREWALL_POLICY_RULE Regra da política de firewall de rede global. Para mais detalhes, consulte Políticas de firewall de rede.
NETWORK_REGIONAL_FIREWALL_POLICY_RULE Regra da política de firewall regional da rede. Para mais detalhes, consulte Políticas de firewall de rede regionais.
UNSUPPORTED_FIREWALL_POLICY_RULE Regra de política de firewall que contém atributos ainda não compatíveis com os testes de conectividade. A análise do firewall é ignorada se uma regra desse tipo puder ser correspondida. Consulte a lista de configurações sem suporte.
TRACKING_STATE Rastreamento do estado do tráfego de resposta criado quando o tráfego de solicitação passa pela regra de firewall de permissão. Para mais detalhes, consulte especificações das regras de firewall.
ANALYSIS_SKIPPED A análise do firewall foi ignorada porque o Teste de conectividade foi executado no modo BypassFirewallChecks

RouteInfo

Apenas para exibição. Metadados associados a uma rota do Compute Engine.

Representação 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
}
Campos
routeType

enum (RouteType)

Tipo de rota.
nextHopType

enum (NextHopType)

Tipo de salto seguinte.
routeScope
(deprecated)

enum (RouteScope)

Indica onde a rota é aplicável. Descontinuado. As rotas com escopo NCC_HUB não estão incluídas no rastreamento em novos testes.
displayName

string

Nome de uma rota.
uri

string

URI de uma rota. SUBNET, STATIC, PEERING_SUBNET (somente para rede de peering) e POLICY_BASED.
region

string

Região da rota. Somente rotas DYNAMIC, PEERING_DYNAMIC, POLICY_BASED e ADVERTISED. Se definido como POLICY_BASED, será uma região de anexos da VLAN do Cloud Interconnect a que a rota se aplica.
destIpRange

string

Intervalo de IPs de destino da rota.
nextHop
(deprecated)

string

Tipo de string do próximo salto da rota (por exemplo, "Túnel VPN"). Descontinuado em favor dos campos "nextHopType" e "nextHopUri", não usado em novos testes.
networkUri

string

URI de uma rede VPC em que a rota está localizada.
priority

integer

Prioridade da rota.
instanceTags[]

string

Tags de instância da rota.
srcIpRange

string

Intervalo de endereços IP de origem da rota. Somente rotas POLICY_BASED.
destPortRanges[]

string

Intervalos de portas de destino da rota. Somente rotas POLICY_BASED.
srcPortRanges[]

string

Intervalos de portas de origem da rota. Somente rotas POLICY_BASED.
protocols[]

string

Protocolos da rota. Somente rotas POLICY_BASED.
nextHopUri

string

URI do recurso de próximo salto.
nextHopNetworkUri

string

URI de uma rede VPC em que o recurso de próximo salto está localizado.
originatingRouteUri

string

Para rotas PEERING_SUBNET e PEERING_STATIC, o URI da rota SUBNET/STATIC de origem.
originatingRouteDisplayName

string

Para rotas PEERING_SUBNET, PEERING_STATIC e PEERING_DYNAMIC, o nome da rota SUBNET/STATIC/DYNAMIC de origem.
nccHubRouteUri

string

Para rotas PEERING_SUBNET e PEERING_DYNAMIC anunciadas pelo hub do NCC, o URI da rota correspondente na tabela de rotas do hub do NCC.
nccHubUri

string

URI do hub do NCC em que a rota é anunciada. Rotas PEERING_SUBNET e PEERING_DYNAMIC anunciadas apenas pelo hub do NCC.
nccSpokeUri

string

URI do spoke do NCC de destino. Rotas PEERING_SUBNET e PEERING_DYNAMIC anunciadas apenas pelo hub do NCC.
advertisedRouteSourceRouterUri

string

Para rotas dinâmicas ADVERTISED, o URI do Cloud Router que divulgou o prefixo de IP correspondente.
advertisedRouteNextHopUri
(deprecated)

string

Para rotas ANUNCIADAS, o URI do próximo salto, ou seja, o URI do endpoint híbrido (túnel VPN, anexo de interconexão, dispositivo roteador do NCC) pelo qual o prefixo anunciado é divulgado ou o URI da rede de origem em peering. Descontinuado em favor do campo "nextHopUri", não usado em novos testes.

RouteType

Tipo de rota:

Enums
ROUTE_TYPE_UNSPECIFIED Tipo não especificado. Valor padrão.
SUBNET Rota é uma rota de sub-rede criada automaticamente pelo sistema.
STATIC Rota estática criada pelo usuário, incluindo a rota padrão para a Internet.
DYNAMIC A rota dinâmica trocada entre pares BGP.
PEERING_SUBNET Uma rota de sub-rede recebida da rede de peering ou do hub do NCC.
PEERING_STATIC Uma rota estática recebida da rede peering.
PEERING_DYNAMIC Uma rota dinâmica recebida da rede de peering ou do hub do NCC.
POLICY_BASED Rota com base em políticas.
ADVERTISED Rota anunciada. Rota sintética usada para fazer a transição do estado "StartFromPrivateNetwork" nos testes de conectividade.

NextHopType

Tipo de salto seguinte:

Enums
NEXT_HOP_TYPE_UNSPECIFIED Tipo não especificado. Valor padrão.
NEXT_HOP_IP O próximo salto é um endereço IP.
NEXT_HOP_INSTANCE O próximo salto é uma instância do Compute Engine.
NEXT_HOP_NETWORK O próximo salto é um gateway de rede VPC.
NEXT_HOP_PEERING O próximo salto é uma peering de VPC. Esse cenário só acontece quando o usuário não tem permissões para o projeto em que o recurso de próximo salto está localizado.
NEXT_HOP_INTERCONNECT O próximo salto é uma interconexão.
NEXT_HOP_VPN_TUNNEL O próximo salto é um túnel VPN.
NEXT_HOP_VPN_GATEWAY O próximo salto é um gateway VPN. Esse cenário ocorre apenas ao rastrear a conectividade de uma rede local para o Google Cloud por meio de uma VPN. A análise simula um pacote que sai da rede local por um túnel VPN e chega a um gateway do Cloud VPN.
NEXT_HOP_INTERNET_GATEWAY O próximo salto é um gateway da Internet.
NEXT_HOP_BLACKHOLE O próximo salto é um buraco negro. Isto é, o próximo salto não existe ou não pode ser usado.
NEXT_HOP_ILB O próximo salto é a regra de encaminhamento de um balanceador de carga interno.
NEXT_HOP_ROUTER_APPLIANCE O próximo salto é uma instância de dispositivo roteador.
NEXT_HOP_NCC_HUB O próximo salto é um hub do NCC. Esse cenário só acontece quando o usuário não tem permissões para o projeto em que o recurso de próximo salto está localizado.
SECURE_WEB_PROXY_GATEWAY O próximo salto é o gateway do Secure Web Proxy.

RouteScope

Indica onde as rotas são aplicáveis.

Enums
ROUTE_SCOPE_UNSPECIFIED Escopo não especificado. Valor padrão.
NETWORK A rota é aplicável a pacotes na rede.
NCC_HUB A rota é aplicável a pacotes que usam a tabela de roteamento do hub do NCC.

GoogleServiceInfo

Apenas para exibição. Detalhes de um serviço do Google que envia pacotes para uma rede VPC. Embora o IP de origem possa ser um endereço roteável publicamente, alguns Serviços do Google usam rotas especiais na infraestrutura de produção do Google para alcançar instâncias do Compute Engine. https://cloud.google.com/vpc/docs/routes#special_return_paths

Representação JSON 
{
  "sourceIp": string,
  "googleServiceType": enum (GoogleServiceType)
}
Campos
sourceIp

string

Endereço IP de origem.
googleServiceType

enum (GoogleServiceType)

Tipo reconhecido de um serviço do Google.

GoogleServiceType

Tipo reconhecido de um serviço do Google.

Enums
GOOGLE_SERVICE_TYPE_UNSPECIFIED Serviço do Google não especificado.
IAP Identity-Aware Proxy. https://cloud.google.com/iap/docs/using-tcp-forwarding
GFE_PROXY_OR_HEALTH_CHECK_PROBER Um dos dois serviços que compartilham intervalos de IP: * Proxy do balanceador de carga * Sonda de verificação de integridade centralizada https://cloud.google.com/load-balancing/docs/firewall-rules
CLOUD_DNS Conectividade do Cloud DNS com destinos de encaminhamento ou servidores de nomes alternativos que usam roteamento particular. 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 e restricted.googleapis.com
GOOGLE_API_PSC API do Google via Private Service Connect. https://cloud.google.com/vpc/docs/configure-private-service-connect-apis
GOOGLE_API_VPC_SC API do Google via VPC Service Controls. https://cloud.google.com/vpc/docs/configure-private-service-connect-apis
SERVERLESS_VPC_ACCESS API do Google via acesso VPC sem servidor. https://cloud.google.com/vpc/docs/serverless-vpc-access

ForwardingRuleInfo

Apenas para exibição. Metadados associados a uma regra de encaminhamento do Compute Engine.

Representação JSON 
{
  "displayName": string,
  "uri": string,
  "matchedProtocol": string,
  "matchedPortRange": string,
  "vip": string,
  "target": string,
  "networkUri": string,
  "region": string,
  "loadBalancerName": string,
  "pscServiceAttachmentUri": string,
  "pscGoogleApiTarget": string
}
Campos
displayName

string

Nome da regra de encaminhamento.
uri

string

URI da regra de encaminhamento.
matchedProtocol

string

Protocolo definido na regra de encaminhamento que corresponde ao pacote.
matchedPortRange

string

Intervalo de portas definido na regra de encaminhamento que corresponde ao pacote.
vip

string

VIP da regra de encaminhamento.
target

string

Tipo de destino da regra de encaminhamento.
networkUri

string

URI da rede.
region

string

Região da regra de encaminhamento. Definido apenas para regras de encaminhamento regionais.
loadBalancerName

string

Nome do balanceador de carga a que a regra de encaminhamento pertence. Vazio para regras de encaminhamento não relacionadas a balanceadores de carga (como regras de encaminhamento do PSC).
pscServiceAttachmentUri

string

URI do anexo de serviço do PSC a que esta regra de encaminhamento se destina (se aplicável).
pscGoogleApiTarget

string

Destino da API do Google para PSC que essa regra de encaminhamento segmenta (se aplicável).

VpnGatewayInfo

Apenas para exibição. Metadados associados a um gateway de VPN do Compute Engine.

Representação JSON 
{
  "displayName": string,
  "uri": string,
  "networkUri": string,
  "ipAddress": string,
  "vpnTunnelUri": string,
  "region": string
}
Campos
displayName

string

Nome de um gateway VPN.
uri

string

URI de um gateway VPN.
networkUri

string

URI de uma rede do Compute Engine em que o gateway VPN está configurado.
ipAddress

string

Endereço IP do gateway VPN.
vpnTunnelUri

string

Um túnel VPN associado a este gateway VPN. Pode haver vários túneis VPN configurados em um gateway VPN, e apenas o relevante para o teste é exibido.
region

string

Nome de uma região do Google Cloud em que este gateway VPN está configurado.

VpnTunnelInfo

Apenas para exibição. Metadados associados a um túnel de VPN do Compute Engine.

Representação JSON 
{
  "displayName": string,
  "uri": string,
  "sourceGateway": string,
  "remoteGateway": string,
  "remoteGatewayIp": string,
  "sourceGatewayIp": string,
  "networkUri": string,
  "region": string,
  "routingType": enum (RoutingType)
}
Campos
displayName

string

Nome de um túnel VPN.
uri

string

URI de um túnel VPN.
sourceGateway

string

URI do gateway VPN na extremidade local do túnel.
remoteGateway

string

URI de um gateway VPN na extremidade remota do túnel.
remoteGatewayIp

string

Endereço IP do gateway VPN remoto.
sourceGatewayIp

string

Endereço IP do gateway VPN local.
networkUri

string

URI de uma rede do Compute Engine em que o túnel da VPN está configurado.
region

string

Nome de uma região do Google Cloud em que este túnel VPN está configurado.
routingType

enum (RoutingType)

Tipo da política de roteamento.

RoutingType

Tipos de política de roteamento VPN. Para detalhes, consulte Roteamento de redes e túneis.

Enums
ROUTING_TYPE_UNSPECIFIED Tipo não especificado. Valor padrão.
ROUTE_BASED VPN com base em rota.
POLICY_BASED Roteamento com base em políticas.
DYNAMIC Roteamento dinâmico (BGP).

VpcConnectorInfo

Apenas para exibição. Metadados associados a um conector de VPC.

Representação JSON 
{
  "displayName": string,
  "uri": string,
  "location": string
}
Campos
displayName

string

Nome de um conector de VPC.
uri

string

URI de um conector de VPC.
location

string

Local em que o conector VPC é implantado.

DirectVpcEgressConnectionInfo

Apenas para exibição. Metadados associados a uma conexão de saída de VPC direta sem servidor.

Representação JSON 
{
  "networkUri": string,
  "subnetworkUri": string,
  "selectedIpRange": string,
  "selectedIpAddress": string,
  "region": string
}
Campos
networkUri

string

URI da rede de acesso direto.
subnetworkUri

string

URI da sub-rede de acesso direto.
selectedIpRange

string

Intervalo de IP selecionado.
selectedIpAddress

string

Endereço IP inicial selecionado, do intervalo de IP selecionado.
region

string

Região em que a saída de VPC direta é implantada.

ServerlessExternalConnectionInfo

Apenas para exibição. Metadados associados a uma conexão pública sem servidor.

Representação JSON 
{
  "selectedIpAddress": string
}
Campos
selectedIpAddress

string

Endereço IP inicial selecionado do pool de endereços dinâmicos do Google.

DeliverInfo

Detalhes do estado final "entregar" e recurso associado.

Representação JSON 
{
  "target": enum (Target),
  "resourceUri": string,
  "ipAddress": string,
  "storageBucket": string,
  "pscGoogleApiTarget": string,
  "googleServiceType": enum (GoogleServiceType)
}
Campos
target

enum (Target)

Tipo de destino para onde o pacote é entregue.
resourceUri

string

URI do recurso ao qual o pacote é entregue.
ipAddress

string

Endereço IP da meta (se aplicável).
storageBucket

string

Nome do bucket do Cloud Storage em que o pacote é entregue (se aplicável).
pscGoogleApiTarget

string

Destino da API do Google para PSC em que o pacote é entregue (se aplicável).
googleServiceType

enum (GoogleServiceType)

Tipo reconhecido de um serviço do Google para onde o pacote é entregue (se aplicável).

Destino

Entregue tipos de destino:

Enums
TARGET_UNSPECIFIED Destino não especificado.
INSTANCE O destino é uma instância do Compute Engine.
INTERNET O destino é a Internet.
GOOGLE_API O destino é uma API do Google.
GKE_MASTER O destino é um mestre do cluster do Google Kubernetes Engine.
CLOUD_SQL_INSTANCE O destino é uma instância do Cloud SQL.
PSC_PUBLISHED_SERVICE O destino é um serviço publicado que usa o Private Service Connect.
PSC_GOOGLE_API O destino são as APIs do Google que usam o Private Service Connect.
PSC_VPC_SC O destino é um VPC-SC que usa o Private Service Connect.
SERVERLESS_NEG O destino é um grupo de endpoints de rede sem servidor.
STORAGE_BUCKET O destino é um bucket do Cloud Storage.
PRIVATE_NETWORK O destino é uma rede privada. Usado apenas para rastreamentos de retorno.
CLOUD_FUNCTION O destino é uma função do Cloud. Usado apenas para rastreamentos de retorno.
APP_ENGINE_VERSION O destino é uma versão de serviço do App Engine. Usado apenas para rastreamentos de retorno.
CLOUD_RUN_REVISION O destino é uma revisão do Cloud Run. Usado apenas para rastreamentos de retorno.
GOOGLE_MANAGED_SERVICE O destino é um serviço gerenciado pelo Google. Usado apenas para rastreamentos de retorno.
REDIS_INSTANCE O destino é uma instância do Redis.
REDIS_CLUSTER O destino é um cluster do Redis.

GoogleServiceType

Tipo reconhecido de um serviço do Google.

Enums
GOOGLE_SERVICE_TYPE_UNSPECIFIED Serviço do Google não especificado.
IAP Identity-Aware Proxy. https://cloud.google.com/iap/docs/using-tcp-forwarding
GFE_PROXY_OR_HEALTH_CHECK_PROBER Um dos dois serviços que compartilham intervalos de IP: * Proxy do balanceador de carga * Sonda de verificação de integridade centralizada https://cloud.google.com/load-balancing/docs/firewall-rules
CLOUD_DNS Conectividade do Cloud DNS com destinos de encaminhamento ou servidores de nomes alternativos que usam roteamento particular. 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 e restricted.googleapis.com
SERVERLESS_VPC_ACCESS API do Google via acesso VPC sem servidor. https://cloud.google.com/vpc/docs/serverless-vpc-access

ForwardInfo

Detalhes do estado final "encaminhar" e recurso associado.

Representação JSON 
{
  "target": enum (Target),
  "resourceUri": string,
  "ipAddress": string
}
Campos
target

enum (Target)

Tipo de destino para onde este pacote é encaminhado.
resourceUri

string

URI do recurso para o qual o pacote é encaminhado.
ipAddress

string

Endereço IP do destino (se aplicável).

Destino

Encaminhe tipos de destino.

Enums
TARGET_UNSPECIFIED Destino não especificado.
PEERING_VPC Encaminhado para uma rede de emparelhamento VPC.
VPN_GATEWAY Encaminhado para um gateway de VPN em nuvem.
INTERCONNECT Encaminhada para uma conexão do Cloud Interconnect.
GKE_MASTER

Encaminhado para um mestre de cluster do Google Kubernetes Engine Container.
IMPORTED_CUSTOM_ROUTE_NEXT_HOP Encaminhado para o próximo salto de uma rota personalizada importada de uma VPC emparelhada.
CLOUD_SQL_INSTANCE

Encaminhada para uma instância do Cloud SQL.
ANOTHER_PROJECT Encaminhado para uma rede VPC em outro projeto.
NCC_HUB Encaminhado para um hub do NCC.
ROUTER_APPLIANCE Encaminhado para um dispositivo roteador.
SECURE_WEB_PROXY_GATEWAY Encaminhado para um gateway do Secure Web Proxy.

AbortInfo

Detalhes do estado final "interromper" e recurso associado.

Representação JSON 
{
  "cause": enum (Cause),
  "resourceUri": string,
  "ipAddress": string,
  "projectsMissingPermission": [
    string
  ]
}
Campos
cause

enum (Cause)

Faz com que a análise seja interrompida.
resourceUri

string

URI do recurso que causou o cancelamento.
ipAddress

string

Endereço IP que causou o cancelamento.
projectsMissingPermission[]

string

Lista de IDs de projetos que o usuário especificou na solicitação, mas não tem acesso. Nesse caso, a análise é interrompida com a causa PERMISSION_DENIED.

Causa

Tipos de causa da interrupção:

Enums
CAUSE_UNSPECIFIED Causa não especificada.
UNKNOWN_NETWORK

Interrompido devido a rede desconhecida. Descontinuado, não usado nos novos testes.
UNKNOWN_PROJECT

Interrompido porque nenhuma informação do projeto pode ser derivada da entrada de teste. Descontinuado, não usado nos novos testes.
NO_EXTERNAL_IP

Interrompido porque o tráfego é enviado de um IP público para uma instância sem um IP externo. Descontinuado, não usado nos novos testes.
UNINTENDED_DESTINATION

Cancelado porque nenhum dos traces corresponde às informações de destino especificadas na solicitação de teste de entrada Descontinuado, não usado nos novos testes.
SOURCE_ENDPOINT_NOT_FOUND

Cancelada porque o endpoint de origem não foi encontrado. Descontinuado, não usado nos novos testes.
MISMATCHED_SOURCE_NETWORK

Cancelada porque a rede de origem não corresponde ao endpoint de origem. Descontinuado, não usado nos novos testes.
DESTINATION_ENDPOINT_NOT_FOUND

Cancelada porque o endpoint de destino não foi encontrado. Descontinuado, não usado nos novos testes.
MISMATCHED_DESTINATION_NETWORK

Cancelada porque a rede de destino não corresponde ao endpoint de destino. Descontinuado, não usado nos novos testes.
UNKNOWN_IP Cancelada porque nenhum endpoint com o endereço IP de destino do pacote foi encontrado.
GOOGLE_MANAGED_SERVICE_UNKNOWN_IP Cancelada porque nenhum endpoint com o IP de destino do pacote foi encontrado no projeto gerenciado pelo Google.
SOURCE_IP_ADDRESS_NOT_IN_SOURCE_NETWORK Cancelada porque o endereço IP de origem não pertence a nenhuma das sub-redes da rede VPC de origem.
PERMISSION_DENIED A operação foi cancelada porque o usuário não tem permissão para acessar todas ou parte das configurações de rede necessárias para executar o teste.
PERMISSION_DENIED_NO_CLOUD_NAT_CONFIGS A operação foi cancelada porque o usuário não tem permissão para acessar as configurações do Cloud NAT necessárias para executar o teste.
PERMISSION_DENIED_NO_NEG_ENDPOINT_CONFIGS A operação foi cancelada porque o usuário não tem permissão para acessar as configurações de endpoint do grupo de endpoints de rede necessárias para executar o teste.
PERMISSION_DENIED_NO_CLOUD_ROUTER_CONFIGS A operação foi cancelada porque o usuário não tem permissão para acessar as configurações do Cloud Router necessárias para executar o teste.
NO_SOURCE_LOCATION Interrompido porque nenhum endpoint de origem ou destino válido é derivado da solicitação de teste de entrada.
INVALID_ARGUMENT Cancelada porque o endpoint de origem ou destino especificado na solicitação é inválido. Alguns exemplos: - A solicitação pode conter um URI de recurso, um ID do projeto ou um endereço IP malformado. - A solicitação pode conter informações inconsistentes. Por exemplo, ela pode incluir a instância e a rede, mas a instância pode não ter uma NIC nessa rede.
TRACE_TOO_LONG Interrompido porque o número de etapas no trace excede um determinado limite. Isso pode ser causado por um loop de roteamento.
INTERNAL_ERROR Cancelada devido a um erro interno do servidor.
UNSUPPORTED Cancelado porque não há suporte para o cenário de teste.
MISMATCHED_IP_VERSION Cancelada porque os recursos de origem e de destino não têm uma versão de IP em comum.
GKE_KONNECTIVITY_PROXY_UNSUPPORTED Cancelada porque a conexão entre o plano de controle e o nó do cluster de origem é iniciada pelo nó e gerenciada pelo proxy Konnectivity.
RESOURCE_CONFIG_NOT_FOUND Cancelada porque a configuração de recurso esperada não foi encontrada.
VM_INSTANCE_CONFIG_NOT_FOUND Cancelada porque a configuração esperada da instância de VM não foi encontrada.
NETWORK_CONFIG_NOT_FOUND Cancelada porque a configuração de rede esperada não foi encontrada.
FIREWALL_CONFIG_NOT_FOUND Cancelada porque a configuração de firewall esperada não foi encontrada.
ROUTE_CONFIG_NOT_FOUND Cancelada porque a configuração de rota esperada não foi encontrada.
GOOGLE_MANAGED_SERVICE_AMBIGUOUS_PSC_ENDPOINT Cancelada porque a seleção de endpoints do PSC para o serviço gerenciado pelo Google é ambígua (vários endpoints do PSC satisfazem a entrada de teste).
GOOGLE_MANAGED_SERVICE_AMBIGUOUS_ENDPOINT Cancelada porque a seleção de endpoints para o serviço gerenciado pelo Google é ambígua (vários endpoints satisfazem a entrada de teste).
SOURCE_PSC_CLOUD_SQL_UNSUPPORTED Cancelada porque os testes com uma instância do Cloud SQL baseada em PSC como origem não são compatíveis.
SOURCE_REDIS_CLUSTER_UNSUPPORTED Cancelada porque os testes com um cluster do Redis como origem não são aceitos.
SOURCE_REDIS_INSTANCE_UNSUPPORTED Cancelada porque os testes com uma instância do Redis como origem não são aceitos.
SOURCE_FORWARDING_RULE_UNSUPPORTED Cancelada porque os testes com uma regra de encaminhamento como origem não são aceitos.
NON_ROUTABLE_IP_ADDRESS Cancelada porque um dos endpoints é um endereço IP não roteável (loopback, link-local etc.).
UNKNOWN_ISSUE_IN_GOOGLE_MANAGED_PROJECT Cancelado devido a um problema desconhecido no projeto gerenciado pelo Google.
UNSUPPORTED_GOOGLE_MANAGED_PROJECT_CONFIG Cancelado devido a uma configuração não compatível do projeto gerenciado pelo Google.
NO_SERVERLESS_IP_RANGES Cancelada porque o endpoint de origem é uma revisão do Cloud Run com acesso direto à VPC ativado, mas não há intervalos de IP sem servidor reservados.

DropInfo

Detalhes do estado final "soltar" e recurso associado.

Representação JSON 
{
  "cause": enum (Cause),
  "resourceUri": string,
  "sourceIp": string,
  "destinationIp": string,
  "region": string
}
Campos
cause

enum (Cause)

Causa pela qual o pacote foi solto.
resourceUri

string

URI do recurso que causou a queda.
sourceIp

string

Endereço IP de origem do pacote descartado (se relevante).
destinationIp

string

Endereço IP de destino do pacote descartado (se relevante).
region

string

Região do pacote descartado (se relevante).

Causa

Tipos de causa de queda:

Enums
CAUSE_UNSPECIFIED Causa não especificada.
UNKNOWN_EXTERNAL_ADDRESS Endereço externo não pode ser encontrado sem um destino conhecido. Se o endereço for usado em um projeto do Google Cloud, forneça o ID do projeto como entrada de teste.
FOREIGN_IP_DISALLOWED Uma instância do Compute Engine só pode enviar ou receber um pacote com um endereço IP externo se o ip_forward estiver habilitado.
FIREWALL_RULE Descartado devido a uma regra de firewall a menos que permitido devido a um rastreamento de conexão.
NO_ROUTE Descartado por não haver rotas correspondentes.
ROUTE_BLACKHOLE Descartado devido à rota inválida. O próximo salto da rota é um buraco negro.
ROUTE_WRONG_NETWORK O pacote está sendo enviado para a rede errada (não intencional). Exemplo: você rastreia um pacote da VM1:Rede1 para VM2:Rede2, no entanto, a rota configurada na Rede1 envia o pacote destinado ao endereço IP da VM2 para a Rede3.
ROUTE_NEXT_HOP_IP_ADDRESS_NOT_RESOLVED O endereço IP do próximo salto da rota não pode ser resolvido em um recurso do GCP.
ROUTE_NEXT_HOP_RESOURCE_NOT_FOUND O recurso do próximo salto da rota não foi encontrado.
ROUTE_NEXT_HOP_INSTANCE_WRONG_NETWORK A instância do próximo salto da rota não tem uma placa de rede (NIC) na rede da rota.
ROUTE_NEXT_HOP_INSTANCE_NON_PRIMARY_IP O endereço IP do próximo salto da rota não é um endereço IP primário da instância do próximo salto.
ROUTE_NEXT_HOP_FORWARDING_RULE_IP_MISMATCH A regra de encaminhamento do próximo salto da rota não corresponde ao endereço IP do próximo salto.
ROUTE_NEXT_HOP_VPN_TUNNEL_NOT_ESTABLISHED O túnel VPN do próximo salto da rota está inativo (não tem SAs do IKE válidas).
ROUTE_NEXT_HOP_FORWARDING_RULE_TYPE_INVALID O tipo de regra de encaminhamento do próximo salto da rota é inválido (não é uma regra de encaminhamento do balanceador de carga de passagem interna).
NO_ROUTE_FROM_INTERNET_TO_PRIVATE_IPV6_ADDRESS O pacote é enviado da Internet ou do serviço do Google para o endereço IPv6 privado.
NO_ROUTE_FROM_EXTERNAL_IPV6_SOURCE_TO_PRIVATE_IPV6_ADDRESS O pacote é enviado do endereço de origem IPv6 externo de uma instância para o endereço IPv6 privado de outra.
VPN_TUNNEL_LOCAL_SELECTOR_MISMATCH O pacote não corresponde a um seletor local de túnel VPN baseado em política.
VPN_TUNNEL_REMOTE_SELECTOR_MISMATCH O pacote não corresponde a um seletor remoto de túnel VPN baseado em política.
PRIVATE_TRAFFIC_TO_INTERNET Pacote com endereço interno de destino enviado para o gateway da Internet.
PRIVATE_GOOGLE_ACCESS_DISALLOWED O endpoint com apenas um endereço IP interno tenta acessar a API e os serviços do Google, mas o Acesso privado do Google não está ativado na sub-rede ou não é aplicável.
PRIVATE_GOOGLE_ACCESS_VIA_VPN_TUNNEL_UNSUPPORTED O endpoint de origem tenta acessar a API e os serviços do Google com o túnel VPN para outra rede, mas o Acesso privado do Google precisa ser ativado na rede do endpoint de origem.
NO_EXTERNAL_ADDRESS O endpoint com apenas um endereço IP interno tenta acessar hosts externos, mas não há um gateway do Cloud NAT correspondente na sub-rede.
UNKNOWN_INTERNAL_ADDRESS Endereço interno não encontrado para um destino conhecido. Se este for um cenário de VPC compartilhado, verifique se o código do projeto de serviço é fornecido como entrada de teste. Caso contrário, verifique se o endereço IP está sendo usado no projeto.
FORWARDING_RULE_MISMATCH Protocolo e portas de regra de encaminhamento não correspondem ao cabeçalho do pacote.
FORWARDING_RULE_NO_INSTANCES A regra de encaminhamento não tem back-ends configurados.
FIREWALL_BLOCKING_LOAD_BALANCER_BACKEND_HEALTH_CHECK Os firewalls bloqueiam os testes de verificação de integridade dos back-end e fazem com que os back-ends não estejam disponíveis para o tráfego do balanceador de carga. Para mais detalhes, consulte Regras de firewall de verificação de integridade.
INGRESS_FIREWALL_TAGS_UNSUPPORTED_BY_DIRECT_VPC_EGRESS Não há suporte a regras de firewall de entrada correspondentes por tags de rede para pacotes enviados pela saída direta da VPC sem servidor. O comportamento é indefinido. https://cloud.google.com/run/docs/configuring/vpc-direct-vpc#limitations
INSTANCE_NOT_RUNNING Pacote enviado de ou para uma instância do Compute Engine que não está em um estado de execução.
GKE_CLUSTER_NOT_RUNNING Pacote enviado de ou para um cluster do GKE que não está em estado de execução.
CLOUD_SQL_INSTANCE_NOT_RUNNING Pacote enviado de ou para uma instância do Cloud SQL que não esteja no estado em execução.
REDIS_INSTANCE_NOT_RUNNING Pacote enviado de ou para uma instância do Redis que não esteja no estado em execução.
REDIS_CLUSTER_NOT_RUNNING Pacote enviado de ou para um cluster do Redis que não está em execução.
TRAFFIC_TYPE_BLOCKED O tipo de tráfego está bloqueado e o usuário não pode configurar uma regra de firewall para habilitá-lo. Consulte Tráfego sempre bloqueado para mais detalhes.
GKE_MASTER_UNAUTHORIZED_ACCESS O acesso ao endpoint do mestre do cluster do Google Kubernetes Engine não é autorizado. Consulte Acesso aos endpoints do cluster para mais detalhes.
CLOUD_SQL_INSTANCE_UNAUTHORIZED_ACCESS O acesso ao endpoint da instância do Cloud SQL não é autorizado. Consulte Como autorizar com redes autorizadas para mais detalhes.
DROPPED_INSIDE_GKE_SERVICE O pacote foi inserido dentro do serviço do Google Kubernetes Engine.
DROPPED_INSIDE_CLOUD_SQL_SERVICE O pacote foi descartado dentro do serviço do Cloud SQL.
GOOGLE_MANAGED_SERVICE_NO_PEERING O pacote foi descartado porque não há peering entre a rede de origem e a rede de serviços gerenciados do Google.
GOOGLE_MANAGED_SERVICE_NO_PSC_ENDPOINT O pacote foi descartado porque o serviço gerenciado pelo Google usa o Private Service Connect (PSC), mas o endpoint do PSC não foi encontrado no projeto.
GKE_PSC_ENDPOINT_MISSING O pacote foi descartado porque o cluster do GKE usa o Private Service Connect (PSC), mas o endpoint do PSC não foi encontrado no projeto.
CLOUD_SQL_INSTANCE_NO_IP_ADDRESS O pacote foi descartado porque a instância do Cloud SQL não tem um endereço IP privado nem público.
GKE_CONTROL_PLANE_REGION_MISMATCH O pacote foi descartado porque um endpoint particular do cluster do GKE está inacessível em uma região diferente daquela do cluster.
PUBLIC_GKE_CONTROL_PLANE_TO_PRIVATE_DESTINATION Pacote enviado de um plano de controle do cluster público do GKE para um endereço IP particular.
GKE_CONTROL_PLANE_NO_ROUTE O pacote foi descartado porque não há rota de um plano de controle do cluster do GKE para uma rede de destino.
CLOUD_SQL_INSTANCE_NOT_CONFIGURED_FOR_EXTERNAL_TRAFFIC Não é permitido enviar pacotes de uma instância do Cloud SQL para um endereço IP externo. A instância do Cloud SQL não está configurada para enviar pacotes a endereços IP externo.
PUBLIC_CLOUD_SQL_INSTANCE_TO_PRIVATE_DESTINATION Pacote enviado de uma instância do Cloud SQL com apenas um endereço IP público para um endereço IP privado.
CLOUD_SQL_INSTANCE_NO_ROUTE O pacote foi descartado porque não há rota de uma instância do Cloud SQL para uma rede de destino.
CLOUD_SQL_CONNECTOR_REQUIRED O pacote foi descartado porque a instância do Cloud SQL exige que todas as conexões usem conectores do Cloud SQL e tenham como destino a porta do proxy do Cloud SQL (3307).
CLOUD_FUNCTION_NOT_ACTIVE O pacote pode ser descartado porque a função do Cloud não está ativa.
VPC_CONNECTOR_NOT_SET O pacote pode ser descartado porque nenhum conector de VPC está definido.
VPC_CONNECTOR_NOT_RUNNING O pacote pode ser descartado porque o conector de VPC não está em estado de execução.
VPC_CONNECTOR_SERVERLESS_TRAFFIC_BLOCKED O pacote pode ser descartado porque o tráfego do serviço sem servidor para o conector de VPC não é permitido.
VPC_CONNECTOR_HEALTH_CHECK_TRAFFIC_BLOCKED O pacote pode ser descartado porque o tráfego de verificação de integridade para o conector de VPC não é permitido.
FORWARDING_RULE_REGION_MISMATCH O pacote pode ter sido descartado porque foi enviado de uma região diferente para um encaminhamento regional sem acesso global.
PSC_CONNECTION_NOT_ACCEPTED O endpoint do Private Service Connect está em um projeto que não está aprovado para se conectar ao serviço.
PSC_ENDPOINT_ACCESSED_FROM_PEERED_NETWORK O pacote é enviado ao endpoint do Private Service Connect pelo peering, mas não há suporte.
PSC_NEG_PRODUCER_ENDPOINT_NO_GLOBAL_ACCESS O pacote é enviado ao back-end do Private Service Connect (grupo de endpoints de rede), mas a regra de encaminhamento do produtor do PSC não tem o acesso global ativado.
PSC_NEG_PRODUCER_FORWARDING_RULE_MULTIPLE_PORTS O pacote é enviado ao back-end do Private Service Connect (grupo de endpoints de rede), mas a regra de encaminhamento do produtor PSC tem várias portas especificadas.
CLOUD_SQL_PSC_NEG_UNSUPPORTED O pacote é enviado ao back-end do Private Service Connect (grupo de endpoints de rede) com destino a um anexo de serviço do Cloud SQL, mas essa configuração não é compatível.
NO_NAT_SUBNETS_FOR_PSC_SERVICE_ATTACHMENT Nenhuma sub-rede NAT foi definida para o anexo de serviço do PSC.
PSC_TRANSITIVITY_NOT_PROPAGATED O endpoint do PSC é acessado via NCC, mas a configuração de transitividade do PSC ainda não foi propagada.
HYBRID_NEG_NON_DYNAMIC_ROUTE_MATCHED O pacote enviado do proxy NEG híbrido corresponde a uma rota não dinâmica, mas essa configuração não é compatível.
HYBRID_NEG_NON_LOCAL_DYNAMIC_ROUTE_MATCHED O pacote enviado do proxy NEG híbrido corresponde a uma rota dinâmica com um próximo salto em uma região diferente, mas essa configuração não é aceita.
CLOUD_RUN_REVISION_NOT_READY Pacote enviado de uma revisão do Cloud Run que não está pronta.
DROPPED_INSIDE_PSC_SERVICE_PRODUCER O pacote foi descartado dentro do produtor de serviços do Private Service Connect.
LOAD_BALANCER_HAS_NO_PROXY_SUBNET Pacote enviado a um balanceador de carga, que exige uma sub-rede somente proxy, mas ela não foi encontrada.
CLOUD_NAT_NO_ADDRESSES Pacote enviado ao Cloud NAT sem IPs NAT ativos.
ROUTING_LOOP O pacote está preso em um loop de roteamento.
DROPPED_INSIDE_GOOGLE_MANAGED_SERVICE O pacote é descartado em um serviço gerenciado pelo Google por ser entregue em um rastreamento de retorno a um endpoint que não corresponde ao endpoint de onde o pacote foi enviado no rastreamento direto. Usado apenas para rastreamentos de retorno.
LOAD_BALANCER_BACKEND_INVALID_NETWORK O pacote é descartado porque uma instância de back-end do balanceador de carga não tem uma interface na rede esperada pelo balanceador de carga.
BACKEND_SERVICE_NAMED_PORT_NOT_DEFINED O pacote é descartado porque uma porta nomeada de serviço de back-end não está definida no nível do grupo de instâncias.
DESTINATION_IS_PRIVATE_NAT_IP_RANGE O pacote é descartado porque um intervalo de IP de destino faz parte de um intervalo de IP do Private NAT.
DROPPED_INSIDE_REDIS_INSTANCE_SERVICE Causa genérica de descarte de um pacote em um projeto de serviço de instância do Redis.
REDIS_INSTANCE_UNSUPPORTED_PORT O pacote é descartado porque uma porta sem suporte está sendo usada para se conectar a uma instância do Redis. A porta 6379 deve ser usada para se conectar a uma instância do Redis.
REDIS_INSTANCE_CONNECTING_FROM_PUPI_ADDRESS O pacote é descartado devido à conexão de um endereço PUPI a uma instância do Redis baseada em PSA.
REDIS_INSTANCE_NO_ROUTE_TO_DESTINATION_NETWORK O pacote é descartado porque não há rota para a rede de destino.
REDIS_INSTANCE_NO_EXTERNAL_IP A instância do Redis não tem um endereço IP externo.
REDIS_INSTANCE_UNSUPPORTED_PROTOCOL O pacote é descartado porque um protocolo sem suporte está sendo usado para se conectar a uma instância do Redis. Apenas conexões TCP são aceitas por uma instância do Redis.
DROPPED_INSIDE_REDIS_CLUSTER_SERVICE Causa genérica de descarte de um pacote em um projeto de serviço do Redis Cluster.
REDIS_CLUSTER_UNSUPPORTED_PORT O pacote é descartado porque uma porta sem suporte está sendo usada para se conectar a um cluster do Redis. As portas 6379 e 11000 a 13047 devem ser usadas para se conectar a um cluster do Redis.
REDIS_CLUSTER_NO_EXTERNAL_IP O Redis Cluster não tem um endereço IP externo.
REDIS_CLUSTER_UNSUPPORTED_PROTOCOL O pacote é descartado porque um protocolo incompatível está sendo usado para se conectar a um cluster do Redis. Apenas conexões TCP são aceitas por um cluster do Redis.
NO_ADVERTISED_ROUTE_TO_GCP_DESTINATION O pacote de uma rede do GCP desconhecida ou que não é do GCP (local) foi descartado porque o endereço IP de destino não pertence a nenhum prefixo de IP anunciado pelo Cloud Router via BGP.
NO_TRAFFIC_SELECTOR_TO_GCP_DESTINATION O pacote de uma rede do GCP desconhecida ou que não é do GCP (local) foi descartado porque o endereço IP de destino não pertence a nenhum prefixo de IP incluído no seletor de tráfego local do túnel da VPN.
NO_KNOWN_ROUTE_FROM_PEERED_NETWORK_TO_DESTINATION O pacote da rede com peering desconhecida foi descartado porque não há uma rota conhecida da rede de origem para o endereço IP de destino.
PRIVATE_NAT_TO_PSC_ENDPOINT_UNSUPPORTED O envio de pacotes processados pelos gateways do Private NAT aos endpoints do Private Service Connect não é aceito.
PSC_PORT_MAPPING_PORT_MISMATCH O pacote é enviado ao serviço de mapeamento de portas do PSC, mas a porta de destino não corresponde a nenhuma regra de mapeamento de portas.
PSC_PORT_MAPPING_WITHOUT_PSC_CONNECTION_UNSUPPORTED Não é possível enviar pacotes diretamente para o serviço de mapeamento de portas do PSC sem passar pela conexão do PSC.
UNSUPPORTED_ROUTE_MATCHED_FOR_NAT64_DESTINATION O pacote com endereço IP de destino no intervalo reservado do NAT64 foi descartado porque corresponde a uma rota de um tipo não compatível.
TRAFFIC_FROM_HYBRID_ENDPOINT_TO_INTERNET_DISALLOWED O pacote pode ser descartado porque o endpoint híbrido, como um gateway VPN ou o Interconnect, não tem permissão para enviar tráfego à Internet.
NO_MATCHING_NAT64_GATEWAY O pacote com endereço IP de destino no intervalo reservado do NAT64 foi descartado porque não há um gateway NAT correspondente na sub-rede.
LOAD_BALANCER_BACKEND_IP_VERSION_MISMATCH O pacote é descartado porque foi enviado a um back-end de um balanceador de carga de passagem que não usa a mesma versão de IP que o front-end.
NO_KNOWN_ROUTE_FROM_NCC_NETWORK_TO_DESTINATION O pacote da rede NCC desconhecida foi descartado porque não há uma rota conhecida da rede de origem para o endereço IP de destino.

LoadBalancerInfo

Apenas para exibição. Metadados associados a um balanceador de carga.

Representação JSON 
{
  "loadBalancerType": enum (LoadBalancerType),
  "healthCheckUri": string,
  "backends": [
    {
      object (LoadBalancerBackend)
    }
  ],
  "backendType": enum (BackendType),
  "backendUri": string
}
Campos
loadBalancerType

enum (LoadBalancerType)

Tipo do balanceador de carga.
healthCheckUri
(deprecated)

string

URI da verificação de integridade do balanceador de carga. Descontinuado e não mais preenchido, já que diferentes back-ends de balanceador de carga podem ter verificações de integridade diferentes.
backends[]

object (LoadBalancerBackend)

Informações para os back-ends do loadbalancer.
backendType

enum (BackendType)

Tipo de configuração de back-end do balanceador de carga.
backendUri

string

URI de configuração de back-end.

LoadBalancerType

A definição de tipo para um balanceador de carga:

Enums
LOAD_BALANCER_TYPE_UNSPECIFIED Tipo não especificado.
INTERNAL_TCP_UDP Balanceador de carga TCP/UDP interno.
NETWORK_TCP_UDP Balanceador de carga de rede TCP/UDP.
HTTP_PROXY Balanceador de carga de proxy HTTP(S).
TCP_PROXY Balanceador de carga de proxy TCP.
SSL_PROXY Balanceador de carga de proxy SSL.

LoadBalancerBackend

Apenas para exibição. Metadados associados a um back-end de balanceador de carga específico.

Representação JSON 
{
  "displayName": string,
  "uri": string,
  "healthCheckFirewallState": enum (HealthCheckFirewallState),
  "healthCheckAllowingFirewallRules": [
    string
  ],
  "healthCheckBlockingFirewallRules": [
    string
  ]
}
Campos
displayName

string

Nome de uma instância ou endpoint da rede do Compute Engine.
uri

string

URI de uma instância do Compute Engine ou endpoint de rede.
healthCheckFirewallState

enum (HealthCheckFirewallState)

Estado da configuração do firewall de verificação de integridade.
healthCheckAllowingFirewallRules[]

string

Uma lista de URIs de regra de firewall que permitem análises de intervalos de IP de verificação de integridade.
healthCheckBlockingFirewallRules[]

string

Uma lista de URIs de regra de firewall que bloqueiam análises dos intervalos de IP de verificação de integridade.

HealthCheckFirewallState

Estado de uma configuração de firewall de verificação de integridade:

Enums
HEALTH_CHECK_FIREWALL_STATE_UNSPECIFIED Estado não especificado. Estado padrão se não for preenchido.
CONFIGURED Há regras de firewall configuradas para permitir análises de verificação de integridade ao back-end.
MISCONFIGURED Há regras de firewall configuradas para permitir intervalos de verificação de integridade parciais ou bloquear todos os intervalos de verificação de integridade. Se uma sondagem de verificação de integridade for enviado de intervalos de IP negados, a verificação de integridade para o back-end falhará. Em seguida, o back-end será marcado como não íntegro e não receberá o tráfego enviado para o balanceador de carga.

BackendType

A definição de tipo para uma configuração de back-end do balanceador de carga:

Enums
BACKEND_TYPE_UNSPECIFIED Tipo não especificado.
BACKEND_SERVICE Serviço de back-end como back-end do balanceador de carga.
TARGET_POOL Pool de destino como back-end do balanceador de carga.
TARGET_INSTANCE Instância de destino como back-end do balanceador de carga.

NetworkInfo

Apenas para exibição. Metadados associados a uma rede do Compute Engine.

Representação JSON 
{
  "displayName": string,
  "uri": string,
  "matchedSubnetUri": string,
  "matchedIpRange": string,
  "region": string
}
Campos
displayName

string

Nome de uma rede do Compute Engine.
uri

string

URI de uma rede do Compute Engine.
matchedSubnetUri

string

URI da sub-rede que corresponde ao endereço IP de origem do teste.
matchedIpRange

string

O intervalo de IPs da sub-rede que corresponde ao endereço IP de origem do teste.
region

string

A região da sub-rede que corresponde ao endereço IP de origem do teste.

GKEMasterInfo

Apenas para exibição. Metadados associados a um mestre do cluster do Google Kubernetes Engine (GKE).

Representação JSON 
{
  "clusterUri": string,
  "clusterNetworkUri": string,
  "internalIp": string,
  "externalIp": string,
  "dnsEndpoint": string
}
Campos
clusterUri

string

URI de um cluster do GKE.
clusterNetworkUri

string

URI de uma rede de cluster do GKE.
internalIp

string

Endereço IP interno de um plano de controle de cluster do GKE.
externalIp

string

Endereço IP externo de um plano de controle de cluster do GKE.
dnsEndpoint

string

Endpoint DNS de um plano de controle de cluster do GKE.

CloudSQLInstanceInfo

Apenas para exibição. Metadados associados a uma instância do Cloud SQL.

Representação JSON 
{
  "displayName": string,
  "uri": string,
  "networkUri": string,
  "internalIp": string,
  "externalIp": string,
  "region": string
}
Campos
displayName

string

Nome de uma instância do Cloud SQL.
uri

string

URI de uma instância do Cloud SQL.
networkUri

string

URI de uma rede de instância do Cloud SQL ou string vazia se a instância não tiver uma.
internalIp

string

Endereço IP interno de uma instância do Cloud SQL.
externalIp

string

Endereço IP externo de uma instância do Cloud SQL.
region

string

Região em que a instância do Cloud SQL está em execução.

RedisInstanceInfo

Apenas para exibição. Metadados associados a uma instância do Cloud Redis.

Representação JSON 
{
  "displayName": string,
  "uri": string,
  "networkUri": string,
  "primaryEndpointIp": string,
  "readEndpointIp": string,
  "region": string
}
Campos
displayName

string

Nome de uma instância do Cloud Redis.
uri

string

URI de uma instância do Cloud Redis.
networkUri

string

URI de uma rede de instância do Cloud Redis.
primaryEndpointIp

string

Endereço IP do endpoint principal de uma instância do Cloud Redis.
readEndpointIp

string

Endereço IP do endpoint de leitura de uma instância do Cloud Redis (se aplicável).
region

string

Região em que a instância do Cloud Redis está definida.

RedisClusterInfo

Apenas para exibição. Metadados associados a um cluster do Redis.

Representação JSON 
{
  "displayName": string,
  "uri": string,
  "networkUri": string,
  "discoveryEndpointIpAddress": string,
  "secondaryEndpointIpAddress": string,
  "location": string
}
Campos
displayName

string

Nome de um cluster do Redis.
uri

string

URI de um cluster do Redis no formato "projects/{projectId}/locations/{location}/clusters/{cluster_id}"
networkUri

string

URI da rede que contém os endpoints do cluster do Redis no formato "projects/{projectId}/global/networks/{network_id}".
discoveryEndpointIpAddress

string

Endereço IP do endpoint de descoberta de um cluster do Redis.
secondaryEndpointIpAddress

string

Endereço IP do endpoint secundário de um cluster do Redis.
location

string

Nome da região em que o cluster do Redis está definido. Por exemplo, "us-central1".

CloudFunctionInfo

Apenas para exibição. Os metadados associados a uma função do Cloud.

Representação JSON 
{
  "displayName": string,
  "uri": string,
  "location": string,
  "versionId": string
}
Campos
displayName

string

Nome de uma função do Cloud.
uri

string

URI de uma função do Cloud.
location

string

Local em que a função do Cloud é implantada.
versionId

string (int64 format)

ID da versão mais recente da função do Cloud Functions implantada com sucesso.

AppEngineVersionInfo

Apenas para exibição. Metadados associados a uma versão do App Engine.

Representação JSON 
{
  "displayName": string,
  "uri": string,
  "runtime": string,
  "environment": string
}
Campos
displayName

string

Nome de uma versão do App Engine.
uri

string

URI de uma versão do App Engine.
runtime

string

Tempo de execução da versão do App Engine.
environment

string

Ambiente de execução do App Engine para uma versão.

CloudRunRevisionInfo

Apenas para exibição. Metadados associados a uma revisão do Cloud Run.

Representação JSON 
{
  "displayName": string,
  "uri": string,
  "location": string,
  "serviceUri": string
}
Campos
displayName

string

Nome de uma revisão do Cloud Run.
uri

string

URI de uma revisão do Cloud Run.
location

string

Local em que esta revisão é implantada.
serviceUri

string

URI do serviço do Cloud Run a que esta revisão pertence.

NatInfo

Apenas para exibição. Metadados associados ao NAT.

Representação 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
}
Campos
type

enum (Type)

Tipo de NAT.
protocol

string

Protocolo IP no formato de sequência, por exemplo: "TCP", "UDP", "ICMP".
networkUri

string

URI da rede em que a conversão de NAT ocorre.
oldSourceIp

string

Endereço IP de origem antes da conversão de NAT.
newSourceIp

string

Endereço IP de origem após a conversão de NAT.
oldDestinationIp

string

Endereço IP de destino antes da tradução NAT.
newDestinationIp

string

Endereço IP de destino após a tradução de NAT.
oldSourcePort

integer

Porta de origem antes da tradução de NAT. Válido apenas quando o protocolo é TCP ou UDP.
newSourcePort

integer

Porta de origem após a tradução de NAT. Válido apenas quando o protocolo é TCP ou UDP.
oldDestinationPort

integer

Porta de destino antes da conversão de NAT. Válido apenas quando o protocolo é TCP ou UDP.
newDestinationPort

integer

Porta de destino após a conversão de NAT. Válido apenas quando o protocolo é TCP ou UDP.
routerUri

string

URI do Cloud Router. Válido apenas quando o tipo é CLOUD_NAT.
natGatewayName

string

O nome do gateway do Cloud NAT. Válido apenas quando o tipo é CLOUD_NAT.

Tipo

Tipos de NAT.

Enums
TYPE_UNSPECIFIED Tipo não especificado.
INTERNAL_TO_EXTERNAL Do endereço interno da instância do Compute Engine para o endereço externo.
EXTERNAL_TO_INTERNAL Do endereço externo da instância do Compute Engine para o endereço interno.
CLOUD_NAT Gateway do Cloud NAT.
PRIVATE_SERVICE_CONNECT NAT do Private Service Connect.

ProxyConnectionInfo

Apenas para exibição. Metadados associados a ProxyConnection.

Representação JSON 
{
  "protocol": string,
  "oldSourceIp": string,
  "newSourceIp": string,
  "oldDestinationIp": string,
  "newDestinationIp": string,
  "oldSourcePort": integer,
  "newSourcePort": integer,
  "oldDestinationPort": integer,
  "newDestinationPort": integer,
  "subnetUri": string,
  "networkUri": string
}
Campos
protocol

string

Protocolo IP no formato de sequência, por exemplo: "TCP", "UDP", "ICMP".
oldSourceIp

string

Endereço IP de origem de uma conexão original.
newSourceIp

string

Endereço IP de origem de uma nova conexão.
oldDestinationIp

string

Endereço IP de destino de uma conexão original
newDestinationIp

string

Endereço IP de destino de uma nova conexão.
oldSourcePort

integer

Porta de origem de uma conexão original. Válido apenas quando o protocolo é TCP ou UDP.
newSourcePort

integer

Porta de origem de uma nova conexão. Válido apenas quando o protocolo é TCP ou UDP.
oldDestinationPort

integer

Porta de destino de uma conexão original. Válido apenas quando o protocolo é TCP ou UDP.
newDestinationPort

integer

Porta de destino de uma nova conexão. Válido apenas quando o protocolo é TCP ou UDP.
subnetUri

string

URI da sub-rede de proxy.
networkUri

string

URI da rede em que a conexão é feita por proxy.

LoadBalancerBackendInfo

Apenas para exibição. Metadados associados ao back-end do balanceador de carga.

Representação JSON 
{
  "name": string,
  "instanceUri": string,
  "backendServiceUri": string,
  "instanceGroupUri": string,
  "networkEndpointGroupUri": string,
  "backendBucketUri": string,
  "pscServiceAttachmentUri": string,
  "pscGoogleApiTarget": string,
  "healthCheckUri": string,
  "healthCheckFirewallsConfigState": enum (HealthCheckFirewallsConfigState)
}
Campos
name

string

Nome de exibição do back-end. Por exemplo, pode ser um nome de instância para os back-ends do grupo de instâncias ou um endereço IP e uma porta para os back-ends do grupo de endpoints de rede zonal.
instanceUri

string

URI da instância de back-end (se aplicável). Preenchido para back-ends de grupos de instâncias e back-ends de NEGs zonais.
backendServiceUri

string

URI do serviço de back-end a que este back-end pertence (se aplicável).
instanceGroupUri

string

URI do grupo de instâncias a que este back-end pertence (se aplicável).
networkEndpointGroupUri

string

URI do grupo de endpoints de rede a que este back-end pertence (se aplicável).
backendBucketUri

string

URI do bucket de back-end que este back-end segmenta (se aplicável).
pscServiceAttachmentUri

string

URI do anexo de serviço do PSC a que esse back-end do NEG do PSC se destina (se aplicável).
pscGoogleApiTarget

string

Destino da API do Google para PSC que este back-end do NEG do PSC segmenta (se aplicável).
healthCheckUri

string

URI da verificação de integridade anexada a este back-end (se aplicável).
healthCheckFirewallsConfigState

enum (HealthCheckFirewallsConfigState)

Apenas saída. Estado da configuração de firewalls de verificação de integridade para o back-end. Isso é resultado da análise estática de firewall, que verifica se o tráfego de verificação de integridade dos intervalos de IP necessários para o back-end é permitido ou não. O back-end ainda pode estar em estado ruim mesmo que esses firewalls estejam configurados. Consulte a documentação para mais informações: https://cloud.google.com/load-balancing/docs/firewall-rules

HealthCheckFirewallsConfigState

Enumeração do estado de configuração dos firewalls de verificação de integridade.

Enums
HEALTH_CHECK_FIREWALLS_CONFIG_STATE_UNSPECIFIED Estado da configuração não especificado. Normalmente, isso significa que o back-end não tem uma verificação de integridade anexada ou que houve um erro de configuração inesperado que impediu que os Testes de conectividade verificassem a configuração da verificação de integridade.
FIREWALLS_CONFIGURED As regras (políticas) de firewall que permitem o tráfego de verificação de integridade de todos os intervalos de IP necessários para o back-end estão configuradas.
FIREWALLS_PARTIALLY_CONFIGURED As regras (políticas) de firewall permitem o tráfego de verificação de integridade apenas de uma parte dos intervalos de IP necessários.
FIREWALLS_NOT_CONFIGURED As regras (políticas) de firewall negam o tráfego de verificação de integridade de todos os intervalos de IP necessários para o back-end.
FIREWALLS_UNSUPPORTED A rede contém regras de firewall de tipos não compatíveis. Por isso, os testes de conectividade não puderam verificar o status da configuração de verificação de integridade. Consulte a documentação para conferir a lista de configurações não compatíveis: https://cloud.google.com/network-intelligence-center/docs/connectivity-tests/concepts/overview#unsupported-configs

StorageBucketInfo

Apenas para exibição. Metadados associados ao bucket de armazenamento.

Representação JSON 
{
  "bucket": string
}
Campos
bucket

string

Nome do bucket do Cloud Storage.

ServerlessNegInfo

Apenas para exibição. Metadados associados ao back-end do grupo de endpoints de rede sem servidor.

Representação JSON 
{
  "negUri": string
}
Campos
negUri

string

URI do grupo de endpoints de rede sem servidor.

ProbingDetails

Resultados da sondagem ativa da última execução do teste.

Representação 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
}
Campos
result

enum (ProbingResult)

O resultado geral da sondagem ativa.
verifyTime

string (Timestamp format)

O momento em que a acessibilidade foi avaliada por sondagem ativa.

Usa RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Outros ajustes também são aceitos. Por exemplo, "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30";
error

object (Status)

Detalhes sobre uma falha interna ou o cancelamento da sondagem ativa.
abortCause

enum (ProbingAbortCause)

O motivo da interrupção da sondagem.
sentProbeCount

integer

Número de sondagens enviadas.
successfulProbeCount

integer

Número de sondagens que chegaram ao destino.
endpointInfo

object (EndpointInfo)

Os endpoints de origem e destino derivados da entrada de teste e usados para sondagem ativa.
probingLatency

object (LatencyDistribution)

Latência medida por sondagem ativa em uma direção: do endpoint de origem ao de destino.
destinationEgressLocation

object (EdgeLocation)

O EdgeLocation de onde um pacote, destinado à Internet, vai sair da rede do Google. Só será preenchido para um teste de conectividade que tenha um endereço de destino da Internet. A ausência desse campo não pode ser usada como indicação de que o destino faz parte da rede do Google.
edgeResponses[]

object (SingleEdgeResponse)

Resultados da sondagem para todos os dispositivos de borda.
probedAllDevices

boolean

Se todos os dispositivos de borda relevantes foram sondados.

ProbingResult

Resultado geral da sondagem do teste.

Enums
PROBING_RESULT_UNSPECIFIED Nenhum resultado foi especificado.
REACHABLE Pelo menos 95% dos pacotes chegaram ao destino.
UNREACHABLE Nenhum pacote chegou ao destino.
REACHABILITY_INCONSISTENT Menos de 95% dos pacotes chegaram ao destino.
UNDETERMINED A acessibilidade não pôde ser determinada. Os possíveis motivos são: * O usuário não tem permissão para acessar alguns dos recursos de rede necessários para executar o teste. * Não foi possível derivar um endpoint de origem válido da solicitação. * Ocorreu um erro interno.

ProbingAbortCause

Tipos de causa da interrupção.

Enums
PROBING_ABORT_CAUSE_UNSPECIFIED Nenhum motivo foi especificado.
PERMISSION_DENIED O usuário não tem permissão para acessar alguns dos recursos de rede necessários para executar o teste.
NO_SOURCE_LOCATION Não foi possível derivar um endpoint de origem válido da solicitação.

LatencyDistribution

Descreve a distribuição de latência medida.

Representação JSON 
{
  "latencyPercentiles": [
    {
      object (LatencyPercentile)
    }
  ]
}
Campos
latencyPercentiles[]

object (LatencyPercentile)

Percentis de latência representativos.

LatencyPercentile

Classificação e valor do percentil de latência.

Representação JSON 
{
  "percent": integer,
  "latencyMicros": string
}
Campos
percent

integer

Porcentagem de amostras a que esse ponto de dados se aplica.
latencyMicros

string (int64 format)

Percentil da latência observada, em microssegundos. Fração de porcentagem/100 de amostras com latência menor ou igual ao valor deste campo.

EdgeLocation

Representação de um local de borda de rede, conforme https://cloud.google.com/vpc/docs/edge-locations.

Representação JSON 
{
  "metropolitanArea": string
}
Campos
metropolitanArea

string

Nome da área metropolitana.

SingleEdgeResponse

Resultados de sondagem para um único dispositivo de borda.

Representação JSON 
{
  "result": enum (ProbingResult),
  "sentProbeCount": integer,
  "successfulProbeCount": integer,
  "probingLatency": {
    object (LatencyDistribution)
  },
  "destinationEgressLocation": {
    object (EdgeLocation)
  },
  "destinationRouter": string
}
Campos
result

enum (ProbingResult)

O resultado geral da sondagem ativa para este dispositivo de saída.
sentProbeCount

integer

Número de sondagens enviadas.
successfulProbeCount

integer

Número de sondagens que chegaram ao destino.
probingLatency

object (LatencyDistribution)

Latência medida por sondagem ativa em uma direção: do endpoint de origem ao de destino.
destinationEgressLocation

object (EdgeLocation)

O EdgeLocation de onde um pacote, destinado à Internet, vai sair da rede do Google. Só será preenchido para um teste de conectividade que tenha um endereço de destino da Internet. A ausência desse campo não pode ser usada como indicação de que o destino faz parte da rede do Google.
destinationRouter

string

Nome do roteador no formato "{router}.{metroshard}". Por exemplo: pf01.aaa01, pr02.aaa01.

Métodos

create

 Cria um novo Connectivity Test.

delete

 Exclui um ConnectivityTest específico.

get

 Consegue os detalhes de um Connectivity Test específico.

getIamPolicy

 Busca a política de controle de acesso de um recurso.

list

 Lista todos os Connectivity Tests pertencentes a um projeto.

patch

 Atualiza a configuração de um ConnectivityTest atual.

rerun

 Execute novamente um ConnectivityTest atual.

setIamPolicy

 Define a política de controle de acesso no recurso especificado.

testIamPermissions

 Retorna permissões do autor da chamada no recurso especificado.