Faça a gestão dos recursos do Data Transfer Essentials

Esta página descreve como gerir os recursos criados através do Data Transfer Essentials.

Faça a gestão das configurações

Pode listar as configurações do Data Transfer Essentials no seu projeto, verificar o estado de uma configuração, atualizá-la ou eliminá-la.

Apresenta as configurações de um projeto

Para apresentar uma lista de todas as configurações numa localização num projeto, use uma das seguintes formas:

gcloud

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

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

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

API

Use o multicloudDataTransferConfigs.get método.

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

Substitua o seguinte:

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

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.

Veja os detalhes de uma configuração

Para ver os detalhes de uma configuração, use uma das seguintes formas:

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

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

O exemplo de saída seguinte mostra que o tráfego de compute-engine está pronto para ser considerado para a faturação do Data Transfer Essentials. Para cloud-sql e cloud-storage, a atualização está pendente. O valor effectiveTime indica a hora em que se espera que o estado entre 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 multicloudDataTransferConfigs.list método.

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

Substitua o seguinte:

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

O exemplo de saída seguinte mostra que o tráfego de compute-engine está pronto para ser considerado para a faturação do Data Transfer Essentials. Para cloud-storage e cloud-sql, a atualização está pendente. O valor effectiveTime indica a hora em que se espera que o estado entre em vigor. O exemplo também mostra o número total de destinos na configuração e o número de destinos que estão 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á a ser adicionado.
  • DELETING: o serviço está a ser eliminado.
  • ACTIVE: o serviço está configurado para a faturação do Data Transfer Essentials.

Atualize uma configuração

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

gcloud

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

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

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

API

Use o multicloudDataTransferConfigs.update método.

PATCH 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: o nome 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 que quer adicionar ou eliminar da configuração. Para ver strings válidas, consulte o artigo Serviços e regiões suportados.

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

As atualizações às configurações do Data Transfer Essentials entram em vigor em aproximadamente 24 horas.

Elimine uma configuração

Só pode eliminar uma configuração depois de eliminar todos os destinos associados à mesma.

Para eliminar uma configuração, use uma das seguintes formas:

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

Faça a gestão dos destinos

Pode listar os destinos do Data Transfer Essentials no seu projeto, verificar o estado de um destino, atualizar um destino ou eliminá-lo.

Apresenta os destinos num projeto

Para apresentar uma lista de todos os destinos num projeto, use uma das seguintes formas:

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

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

API

Use o multicloudDataTransferConfigs.destinations.list método.

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

Substitua o seguinte:

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

Veja os detalhes de um destino

Para ver os detalhes de um destino, use uma das seguintes formas:

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

  • DESTINATION_NAME: o nome do destino
  • CONFIGURATION_NAME: o nome da configuração cujo destino quer ver
  • LOCATION: a região da configuração

O exemplo seguinte mostra que o ponto final especificado para destination1 é válido e que o destino está a ser adicionado no momento 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 multicloudDataTransferConfigs.destinations.get método.

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

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: o nome do destino

O seguinte resultado de exemplo mostra que o ponto final especificado para destination1 é válido e o destino está a ser adicionado no momento 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á a ser adicionado.
  • DELETING: o destino está a ser eliminado.
  • SUSPENDING: o destino está a ser suspenso com base na auditoria.
  • ACTIVE: o destino é considerado para a faturação do Data Transfer Essentials.
  • SUSPENDED: o destino foi eliminado ou viola os termos de utilização e não vai ser considerado para a faturação do Data Transfer Essentials.

Para um ponto final, o estado pode ser um dos seguintes:

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

Se o estado de, pelo menos, um ponto final for VALID, o destino é considerado elegível para a faturação do Data Transfer Essentials.

Se o estado de todos os pontos finais for INVALID, considera-se que o destino não é elegível para a faturação do Data Transfer Essentials. Neste caso, o estado do destino é definido como SUSPENDING ou SUSPENDED, consoante o estado atual seja ADDING ou ACTIVE, respetivamente. O tráfego para esse destino é tratado como tráfego normal da Internet.

Atualize um destino

Um destino tem de ter, pelo menos, um ponto final e não pode ter mais de cinco pontos finais.

Para adicionar ou eliminar pontos finais de um destino, use uma das seguintes formas:

gcloud

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

Para especificar pontos finais, use uma das seguintes opções. Pode especificar as flags add-endpoints ou remove-endpoints várias vezes no mesmo comando.

  • endpoints: substitui os pontos finais no destino pela lista especificada
  • add-endpoints: adiciona os pontos finais especificados ao destino
  • remove-endpoints: remove os pontos finais 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 o seguinte:

  • DESTINATION_NAME: o nome do destino.
  • CONFIGURATION_NAME: o nome da configuração que quer atualizar.
  • 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 ou um valor.

  • Para cada ponto final, especifique o seguinte:

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

API

Use o multicloudDataTransferConfigs.destinations.update método.

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 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: o nome do destino.
  • 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 strings correspondentes a pontos finais que quer adicionar ao destino ou remover pontos finais que não quer manter no destino:

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

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

As atualizações aos destinos do Data Transfer Essentials e às configurações relacionadas entram em vigor em aproximadamente 24 horas.

Elimine um destino

Para eliminar um destino, use uma das seguintes formas:

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