技能 硬件工程 查询CAST AI集群和成本报告

查询CAST AI集群和成本报告

v20260423
castai-hello-world
该技能提供了一套完整的API调用流程,用户可以通过`curl`命令与CAST AI平台交互。它可以用于列出所有连接的Kubernetes集群、获取详细的成本节省报告,并检查集群节点库存。适用于环境连接验证、云成本审计以及资源状态监控。
获取技能
483 次下载
概览

CAST AI Hello World

Overview

First API calls against the CAST AI REST API: list connected clusters, retrieve the savings report, and inspect node inventory. All examples use curl with the X-API-Key header -- no SDK required.

Prerequisites

  • Completed castai-install-auth setup
  • CASTAI_API_KEY environment variable set
  • At least one cluster connected to CAST AI

Instructions

Step 1: List Connected Clusters

curl -s -H "X-API-Key: ${CASTAI_API_KEY}" \
  https://api.cast.ai/v1/kubernetes/external-clusters \
  | jq '.items[] | {id, name, status, providerType}'

Expected output:

{
  "id": "abc123-def456",
  "name": "production-eks",
  "status": "ready",
  "providerType": "eks"
}

Step 2: Get Cluster Savings Report

export CASTAI_CLUSTER_ID="your-cluster-id"

# Current month savings
curl -s -H "X-API-Key: ${CASTAI_API_KEY}" \
  "https://api.cast.ai/v1/kubernetes/clusters/${CASTAI_CLUSTER_ID}/savings" \
  | jq '{
    monthlySavings: .monthlySavings,
    savingsPercentage: .savingsPercentage,
    currentCost: .currentMonthlyCost,
    optimizedCost: .optimizedMonthlyCost
  }'

Step 3: List Cluster Nodes

curl -s -H "X-API-Key: ${CASTAI_API_KEY}" \
  "https://api.cast.ai/v1/kubernetes/external-clusters/${CASTAI_CLUSTER_ID}/nodes" \
  | jq '.items[] | {
    name: .name,
    instanceType: .instanceType,
    lifecycle: .lifecycle,
    cpu: .allocatableCpu,
    memory: .allocatableMemory,
    zone: .zone
  }'

Step 4: Check Autoscaler Policies

curl -s -H "X-API-Key: ${CASTAI_API_KEY}" \
  "https://api.cast.ai/v1/kubernetes/clusters/${CASTAI_CLUSTER_ID}/policies" \
  | jq '{
    enabled: .enabled,
    unschedulablePods: .unschedulablePods.enabled,
    nodeDownscaler: .nodeDownscaler.enabled,
    spotInstances: .spotInstances.enabled
  }'

Output

  • List of connected clusters with IDs and status
  • Monthly savings report with before/after cost
  • Node inventory with instance types and lifecycle (spot vs on-demand)
  • Autoscaler policy status

Error Handling

ErrorCauseSolution
401 UnauthorizedBad API keyRegenerate at console.cast.ai
404 Not FoundWrong cluster IDList clusters first to get correct ID
Empty items arrayNo clusters connectedRun castai-install-auth to onboard
agentStatus: offlineAgent not runningCheck kubectl get pods -n castai-agent

Resources

Next Steps

Proceed to castai-local-dev-loop to set up a development workflow.

信息
分类 硬件工程
名称 castai-hello-world
版本 v20260423
大小 3.24KB
更新时间 2026-04-27
语言