Configurar o acesso a serviços privados

Console

1. No console do Cloud de Confiance , acesse a página Redes VPC.

   Acessar redes VPC

2. Selecione a rede VPC que você quer usar.
3. Selecione a guia Acesso a serviços particulares.
4. Selecione a guia Intervalos de IP alocados para serviços.
5. Clique em Alocar intervalo de IP.
6. Para o Nome do intervalo alocado, especifique google-managed-services-VPC_NETWORK_NAME, em que VPC_NETWORK_NAME é o nome da rede VPC que você está conectando (por exemplo, google-managed-services-default). A Descrição é opcional.
7. Na notação CIDR, selecione a opção Personalizado e insira o intervalo de endereços IP a ser alocado.
8. Clique em Alocar para criar o intervalo alocado.

gcloud

Escolha uma destas opções:

• Para especificar um intervalo de endereços e um tamanho de prefixo (máscara de sub-rede), use os sinalizadores addresses e prefix-length. Por exemplo, para alocar o bloco CIDR 192.168.0.0/16, especifique 192.168.0.0 como endereço e 16 como tamanho de prefixo.

    gcloud compute addresses create google-managed-services-VPC_NETWORK_NAME \
       --global \
       --purpose=VPC_PEERING \
       --addresses=192.168.0.0 \
       --prefix-length=16 \
       --network=projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME
    

• Para especificar apenas um tamanho de prefixo (máscara de sub-rede), use a sinalização prefix-length. Quando você omite o intervalo de endereços,o Cloud de Confianceseleciona automaticamente um intervalo que não está sendo usado na rede VPC. No exemplo a seguir, é selecionado um intervalo de endereços IP não utilizado com um tamanho de prefixo de 16 bits.

  gcloud compute addresses create google-managed-services-VPC_NETWORK_NAME \
    --global \
    --purpose=VPC_PEERING \
    --prefix-length=16 \
    --network=projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME
  

Substitua VPC_NETWORK_NAME pelo nome da sua rede VPC, como my-vpc-network.

O exemplo a seguir aloca um intervalo de IP que permite aos recursos na rede VPC my-vpc-network conectarem-se a instâncias do Cloud SQL usando IP privado.

  gcloud compute addresses create google-managed-services-my-vpc-network \
    --global \
    --purpose=VPC_PEERING \
    --prefix-length=16 \
    --network=projects/myprojectid/global/networks/myvpcnetwork \
    --project=my-project
    

Terraform

Para alocar um intervalo de endereços IP, use um recurso do Terraform.

resource "google_compute_global_address" "private_ip_address" {
  name          = "private-ip-address"
  purpose       = "VPC_PEERING"
  address_type  = "INTERNAL"
  prefix_length = 16
  network       = google_compute_network.peering_network.id
}

Aplique as alterações

Para aplicar a configuração do Terraform em um projeto Cloud de Confiance , siga as etapas nas seções a seguir.

Preparar o Cloud Shell

1. Inicie o Cloud Shell.

2. Defina o projeto padrão do Cloud de Confiance em que você quer aplicar as configurações do Terraform.

   Você só precisa executar esse comando uma vez por projeto, e ele pode ser executado em qualquer diretório.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   As variáveis de ambiente serão substituídas se você definir valores explícitos no arquivo de configuração do Terraform.

Preparar o diretório

Cada arquivo de configuração do Terraform precisa ter o próprio diretório, também chamado de módulo raiz.

1. No Cloud Shell, crie um diretório e um novo arquivo dentro dele. O nome do arquivo precisa ter a extensão .tf, por exemplo, main.tf. Neste tutorial, o arquivo é chamado de main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Se você estiver seguindo um tutorial, poderá copiar o exemplo de código em cada seção ou etapa.

   Copie o exemplo de código no main.tf recém-criado.

   Se preferir, copie o código do GitHub. Isso é recomendado quando o snippet do Terraform faz parte de uma solução de ponta a ponta.

3. Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
4. Salve as alterações.
5. Inicialize o Terraform. Você só precisa fazer isso uma vez por diretório.

   terraform init

   Opcionalmente, para usar a versão mais recente do provedor do Google, inclua a opção -upgrade:

   terraform init -upgrade

Aplique as alterações

1. Revise a configuração e verifique se os recursos que o Terraform vai criar ou atualizar correspondem às suas expectativas:

   terraform plan

   Faça as correções necessárias na configuração.

2. Para aplicar a configuração do Terraform, execute o comando a seguir e digite yes no prompt:

   terraform apply

   Aguarde até que o Terraform exiba a mensagem "Apply complete!".

3. Abra seu projeto do Cloud de Confiance para ver os resultados. No console do Cloud de Confiance , navegue até seus recursos na UI para verificar se foram criados ou atualizados pelo Terraform.

Excluir as alterações

Remova os recursos aplicados anteriormente com a configuração do Terraform executando o seguinte comando e inserindo yes no prompt:

terraform destroy

Console

1. No console do Cloud de Confiance , acesse a página Instâncias do Cloud SQL.

   Acesse "Instâncias do Cloud SQL"

2. Clique em Criar instância.
3. Na seção Personalizar sua instância, expanda Mostrar opções de configuração.
4. Expanda Conexões.
5. Selecione IP privado.
6. Selecione Acesso a serviços particulares (PSA).

   Uma lista suspensa mostra as redes VPC disponíveis no projeto. Se o projeto for o de serviço de uma VPC compartilhada, as redes VPC do projeto host também serão exibidas.

7. Selecione a rede VPC a ser usada.

Se você receber uma mensagem indicando que precisa configurar uma conexão de serviço particular, faça o seguinte:

1. Clique em Configurar conexão.
2. Na seção Alocar um intervalo de IP, selecione uma das seguintes opções:
   • Selecione um ou mais intervalos de IP atuais ou crie um novo no menu suspenso. O menu suspenso inclui intervalos alocados anteriormente, se houver, ou você pode selecionar Alocar um novo intervalo de IP e inserir um novo intervalo e nome.
   • Use um intervalo de IP alocado automaticamente na sua rede..
3. Clique em Continuar.
4. Clique em Criar conexão.
5. Verifique se você vê a mensagem Private service connection for network VPC_NETWORK_NAME has been successfully created.
8. Se quiser, especifique um intervalo de IP alocado para as instâncias usarem nas conexões.
   1. Expanda Mostrar opção de intervalo de IP alocado.
   2. Selecione um intervalo de IP no menu suspenso.
9. Opcional. Para dar permissão a fim de que outros serviços do Cloud de Confiance by S3NS , como o BigQuery, acessem dados no Cloud SQL e façam consultas neles por uma conexão por IP particular, marque Ativar caminho particular.
10. Conclua a configuração da instância.
11. Clique em Criar instância.

gcloud

Antes de criar uma instância usando um endereço IP particular, verifique se o projeto está configurado para acesso a serviços particulares.

Execute os seguintes comandos da CLI gcloud para configurar a rede de acesso a serviços particulares para o Cloud SQL:

1. Ative as APIs necessárias:

   gcloud services enable \
       sqladmin.googleapis.com \
       compute.googleapis.com \
       servicenetworking.googleapis.com \
       --project=PROJECT_ID
       

2. Alocar um intervalo de endereços IP para o peering de rede VPC:

   gcloud compute addresses create google-managed-services-VPC_NETWORK_NAME \
       --global \
       --purpose=VPC_PEERING \
       --prefix-length=16 \
       --network=projects/NETWORK_PROJECT_ID/global/networks/VPC_NETWORK_NAME \
       --project=PROJECT_ID
       

3. Estabeleça a conexão de peering de rede VPC:

   gcloud services vpc-peerings connect \
       --service=servicenetworking.googleapis.com \
       --ranges=google-managed-services-VPC_NETWORK_NAME \
       --network=VPC_NETWORK_NAME \
       --project=PROJECT_ID
       

Antes de usar os dados da solicitação, faça as substituições a seguir:

