Gerenciar recursos do Data Transfer Essentials

Nesta página, descrevemos como gerenciar recursos criados usando a Transferência de Dados Básica.

Gerenciar configurações

É possível listar as configurações da Transferência de Dados Básica no seu projeto, verificar o estado de uma configuração, atualizar ou excluir uma.

Listar as configurações em um projeto

Para listar todas as configurações em um local em um projeto, use uma das seguintes maneiras:

gcloud

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

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

Substitua LOCATION pela região da configuração.

API

Use o método multicloudDataTransferConfigs.get.

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

Substitua:

PROJECT_ID: ID do projeto
LOCATION: a região da configuração

Opcionalmente, 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.

Conferir os detalhes de uma configuração

Para conferir os detalhes de uma configuração, use uma das seguintes maneiras:

gcloud

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

gcloud network-connectivity multicloud-data-transfer-configs describe CONFIGURATION_NAME \
    --location=LOCATION

Substitua:

CONFIGURATION_NAME: o nome da configuração
LOCATION: a região da configuração

O exemplo de saída a seguir mostra que o tráfego de compute-engine está pronto para ser considerado para o faturamento da Transferência de Dados Básica. Para cloud-sql e cloud-storage, a atualização está pendente. O valor effectiveTime indica o horário em que o estado deve entrar em vigor. O exemplo também mostra o número total de destinos na configuração e o número de destinos ativos.

description: 'sample config'
destinationsCount: 2
destinationsActiveCount: 0
name: config1
region: https://www.googleapis.com/network-connectivity/v1/projects/my-project/locations/europe-west3
services:
- cloud-sql:
  states:
  - effectiveTime: 2024-12-12T08:00:00Z
    state: DELETING
- cloud-storage:
  states:
  - effectiveTime: 2024-12-12T08:00:00Z
    state: ADDING
- compute-engine:
  states:
  - state: ACTIVE
…

API

Use o método multicloudDataTransferConfigs.list.

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

Substitua:

PROJECT_ID: ID do projeto
LOCATION: a região da configuração
CONFIGURATION_NAME: o nome da configuração

O exemplo de saída a seguir mostra que o tráfego de compute-engine está pronto para ser considerado para o faturamento da Transferência de Dados Básica. Para cloud-storage e cloud-sql, a atualização está pendente. O valor effectiveTime indica o horário em que o estado deve entrar em vigor. O exemplo também mostra o número total de destinos na configuração e o número de destinos ativos.

{
  "multicloudDataTransferConfig": [
    {
      "name": "projects/test-project/locations/europe-west1/multicloudDataTransferConfigs/config1",
      "createTime": "2025-05-14T10:16:22.761275571Z",
      "updateTime": "2025-05-14T10:16:25.872465362Z",
      "etag": "l-WY4OT6hBsMT8sAwEbuSpviLsE9iC_UDJXDyfE265I",
      "description": "sample config",
      "destinationsCount": 1,
      "destinationsActiveCount": 1,
      "services": {
        "cloud-sql": {
          "states": [
            {
              "effectiveTime": "2025-05-29T07:00:00Z",
              "state": "DELETING"
            }
          ]
        },
        "cloud-storage": {
          "states": [
            {
              "effectiveTime": "2025-05-29T07:00:00Z",
              "state": "ADDING"
            }
          ]
        },
        "compute-engine": {
          "states": [
            {
              "state": "ACTIVE"
            }
          ]
        }
      }
    }
  ]
}

O estado de um serviço pode ser um dos seguintes:

ADDING: o serviço está sendo adicionado.
DELETING: o serviço está sendo excluído.
ACTIVE: o serviço está configurado para o faturamento da Transferência de Dados Básica.

Atualizar uma configuração

Para adicionar ou excluir serviços de uma configuração, use uma das seguintes maneiras:

gcloud

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

Para especificar serviços, use uma das seguintes opções:

services: substitui os serviços na configuração pela lista especificada
update-services: adiciona os serviços especificados à configuração
remove-services: remove os serviços especificados da configuração
clear-services: remove todos os serviços da configuração

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

