O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Ative e desative serviços

Pode usar a utilização de serviços para ativar ou desativar qualquer serviço disponível para os seus Google Cloud projetos. Isto inclui serviços privados criados com o Cloud Endpoints. Para saber mais acerca das diferenças entre serviços públicos e privados, consulte Serviços públicos e privados.

A maioria dos utilizadores pode ativar e desativar serviços com a Google Cloud consola. Para scripts, use a Google Cloud CLI. Para aceder à API Service Usage por programação, recomendamos a utilização de uma biblioteca cliente. Para experimentar a API, pode enviar um pedido sem configurar um ambiente de desenvolvimento completo.

Para os limites de quota de utilização do serviço, consulte o artigo Quotas e limites. É aconselhável limitar a utilização faturável. Consoante a API, pode limitar explicitamente os pedidos.

Antes de começar

Antes de ativar e desativar serviços, tem de configurar o Google Cloud projeto e o ambiente para a utilização de serviços.

Consola

Inicie sessão na sua Google Cloud conta. Se está a usar o Google Cloudpela primeira vez, crie uma conta para avaliar o desempenho dos nossos produtos em cenários reais. Os novos clientes também recebem 300 USD em créditos sem custo financeiro para executar, testar e implementar 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.

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.

gcloud

Instale a CLI Google Cloud.

Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

Para inicializar a CLI gcloud, 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: a seleção de um projeto não requer uma função de IAM específica. Pode selecionar qualquer projeto no qual lhe tenha sido concedida uma função.
Crie um projeto: para criar um projeto, precisa da função de criador de projetos (roles/resourcemanager.projectCreator), que contém a autorização resourcemanager.projects.create. Saiba como conceder funções.

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

Se estiver a usar um projeto existente para este guia, verifique se tem as autorizações necessárias para concluir este guia. Se criou um novo projeto, já tem as autorizações necessárias.

Instale a CLI Google Cloud.

Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

Para inicializar a CLI gcloud, 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: a seleção de um projeto não requer uma função de IAM específica. Pode selecionar qualquer projeto no qual lhe tenha sido concedida uma função.
Crie um projeto: para criar um projeto, precisa da função de criador de projetos (roles/resourcemanager.projectCreator), que contém a autorização resourcemanager.projects.create. Saiba como conceder funções.

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

Se estiver a usar um projeto existente para este guia, verifique se tem as autorizações necessárias para concluir este guia. Se criou um novo projeto, já tem as autorizações necessárias.

API REST

Ter um Google Cloud projeto para o qual quer ativar ou desativar APIs.
Valide se tem as autorizações necessárias para concluir este guia. Se estiver a usar um projeto que criou, normalmente já tem as autorizações necessárias.

Funções necessárias

Para receber as autorizações de que precisa para ativar e desativar serviços, peça ao seu administrador para lhe conceder a função de IAM Administrador de utilização do serviço (roles/serviceusage.serviceUsageAdmin) no seu projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Ative um serviço

O processo para ativar um serviço pode variar. Algumas APIs pedem-lhe que aceite primeiro os respetivos Termos de Utilização ou estão em pré-visualização e requerem aprovação antes de as poder usar. Outras APIs podem pedir informações adicionais, como os detalhes de contacto da sua organização e o nome da sua aplicação. Todas as informações pedidas permanecem confidenciais na Google. Utilizamo-lo para compreender a utilização da API e para entrar em contacto consigo, se necessário.

Consola

Na Google Cloud consola, aceda à página APIs & Services > API Library.

Aceder à API Library
Selecione um projeto recente ou use o seletor de recursos na barra de ferramentas da consola para selecionar o Google Cloud projeto onde quer ativar uma API.
Clique na API que quer ativar ou pesquise-a através da 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 qualquer um dos dados de comando abaixo, faça as seguintes substituições:

SERVICE: o nome do serviço que 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

