Veja a configuração de rede de uma instância

Use as instruções nesta página para ver as interfaces de rede, redes, sub-redes e endereços IP de uma instância de computação.

Antes de começar

• Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se no Compute Engine selecionando uma das seguintes opções:

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando:

     gcloud init

     Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

     Nota: se instalou a CLI gcloud anteriormente, certifique-se de que tem a versão mais recente executando gcloud components update.
  2. Set a default region and zone.

  REST

  Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

  Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando:

  gcloud init

  Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

  Nota: se instalou a CLI gcloud anteriormente, certifique-se de que tem a versão mais recente executando gcloud components update.

  Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.

Funções necessárias

Para receber as autorizações de que precisa para ver a configuração de rede de uma instância, peça ao seu administrador que lhe conceda a função IAM Administrador de instâncias do Compute (v1) (roles/compute.instanceAdmin.v1) ou Administrador de rede do Compute (roles/compute.networkAdmin) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Esta função predefinida contém as autorizações necessárias para ver a configuração de rede de uma instância. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para ver a configuração de rede de uma instância:

• Ver a configuração de rede de uma instância: compute.instances.get na instância
• Veja os endereços IP de uma instância: compute.instances.list no projeto

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Veja endereços IP

Pode ver os endereços IP internos e externos da sua instância. Os endereços IP podem ser endereços IPv4 ou IPv6.

Consola

1. Na Google Cloud consola, aceda à página Instâncias de VM.

   Aceder às instâncias de VM

2. Opcional: use a caixa Filtro para restringir o número de instâncias apresentadas.

3. Se a instância tiver um endereço IP externo, este é apresentado na coluna IP externo.

   Se a coluna IP externo estiver vazia, significa que não existe um endereço IP externo para a instância. Se a instância não tiver um endereço IP externo, pode atribuir um.

Consoante as opções de apresentação de colunas, pode ver mais colunas ou menos colunas do que as que aparecem na imagem anterior.

gcloud

Existem dois comandos que pode usar para ver os endereços IP de uma instância:

• gcloud compute instances list mostra todos os endereços IP usados por uma instância de computação, estáticos ou efémeros.
• gcloud compute addresses list mostra todos os endereços IP reservados que estão atribuídos a uma instância de computação.

Esta tarefa mostra como ver endereços IP através de comandos gcloud compute instances.

1. Para ver os endereços IP internos e externos das suas instâncias, use o comando gcloud compute instances list.

   gcloud compute instances list

   Pode acrescentar a cláusula --filter para restringir o número de instâncias devolvidas pelo comando, por exemplo, --filter='zone:us-central1-c'.

   O resultado é semelhante ao seguinte:

   NAME           ZONE            MACHINE_TYPE    PREEMPTIBLE  INTERNAL_IP                EXTERNAL_IP                     STATUS
   webapp1        us-central1-c   c3-highmem-88   true         192.0.2.11                                                 RUNNING
   my-instance    us-central1-c   n4-standard-2                192.0.2.126                203.0.113.6                     RUNNING
   my-dual-stack  us-central1-a   e2-micro                     192.0.2.54                 203.0.113.7                     RUNNING
                                                                                         2001:db8:2:2:2:2:2:2/96
   new-ipv6-only  us-central1-a   n4-standard-2                2001:db8:1:1:1:1:1:1/96                                    RUNNING
   

   Se o campo de endereço IP externo estiver vazio, significa que não existe nenhum endereço IP desse tipo definido para a instância. Pode atribuir um.

2. Para ver o endereço IP interno ou externo de uma instância específica, use o comando gcloud compute instances describe com uma flag --format para filtrar a saída.

   Moradas internas

   Para ver o endereço IP interno de uma instância específica, use qualquer um dos seguintes comandos:

   • Endereços IPv4:

        gcloud compute instances describe INSTANCE_NAME \
            --zone=ZONE \
            --format='get(networkInterfaces[0].networkIP)'
       

     192.0.2.11

   • Endereços IPv6:

        gcloud compute instances describe INSTANCE_NAME \
            --zone=ZONE \
            --format='get(networkInterfaces[0].ipv6Address)'
       

     2001:db8:2:2:2:2:2:2

   Endereços externos

   Para ver o endereço IP externo de uma instância específica, use um dos seguintes comandos:

   • Endereços IPv4:

        gcloud compute instances describe INSTANCE_NAME \
            --zone=ZONE \
            --format='get(networkInterfaces[0].accessConfigs[0].natIP)'
       

     203.0.113.6

   • Endereços IPv6:

        gcloud compute instances describe INSTANCE_NAME \
            --zone=ZONE \
            --format='get(networkInterfaces[0].ipv6AccessConfigs[0].externalIpv6)'
       

     2001:db8:3:3:3:3:3:3

   Substitua o seguinte:

   • INSTANCE_NAME: o nome da instância cujo IP interno ou externo quer ver
   • ZONE: o nome da zona onde a instância está localizada

   Se o comando não devolver um endereço IP, significa que a instância não tem um endereço IP externo configurado.

REST

Faça um pedido GET ao método instances.get. Ao anexar um parâmetro de consulta $fields ao pedido, pode restringir a saída apenas aos campos de interesse.

 GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME$fields=name,networkInterfaces.networkIP,networkInterfaces.accessConfigs.natIP,networkInterfaces.ipv6AccessConfigs.externalIpv6
 

Substitua o seguinte:

• PROJECT_NAME: o nome do projeto que contém a instância
• ZONE: a zona da instância que quer consultar
• INSTANCE_NAME: o nome do recurso de instância a devolver

Se algum dos endereços IP não estiver configurado, esse campo não é apresentado no resultado. Para uma instância de computação que usa uma rede de pilha dupla com um endereço IPv6 externo, o corpo da resposta é semelhante ao seguinte:

{
  "name": "my-dual-stack-vm",
  "networkInterfaces": [
    {
      "networkIP": "10.0.0.2",
      "accessConfigs": [
        {
          "natIP": "104.155.21.204"
        }
      ],
      "ipv6AccessConfigs": [
        {
          "externalIpv6": "2600:1900:4010:8b2:0:0:0:0"
        }
      ]
    }
  ]
}

Os seguintes campos contêm as informações necessárias:

• networkIP: o endereço IPv4 interno atribuído
• natIP: o endereço IPv4 externo atribuído
• externalIpv6: o endereço IPv6 externo atribuído

Python

from enum import Enum
from typing import List

from google.cloud import compute_v1


def get_instance(project_id: str, zone: str, instance_name: str) -> compute_v1.Instance:
    """
    Get information about a VM instance in the given zone in the specified project.

    Args:
        project_id: project ID or project number of the Cloud project you want to use.
        zone: name of the zone you want to use. For example: “us-west3-b”
        instance_name: name of the VM instance you want to query.
    Returns:
        An Instance object.
    """
    instance_client = compute_v1.InstancesClient()
    instance = instance_client.get(
        project=project_id, zone=zone, instance=instance_name
    )

    return instance


class IPType(Enum):
    INTERNAL = "internal"
    EXTERNAL = "external"
    IP_V6 = "ipv6"


def get_instance_ip_address(
    instance: compute_v1.Instance, ip_type: IPType
) -> List[str]:
    """
    Retrieves the specified type of IP address (ipv6, internal or external) of a specified Compute Engine instance.

    Args:
        instance (compute_v1.Instance): instance to get
        ip_type (IPType): The type of IP address to retrieve (ipv6, internal or external).

    Returns:
        List[str]: Requested type IP addresses of the instance.
    """
    ips = []
    if not instance.network_interfaces:
        return ips
    for interface in instance.network_interfaces:
        if ip_type == IPType.EXTERNAL:
            for config in interface.access_configs:
                if config.type_ == "ONE_TO_ONE_NAT":
                    ips.append(config.nat_i_p)
        elif ip_type == IPType.IP_V6:
            for ipv6_config in getattr(interface, "ipv6_access_configs", []):
                if ipv6_config.type_ == "DIRECT_IPV6":
                    ips.append(ipv6_config.external_ipv6)

        elif ip_type == IPType.INTERNAL:
            # Internal IP is directly available in the network interface
            ips.append(interface.network_i_p)
    return ips

Java

import com.google.cloud.compute.v1.AccessConfig;
import com.google.cloud.compute.v1.AccessConfig.Type;
import com.google.cloud.compute.v1.GetInstanceRequest;
import com.google.cloud.compute.v1.Instance;
import com.google.cloud.compute.v1.InstancesClient;
import com.google.cloud.compute.v1.NetworkInterface;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

public class GetVmAddress {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    // Project ID or project number of the Google Cloud project you want to use.
    String projectId = "your-project-id";
    // Instance ID of the Google Cloud project you want to use.
    String instanceId = "your-instance-id";
    // IPType you want to search.
    IpType ipType = IpType.INTERNAL;

    getVmAddress(projectId, instanceId, ipType);
  }

  // Retrieves the specified type of IP address
  // (ipv6, internal or external) of a specified Compute Engine instance.
  public static List<String> getVmAddress(String projectId, String instanceId, IpType ipType)
          throws IOException {
    List<String> result = new ArrayList<>();
    Instance instance = getInstance(projectId, instanceId);

    for (NetworkInterface networkInterface : instance.getNetworkInterfacesList()) {
      if (ipType == IpType.EXTERNAL) {
        for (AccessConfig accessConfig : networkInterface.getAccessConfigsList()) {
          if (accessConfig.getType().equals(Type.ONE_TO_ONE_NAT.name())) {
            result.add(accessConfig.getNatIP());
          }
        }
      } else if (ipType == IpType.IP_V6) {
        for (AccessConfig accessConfig : networkInterface.getAccessConfigsList()) {
          if (accessConfig.hasExternalIpv6()
                  && accessConfig.getType().equals(Type.DIRECT_IPV6.name())) {
            result.add(accessConfig.getExternalIpv6());
          }
        }
      } else if (ipType == IpType.INTERNAL) {
        result.add(networkInterface.getNetworkIP());
      }
    }

    return result;
  }

  private static Instance getInstance(String projectId, String instanceId) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (InstancesClient instancesClient = InstancesClient.create()) {
      GetInstanceRequest request = GetInstanceRequest.newBuilder()
              .setInstance(instanceId)
              .setProject(projectId)
              .setZone("us-central1-b")
              .build();
      return instancesClient.get(request);
    }
  }

  public enum IpType {
    INTERNAL("internal"),
    EXTERNAL("external"),
    IP_V6("ipv6");

    private final String type;

    IpType(String type) {
      this.type = type;
    }

    public String getType() {
      return type;
    }
  }
}

Veja as interfaces de rede de uma instância

Cada instância de computação tem, pelo menos, uma interface de rede. Pode ver as propriedades configuradas das interfaces de rede de uma instância das seguintes formas.

Consola

1. Na Google Cloud consola, aceda à página Instâncias de VM.

   Aceder às instâncias de VM

2. Opcional: use a caixa Filtro para restringir o número de instâncias apresentadas.

3. Clique no nome da instância que quer inspecionar.

4. Na secção Rede, em Interfaces de rede, pode ver as interfaces de rede (NICs) criadas para a instância, a rede e a sub-rede associadas a cada NIC, bem como os respetivos endereços IP atribuídos.

5. Pode clicar no nome de uma NIC para abrir a página Detalhes da interface de rede. Nesta página, pode ver as firewalls e as rotas usadas pela NIC, bem como realizar um teste de conetividade para a NIC.

gcloud

Para ver as interfaces de rede (NICs) de uma instância de computação, use o comando gcloud compute instances describe. Pode anexar uma opção --format ao comando para restringir as informações devolvidas a campos específicos e alterar a forma como são apresentadas, por exemplo:

gcloud compute instances describe INSTANCE_NAME --zone=ZONE \
    --format="flattened(name,networkInterfaces[].name, networkInterfaces[].network.basename(), networkInterfaces[].stackType, networkInterfaces[].nicType)"

Substitua o seguinte:

• INSTANCE_NAME: o nome da instância a ver
• ZONE: a zona da instância que quer ver

O resultado é semelhante ao seguinte:

name:                           my-multinic-vm
networkInterfaces[0].name:      nic0
networkInterfaces[0].network:   default
networkInterfaces[0].nicType:   GVNIC
networkInterfaces[0].stackType: IPV4_ONLY
networkInterfaces[1].name:      nic1
networkInterfaces[1].network:   appnet-vpc-0
networkInterfaces[1].nicType:   GVNIC
networkInterfaces[1].stackType: IPV4_IPV6

REST

Construa um pedido GET para o método instances.get. Ao anexar um parâmetro de consulta $fields ao pedido, pode restringir a saída apenas à propriedade networkInterfaces.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME?$fields=networkInterfaces

Substitua o seguinte:

• PROJECT_NAME: o nome do projeto que contém a instância
• ZONE: a zona da instância que quer consultar
• INSTANCE_NAME: o nome do recurso de instância a devolver

O resultado é semelhante ao seguinte:

{
  "networkInterfaces": [
  {
    "kind": "compute#networkInterface",
    "network": "https://www.googleapis.com/compute/v1/projects/my-project/global/networks/network-name-1",
    "subnetwork": "https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/subnetworks/subnet-name-1",
    "networkIP": "10.128.0.15",
    "name": "nic0",
    "accessConfigs": [
      {
        "kind": "compute#accessConfig",
        "type": "ONE_TO_ONE_NAT",
        "name": "External NAT",
        "networkTier": "PREMIUM"
      }
    ],
    "fingerprint": "mBy9xvkWA9M=",
    "stackType": "IPV4_ONLY",
    "nicType": "GVNIC"
  },
  {
    "kind": "compute#networkInterface",
    "network": "https://www.googleapis.com/compute/v1/projects/my-project/global/networks/network-name-2",
    "subnetwork": "https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/subnetworks/subnet-name-2",
    "networkIP": "10.0.20.2",
    "name": "nic1",
    "accessConfigs": [
      {
        "kind": "compute#accessConfig",
        "type": "ONE_TO_ONE_NAT",
        "name": "External NAT",
        "networkTier": "PREMIUM"
      }
    ],
    "ipv6AccessConfigs": [
      {
        "kind": "compute#accessConfig",
        "type": "DIRECT_IPV6",
        "name": "external-ipv6",
        "externalIpv6": "2600:1900:4000:8447:0:0:0:0",
        "externalIpv6PrefixLength": 96,
        "publicPtrDomainName": "",
        "networkTier": "PREMIUM"
      }
    ],
    "fingerprint": "rx6hfNA94f4=",
    "stackType": "IPV4_IPV6",
    "ipv6AccessType": "EXTERNAL",
    "nicType": "GVNIC"
  }
  ]
}

Veja a configuração da interface de rede dinâmica para uma instância

Pré-visualização

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Se configurou NICs dinâmicas para uma instância, pode usar um dos seguintes métodos para rever as informações das NICs dinâmicas.

gcloud

Para ver as interfaces de rede (NICs) de uma instância de computação, use o comando gcloud beta compute instances describe. Pode anexar uma opção --format ao comando para restringir as informações devolvidas a campos específicos e alterar a forma como são apresentadas, por exemplo:

gcloud compute instances describe INSTANCE_NAME --zone=ZONE \
    --format="flattened(name,networkInterfaces[].name, networkInterfaces[].network.basename(), networkInterfaces[].stackType, networkInterfaces[].parentNicName)"

O resultado é semelhante ao seguinte:

name:                           test-instance
networkInterfaces[0].name:      nic0
networkInterfaces[0].network:   default
networkInterfaces[0].nicType:   GVNIC
networkInterfaces[0].stackType: IPV4_ONLY
networkInterfaces[1].name:      nic1
networkInterfaces[1].network:   prod-ipv6
networkInterfaces[1].nicType:   GVNIC
networkInterfaces[1].stackType: IPV4_IPV6
networkInterfaces[1].name:      nic1.2
networkInterfaces[1].network:   alt-ipv6-net
networkInterfaces[1].nicType:   GVNIC
networkInterfaces[1].stackType: IPV4_IPV6
networkInterfaces[1].parentNicName: nic1