• INSTANCE_ID: o ID da instância
• PROJECT_ID: o ID do projeto

• NETWORK_PROJECT_ID: o ID do projeto da rede VPC

• VPC_NETWORK_NAME: o nome da rede VPC
• RANGE_NAME: opcional. Se especificado, define um nome de intervalo para o qual um intervalo de IP é alocado. O nome do intervalo precisa estar em conformidade com RFC-1035 e conter de 1 a 63 caracteres.
• REGION_NAME: o nome da região

Como opção, use o parâmetro --enable-google-private-path para permitir que outros serviços do Cloud de Confiance , como o BigQuery, acessem dados no Cloud SQL e façam consultas nesses dados em uma conexão por IP particular. Esse parâmetro só será válido se:

• Use o parâmetro --no-assign-ip.
• Use o parâmetro --network para especificar o nome da rede VPC que você quer usar para criar uma conexão particular.

gcloud beta sql instances create INSTANCE_ID \
  --project=PROJECT_ID \
  --network=projects/NETWORK_PROJECT_ID/global/networks/VPC_NETWORK_NAME \
  --no-assign-ip \
  --allocated-ip-range-name=RANGE_NAME \
  --enable-google-private-path \
  --enforce-new-sql-network-architecture

Terraform

Para configurar o IP privado para uma nova instância, use os seguintes recursos do Terraform:

• google_compute_network
• google_compute_global_address
• google_service_networking_connection
• google_sql_database_instance

resource "google_compute_network" "peering_network" {
  name                    = "private-network"
  auto_create_subnetworks = "false"
}

resource "google_compute_global_address" "private_ip_address" {
  name          = "private-ip-address"
  purpose       = "VPC_PEERING"
  address_type  = "INTERNAL"
  prefix_length = 16
  network       = google_compute_network.peering_network.id
}

resource "google_service_networking_connection" "default" {
  network                 = google_compute_network.peering_network.id
  service                 = "servicenetworking.googleapis.com"
  reserved_peering_ranges = [google_compute_global_address.private_ip_address.name]
}

