Esta página foi traduzida pela API Cloud Translation.

Gerenciar recursos do Data Transfer Essentials

Nesta página, descrevemos como gerenciar recursos criados com o Data Transfer Essentials.

Gerenciar configurações

É possível listar, verificar o estado, atualizar ou excluir as configurações do Data Transfer Essentials no seu projeto.

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 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 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

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.

Ver os detalhes de uma configuração

Para conferir os detalhes de uma configuração, use uma das seguintes opções:

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 no faturamento do Data Transfer Essentials. Para cloud-sql e cloud-storage, a atualização está pendente. O valor effectiveTime indica o momento em que o estado deve entrar em vigor. A amostra 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 no faturamento do Data Transfer Essentials. Para cloud-storage e cloud-sql, a atualização está pendente. O valor effectiveTime indica o momento em que o estado deve entrar em vigor. A amostra 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 do Data Transfer Essentials.

Atualizar uma configuração

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

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:

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 conferir strings válidas, consulte Serviços e regiões compatíveis. Use clear-services para remover todos os serviços da configuração.

API

Use o método multicloudDataTransferConfigs.update.

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 conferir strings válidas, consulte Serviços e regiões compatíveis.

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 do Data Transfer Essentials 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 método multicloudDataTransferConfigs.delete.

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

Gerenciar destinos

É possível listar os destinos do Data Transfer Essentials no seu projeto, verificar o estado de um destino, atualizar ou excluir um destino.

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 opções:

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 de que você quer ver o destino.
LOCATION: a região da configuração

A amostra a seguir mostra que o endpoint especificado para destination1 é válido e que o destino está sendo 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 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 até o 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 do Data Transfer Essentials.
SUSPENDED: o destino foi excluído ou viola os termos de uso e não será considerado para o faturamento do Data Transfer Essentials.

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 um endpoint for VALID, o destino será considerado qualificado para o faturamento do Data Transfer Essentials.

Se o estado de todos os endpoints for INVALID, o destino será considerado não qualificado para o faturamento do Data Transfer Essentials. 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 comando gcloud network-connectivity multicloud-data-transfer-configs destinations update.

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 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.update.

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 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 ou remova os 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 do Data Transfer Essentials e nas configurações relacionadas levam aproximadamente 24 horas para entrar em vigor.

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 método multicloudDataTransferConfigs.destinations.delete.

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

Ver 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