Edite instâncias

Esta página descreve como editar uma instância do Cloud SQL existente.

Depois de criar uma instância, pode editá-la enquanto está em execução para alterar as respetivas definições. Para informações sobre as definições de instâncias e como a alteração das definições pode afetar uma instância, consulte Definições de instâncias.

Pode integrar o Cloud SQL para SQL Server com o serviço gerido para o Microsoft Active Directory (Microsoft AD gerido). Esta integração inclui capacidades para aderir e sair de um domínio do Microsoft AD gerido ao nível da instância. Para mais informações, consulte o artigo Vista geral do Microsoft AD gerido no Cloud SQL.

Também pode ativar ou desativar a auditoria da base de dados.

Edite uma instância

A maioria das edições só pode ser aplicada a uma instância quando esta está em execução.

Consola

  1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

    Aceda a Instâncias do Cloud SQL

  2. Para abrir a página Vista geral de uma instância, clique no nome da instância.
  3. Clique em Edit.
  4. Na secção Personalize a sua instância, se aparecer o menu Mostrar opções de configuração, clique nele.

  5. Atualize quaisquer definições editáveis da sua instância.

    Saiba mais acerca das definições de instâncias.

  6. Clique em Guardar.

gcloud

Este comando modifica a hora de início da cópia de segurança.

gcloud sql instances patch INSTANCE_NAME \
--backup-start-time 16:00

Se uma correção modificar um valor que requer um reinício, é apresentado um pedido para continuar com a alteração ou cancelar.

Para saber mais sobre as flags de configuração de instâncias, consulte gcloud sql instances patch.

REST v1

Ao usar este comando, pode modificar a hora de início da cópia de segurança.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID do projeto
  • INSTANCE_ID: o ID da instância
  • PRIVATE_NETWORK: a rede que está a adicionar ou a selecionar para criar uma ligação privada

Método HTTP e URL: 

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

Corpo JSON do pedido: 

{
  "settings": {
    "backupConfiguration": {
      "startTime": "16:00",
      "enabled": true,
      "binaryLogEnabled": true
    }
  }
    "ipConfiguration": {
      "privateNetwork": "PRIVATE_NETWORK",
      "authorizedNetworks": [],
      "ipv4Enabled": false,
    }
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 uma correção modificar um valor que requer um reinício, é apresentada uma mensagem para continuar com a alteração ou cancelar.

Para ver como o pedido da API REST subjacente é criado para esta tarefa, consulte o Explorador de APIs na página instances:patch.

REST v1beta4

Ao usar este comando, pode modificar a hora de início da cópia de segurança.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID do projeto
  • INSTANCE_ID: o ID da instância
  • PRIVATE_NETWORK: a rede que está a adicionar ou a selecionar para criar uma ligação privada

Método HTTP e URL: 

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

Corpo JSON do pedido: 

{
  "settings": {
    "backupConfiguration": {
      "startTime": "16:00",
      "enabled": true,
      "binaryLogEnabled": true
    }
  }
    "ipConfiguration": {
      "privateNetwork": "PRIVATE_NETWORK",
      "authorizedNetworks": [],
      "ipv4Enabled": false,
    }
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 a correção modificar um valor que requer um reinício, é apresentada uma mensagem para continuar com a alteração ou cancelar.

Para ver como o pedido da API REST subjacente é criado para esta tarefa, consulte o Explorador de APIs na página instances:patch.

Edite uma instância com o Private Service Connect ativado

Pode atualizar uma instância com o Private Service Connect ativado através da CLI gcloud ou da API. Por exemplo, pode atualizar projetos associados a instâncias para os seguintes fins:

  • Para permitir ligações de pontos finais do Private Service Connect às instâncias do Cloud SQL.
  • Para remover projetos da lista de projetos permitidos. Para qualquer projeto removido, as ligações a quaisquer pontos finais do Private Service Connect existentes continuam a funcionar, mas não são aceites novos pontos finais.

gcloud

Para atualizar os 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 à qual os pontos finais do Private Service Connect nas redes VPC se podem ligar.
  • PROJECT_ID: o ID ou o número do projeto do projeto Google Cloud que contém a instância à qual os pontos finais do Private Service Connect nas redes VPC podem estabelecer ligação.
  • ALLOWED_PROJECTS: uma lista de IDs ou números de projetos permitidos, separados por vírgulas. Estes projetos substituem os projetos que já estão configurados para usar o Private Service Connect. Se um projeto não estiver incluído nesta lista, não pode usá-lo para criar uma instância e ativar o Private Service Connect para o mesmo.

O exemplo seguinte permite que dois projetos (98765 e 87654) estabeleçam ligações a partir de pontos finais do Private Service Connect para a instância do Cloud SQL contida no projeto 12345:myinstance

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

Esta flag garante que nenhum projeto é permitido inadvertidamente.

REST v1

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID ou o número do projeto do projeto Google Cloud que contém a instância à qual os pontos finais do Private Service Connect nas redes VPC podem estabelecer ligação.
  • INSTANCE_NAME: o nome da instância do Cloud SQL à qual os pontos finais do Private Service Connect nas redes VPC se podem ligar.
  • ALLOWED_PROJECTS: uma lista de IDs ou números de projetos permitidos, separados por vírgulas. Estes projetos substituem os projetos que já estão configurados para usar o Private Service Connect. Se um projeto não estiver incluído nesta lista, não pode usá-lo para criar uma instância e ativar o Private Service Connect para o mesmo.

Método HTTP e URL: 

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

Corpo JSON do pedido: 

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS]
      }
    },
    "kind": "sql#settings"
  }
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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. Esta flag garante que nenhum projeto é permitido inadvertidamente.

