REST Resource: projects.locations.global.connectivityTests

Recurso: ConnectivityTest

Um teste de conetividade 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 único do recurso que usa o formulário: projects/{projectId}/locations/global/connectivityTests/{test}

description

string

A descrição do teste de conetividade fornecida pelo utilizador. Um máximo de 512 carateres.

source

object (Endpoint)

Obrigatório. Especificação da origem do teste de conetividade.

Pode usar uma combinação do endereço IP de origem, do URI de um ponto final suportado, do ID do projeto ou da rede VPC para identificar a localização de origem.

A análise de acessibilidade pode prosseguir mesmo que a localização de origem seja ambígua. No entanto, o resultado do teste pode incluir pontos finais ou usar uma origem que não pretende testar.

destination

object (Endpoint)

Obrigatório. Especificação do destino do teste de conetividade.

Pode usar uma combinação do endereço IP de destino, do URI de um ponto final suportado, do ID do projeto ou da rede VPC para identificar a localização de destino.

A análise de acessibilidade prossegue mesmo que a localização de destino seja ambígua. No entanto, o resultado do teste pode incluir pontos finais ou usar um destino que não pretende testar.

protocol

string

Protocolo IP do teste. Quando não é indicado, é assumido "TCP".

relatedProjects[]

string

Outros projetos que podem ser relevantes para a análise de acessibilidade. Isto aplica-se a cenários em que um teste pode ultrapassar os limites do projeto.

displayName

string

Apenas saída. O nome a apresentar de um teste de conetividade.

labels

map (key: string, value: string)

Etiquetas de recursos para representar metadados fornecidos pelos utilizadores.

Um objeto que contém 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 o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "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 o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "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 da execução mais recente. Os detalhes são atualizados quando cria um novo teste, atualiza um teste existente ou aciona uma nova execução única de um teste existente.

probingDetails

object (ProbingDetails)

Apenas saída. Os detalhes da sondagem deste teste da execução mais recente, presentes apenas para testes aplicáveis. Os detalhes são atualizados quando cria um novo teste, atualiza um teste existente ou aciona uma nova execução única de um teste existente.

roundTrip

boolean

Se deve executar a análise para o caminho de retorno do destino para a origem. O valor predefinido é False.

returnReachabilityDetails

object (ReachabilityDetails)

Apenas saída. Os detalhes de acessibilidade deste teste da execução mais recente para o caminho de retorno. Os detalhes são atualizados quando cria um novo teste, atualiza um teste existente ou aciona uma nova execução única de um teste existente.

bypassFirewallChecks

boolean

Se a análise deve ignorar a verificação da firewall. O valor predefinido é False.

Ponto final

Origem ou destino do teste de conetividade.

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 ponto final, que pode ser um IP externo ou interno.

port

integer

A porta do protocolo IP do ponto final. 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 respetivo endereço IP 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 o encaminhamento de protocolos, o Private Service Connect e outros serviços de rede para fornecer informações de encaminhamento no plano de controlo. Aplicável apenas ao ponto final 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 controlo do cluster do Google Kubernetes Engine.

fqdn

string

Ponto final de DNS do plano de controlo do cluster do Google Kubernetes Engine. Requer a definição de gkeMasterCluster. Não pode ser usado em simultâneo com ipAddress ou network. Aplicável apenas ao ponto final de destino.

cloudSqlInstance

string

Um URI de instância do Cloud SQL.

redisInstance

string

Um URI de instância de Redis. Aplicável apenas ao ponto final de destino.

redisCluster

string

Um URI do Redis Cluster. Aplicável apenas ao ponto final de destino.

alloyDbInstance

string

Um URI da instância do AlloyDB.

cloudFunction

object (CloudFunctionEndpoint)

Uma função do Cloud. Aplicável apenas ao ponto final de origem.

appEngineVersion

object (AppEngineVersionEndpoint)

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

cloudRunRevision

object (CloudRunRevisionEndpoint)

Uma revisão do Cloud Run. Aplicável apenas ao ponto final de origem.

network

string

Um URI de rede VPC.

networkType

enum (NetworkType)

Tipo de rede onde o ponto final está localizado. Aplicável apenas ao ponto final de origem, uma vez que o tipo de rede de destino pode ser inferido a partir da origem.

projectId

string

ID do projeto onde o ponto final está localizado. O ID do projeto pode ser derivado do URI se fornecer um URI de ponto final ou de rede. Seguem-se dois casos em que pode ter de indicar o ID do projeto: 1. Apenas o endereço IP é especificado e o endereço IP está num projeto do Google Cloud. 2. Quando está a usar a VPC partilhada e o endereço IP que fornece é do projeto de serviço. Neste caso, a rede na qual o endereço IP reside é definida no projeto anfitrião.

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 para o qual a regra de encaminhamento aponta. Vazio para regras de encaminhamento não relacionadas com balanceadores de carga.

loadBalancerType

enum (LoadBalancerType)

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

ForwardingRuleTarget

Tipo de destino de uma regra de encaminhamento.

Enumerações
FORWARDING_RULE_TARGET_UNSPECIFIED O destino da regra de encaminhamento é desconhecido.
INSTANCE Instância do Compute Engine para encaminhamento de protocolos.
LOAD_BALANCER Balanceador de carga. Pode encontrar o tipo específico em loadBalancerType.
VPN_GATEWAY Gateway do Cloud VPN clássico.
PSC A regra de encaminhamento é um ponto final do Private Service Connect.

LoadBalancerType

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

Enumerações
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 de 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 conjunto de destino.
TCP_UDP_INTERNAL_LOAD_BALANCER Balanceador de carga TCP/UDP interno.

CloudFunctionEndpoint

Wrapper para atributos da 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 do 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 ao qual a revisão pertence. O formato é: projects/{project}/locations/{location}/services/{service}

NetworkType

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

Enumerações
NETWORK_TYPE_UNSPECIFIED Tipo predefinido se não for especificado.
GCP_NETWORK Uma rede alojada no Google Cloud. Para receber resultados mais detalhados, especifique o URI da rede de origem ou de destino.
NON_GCP_NETWORK Uma rede alojada fora do Google Cloud. Pode ser uma rede nas instalações, um recurso da Internet ou uma rede alojada por outro fornecedor de nuvem.

ReachabilityDetails

Resultados da análise da 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 da configuração do teste.

verifyTime

string (Timestamp format)

A hora da análise da configuração.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "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 falha ou de um cancelamento da análise de acessibilidade.

traces[]

object (Trace)

O resultado pode conter uma lista de rastreios se um teste tiver vários caminhos possíveis na rede, como quando o ponto final de destino é um equilibrador de carga com vários backends.

Resultado

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

Enumerações
RESULT_UNSPECIFIED Não foi especificado nenhum resultado.
REACHABLE

Os cenários possíveis são:

  • A análise da configuração determinou que se espera que um pacote originário da origem chegue ao destino.
  • A análise não foi concluída porque o utilizador não tem autorização para alguns dos recursos no rastreio. No entanto, no momento em que a autorização do utilizador se tornou insuficiente, o rastreio tinha sido bem-sucedido até então.
UNREACHABLE Espera-se que um pacote originário da origem seja rejeitado antes de chegar ao destino.
AMBIGUOUS Os pontos finais de origem e destino não identificam exclusivamente a localização do teste na rede, e o resultado da acessibilidade contém vários rastreios. Para alguns rastreios, um pacote podia ser entregue e, para outros, não. Este resultado também é atribuído à análise de configuração do caminho de retorno se, por si só, dever ser ACESSÍVEL, mas a análise de configuração do caminho para a frente for AMBIGUOUS.
UNDETERMINED

A análise da configuração não foi concluída. Os motivos possíveis são:

  • Ocorreu um erro de autorizações. Por exemplo, o utilizador pode não ter autorização de leitura para todos os recursos mencionados no teste.
  • Ocorreu um erro interno.
  • O analisador recebeu um argumento inválido ou não suportado, ou não conseguiu identificar um ponto final conhecido.

Trace

O rastreio representa um caminho de encaminhamento de pacotes simulado.

  • Cada rastreio contém vários passos ordenados.
  • Cada passo está num estado específico com a configuração associada.
  • O estado é categorizado como estados finais ou não finais.
  • Cada estado final tem um motivo associado.
  • Cada rastreio tem de terminar com um estado final (o último passo).
  |---------------------Trace----------------------|
  Step1(State) Step2(State) ---  StepN(State(final))
Representação JSON
{
  "endpointInfo": {
    object (EndpointInfo)
  },
  "steps": [
    {
      object (Step)
    }
  ],
  "forwardTraceId": integer
}
Campos
endpointInfo

