Ativar e desativar serviços

É possível usar o Service Usage para ativar ou desativar qualquer serviço disponível para seus projetos Google Cloud . Isso inclui Google Cloud serviços públicos e serviços privados criados com o Cloud Endpoints. Para saber mais sobre as diferenças entre serviços públicos e privados, consulte Serviços públicos e privados.

A maioria dos usuários pode ativar e desativar serviços com o console Google Cloud . Para scripts, use a Google Cloud CLI. Para acessar a API Service Usage de forma programática, recomendamos usar uma biblioteca de cliente. Para testar a API, envie uma solicitação sem configurar um ambiente de desenvolvimento completo.

Para limites de cota do Service Usage, consulte Cotas e limites. Talvez você queira limitar o uso faturável. Dependendo da API, é possível limitar explicitamente as solicitações.

Antes de começar

Antes de ativar e desativar serviços, configure seu projeto e ambiente doGoogle Cloud para o Service Usage.

Console

Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Service Usage API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Service Usage API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

gcloud

Instale a CLI do Google Cloud.

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

Para inicializar a gcloud CLI, execute o seguinte comando:

gcloud init

Crie ou selecione um Google Cloud projeto.

Funções necessárias para selecionar ou criar um projeto

Selecionar um projeto: não é necessário um papel específico do IAM para selecionar um projeto. Você pode escolher qualquer projeto em que tenha recebido um papel.
Criar um projeto: para criar um projeto, é necessário ter o papel de Criador de projetos (roles/resourcemanager.projectCreator), que contém a permissão resourcemanager.projects.create. Saiba como conceder papéis.

Crie um projeto do Google Cloud :
```
gcloud projects create PROJECT_ID
```
Substitua PROJECT_ID por um nome para o projeto Google Cloud que você está criando.
Selecione o projeto Google Cloud que você criou:
```
gcloud config set project PROJECT_ID
```
Substitua PROJECT_ID pelo nome do projeto do Google Cloud .

Se este guia estiver usando um projeto atual, verifique se você tem as permissões necessárias para concluir o guia. Se você criou um projeto, já tem as permissões necessárias.

Verifique se o faturamento está ativado para o projeto do Google Cloud .

Ative a API Service Usage:

Funções necessárias para ativar APIs

Para ativar as APIs, é necessário ter o papel do IAM de administrador do Service Usage (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder papéis.

gcloud services enable serviceusage.googleapis.com

Instale a CLI do Google Cloud.

Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

Para inicializar a gcloud CLI, execute o seguinte comando:

gcloud init

Crie ou selecione um Google Cloud projeto.

Funções necessárias para selecionar ou criar um projeto

Selecionar um projeto: não é necessário um papel específico do IAM para selecionar um projeto. Você pode escolher qualquer projeto em que tenha recebido um papel.
Criar um projeto: para criar um projeto, é necessário ter o papel de Criador de projetos (roles/resourcemanager.projectCreator), que contém a permissão resourcemanager.projects.create. Saiba como conceder papéis.

Crie um projeto do Google Cloud :
```
gcloud projects create PROJECT_ID
```
Substitua PROJECT_ID por um nome para o projeto Google Cloud que você está criando.
Selecione o projeto Google Cloud que você criou:
```
gcloud config set project PROJECT_ID
```
Substitua PROJECT_ID pelo nome do projeto do Google Cloud .

Se este guia estiver usando um projeto atual, verifique se você tem as permissões necessárias para concluir o guia. Se você criou um projeto, já tem as permissões necessárias.

Verifique se o faturamento está ativado para o projeto do Google Cloud .

Ative a API Service Usage:

Funções necessárias para ativar APIs

gcloud services enable serviceusage.googleapis.com

Funções exigidas

Para receber as permissões necessárias para ativar e desativar serviços, peça ao administrador para conceder a você o papel do IAM de Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Ativar um serviço

O processo para ativar um serviço pode variar. Algumas APIs pedem que você aceite os Termos de Serviço ou estão em prévia e exigem aprovação antes de serem usadas. Outras APIs podem solicitar informações adicionais, como os detalhes de contato da sua organização e o nome do aplicativo. Todas as informações solicitadas permanecem confidenciais no Google. Usamos esse dado para entender o uso da API e entrar em contato com você, se necessário.

Console

No console do Google Cloud , acesse a página APIs e serviços > Biblioteca de APIs.

Acessar a biblioteca de APIs
Selecione um projeto recente ou use o seletor de recursos na barra de ferramentas do console para escolher o projeto do Google Cloud em que você quer ativar uma API.
Clique na API que você quer ativar ou pesquise usando a caixa Pesquisar APIs e serviços.
Clique em Ativar.

gcloud

O comando gcloud services enable ativa um serviço com o nome especificado para o projeto atual.

Antes de usar os dados do comando abaixo, faça estas substituições:

SERVICE: o nome do serviço que você quer ativar.

Execute o comando gcloud services enable:

Linux, macOS ou Cloud Shell

gcloud services enable SERVICE

Windows (PowerShell)

gcloud services enable SERVICE

Windows (cmd.exe)

gcloud services enable SERVICE

Você receberá uma resposta semelhante a esta:


Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

Para ativar vários serviços, use nomes de serviços delimitados por espaços. Por exemplo, o comando a seguir ativa os serviços BigQuery e Pub/Sub:

gcloud services enable bigquery.googleapis.com pubsub.googleapis.com

Para recuperar os detalhes da operação, use o comando gcloud services operations describe:

gcloud services operations describe operations/OPERATION_ID

Substitua OPERATION_ID pelo ID da operação que você recebeu em resposta à solicitação original.

API REST

Ativar um único serviço

Para ativar um único serviço, use o método services.enable.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

PROJECT_ID: o ID do projeto do Google Cloud.
SERVICE: o nome do serviço que você quer ativar.

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable" | Select-Object -Expand Content

Se houver êxito, o corpo da resposta conterá uma instância de Operation:

{
  "name": "operations/OPERATION_ID"
}

Ativar vários serviços

Para ativar até 20 serviços em uma única operação, use o método services.batchEnable.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

PROJECT_ID: o ID do projeto do Google Cloud.
SERVICE1: o nome de um serviço que você quer ativar.
SERVICE2: o nome de outro serviço que você quer ativar.

Corpo JSON da solicitação:

{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo chamado request.json. Execute o comando a seguir no terminal para criar ou substituir esse arquivo no diretório atual:

cat > request.json << 'EOF'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
EOF

Depois execute o comando a seguir para enviar a solicitação REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo chamado request.json. Execute o comando a seguir no terminal para criar ou substituir esse arquivo no diretório atual:

@'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
'@  | Out-File -FilePath request.json -Encoding utf8

Depois execute o comando a seguir para enviar a solicitação REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable" | Select-Object -Expand Content

Se houver êxito, o corpo da resposta conterá uma instância de Operation:

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.OperationMetadata"
  }
}

