以 FOCUS 格式匯出使用量資料
以 FinOps Open Cost & Usage Specification (FOCUS) 格式匯出您的 IBM Cloud® 使用量資料，以簡化多雲端成本管理，並與 FinOps 工具進行無縫整合。
IBM Cloud 現在支援 FOCUS v1.2 ( FinOps Open Cost and Usage Specification) 格式，用於成本和使用情況報告。FOCUS 格式是 FinOps Foundation 開發的跨雲標準，可將各雲供應商的計費和使用情況資料規範化。 透過以 FOCUS 格式匯出 IBM Cloud 使用量資料，您就可以分析 IBM Cloud 成本與 AWS、Azure 及 GCP 資料，而不需要自訂轉換。 如需詳細資訊，請參閱 FinOps Foundation FOCUS v1.2 規格。
開始之前
在您以 FOCUS 格式匯出使用量資料之前，請確保您擁有下列存取權限和資源：
- 計費管理員或帳戶所有人可存取 IBM Cloud 帳戶
- 存取 IBM Cloud 主控台或 CLI
- 瞭解您的成本管理和 FinOps 工具需求
瞭解 FOCUS 格式的優點
FOCUS 格式為管理雲端成本提供了多項優勢：
- 強化多雲端能見度
- 將 IBM Cloud 使用量資料與 AWS 成本與使用量報告 (CUR)、Azure CSV 匯出，以及 GCP 帳單資料進行規範化，以進行統一的成本分析。
- 直接工具整合
- 將 FOCUS 格式的資料直接匯入 FinOps 平台，例如 Apptio Cloudability、CloudHealth, Kubecost 以及其他成本最佳化工具，而不需要自訂轉換腳本。
- 縮短上線時間
- 消除手動資料轉換程序，減少將 IBM Cloud 帳單資料整合至成本管理工作流程所需的時間和成本。
- 提高透明度
- 存取符合業界最佳實務的標準化帳單尺寸，讓您更容易瞭解和驗證 IBM Cloud 費用。
- 競爭力均等
- 受益於其他領先雲端服務供應商所使用的相同標準化格式，確保在您的多雲端環境中採用一致的成本管理作法。
匯出使用資料
實體層級的使用資料提供個別資源實體的詳細資訊，可進行詳細的成本分配和收費。
- 登入 IBM Cloud 主控台。
- 移至 Manage > Billing and usage > Usage。
- 按一下 FOCUS 按鈕。 系統下載一個 CSV 檔案，其中包含 FOCUS v1.2 格式的實體級使用資料，以及用於特定資源詳細資訊的附加列。
完全支援的欄位
IBM CSV 檔案包含所有必須填寫的 FOCUS v1.2 欄位：
| 欄位 | 類型 | 說明 |
|---|---|---|
BilledCost |
十進位 | 向客戶收取的費用 |
BillingCurrency |
字串 | 貨幣代碼 (ISO 4217) |
ChargeCategory |
字串 | 收費類型 (使用、購買、稅金、調整) |
ChargeDescription |
字串 | 指控說明 |
ChargePeriodEnd |
DateTime | 收費期間結束 (ISO 8601) |
ChargePeriodStart |
DateTime | 收費期間開始 (ISO 8601) |
EffectiveCost |
十進位 | 折現後的攤銷成本 |
ListUnitPrice |
十進位 | 折扣前每單位上市價格 |
PricingCategory |
字串 | 定價模型 |
PricingQuantity |
十進位 | 用於定價的數量 |
PricingUnit |
字串 | 計價單位 |
ProviderName |
字串 | 永遠 " IBM " |
PublisherName |
字串 | 服務發行商名稱 |
ResourceId |
字串 | 唯一的資源識別碼 |
ResourceName |
字串 | 資源名稱 |
ServiceCategory |
字串 | 高階服務類別 |
ServiceName |
字串 | 服務的名稱 |
SkuId |
字串 | SKU 識別碼 |
其他支援的欄位
除了 16 個必填欄位外，IBM Cloud FOCUS 報告還包括 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。
-
取得具有適當帳務存取權限的 API 金鑰。 如需詳細資訊，請參閱 管理 API 金鑰。
-
使用下列 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）。
標頭：
Authorization （必要） : 用於 IAM 驗證的承載符記號。
x-focus-version（選用）- 要使用的 FOCUS 版本 (預設值: 1.2 )。 設定為
true可繞過快取記憶體並產生新報告。
Query Parameters:
format- 這些選項包括：
- json (預設)- 將以分頁 JSON 格式傳回結果。
- csv- 將以 CSV 格式傳回所有結果。
_limit（選用）- 分頁限制，最大 250 (預設值：200)。
驗證 FOCUS 格式匯出：
為確保您匯出的資料符合 FOCUS v1.2 規格，您可以使用 FinOps Foundation 的 FOCUS 驗證工具來驗證檔案。 IBM Cloud FOCUS 匯出的設計是為了通過驗證，100% 符合所有 16 個強制 MUST 欄位。
比較 IBM 原始格式與 FOCUS v1.2 格式
IBM 本機和 FOCUS v1.2 兩種格式都可用於用途匯出。 下表強調了主要差異：
| 層面 | IBM 原生格式 | FOCUS v1.2 格式 |
|---|---|---|
| 直欄名稱 | IBM-特定命名慣例 | 標準化 FOCUS v1.2 列名 |
| 多雲端相容性 | IBM Cloud 只有 | 相容於 AWS, Azure、GCP |
| FinOps 工具支援 | 需要自訂轉換 | 支援直接匯入 |
| 資料精度 | 相同的詳細程度 | 相同的詳細程度 |
| 合規性 | IBM-特定 | 100% 符合 FOCUS v1.2 (16/16 MUST 欄位) |
| 使用案例 | IBM-特定分析與報告 | 多雲端成本管理與 FinOps 工具 |
您可以同時以兩種格式匯出資料，以支援組織內不同的使用情況。
下一步
以 FOCUS 格式匯出使用資料後，您可以
- 設定成本分配標籤，以改善成本歸因和扣款
- 分析您的使用情況，找出成本優化機會
- 實施 FinOps 最佳實務，以優化雲端成本