object (EndpointInfo)

Derivados da definição dos pontos finais de origem e destino especificada pelo pedido do utilizador e validados pelo modelo do plano de dados. Se existirem vários rastreios a começar em localizações de origem diferentes, o endpointInfo pode ser diferente entre os rastreios.

steps[]

object (Step)

Um rastreio de um teste contém vários passos desde o estado inicial até ao estado final (entregue, rejeitado, encaminhado ou anulado).

Os passos estão ordenados pela sequência de processamento na máquina de estados da rede simulada. É fundamental preservar a ordem dos passos e evitar reordená-los ou ordená-los.

forwardTraceId

integer

ID do rastreio. Para rastreios de encaminhamento, este ID é exclusivo de cada rastreio. Para rastreios de devolução, corresponde ao ID do rastreio de encaminhamento associado. Uma única rastreabilidade de encaminhamento pode estar associada a nenhuma, uma ou mais do que uma rastreabilidade de retorno.

EndpointInfo

Apenas para apresentação. A especificação dos pontos finais para o teste. EndpointInfo é derivado do ponto final de origem e de 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 string, por exemplo: "TCP", "UDP", "ICMP".

sourcePort

integer

Porta de origem. Só é válido quando o protocolo é TCP ou UDP.

destinationPort

integer

Porta de destino. Só é válido quando o protocolo é TCP ou UDP.

sourceNetworkUri

string

URI da rede de origem deste pacote.

destinationNetworkUri

string

URI da rede para a qual este pacote é enviado.

sourceAgentUri

string

URI do agente de telemetria de origem a partir do qual este pacote tem origem.

Passo

Um caminho de encaminhamento simulado é composto por vários passos. Cada passo 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 do passo. Normalmente, trata-se de um resumo do estado.

state

enum (State)

Cada passo está num dos estados predefinidos.

causesDrop

boolean

Este é um passo que leva ao estado final Drop.

projectId

string

ID do projeto que contém a configuração que este passo está a validar.

Campo de união step_info. Configuração ou metadados associados a cada passo. A configuração é filtrada com base na autorização do visitante. Se um visitante não tiver autorização para ver a configuração neste passo, é preenchido um estado especial para estados não finais (VIEWER_PERMISSION_MISSING) e, para o estado final, a configuração é limpa. step_info só pode ser uma das seguintes opções:
instance

object (InstanceInfo)

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

firewall

object (FirewallInfo)

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

route

object (RouteInfo)

Apresente informações de um trajeto do Compute Engine.

endpoint

object (EndpointInfo)

Apresentar informações da origem e do destino em análise. As informações do ponto final num estado intermédio podem diferir da entrada inicial, uma vez que podem ser modificadas por um estado como NAT ou proxy de ligação.

googleService

object (GoogleServiceInfo)

Apresente informações de um serviço Google

forwardingRule

object (ForwardingRuleInfo)

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

vpnGateway

object (VpnGatewayInfo)

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

vpnTunnel

object (VpnTunnelInfo)

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

vpcConnector

object (VpcConnectorInfo)

Apresentar informações de um conetor de VPC.

directVpcEgressConnection

object (DirectVpcEgressConnectionInfo)

Apresentar informações de uma ligação de saída direta da VPC sem servidor.

serverlessExternalConnection

object (ServerlessExternalConnectionInfo)

Apresentar informações de uma ligação pública (externa) sem servidor.

deliver

object (DeliverInfo)

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

forward

object (ForwardInfo)

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

abort

object (AbortInfo)

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

drop

object (DropInfo)

Apresentar informações sobre o "abandono" final e o motivo.

loadBalancer
(deprecated)

object (LoadBalancerInfo)

Apresentar informações dos balanceadores de carga. Obsoleto a favor do campo loadBalancerBackendInfo, não usado em novos testes.

network

object (NetworkInfo)

Apresentar informações de uma rede do Google Cloud.

gkeMaster

object (GKEMasterInfo)

Apresente informações de um master do cluster do Google Kubernetes Engine.

cloudSqlInstance

object (CloudSQLInstanceInfo)

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

redisInstance

object (RedisInstanceInfo)

Apresentar informações de uma instância de Redis.

redisCluster

object (RedisClusterInfo)

Apresentar informações de um Redis Cluster.

cloudFunction

object (CloudFunctionInfo)

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

appEngineVersion

object (AppEngineVersionInfo)

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

cloudRunRevision

object (CloudRunRevisionInfo)

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

nat

object (NatInfo)

Apresentar informações de um NAT.

proxyConnection

object (ProxyConnectionInfo)

Apresentar informações de uma ProxyConnection.

loadBalancerBackendInfo

object (LoadBalancerBackendInfo)

Apresente informações de um back-end do balanceador de carga específico.

storageBucket

object (StorageBucketInfo)

Apresentar informações de um contentor de armazenamento. Usado apenas para rastreios de retorno.

serverlessNeg

object (ServerlessNegInfo)

Apresente informações de um back-end do grupo de pontos finais de rede sem servidor. Usado apenas para rastreios de retorno.

Estado

Tipo de estados definidos na máquina de estados da rede. Cada passo no rastreio de pacotes está num estado específico.

Enumerações
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 de início.
START_FROM_INTERNET Estado inicial: pacote originário da Internet. As informações do ponto final são preenchidas.
START_FROM_GOOGLE_SERVICE Estado inicial: pacote originário de um serviço Google. As informações de googleService são preenchidas.
START_FROM_PRIVATE_NETWORK Estado inicial: pacote originário de uma VPC ou de uma rede no local com IP de origem interno. Se a origem for uma rede VPC visível para o utilizador, um NetworkInfo é 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 de início.
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 de início.
START_FROM_REDIS_INSTANCE Estado inicial: pacote originado de uma instância do Redis. Um RedisInstanceInfo é preenchido com informações da instância de início.
START_FROM_REDIS_CLUSTER Estado inicial: pacote originário de um Redis Cluster. Um RedisClusterInfo é preenchido com informações do cluster de início.
START_FROM_CLOUD_FUNCTION Estado inicial: pacote originado numa Cloud Function. 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 de revisão de início.
START_FROM_STORAGE_BUCKET Estado inicial: pacote originário de um contentor de armazenamento. Usado apenas para rastreios 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 rastreios de retorno.
START_FROM_SERVERLESS_NEG Estado inicial: pacote originado de um back-end do grupo de pontos finais de rede sem servidor. Usado apenas para rastreios de retorno. As informações serverlessNeg estão preenchidas.
APPLY_INGRESS_FIREWALL_RULE Estado da verificação da configuração: verifique a regra da firewall de entrada.
APPLY_EGRESS_FIREWALL_RULE Estado da verificação da configuração: verifique a regra da firewall de saída.
APPLY_ROUTE Estado da verificação da configuração: verifique a rota.
APPLY_FORWARDING_RULE Estado da verificação da configuração: regra de encaminhamento correspondente.
ANALYZE_LOAD_BALANCER_BACKEND Estado da verificação da configuração: verifique a configuração do back-end do balanceador de carga.
SPOOFING_APPROVED Estado da verificação da configuração: pacote enviado ou recebido ao abrigo de um endereço IP estrangeiro e permitido.
ARRIVE_AT_INSTANCE Estado de encaminhamento: a chegar a uma instância do Compute Engine.
ARRIVE_AT_INTERNAL_LOAD_BALANCER

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

ARRIVE_AT_EXTERNAL_LOAD_BALANCER

Estado de encaminhamento: a chegar a um balanceador de carga externo do Compute Engine. Obsoleto a favor do estado ANALYZE_LOAD_BALANCER_BACKEND, não usado em novos testes.

ARRIVE_AT_VPN_GATEWAY Estado de encaminhamento: a chegar a um gateway do Cloud VPN.
ARRIVE_AT_VPN_TUNNEL Estado de encaminhamento: a chegar a um túnel do Cloud VPN.
ARRIVE_AT_VPC_CONNECTOR Estado do encaminhamento: a chegar a um conetor de VPC.
DIRECT_VPC_EGRESS_CONNECTION Estado de encaminhamento: para pacotes originários de um ponto final sem servidor encaminhados através da saída da VPC direta.
SERVERLESS_EXTERNAL_CONNECTION Estado do encaminhamento: para pacotes originários de um ponto final sem servidor encaminhados através da conetividade pública (externa).
NAT Estado de transição: cabeçalho do pacote traduzido.
PROXY_CONNECTION Estado de transição: a ligação original é terminada e é iniciada uma nova ligação com proxy.
DELIVER Estado final: o pacote pode ser entregue.
DROP Estado final: o pacote pode ter sido rejeitado.
FORWARD Estado final: o pacote pode ser encaminhado para uma rede com uma configuração desconhecida.
ABORT Estado final: a análise é anulada.
VIEWER_PERMISSION_MISSING Estado especial: o visitante do resultado do teste não tem autorização para ver a configuração neste passo.

InstanceInfo

Apenas para apresentaçã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

Etiquetas de rede configuradas na instância.

serviceAccount
(deprecated)

string

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

pscNetworkAttachmentUri

string

URI da associação de rede do PSC à qual a NIC está associada (se relevante).

running
(deprecated)

boolean

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

status

enum (Status)

O estado da instância.

Estado

O estado da instância. Consideramos que todos os estados que não sejam "EM EXECUÇÃO" não estão em execução.

Enumerações
STATUS_UNSPECIFIED Valor não especificado predefinido.
RUNNING A instância está em execução.
NOT_RUNNING A instância tem qualquer estado que não seja "RUNNING".

FirewallInfo

Apenas para apresentação. Metadados associados a uma regra de firewall da VPC, a uma regra de firewall da VPC implícita ou a 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 a apresentar da regra de firewall. Este campo pode estar vazio para regras de políticas de firewall.

uri

string

O URI da regra de firewall. Este campo não é aplicável a regras de firewall de VPC implícitas.

direction

string

Valores possíveis: INGRESS, EGRESS

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 à qual a regra de firewall está associada. Este campo não é aplicável a regras de políticas de firewall hierárquicas.

targetTags[]

string

As etiquetas de destino definidas pela regra de firewall da VPC. Este campo não é aplicável a regras de políticas 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 à qual esta regra está associada. Este campo não é aplicável a regras de firewall da VPC nem a regras de firewall da VPC implícitas.

policyUri

string

O URI da política de firewall à qual esta regra está associada. Este campo não é aplicável a regras de firewall da VPC nem a regras de firewall da VPC implícitas.

firewallRuleType

enum (FirewallRuleType)

O tipo da regra de firewall.

policyPriority

integer

A prioridade da política de firewall à qual esta regra está associada. Este campo não é aplicável a regras de firewall da VPC nem a regras de firewall da VPC implícitas.

FirewallRuleType

O tipo da regra de firewall.

Enumerações
FIREWALL_RULE_TYPE_UNSPECIFIED Tipo não especificado.
HIERARCHICAL_FIREWALL_POLICY_RULE Regra de política de firewall hierárquica. Para obter detalhes, consulte o artigo Vista geral das políticas de firewall hierárquicas.
VPC_FIREWALL_RULE Regra de firewall da VPC. Para ver detalhes, consulte o artigo Vista geral das regras de firewall da VPC.
IMPLIED_VPC_FIREWALL_RULE Regra de firewall da VPC implícita. Para ver detalhes, consulte o artigo Regras implícitas.
SERVERLESS_VPC_ACCESS_MANAGED_FIREWALL_RULE Regras de firewall implícitas geridas pelo acesso a VPC sem servidor para permitir o acesso de entrada. Não são visíveis na Google Cloud Console. Para mais detalhes, consulte as regras implícitas do conetor de VPC.
NETWORK_FIREWALL_POLICY_RULE Regra de política de firewall de rede global. Para obter detalhes, consulte o artigo Políticas de firewall de rede.
NETWORK_REGIONAL_FIREWALL_POLICY_RULE Regra de política de firewall de rede regional. Para obter detalhes, consulte o artigo Políticas de firewall de rede regionais.
UNSUPPORTED_FIREWALL_POLICY_RULE Regra de política de firewall que contém atributos ainda não suportados nos testes de conectividade. A análise da firewall é ignorada se for possível encontrar uma correspondência para essa regra. Consulte a lista de configurações não suportadas.
TRACKING_STATE Estado de acompanhamento do tráfego de resposta criado quando o tráfego de pedidos passa pela regra de firewall de permissão. Para ver detalhes, consulte as especificações das regras de firewall
ANALYSIS_SKIPPED A análise da firewall foi ignorada devido à execução do teste de conetividade no modo BypassFirewallChecks

RouteInfo

Apenas para apresentaçã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 trajeto.

nextHopType

enum (NextHopType)

Tipo de salto seguinte.

routeScope
(deprecated)

enum (RouteScope)

Indica onde a rota é aplicável. Descontinuado: as rotas com o âmbito NCC_HUB não estão incluídas no rastreio em novos testes.

displayName

string

Nome de um trajeto.

uri

string

URI de um trajeto. Apenas rotas SUBNET, STATIC, PEERING_SUBNET (apenas para rede de peering) e POLICY_BASED.

region

string

Região do trajeto. Apenas rotas DYNAMIC, PEERING_DYNAMIC, POLICY_BASED e ADVERTISED. Se estiver definido para o encaminhamento POLICY_BASED, esta é uma região de associações de VLAN para o Cloud Interconnect ao qual o encaminhamento 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 de VPN"). Descontinuado a favor dos campos nextHopType e nextHopUri, não usado em novos testes.

networkUri

string

URI de uma rede de VPC onde o trajeto está localizado.

priority

integer

Prioridade do trajeto.

instanceTags[]

string

Etiquetas de instâncias do trajeto.

srcIpRange

string

Intervalo de endereços IP de origem da rota. Apenas rotas POLICY_BASED.

destPortRanges[]

string

Intervalos de portas de destino da rota. Apenas rotas POLICY_BASED.

srcPortRanges[]

string

Intervalos de portas de origem do trajeto. Apenas rotas POLICY_BASED.

protocols[]

string

Protocolos do trajeto. Apenas rotas POLICY_BASED.

nextHopUri

string

URI do recurso de salto seguinte.

nextHopNetworkUri

string

URI de uma rede VPC onde se encontra o recurso de próximo salto.

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 da NCC, o URI da rota correspondente na tabela de encaminhamento do hub da NCC.

nccHubUri

string

URI do hub do NCC através do qual a rota é anunciada. Rotas PEERING_SUBNET e PEERING_DYNAMIC anunciadas apenas pelo hub da NCC.

nccSpokeUri

string

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

advertisedRouteSourceRouterUri

string

Para rotas dinâmicas ANUNCIADAS, o URI do Cloud Router que anunciou o prefixo IP correspondente.

advertisedRouteNextHopUri
(deprecated)

string

Para rotas ADVERTISED, o URI do respetivo salto seguinte, ou seja, o URI do ponto final híbrido (túnel de VPN, anexo do Interconnect, dispositivo de router da NCC) através do qual o prefixo anunciado é anunciado, ou o URI da rede de peering de origem. Descontinuado a favor do campo nextHopUri, não usado em novos testes.

RouteType

Tipo de trajeto:

Enumerações
ROUTE_TYPE_UNSPECIFIED Tipo não especificado. Valor predefinido.
SUBNET Route é uma rota de sub-rede criada automaticamente pelo sistema.
STATIC Rota estática criada pelo utilizador, incluindo a rota predefinida para a Internet.
DYNAMIC Rota dinâmica trocada entre pares BGP.
PEERING_SUBNET Uma rota de sub-rede recebida da rede de peering ou do hub da NCC.
PEERING_STATIC Uma rota estática recebida da rede de peering.
PEERING_DYNAMIC Uma rota dinâmica recebida da rede de peering ou do hub do NCC.
POLICY_BASED Rota baseada em políticas.
ADVERTISED Trajeto anunciado. Rota sintética usada para a transição do estado StartFromPrivateNetwork nos testes de conetividade.

NextHopType

Tipo de salto seguinte:

Enumerações
NEXT_HOP_TYPE_UNSPECIFIED Tipo não especificado. Valor predefinido.
NEXT_HOP_IP O salto seguinte é um endereço IP.
NEXT_HOP_INSTANCE O salto seguinte é uma instância do Compute Engine.
NEXT_HOP_NETWORK O próximo salto é um gateway de rede da VPC.
NEXT_HOP_PEERING O salto seguinte é uma VPC de intercâmbio. Este cenário só acontece quando o utilizador não tem autorizações para o projeto onde se encontra o recurso de salto seguinte.
NEXT_HOP_INTERCONNECT O salto seguinte é uma interligação.
NEXT_HOP_VPN_TUNNEL O próximo salto é um túnel de VPN.
NEXT_HOP_VPN_GATEWAY O salto seguinte é um gateway de VPN. Este cenário só ocorre quando a conetividade é rastreada de uma rede no local para o Google Cloud através de uma VPN. A análise simula um pacote que sai da rede no local através de um túnel VPN e chega a um gateway de VPN na nuvem.
NEXT_HOP_INTERNET_GATEWAY O salto seguinte é um gateway de Internet.
NEXT_HOP_BLACKHOLE O salto seguinte é um buraco negro, ou seja, o salto seguinte não existe ou não é utilizável.
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 de encaminhamento.
NEXT_HOP_NCC_HUB O salto seguinte é um hub do NCC. Este cenário só acontece quando o utilizador não tem autorizações para o projeto onde se encontra o recurso de salto seguinte.
SECURE_WEB_PROXY_GATEWAY O próximo salto é o gateway do proxy Web seguro.