Para ver como o pedido da API REST subjacente é criado para esta tarefa, consulte o Explorador de APIs na página instances:patch.

REST v1beta4

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID ou o número do projeto do projeto Google Cloud que contém a instância à qual os pontos finais do Private Service Connect nas redes VPC podem estabelecer ligação.
  • INSTANCE_NAME: o nome da instância do Cloud SQL à qual os pontos finais do Private Service Connect nas redes VPC se podem ligar.
  • ALLOWED_PROJECTS: uma lista de IDs ou números de projetos permitidos, separados por vírgulas. Estes projetos substituem os projetos que já estão configurados para usar o Private Service Connect. Se um projeto não estiver incluído nesta lista, não pode usá-lo para criar uma instância e ativar o Private Service Connect para o mesmo.

Método HTTP e URL: 

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

Corpo JSON do pedido: 

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "pscConfig": {
        "allowedConsumerProjects": [ALLOWED_PROJECTS]
      }
    },
    "kind": "sql#settings"
  }
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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. Esta flag garante que nenhum projeto é permitido inadvertidamente.

Para ver como o pedido da API REST subjacente é criado para esta tarefa, consulte o Explorador de APIs na página instances:patch.

Edite um SAN personalizado para uma instância

Se quiser usar um nome DNS personalizado para se ligar a uma instância do Cloud SQL em vez de usar um endereço IP, configure a definição de nome alternativo do assunto (SAN) personalizado enquanto cria a instância. O nome DNS personalizado que inserir na definição SAN personalizada é adicionado ao campo SAN do certificado do servidor da instância. Isto permite-lhe usar o nome DNS personalizado com a validação do nome de anfitrião de forma segura.

Pode realizar as seguintes operações com um SAN personalizado para um certificado de servidor de uma instância:

  • Adicione nomes DNS à instância: adicione uma lista separada por vírgulas de até três nomes DNS personalizados à definição SAN personalizada. O Cloud SQL adiciona estes nomes ao campo SAN do certificado do servidor. Pode proteger vários nomes de DNS com um único certificado.
  • Modifique os nomes DNS da instância: altere os nomes DNS personalizados que quer adicionar ao campo SAN do certificado do servidor da instância.
  • Remover nomes DNS da instância: remove todos os nomes DNS personalizados do campo SAN do certificado do servidor da instância.

Pode editar um SAN personalizado para uma instância através da CLI gcloud ou da API.

gcloud

Para editar um SAN personalizado para uma instância, use o comando gcloud beta sql instances patch:

gcloud beta 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 está a adicionar, modificar ou remover nomes DNS
  • PROJECT_ID: o ID ou o 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 está a adicionar ao certificado do servidor da sua instância

Para remover todos os nomes DNS do certificado de servidor de uma instância do Cloud SQL, use o comando gcloud beta sql instances patch e a flag
--clear-custom-subject-alternative-names:

gcloud beta sql instances patch INSTANCE_NAME \
--project=PROJECT_ID \
--clear-custom-subject-alternative-names

Esta flag garante que não são adicionados nomes DNS ao certificado inadvertidamente.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • PROJECT_ID: o ID ou o número do projeto do seu projeto Google Cloud . Este projeto contém uma instância do Cloud SQL que tem um certificado do servidor ao qual está a adicionar, modificar ou remover 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 está a adicionar ao certificado do servidor da sua instância.

    Se já tiver nomes de DNS que adicionou ao certificado e usar este parâmetro para especificar nomes de DNS diferentes, o Cloud SQL remove os nomes de DNS originais do certificado.

    Se não especificar nomes DNS para o parâmetro customSubjectAlternativeNames, mas fornecer o valor nulo [], o Cloud SQL remove todos os nomes DNS do certificado do servidor da instância. Isto garante que não são adicionados nomes DNS ao certificado inadvertidamente.

Método HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1veta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Corpo JSON do pedido: 

{
  "kind": "sql#instance",
  "name": "INSTANCE_NAME",
  "project": "PROJECT_ID",
  "settings": {
    "ipConfiguration": {
      "customSubjectAlternativeNames": "DNS_NAMES"
    },
    "kind": "sql#settings"
  }
}

Para enviar o seu pedido, expanda uma destas opções:

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 ver como o pedido da API REST subjacente é construído para esta tarefa, consulte o Explorador de APIs na página instances:patch.