Substitua:

CONFIGURATION_NAME: o nome da configuração que você quer atualizar.
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 que você quer adicionar ou excluir da configuração. Para strings válidas, consulte Serviços e regiões com suporte. Use clear-services para remover todos os serviços da configuração.

API

Use o método multicloudDataTransferConfigs.patch.

PATCH 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: o nome 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 que você quer adicionar ou excluir da configuração. Para strings válidas, consulte Serviços e regiões com suporte.

Além disso, para evitar que um conjunto especificado de campos seja substituído durante uma operação de atualização, use a opção updateMask, que segue o formato fieldMask.

As atualizações nas configurações da Transferência de Dados Básica entram em vigor em aproximadamente 24 horas.

Excluir uma configuração

Só é possível excluir uma configuração depois de excluir todos os destinos associados a ela.

Para excluir uma configuração, use uma das seguintes maneiras:

gcloud

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

gcloud network-connectivity multicloud-data-transfer-configs delete CONFIGURATION_NAME \
    --location=LOCATION

API

Use o multicloudDataTransferConfigs.delete método.

DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME

Gerenciar destinos

É possível listar os destinos da Transferência de Dados Básica no seu projeto, verificar o estado de um destino, atualizar ou excluir um.

Listar os destinos em um projeto

Para listar todos os destinos em um projeto, use uma das seguintes maneiras:

gcloud

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

gcloud network-connectivity multicloud-data-transfer-configs destinations list \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION

Substitua:

CONFIGURATION_NAME: o nome da configuração cujos destinos você quer listar
LOCATION: a região da configuração

API

Use o método multicloudDataTransferConfigs.destinations.list.

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

Substitua:

PROJECT_ID: ID do projeto
LOCATION: a região da configuração
CONFIGURATION_NAME: o nome da configuração cujos destinos você quer listar

Conferir os detalhes de um destino

Para conferir os detalhes de um destino, use uma das seguintes maneiras:

gcloud

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

gcloud network-connectivity multicloud-data-transfer-configs destinations describe DESTINATION_NAME \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION

Substitua:

DESTINATION_NAME: o nome do destino
CONFIGURATION_NAME: o nome da configuração cujo destino você quer conferir
LOCATION: a região da configuração

O exemplo a seguir mostra que o endpoint especificado para destination1 é válido e o destino está sendo adicionado pelo horário indicado por effectiveTime.

createTime: '2025-05-28T13:08:00.171978514Z'
description: 'sample destination'
endpoints:
- asn: 16509
  csp: aws
  state: VALID
etag: tag1
ipPrefix: 203.0.113.0/24
name: projects/test-project/locations/europe-west3/multicloudDataTransferConfig/config1/destinations/destination1
stateTimeline:
  states:
  - effectiveTime: '2025-05-29T07:00:00Z'
    state: ADDING
updateTime: '2025-05-28T13:08:03.431862259Z'
…

API

Use o método multicloudDataTransferConfigs.destinations.get.

GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME

Substitua:

PROJECT_ID: ID do projeto
LOCATION: a região da configuração
CONFIGURATION_NAME: o nome da configuração
DESTINATION_NAME: o nome do destino

O exemplo de saída a seguir mostra que o endpoint especificado para destination1 é válido e o destino está sendo adicionado pelo horário indicado por effectiveTime.

{
  "destination": [
    {
      "name": "projects/test-project/locations/europe-west3/multicloudDataTransferConfig/config1/destinations/destination1",
      "createTime": "2025-05-14T10:18:16.941520739Z",
      "updateTime": "2025-05-14T10:18:20.028116272Z",
      "etag": "tag1",
      "description": "sample destination",
      "ipPrefix": "203.0.113.0/24",
      "endpoints": [
        {
          "asn": 16509,
          "csp": "aws",
          "state": "VALID"
        }
      ],
      "stateTimeline": {
        "states": [
          {
            "state": "ADDING",
            "effectiveTime": "2025-05-29T07:00:00Z"
          }
        ]
      }
    }
  ]
}

Para um destino, o estado pode ser um dos seguintes:

ADDING: o destino está sendo adicionado.
DELETING: o destino está sendo excluído.
SUSPENDING: o destino está sendo suspenso com base na auditoria.
ACTIVE: o destino é considerado para o faturamento da Transferência de Dados Básica.
SUSPENDED: o destino foi excluído ou viola os termos de uso e não será considerado para o faturamento da Transferência de Dados Básica.

Para um endpoint, o estado pode ser um dos seguintes:

VALID: a combinação de valores de ASN e CSP é válida.
INVALID: a combinação de valores de ASN e CSP não é válida.

Se o estado de pelo menos um endpoint for VALID, o destino será considerado qualificado para o faturamento da Transferência de Dados Básica.

Se o estado de todos os endpoints for INVALID, o destino será considerado não qualificado para o faturamento da Transferência de Dados Básica. Nesse caso, o estado do destino é definido como SUSPENDING ou SUSPENDED, dependendo se o estado atual é ADDING ou ACTIVE, respectivamente. O tráfego para esse destino é tratado como tráfego normal da Internet.

Atualizar um destino

Um destino precisa ter pelo menos um endpoint e não pode ter mais de cinco.

Para adicionar ou excluir endpoints de um destino, use uma das seguintes maneiras:

gcloud

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

Para especificar endpoints, use uma das seguintes opções. É possível especificar as flags add-endpoints ou remove-endpoints várias vezes no mesmo comando.

endpoints: substitui os endpoints no destino pela lista especificada
add-endpoints: adiciona os endpoints especificados ao destino
remove-endpoints: remove os endpoints especificados do destino

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

Substitua:

DESTINATION_NAME: o nome do destino.
CONFIGURATION_NAME: o nome da configuração que você quer atualizar.
LOCATION: a região da configuração.
DESCRIPTION: uma descrição do destino e da finalidade dele.
IP_PREFIX: o prefixo de IP do destino especificado como um intervalo ou um valor.
Para cada endpoint, especifique o seguinte:
- ASN: o ASN que deve anunciar o prefixo. Consulte ASNs reconhecidos.
- CSP: uma string que representa o CSP do ASN que está anunciando o prefixo.

API

Use o método multicloudDataTransferConfigs.destinations.patch.

PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME
{
  "description": "DESCRIPTION",
  "ip_prefix": "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: o nome do destino.
DESCRIPTION: uma descrição do destino e da finalidade dele.
IP_PREFIX: o prefixo de 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 de 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 ou remover endpoints que não quer manter no destino:
- ASN: o ASN que deve anunciar o prefixo. Consulte ASNs reconhecidos.
- CSP: uma string que representa o CSP do ASN que está anunciando o prefixo.

Além disso, para evitar que um conjunto especificado de campos seja substituído durante uma operação de atualização, use a opção updateMask, que segue o formato fieldMask.

As atualizações nos destinos da Transferência de Dados Básica e nas configurações relacionadas entram em vigor em aproximadamente 24 horas.

Excluir um destino

Para excluir um destino, use uma das seguintes maneiras:

gcloud

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

gcloud network-connectivity multicloud-data-transfer-configs destinations delete DESTINATION_NAME \
    --multicloud-data-transfer-config=CONFIGURATION_NAME \
    --location=LOCATION

API

Use o multicloudDataTransferConfigs.destinations.delete método.

DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME

Gerenciar recursos do Data Transfer Essentials Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Gerenciar configurações

Listar as configurações em um projeto

gcloud

API

Conferir os detalhes de uma configuração

gcloud

API

Atualizar uma configuração

gcloud

API

Excluir uma configuração

gcloud

API

Gerenciar destinos

Listar os destinos em um projeto

gcloud

API

Conferir os detalhes de um destino

gcloud

API

Atualizar um destino

gcloud

API

Excluir um destino

gcloud

API

Gerenciar recursos do Data Transfer Essentials