Este guia fornece todos os passos de configuração necessários para começar a usar a API Cloud Billing Budget.
Antes de começar
Antes de ler este guia, deve fazer o seguinte:
Acerca da Google Cloud consola
A Google Cloud consola (visite a documentação, abra a consola) é uma IU da Web usada para aprovisionar, configurar, gerir e monitorizar sistemas que usam Google Cloud produtos. Utiliza a Google Cloud consola para configurar e gerir Google Cloud recursos do Google Cloud e da Cloud Billing.
1. Selecione ou crie um projeto
Para usar os serviços fornecidos pela Google Cloud, tem de criar um projeto. Um projeto organiza todos os seus Google Cloud recursos. Um projeto consiste num conjunto de colaboradores, APIs ativadas (e outros recursos), ferramentas de monitorização, informações de faturação e controlos de autenticação e acesso. Pode criar um projeto ou vários projetos e usá-los para organizar os seus recursos numa hierarquia de recursos.Google Cloud Para mais informações sobre projetos, consulte a documentação do Resource Manager.
Recomendação sobre projetos: recomendamos que crie e use um projeto Google Cloud separado para satisfazer todas as suas necessidades de administração de faturação e FinOps para uma conta do Cloud Billing, incluindo a sua utilização da API Google Cloud Billing Budget. Saiba mais sobre as vantagens de usar um projeto focado em FinOps para os seus exemplos de utilização de administração de faturação.
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
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
2. Ativar faturação
Tem de se certificar de que a faturação está ativada no projeto que está a usar para chamar a API Cloud Billing Budget. Se seguiu a recomendação na secção do projeto, este é o seu projeto de administração de faturação ou FinOps Google Cloud .
Verify that billing is enabled for your Google Cloud project.
Uma conta de faturação do Google Cloud é usada para definir quem paga por um determinado conjunto de Google Cloud recursos. Os recursos, como as APIs ativadas, estão organizados em projetos. Uma conta de faturação do Google Cloud pode ser associada a um ou mais projetos. A utilização do projeto é cobrada à conta de faturação associada. Na maioria dos casos, configura a faturação quando cria um projeto. Para mais informações, consulte a documentação do Cloud Billing.
Custo de utilização
Configura orçamentos do Cloud Billing para monitorizar os custos incorridos numa conta do Cloud Billing. A conta do Cloud Billing que está a monitorizar pode ser a mesma conta do Cloud Billing associada ao projeto que usa para chamar a API Cloud Billing Budget. Tenha em atenção que a API Cloud Billing Budget é gratuita para Google Cloud clientes. Se optar por configurar notificações de orçamento programáticas, ser-lhe-ão cobrados os preços padrão do Pub/Sub.
3. Ative a API
Tem de ativar a API Cloud Billing Budget no projeto que está a usar para chamar a API Cloud Billing Budget. Se seguiu a recomendação na secção do projeto, este é o seu projeto de administração de faturação ou FinOps Google Cloud .
Para mais informações sobre a ativação de APIs, consulte a documentação de utilização de serviços.
Enable the Cloud Billing Budget 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.
4. Configure a autenticação e a autorização
Se planeia usar a API Cloud Billing Budget, tem de configurar a autenticação. Qualquer aplicação cliente que use a API tem de confirmar a sua identidade através da autenticação. Para ver detalhes, consulte o artigo Autentique-se na Faturação na nuvem.
Autentica-se como um principal específico, como uma Conta Google ou uma conta de serviço. Esse principal tem de ter funções da gestão de identidade e de acesso (IAM) que contenham as autorizações necessárias para a API Cloud Billing Budget.
Para garantir que o principal tem as autorizações
necessárias para gerir orçamentos,
peça ao seu administrador para conceder ao principal a função do IAM
Administrador da conta de faturação (roles/billing.admin)
na sua conta de faturação.
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.
O administrador também pode conceder ao principal as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.
Para saber como conceder funções numa conta de faturação, consulte o artigo Atualize as autorizações do Cloud Billing.
5. Instale e inicialize a CLI gcloud
Se planeia usar a API Cloud Billing Budget, tem de instalar e inicializar a CLI Google Cloud. A Google Cloud CLI é um conjunto de ferramentas que pode usar para gerir recursos e aplicações alojados no Google Cloud. Isto inclui a CLI gcloud. O seguinte link fornece instruções:
Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando:
gcloud initSe estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.
6. Teste o SDK e a autenticação
Se configurou a autenticação nos passos anteriores, pode usar a CLI gcloud para testar o seu ambiente de autenticação. Execute o seguinte comando para verificar se não ocorre nenhum erro e se são devolvidas credenciais:
gcloud auth print-access-token
Esse comando é usado por todos os exemplos REST da linha de comandos da API Cloud Billing Budget para autenticar chamadas API.
7. Instale a biblioteca cliente da API Cloud Billing Budget
A API Cloud Billing Budget é criada com base em HTTP e JSON, pelo que qualquer cliente HTTP padrão pode enviar pedidos para a mesma e analisar as respostas.
Tem três opções para chamar a API:
Bibliotecas cliente suportadas pela Google (recomendado)
As bibliotecas cliente oferecem uma melhor integração de linguagem, segurança melhorada e suporte para fazer chamadas que requerem autorização do utilizador. As bibliotecas cliente suportadas pela Google estão disponíveis para vários idiomas populares e são a opção recomendada.