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.
Defina sua política de ativação como ALWAYS. 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. Acesse a página Instâncias do Cloud SQL no Console do Google Cloud.

    Acessar a página "Instâncias" do Cloud SQL

  2. Selecione uma instância para ser iniciada clicando no nome dela.
  3. Clique no botão Iniciar, na barra de botões na parte superior da página.
  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

v1beta4 REST

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://www.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://www.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://www.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 nesta tarefa, consulte APIs Explorer 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. Acesse a página Instâncias do Cloud SQL no Console do Google Cloud.

    Acessar a página "Instâncias" do Cloud SQL

  2. Clique no nome da instância para interrompê-la.
  3. Clique no botão Interromper, na barra de botões na parte superior da página.
  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

v1beta4 REST

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://www.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://www.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://www.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 nesta tarefa, consulte APIs Explorer 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.

Para reiniciar uma instância:

Console

  1. Acesse a página Instâncias do Cloud SQL no Console do Google Cloud.

    Acessar a página "Instâncias" do Cloud SQL

  2. Selecione uma instância para ser reiniciada clicando no nome dela.
  3. Clique no botão Reiniciar, na barra de botões na parte superior da página.13
  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]

v1beta4 REST

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://www.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 à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://www.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://www.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}
Para ver como a solicitação da API REST é criada para essa tarefa, consulte o APIs Explorer na página "instances:restart".