Esta página descreve como editar uma instância do Cloud SQL.
Depois de criada, as configurações de uma instância podem ser editadas para alterar as configurações dela. Para informações sobre configurações de instância e como a alteração de configurações pode afetá-la, consulte Configurações da instância.
Integre o Cloud SQL para SQL Server ao Serviço Gerenciado para Microsoft Active Directory (Microsoft AD gerenciado). Essa integração inclui recursos para mesclar e sair de um domínio do Microsoft AD gerenciado no nível por instância. Para mais informações, consulte a Visão geral do Microsoft AD gerenciado no Cloud SQL.
Também é possível ativar ou desativar a auditoria do banco de dados.
Editar uma instância
A maioria das edições só pode ser aplicada a uma instância quando ela está em execução.
Console
-
No console do Google Cloud , acesse a página Instâncias do Cloud SQL.
- Para abrir a página Visão geral de uma instância, clique no nome dela.
- Clique em Editar.
- Na seção Personalizar a instância, se o menu Mostrar opções de configuração for exibido, clique nele.
Atualize as configurações editáveis da instância.
Saiba mais sobre configurações de instância.
- Clique em Salvar.
gcloud
Esse comando modifica o horário de início do backup.
gcloud sql instances patch INSTANCE_NAME \ --backup-start-time 16:00
Se um patch modificar um valor que requer reinicialização, você verá uma solicitação para prosseguir com a mudança ou cancelar.
Para saber mais sobre as sinalizações de configuração da instância, consulte gcloud sql instances patch.
REST v1
Use esse comando para modificar o horário de início do backup.
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
- PRIVATE_NETWORK: a rede que você está adicionando ou selecionando para criar uma conexão particular
Método HTTP e URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
Corpo JSON da solicitação:
{
"settings": {
"backupConfiguration": {
"startTime": "16:00",
"enabled": true,
"binaryLogEnabled": true
}
}
"ipConfiguration": {
"privateNetwork": "PRIVATE_NETWORK",
"authorizedNetworks": [],
"ipv4Enabled": false,
}
}
Para enviar a solicitação, expanda uma destas opções:
Você 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-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
Se um patch modificar um valor que requer reinicialização, você verá uma solicitação para prosseguir com a mudança ou cancelar.
Para ver como a solicitação da API REST subjacente (em inglês) é criada nesta tarefa, consulte APIs Explorer na página "instances:patch" (em inglês).REST v1beta4
Use esse comando para modificar o horário de início do backup.
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
- PRIVATE_NETWORK: a rede que você está adicionando ou selecionando para criar uma conexão particular
Método HTTP e URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
Corpo JSON da solicitação:
{
"settings": {
"backupConfiguration": {
"startTime": "16:00",
"enabled": true,
"binaryLogEnabled": true
}
}
"ipConfiguration": {
"privateNetwork": "PRIVATE_NETWORK",
"authorizedNetworks": [],
"ipv4Enabled": false,
}
}Para enviar a solicitação, expanda uma destas opções:
Você 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-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
Se o patch modificar um valor que requer reinicialização, você verá uma solicitação para prosseguir com a mudança ou cancelar.
Para ver como a solicitação da API REST subjacente (em inglês) é criada nesta tarefa, consulte APIs Explorer na página "instances:patch" (em inglês).Editar uma instância com o Private Service Connect ativado
É possível atualizar uma instância com o Private Service Connect ativado usando a CLI gcloud ou a API. Por exemplo, você pode atualizar projetos associados a instâncias para as seguintes finalidades:
- Para permitir conexões dos endpoints do Private Service Connect com as instâncias do Cloud SQL.
- Para todas as criações, clones e ativações do Private Service Connect de instâncias do Cloud SQL em agosto de 2026 e depois, o comportamento de reconciliação de conexão é ativado por padrão e não pode ser desativado. Quando você remove um projeto da lista de projetos permitidos, todas as conexões do Private Service Connect do projeto removido são imediatamente encerradas (reconciliadas). Isso significa que os aplicativos que usam endpoints do Private Service Connect nesses projetos removidos não podem continuar se conectando usando esses endpoints. Para instâncias criadas antes de agosto de 2026, quando você remove um projeto da lista de projetos permitidos, os aplicativos que usam endpoints do Private Service Connect nesses projetos removidos continuam se conectando até que você remova manualmente esses endpoints.
gcloud
Para atualizar projetos que podem usar o Private Service Connect, use o comando gcloud sql instances patch:
gcloud sql instances patch INSTANCE_NAME \ --project=PROJECT_ID \ --allowed-psc-projects=ALLOWED_PROJECTS
Faça as seguintes substituições:
- INSTANCE_NAME: o nome da instância do Cloud SQL a que os endpoints do Private Service Connect em redes VPC podem se conectar.
- PROJECT_ID: o ID ou número do projeto do Google Cloud projeto que contém a instância a que os endpoints do Private Service Connect nas redes VPC podem se conectar.
- ALLOWED_PROJECTS: uma lista de IDs ou números de projetos permitidos, separados por vírgulas. Eles substituem os projetos que já estão configurados para usar o Private Service Connect. Se um projeto não estiver na lista, não será possível usá-lo para criar uma instância e ativar o Private Service Connect para ele.
O exemplo a seguir permite que dois projetos (98765 e 87654) estabeleçam conexões de endpoints do Private Service Connect com a instância myinstance do Cloud SQL contida no projeto 12345:
gcloud sql instances patch myinstance \ --project=12345 \ --allowed-psc-projects='98765','87654'
Para remover todos os projetos permitidos, use o comando gcloud sql instances patch e a flag --clear-allowed-psc-projects:
gcloud sql instances patch INSTANCE_NAME \ --project=PROJECT_ID \ --clear-allowed-psc-projects
Essa sinalização garante que nenhum projeto seja permitido acidentalmente.
REST v1
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- PROJECT_ID: o ID ou número do projeto do Google Cloud projeto que contém a instância a que os endpoints do Private Service Connect nas redes VPC podem se conectar.
- INSTANCE_NAME: o nome da instância do Cloud SQL a que os endpoints do Private Service Connect em redes VPC podem se conectar.
- ALLOWED_PROJECTS: uma lista de IDs ou números de projetos permitidos, separados por vírgulas. Eles substituem os projetos que já estão configurados para usar o Private Service Connect. Se um projeto não estiver na lista, não será possível usá-lo para criar uma instância e ativar o Private Service Connect para ele.
Método HTTP e URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME
Corpo JSON da solicitação:
{
"kind": "sql#instance",
"name": "INSTANCE_NAME",
"project": "PROJECT_ID",
"settings": {
"ipConfiguration": {
"pscConfig": {
"allowedConsumerProjects": [ALLOWED_PROJECTS]
}
},
"kind": "sql#settings"
}
}
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_NAME",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
Para remover todos os projetos permitidos, use a flag clear-allowed-psc-projects. Essa sinalização garante que nenhum projeto seja permitido acidentalmente.
REST v1beta4
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- PROJECT_ID: o ID ou número do projeto do Google Cloud projeto que contém a instância a que os endpoints do Private Service Connect nas redes VPC podem se conectar.
- INSTANCE_NAME: o nome da instância do Cloud SQL a que os endpoints do Private Service Connect em redes VPC podem se conectar.
- ALLOWED_PROJECTS: uma lista de IDs ou números de projetos permitidos, separados por vírgulas. Eles substituem os projetos que já estão configurados para usar o Private Service Connect. Se um projeto não estiver na lista, não será possível usá-lo para criar uma instância e ativar o Private Service Connect para ele.
Método HTTP e URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME
Corpo JSON da solicitação:
{
"kind": "sql#instance",
"name": "INSTANCE_NAME",
"project": "PROJECT_ID",
"settings": {
"ipConfiguration": {
"pscConfig": {
"allowedConsumerProjects": [ALLOWED_PROJECTS]
}
},
"kind": "sql#settings"
}
}
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_NAME",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
Para remover todos os projetos permitidos, use a flag clear-allowed-psc-projects. Essa sinalização garante que nenhum projeto seja permitido acidentalmente.
Editar o modo de AC do servidor para uma instância
É possível alterar o modo de autoridade certificadora (AC) do servidor
de uma instância para usar a AC compartilhada (GOOGLE_MANAGED_CAS_CA) ou a
AC gerenciada pelo cliente (CUSTOMER_MANAGED_CAS_CA).
Não é possível mudar uma instância para usar a opção de AC por instância (GOOGLE_MANAGED_INTERNAL_CA),
que é a configuração padrão.
Para mais informações sobre as diferentes opções de modo de CA do servidor, consulte Hierarquias de autoridade certificadora (CA).
Antes de atualizar uma instância para usar uma CA compartilhada ou gerenciada pelo cliente, faça o seguinte:
- Confira a lista de serviços do Google Cloud que não são compatíveis com conexões com instâncias do Cloud SQL configuradas para usar uma CA compartilhada ou gerenciada pelo cliente. Se a implantação precisar usar o serviço, talvez seja necessário atrasar a atualização.
- Se você estiver usando o proxy de autenticação do Cloud SQL ou qualquer um dos conectores de linguagem do Cloud SQL para se conectar à instância, verifique se eles estão executando as versões mínimas necessárias. Para CA compartilhada, use o proxy de autenticação do Cloud SQL versão 2.13.0 ou mais recente. Para CA gerenciada pelo cliente, use o proxy de autenticação do Cloud SQL versão 2.14.3 ou mais recente. Para saber as versões mínimas necessárias dos conectores de linguagem do Cloud SQL, consulte Requisitos dos conectores de linguagem do Cloud SQL.
- Se você estiver mudando para a CA compartilhada, faça o download dos pacotes de CA globais e regionais, copie-os para os clientes do banco de dados e permita que eles confiem nessas CAs. Configurar os certificados antes de mudar a configuração do modo de CA do servidor pode ajudar a evitar possíveis interrupções para os clientes do banco de dados.
- Se você estiver mudando para a AC gerenciada pelo cliente, faça o seguinte:
- Verifique se você já criou um pool de CAs e concedeu à conta de serviço acesso ao pool de CAs.
- Verifique se há pelo menos uma CA no pool de CAs.
- Para evitar interrupções após a atualização, faça o download dos certificados da CA gerenciada pelo cliente e configure os clientes do banco de dados para confiar na CA.
Console
-
No console do Google Cloud , acesse a página Instâncias do Cloud SQL.
- Para abrir a página Visão geral de uma instância, clique no nome dela.
- Clique em Editar.
- Na seção Personalizar sua instância, expanda Mostrar opções de configuração.
- Clique em Segurança.
- Na seção Modo de autoridade certificadora do servidor, selecione Autoridade certificadora CAS gerenciada pelo Google.
- Opcional: para ativar a rotação automática dos certificados do servidor, marque a caixa de seleção Fazer a rotação de certificados do servidor automaticamente.
- Clique em Salvar.
Para atualizar sua instância de uma AC por instância ou compartilhada para uma AC gerenciada pelo cliente, consulte Usar uma AC gerenciada pelo cliente.
gcloud
Para atualizar sua instância de uma CA por instância para uma CA compartilhada, execute o seguinte comando:
gcloud sql instances patch INSTANCE_NAME \ --server-ca-mode=GOOGLE_MANAGED_CAS_CA
Substitua INSTANCE_NAME: o nome da instância do Cloud SQL
que você quer corrigir.
Para a flag --server-ca-mode, especifique GOOGLE_MANAGED_CAS_CA.
Para atualizar sua instância de uma AC por instância ou compartilhada para uma AC gerenciada pelo cliente, consulte Usar uma AC gerenciada pelo cliente.
REST
Para atualizar sua instância de uma CA por instância para uma CA compartilhada,
use o método instances.patch
e especifique as seguintes propriedades:
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_IDpelo ID do projeto em que a instância do Cloud SQL está.INSTANCE_IDpelo nome da instância do Cloud SQL que você quer corrigir.
Método HTTP e URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
Corpo JSON da solicitação:
{
"settings":{
"ipConfiguration":
{
"serverCaMode": "GOOGLE_MANAGED_CAS_CA"
}
}
}
Para enviar a solicitação, expanda uma destas opções:
Você 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": "2025-01-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
Para atualizar sua instância de uma AC por instância ou compartilhada para uma AC gerenciada pelo cliente, consulte Usar uma AC gerenciada pelo cliente.
Editar uma SAN personalizada para uma instância
Se você quiser usar um nome DNS personalizado para se conectar a uma instância do Cloud SQL em vez de um endereço IP, defina a configuração de nome alternativo do sujeito (SAN, na sigla em inglês) personalizado ao criar a instância. O nome DNS personalizado que você insere na configuração de SAN personalizada é adicionado ao campo SAN do certificado do servidor da instância. Isso permite que você use o nome DNS personalizado com a validação do nome do host de forma segura.
É possível realizar as seguintes operações com um SAN personalizado para um certificado de servidor de uma instância:
- Adicione nomes de DNS à instância: adicione uma lista separada por vírgulas de até três nomes de DNS personalizados à configuração de SAN personalizada. O Cloud SQL adiciona esses nomes ao campo SAN do certificado do servidor. É possível proteger vários nomes de DNS com um único certificado.
- Modificar os nomes de DNS da instância: mude os nomes de DNS personalizados que você quer adicionar ao campo SAN do certificado do servidor da instância.
- Remover nomes DNS da instância: remova todos os nomes DNS personalizados do campo SAN do certificado do servidor da instância.
É possível editar um SAN personalizado para uma instância usando a CLI gcloud ou a API.
gcloud
Para editar um SAN personalizado para uma instância, use o comando gcloud sql instances patch:
gcloud sql instances patch INSTANCE_NAME \ --project=PROJECT_ID \ --custom-subject-alternative-names=DNS_NAMES
Faça as seguintes substituições:
- INSTANCE_NAME: o nome da instância do Cloud SQL que tem um certificado de servidor ao qual você está adicionando, modificando ou removendo nomes de DNS
- PROJECT_ID: o ID ou número do projeto do Google Cloud projeto que contém a instância
- DNS_NAMES: uma lista separada por vírgulas de até três nomes DNS que você está adicionando ao certificado do servidor da sua instância.
Para remover todos os nomes DNS do certificado do servidor de uma instância do Cloud SQL, use o comando gcloud sql instances patch e a flag --clear-custom-subject-alternative-names:
gcloud sql instances patch INSTANCE_NAME \ --project=PROJECT_ID \ --clear-custom-subject-alternative-names
Essa flag garante que nenhum nome DNS seja adicionado ao certificado acidentalmente.
REST
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- PROJECT_ID: o ID ou o número do projeto do Google Cloud . Este projeto contém uma instância do Cloud SQL com um certificado do servidor em que você está adicionando, modificando ou removendo nomes de DNS.
- INSTANCE_NAME: o nome da instância.
DNS_NAMES: uma lista separada por vírgulas de até três nomes DNS que você está adicionando ao certificado do servidor da sua instância.
Se você já tiver nomes DNS adicionados ao certificado e usar esse parâmetro para especificar nomes DNS diferentes, o Cloud SQL vai remover os nomes DNS originais do certificado.
Se você não especificar nenhum nome DNS para o parâmetro
customSubjectAlternativeNames, mas fornecer o valor nulo[], o Cloud SQL vai remover todos os nomes DNS do certificado do servidor da instância. Isso garante que nenhum nome DNS seja adicionado ao certificado por engano.
Método HTTP e URL:
PATCH https://sqladmin.googleapis.com/sql/v1veta4/projects/PROJECT_ID/instances/INSTANCE_NAME
Corpo JSON da solicitação:
{
"kind": "sql#instance",
"name": "INSTANCE_NAME",
"project": "PROJECT_ID",
"settings": {
"ipConfiguration": {
"customSubjectAlternativeNames": "DNS_NAMES"
},
"kind": "sql#settings"
}
}
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_NAME",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}