REST

Construa um pedido GET para o método instances.get. Ao anexar um parâmetro de consulta $fields ao pedido, pode restringir a saída apenas à propriedade networkInterfaces.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: ID do projeto que contém a instância
• ZONE: zona da instância
• INSTANCE_NAME: o nome da instância

Método HTTP e URL:

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME?$fields=networkInterfaces

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://compute.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME?$fields=networkInterfaces"

PowerShell (Windows)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://compute.googleapis.com/compute/beta/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME?$fields=networkInterfaces" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

{
  "networkInterfaces": [
  {
    "kind": "compute#networkInterface",
    "network": "https://www.googleapis.com/compute/beta/projects/my-project/global/networks/network-name-1",
    "subnetwork": "https://www.googleapis.com/compute/beta/projects/my-project/regions/us-central1/subnetworks/subnet-name-1",
    "networkIP": "10.128.0.15",
    "name": "nic0",
    "accessConfigs": [
      {
        "kind": "compute#accessConfig",
        "type": "ONE_TO_ONE_NAT",
        "name": "External NAT",
        "networkTier": "PREMIUM"
      }
    ],
    "fingerprint": "mBy9xvkWA9M=",
    "stackType": "IPV4_ONLY",
    "nicType": "GVNIC"
  },
  {
    "kind": "compute#networkInterface",
    "network": "https://www.googleapis.com/compute/beta/projects/my-project/global/networks/network-name-2",
    "subnetwork": "https://www.googleapis.com/compute/beta/projects/my-project/regions/us-central1/subnetworks/subnet-name-2",
    "networkIP": "10.0.20.2",
    "name": "nic1",
    "accessConfigs": [
      {
        "kind": "compute#accessConfig",
        "type": "ONE_TO_ONE_NAT",
        "name": "External NAT",
        "networkTier": "PREMIUM"
      }
    ],
    "ipv6AccessConfigs": [
      {
        "kind": "compute#accessConfig",
        "type": "DIRECT_IPV6",
        "name": "external-ipv6",
        "externalIpv6": "2600:1900:4000:8447:0:0:0:0",
        "externalIpv6PrefixLength": 96,
        "publicPtrDomainName": "",
        "networkTier": "PREMIUM"
      }
    ],
    "fingerprint": "rx6hfNA94f4=",
    "stackType": "IPV4_IPV6",
    "ipv6AccessType": "EXTERNAL",
    "nicType": "GVNIC",
    "parentNicName": "nic1"
  },
  {
    "kind": "compute#networkInterface",
    "network": "https://www.googleapis.com/compute/beta/projects/my-project/global/networks/network-name-3",
    "subnetwork": "https://www.googleapis.com/compute/beta/projects/my-project/regions/us-central1/subnetworks/subnet-name-3",
    "networkIP": "10.0.26.2",
    "name": "nic1.1",
    "accessConfigs": [
      {
        "kind": "compute#accessConfig",
        "type": "ONE_TO_ONE_NAT",
        "name": "External NAT",
        "networkTier": "PREMIUM"
      }
    ],
    "ipv6AccessConfigs": [
      {
        "kind": "compute#accessConfig",
        "type": "DIRECT_IPV6",
        "name": "external-ipv6",
        "externalIpv6": "2600:1900:4000:8450:0:0:0:0",
        "externalIpv6PrefixLength": 96,
        "publicPtrDomainName": "",
        "networkTier": "PREMIUM"
      }
    ],
    "fingerprint": "rx6hfNA94f4=",
    "stackType": "IPV4_IPV6",
    "ipv6AccessType": "EXTERNAL",
    "nicType": "GVNIC",
    "parentNicName": "nic1"
  }
  ]
}

Veja todas as instâncias de computação numa rede

