利用データをFOCUS形式でエクスポート

FinOps Open Cost & Usage Specification (FOCUS) フォーマットで IBM Cloud® の使用状況データをエクスポートして、マルチクラウドのコスト管理を簡素化し、 FinOps ツールとのシームレスな統合を可能にします。

FOCUSフォーマットは、 FinOps Foundationによって開発されたクロス・クラウド標準であり、クラウド・プロバイダー間の課金・利用データを正規化する。 IBM Cloud、コストと利用報告のためにFOCUS v1.2 ( FinOps Open Cost and Usage Specification)フォーマットをサポートするようになった。 IBM Cloud の使用量データを FOCUS フォーマットでエクスポートすることで、 AWS、 Azure、 GCP のデータとともに、 IBM Cloud のコストをカスタム変換なしで分析することができます。 詳細については、 FinOps Foundation FOCUS v1.2 仕様を 参照。

開始前に

利用データを FOCUS フォーマットでエクスポートする前に、以下のアクセスとリソースがあることを確認してください：

  • 課金管理者またはアカウント所有者は、 IBM Cloud アカウントアクセスできます
  • IBM Cloud コンソールまたはCLIへのアクセス
  • コスト管理および FinOps ツールの要件を理解する

FOCUSフォーマットのメリットを理解する

FOCUSフォーマットには、クラウドのコスト管理にいくつかの利点があります：

強化されたマルチクラウドの可視性
AWS Cost and Usage Reports (CUR)、 Azure CSV exports、 GCP billing data と共に IBM Cloud usage data を正規化し、統一されたコスト分析を行う。
ツールとの直接統合
Apptio Cloudability, CloudHealth, Kubecost などの FinOps プラットフォームや、その他のコスト最適化ツールに、カスタム変換スクリプトなしで FOCUS フォーマットのデータを直接インポート。
オンボーディング時間の短縮
手作業によるデータ変換プロセスを排除し、 IBM Cloud 請求データをコスト管理ワークフローに統合するために必要な時間とコストを削減します。
透明性の向上
業界のベストプラクティスに沿った標準化された請求ディメンションにアクセスすることで、 IBM Cloud の料金を理解し、検証することが容易になります。
競争力のあるパリティ
他の主要なクラウドサービスプロバイダーが使用しているのと同じ標準化されたフォーマットを利用することで、マルチクラウド環境全体で一貫したコスト管理を実現できます。

利用データのエクスポート

インスタンスレベルの使用状況データは、個々のリソースインスタンスに関する詳細な情報を提供し、詳細なコスト配分とチャージバックを可能にします。

  1. IBM Cloud コンソールにログインする。
  2. 「管理」 > 「請求および使用量」 > **「使用量」**に進みます。
  3. FOCUS ボタンをクリックします。 システムは、FOCUS v1.2 フォーマットのインスタンスレベルの使用量データを含む CSV ファイルをダウンロードします。

完全対応フィールド

IBM CSV ファイルには、FOCUS v1.2 の必須フィールドがすべて含まれています：

完全にサポートされているMUSTフィールド
フィールド タイプ 説明
BilledCost 10 進法 お客様請求額
BillingCurrency ストリング 通貨コード (ISO 4217)
ChargeCategory ストリング 料金の種類（利用、購入、税金、調整）
ChargeDescription ストリング チャージ内容
ChargePeriodEnd DateTime 充電期間終了（ISO 8601）
ChargePeriodStart DateTime 充電期間の開始（ISO 8601）
EffectiveCost 10 進法 割引後の償却原価
ListUnitPrice 10 進法 割引前の1台あたりの定価
PricingCategory ストリング 料金モデル
PricingQuantity 10 進法 価格設定に使用する数量
PricingUnit ストリング 価格設定の単位
ProviderName ストリング 常に " IBM "
PublisherName ストリング サービス発行者名
ResourceId ストリング 一意のリソース識別子
ResourceName ストリング リソース名
ServiceCategory ストリング ハイレベル・サービス・カテゴリー
ServiceName ストリング サービスの名前
SkuId ストリング SKU識別子