RouteScope

Indica onde os trajetos são aplicáveis.

Enumerações
ROUTE_SCOPE_UNSPECIFIED Âmbito não especificado. Valor predefinido.
NETWORK A rota é aplicável a pacotes na rede.
NCC_HUB A rota é aplicável a pacotes que usam a tabela de encaminhamento do NCC Hub.

GoogleServiceInfo

Apenas para apresentação. Detalhes de um serviço Google que envia pacotes para uma rede VPC. Embora o IP de origem possa ser um endereço encaminhável publicamente, alguns serviços Google usam rotas especiais na infraestrutura de produção da 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 Google.

GoogleServiceType

Tipo reconhecido de um serviço Google.

Enumerações
GOOGLE_SERVICE_TYPE_UNSPECIFIED Serviço Google não especificado.
IAP Proxy com reconhecimento de identidade. https://cloud.google.com/iap/docs/using-tcp-forwarding
GFE_PROXY_OR_HEALTH_CHECK_PROBER Um de dois serviços que partilham intervalos de IP: * Proxy do balanceador de carga * Testador de verificação de funcionamento centralizado https://cloud.google.com/load-balancing/docs/firewall-rules
CLOUD_DNS Conetividade do Cloud DNS para alvos de encaminhamento ou servidores de nomes alternativos que usam o encaminhamento privado. 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 Google através do Private Service Connect. https://cloud.google.com/vpc/docs/configure-private-service-connect-apis
GOOGLE_API_VPC_SC API Google através dos Controlos de serviços de VPC. https://cloud.google.com/vpc/docs/configure-private-service-connect-apis
SERVERLESS_VPC_ACCESS API Google através do acesso VPC sem servidor. https://cloud.google.com/vpc/docs/serverless-vpc-access

ForwardingRuleInfo

Apenas para apresentaçã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 de rede.

region

string

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

loadBalancerName

string

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

pscServiceAttachmentUri

string

URI da associação de serviço do PSC que esta regra de encaminhamento segmenta (se aplicável).

pscGoogleApiTarget

string

O PSC Google API segmenta esta regra de encaminhamento (se aplicável).

VpnGatewayInfo

Apenas para apresentaçã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 de VPN.

uri

string

URI de um gateway de VPN.

networkUri

string

URI de uma rede do Compute Engine onde o gateway de VPN está configurado.

ipAddress

string

Endereço IP do gateway de VPN.

vpnTunnelUri

string

Um túnel de VPN associado a este gateway de VPN. Podem existir vários túneis de VPN configurados num gateway de VPN, e apenas é apresentado o relevante para o teste.

region

string

Nome de uma região do Google Cloud onde esta gateway de VPN está configurada.

VpnTunnelInfo

Apenas para apresentação. Metadados associados a um túnel 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 de VPN.

uri

string

URI de um túnel de VPN.

sourceGateway

string

URI do gateway de VPN no ponto final local do túnel.

remoteGateway

string

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

remoteGatewayIp

string

Endereço IP do gateway de VPN remoto.

sourceGatewayIp

string

Endereço IP do gateway de VPN local.

networkUri

string

URI de uma rede do Compute Engine onde o túnel VPN está configurado.

region

string

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

routingType

enum (RoutingType)

Tipo da política de encaminhamento.

RoutingType

Tipos de política de encaminhamento de VPN. Para obter detalhes, consulte o artigo Redes e encaminhamento de túneis.

Enumerações
ROUTING_TYPE_UNSPECIFIED Tipo não especificado. Valor predefinido.
ROUTE_BASED VPN baseada no encaminhamento.
POLICY_BASED Encaminhamento baseado em políticas.
DYNAMIC Encaminhamento dinâmico (BGP).

VpcConnectorInfo

Apenas para apresentação. Metadados associados a um conetor de VPC.

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

string

Nome de um conetor de VPC.

uri

string

URI de um conetor de VPC.

location

string

Localização na qual o conetor de VPC está implementado.

DirectVpcEgressConnectionInfo

Apenas para apresentação. Metadados associados a uma ligaçã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 IPs selecionado.

selectedIpAddress

string

Endereço IP inicial selecionado, a partir do intervalo de IP selecionado.

region

string

Região na qual a saída do VPC direto está implementada.

ServerlessExternalConnectionInfo

Apenas para apresentação. Metadados associados a uma ligação pública sem servidor.

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

string

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

DeliverInfo

Detalhes do estado final "deliver" e do 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 onde o pacote é entregue.

resourceUri

string

URI do recurso ao qual o pacote é entregue.

ipAddress

string

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

storageBucket

string

Nome do contentor do Cloud Storage para o qual o pacote é entregue (se aplicável).

pscGoogleApiTarget

string

A API Google do PSC para a qual o pacote é entregue (se aplicável).

googleServiceType

enum (GoogleServiceType)

Tipo reconhecido de um serviço Google ao qual o pacote é entregue (se aplicável).

Destino

Tipos de segmentações por fornecimento:

Enumerações
TARGET_UNSPECIFIED Alvo não especificado.
INSTANCE O destino é uma instância do Compute Engine.
INTERNET O alvo é a Internet.
GOOGLE_API O Target é uma API 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 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 pontos finais de rede sem servidor.
STORAGE_BUCKET O destino é um contentor do Cloud Storage.
PRIVATE_NETWORK O destino é uma rede privada. Usado apenas para rastreios de retorno.
CLOUD_FUNCTION O destino é uma função do Cloud. Usado apenas para rastreios de retorno.
APP_ENGINE_VERSION O destino é uma versão do serviço do App Engine. Usado apenas para rastreios de retorno.
CLOUD_RUN_REVISION O destino é uma revisão do Cloud Run. Usado apenas para rastreios de retorno.
GOOGLE_MANAGED_SERVICE O Target é um serviço gerido pela Google. Usado apenas para rastreios de retorno.
REDIS_INSTANCE O destino é uma instância de Redis.
REDIS_CLUSTER O destino é um Redis Cluster.

GoogleServiceType

Tipo reconhecido de um serviço Google.

Enumerações
GOOGLE_SERVICE_TYPE_UNSPECIFIED Serviço Google não especificado.
IAP Proxy com reconhecimento de identidade. https://cloud.google.com/iap/docs/using-tcp-forwarding
GFE_PROXY_OR_HEALTH_CHECK_PROBER Um de dois serviços que partilham intervalos de IP: * Proxy do balanceador de carga * Testador de verificação de funcionamento centralizado https://cloud.google.com/load-balancing/docs/firewall-rules
CLOUD_DNS Conetividade do Cloud DNS para alvos de encaminhamento ou servidores de nomes alternativos que usam o encaminhamento privado. 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 Google através do acesso VPC sem servidor. https://cloud.google.com/vpc/docs/serverless-vpc-access

ForwardInfo

Detalhes do estado final "encaminhar" e do recurso associado.

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

enum (Target)

Tipo de destino para o qual este pacote é encaminhado.

resourceUri

string

URI do recurso para o qual o pacote é encaminhado.

ipAddress

string

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

Destino

Tipos de segmentações de encaminhamento.

Enumerações
TARGET_UNSPECIFIED Alvo não especificado.
PEERING_VPC Encaminhado para uma rede de intercâmbio da VPC.
VPN_GATEWAY Encaminhado para um gateway do Cloud VPN.
INTERCONNECT Encaminhado para uma ligação do Cloud Interconnect.
GKE_MASTER

Encaminhada para um mestre do cluster de contentores do Google Kubernetes Engine.

IMPORTED_CUSTOM_ROUTE_NEXT_HOP Encaminhado para o próximo salto de um encaminhamento personalizado importado de uma VPC de peering.
CLOUD_SQL_INSTANCE

Encaminhada para uma instância do Cloud SQL.

ANOTHER_PROJECT Encaminhado para uma rede VPC noutro projeto.
NCC_HUB Encaminhado para um centro de controlo de rede (NCC).
ROUTER_APPLIANCE Encaminhada para um dispositivo de router.
SECURE_WEB_PROXY_GATEWAY Encaminhada para um gateway de proxy Web seguro.

