# API调用
通用API调用子命令说明如[表1]所示。
 表1**API调用子命令** 
| 子命令                                | 说明                                                                |
|:---|:---|
| api GET \<path\>                 | 通用 GET 请求任意 DWS REST API 路径，占位符 {project_id} / {cluster_id} 自动从配置填充。 |
| api list-quotas                 | 列出 DWS 配额。                                                          |
| api list-projects \[--domain-id\] | 列出 IAM 项目（可指定 IAM domain）。                                       |
   
所有请求经 APICaller 以 HMAC-SHA256 签名，端点域名按 config.active.region 自动构造（https://dws.\<region\>.myhuaweicloud.com；list-projects 走 IAM 端点）。
```
# 通用 GET 通道（占位符自动填充）
hwc-dws-cli api GET /v1.0/{project_id}/clusters 
hwc-dws-cli api GET /v1.0/{project_id}/clusters/{cluster_id}/snapshots 
hwc-dws-cli api GET /v1.0/{project_id}/clusters/{cluster_id}/configurations  
# 配额 / IAM 项目
hwc-dws-cli api list-quotas 
hwc-dws-cli api list-projects 
hwc-dws-cli api list-projects --domain-id d00xxxxxxxx
```
![](https://support.huaweicloud.com/dws-ai-dws/public_sys-resources/caution_3.0-zh-cn.png)
api GET 仅支持 {project_id} 与 {cluster_id} 两个占位符；其他占位符会报 PATH.PLACEHOLDER.UNRESOLVED。