Criar recursos dos Conceitos básicos da Transferência de dados

Para que o tráfego seja identificado como configurado para o faturamento do Data Transfer Essentials, é necessário selecionar serviços e associá-los a endpoints selecionados. Nesta página, mostramos como criar os recursos necessários do Data Transfer Essentials, que são configurações e destinos.

Antes de começar

Antes de criar configurações ou destinos do Data Transfer Essentials, faça o seguinte:

  1. Instale a Google Cloud CLI, caso ainda não tenha feito isso.

  2. Autentique a CLI gcloud com sua conta:

    gcloud auth login

  3. Definir o projeto:

    gcloud config set project PROJECT_ID

    Substitua PROJECT_ID pelo ID do projeto.

  4. Ative a API Network Connectivity no projeto.

  5. Configure as permissões.

  6. Verifique se os serviços que você quer selecionar para o Data Transfer Essentials são compatíveis. É possível configurar o Data Transfer Essentials apenas para serviços e regiões compatíveis.

    gcloud

    Use o comando gcloud network-connectivity multicloud-data-transfer-supported-services list.

    gcloud network-connectivity multicloud-data-transfer-supported-services list \
    --location=LOCATION

    Substitua LOCATION por um ID da região Google Cloud, por exemplo, europe-west3.

    O exemplo de saída a seguir mostra que os serviços estão qualificados para serem configurados usando o Data Transfer Essentials porque usam níveis compatíveis.

    NAME                   SERVICE_CONFIGS
cloud-sql              [{'eligibilityCriteria': 'NETWORK_SERVICE_TIER_PREMIUM_ONLY'}]
cloud-storage          [{'eligibilityCriteria': 'REQUEST_ENDPOINT_REGIONAL_ENDPOINT_ONLY'}]
compute-engine         [{'eligibilityCriteria': 'NETWORK_SERVICE_TIER_STANDARD_ONLY'}]

    Para verificar a qualificação de um serviço específico, use o comando gcloud network-connectivity multicloud-data-transfer-supported-services describe.

    gcloud network-connectivity multicloud-data-transfer-supported-services describe SERVICE1 \
    --location=LOCATION

    Substitua SERVICE1 por uma string válida que represente o serviço. Consulte Serviços e regiões compatíveis.

    API

    Use o método multicloudDataTransferSupportedServices.get.

    GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:getMulticloudDataTransferSupportedServices

    Substitua:

    • PROJECT_ID: ID do projeto
    • LOCATION: um ID de região Google Cloud , por exemplo, europe-west3

    O exemplo de saída a seguir lista os serviços que podem ser configurados usando o Data Transfer Essentials porque usam níveis compatíveis.

    {
  "multicloudDataTransferSupportedServices": [
    {
      "name": "cloud-sql",
      "serviceConfigs": [
        {
          "eligibilityCriteria": "NETWORK_SERVICE_TIER_PREMIUM_ONLY"
        }
      ]
    },
    {
      "name": "cloud-storage",
      "serviceConfigs": [
        {
          "eligibilityCriteria": "REQUEST_ENDPOINT_REGIONAL_ENDPOINT_ONLY"
        }
      ]
    },
    {
      "name": "compute-engine",
      "serviceConfigs": [
        {
          "eligibilityCriteria": "NETWORK_SERVICE_TIER_STANDARD_ONLY"
        }
      ]
    }
  ]
}

    Para verificar a qualificação de um serviço específico, use o seguinte método:

    GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:getMulticloudDataTransferSupportedServices
{
"service": "SERVICE1"
}

    Substitua:

    • PROJECT_ID: ID do projeto.
    • LOCATION: um ID de região Google Cloud , por exemplo, europe-west3.
    • SERVICE1: uma string válida que representa o serviço. Consulte Serviços e regiões compatíveis.

  7. Verifique se os números de sistema autônomo (ASNs) que você quer especificar são reconhecidos. É possível configurar o tráfego apenas para destinos que usam ASNs reconhecidos.

Criar uma configuração

Crie uma configuração do Data Transfer Essentials que inclua os serviços especificados. Só é possível criar uma configuração por região e por projeto.

gcloud

Use o comando gcloud network-connectivity multicloud-data-transfer-configs create.

gcloud network-connectivity multicloud-data-transfer-configs create CONFIGURATION_NAME \
    --location=LOCATION \
    --description=DESCRIPTION \
    --services=SERVICE-A,...

Substitua:

  • CONFIGURATION_NAME: um nome para a configuração.
  • LOCATION: a região da configuração.
  • DESCRIPTION: uma descrição da configuração e da finalidade dela.
  • SERVICE-A,...: uma série de strings que representam os serviços para os quais você quer configurar o Data Transfer Essentials. Para conferir strings válidas, consulte Serviços e regiões compatíveis.

O comando de exemplo a seguir cria uma configuração chamada config1 na região europe-west3 para os serviços compute-engine, cloud-storage e cloud-sql.

gcloud network-connectivity multicloud-data-transfer-configs create config1 \
    --location=europe-west3 \
    --description="configuration for europe-west3" \
    --services=compute-engine,cloud-storage,cloud-sql

API

Use o método multicloudDataTransferConfigs.create.

POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME
{
  "description": "DESCRIPTION",
  "services": {
    "SERVICE-A",
    "SERVICE-B"
  }
}

