Export von Nutzungsdaten im FOCUS-Format

Exportieren Sie Ihre IBM Cloud® Nutzungsdaten im FinOps Open Cost & Usage Specification (FOCUS) Format, um das Multi-Cloud-Kostenmanagement zu vereinfachen und eine nahtlose Integration mit FinOps Tools zu ermöglichen.

Das FOCUS-Format ist ein von der FinOps Foundation entwickelter Cloud-übergreifender Standard, der Abrechnungs- und Nutzungsdaten über Cloud-Anbieter hinweg normalisiert. IBM Cloud unterstützt jetzt das FOCUS-Format v1.2 ( FinOps Open Cost and Usage Specification) für Kosten- und Nutzungsberichte. Wenn Sie Ihre IBM Cloud Nutzungsdaten im FOCUS-Format exportieren, können Sie die Kosten von IBM Cloud zusammen mit den Daten von AWS, Azure und GCP ohne benutzerdefinierte Transformation analysieren. Weitere Informationen finden Sie in der Spezifikation der FinOps Foundation FOCUS v1.2.

Vorbereitende Schritte

Bevor Sie Nutzungsdaten im FOCUS-Format exportieren, müssen Sie sicherstellen, dass Sie über die folgenden Zugriffsrechte und Ressourcen verfügen:

  • Zugriff des Rechnungsadministrators oder Kontoinhabers auf das Konto IBM Cloud
  • Zugriff auf die IBM Cloud Konsole oder CLI
  • Verständnis für Ihre Anforderungen an Kostenmanagement und FinOps

Die Vorteile des FOCUS-Formats verstehen

Das FOCUS-Format bietet mehrere Vorteile für die Verwaltung Ihrer Cloud-Kosten:

Verbesserte Multi-Cloud-Transparenz
Normalisieren Sie IBM Cloud Nutzungsdaten mit AWS Kosten- und Nutzungsberichten (CUR), Azure CSV Exporten und GCP Rechnungsdaten für eine einheitliche Kostenanalyse.
Direkte Tool-Integration
Importieren Sie FOCUS-formatierte Daten direkt in FinOps Plattformen wie Apptio Cloudability, CloudHealth, Kubecost und andere Kostenoptimierungstools, ohne eigene Transformationsskripte.
Verkürzte Einführungszeit
Eliminieren Sie manuelle Datenumwandlungsprozesse und reduzieren Sie den Zeit- und Kostenaufwand für die Integration von IBM Cloud Rechnungsdaten in Ihre Kostenmanagement-Workflows.
Verbesserte Transparenz
Greifen Sie auf standardisierte Abrechnungsdimensionen zu, die mit den besten Praktiken der Branche übereinstimmen, und erleichtern Sie so das Verständnis und die Validierung Ihrer IBM Cloud Gebühren.
Wettbewerbliche Parität
Profitieren Sie von demselben standardisierten Format, das auch von anderen führenden Cloud-Service-Anbietern verwendet wird, und gewährleisten Sie so einheitliche Kostenmanagementpraktiken in Ihrer Multi-Cloud-Umgebung.

Exportieren von Nutzungsdaten

Nutzungsdaten auf Instanzebene liefern detaillierte Angaben zu einzelnen Ressourceninstanzen und ermöglichen so eine detaillierte Kostenzuweisung und Rückverrechnung.

  1. Melden Sie sich bei der Konsole IBM Cloud an.
  2. Rufen Sie Verwalten > Abrechnung und Nutzung > Nutzung auf.
  3. Klicken Sie auf die Schaltfläche FOCUS. Das System lädt eine Datei CSV herunter, die Nutzungsdaten auf Instanzebene im FOCUS-Format v1.2 enthält, mit zusätzlichen Spalten für ressourcenspezifische Details.

Vollständig unterstützte Felder

IBM CSV datei enthält alle obligatorischen FOCUS v1.2 Felder:

Vollständig unterstützte MUST-Felder
Feld Typ Beschreibung
BilledCost Dezimal Dem Kunden in Rechnung gestellte Kosten
BillingCurrency Zeichenfolge Währungscode (ISO 4217)
ChargeCategory Zeichenfolge Art des Entgelts (Verbrauch, Kauf, Steuer, Berichtigung)
ChargeDescription Zeichenfolge Beschreibung der Ladung
ChargePeriodEnd DateTime Ende des Abrechnungszeitraums (ISO 8601)
ChargePeriodStart DateTime Beginn des Entgeltzeitraums (ISO 8601)
EffectiveCost Dezimal Fortgeführte Anschaffungskosten nach Abschlägen
ListUnitPrice Dezimal Listenpreis pro Einheit vor Rabatten
PricingCategory Zeichenfolge Preismodell
PricingQuantity Dezimal Für die Preisfindung verwendete Menge
PricingUnit Zeichenfolge Maßeinheit für die Preisgestaltung
ProviderName Zeichenfolge Immer " IBM "
PublisherName Zeichenfolge Name des Herausgebers des Dienstes
ResourceId Zeichenfolge Eindeutige Kennung der Ressource
ResourceName Zeichenfolge Ressourcenname
ServiceCategory Zeichenfolge Hochrangige Dienstleistungskategorie
ServiceName Zeichenfolge Der Name des Service
SkuId Zeichenfolge SKU-Kennung

