Prácticas recomendadas para el etiquetado de uso

En el caso de los productos de SaaS basados en el uso, Google Cloud Marketplace atribuye el uso a un único proyectoGoogle Cloud , especificado por el campo usageReportingId. En algunos casos, un producto de SaaS se puede compartir de forma generalizada en la organización de un cliente y se puede usar en muchos proyectos del cliente. Para habilitar la compatibilidad con una atribución de costes más específica, recomendamos que los productos SaaS basados en el uso incluyan el campo opcional userLabels en su informe de uso operation.

Si tu servicio ya admite el concepto de etiquetas de recursos, te recomendamos que reenvíes esas etiquetas en tus informes de uso. Las etiquetas deben cumplir los requisitos de sintaxis.

Etiquetas de uso

Cloud Marketplace reserva las siguientes etiquetas. Puedes usar estas etiquetas para identificar contexto adicional sobre el uso en tu plataforma de servicios. Te recomendamos que incluyas estas etiquetas en tus informes de uso de forma predeterminada.

Las etiquetas se reenvían a las herramientas de gestión de costes de Facturación de Cloud, como los informes de costes y las exportaciones de facturación.

Ejemplo de etiquetado de uso

En este ejemplo, supongamos que tu organización ofrece un producto de almacenamiento llamado SaaS Storage Solutions.

Un cliente, Carlos, ha comprado tu oferta de almacenamiento para suGoogle Cloud proyecto e-commerce-website, con el fin de alojar las bases de datos user_profiles_db y products_db de su sitio web de comercio electrónico:

• user_profiles_db contiene información sobre los usuarios que visitan el sitio de Carl.
• products_db contiene información sobre los productos que vende Carl en su sitio.

Si quieres proporcionar a Carl un desglose detallado de los costes de su uso, puedes usar el par clave-valor userLabels para informar del coste del uso de cada base de datos por separado.

Por ejemplo, para informar del coste atribuido al products_db almacenamiento de Carl, puede enviar el siguiente informe, que indica que el products_db almacenamiento de Carl le cuesta 100 unidades:

operation = {
  'operationId': '<UUID>',
  'operationName': 'db-total-storage',
  'consumerId': 'project:carl_website',
  'startTime': '<Timestamp>',
  'endTime': '<Timestamp>',
  'metricValues': [{
      'int64Value': 100,
  }],
  'userLabels': {
    'cloudmarketplace.googleapis.com/container_name': 'e-commerce-website',
    'cloudmarketplace.googleapis.com/resource_name': 'products_db'
  }
}

service.services().report(
  serviceName=service_name, body={
    'operations': [operation]
}).execute()

En este ejemplo, service_name es el ID de proyecto de Carl. Google Cloud

Para ver un ejemplo más detallado de cómo usar userLabels, consulta el codelab de SaaS.