Cómo obtener la huella de carbono de los servicios de OVHcloud

Objetivo

En el marco de sus actividades profesionales o por interés sobre el tema, es posible que deba calcular la huella de carbono de sus servicios.

Descubra cómo recuperar mensualmente la huella de carbono de sus servicios de OVHcloud.

Requisitos

• Ser contacto de "Facturación" de los servicios para los que desea obtener la huella de carbono. Para más información, consulte nuestra guía sobre la gestión de contactos.

El cálculo de la huella de carbono está disponible para los siguientes servicios:

• Servidor dedicado (Advance, Game, Scale, High Grade, Storage)
• Servidor Dedicado Eco (Rise, Kimsufi, So You Start)
• VMware on OVHcloud
• Public Cloud

Procedimiento

Tenga en cuenta los siguientes puntos:

• No puede generar un balance de situación para el mes en curso.
• Si introduce una fecha de inicio, mitad o fin de mes para el mes seleccionado a través de la API de OVHcloud, el balance tendrá en cuenta el mes completo.
• No se pueden generar balances después de los últimos 24 meses.
• No es posible generar ningún balance del período anterior a la fecha de puesta en marcha de la funcionalidad para cada servicio de OVHcloud (ver la tabla a continuación).

Disponibilidad de los datos de huella de carbono:

Obtener el balance mensual del mes anterior desde el área de cliente de OVHcloud

1. Conéctese al área de cliente de OVHcloud.
2. En la página que aparece, en la columna izquierda, desplácese hasta la sección que contiene los Enlaces útiles y haga clic en la pestaña Mi huella de carbono.
3. En la nueva página que aparece, haga clic en Descargar mi huella de [Mes] [Año].

Podrá recuperar cada mes la huella de carbono del mes anterior para sus servicios elegibles.

Si necesita la huella de carbono durante un mes anterior al mes anterior al mes en curso, deberá utilizar obligatoriamente nuestras API para recuperarla.

Recuperar un balance mensual anterior al mes anterior a través de nuestras API

Por defecto, las API de OVHcloud están disponibles para que los desarrolladores o integradores puedan asociar, por ejemplo, funcionalidades presentes o no en el área de cliente de OVHcloud directamente en sus aplicaciones o soluciones.

Etapa 1 - Conectarse a la API OVHcloud

• Visite nuestro sitio web API OVHcloud (compruebe que está en https://eu.api.ovh.com si sus servicios están alojados en Europa y en https://ca.api.ovh.com si están alojados fuera de Europa).
• En la nueva página, haga clic en Explore the OVHcloud API.
• En la nueva página que aparece, en el lado izquierdo de la página, sitúese en el formulario situado a la derecha del campo v1 y seleccione/introduzca la opción /me.
• Entre la lista de llamadas API que aparece a continuación, busque y haga clic en la siguiente llamada API: POST /me/carbonCalculator/task. También puede hacer clic directamente en la siguiente llamada a la API para acceder:

• En la parte derecha de la página aparece la API con su recuadro a completar.
• Haga clic en el botón situado en la esquina superior derecha, titulado Authenticate, y luego en el botón Login with OVHcloud SSO.
• Se abrirá la interfaz de conexión a su área de cliente de OVHcloud.
• Conéctese con su ID de cliente y haga clic en Authorize para utilizar las API de OVHcloud con sus servicios.
• A continuación, el sistema le redirigirá automáticamente a la página anterior de la API POST /me/carbonCalculator/task.

Etapa 2 - Solicitar la generación de la hoja de balance y obtener el ID de la tarea solicitada

Sustituya la fecha actual que aparece en el recuadro de la API por la fecha en la que desea detener el cálculo del balance de situación. Utilice el siguiente formato de fecha:

{
  "date": "YYYY-MM-DD"
}

Una vez que haya elegido la fecha y la haya introducido correctamente, haga clic en el botón azul EXECUTE situado en la parte inferior derecha de la sección que haya rellenado.

Si todo se ha realizado correctamente, aparecerá un taskID en la ventana RESPONSE al bajar a la página, debajo del botón EXECUTE.

Por ejemplo, si su ID de cliente de OVHcloud es el aa00000-ovh y la fecha elegida anteriormente era el 31-01-2025, obtendrá el siguiente resultado:

{
  "taskID": "aa00000-ovh_202501"
}

Copie únicamente el valor obtenido de su lado y equivalente al valor de nuestro ejemplo aa00000-ovh_202501 (sin copiar los dos " situados en los extremos).

Etapa 3 - Obtener el archivo que contiene el balance de carbono de sus servicios en formato PDF

Gracias al valor del taskID recuperado anteriormente, podrá recuperar el balance de carbono de sus servicios en formato PDF.

Permanezca en nuestro sitio web API OVHcloud y realice las siguientes acciones:

• En la parte izquierda de la página, sitúese en el formulario situado a la derecha del formulario v1 y seleccione/introduzca la opción /me.
• Entre la lista de llamadas API que aparece a continuación, busque y haga clic en la siguiente llamada API: GET /me/carbonCalculator/task/{taskID}. También puede hacer clic directamente en la siguiente llamada a la API para acceder:

• En la parte derecha de la página se muestra la llamada API con un formulario a rellenar.

Rellene el formulario de la sección PATH PARAMETERS del siguiente modo:

• taskID: copie aquí el valor del taskID recuperado en la etapa 2.

Una vez introducido correctamente el valor de su taskID, haga clic en el botón azul EXECUTE.

El siguiente resultado aparece en la ventana RESPONSE cuando se desplaza a la página, debajo del botón EXECUTE:

{
  "link": "Find here the complete URL to download the carbon footprint in PDF format",
  "status": "SUCCESS",
  "taskID": "aa00000-ovh_202501"
}

En este resultado, copie la URL completa en "HTTPS" (sin las comillas) a la derecha de la mención "link": y péguela en la barra de búsqueda de su navegador de Internet para iniciar la descarga del balance de carbono en formato PDF.

Su navegador de Internet descargará automáticamente el archivo y lo mostrará.

Una vez abierto el archivo, podrá ver lo siguiente:

• Una tabla de las emisiones de C02 por categoría para el mes solicitado.
• Un cuadro de las emisiones de C02 por categoría entre el comienzo del año natural y el mes solicitado.
• Una tabla que detalla los valores por tipo de producto suscrito.
• Un gráfico que muestra las emisiones de C02 por categoría.

Más información

Primeros pasos con las API de OVHcloud

Para servicios especializados (posicionamiento, desarrollo, etc.), contacte con partners de OVHcloud.

Si quiere disfrutar de ayuda para utilizar y configurar sus soluciones de OVHcloud, puede consultar nuestras distintas soluciones pestañas de soporte.

Interactúe con nuestra comunidad de usuarios.