AbortInfo

Detalhes do estado final "abort" e do 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 anulada.

resourceUri

string

URI do recurso que causou a anulação.

ipAddress

string

Endereço IP que causou a anulação.

projectsMissingPermission[]

string

Lista de IDs de projetos que o utilizador especificou no pedido, mas aos quais não tem acesso. Neste caso, a análise é anulada com a causa PERMISSION_DENIED.

Causa

Tipos de causas de anulação:

Enumerações
CAUSE_UNSPECIFIED A causa não está especificada.
UNKNOWN_NETWORK

Abortada devido a uma rede desconhecida. Obsoleto, não usado nos novos testes.

UNKNOWN_PROJECT

A operação foi anulada porque não é possível obter informações do projeto a partir da entrada de teste. Obsoleto, não usado nos novos testes.

NO_EXTERNAL_IP

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

UNINTENDED_DESTINATION

Anulado porque nenhum dos rastreios corresponde às informações de destino especificadas no pedido de teste de entrada. Obsoleto, não usado nos novos testes.

SOURCE_ENDPOINT_NOT_FOUND

Abortado porque não foi possível encontrar o ponto final de origem. Obsoleto, não usado nos novos testes.

MISMATCHED_SOURCE_NETWORK

Anulado porque a rede de origem não corresponde ao ponto final de origem. Obsoleto, não usado nos novos testes.

DESTINATION_ENDPOINT_NOT_FOUND

Anulado porque não foi possível encontrar o ponto final de destino. Obsoleto, não usado nos novos testes.

MISMATCHED_DESTINATION_NETWORK

Anulado porque a rede de destino não corresponde ao ponto final de destino. Obsoleto, não usado nos novos testes.

UNKNOWN_IP Anulado porque não foi encontrado nenhum ponto final com o endereço IP de destino do pacote.
GOOGLE_MANAGED_SERVICE_UNKNOWN_IP Abortado porque não foi encontrado nenhum ponto final com o IP de destino do pacote no projeto gerido pela Google.
SOURCE_IP_ADDRESS_NOT_IN_SOURCE_NETWORK Anulado porque o endereço IP de origem não pertence a nenhuma das sub-redes da rede VPC de origem.
PERMISSION_DENIED Abortado porque o utilizador não tem autorização para aceder a todas ou a parte das configurações de rede necessárias para executar o teste.
PERMISSION_DENIED_NO_CLOUD_NAT_CONFIGS Abortado porque o utilizador não tem autorização para aceder às configurações do Cloud NAT necessárias para executar o teste.
PERMISSION_DENIED_NO_NEG_ENDPOINT_CONFIGS Abortado porque o utilizador não tem autorização para aceder às configurações dos pontos finais do grupo de pontos finais de rede necessárias para executar o teste.
PERMISSION_DENIED_NO_CLOUD_ROUTER_CONFIGS Abortado porque o utilizador não tem autorização para aceder às configurações do Cloud Router necessárias para executar o teste.
NO_SOURCE_LOCATION Anulado porque não é derivado nenhum ponto final de origem ou de destino válido do pedido de teste de entrada.
INVALID_ARGUMENT Anulado porque o ponto final de origem ou de destino especificado no pedido é inválido. Alguns exemplos: - O pedido pode conter um URI de recurso, um ID do projeto ou um endereço IP formatado incorretamente. – O pedido pode conter informações inconsistentes (por exemplo, o pedido pode incluir a instância e a rede, mas a instância pode não ter uma NIC nessa rede).
TRACE_TOO_LONG Anulado porque o número de passos no rastreio excede um determinado limite. Pode ser causado por um ciclo de encaminhamento.
INTERNAL_ERROR Abortado devido a um erro interno do servidor.
UNSUPPORTED Abortado porque o cenário de teste não é suportado.
MISMATCHED_IP_VERSION Aborted because the source and destination resources have no common IP version.
GKE_KONNECTIVITY_PROXY_UNSUPPORTED Anulado porque a ligação entre o plano de controlo e o nó do cluster de origem é iniciada pelo nó e gerida pelo proxy Konnectivity.
RESOURCE_CONFIG_NOT_FOUND Anulado porque faltava a configuração do recurso esperada.
VM_INSTANCE_CONFIG_NOT_FOUND Abortado porque faltava a configuração esperada da instância de VM.
NETWORK_CONFIG_NOT_FOUND Abortado porque a configuração de rede esperada estava em falta.
FIREWALL_CONFIG_NOT_FOUND Abortado porque faltava a configuração da firewall esperada.
ROUTE_CONFIG_NOT_FOUND Abortado porque a configuração do trajeto esperada estava em falta.
GOOGLE_MANAGED_SERVICE_AMBIGUOUS_PSC_ENDPOINT Abortado porque a seleção do ponto final PSC para o serviço gerido pela Google é ambígua (vários pontos finais PSC satisfazem a entrada de teste).
GOOGLE_MANAGED_SERVICE_AMBIGUOUS_ENDPOINT Anulado porque a seleção do ponto final para o serviço gerido pela Google é ambígua (vários pontos finais satisfazem a entrada de teste).
SOURCE_PSC_CLOUD_SQL_UNSUPPORTED Abortado porque os testes com uma instância do Cloud SQL baseada em PSC como origem não são suportados.
SOURCE_REDIS_CLUSTER_UNSUPPORTED Anulado porque os testes com um cluster Redis como origem não são suportados.
SOURCE_REDIS_INSTANCE_UNSUPPORTED Ação anulada porque os testes com uma instância do Redis como origem não são suportados.
SOURCE_FORWARDING_RULE_UNSUPPORTED Anulado porque os testes com uma regra de encaminhamento como origem não são suportados.
NON_ROUTABLE_IP_ADDRESS Abortado porque um dos pontos finais é um endereço IP não encaminhável (loopback, link-local, etc.).
UNKNOWN_ISSUE_IN_GOOGLE_MANAGED_PROJECT A operação foi anulada devido a um problema desconhecido no projeto gerido pela Google.
UNSUPPORTED_GOOGLE_MANAGED_PROJECT_CONFIG Anulado devido a uma configuração não suportada do projeto gerido pela Google.
NO_SERVERLESS_IP_RANGES Abortado porque o ponto final de origem é uma revisão do Cloud Run com acesso direto à VPC ativado, mas não existem intervalos de IP sem servidor reservados.

DropInfo

Detalhes do estado final "drop" e do recurso associado.

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

enum (Cause)

Fazer com que o pacote seja rejeitado.

resourceUri

string

URI do recurso que causou a diminuição.

sourceIp

string

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

destinationIp

string

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

region

string

Região do pacote rejeitado (se relevante).

Causa

Tipos de causas de quedas:

Enumerações
CAUSE_UNSPECIFIED A causa não está especificada.
UNKNOWN_EXTERNAL_ADDRESS Não é possível resolver o endereço externo de destino para um destino conhecido. Se o endereço for usado num projeto do Google Cloud, indique 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 estrangeiro se ip_forward estiver ativado.
FIREWALL_RULE Descartado devido a uma regra de firewall, a menos que seja permitido devido à monitorização de ligações.
NO_ROUTE Ignorado porque não existem rotas correspondentes.
ROUTE_BLACKHOLE Ignorado devido a rota inválida. O salto seguinte da rota é um buraco negro.
ROUTE_WRONG_NETWORK O pacote é enviado para uma rede errada (não pretendida). Exemplo: rastreia um pacote de VM1:Network1 para VM2:Network2. No entanto, a rota configurada em Network1 envia o pacote destinado ao endereço IP de VM2 para Network3.
ROUTE_NEXT_HOP_IP_ADDRESS_NOT_RESOLVED Não é possível resolver o endereço IP do salto seguinte da rota para um recurso do GCP.
ROUTE_NEXT_HOP_RESOURCE_NOT_FOUND Não foi encontrado o recurso do próximo salto do trajeto.
ROUTE_NEXT_HOP_INSTANCE_WRONG_NETWORK A instância de salto seguinte da rota não tem uma NIC na rede da rota.
ROUTE_NEXT_HOP_INSTANCE_NON_PRIMARY_IP O endereço IP do salto seguinte da rota não é um endereço IP principal da instância do salto seguinte.
ROUTE_NEXT_HOP_FORWARDING_RULE_IP_MISMATCH A regra de encaminhamento do salto seguinte da rota não corresponde ao endereço IP do salto seguinte.
ROUTE_NEXT_HOP_VPN_TUNNEL_NOT_ESTABLISHED O túnel de VPN do salto seguinte da rota está inativo (não tem SAs IKE válidas).
ROUTE_NEXT_HOP_FORWARDING_RULE_TYPE_INVALID O tipo de regra de encaminhamento do salto seguinte da rota é inválido (não é uma regra de encaminhamento do balanceador de carga de passagem interno).
NO_ROUTE_FROM_INTERNET_TO_PRIVATE_IPV6_ADDRESS O pacote é enviado da Internet ou do serviço 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 uma instância.
VPN_TUNNEL_LOCAL_SELECTOR_MISMATCH O pacote não corresponde a um seletor local de túnel de VPN baseado em políticas.
VPN_TUNNEL_REMOTE_SELECTOR_MISMATCH O pacote não corresponde a um seletor remoto de túnel VPN baseado em políticas.
PRIVATE_TRAFFIC_TO_INTERNET Pacote com endereço de destino interno enviado para o gateway de Internet.
PRIVATE_GOOGLE_ACCESS_DISALLOWED O ponto final com apenas um endereço IP interno tenta aceder à API Google e aos serviços Google, mas o acesso privado à Google não está ativado na sub-rede ou não é aplicável.
PRIVATE_GOOGLE_ACCESS_VIA_VPN_TUNNEL_UNSUPPORTED O ponto final de origem tenta aceder à API Google e aos serviços através do túnel VPN para outra rede, mas o acesso privado à Google tem de estar ativado na rede do ponto final de origem.
NO_EXTERNAL_ADDRESS O ponto final com apenas um endereço IP interno tenta aceder a anfitriões externos, mas não existe um gateway do Cloud NAT correspondente na sub-rede.
UNKNOWN_INTERNAL_ADDRESS Não é possível resolver o endereço interno de destino para um destino conhecido. Se for um cenário de VPC partilhada, verifique se o ID do projeto de serviço é fornecido como entrada de teste. Caso contrário, verifique se o endereço IP está a ser usado no projeto.
FORWARDING_RULE_MISMATCH O protocolo e as portas da 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 As firewalls bloqueiam as sondas de verificação de funcionamento para os back-ends e fazem com que os back-ends fiquem indisponíveis para o tráfego do equilibrador de carga. Para mais detalhes, consulte o artigo Regras da firewall de verificação de funcionamento.
INGRESS_FIREWALL_TAGS_UNSUPPORTED_BY_DIRECT_VPC_EGRESS A correspondência de regras de firewall de entrada por etiquetas de rede para pacotes enviados através da saída direta da VPC sem servidor não é suportada. O comportamento não está definido. https://cloud.google.com/run/docs/configuring/vpc-direct-vpc#limitations
INSTANCE_NOT_RUNNING O pacote é enviado de ou para uma instância do Compute Engine que não está em 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 está em execução.
REDIS_INSTANCE_NOT_RUNNING Pacote enviado de ou para uma instância do Redis que não está em execução.
REDIS_CLUSTER_NOT_RUNNING Pacote enviado de ou para um Redis Cluster que não está em estado de execução.
TRAFFIC_TYPE_BLOCKED O tipo de tráfego está bloqueado e o utilizador não pode configurar uma regra de firewall para o ativar. Consulte a secção Tráfego sempre bloqueado para ver mais detalhes.
GKE_MASTER_UNAUTHORIZED_ACCESS O acesso ao ponto final do nó principal do cluster do Google Kubernetes Engine não está autorizado. Consulte o artigo Acesso aos pontos finais do cluster para ver mais detalhes.
CLOUD_SQL_INSTANCE_UNAUTHORIZED_ACCESS O acesso ao ponto final da instância do Cloud SQL não está autorizado. Consulte o artigo Autorizar com redes autorizadas para ver mais detalhes.
DROPPED_INSIDE_GKE_SERVICE O pacote foi rejeitado no serviço do Google Kubernetes Engine.
DROPPED_INSIDE_CLOUD_SQL_SERVICE O pacote foi rejeitado no serviço Cloud SQL.
GOOGLE_MANAGED_SERVICE_NO_PEERING O pacote foi rejeitado porque não existe peering entre a rede de origem e a rede de serviços geridos da Google.
GOOGLE_MANAGED_SERVICE_NO_PSC_ENDPOINT O pacote foi rejeitado porque o serviço gerido pela Google usa o Private Service Connect (PSC), mas o ponto final do PSC não foi encontrado no projeto.
GKE_PSC_ENDPOINT_MISSING O pacote foi rejeitado porque o cluster do GKE usa o Private Service Connect (PSC), mas o ponto final do PSC não foi encontrado no projeto.
CLOUD_SQL_INSTANCE_NO_IP_ADDRESS O pacote foi rejeitado 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 rejeitado porque um ponto final privado do cluster do GKE está inacessível a partir de uma região diferente da região do cluster.
PUBLIC_GKE_CONTROL_PLANE_TO_PRIVATE_DESTINATION Pacote enviado de um plano de controlo de cluster do GKE público para um endereço IP privado.
GKE_CONTROL_PLANE_NO_ROUTE O pacote foi rejeitado porque não existe uma rota do plano de controlo de um cluster do GKE para uma rede de destino.
CLOUD_SQL_INSTANCE_NOT_CONFIGURED_FOR_EXTERNAL_TRAFFIC Não é permitido o envio de 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 para endereços IP externos.
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 rejeitado porque não existe uma rota de uma instância do Cloud SQL para uma rede de destino.
CLOUD_SQL_CONNECTOR_REQUIRED O pacote foi rejeitado porque a instância do Cloud SQL requer que todas as ligações usem conetores do Cloud SQL e tenham como destino a porta do proxy do Cloud SQL (3307).
CLOUD_FUNCTION_NOT_ACTIVE O pacote pode ter sido rejeitado porque a função do Cloud não está num estado ativo.
VPC_CONNECTOR_NOT_SET O pacote pode ter sido rejeitado porque não está definido nenhum conetor de VPC.
VPC_CONNECTOR_NOT_RUNNING O pacote pode ter sido rejeitado porque o conector da VPC não está em execução.
VPC_CONNECTOR_SERVERLESS_TRAFFIC_BLOCKED O pacote pode ter sido rejeitado 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 ter sido rejeitado porque o tráfego de verificação de estado para o conetor de VPC não é permitido.
FORWARDING_RULE_REGION_MISMATCH O pacote pode ter sido rejeitado porque foi enviado de uma região diferente para um encaminhamento regional sem acesso global.
PSC_CONNECTION_NOT_ACCEPTED O ponto final do Private Service Connect está num projeto que não está aprovado para se ligar ao serviço.
PSC_ENDPOINT_ACCESSED_FROM_PEERED_NETWORK O pacote é enviado para o ponto final do Private Service Connect através da interligação, mas não é suportado.
PSC_NEG_PRODUCER_ENDPOINT_NO_GLOBAL_ACCESS O pacote é enviado para o back-end do Private Service Connect (grupo de pontos finais da rede), mas a regra de encaminhamento do PSC do produtor não tem o acesso global ativado.
PSC_NEG_PRODUCER_FORWARDING_RULE_MULTIPLE_PORTS O pacote é enviado para o back-end do Private Service Connect (grupo de pontos finais da rede), mas a regra de encaminhamento do PSC do produtor tem várias portas especificadas.
CLOUD_SQL_PSC_NEG_UNSUPPORTED O pacote é enviado para o back-end do Private Service Connect (grupo de pontos finais da rede) segmentando uma associação de serviço do Cloud SQL, mas esta configuração não é suportada.
NO_NAT_SUBNETS_FOR_PSC_SERVICE_ATTACHMENT Não estão definidas sub-redes NAT para a associação de serviço do PSC.
PSC_TRANSITIVITY_NOT_PROPAGATED O ponto final do PSC é acedido através do 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 do NEG híbrido corresponde a uma rota não dinâmica, mas essa configuração não é suportada.
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 numa região diferente, mas essa configuração não é suportada.
CLOUD_RUN_REVISION_NOT_READY Pacote enviado a partir de uma revisão do Cloud Run que não está pronta.
DROPPED_INSIDE_PSC_SERVICE_PRODUCER O pacote foi rejeitado no produtor do serviço do Private Service Connect.
LOAD_BALANCER_HAS_NO_PROXY_SUBNET Pacote enviado para um equilibrador de carga, que requer uma sub-rede apenas de proxy, e a sub-rede não é encontrada.
CLOUD_NAT_NO_ADDRESSES Pacote enviado para o Cloud NAT sem IPs NAT ativos.
ROUTING_LOOP O pacote está bloqueado num ciclo de encaminhamento.
DROPPED_INSIDE_GOOGLE_MANAGED_SERVICE O pacote é rejeitado num serviço gerido pela Google por ter sido entregue num rastreio de retorno a um ponto final que não corresponde ao ponto final a partir do qual o pacote foi enviado no rastreio de encaminhamento. Usado apenas para rastreios de retorno.
LOAD_BALANCER_BACKEND_INVALID_NETWORK O pacote é rejeitado porque uma instância de back-end do balanceador de carga não tem uma interface de rede na rede esperada pelo balanceador de carga.
BACKEND_SERVICE_NAMED_PORT_NOT_DEFINED O pacote é rejeitado porque não foi definido um serviço de back-end com nome de porta ao nível do grupo de instâncias.
DESTINATION_IS_PRIVATE_NAT_IP_RANGE O pacote é rejeitado porque um intervalo de IPs de destino faz parte de um intervalo de IPs NAT privados.
DROPPED_INSIDE_REDIS_INSTANCE_SERVICE Motivo genérico da rejeição de um pacote rejeitado no projeto de serviço de uma instância do Redis.
REDIS_INSTANCE_UNSUPPORTED_PORT O pacote é rejeitado porque está a ser usada uma porta não suportada para estabelecer ligação a uma instância do Redis. A porta 6379 deve ser usada para estabelecer ligação a uma instância do Redis.
REDIS_INSTANCE_CONNECTING_FROM_PUPI_ADDRESS O pacote é ignorado devido à ligação a partir de um endereço PUPI a uma instância Redis baseada em PSA.
REDIS_INSTANCE_NO_ROUTE_TO_DESTINATION_NETWORK O pacote é rejeitado porque não existe um trajeto 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 é rejeitado devido à utilização de um protocolo não suportado para estabelecer ligação a uma instância do Redis. Uma instância do Redis só aceita ligações TCP.
DROPPED_INSIDE_REDIS_CLUSTER_SERVICE Motivo genérico de rejeição de um pacote rejeitado num projeto de serviço do Redis Cluster.
REDIS_CLUSTER_UNSUPPORTED_PORT O pacote é rejeitado porque está a ser usada uma porta não suportada para estabelecer ligação a um Redis Cluster. As portas 6379 e 11000 a 13047 devem ser usadas para estabelecer ligação a um Redis Cluster.
REDIS_CLUSTER_NO_EXTERNAL_IP O Redis Cluster não tem um endereço IP externo.
REDIS_CLUSTER_UNSUPPORTED_PROTOCOL O pacote é rejeitado devido à utilização de um protocolo não suportado para estabelecer ligação a um Redis Cluster. Um cluster Redis só aceita ligações TCP.
NO_ADVERTISED_ROUTE_TO_GCP_DESTINATION O pacote da rede não pertencente à GCP (nas instalações) ou desconhecida da GCP é rejeitado porque o endereço IP de destino não pertence a nenhum prefixo IP anunciado através do BGP pelo Cloud Router.
NO_TRAFFIC_SELECTOR_TO_GCP_DESTINATION O pacote da rede não pertencente à GCP (no local) ou desconhecida da GCP é rejeitado porque o endereço IP de destino não pertence a nenhum prefixo IP incluído no seletor de tráfego local do túnel VPN.
NO_KNOWN_ROUTE_FROM_PEERED_NETWORK_TO_DESTINATION O pacote da rede de pares desconhecida é rejeitado porque não existe um caminho conhecido da rede de origem para o endereço IP de destino.
PRIVATE_NAT_TO_PSC_ENDPOINT_UNSUPPORTED O envio de pacotes processados pelos gateways NAT privados para os pontos finais do Private Service Connect não é suportado.
PSC_PORT_MAPPING_PORT_MISMATCH O pacote é enviado para o serviço de mapeamento de portas do PSC, mas a respetiva porta de destino não corresponde a nenhuma regra de mapeamento de portas.
PSC_PORT_MAPPING_WITHOUT_PSC_CONNECTION_UNSUPPORTED O envio de pacotes diretamente para o serviço de mapeamento de portas do PSC sem passar pela ligação do PSC não é suportado.
UNSUPPORTED_ROUTE_MATCHED_FOR_NAT64_DESTINATION O pacote com o endereço IP de destino dentro do intervalo NAT64 reservado é eliminado devido à correspondência com uma rota de um tipo não suportado.
TRAFFIC_FROM_HYBRID_ENDPOINT_TO_INTERNET_DISALLOWED O pacote pode ter sido rejeitado porque um ponto final híbrido, como um gateway de VPN ou uma interconexão, não tem autorização para enviar tráfego para a Internet.
NO_MATCHING_NAT64_GATEWAY O pacote com o endereço IP de destino dentro do intervalo NAT64 reservado é rejeitado porque não existe nenhum gateway NAT correspondente na sub-rede.
LOAD_BALANCER_BACKEND_IP_VERSION_MISMATCH O pacote é rejeitado porque foi enviado para um back-end de um equilibrador 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 do NCC desconhecido é rejeitado porque não existe um caminho conhecido da rede de origem para o endereço IP de destino.

LoadBalancerInfo

Apenas para apresentaçã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 estado do equilibrador de carga. Obsoleto e já não preenchido, uma vez que diferentes back-ends do equilibrador de carga podem ter verificações de estado diferentes.

backends[]

object (LoadBalancerBackend)

Informações para os back-ends do balanceador de carga.

backendType

enum (BackendType)

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

backendUri

string

URI da configuração do back-end.

LoadBalancerType

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

Enumerações
LOAD_BALANCER_TYPE_UNSPECIFIED O tipo não está 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 apresentação. Metadados associados a um back-end do 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 do Compute Engine ou de um ponto final de rede.

uri

string

URI de uma instância do Compute Engine ou de um ponto final da rede.

healthCheckFirewallState

enum (HealthCheckFirewallState)

Estado da configuração da firewall da verificação de funcionamento.

healthCheckAllowingFirewallRules[]

string

Uma lista de URIs de regras de firewall que permitem sondagens de intervalos de IP de verificações de funcionamento.

healthCheckBlockingFirewallRules[]

string

Uma lista de URIs de regras de firewall que bloqueiam sondagens de intervalos de IPs de verificação de estado.

HealthCheckFirewallState

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

Enumerações
HEALTH_CHECK_FIREWALL_STATE_UNSPECIFIED O estado não está especificado. Estado predefinido se não for preenchido.
CONFIGURED Existem regras de firewall configuradas para permitir que as sondas de verificação de funcionamento acedam ao back-end.
MISCONFIGURED Existem regras de firewall configuradas para permitir intervalos de verificações de funcionamento parciais ou bloquear todos os intervalos de verificações de funcionamento. Se uma sondagem de verificação de funcionamento for enviada a partir de intervalos de IP recusados, a verificação de funcionamento para o back-end falha. Em seguida, o back-end é marcado como não saudável e não recebe 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:

Enumerações
BACKEND_TYPE_UNSPECIFIED O tipo não está especificado.
BACKEND_SERVICE Serviço de back-end como back-end do balanceador de carga.
TARGET_POOL Grupo 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 apresentaçã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 IP 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 apresentaçã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 controlo do cluster do GKE.

externalIp

string

Endereço IP externo de um painel de controlo do cluster do GKE.

dnsEndpoint

string

Ponto final de DNS de um painel de controlo do cluster do GKE.

CloudSQLInstanceInfo

Apenas para apresentaçã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 uma 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 na qual a instância do Cloud SQL está a ser executada.

RedisInstanceInfo

Apenas para apresentaçã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 ponto final principal de uma instância do Cloud Redis.

readEndpointIp

string

Ler o endereço IP do ponto final de uma instância do Cloud Redis (se aplicável).

region

string

Região na qual a instância do Cloud Redis está definida.

RedisClusterInfo

Apenas para apresentação. Metadados associados a um Redis Cluster.

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

string

Nome de um cluster Redis.

uri

string

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

networkUri

string

URI da rede que contém os pontos finais do Redis Cluster no formato "projects/{projectId}/global/networks/{network_id}".

discoveryEndpointIpAddress

string

Endereço IP do ponto final de deteção de um Redis Cluster.

secondaryEndpointIpAddress

string

Endereço IP do ponto final secundário de um Redis Cluster.

location

string

Nome da região na qual o Redis Cluster está definido. Por exemplo, "us-central1".

CloudFunctionInfo

Apenas para apresentação. Metadados associados a uma Cloud Function.

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

Localização na qual a função do Cloud está implementada.

versionId

string (int64 format)

ID da versão implementada com êxito mais recente da função do Cloud.

AppEngineVersionInfo