resource "google_sql_database_instance" "instance" {
  name             = "private-ip-sql-instance"
  region           = "us-central1"
  database_version = "MYSQL_8_0"

  depends_on = [google_service_networking_connection.default]

  settings {
    tier = "db-f1-micro"
    ip_configuration {
      ipv4_enabled    = "false"
      private_network = google_compute_network.peering_network.id
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

resource "google_compute_network_peering_routes_config" "peering_routes" {
  peering              = google_service_networking_connection.default.peering
  network              = google_compute_network.peering_network.name
  import_custom_routes = true
  export_custom_routes = true
}


## Uncomment this block after adding a valid DNS suffix

# resource "google_service_networking_peered_dns_domain" "default" {
#   name       = "example-com"
#   network    = google_compute_network.peering_network.name
#   dns_suffix = "example.com."
#   service    = "servicenetworking.googleapis.com"
# }

Aplique as alterações

Para aplicar a configuração do Terraform em um projeto Cloud de Confiance , siga as etapas nas seções a seguir.

Preparar o Cloud Shell

1. Inicie o Cloud Shell.

2. Defina o projeto padrão do Cloud de Confiance em que você quer aplicar as configurações do Terraform.

   Você só precisa executar esse comando uma vez por projeto, e ele pode ser executado em qualquer diretório.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   As variáveis de ambiente serão substituídas se você definir valores explícitos no arquivo de configuração do Terraform.

Preparar o diretório

Cada arquivo de configuração do Terraform precisa ter o próprio diretório, também chamado de módulo raiz.

1. No Cloud Shell, crie um diretório e um novo arquivo dentro dele. O nome do arquivo precisa ter a extensão .tf, por exemplo, main.tf. Neste tutorial, o arquivo é chamado de main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Se você estiver seguindo um tutorial, poderá copiar o exemplo de código em cada seção ou etapa.

   Copie o exemplo de código no main.tf recém-criado.

   Se preferir, copie o código do GitHub. Isso é recomendado quando o snippet do Terraform faz parte de uma solução de ponta a ponta.

3. Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
4. Salve as alterações.
5. Inicialize o Terraform. Você só precisa fazer isso uma vez por diretório.

   terraform init

   Opcionalmente, para usar a versão mais recente do provedor do Google, inclua a opção -upgrade:

   terraform init -upgrade

Aplique as alterações

1. Revise a configuração e verifique se os recursos que o Terraform vai criar ou atualizar correspondem às suas expectativas:

   terraform plan

   Faça as correções necessárias na configuração.

2. Para aplicar a configuração do Terraform, execute o comando a seguir e digite yes no prompt:

   terraform apply

   Aguarde até que o Terraform exiba a mensagem "Apply complete!".

3. Abra seu Cloud de Confiance projeto para conferir os resultados. No console do Cloud de Confiance , navegue até seus recursos na UI para verificar se foram criados ou atualizados pelo Terraform.

Excluir as alterações

Para excluir as mudanças, faça o seguinte:

1. Para desativar a proteção contra exclusão, no arquivo de configuração do Terraform, defina o argumento deletion_protection como false.

   deletion_protection =  "false"

2. Para aplicar a configuração atualizada do Terraform, execute o comando a seguir e digite yes no prompt:

   terraform apply

3. Remova os recursos aplicados anteriormente com a configuração do Terraform executando o seguinte comando e inserindo yes no prompt:

   terraform destroy

REST v1

Crie uma instância nova com um endereço IP privado:

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• PROJECT_ID:: o ID do projeto
• INSTANCE_ID:: o ID da instância
• VPC_NETWORK_NAME:: especifique o nome da rede de nuvem privada virtual (VPC) que você quer usar para essa instância. O acesso a serviços particulares já precisa estar configurado na rede.
• RANGE_NAME: Opcional. Se especificado, define um nome de intervalo para o qual um intervalo de IP é alocado. O nome do intervalo precisa estar em conformidade com RFC-1035 e conter de 1 a 63 caracteres.
• AUTHORIZED_NETWORKS:: para conexões por IP público, especifique as conexões de redes autorizadas que podem se conectar à instância.

Para o parâmetro ipv4Enabled, defina o valor como true se estiver usando um endereço IP público para a instância ou como false se a instância tiver um endereço IP particular.

Se você definir o parâmetro enablePrivatePathForGoogleCloudServices como true, permitirá que outros serviços do Cloud de Confiance by S3NS , como o BigQuery, acessem dados no Cloud SQL e façam consultas nesses dados em uma conexão por IP particular. Ao definir esse parâmetro como false, outros serviços do Cloud de Confiance by S3NS não podem acessar dados no Cloud SQL por uma conexão por IP particular.

É possível usar o campo sqlNetworkArchitecture para aplicar o uso da nova arquitetura de rede à instância no momento da criação, mesmo que o projeto não tenha sido totalmente atualizado. Para mais detalhes sobre a nova arquitetura de rede e as implicações dela, consulte Fazer upgrade de uma instância para a nova arquitetura de rede e Alocar um intervalo de endereços IP.

Método HTTP e URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

Corpo JSON da solicitação:

{
  "name": "INSTANCE_ID",
  "region": "region",
  "databaseVersion": "database-version",
  "settings": {
    "tier": "machine-type",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
      "allocatedIpRange": "RANGE_NAME"
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      
      "enablePrivatePathForGoogleCloudServices": true
      
    }
  },
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}

Para enviar a solicitação, expanda uma destas opções:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

Você vai receber uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Crie uma instância nova com um endereço IP privado:

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• PROJECT_ID:: o ID do projeto
• INSTANCE_ID:: o ID da instância
• VPC_NETWORK_NAME:: especifique o nome da rede de nuvem privada virtual (VPC) que você quer usar para essa instância. O acesso a serviços particulares já precisa estar configurado na rede.
• RANGE_NAME: Opcional. Se especificado, define um nome de intervalo para o qual um intervalo de IP é alocado. O nome do intervalo precisa estar em conformidade com RFC-1035 e conter de 1 a 63 caracteres.
• AUTHORIZED_NETWORKS:: para conexões por IP público, especifique as conexões de redes autorizadas que podem se conectar à instância.

Para o parâmetro ipv4Enabled, defina o valor como true se estiver usando um endereço IP público para a instância ou como false se a instância tiver um endereço IP particular.

Se você definir o parâmetro enablePrivatePathForGoogleCloudServices como true, permitirá que outros serviços do Cloud de Confiance by S3NS , como o BigQuery, acessem dados no Cloud SQL e façam consultas nesses dados em uma conexão por IP particular. Ao definir esse parâmetro como false, outros serviços do Cloud de Confiance by S3NS não podem acessar dados no Cloud SQL por uma conexão por IP particular.

É possível usar o campo sqlNetworkArchitecture para aplicar o uso da nova arquitetura de rede à instância no momento da criação, mesmo que o projeto não tenha sido totalmente atualizado. Para mais detalhes sobre a nova arquitetura de rede e as implicações dela, consulte Fazer upgrade de uma instância para a nova arquitetura de rede e Alocar um intervalo de endereços IP.

Método HTTP e URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances

Corpo JSON da solicitação:

{
  "name": "INSTANCE_ID",
  "region": "region",
  "databaseVersion": "database-version",
  "settings": {
    "tier": "machine-type",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
      "allocatedIpRange": "RANGE_NAME"
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      
      "enablePrivatePathForGoogleCloudServices": true
      
    }
  },
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}

Para enviar a solicitação, expanda uma destas opções:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

Você vai receber uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Console

1. No console do Cloud de Confiance , acesse a página Instâncias do Cloud SQL.

   Acesse "Instâncias do Cloud SQL"

2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
3. Selecione Conexões no menu de navegação do Cloud SQL.
4. Na guia Rede, marque a caixa de seleção IP particular.

   Uma lista suspensa exibirá as redes disponíveis no projeto.

5. Selecione a rede VPC a ser usada:

Se você vir a mensagem Conexão de serviço particular obrigatória, siga estas instruções:

1. Clique em Configurar conexão.
2. Na seção Alocar um intervalo de IP, escolha uma destas opções:
   • Selecione um ou mais intervalos de IP atuais ou crie um novo no menu suspenso. O menu suspenso inclui intervalos alocados anteriormente, se houver, ou você pode selecionar Alocar um novo intervalo de IP e inserir um novo intervalo e nome.
   • Use um intervalo de IP alocado automaticamente na sua rede.
3. Clique em Continuar.
4. Clique em Criar conexão.
5. Verifique se o status da Conexão de serviço particular da rede VPC_NETWORK_NAME foi criado.
6. Opcional. Para permitir que outros serviços Cloud de Confiance , como o BigQuery, acessem dados no Cloud SQL e façam consultas nesses dados por uma conexão por IP particular, marque a caixa de seleção Ativar caminho particular.
7. Clique em Salvar.

gcloud

Verifique se o projeto está configurado para acesso a serviços particulares.

Atualize a instância do Cloud SQL usando o parâmetro --network para especificar o nome da rede VPC selecionada.

Para aplicar o uso da nova arquitetura de rede à instância ao adicionar uma configuração de rede de IP privado, use a flag --enforce-new-sql-network-architecture. Verifique se você alocou espaço de endereço IP suficiente no intervalo de IP. Quando você usa a aplicação da nova arquitetura de rede antes que um projeto seja totalmente atualizado, pode ocorrer uma falha na criação da instância se não houver espaço de endereço IP suficiente disponível.

Para mais informações, consulte Fazer upgrade de uma instância para a nova arquitetura de rede e Alocar um intervalo de endereços IP.

gcloud beta sql instances patch INSTANCE_ID \
--project=PROJECT_ID \
--network=projects/NETWORK_PROJECT_ID/global/networks/VPC_NETWORK_NAME \
--no-assign-ip \
--enable-google-private-path \
--enforce-new-sql-network-architecture

REST v1

Crie uma instância nova com um endereço IP privado:

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• PROJECT_ID:: o ID do projeto
• INSTANCE_ID:: o ID da instância
• VPC_NETWORK_NAME:: especifique o nome da rede de nuvem privada virtual (VPC) que você quer usar para essa instância. O acesso a serviços particulares já precisa estar configurado na rede.
• RANGE_NAME: Opcional. Se especificado, define um nome de intervalo para o qual um intervalo de IP é alocado. O nome do intervalo precisa estar em conformidade com RFC-1035 e conter de 1 a 63 caracteres.
• AUTHORIZED_NETWORKS:: para conexões por IP público, especifique as conexões de redes autorizadas que podem se conectar à instância.

Para o parâmetro ipv4Enabled, defina o valor como true se estiver usando um endereço IP público para a instância ou como false se a instância tiver um endereço IP particular.

Se você definir o parâmetro enablePrivatePathForGoogleCloudServices como true, permitirá que outros serviços do Cloud de Confiance by S3NS , como o BigQuery, acessem dados no Cloud SQL e façam consultas nesses dados em uma conexão por IP particular. Ao definir esse parâmetro como false, outros serviços do Cloud de Confiance by S3NS não podem acessar dados no Cloud SQL por uma conexão por IP particular.

É possível usar o campo sqlNetworkArchitecture para aplicar o uso da nova arquitetura de rede à instância no momento da criação, mesmo que o projeto não tenha sido totalmente atualizado. Para mais detalhes sobre a nova arquitetura de rede e as implicações dela, consulte Fazer upgrade de uma instância para a nova arquitetura de rede e Alocar um intervalo de endereços IP.

Método HTTP e URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON da solicitação:

{
  "settings":
  {
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
      "allocatedIpRange": "RANGE_NAME"
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      
      "enablePrivatePathForGoogleCloudServices": true
      
    }
  },
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}