Zusätzlich unterstützte Felder

Neben den 16 Pflichtfeldern enthält IBM Cloud FOCUS-Berichte 39 weitere Felder:

Zusätzliche unterstützte Felder
Kategorie Feldname
Konto & Abrechnung: BillingAccountId, BillingAccountName, BillingAccountType, BillingPeriodEnd, BillingPeriodStart, InvoiceIssuerName
Geographisch: AvailabilityZone, RegionId, RegionName
Engagement & Rabatt: CommitmentDiscountCategory, CommitmentDiscountId, CommitmentDiscountName, CommitmentDiscountType, CommitmentDiscountUnit
Kostenaufschlüsselung: ContractedCost, ContractedUnitPrice, ListCost
Details zur Ladung: ChargeClass, ChargeFrequency
Verbrauch: ConsumedQuantity, ConsumedUnit
Preisstruktur: PricingCurrency, SkuMeter
Ressourcen-Metadaten: ResourceType, ServiceSubcategory, Tags
IBM-Spezifische Erweiterungen: x_DiscountId, x_DiscountName, x_DiscountQuantity, x_OfferId, x_OfferCredit

Exportieren von Nutzungsdaten über die API

Sie können den Export von Nutzungsdaten mit Hilfe der IBM Cloud Nutzungsberichte API automatisieren. Weitere Informationen finden Sie unter Verwendungsberichte-API.

  1. Besorgen Sie sich einen API-Schlüssel mit entsprechendem Abrechnungszugang. Weitere Informationen finden Sie unter API-Schlüssel verwalten.

  2. Verwenden Sie den folgenden API-Endpunkt, um Nutzungsdaten zu exportieren:

    curl -X GET "https://billing.cloud.ibm.com/v4/accounts/{account_id}/focus/{month}" \
  -H "Authorization: Bearer {iam_token}" \
  -H "Accept: text/csv"

Ersetzen Sie {account_id} durch Ihre IBM Cloud Konto-ID (erforderlich), {month} durch den Berichtsmonat im Format JJJJ-MM (z. B. 2024-01) und {iam_token} durch Ihr IAM-Zugangs-Token.

API-Parameter

Die FOCUS-Export-API unterstützt die folgenden Parameter: account_id (erforderlich) : Die IBM Cloud Konto-ID.

month (erforderlich)
Monat im Format JJJJ-MM melden (z. B. 2024-01).

Überschriften: Authorization (erforderlich) : Bearer-Token für die IAM-Authentifizierung.

x-focus-version (fakultativ)
Zu verwendende FOCUS-Version (Standard: 1.2 ). Setzen Sie diese Option auf true, um den Cache zu umgehen und einen neuen Bericht zu erstellen.

Query Parameters:

format
Folgende Optionen sind verfügbar:
  • json (Standard)- gibt die Ergebnisse im paginierten JSON-Format zurück.
  • csv- liefert alle Ergebnisse im Format CSV.
_limit (fakultativ)
Paginierungsgrenze, maximal 250 (Standard: 200).

Validierung von Exporten im FOCUS-Format:

Um sicherzustellen, dass Ihre exportierten Daten den Spezifikationen von FOCUS v1.2 entsprechen, können Sie die Dateien mit dem FOCUS-Validator-Tool der FinOps Foundation validieren. Die IBM Cloud FOCUS-Exporte sind so konzipiert, dass alle 16 obligatorischen MUST-Felder die Validierung zu 100 % erfüllen.

Vergleich der Formate IBM native und FOCUS v1.2

Für Nutzungsexporte stehen die Formate IBM native und FOCUS v1.2 zur Verfügung. In der folgenden Tabelle sind die wichtigsten Unterschiede aufgeführt:

Vergleich der Formate
Aspekt IBM Natives Format FOCUS v1.2 Format
Spaltennamen IBM-spezifische Namenskonventionen Standardisierte FOCUS v1.2 Spaltennamen
Multi-Cloud-Kompatibilität IBM Cloud nur Kompatibel mit AWS, Azure, GCP
FinOps werkzeugunterstützung Erfordert benutzerdefinierte Transformation Direktimport unterstützt
Datengranularität Gleicher Detaillierungsgrad Gleicher Detaillierungsgrad
Compliance IBM-spezifisch 100 % konform mit FOCUS v1.2 (16/16 MUSS-Felder)
Anwendungsfall IBM-spezifische Analyse und Berichterstattung Multi-Cloud-Kostenmanagement und FinOps Werkzeuge

Sie können Daten in beiden Formaten gleichzeitig exportieren, um verschiedene Anwendungsfälle in Ihrem Unternehmen zu unterstützen.

Nächste Schritte

Nachdem Sie Ihre Nutzungsdaten im FOCUS-Format exportiert haben, können Sie: