메뉴
cloudtower operation API and SDK. Use when working with the cloudtower-api or when the user needs to interact with this API.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Export large batches of summarized traffic-visualization flow rows from CloudTower as CSV. Best suited when you need broad cluster-wide flow snapshots rather than deep interactive TQL. Use when the user needs flow exports for downstream analysis or a plain file download.
查询 ZBS/ELF/SFS/SKS/CloudTower/Everoute/备份/复制等产品的监控指标信息，覆盖约 1400 个指标。只要用户涉及指标含义、指标名查找、告警规则解读、Grafana/Prometheus 指标说明，都应使用本 skill。典型触发场景：询问某个指标名（如 zbs_volume_read_iops、everoute_pod_restart_count）的含义或中文说明；用关键词（如"读延迟"、"GC"、"IOPS"、"NFS"、"备份仓库"）反查有哪些对应指标；看到告警或监控面板中的指标名不理解其含义；想了解某个子系统（如 chunk、volume、host、ELF VM、SFS、Everoute）有哪些相关监控指标。
Base skill for CloudTower observability. Use when 1) Querying metrics for cluster/host/disk/vm etc. through the VictoriaMetrics API. 2) Discovering which observability service (OVM) a cluster is bound to. 3) Performing generic broad-to-narrow metric drill-down. 4) Delegates metric-name discovery to the `metrics-lookup` skill and CloudTower resource inventory to the `cloudtower-api` skill.
| name | cloudtower-api |
| description | cloudtower operation API and SDK. Use when working with the cloudtower-api or when the user needs to interact with this API. |
| metadata | {"api-version":"4.8.0","openapi-version":"3.0.0"} |
cloudtower operation API and SDK
This API documentation is split into multiple files for on-demand loading.
Directory structure:
references/
├── resources/ # 130 resource index files
├── operations/ # 575 operation detail files
└── schemas/ # 164 schema groups, 1894 schema files
Navigation flow:
references/resources/<resource>.md to see available operationsreferences/operations/<operation>.md for full detailsreferences/schemas/<prefix>/<schema>.md//v2/apireferences/operations/*.md should be called as /v2/api + operation path.see Authentication
Most mutation operations are asynchronous. Instead of blocking, the API returns immediately with a placeholder resource and a task reference. As a result, a successful response does not guarantee that the operation has finished; the returned data (except for the resource id) should be treated as temporary.
Mutation responses are typically WithTask<T> or Array<WithTask<T>>. See the schema index at With schemas for concrete types.
Use the task ID to track completion via the Task resource:
Poll the task until it finishes (success or failure), then fetch the latest resource state by ID. If task_id is null, the operation is synchronous and no polling is required.
For any CloudTower API request, as the response may be larget, you MUST NOT load the response directly into the agent context. Instead:
tower_20240601_123456_abcdef/tmp/tower_{request_id}.json.head, tail, grep, or jq to extract small portions.Exception: task query in Async Operations and Tasks section may bypass this rule when the response is small and ephemeral.
references/resources/Vm.md (58 ops)references/resources/Metrics.md (17 ops)references/resources/Cluster.md (15 ops)references/resources/BackupPlan.md (13 ops)references/resources/Host.md (11 ops)references/resources/ContentLibraryVmTemplate.md (10 ops)references/resources/VmVolume.md (10 ops)references/resources/GlobalSettings.md (9 ops)references/resources/ContentLibraryImage.md (8 ops)references/resources/IscsiLun.md (8 ops)references/resources/SnapshotPlan.md (8 ops)references/resources/User.md (8 ops)references/resources/CloudTowerApplication.md (7 ops)references/resources/Datacenter.md (7 ops)references/resources/Label.md (7 ops)references/resources/NvmfNamespace.md (7 ops)references/resources/Vds.md (7 ops)references/resources/Vlan.md (7 ops)references/resources/BrickTopo.md (6 ops)references/resources/GpuDevice.md (6 ops)references/resources/ReportTemplate.md (6 ops)references/resources/SnapshotGroup.md (6 ops)references/resources/VmTemplate.md (6 ops)references/resources/AlertNotifier.md (6 ops)references/resources/ConsistencyGroupSnapshot.md (5 ops)references/resources/ConsistencyGroup.md (5 ops)references/resources/EntityFilter.md (5 ops)references/resources/Graph.md (5 ops)references/resources/IscsiTarget.md (5 ops)references/resources/ElfImage.md (5 ops)references/resources/IsolationPolicy.md (5 ops)references/resources/LogCollection.md (5 ops)references/resources/NamespaceGroup.md (5 ops)references/resources/NetworkPolicyRuleService.md (5 ops)references/resources/NfsExport.md (5 ops)references/resources/NvmfSubsystem.md (5 ops)references/resources/Organization.md (5 ops)references/resources/RackTopo.md (5 ops)references/resources/UserRoleNext.md (5 ops)references/resources/SecurityGroup.md (5 ops)references/resources/SecurityPolicy.md (5 ops)references/resources/SnmpTransport.md (5 ops)references/resources/SnmpTrapReceiver.md (5 ops)references/resources/UsbDevice.md (5 ops)references/resources/View.md (5 ops)references/resources/VirtualPrivateCloudFloatingIp.md (5 ops)references/resources/VirtualPrivateCloudNatGateway.md (5 ops)references/resources/VirtualPrivateCloudRouteTable.md (5 ops)references/resources/VirtualPrivateCloudRouterGateway.md (5 ops)references/resources/VirtualPrivateCloudSecurityGroup.md (5 ops)references/resources/VirtualPrivateCloudSecurityPolicy.md (5 ops)references/resources/VirtualPrivateCloudSubnet.md (5 ops)references/resources/VirtualPrivateCloud.md (5 ops)references/resources/VmFolder.md (5 ops)references/resources/VmPlacementGroup.md (5 ops)references/resources/GlobalAlertRule.md (4 ops)references/resources/Disk.md (4 ops)references/resources/IscsiLunSnapshot.md (4 ops)references/resources/NvmfNamespaceSnapshot.md (4 ops)references/resources/Task.md (4 ops)references/resources/VcenterAccount.md (4 ops)references/resources/VmSnapshot.md (4 ops)references/resources/VmVolumeSnapshot.md (4 ops)references/resources/Alert.md (3 ops)references/resources/UserAuditLog.md (3 ops)references/resources/Ovf.md (3 ops)references/resources/License.md (3 ops)references/resources/NfsInode.md (3 ops)references/resources/Nic.md (3 ops)references/resources/NodeTopo.md (3 ops)references/resources/ReplicationPlan.md (3 ops)references/resources/SvtImage.md (3 ops)references/resources/UploadTask.md (3 ops)references/resources/VsphereEsxiAccount.md (3 ops)references/resources/Observability.md (2 ops)references/resources/AlertRule.md (2 ops)references/resources/Application.md (2 ops)references/resources/BackupPlanExecution.md (2 ops)references/resources/BackupRestoreExecution.md (2 ops)references/resources/BackupRestorePoint.md (2 ops)references/resources/BackupService.md (2 ops)references/resources/BackupStoreRepository.md (2 ops)references/resources/BackupTargetExecution.md (2 ops)references/resources/BusinessHostGroup.md (2 ops)references/resources/BusinessHost.md (2 ops)references/resources/CloudTowerApplicationPackage.md (2 ops)references/resources/ClusterImage.md (2 ops)references/resources/ClusterSettings.md (2 ops)references/resources/ClusterTopo.md (2 ops)references/resources/ClusterUpgradeHistory.md (2 ops)references/resources/Deploy.md (2 ops)references/resources/DiskPool.md (2 ops)references/resources/EcpLicense.md (2 ops)references/resources/ElfDataStore.md (2 ops)references/resources/ElfStoragePolicy.md (2 ops)references/resources/EverouteCluster.md (2 ops)references/resources/EverouteLicense.md (2 ops)references/resources/EveroutePackage.md (2 ops)references/resources/IscsiConnection.md (2 ops)references/resources/PmemDimm.md (2 ops)references/resources/RegistryService.md (2 ops)references/resources/ReplicaVm.md (2 ops)references/resources/ReplicationService.md (2 ops)references/resources/ReportTask.md (2 ops)references/resources/SmtpServer.md (2 ops)references/resources/SnapshotPlanTask.md (2 ops)references/resources/SystemAuditLog.md (2 ops)references/resources/V2EverouteLicense.md (2 ops)references/resources/VirtualPrivateCloudClusterBinding.md (2 ops)references/resources/VirtualPrivateCloudEdgeGatewayGroup.md (2 ops)references/resources/VirtualPrivateCloudEdgeGateway.md (2 ops)references/resources/VirtualPrivateCloudExternalSubnetGroup.md (2 ops)references/resources/VirtualPrivateCloudExternalSubnet.md (2 ops)references/resources/VmDisk.md (2 ops)references/resources/VmEntityFilterResult.md (2 ops)references/resources/VmExportFile.md (2 ops)references/resources/VmNic.md (2 ops)references/resources/Witness.md (2 ops)references/resources/ZoneTopo.md (2 ops)references/resources/Zone.md (2 ops)references/resources/Ntp.md (1 ops)references/resources/ResourceChange.md (1 ops)references/resources/Internal.md (1 ops)references/resources/TableReporter.md (1 ops)references/resources/ApiInfo.md (1 ops)references/resources/DiscoveredHost.md (1 ops)references/resources/Ipmi.md (1 ops)references/resources/LogServiceConfig.md (1 ops)references/resources/PciDevice.md (1 ops)references/resources/WitnessService.md (1 ops)