# Alibaba Cloud MSSP API

> Alibaba Cloud MSSP API on Apizie: 30 endpoints (Confirms receipt of a classified protection evaluation report, Creates a service-linked role, Creates a service ticket, Deletes a classified protection evaluation report, …) 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-mssp/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Alibaba Cloud OpenAPI for MSSP (mssp, version 2016-12-28). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Confirms receipt of a classified protection evaluation report
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/confirm-djbh-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Id | integer | no | The primary key ID of the report |

### Creates a service-linked role
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/create-service-linked-role` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Lang | string | no | The language |
| RegionId | string | no | The region ID |

### Creates a service ticket
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/create-service-work-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| WorkOrderName | string | yes | The name of the ticket |
| WorkOrderType | string | yes | The type of the ticket |
| WorkOrderSource | string | yes | The source of the ticket |
| WorkOrderStatus | string | yes | The status of the ticket |
| CustomerId | string | yes | The ID of the customer |
| StartTime | integer | yes | The start time. The value is a UNIX timestamp in milliseconds |
| OwnerId | string | yes | 负责人 |
| Operator | string | yes | The operator |
| OperateType | string | yes | The type of the operation |
| OperateRemark | string | yes | The remarks for the operation |
| WorkOrderDetail | string | yes | The details of the ticket |
| DurationDay | string | yes | The duration in days |
| IsAttachment | string | yes | The attachment requirement |
| IsWorkOrderNotify | string | yes | Specifies whether a notification is required |
| NotifyDay | string | no | The number of days in advance for notification |
| Creator | string | yes | The creator |
| NotifyId | integer | no | The ID of the notification |
| IsMilestone | string | no | Specifies whether it is a milestone |
| Priority | integer | no | The priority of the ticket |

### Deletes a classified protection evaluation report
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/delete-djbh-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Id | integer | yes | The primary key ID of the report |

### Queries the service-linked role
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/describe-service-linked-role` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Lang | string | no | The language |
| RegionId | string | no | The region ID |

### Processes a service ticket
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/dispose-service-work-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Id | integer | yes | The ticket ID |
| WorkOrderName | string | yes | The ticket name |
| WorkOrderStatus | string | no | The ticket status |
| Operator | string | yes | The operator |
| OperateType | string | yes | The processing type |
| OperateRemark | string | yes | The operation remark |
| ForwardOwnerId | string | no | The user to whom the ticket is forwarded |
| UpgradeOwnerId | string | no | The escalated user |
| IsAttachment | string | no | Specifies whether an attachment is required |
| IsWorkOrderNotify | string | no | Specifies whether ticket notifications are enabled |
| AttachmentName | string | no | The attachment name |
| StartTime | integer | no | The start time. The value is a UNIX timestamp in milliseconds |
| EndTime | integer | no | The end time. The value is a UNIX timestamp in milliseconds |
| NotifyId | integer | no | The notification ID |
| WorkOrderDetail | string | no | The ticket details |

### Processes alert tickets
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/dispose-work-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Operator | string | yes | The operator |
| TaskIds | string | yes | The ticket IDs, separated by commas |
| Status | integer | yes | The ticket status |
| OptRemark | string | yes | The operation remarks |
| WorkTaskAnalysisResults | string | no | 告警ai分析结果 (JSON-encoded) |
| SyncSasDeal | integer | no | 同步云安全中心我已手动处理 |
| SyncWafApisecDeal | integer | no | 同步waf已确认 |
| SyncSasSiemEventDeal | integer | no | 同步cloudsiem已确认 |

### Queries the details of an alert
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-alarm-detail-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Id | integer | yes | The primary key ID |

### Queries the convergence trend of attacked assets
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-attacked-asset-deal` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| DateType | string | yes | The time filter type. You can filter by the last 7 days, last 30 days, last half year, or a custom time range. This field is a time range… |
| StartDate | integer | yes | The start time, specified as a UNIX timestamp in milliseconds |
| EndDate | integer | yes | The end time, specified as a UNIX timestamp in milliseconds |
| SuspEventSource | string | no | The source of the alert event |

### Queries the convergence trend of compliance risks
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-baseline-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| DateType | string | yes | The time filter type. You can filter time by the last 7 days, last 30 days, last half year, or a custom time range. This field is a time… |
| StartDate | integer | yes | The start time. Use a millisecond-level UNIX timestamp |
| EndDate | integer | yes | The end time. Use a millisecond-level UNIX timestamp |
| SuspEventSource | string | no | The source of the alert event |

### Retrieves the console score
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-console-score` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| DateType | string | yes | The time filter type. You can filter by the last 7 days, last 30 days, last half year, or a custom time range. If this parameter is left… |
| StartDate | integer | yes | The start time, specified as a UNIX timestamp in milliseconds |
| EndDate | integer | yes | The end time, specified as a UNIX timestamp in milliseconds |
| SuspEventSource | string | no | The source of the alert event |

### Queries risk details
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-detail-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Id | integer | yes | The primary key ID |

### Downloads a single service report
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-document-download-url` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Id | integer | yes | The document management ID |
| ReportType | string | no | The report type |
| FileKey | string | no | The file identifier |

### Queries service reports
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-document-page` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| CurrentPage | integer | yes | The current page number |
| PageSize | integer | yes | The number of entries per page |
| ReportType | string | yes | The report type |
| DocumentName | string | no | The document name |
| DeliveredBy | string | no | The person who delivered the report |
| DocumentType | string | no | The document type |

### Retrieves the statistics on the homepage of a service report
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-document-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| ReportType | string | no | The type of the service report |