Para enviar a solicitação, expanda uma destas opções:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Você vai receber uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Crie uma instância nova com um endereço IP privado:

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• PROJECT_ID:: o ID do projeto
• INSTANCE_ID:: o ID da instância
• VPC_NETWORK_NAME:: especifique o nome da rede de nuvem privada virtual (VPC) que você quer usar para essa instância. O acesso a serviços particulares já precisa estar configurado na rede.
• RANGE_NAME: Opcional. Se especificado, define um nome de intervalo para o qual um intervalo de IP é alocado. O nome do intervalo precisa estar em conformidade com RFC-1035 e conter de 1 a 63 caracteres.
• AUTHORIZED_NETWORKS: para conexões por IP público, especifique as conexões de redes autorizadas que podem se conectar à instância.

Para o parâmetro ipv4Enabled, defina o valor como true se estiver usando um endereço IP público para a instância ou como false se a instância tiver um endereço IP particular.

Se você definir o parâmetro enablePrivatePathForGoogleCloudServices como true, permitirá que outros serviços do Cloud de Confiance by S3NS , como o BigQuery, acessem dados no Cloud SQL e façam consultas nesses dados em uma conexão por IP particular. Ao definir esse parâmetro como false, outros serviços Cloud de Confiance by S3NS não podem acessar dados no Cloud SQL por uma conexão por IP particular.

É possível usar o campo sqlNetworkArchitecture para forçar o uso da nova arquitetura de rede na instância após a criação, mesmo que o projeto não esteja totalmente atualizado. Para mais detalhes sobre a nova arquitetura de rede e as implicações dela, consulte Fazer upgrade de uma instância para a nova arquitetura de rede e Alocar um intervalo de endereços IP.

Método HTTP e URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON da solicitação:

{
  "settings":
  {
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "projects/PROJECT_ID/global/networks/VPC_NETWORK_NAME",
      "allocatedIpRange": "RANGE_NAME"
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      
      "enablePrivatePathForGoogleCloudServices": true
      
    }
  },
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}

Para enviar a solicitação, expanda uma destas opções:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Você vai receber uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}