Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Como ativar e desativar serviços
Esta página descreve como ativar e desativar serviços em um Google Cloud projeto.
É possível usar o Service Usage para ativar ou desativar qualquer serviço disponível
para os projetos, incluindo serviços públicos
Google Cloud e serviços particulares criados
usando o Cloud Endpoints. Para mais informações sobre as
diferenças entre APIs e serviços públicos e privados, consulte
Serviços públicos e privados.
Na maioria dos casos de uso operacional, a maneira mais simples de ativar e desativar serviços
é usar o console Google Cloud . Se você precisar criar scripts, também é possível usar a
Google Cloud CLI. Se precisar programar com a API Service Usage, recomendamos que você use uma das bibliotecas de clientes fornecidas. Para testar a API, siga as instruções alternativas neste guia e use o comando curl para testar a API sem configurar um ambiente de desenvolvimento de aplicativo completo.
Antes de começar
Para ativar e desativar APIs e serviços, você precisa dos seguintes itens:
Um projeto de Google Cloud . Para saber como criar um projeto Google Cloud , consulte
Criar e gerenciar projetos.
Se você quiser usar os exemplos curl neste guia, siga as instruções para concluir a configuração inicial em Primeiros passos. Essas etapas incluem
a definição de gcurl, que é um alias autenticado do comando curlpadrão, e a definição da variável de ambiente PROJECT_NUMBER.
Ativação dos serviços
A ativação de serviços usa a cota da
métrica de cota serviceusage.googleapis.com/mutate_requests. A cota
padrão disponível é de 2 consultas por segundo (QPS).
Console
Para ativar uma API para um projeto, siga estas etapas:
Selecione o projeto do Google Cloud em que você quer ativar
uma API executando uma das seguintes ações:
Clique em um projeto Google Cloud em Selecionar um projeto recente.
Use o navegador de projeto Google Cloud seguindo estas
etapas:
Clique em Selecionar projeto para abrir o navegador de Google Cloud projetos.
Encontre seu projeto e clique no Google Cloud nome dele.
Clique em Abrir para abrir o projeto.
Clique na API que você pretende ativar. Se você precisar de ajuda para encontrar a API, use
a caixa Pesquisar APIs e serviços na parte superior da página. Será exibida uma página descrevendo a API.
Clique no botão Ativar.
gcloud
Execute o seguinte comando para ativar o serviço da API Pub/Sub em seu projeto atual:
gcloud services enable pubsub.googleapis.com
O comando produz um resultado semelhante ao seguinte:
Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.
Você pode usar o seguinte comando para ver os detalhes da operação:
É possível ativar um único serviço usando o método services.enable. É possível ativar entre 2 e 20 serviços em uma única operação usando o método services.batchEnable.
Ativar um único serviço
O comando a seguir ativa o serviço da API Pub/Sub no seu projeto:
O método
services.enable
retorna um recurso
Operação de longa duração, que representa o trabalho em andamento no servidor. Cada operação tem um nome de recurso exclusivo. Por exemplo, veja uma operação
com o nome operations/acf.2e2fcfce-8327-4984-9040-a67777082687:
Se quiser ativar vários serviços de API no seu projeto, você poderá emitir
um comando de ativação para cada serviço de API individualmente ou emitir um
comando de ativação em lote e especificar várias APIs. Por exemplo, para ativar os serviços da API Pub/Sub e Dataflow no seu projeto:
Como services.enable, services.batchEnable
retorna um recurso de operação, que você pode pesquisar usando o name dele.
Desativação de serviços
A desativação de serviços usa a cota da
métrica de cota serviceusage.googleapis.com/mutate_requests. A cota
padrão disponível é de 2 consultas por segundo (QPS).
É possível desativar uma API em um projeto a qualquer momento. Você receberá cobranças sobre qualquer taxa pendente na sua conta e por qualquer uso de API faturável nos seus projetos. Para mais informações, consulte APIs e faturamento.
Muitos serviços, como o Cloud Storage e o BigQuery, cobram pelo armazenamento de dados. A desativação do
acesso à API de um serviço não exclui os dados subjacentes, que vão continuar
sendo cobrados. Se você quiser interromper o uso de um serviço e impedir todas as cobranças futuras, exclua todos os dados associados ao serviço antes de desativar o acesso à API dele.
Se você desativar a API GKE, todos os clusters em execução no projeto serão suspensos. Após 30 dias, os clusters suspensos são excluídos. Para restabelecer os clusters suspensos, ative a API GKE. Pode levar até 24 horas para que os clusters sejam restabelecidos.
Console
Para desativar uma API em um projeto, siga estas etapas:
Selecione o projeto Google Cloud em que você quer desativar
uma API executando uma das seguintes ações:
Clique em um projeto Google Cloud em Selecionar um projeto recente.
Use o navegador de projeto Google Cloud seguindo estas
etapas:
Clique em Selecionar projeto para abrir o navegador de Google Cloud projetos.
Encontre seu projeto e clique no Google Cloud nome dele.
Clique em Abrir para abrir o projeto.
Clique na API que você pretende desativar. Se você precisar de ajuda para encontrar a API, use
a caixa Pesquisar APIs e serviços na parte superior da página. Será exibida uma página descrevendo a API.
Clique em stopDesativar API.
gcloud
Execute o seguinte comando para desativar o serviço da API Pub/Sub no seu projeto atual:
gcloud services disable pubsub.googleapis.com
O comando produz um resultado semelhante ao seguinte:
Waiting for async operation operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8 to complete...
Operation finished successfully.
Você pode usar o seguinte comando para ver os detalhes da operação:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[],[],null,["# Enabling and Disabling Services\n===============================\n\nThis page describes how to enable and disable services for a Google Cloud project.\nYou can use Service Usage to enable or disable any available service\nfor your projects, including public\n[Google Cloud services](/terms/services) and private services created\nusing [Cloud Endpoints](/endpoints/docs). For more information on the\ndifferences between public and private APIs and services, see\n[Public and Private Services](/service-usage/docs/public-vs-private).\n\nFor most operational use cases, the simplest way to enable and disable services\nis to use the Google Cloud console. If you need to create scripts, you can also use the\nGoogle Cloud CLI. If you need to program against the\nService Usage API, we recommend that you use one of our provided\n[client libraries](/service-usage/docs/libraries). To experiment with the API,\nyou can follow the alternative instructions in this guide and use the `curl`\ncommand to test the API without setting up a full application development\nenvironment.\n\nBefore you begin\n----------------\n\nTo enable and disable APIs and services you need:\n\n- A Google Cloud project. To learn how to create a Google Cloud project, see [Creating and Managing Projects](/resource-manager/docs/creating-managing-projects).\n- The correct [Identity and Access Management](/iam) permissions. To learn about the IAM requirements for Service Usage, see [Access Control](/service-usage/docs/access-control).\n- To install the [Google Cloud CLI](/sdk/docs/install).\n- If you want to use the `curl` examples in this guide, make sure you follow the instructions to complete the initial setup in [Getting Started](/service-usage/docs/set-up-development-environment). These steps include defining `gcurl`, which is an authenticated alias for the standard `curl` command, and defining the environment variable `PROJECT_NUMBER`.\n\nEnabling services\n-----------------\n\nEnabling services uses quota from the\n`serviceusage.googleapis.com/mutate_requests` quota metric. The default\navailable quota is 2 queries per second (QPS). \n\n### console\n\nTo enable an API for a project:\n\n1. Go to the Google Cloud console [API Library](https://console.cloud.google.com/project/_/apis/library) page. \n [Go to the API Library page](https://console.cloud.google.com/project/_/apis/library)\n2. Select the Google Cloud project where you want to enable\n an API by performing one of the following:\n\n - Click on a Google Cloud project under **Select a recent project**.\n\n - Use the Google Cloud project browser by performing the following\n steps:\n\n 1. Click **Select project** to open the Google Cloud project browser.\n 2. Find your project and then click on the Google Cloud project name.\n 3. Click **Open** to open the project.\n3. Click the API you want to enable. If you need help finding the API, use\n the **Search for APIs \\& Services** box near the top of the page. A page\n describing the API appears.\n\n4. Click the **Enable** button.\n\n### gcloud\n\nRun the following command to enable the Pub/Sub API service in your\ncurrent project: \n\n```\ngcloud services enable pubsub.googleapis.com\n```\n\nThe command produces output similar to the following: \n\n```\nWaiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...\nOperation finished successfully.\n```\n\nYou can use the following command to get the operation details: \n\n```\ngcloud services operations describe operations/acf.2e2fcfce-8327-4984-9040-a67777082687\n```\n\n### curl\n\nYou can enable a single service using the\n[`services.enable`](/service-usage/docs/reference/rest/v1/services/enable)\nmethod. You can enable between 2 and 20 services in a single operation using\nthe [`services.batchEnable`](/service-usage/docs/reference/rest/v1/services/batchEnable)\nmethod.\n\n### Enable a single service\n\nThe following command enables the Pub/Sub API service on your\nproject: \n\n gcurl -d '{}' \"https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services/pubsub.googleapis.com:enable\"\n\nThe\n[`services.enable`](/service-usage/docs/reference/rest/v1/services/enable)\nmethod returns a\n[Long Running Operation](/service-usage/docs/reference/rest/v1/operations)\nresource, which represents ongoing work on the server. Each operation has\na unique resource name. For example, here is an operation\nwith the name `operations/acf.2e2fcfce-8327-4984-9040-a67777082687`: \n\n {\n \"name\": \"operations/acf.2e2fcfce-8327-4984-9040-a67777082687\"\n }\n\nTo poll the operation status by using the Service Usage\n[`operations.get`](/service-usage/docs/reference/rest/v1/operations/get)\nmethod, pass the name of the operation to the API: \n\n OPERATION_NAME=\"operations/acf.2e2fcfce-8327-4984-9040-a67777082687\"\n gcurl \"https://serviceusage.googleapis.com/v1/${OPERATION_NAME}\"\n\n### Enable multiple services at once\n\nIf you want to enable multiple API services on your project, you can issue\nan enable command for each API service individually, or you can issue one\nbatch enable command and specify multiple APIs. For example, to enable both\nthe Pub/Sub and Dataflow API services on your project: \n\n gcurl -d '{\n \"serviceIds\": [\"pubsub.googleapis.com\", \"dataflow.googleapis.com\"]\n }' \"https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services:batchEnable\"\n\nLike `services.enable`, [`services.batchEnable`](/service-usage/docs/reference/rest/v1/services/batchEnable)\nreturns an operation resource, which you can poll by using its `name`.\n| **Note:** The process for enabling APIs can vary. Some APIs prompt you to accept their Terms of Service before you can enable them. Some APIs are in preview mode and require special signup and whitelisting before you can use them. Other APIs might ask for additional information, such as your organization's contact information and the name of the application you are developing. When more information is requested, it will not be shared outside of Google; it's used to help Google understand how the API is being used and as a secondary contact should we need to contact you regarding your use of the service.\n\nDisabling services\n------------------\n\nDisabling services uses quota from the\n`serviceusage.googleapis.com/mutate_requests` quota metric. The default\navailable quota is 2 queries per second (QPS).\n\nYou can disable an API for a project at any time, although any pending fees will\nstill be charged to your account and you'll be charged for any billable API use\nin your projects. For more information, see\n[APIs and Billing](https://support.google.com/cloud/answer/6158867).\n\nMany services like Cloud Storage and BigQuery charge to store data. Disabling a\nservice's API access does not delete the underlying data which will continue\nto be billed. If your intent is to discontinue using a service and stop all\nfuture charges, be sure to delete all data associated with the service before\ndisabling the service's API access.\n\nIf you disable the GKE API, any running clusters in the project become suspended. After 30 days, the suspended clusters are deleted. To reinstate your suspended clusters, enable the GKE API. It may take up to 24 hours for the clusters to be reinstated.\n**Note:** In v1 of the API, if you attempt to disable a service that other enabled services depend on, the call will fail. The API call to disable the service will result in an error message. To disable the specified service and all of the services that depend on it, set the `disable_dependent_services` parameter on the [`services.disable`](/service-usage/docs/reference/rest/v1/services/disable) request to `true`. \n\n### console\n\nTo disable an API for a project:\n\n1. Go to the Google Cloud console [API Dashboard](https://console.cloud.google.com/project/_/apis/dashboard) page. \n [Go to the API Dashboard page](https://console.cloud.google.com/project/_/apis/dashboard)\n2. Select the Google Cloud project where you want to disable\n an API by performing one of the following:\n\n - Click on a Google Cloud project under **Select a recent project**.\n\n - Use the Google Cloud project browser by performing the following\n steps:\n\n 1. Click **Select project** to open the Google Cloud project browser.\n 2. Find your project and then click on the Google Cloud project name.\n 3. Click **Open** to open the project.\n3. Click the API you want to disable. If you need help finding the API, use\n the **Search for APIs \\& Services** box near the top of the page. A page\n describing the API appears.\n\n4. Click *stop* **Disable API**.\n\n### gcloud\n\nRun the following command to disable the Pub/Sub API service for\nyour current project: \n\n```\ngcloud services disable pubsub.googleapis.com\n```\n\nThe command produces output similar to the following: \n\n```\nWaiting for async operation operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8 to complete...\nOperation finished successfully.\n```\n\nYou can use the following command to get the operation details: \n\n```\ngcloud services operations describe operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8\n```\n\n### curl\n\nThe following command disables the Pub/Sub API service on\nyour project: \n\n gcurl -d '{}' \"https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services/pubsub.googleapis.com:disable\"\n\nLike `services.enable`, [`services.disable`](/service-usage/docs/reference/rest/v1/services/disable)\nreturns an operation resource, which you can poll by using its `name`."]]
