Como iniciar, interromper e reiniciar instâncias

Nesta página, você verá como iniciar e interromper uma instância, e reiniciar uma instância em execução.

Política de ativação

Ao iniciar, interromper ou reiniciar uma instância, é preciso definir uma política de ativação a ser usada. Essa política indica se a instância está ativada para aceitar solicitações de conexão.

As opções de política de ativação são:

  • ALWAYS: a instância está sempre ativa e em execução.
  • NEVER: a instância não é reiniciada.
Se você estiver usando uma instância do MySQL, geralmente definirá a política de ativação como ALWAYS para aceitar solicitações de conexão. Se você não estiver usando a instância, defina a política de ativação dela como NEVER para evitar cobranças.

Como iniciar uma instância

Para iniciar uma instância interrompida:

Console

  1. No Console do Google Cloud, acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Clique no nome da instância para abrir a página Visão geral correspondente.
  3. Clique em Iniciar.
  4. Na caixa de diálogo Iniciar instância do banco de dados?, clique em Iniciar.
    A política de ativação da instância será definida como Sempre, e a instância será iniciada.

gcloud

Use SEMPRE para a política de ativação:

gcloud sql instances patch INSTANCE_NAME \
--activation-policy=ALWAYS

REST v1beta4

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
  • activation-policy: a política de ativação é ALWAYS ou NEVER

Método HTTP e URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Corpo JSON da solicitação:

{
  "settings": {
    "activationPolicy": "activation-policy"
  }
}

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-20T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}
Para ver como a solicitação da API REST subjacente é criada nesta tarefa, consulte o Explorador de APIs na página "instances:patch".

Como interromper uma instância

É possível interromper manualmente uma instância quando necessário. Quando você interrompe uma instância, ela permanece assim e não responde às conexões do aplicativo até ser iniciada novamente.

A interrupção da instância suspende as cobranças referentes a esse recurso. Os dados da instância não são afetados e as cobranças por armazenamento e endereços IP continuam sendo aplicadas.

Para interromper uma instância, faça o seguinte:

Console

  1. No Console do Google Cloud, acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Clique no nome da instância para abrir a página Visão geral correspondente.
  3. Clique em Stop.
  4. Na caixa de diálogo Interromper a instância do banco de dados?, clique em Interromper.

    A política de ativação da instância será definida como Off (Nunca), e a instância será interrompida.

gcloud

gcloud sql instances patch INSTANCE_NAME \
--activation-policy=NEVER

REST v1beta4

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
  • activation-policy: a política de ativação é NUNCA

Método HTTP e URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Corpo JSON da solicitação:

{
  "settings": {
    "activationPolicy": "activation-policy"
  }
}

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-20T21:30:35.667Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}
Para ver como a solicitação da API REST subjacente é criada nesta tarefa, consulte o Explorador de APIs na página "instances:patch".

Como reiniciar uma instância

O reinício de uma instância drena as conexões dela e a interrompe. Depois, a instância é reiniciada e está pronta para aceitar novas conexões.

A reinicialização de uma instância não altera os endereços IP públicos ou privados da instância.

Para reiniciar uma instância:

Console

  1. No Console do Google Cloud, acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. Clique no nome da instância para abrir a página Visão geral correspondente.
  3. Clique em Restart.
  4. Na caixa de diálogo Reiniciar instância do banco de dados, clique em Reiniciar.

gcloud

Reinicie a instância:

gcloud sql instances restart INSTANCE_NAME

REST v1beta4

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
  • activation-policy: a política de ativação é ALWAYS ou NEVER

Método HTTP e URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/restart

Corpo JSON da solicitação:

{
  "settings": {
    "activationPolicy": "activation-policy"
  }
}

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-20T21:30:35.667Z",
  "operationType": "RESTART",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}
Para ver como a solicitação da API REST subjacente (em inglês) é criada para essa tarefa, consulte o APIs Explorer na página "instances:restart" (em inglês).