Deve receber uma resposta semelhante à seguinte:


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 seguinte comando ativa os serviços BigQuery e Pub/Sub:

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

Para obter 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 recebeu em resposta ao seu pedido original.

API REST

Ative um único serviço

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

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

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

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

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando 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)

Nota: O comando seguinte pressupõe que iniciou sessão na gcloud CLI do Google Ads com a sua conta de utilizador executando gcloud init ou gcloud auth login . Pode verificar a conta atualmente ativa executando 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 for bem-sucedido, o corpo da resposta contém uma instância recém-criada de Operation:

{
  "name": "operations/OPERATION_ID"
}

Ative vários serviços

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

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

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

Corpo JSON do pedido:

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

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

curl (Linux, macOS ou Cloud Shell)

Guarde o corpo do pedido num ficheiro denominado request.json. Execute o seguinte comando no terminal para criar ou substituir este ficheiro no diretório atual:

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

Em seguida, execute o seguinte comando para enviar o seu pedido 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)

Guarde o corpo do pedido num ficheiro denominado request.json. Execute o seguinte comando no terminal para criar ou substituir este ficheiro no diretório atual:

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

Em seguida, execute o seguinte comando para enviar o seu pedido 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 for bem-sucedido, o corpo da resposta contém uma instância recém-criada de Operation:

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

Desative um serviço

Pode desativar uma API para um projeto em qualquer altura. No entanto, continua a ser cobrado por quaisquer taxas pendentes e utilização da API faturável nos seus projetos. Para mais informações, consulte o guia de introdução às APIs Cloud.

Muitos serviços, como o Cloud Storage e o BigQuery, cobram pelo armazenamento de dados, e a desativação da API destes serviços não elimina os seus dados. Para estes serviços, continua a receber faturas relativas ao armazenamento de dados, mesmo depois de a API ser desativada. Por outro lado, quando desativa a API Cloud Run, os recursos associados ao Cloud Run são eliminados, o que pode não ser a sua intenção.

Em ambos os casos e como prática recomendada geral, deve fazer um inventário dos recursos associados ao seu serviço antes de o desativar. Para serviços como o Cloud Storage e o BigQuery, para parar as cobranças futuras e descontinuar a utilização do serviço, elimine todos os dados associados antes de desativar a respetiva API. Para o Cloud Run, não desative a API até confirmar que todos os recursos do Cloud Run existentes podem ser eliminados em segurança.

Se desativar a API Kubernetes Engine, os clusters em execução no projeto são suspensos. Após 30 dias, estes clusters suspensos são eliminados. Para reativar os seus clusters, reative a API GKE. A reposição dos clusters pode demorar até 24 horas. Para mais informações, consulte o artigo Ciclo de vida do cluster.

Consola

Na Google Cloud consola, aceda à página APIs & Services > API Library.

Aceder à API Library
Selecione um projeto recente ou use o seletor de recursos na barra de ferramentas da consola para selecionar o Google Cloud projeto onde quer desativar uma API.
Clique na API que quer desativar ou pesquise-a através da 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 qualquer um dos dados de comando abaixo, faça as seguintes substituições:

SERVICE: o nome do serviço que 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

Deve receber uma resposta semelhante à seguinte:


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 seguinte comando desativa os serviços BigQuery e Pub/Sub:

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

Para obter 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 recebeu em resposta ao seu pedido original.

API REST

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

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

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

Para enviar o seu pedido, 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 for bem-sucedido, o corpo da resposta contém uma instância recém-criada de Operation:

{
  "name": "operations/OPERATION_ID"
}

Verifique o estado de uma operação de longa duração

A utilização do método de ativação ou desativação devolve uma operação de longa duração (LRO). O LRO acompanha o estado do pedido e indica se a alteração ao serviço está concluída.

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

OPERATION_ID: o identificador da operação. Recebe este ID na resposta à sua solicitação original.

Para enviar o seu pedido, 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 está definido como true, a operação está concluída.