Substitua:

  • PROJECT_ID: ID do projeto.
  • LOCATION: a região da configuração.
  • CONFIGURATION_NAME: um nome para a configuração.
  • DESCRIPTION: uma descrição da configuração e da finalidade dela.
  • SERVICE-A,...: uma série de strings que representam os serviços para os quais você quer configurar o Data Transfer Essentials. Para conferir strings válidas, consulte Serviços e regiões compatíveis.

Se quiser, use o parâmetro de consulta requestID para identificar suas solicitações de API. Se você repetir a solicitação, o servidor poderá usar o identificador para ignorar uma solicitação que já foi respondida.

O snippet JSON a seguir cria uma configuração chamada config1 na região europe-west3 para os serviços compute-engine, cloud-storage e cloud-sql.

POST https://networkconnectivity.googleapis.com/v1/projects/my-project/locations/europe-west3/multicloudDataTransferConfigs/config1
{
  "description": "configuration for europe-west3",
  "services": {
    "compute-engine": {},
    "cloud-storage": {},
    "cloud-sql": {}
}

As configurações do Data Transfer Essentials levam até 24 horas para serem criadas. Para verificar o estado da configuração, confira os detalhes dela.

Para adicionar ou remover serviços, atualize uma configuração.

Antes de tentar criar uma nova configuração, exclua a configuração atual.

Criar um destino para a configuração

Crie um destino para a configuração do Data Transfer Essentials. Um recurso de destino cria uma associação entre uma configuração atual e um prefixo de IP externo com um endpoint. Um endpoint contém um identificador de provedor de serviços de nuvem (CSP) e o ASN dele.

Crie um destino por vez.

gcloud

Use o comando gcloud network-connectivity multicloud-data-transfer-configs destinations create.

gcloud network-connectivity multicloud-data-transfer-configs destinations create DESTINATION_NAME \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION \
    --description=DESCRIPTION \
    --ip-prefix=IP_PREFIX \
    --endpoints=asn=ASN,csp=CSP

Substitua:

  • DESTINATION_NAME: um nome para o destino. O nome precisa ser exclusivo em uma região.
  • CONFIGURATION_NAME: o nome da configuração.
  • LOCATION: a região da configuração.
  • DESCRIPTION: uma descrição do destino e da finalidade dele.

  • IP_PREFIX: o prefixo IP do destino especificado como um intervalo (por exemplo, 203.0.113.0/24 ou 2001:db8::/32) ou um valor (por exemplo, 203.0.113.6 ou 2001:db8:2:2:2:2:2:2). Um prefixo IP precisa ser usado apenas uma vez em uma configuração, associado a pelo menos um endpoint e pode ser associado a até cinco endpoints.

  • Especifique strings correspondentes aos endpoints que você quer adicionar ao destino:

    • ASN: o ASN esperado para anunciar o prefixo. Consulte ASNs reconhecidos.
    • CSP: uma string que representa o CSP do ASN que está anunciando o prefixo.

    É possível especificar a flag endpoints várias vezes no mesmo comando. Um destino precisa ter pelo menos um endpoint e não pode ter mais de cinco.

O comando de exemplo a seguir cria um destino chamado destination1 para a configuração config1 na região europe-west3 para o prefixo de IP e o endpoint especificados.

gcloud network-connectivity multicloud-data-transfer-configs destinations create destination1 \
    --multicloud-data-transfer-config=config1 \
    --location=europe-west3 \
    --description="destination1 for config1" \
    --ip-prefix=203.0.113.0/24 \
    --endpoints=asn=16509,csp="aws"

API

Use o método multicloudDataTransferConfigs.destinations.create.

POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME
{
  "description": "DESCRIPTION",
  "ipPrefix": "IP_PREFIX",
  "endpoints": [
    {
      "asn": "ASN",
      "csp": "CSP"
    }
  ]
}

Substitua:

  • PROJECT_ID: ID do projeto.
  • LOCATION: a região da configuração.
  • CONFIGURATION_NAME: o nome da configuração.
  • DESTINATION_NAME: um nome para o destino. O nome precisa ser exclusivo em uma região.
  • DESCRIPTION: uma descrição do destino e da finalidade dele.

  • IP_PREFIX: o prefixo IP do destino especificado como um intervalo (por exemplo, 203.0.113.0/24 ou 2001:db8::/32) ou um valor (por exemplo, 203.0.113.6 ou 2001:db8:2:2:2:2:2:2). Um prefixo IP precisa ser usado apenas uma vez em uma configuração e para apenas um ASN.

  • Especifique strings correspondentes aos endpoints que você quer adicionar ao destino:

    • ASN: o ASN esperado para anunciar o prefixo. Consulte ASNs reconhecidos.
    • CSP: uma string que representa o CSP do ASN que está anunciando o prefixo.

    É possível especificar vários endpoints na mesma chamada. Um destino precisa ter pelo menos um endpoint e não pode ter mais de cinco.

O comando de exemplo a seguir cria um destino chamado destination1 para a configuração config1 na região europe-west3 para o prefixo de IP e o endpoint especificados.

POST https://networkconnectivity.googleapis.com/v1/projects/my-project/locations/europe-west3/multicloudDataTransferConfigs/config1/destinations/destination1
{
  "description": "destination1 for config1",
  "ipPrefix": "203.0.113.0/24",
  "endpoints": [
    {
      "asn": "16509",
      "csp": "aws"
    }
  ]
}

Para verificar o estado do destino, confira os detalhes dele.

Para adicionar ou remover endpoints, atualize o destino.

Como alternativa, exclua o destino.

A seguir