En esta guía se explican todos los pasos de configuración necesarios para empezar a usar la API Cloud Billing Budget.
Antes de empezar
Antes de leer esta guía, debes hacer lo siguiente:
- Consulta la descripción general de la API Budget de Facturación de Cloud.
- Consulta los requisitos previos de la API Budget de Facturación de Cloud.
Acerca de la consola Google Cloud
La Google Cloud consola (visitar documentación, abrir consola) es una interfaz web que se usa para aprovisionar, configurar, gestionar y monitorizar sistemas que usan productos deGoogle Cloud . Utilizas la consola para configurar y gestionar Google Cloud Google Cloud recursos de facturación de Cloud.
1. Seleccionar o crear un proyecto
Para usar los servicios que ofrece Google Cloud, debes crear un proyecto. Un proyecto organiza todos tus Google Cloud recursos. Un proyecto consta de un conjunto de colaboradores, APIs habilitadas (y otros recursos), herramientas de monitorización, información de facturación y controles de autenticación y acceso. Puedes crear un proyecto o varios y usarlos para organizar tusGoogle Cloud recursos en una jerarquía de recursos. Para obtener más información sobre los proyectos, consulta la documentación de Resource Manager.
Recomendación sobre los proyectos: te recomendamos que crees y uses un proyecto Google Cloud independiente Google Cloud para cubrir todas tus necesidades de FinOps y de administración de la facturación de una cuenta de Facturación de Cloud, incluido el uso de la API Cloud Billing Budget. Consulta más información sobre las ventajas de usar un proyecto centrado en FinOps en tus casos prácticos de administración de facturación.
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. Habilita la facturación
Debes asegurarte de que la facturación esté habilitada en el proyecto que utilices para llamar a la API Cloud Billing Budget. Si has seguido la recomendación de la sección de proyectos, este es tu proyecto de FinOps o de administración de facturación Google Cloud .
Verify that billing is enabled for your Google Cloud project.
Una cuenta de facturación de Cloud se usa para definir quién paga un conjunto determinado deGoogle Cloud recursos. Los recursos, como las APIs habilitadas, se organizan en proyectos. Una cuenta de facturación de Cloud se puede vincular a uno o varios proyectos. El uso del proyecto se carga en la cuenta de facturación vinculada. En la mayoría de los casos, la facturación se configura al crear un proyecto. Para obtener más información, consulta la documentación de Facturación de Cloud.
Coste de uso
Configura presupuestos de Facturación de Cloud para monitorizar los costes incurridos en una cuenta de Facturación de Cloud. La cuenta de Facturación de Cloud que monitorizas puede ser la misma que está vinculada al proyecto que usas para llamar a la API Cloud Billing Budget. Ten en cuenta que la API Cloud Billing Budget es gratuita para los clientes de Google Cloud . Si decide configurar las notificaciones de presupuesto programáticas, se le cobrarán los precios estándar de Pub/Sub.
3. Activar la API
Debes habilitar la API Cloud Billing Budget en el proyecto que utilices para llamar a la API Cloud Billing Budget. Si has seguido la recomendación de la sección de proyectos, este es tu proyecto de FinOps o de administración de facturación Google Cloud .
Para obtener más información sobre cómo habilitar APIs, consulta la documentación de Uso de Servicio.
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. Configurar la autenticación y la autorización
Si tienes previsto usar la API Cloud Billing Budget, debes configurar la autenticación. Cualquier aplicación cliente que use la API debe confirmar su identidad mediante la autenticación. Para obtener más información, consulta Autenticación en Facturación de Cloud.
Te autenticas como un principal específico, como una cuenta de Google o una cuenta de servicio. Ese principal debe tener roles de gestión de identidades y accesos (IAM) que contengan los permisos necesarios para la API Cloud Billing Budget.
Para asegurarte de que la cuenta principal tiene los permisos necesarios para gestionar los presupuestos, pide a tu administrador que le conceda el rol de gestión de identidades y accesos Administrador de cuenta de facturación (roles/billing.admin) en tu cuenta de facturación.
Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.
Es posible que tu administrador también pueda conceder al principal los permisos necesarios a través de roles personalizados u otros roles predefinidos.
Para saber cómo asignar roles en una cuenta de facturación, consulta el artículo Actualizar permisos de facturación de Cloud.
5. Instalar e inicializar gcloud CLI
Si tienes previsto usar la API Cloud Billing Budget, debes instalar e inicializar la CLI de Google Cloud. Google Cloud CLI es un conjunto de herramientas que puedes usar para gestionar recursos y aplicaciones alojados en Google Cloud. Esto incluye gcloud CLI. En el siguiente enlace se explica cómo hacerlo:
Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando:
gcloud initSi utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.
6. Probar el SDK y la autenticación
Si has configurado la autenticación en los pasos anteriores, puedes usar la CLI de gcloud para probar tu entorno de autenticación. Ejecuta el siguiente comando para verificar que no se produce ningún error y que se devuelven las credenciales:
gcloud auth print-access-token
Todos los ejemplos de REST de la línea de comandos de la API Cloud Billing Budget usan este comando para autenticar las llamadas a la API.
7. Instalar la biblioteca de cliente de la API Budget de Facturación de Cloud
La API Budget de Facturación de Cloud se basa en HTTP y JSON, por lo que cualquier cliente HTTP estándar puede enviarle solicitudes y analizar las respuestas.
Tienes tres opciones para llamar a la API:
Bibliotecas de cliente admitidas por Google (recomendado)
Las bibliotecas de cliente se integran mejor con los diferentes lenguajes de programación, ofrecen una mayor seguridad y permiten hacer llamadas a la API que necesiten autorización por parte del usuario. Las bibliotecas de cliente compatibles con Google están disponibles en varios lenguajes populares y son la opción recomendada.