# Alibaba Cloud Intelligent Advisor API

> Alibaba Cloud Intelligent Advisor API on Apizie: 17 endpoints (Retrieves the latest inspection results for a user based on multiple dimensions and returns all results, Retrieves the latest inspection results based on multiple dimensions. The results are returned in pages with…, Retrieves the latest inspection results based on multiple dimensions and returns them in pages, Queries the inspection items currently available to the user, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:aliyun-advisor/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-advisor`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/advisor
- Page: https://zieapi.vercel.app/api/cloud/aliyun-advisor
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-advisor/openapi.json

Alibaba Cloud OpenAPI for Intelligent Advisor (advisor, version 2018-01-20). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Retrieves the latest inspection results for a user based on multiple dimensions and returns all results
`POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/describe-advices` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://advisor.cn-hangzhou.aliyuncs.com |
| AdviceId | integer | no | The inspection result ID |
| CheckId | string | no | The inspection item code |
| ResourceId | string | no | The resource or instance ID |
| Language | string | no | The language of the request |
| ExcludeAdviceId | integer | no | The inspection result ID to exclude |
| Product | string | no | The cloud service code |
| CheckPlanId | integer | no | The inspection plan ID. If not specified, the system default plan is used |

### Retrieves the latest inspection results based on multiple dimensions. The results are returned in pages with…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/describe-advices-flat-page` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://advisor.cn-hangzhou.aliyuncs.com |
| AdviceId | integer | no | The ID of the inspection result |
| CheckId | string | no | The code of the inspection item |
| ResourceId | string | no | The resource or instance ID |
| Language | string | no | The language used in the request |
| Product | string | no | The code of the cloud service |
| PageNumber | integer | no | The page number |
| PageSize | integer | no | The number of entries per page |

### Retrieves the latest inspection results based on multiple dimensions and returns them in pages
`POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/describe-advices-page` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://advisor.cn-hangzhou.aliyuncs.com |
| AdviceId | integer | no | The inspection result ID |
| CheckId | string | no | The inspection item code |
| ResourceId | string | no | The resource or instance ID |
| Language | string | no | The language of the request |
| Product | string | no | The cloud product code |
| PageNumber | integer | no | The page number |
| PageSize | integer | no | The number of entries per page |
| CheckPlanId | integer | no | The inspection plan ID. If not specified, the system plan is used by default |

### Queries the inspection items currently available to the user
`POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/describe-advisor-checks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://advisor.cn-hangzhou.aliyuncs.com |
| Language | string | no | The language |
| Product | string | no | The cloud service code |

### Queries the settings of inspection items by page
`POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/describe-advisor-checks-fo-pages` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://advisor.cn-hangzhou.aliyuncs.com |
| PageNumber | integer | no | The page number. Pages start from page 1. Default value: 1 |
| PageSize | integer | no | The number of entries per page |
| Name | string | no | The name of the inspection item |
| Category | string | no | This parameter is invalid. Cost optimization is not supported |
| Product | string | no | The code of the cloud service |
| Status | string | no | Specifies whether the diagnostic item is disabled. Valid values: enabled: The item is enabled. disabled: The item is disabled |
| Token | string | no | The content of the credential token |
| BizCategory | string | no | The inspection type |
| AssumeAliyunId | integer | no | The Alibaba Cloud account ID used for inspection |
| CheckTypes | string | no | This parameter is invalid. Cost optimization is not supported (JSON-encoded) |
| Source | string | no | This parameter is invalid. Cost optimization is not supported |
| Language | string | no | The Language |

### Retrieves the list of inspected resources. You must trigger resource information synchronization to obtain…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/describe-advisor-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://advisor.cn-hangzhou.aliyuncs.com |
| ResourceId | string | no | The resource or instance ID |
| Keyword | string | no | The search keyword used to fuzzy match resource or instance IDs or names |
| Language | string | no | The language of the request |
| Product | string | no | The cloud service code |
| PageNumber | integer | no | The page number |
| PageSize | integer | no | The number of entries per page |

### Queries the details of cost optimization results
`POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/describe-cost-check-advices` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://advisor.cn-hangzhou.aliyuncs.com |
| CheckId | string | no | The code of the check item |
| ResourceName | string | no | The name of the resource |
| Severity | string | no | The severity level. Valid values: 1: Warning. 2: Critical |
| RegionIds | string | no | The list of edge node IDs. This is a filter condition for the query. Multiple values are supported and separated by commas (,). By… |
| ResourceIds | string | no | The list of resource IDs, which are the instance IDs (JSON-encoded) |
| PageNumber | integer | no | The page number of the instance status list. Pages start from 1. Default value: 1 |
| PageSize | integer | no | The number of entries per page |
| Language | string | no | The language used |
| TagKeys | string | no | The list of tag keys that meet the conditions (JSON-encoded) |
| TagValues | string | no | The tag values (JSON-encoded) |
| AssumeAliyunIdList | string | no | The IDs of the member accounts to query (JSON-encoded) |
| TagList | string | no | The list of tags (JSON-encoded) |
| CheckPlanId | integer | no | The CheckPlanId |
| ResourceGroupIdList | string | no | The ResourceGroupIdList (JSON-encoded) |
| ResourceId | string | no | The ResourceId |

### Queries the overview of aggregated cost optimization results for check items
`POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/describe-cost-check-results` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://advisor.cn-hangzhou.aliyuncs.com |
| Product | string | no | The code of the cloud service |
| CheckIds | string | no | The list of check item IDs (JSON-encoded) |
| Severity | integer | no | The severity level. Valid values: 1: Warning. 2: Critical |
| ResourceName | string | no | The name of the resource |
| RegionIds | string | no | The set of region IDs. This parameter is an array (JSON-encoded) |
| ResourceIds | string | no | The list of resource IDs. A maximum of 100 IDs are supported (JSON-encoded) |
| AssumeAliyunIdList | string | no | The collection of IDs of the member accounts to query (JSON-encoded) |
| GroupBy | string | no | The dimension for grouping. Valid values: Category: Groups by category. This is the default value. Product: Groups by cloud service |
| TagKeys | string | no | The list of tag keys that meet the conditions (JSON-encoded) |
| TagValues | string | no | The tag values (JSON-encoded) |
| TagList | string | no | The list of tags (JSON-encoded) |
| ResourceGroupIdList | string | no | The filter for resource group IDs (JSON-encoded) |
| CheckPlanId | integer | no | The CheckPlanId |
| ResourceId | string | no | The ResourceId |
| Language | string | no | The Language |

### Retrieves the cost optimization overview
`POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/describe-cost-optimization-overview` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://advisor.cn-hangzhou.aliyuncs.com |
| AssumeAliyunId | integer | no | The ID of the Alibaba Cloud account used for inspection |
| Token | string | no | The token required for the request. This parameter is not supported |
| AssumeAliyunIdList | string | no | The IDs of the member accounts to query (JSON-encoded) |
| CheckPlanId | integer | no | The CheckPlanId |

### Retrieves historical inspection results in pages by product, date, and severity level
`POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/get-history-advices` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://advisor.cn-hangzhou.aliyuncs.com |
| Language | string | no | The language of the request |
| Product | string | no | The code of the cloud service |
| Severity | string | no | The severity level. Valid values: 1: warning 2: critical |
| PageSize | integer | no | The number of entries per page |
| PageNum | integer | no | The page number |
| StartDate | string | no | The start time of the time range for the query. Specify the time in the yyyy-mm-dd format |
| EndDate | string | no | The end time of the time range for the query. Specify the time in the yyyy-mm-dd format |
| Reverse | string | no | Specifies whether to sort the results in descending order. Valid values: true: Sorts the results in descending order. false: Sorts the… |

### Retrieves the task execution progress for regular users or a single account in a resource directory
`POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/get-inspect-progress` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://advisor.cn-hangzhou.aliyuncs.com |
| TaskId | integer | no | The ID of the task to query |
| AssumeAliyunId | integer | no | The primary account for inspection |
| Token | string | no | The token required to integrate ARMS Prometheus Monitoring |

### Queries the list of cloud services
`POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/get-product-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://advisor.cn-hangzhou.aliyuncs.com |
| Token | string | no | The required token |
| Language | string | no | The Language |

### Queries the execution status of a task by task ID
`POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/get-task-status-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://advisor.cn-hangzhou.aliyuncs.com |
| TaskId | string | yes | The ID of the task to query |

### Refreshes diagnostic items, triggers resource metric synchronization for the inspection items, and re-runs…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/refresh-advisor-check` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://advisor.cn-hangzhou.aliyuncs.com |
| ResourceId | string | no | The resource or instance ID |
| CheckId | string | no | The inspection item code |
| Product | string | no | The product code |
| Language | string | no | The language to use |
| ResourceDimensionList | string | no | The ResourceDimensionList (JSON-encoded) |
| AssumeAliyunId | integer | no | The AssumeAliyunId |
| CheckPlanId | integer | no | The inspection plan ID. If not specified, the system plan is used by default |
| Token | string | no | The Token |

### Initiates a cost optimization inspection
`POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/refresh-advisor-cost-check` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://advisor.cn-hangzhou.aliyuncs.com |
| Product | string | no | The product code |
| ResourceIds | string | no | The IDs of the resources to update (JSON-encoded) |
| CheckIds | string | no | The IDs of the check items (JSON-encoded) |
| RefreshResource | string | no | Specifies whether to refresh the resource status. Default value: false |
| AssumeAliyunIdList | string | no | The IDs of the member accounts to query (JSON-encoded) |
| CheckPlanId | integer | no | The CheckPlanId |

### Triggers a resource information synchronization task based on a specific product and resource ID, and…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/refresh-advisor-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://advisor.cn-hangzhou.aliyuncs.com |
| Product | string | yes | The cloud service code |
| ResourceId | string | no | The resource or instance ID |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://advisor.cn-hangzhou.aliyuncs.com |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-advisor/describe-advices" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Intelligent Advisor API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-advisor/describe-advices with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud Intelligent Advisor API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud Intelligent Advisor itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud Intelligent Advisor API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-advisor.

### What is the status of the Alibaba Cloud Intelligent Advisor API?
Needs your own provider key (bring your own key)