Crie recursos essenciais da transferência de dados

Para que o tráfego seja identificado como configurado para a faturação do Data Transfer Essentials, tem de selecionar serviços e associá-los a pontos finais selecionados. Esta página mostra-lhe como criar os recursos essenciais de transferência de dados necessários, 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. Se ainda não o fez, instale a CLI Google Cloud.

  2. Autentique a CLI gcloud com a sua conta:

    gcloud auth login

  3. Defina o projeto:

    gcloud config set project PROJECT_ID

    Substitua PROJECT_ID pelo seu ID do projeto.

  4. Ative a API Network Connectivity no seu projeto.

  5. Configure as autorizações.

  6. Verifique se os serviços que quer selecionar para o Data Transfer Essentials são suportados. Pode configurar o Data Transfer Essentials apenas para serviços e regiões suportados.

    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 Google CloudID da região, por exemplo, europe-west3.

    O exemplo de resultado seguinte mostra que os serviços são elegíveis para serem configurados através do Data Transfer Essentials porque usam níveis suportados.

    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 elegibilidade 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 os Serviços e regiões suportados.

    API

    Use o multicloudDataTransferSupportedServices.get método.

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

    Substitua o seguinte:

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

    O exemplo de resultado seguinte apresenta os serviços elegíveis para serem configurados através do Data Transfer Essentials porque usam níveis suportados.

    {
  "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 elegibilidade 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 o seguinte:

    • PROJECT_ID: o ID do seu projeto.
    • LOCATION: um ID da região, por exemplo, europe-west3. Google Cloud
    • SERVICE1: uma string válida que representa o serviço. Consulte os serviços e as regiões suportados.

  7. Verifique se os números de sistemas autónomos (ASNs) que quer especificar são reconhecidos. Pode configurar o tráfego apenas para destinos que usem ASNs reconhecidos.

Crie uma configuração

Crie uma configuração do Data Transfer Essentials que inclua serviços especificados. Só pode criar uma configuração por região 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 o seguinte:

  • CONFIGURATION_NAME: um nome para a configuração.
  • LOCATION: a região da configuração.
  • DESCRIPTION: uma descrição da configuração e do respetivo objetivo.
  • SERVICE-A,...: uma série de strings que representam os serviços para os quais quer configurar o Data Transfer Essentials. Para ver strings válidas, consulte o artigo Serviços e regiões suportados.

O seguinte comando de exemplo cria uma configuração denominada 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 multicloudDataTransferConfigs.create método.

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

Substitua o seguinte:

  • PROJECT_ID: o ID do seu projeto.
  • LOCATION: a região da configuração.
  • CONFIGURATION_NAME: um nome para a configuração.
  • DESCRIPTION: uma descrição da configuração e do respetivo objetivo.
  • SERVICE-A,...: uma série de strings que representam os serviços para os quais quer configurar o Data Transfer Essentials. Para ver strings válidas, consulte o artigo Serviços e regiões suportados.

Opcionalmente, use o parâmetro de consulta requestID para identificar os seus pedidos de API. Se repetir o pedido, o servidor pode usar o identificador para ignorar um pedido ao qual já foi respondido.

O seguinte fragmento de JSON cria uma configuração denominada 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 demoram até 24 horas a ser criadas. Para verificar o estado da configuração, veja os detalhes da configuração.

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

Antes de tentar criar uma nova configuração, elimine a configuração existente.

Crie 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 existente e um prefixo de IP externo com um ponto final. Um ponto final contém um identificador do fornecedor de serviços na nuvem (CSP) e o respetivo ASN.

Crie um destino de cada 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 o seguinte:

  • DESTINATION_NAME: um nome para o destino. O nome tem de ser exclusivo numa região.
  • CONFIGURATION_NAME: o nome da configuração.
  • LOCATION: a região da configuração.
  • DESCRIPTION: uma descrição do destino e da sua finalidade.

  • 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 tem de ser usado apenas uma vez numa configuração, tem de estar associado a, pelo menos, um ponto final e pode estar associado a um máximo de 5 pontos finais.

  • Especifique as strings correspondentes aos pontos finais que quer adicionar ao destino:

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

    Pode especificar a flag endpoints várias vezes no mesmo comando. Um destino tem de ter, pelo menos, um ponto final e não pode ter mais de cinco pontos finais.

O seguinte comando de exemplo cria um destino denominado destination1 para a configuração config1 na região europe-west3 para o prefixo de IP e o ponto final 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 multicloudDataTransferConfigs.destinations.create método.

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 o seguinte:

  • PROJECT_ID: o ID do seu projeto.
  • LOCATION: a região da configuração.
  • CONFIGURATION_NAME: o nome da configuração.
  • DESTINATION_NAME: um nome para o destino. O nome tem de ser exclusivo numa região.
  • DESCRIPTION: uma descrição do destino e da sua finalidade.

  • 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 tem de ser usado apenas uma vez numa configuração e apenas para um ASN.

  • Especifique as strings correspondentes aos pontos finais que quer adicionar ao destino:

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

    Pode especificar vários pontos finais na mesma chamada. Um destino tem de ter, pelo menos, um ponto final e não pode ter mais de cinco pontos finais.

O seguinte comando de exemplo cria um destino denominado destination1 para a configuração config1 na região europe-west3 para o prefixo de IP e o ponto final 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, veja os detalhes do destino.

Para adicionar ou remover pontos finais, atualize o destino.

Em alternativa, elimine o destino.

O que se segue?