追加サポートフィールド

IBM Cloud FOCUSレポートには、16の必須フィールド以外に39の追加フィールドがある：

その他の対応フィールド
カテゴリ フィールド名
アカウント請求 BillingAccountId, BillingAccountName, BillingAccountType, BillingPeriodEnd, BillingPeriodStart, InvoiceIssuerName
地理的だ： AvailabilityZone, RegionId, RegionName
コミットメントと割引： CommitmentDiscountCategory, CommitmentDiscountId, CommitmentDiscountName, CommitmentDiscountType, CommitmentDiscountUnit
費用の内訳： ContractedCost, ContractedUnitPrice, ListCost
料金の詳細 ChargeClass, ChargeFrequency
使用量: ConsumedQuantity, ConsumedUnit
料金: PricingCurrency, SkuMeter
リソースのメタデータ： ResourceType, ServiceSubcategory, Tags
IBM-特定の拡張： x_DiscountId, x_DiscountName, x_DiscountQuantity, x_OfferId, x_OfferCredit

APIを使用した利用データのエクスポート

IBM Cloud Usage Reports API を使用して、使用量データのエクスポートを自動化できます。 詳細については、 使用状況レポートAPIを 参照してください。

  1. 適切な課金アクセス権を持つAPIキーを取得する。 詳しくは、API キーの管理を参照してください。

  2. 利用データをエクスポートするには、以下のAPIエンドポイントを使用します：

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

{account_id} を IBM Cloud のアカウント ID（必須）、 {month} を YYYY-MM 形式のレポート月（例：2024-01）、 {iam_token} を IAM アクセストークンに置き換えてください。

API パラメーター

FOCUS エクスポート API は以下のパラメータをサポートしています： account_id （必須） : IBM Cloud アカウント ID。

month （必須）
月をYYYY-MM形式で報告する（例：2024-01）。

Headers: Authorization （必須） : IAM 認証用のベアラ・トークン。

x-focus-version (オプション)
使用する FOCUS バージョン (デフォルト: 1.2 )。 キャッシュをバイパスして新しいレポートを生成するには、 true に設定します。

Query Parameters:

format
オプションには以下のものがあります。
  • json (default)- ページ分割された JSON 形式で結果を返します。
  • csv- すべての結果を CSV 形式で返します。
_limit (オプション)
ページネーションの上限、最大250（デフォルト：200）。

FOCUS フォーマットのエクスポートの検証：

エクスポートされたデータが FOCUS v1.2 の仕様に適合していることを確認するために、 FinOps Foundation の FOCUS Validator ツールを使用してファイルを検証することができます。 IBM Cloud FOCUS のエクスポートは、16 の必須フィールド（MUST）すべてにおいて 100% 準拠のバリデーションに合格するように設計されています。

IBM ネイティブフォーマットと FOCUS v1.2 フォーマットの比較

IBM ネイティブフォーマットと FOCUS v1.2 フォーマットの両方が利用可能です。 以下の表は、主な相違点のハイライトである：

フォーマット比較
局面 IBM ネイティブ・フォーマット FOCUS v1.2 フォーマット
列名 IBM-特定命名規則 標準化された FOCUS v1.2 列名
マルチクラウド対応 IBM Cloud のみ AWS, Azure と互換性がある、 GCP
FinOps ツールサポート カスタム変換が必要 ダイレクト・インポートに対応
データ細分度 同レベルのディテール 同レベルのディテール
コンプライアンス IBM-具体的 FOCUS v1.2 に100%準拠（16/16のMUSTフィールド）
ユース・ケース IBM-特定の分析と報告 マルチクラウドのコスト管理と FinOps ツール

組織内のさまざまなユースケースをサポートするために、両方のフォーマットで同時にデータをエクスポートすることができます。

次のステップ

FOCUS形式で利用データをエクスポートした後は、以下のことができます：