Use um dos seguintes métodos para ver todas as instâncias de computação numa determinada rede.

Consola

1. Na Google Cloud consola, aceda à página Redes VPC.

   Aceda a redes de VPC

2. Opcional: use a caixa Filtrar para restringir o número de redes apresentadas.

3. Clique no nome da rede para a qual quer listar as instâncias de computação.

4. Selecione o separador Instâncias para ver as instâncias nessa rede.

gcloud

Para ver as instâncias de computação que usam uma rede específica, use o comando gcloud compute instances list.

Use uma flag --filter para listar apenas as instâncias que usam uma rede específica. Também pode usar uma flag --format para restringir e formatar os resultados, por exemplo:

gcloud compute instances list \
    --filter 'networkInterfaces[].network:NETWORK_NAME' \
    --format="table(name:sort=1,machineType.basename(),zone.basename(),networkInterfaces[].subnetwork)"

O resultado é semelhante ao seguinte:

NAME: c2-tier1-multinic
MACHINE_TYPE: c2-standard-30
ZONE: us-central1-c
SUBNETWORK: ['https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/subnetworks/default', 'https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/subnetworks/webapps-external-subnet']

NAME: c3-with-lssd
MACHINE_TYPE: c3-standard-4-lssd
ZONE: us-central1-a
SUBNETWORK: ['https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/subnetworks/default']

NAME: example-instance3
MACHINE_TYPE: n2-custom-2-163840-ext
ZONE: us-central1-b
SUBNETWORK: ['https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/subnetworks/default']

NAME: n4-test-windows
MACHINE_TYPE: n4-standard-2
ZONE: us-central1-c
SUBNETWORK: ['https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/subnetworks/default']

Determine se a rede de nível 1 está ativada

Use um dos seguintes métodos para determinar se o desempenho de rede de nível 1 por VM está ativado para uma instância.

Consola

1. Na Google Cloud consola, aceda à página Instâncias de VM.

   Aceder às instâncias de VM

2. Opcional: use a caixa Filtro para restringir o número de instâncias apresentadas.

3. Clique no nome da instância que quer inspecionar.

4. Na secção Rede, verifique o valor de Nível de largura de banda de saída total:

   • TIER_1: as redes de nível 1 estão ativadas.
   • -: as redes de nível 1 não estão ativadas.

gcloud

Para ver a definição networkPerformanceConfig de uma instância, use o comando gcloud compute instances describe. Pode anexar uma opção --format ao comando para restringir as informações devolvidas a campos específicos e alterar a forma como são apresentadas, por exemplo:

gcloud compute instances describe INSTANCE_NAME \
    --zone=ZONE \
    --format="text(name, networkPerformanceConfig)"

Se a rede de nível 1 não estiver configurada para a instância, o campo networkPerformanceConfig não é incluído no resultado. Se a rede de nível 1 estiver ativada para uma instância, o resultado é semelhante ao seguinte:

name:                                              c2-tier1-multinic
networkPerformanceConfig.totalEgressBandwidthTier: TIER_1

REST

Construa um pedido GET para o método instances.get. Ao anexar um parâmetro de consulta $fields ao pedido, pode restringir a saída apenas aos campos name, networkPerformanceConfig e nicType.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME?$fields=name,networkPerformanceConfig,networkInterfaces.nicType

Substitua o seguinte:

• PROJECT_NAME: o nome do projeto que contém a instância
• ZONE: a zona da instância que quer consultar
• INSTANCE_NAME: o nome do recurso de instância a devolver

Se a rede de nível 1 não estiver configurada para a instância, o campo networkPerformanceConfig não é incluído no resultado. Se a rede de nível 1 estiver ativada para uma instância, o resultado é semelhante ao seguinte:

{
  "name": "c2-tier1-multinic",
  "networkInterfaces": [
    {
      "nicType": "GVNIC"
    },
    {
      "nicType": "GVNIC"
    }
  ],
  "networkPerformanceConfig": {
    "totalEgressBandwidthTier": "TIER_1"
  }
}