Apenas para apresentaçã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 apresentaçã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 onde esta revisão está implementada.

serviceUri

string

URI do serviço do Cloud Run ao qual esta revisão pertence.

NatInfo

Apenas para apresentação. Metadados associados à 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 string, por exemplo: "TCP", "UDP", "ICMP".

networkUri

string

URI da rede onde ocorre a tradução NAT.

oldSourceIp

string

Endereço IP de origem antes da tradução de NAT.

newSourceIp

string

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

oldDestinationIp

string

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

newDestinationIp

string

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

oldSourcePort

integer

Porta de origem antes da tradução NAT. Só é válido quando o protocolo é TCP ou UDP.

newSourcePort

integer

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

oldDestinationPort

integer

Porta de destino antes da tradução NAT. Só é válido quando o protocolo é TCP ou UDP.

newDestinationPort

integer

Porta de destino após a tradução NAT. Só é válido quando o protocolo é TCP ou UDP.

routerUri

string

URI do Cloud Router. Só é válido quando o tipo é CLOUD_NAT.

natGatewayName

string

O nome da gateway do Cloud NAT. Só é válido quando o tipo é CLOUD_NAT.

Tipo

Tipos de NAT.

Enumerações
TYPE_UNSPECIFIED O tipo não está 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 apresentaçã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 string, por exemplo: "TCP", "UDP", "ICMP".

oldSourceIp

string

Endereço IP de origem de uma ligação original.

newSourceIp

string

Endereço IP de origem de uma nova ligação.

oldDestinationIp

string

Endereço IP de destino de uma ligação original

newDestinationIp

string

Endereço IP de destino de uma nova ligação.

oldSourcePort

integer

Porta de origem de uma ligação original. Só é válido quando o protocolo é TCP ou UDP.

newSourcePort

integer

Porta de origem de uma nova ligação. Só é válido quando o protocolo é TCP ou UDP.

oldDestinationPort

integer

Porta de destino de uma ligação original. Só é válido quando o protocolo é TCP ou UDP.

newDestinationPort

integer

Porta de destino de uma nova ligação. Só é válido quando o protocolo é TCP ou UDP.

subnetUri

string

URI da sub-rede proxy.

networkUri

string

URI da rede onde a ligação é feita através de proxy.

LoadBalancerBackendInfo

Apenas para apresentaçã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 a apresentar do back-end. Por exemplo, pode ser um nome de instância para os backends do grupo de instâncias ou um endereço IP e uma porta para os backends do grupo de pontos finais de rede zonais.

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 NEG zonais.

backendServiceUri

string

URI do serviço de back-end ao qual este back-end pertence (se aplicável).

instanceGroupUri

string

URI do grupo de instâncias ao qual este back-end pertence (se aplicável).

networkEndpointGroupUri

string

URI do grupo de pontos finais da rede ao qual este back-end pertence (se aplicável).

backendBucketUri

string

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

pscServiceAttachmentUri

string

URI da associação de serviço do PSC que este back-end do NEG do PSC segmenta (se aplicável).

pscGoogleApiTarget

string

A API Google do PSC segmenta estes destinos de back-end do NEG do PSC (se aplicável).

healthCheckUri

string

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

healthCheckFirewallsConfigState

enum (HealthCheckFirewallsConfigState)

Apenas saída. Estado da configuração das firewalls de verificação de funcionamento para o back-end. Isto é o resultado da análise da firewall estática (que verifica se o tráfego de verificação de estado dos intervalos de IP necessários para o back-end é permitido ou não). O back-end pode continuar em mau estado mesmo que estas firewalls estejam configuradas. 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 das firewalls de verificação do estado de funcionamento.

Enumerações
HEALTH_CHECK_FIREWALLS_CONFIG_STATE_UNSPECIFIED Estado da configuração não especificado. Normalmente, significa que o back-end não tem uma verificação de estado anexada ou que ocorreu um erro de configuração inesperado que impede os testes de conetividade de validar a configuração da verificação de estado.
FIREWALLS_CONFIGURED As regras (políticas) de firewall que permitem o tráfego de verificação de funcionamento 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ções de funcionamento apenas a partir de uma parte dos intervalos de IPs necessários.
FIREWALLS_NOT_CONFIGURED As regras de firewall (políticas) negam o tráfego de verificação de funcionamento 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 suportados, pelo que os testes de conetividade não conseguiram validar o estado da configuração da verificação de estado. Consulte a documentação para ver a lista de configurações não suportadas: https://cloud.google.com/network-intelligence-center/docs/connectivity-tests/concepts/overview#unsupported-configs

StorageBucketInfo

Apenas para apresentação. Metadados associados ao contentor de armazenamento.

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

string

Nome do contentor do Cloud Storage.

ServerlessNegInfo

Apenas para apresentação. Metadados associados ao back-end do grupo de pontos finais da rede sem servidor.

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

string

URI do grupo de pontos finais da 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)

A hora em que a acessibilidade foi avaliada através da sondagem ativa.

Usa RFC 3339, em que o resultado gerado é sempre normalizado em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Também são aceites desvios diferentes de "Z". Exemplos: "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 pelo qual a análise detalhada foi interrompida.

sentProbeCount

integer

Número de sondagens enviadas.

successfulProbeCount

integer

O número de sondagens que chegaram ao destino.

endpointInfo

object (EndpointInfo)

Os pontos finais de origem e destino derivados da entrada de teste e usados para a sondagem ativa.

probingLatency

object (LatencyDistribution)

Latência medida por sondagem ativa numa direção: da origem ao ponto final de destino.

destinationEgressLocation

object (EdgeLocation)

A EdgeLocation a partir da qual um pacote, destinado à Internet, vai sair da rede Google. Este campo só é preenchido para um teste de conetividade que tenha um endereço de destino da Internet. A ausência deste campo não deve ser usada como uma indicação de que o destino faz parte da rede Google.

edgeResponses[]

object (SingleEdgeResponse)

Resultados de sondagem para todos os dispositivos periféricos.

probedAllDevices

boolean

Se todos os dispositivos periféricos relevantes foram sondados.

ProbingResult

Resultado geral da análise detalhada do teste.

Enumerações
PROBING_RESULT_UNSPECIFIED Não foi especificado nenhum resultado.
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 Não foi possível determinar a acessibilidade. Os possíveis motivos são: * O utilizador não tem autorização para aceder a alguns dos recursos de rede necessários para executar o teste. * Não foi possível obter nenhum ponto final de origem válido a partir do pedido. * Ocorreu um erro interno.

ProbingAbortCause

Tipos de causas de cancelamento.

Enumerações
PROBING_ABORT_CAUSE_UNSPECIFIED Não foi especificado nenhum motivo.
PERMISSION_DENIED O utilizador não tem autorização para aceder a alguns dos recursos de rede necessários para executar o teste.
NO_SOURCE_LOCATION Não foi possível obter nenhum ponto final de origem válido a partir do pedido.

LatencyDistribution

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

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

object (LatencyPercentile)

Percentis de latência representativos.

LatencyPercentile

Ordem percentual e valor da latência.

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

integer

Percentagem de amostras a que este ponto de dados se aplica.

latencyMicros

string (int64 format)

Percentil percentual da latência observada, em microssegundos. A fração de percentagem/100 de amostras tem uma latência inferior ou igual ao valor deste campo.

EdgeLocation

Representação de uma localização na extremidade da rede, conforme https://cloud.google.com/vpc/docs/edge-locations.

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

string

Nome da área metropolitana.

SingleEdgeResponse

Resultados da sondagem para um único dispositivo periférico.

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

O número de sondagens que chegaram ao destino.

probingLatency

object (LatencyDistribution)

Latência medida por sondagem ativa numa direção: da origem ao ponto final de destino.

destinationEgressLocation

object (EdgeLocation)

A EdgeLocation a partir da qual um pacote, destinado à Internet, vai sair da rede Google. Este campo só é preenchido para um teste de conetividade que tenha um endereço de destino da Internet. A ausência deste campo não deve ser usada como uma indicação de que o destino faz parte da rede Google.

destinationRouter

string

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

Métodos

create

Cria um novo teste de conetividade.

delete

Elimina um ConnectivityTest específico.

get

Obtém os detalhes de um teste de conetividade específico.

getIamPolicy

Obtém a política de controlo de acesso para um recurso.

list

Apresenta todos os Connectivity Tests pertencentes a um projeto.

patch

Atualiza a configuração de um ConnectivityTest existente.

rerun

Voltar a executar um ConnectivityTest existente.

setIamPolicy

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

testIamPermissions

Devolve as autorizações que um autor da chamada tem no recurso especificado.