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.

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. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  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 v1

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/v1/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/v1/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/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

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".

Interromper uma instância

Você pode 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:

Console

  1. No console do Google Cloud, 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. 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 v1

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/v1/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/v1/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/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

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".

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. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  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 v1

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/v1/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/v1/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/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

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).