Desativar um serviço

É possível desativar uma API em um projeto a qualquer momento. No entanto, você ainda vai receber cobranças por taxas pendentes e pelo uso de APIs faturáveis nos seus projetos. Para mais informações, consulte o guia Primeiros passos das APIs do Cloud.

Muitos serviços, como o Cloud Storage e o BigQuery, cobram pelo armazenamento de dados. Desativar a API de um serviço não exclui seus dados, e você vai continuar recebendo cobranças por ela. Para interromper cobranças futuras e parar de usar um serviço, exclua todos os dados associados antes de desativar a API.

Se você desativar a API Google Kubernetes Engine, os clusters em execução no projeto serão suspensos. Após 30 dias, esses clusters suspensos são excluídos. Para reativar seus clusters, reative a API GKE. Pode levar até 24 horas para os clusters serem restabelecidos. Para mais informações, consulte Ciclo de vida do cluster.

Console

No console do Google Cloud , acesse a página APIs e serviços > Biblioteca de APIs.

Acessar a biblioteca de APIs
Selecione um projeto recente ou use o seletor de recursos na barra de ferramentas do console para selecionar o projeto Google Cloud em que você quer desativar uma API.
Clique na API que você quer desativar ou pesquise usando a caixa Pesquisar APIs e serviços.
Clique em Desativar API.

gcloud

O comando gcloud services disable desativa um serviço com o nome especificado para o projeto atual.

Antes de usar os dados do comando abaixo, faça estas substituições:

SERVICE: o nome do serviço que você quer desativar.

Execute o comando gcloud services disable:

Linux, macOS ou Cloud Shell

gcloud services disable SERVICE

Windows (PowerShell)

gcloud services disable SERVICE

Windows (cmd.exe)

gcloud services disable SERVICE

Você receberá uma resposta semelhante a esta:


Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

Para desativar vários serviços, use nomes de serviços delimitados por espaços. Por exemplo, o comando a seguir desativa os serviços do BigQuery e do Pub/Sub:

gcloud services disable bigquery.googleapis.com pubsub.googleapis.com

Para recuperar os detalhes da operação, use o comando gcloud services operations describe:

gcloud services operations describe operations/OPERATION_ID

Substitua OPERATION_ID pelo ID da operação que você recebeu em resposta à solicitação original.

API REST

Para desativar um serviço, use o método services.disable.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

PROJECT_ID: o ID do projeto do Google Cloud.
SERVICE: o nome do serviço que você quer desativar.

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Execute o seguinte comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable"

PowerShell (Windows)

Execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable" | Select-Object -Expand Content

Se houver êxito, o corpo da resposta conterá uma instância de Operation:

{
  "name": "operations/OPERATION_ID"
}

Verificar o status de uma operação de longa duração

O uso do método de ativação ou desativação retorna uma operação (LRO) de longa duração. A LRO rastreia o status da solicitação e indica se a mudança no serviço foi concluída.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

OPERATION_ID: o identificador da operação. Você recebe esse ID na resposta à sua solicitação original.

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://serviceusage.googleapis.com/v1/operations/OPERATION_ID"

PowerShell (Windows)

Execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/operations/OPERATION_ID" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.EnableServiceResponse",
    "service": {
      "name": "projects/PROJECT_NUMBER/services/SERVICE",
      "config": {
        "name": "SERVICE",
        "title": "TITLE",
        "documentation": {},
        "quota": {},
        "authentication": {},
        "usage": {
          "requirements": [
            "serviceusage.googleapis.com/tos/cloud"
          ]
        },
        "monitoring": {}
      },
      "state": "ENABLED",
      "parent": "projects/PROJECT_NUMBER"
    }
  }
}

Quando o campo done estiver definido como true, a operação será concluída.