### Retrieves the most recently uploaded service reports
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-recent-document` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| DateType | string | yes | The time filter type. Supports filtering by the last 7 days, last 30 days, last half year, or custom time ranges. This field is an… |
| StartDate | integer | yes | The start time. The value is a UNIX timestamp in milliseconds |
| EndDate | integer | yes | The end time. The value is a UNIX timestamp in milliseconds |
| SuspEventSource | string | no | The source of the alert event |

### Retrieves the security protection coverage
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-safety-cover` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| DateType | string | yes | The time filter type. You can filter by the last 7 days, last 30 days, last 6 months, or a custom time range. This field is a time range… |
| StartDate | integer | yes | The start time. Use a UNIX timestamp in milliseconds |
| EndDate | integer | yes | The end time. Use a UNIX timestamp in milliseconds |
| SuspEventSource | string | no | The source of the alert event |

### Retrieves the SOW list
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-sow-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| DateType | string | yes | The time filter type. You can filter by the last 7 days, last 30 days, last 6 months, or a custom time range. This field is a time range… |
| StartDate | integer | yes | The start time. Use a UNIX timestamp in milliseconds |
| EndDate | integer | yes | The end time. Use a UNIX timestamp in milliseconds |
| SuspEventSource | string | no | The source of the alert event |

### Queries alert handling records
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-susp-event-page` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| CurrentPage | integer | yes | The current page number |
| PageSize | integer | yes | The number of entries per page |
| Source | string | no | The alert source |
| Status | integer | no | The handling status |
| AlarmStartTime | integer | no | The start time of the alert. The value is a UNIX timestamp in milliseconds |
| AlarmEndTime | integer | no | The end time of the alert. The value is a UNIX timestamp in milliseconds |

### Retrieves the statistics items of alerts
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-susp-event-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| DateType | string | yes | The time filter type. You can filter by the last 7 days, last 30 days, last 6 months, or a custom time range. This field is a time range… |
| StartDate | integer | yes | The start time. Use a Unix timestamp in milliseconds |
| EndDate | integer | yes | The end time. Use a Unix timestamp in milliseconds |
| SuspEventSource | string | no | The alert event source |

### Retrieves alert page statistics
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-susp-page-summary` (byok)

### Queries the activation status of the user
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-user-status` (byok)

### Queries security risks
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-vul-item-page` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| CurrentPage | integer | yes | The current page number |
| PageSize | integer | yes | The number of entries per page |
| ScanType | string | no | The vulnerability type |
| Level | string | no | The risk level |
| Dealed | string | no | The processing status. Valid values: y: handled. n: unhandled. h: handling |
| Name | string | no | The vulnerability name |
| AliasName | string | no | The vulnerability alias |

### Queries the details of processed vulnerabilities
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-vul-list-by-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| CurrentPage | integer | no | The number of the current page |
| PageSize | integer | no | The number of entries per page |
| Id | integer | yes | The primary key ID |
| Dealed | string | no | Specifies whether the vulnerability has been processed. Valid values: y: processed n: not processed |
| Necessity | string | no | The risk level |
| Remark | string | no | The asset information of the vulnerability to query. You can set this parameter to the asset name, public IP address, or private IP address |
| Uuids | string | no | The UUIDs of the servers for which you want to query vulnerabilities. Separate multiple UUIDs with commas (,) |

### Queries alert page statistics
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-vul-page-summary` (byok)

### Retrieves risk statistics
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-vul-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| DateType | string | yes | The time filter type. Supports filtering by the last 7 days, last 30 days, last half year, or a custom time range. This field is a time… |
| StartDate | integer | yes | The start time, specified as a UNIX timestamp in milliseconds |
| EndDate | integer | yes | The end time, specified as a UNIX timestamp in milliseconds |
| SuspEventSource | string | no | The source of the alert event |

### Retrieves the statistics for first-line tickets
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/get-work-task-summary` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| DateType | string | yes | The time filter type. You can filter by the last 7 days, last 30 days, last half year, or a custom time range. This field is an identifier… |
| StartDate | integer | yes | The start time. Use a UNIX timestamp in milliseconds |
| EndDate | integer | yes | The end time. Use a UNIX timestamp in milliseconds |
| SuspEventSource | string | no | The source of the alert event |

### Queries service customer information
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/page-service-customer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| CurrentPage | integer | yes | The page number of the query results. Default value: 1 |
| PageSize | integer | yes | The number of records per page |
| StartTime | integer | no | The start time. The value is a UNIX timestamp in milliseconds |
| EndTime | integer | no | The end time. The value is a UNIX timestamp in milliseconds |
| AuthStatus | integer | no | The authorization status |
| MonitorAuthStatus | integer | no | The authorization status for China Cloud Security alerts |
| CmAuthStatus | integer | no | The authorization status for CloudMonitor alerts |

### Sends a custom alert event
`POST https://zieapi.vercel.app/v1/cloud:aliyun-mssp/send-custom-event` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| CustomerId | string | yes | The user ID |
| DataSource | string | no | The data source |
| EventDescription | string | no | The event details |
| EventDetails | string | no | The alert event details |
| EventName | string | yes | The event name |
| EventType | string | yes | The event type |
| OccurrenceTime | integer | no | The time when the alert event first occurred. The value is a UNIX timestamp in milliseconds |
| FindTime | integer | yes | The time when the alert was detected. The value is a UNIX timestamp in milliseconds |
| InstanceId | string | no | The instance ID |
| InstanceName | string | no | The instance name |
| IsSend | string | yes | Specifies whether to send the alert |
| Level | string | yes | The event level |
| Product | string | no | The product name |
| UniqueId | string | yes | The unique ID |
| Uuid | string | no | The UUID |
| OwnerId | string | no | The OwnerId |
| EventMarkdown | string | no | The details in Markdown format |

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

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-mssp/confirm-djbh-report" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

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

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

### Can AI agents use the Alibaba Cloud MSSP 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-mssp.

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