# Alibaba Cloud Lingjun-Controller API

> Alibaba Cloud Lingjun-Controller API on Apizie: 66 endpoints (Approves an O\\&M operation, Modifies the node group of nodes, Upgrades or downgrades the specifications of one or more nodes. Before you change the specifications, ensure…, Changes the resource group of a resource, …) 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-eflo-controller/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Alibaba Cloud OpenAPI for Lingjun-Controller (eflo-controller, version 2022-12-15). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Approves an O\\&M operation
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/approve-operation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NodeId | string | no | The node ID |
| OperationType | string | no | The O\&M operation type Valid value: RepairMachine |

### Modifies the node group of nodes
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/change-node-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| Nodes | string | no | The node information (JSON-encoded) |
| IgnoreFailedNodeTasks | string | no | Specifies whether to skip failed nodes. Default value: False |
| TargetNodeGroupId | string | no | The ID of the target node group |

### Upgrades or downgrades the specifications of one or more nodes. Before you change the specifications, ensure…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/change-node-types` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NodeType | string | no | The node specifications |
| NodeIds | string | no | A list of node IDs. You can specify a maximum of 10 nodes in a single request (JSON-encoded) |

### Changes the resource group of a resource
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/change-resource-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ResourceType | string | no | The type of the resource |
| ResourceId | string | yes | The ID of the resource |
| ResourceRegionId | string | yes | The ID of the region |
| ResourceGroupId | string | yes | The ID of the destination resource group |

### Disconnect Connection
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/close-session` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| SessionToken | string | no | Session token |
| SessionId | string | no | The session ID |

### Creates a Lingjun cluster
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/create-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ClusterName | string | no | The name of the cluster |
| ClusterType | string | no | The type of the cluster |
| ClusterDescription | string | no | The description of the cluster |
| NodeGroups | string | no | The node groups (JSON-encoded) |
| IgnoreFailedNodeTasks | string | no | Specifies whether failed nodes can be skipped. Default value: false |
| ResourceGroupId | string | no | The resource group ID |
| Networks | string | no | The network information (JSON-encoded) |
| Tag | string | no | The resource tags (JSON-encoded) |
| Components | string | no | The components (software instances) (JSON-encoded) |
| HpnZone | string | no | The cluster ID |
| NimizVSwitches | string | no | The node vSwitches (JSON-encoded) |
| OpenEniJumboFrame | string | no | Specifies whether the network interface supports jumbo frames |

### Creates a diagnostics task
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/create-diagnostic-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ClusterId | string | no | The cluster ID |
| NodeIds | string | no | The IDs of the nodes (JSON-encoded) |
| DiagnosticType | string | no | The diagnostics type |
| AiJobLogInfo | string | no | The log information (JSON-encoded) |

### Creates a network test task
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/create-net-test-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NetTestType | string | no | The type of network test. Valid values: DelayTest, TrafficTest, and CommTest |
| Port | string | no | The test port number |
| TrafficTest | string | no | This field is empty if TrafficModel is set to Fullmesh (JSON-encoded) |
| DelayTest | string | no | Specify this parameter if NetTestType is set to DelayTest (JSON-encoded) |
| CommTest | string | no | Specify this parameter if NetTestType is set to CommTest (JSON-encoded) |
| ClusterId | string | no | The cluster ID |
| NetworkMode | string | no | The network mode |
| ClusterName | string | no | The cluster name |

### Creates a node group in a cluster
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/create-node-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NodeGroup | string | yes | The node ID (JSON-encoded) |
| ClusterId | string | yes | The cluster ID |
| NodeUnit | string | no | The node information (JSON-encoded) |

### Creates a Web Terminal session
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/create-session` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NodeId | string | no | The instance ID |
| StartTime | string | no | The start time. The value is a 13-digit timestamp |
| SessionType | string | no | The type of the session corresponding to the session package |

### Creates a VSC
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/create-vsc` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ClientToken | string | no | A client token to ensure the idempotency of the request |
| NodeId | string | yes | The ID of the node |
| VscType | string | no | The type of the VSC. Valid values: primary and standard. The default value is primary |
| VscName | string | no | The custom name of the VSC. The name must be unique on a single compute node |
| Tag | string | no | The tags of the resource (JSON-encoded) |
| ResourceGroupId | string | no | The ID of the resource group |

### Deletes a Lingjun cluster
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/delete-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ClusterId | string | yes | The cluster ID |

### Deletes an unused hyper node
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/delete-hyper-node` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| HyperNodeId | string | yes | The hyper node ID |

### Releases a pay-as-you-go node
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/delete-node` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NodeId | string | yes | The node ID |

### Delete Node Group
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/delete-node-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ClusterId | string | no | The cluster ID |
| NodeGroupId | string | no | The node group ID |

### Deletes a VSC
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/delete-vsc` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request |
| VscId | string | yes | The ID of the VSC to delete |

### Queries the details of a Lingjun AI Computing Service cluster
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/describe-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ClusterId | string | yes | The cluster ID |

### Queries the results of a diagnostic task
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/describe-diagnostic-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| DiagnosticId | string | no | The diagnostic ID |

### Queries the details of a fault report after a user submits one
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/describe-fault-report` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ReportId | string | yes | The report ID |

### Queries the details of a hypernode
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/describe-hyper-node` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| HyperNodeId | string | yes | The hypernode ID |

### Queries the execution list and status of O&M Assistant commands
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/describe-invocations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| InvokeId | string | yes | The command execution ID |
| NodeId | string | no | The instance ID |
| IncludeOutput | string | no | Specifies whether to return the command output in the results. true: Returns the output. In this case, specify at least the InvokeId or… |
| ContentEncoding | string | no | The encoding method for the CommandContent and Output fields in the response. Valid values: PlainText: Returns the original command… |

### Queries network test results
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/describe-net-test-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| TestId | string | no | The test task ID |

### Queries a list of nodes
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/describe-node` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NodeId | string | yes | The node ID |

### Queries node groups
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/describe-node-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NodeGroupId | string | yes | The node group ID |

### Queries the detailed progress of a node group configuration refresh task. Returns the actual execution…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/describe-node-group-refresh-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NodeGroupRefreshTaskId | string | yes | The ID of the node group configuration refresh task. After you call RefreshNodeGroupNodes to trigger a node group configuration refresh,… |
| NodeStatuses | string | no | The node refresh statuses to filter by: Pending: the node is waiting to be refreshed. InProgress: the node is being refreshed. Success:… |
| NextToken | string | no | The pagination token. Set this parameter to the NextToken value returned in the previous call. You do not need to set this parameter for… |
| MaxResults | integer | no | The maximum number of entries per page for a paged query. Valid values: 1 to 500. Default value: 100. For more information about paging,… |

### Queries the constraints for a node type
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/describe-node-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NodeType | string | no | The node scaling mode |

### Queries a list of regions
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/describe-regions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| AcceptLanguage | string | no | The natural language that is used to filter responses. For more information, see RFC 7231. zh-CN en-US Default value: zh-CN. Valid values:… |

### Queries the list and status of files sent by O&M Assistant
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/describe-send-file-results` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| InvokeId | string | yes | The command execution ID |
| NodeId | string | no | The node ID |

### Queries the details of a node
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/describe-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| TaskId | string | yes | The node ID |

### Retrieves the details of a specific virtual switch controller (Vsc)
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/describe-vsc` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| VscId | string | yes | The ID of the Vsc |

### Queries a list of zones
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/describe-zones` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| AcceptLanguage | string | no | The natural language that is used to filter responses. For more information, see RFC 7231. Valid values: zh-CN en-US Default value: zh-CN.… |

### Scales out a cluster
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/extend-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ClusterId | string | no | The cluster ID |
| NodeGroups | string | no | The node groups (JSON-encoded) |
| IgnoreFailedNodeTasks | string | no | Specifies whether to allow skipping failed nodes. Default value: False |
| VpdSubnets | string | no | The list of cluster subnets (JSON-encoded) |
| IpAllocationPolicy | string | no | The combined policies for IP allocation. Each policy supports only one policy type, and multiple policies can be combined (JSON-encoded) |
| VSwitchZoneId | string | no | The zone ID of the vSwitch |

### Queries the host group list under a cluster and the host list under each group
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-cluster-hyper-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The pagination token. Set this parameter to the NextToken value returned in the previous API call |
| MaxResults | integer | no | The number of entries per page in a paged query. Maximum value: 100. Default value: If this parameter is not set or is set to a value less… |
| NodeGroupId | string | no | The node group ID |
| Tags | string | no | The tag information (JSON-encoded) |
| ResourceGroupId | string | no | The resource group ID |

### Queries the list of nodes in a cluster
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-cluster-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ClusterId | string | yes | The cluster ID |
| NextToken | string | no | The pagination token. Set this parameter to the value of NextToken that was returned in the previous API call |
| MaxResults | integer | no | The number of entries per page in a paged query. Default value: 20 |
| NodeGroupId | string | no | The node group ID |
| Tags | string | no | The tag information (JSON-encoded) |
| ResourceGroupId | string | no | The resource group ID |
| OperatingStates | string | no | The list of node states (JSON-encoded) |

### Queries a list of cluster instances
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-clusters` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NextToken | string | no | The pagination token. Set this parameter to the value of NextToken that is returned from the previous API call |
| MaxResults | integer | no | The number of entries per page for a paged query. Default value: 20 |
| ResourceGroupId | string | no | The resource group ID |
| Tags | string | no | The list of tags (JSON-encoded) |

### Queries a list of diagnostic tasks
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-diagnostic-results` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NextToken | string | no | The pagination token. Set this parameter to the value of NextToken that was returned from the previous API call |
| MaxResults | integer | no | The number of entries per page in a paged query. Maximum value: 100. Default value: If this parameter is not specified or is set to a… |
| DiagType | string | no | The diagnostic type |
| ResourceGroupId | string | no | The resource group ID |

### Queries the list of historical fault reports
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-fault-reports` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| Nodes | string | no | The list of nodes (JSON-encoded) |
| Status | string | no | The status of the fault report |
| NextToken | string | no | The pagination token |
| MaxResults | integer | no | The maximum number of results to return |

### Queries the list of available rack physical machines
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-free-hyper-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NextToken | string | no | The pagination token. Set this parameter to the value of NextToken that was returned from the last API call |
| MaxResults | integer | no | The number of entries per page in a paged query. Maximum value: 100. Default value: •If this parameter is not specified or is set to a… |
| MachineType | string | no | The machine type |
| HpnZone | string | no | The cluster ID |
| ResourceGroupId | string | no | The resource group ID |
| Tags | string | no | The list of tags (JSON-encoded) |
| Status | string | no | The list of unused node statuses to return (JSON-encoded) |

### Queries the list of unused nodes
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-free-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NextToken | string | no | The pagination token. Set this parameter to the value of NextToken that is returned from the previous API call |
| MaxResults | integer | no | The number of entries per page for a paged query. Default value: 20 |
| MachineType | string | no | The machine type |
| HpnZone | string | no | The cluster number |
| ResourceGroupId | string | no | The resource group ID |
| Tags | string | no | The tag information (JSON-encoded) |
| OperatingStates | string | no | The type of unused nodes to return (JSON-encoded) |

### Queries a list of machines
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-hyper-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NodeGroupName | string | no | The name of the node group |
| MachineType | string | no | The machine type |
| ZoneId | string | no | The zone ID |
| NextToken | string | no | The pagination token. Set this parameter to the NextToken value returned in the previous API call |
| MaxResults | integer | no | The number of entries per page in a paged query. Maximum value: 100. Default value: If this parameter is not specified or is set to a… |
| ResourceGroupId | string | no | The resource group ID |
| HyperNodeId | string | no | The node ID |
| ClusterName | string | no | The cluster name |
| HpnZone | string | no | The cluster number |
| Tags | string | no | The tag information (JSON-encoded) |
| OperatingStates | string | no | The node status. If this parameter is not specified, all statuses are returned. Valid values: Extending, UnusedNodeStopped,… |
| CommodityCode | string | no | The commodity code |
| HyperNodeIds | string | no | The list of node IDs (JSON-encoded) |

### Lists available images
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-images` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ImageVersion | string | no | The image version |
| Architecture | string | no | The architecture |
| Platform | string | no | The platform |

### Queries the network configurations for machine types
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-machine-network-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| MachineHpnInfo | string | no | The information about the machine types (JSON-encoded) |

### Queries the list of available machine types
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-machine-types` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| Name | string | no | The name of the machine type |

### Queries the list of network tests
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-net-test-results` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NextToken | string | no | The pagination token. Set this parameter to the value of NextToken that is returned from the previous API call |
| MaxResults | integer | no | The number of entries per page in a paged query. Maximum value: 100. Default value: If this parameter is not specified or is set to a… |
| NetTestType | string | no | The network test type |
| ResourceGroupId | string | no | The resource group ID |

### Queries nodes with configuration drift within a node group and the drift details
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-node-group-drifted-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NodeGroupId | string | yes | The node group ID. Call ListClusters to obtain the ClusterId, pass the ClusterId to ListNodeGroups, and obtain the value from the… |
| NodeIds | string | no | Limits the check scope. If not specified, all nodes in the node group are checked. If the model is a super node, pass the TrayNode ID.… |
| NextToken | string | no | The pagination token. Set this parameter to the NextToken value returned in the previous call. You do not need to set this parameter for… |
| MaxResults | integer | no | The maximum number of entries per page in a paging query. Valid values: 1 to 500. Default value: 100 |

### Queries the list of node group configuration refresh tasks by paging
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-node-group-refresh-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ClusterId | string | no | The cluster ID |
| NodeGroupId | string | no | The node group ID |
| Statuses | string | no | The list of task statuses. Valid values: Pending: The refresh task is created and waiting to be executed. InProgress: The refresh task is… |
| NextToken | string | no | The pagination token. Set this parameter to the NextToken value returned in the previous call. You do not need to set this parameter for… |
| MaxResults | integer | no | The maximum number of entries per page for paging. Valid values: 1 to 500. Default value: 100 |

### Queries node group information in a cluster
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-node-groups` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NodeGroupId | string | no | The node group ID |
| NextToken | string | no | The NextToken for the next page. Include this return value when requesting the next page |
| ClusterId | string | no | The cluster ID |
| MaxResults | integer | no | The number of entries per page for a paged query. Maximum value: 100. Default value: If the value is not set or is set to less than 20,… |

### Queries system logs
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-syslogs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ToTime | string | yes | The end time. Specify a UNIX timestamp in seconds |
| Query | string | no | The query condition |
| Reverse | string | no | Specifies whether to query logs in reverse chronological order |
| NextToken | string | no | The token for the next page. Include this token when you retrieve the next page of results |
| NodeId | string | yes | The node ID |
| FromTime | string | yes | The start time. Specify a UNIX timestamp in seconds |

### Queries the tags that are attached to resources
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ResourceType | string | yes | The resource type |
| ResourceId | string | no | The list of resource IDs (JSON-encoded) |
| RegionId | string | yes | The region ID |
| Tag | string | no | The list of tags (JSON-encoded) |
| NextToken | string | no | The token used to retrieve the next page of results. Set this parameter to the NextToken value returned in the previous response |

### Query the cluster types available to the user
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-user-cluster-types` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |

### Queries a list of VSCs
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/list-vscs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NextToken | string | no | The token that marks the position from which to start the query. If you leave this parameter empty, the query starts from the beginning |
| MaxResults | integer | no | The maximum number of entries to return on each page |
| NodeIds | string | no | The list of node IDs (JSON-encoded) |
| VscName | string | no | The name of the VSC |
| Tag | string | no | The list of tags (JSON-encoded) |
| ResourceGroupId | string | no | The ID of the resource group |

### Restarts nodes
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/reboot-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ClusterId | string | no | The cluster ID |
| Nodes | string | no | The nodes (JSON-encoded) |
| IgnoreFailedNodeTasks | string | no | Specifies whether to allow skipping failed nodes. Default value: False |

### Refreshes node group configurations to existing nodes. Manually triggers the node group configuration to…
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/refresh-node-group-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NodeGroupId | string | yes | The node group ID |
| MaxDisruptiveAction | string | no | The maximum disruptive action level allowed for the refresh operation. The system independently evaluates the action level required to… |
| NodeIds | string | no | The filter scope for node refresh. If not specified, all nodes in the node group are included. If the instance type is a hypernode, pass… |

### Reinstalls machines
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/reimage-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ClusterId | string | no | The cluster ID |
| Nodes | string | no | The list of nodes (JSON-encoded) |
| IgnoreFailedNodeTasks | string | no | Specifies whether to skip failed nodes. Default value: False |
| UserData | string | no | The custom executable shell script. The script must be Base64-encoded. The maximum size of the raw data is 16 KB |

### Reports a fault for an abnormal node
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/report-node-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NodeId | string | yes | The node ID |
| DiagnosisType | string | yes | The diagnosis type. Valid values: QUICK: quick diagnosis COMPREHENSIVE: comprehensive diagnosis |
| Description | string | yes | The detailed description of the exception |

### Reports issues with abnormal nodes
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/report-nodes-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| Nodes | string | no | The list of nodes (JSON-encoded) |
| StartTime | string | no | The start time of the node issue. The time is in the ISO 8601 format \`yyyy-MM-ddTHH:mm:ss+0800\` and includes the time zone |
| EndTime | string | no | The end time of the node issue. The time is in the ISO 8601 format \`yyyy-MM-ddTHH:mm:ss+0800\` and includes the time zone |
| Reason | string | no | The impact of the issue on the Lingjun node. Valid values: ● HardwareError: A hardware error occurred. ● SoftwareError: A software error… |
| Description | string | no | The description |
| IssueCategory | string | no | The category of the issue. This parameter is required when \`Reason\` is set to \`HardwareError\`. Valid values: ● hardware-cpu-error: CPU… |

### Runs a Shell script on one or more Lingjun nodes
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/run-command` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| Name | string | no | The command name |
| Description | string | no | The command description |
| CommandContent | string | no | The command content. Take note of the following: When `EnableParameter` is set to true, you can use custom parameters in the command.… |
| Timeout | integer | no | The timeout period for the command. Unit: seconds. A timeout error occurs if the command cannot be run because the process slows down or… |
| WorkingDir | string | no | The working path of the command. You can specify a custom path. Default path: Linux instances: By default, the path is in the /home… |
| EnableParameter | string | no | Specifies whether to use custom parameters in the command. Default value: false |
| ContentEncoding | string | no | The encoding mode of the command content. Valid values: PlainText Base64 Default value: PlainText. If the specified value of this… |
| Username | string | no | The username that you use to run the command. The name can be up to 255 characters in length. For Linux instances, the root user is used… |
| NodeIdList | string | no | The node list (JSON-encoded) |
| RepeatMode | string | no | The mode to run the command. Valid values: Once: runs the command immediately. Period: runs the command based on a schedule. When set to… |
| ClientToken | string | no | The client token to ensure the idempotency of the request. Use your client to generate the token that is unique among requests. The token… |
| Frequency | string | no | The schedule to run the command. Supported schedule types: at a fixed interval based on a rate expression, run only once at a specific… |
| Parameters | string | no | The key-value pairs of custom parameters to pass in when the command includes custom parameters. For example, the command content is `echo… |
| CommandId | string | no | The ID of the command |
| TerminationMode | string | no | Indicates how the command task is stopped when a command execution is manually stopped or times out. Valid values: Process: The process of… |
| Launcher | string | no | The launcher for script execution. Cannot exceed 1 KB |

### Sends a file to one or more Lingjun nodes
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/send-file` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| Name | string | yes | The file name. The name can be up to 255 characters in length and can contain any characters |
| Description | string | no | The description of the file. The description can be up to 512 characters in length and can contain any characters |
| TargetDir | string | yes | The directory in the Lingjun node to which the file is sent. If the specified directory does not exist, the system creates the directory… |
| ContentType | string | no | The content type of the file. Valid values: PlainText Base64 Default value: PlainText |
| Content | string | yes | The content of the file. The file must not exceed 32 KB in size after it is encoded in Base64. If `ContentType` is set to `PlainText`, the… |
| FileMode | string | no | The permissions on the file. This parameter takes effect only on Linux instances. You can configure this parameter in the same way as you… |
| FileOwner | string | no | The owner of the file. This parameter takes effect only on Linux instances. Default value: root |
| FileGroup | string | no | The user group of the file. This parameter takes effect only on Linux instances. Default value: root. The value can be up to 64 characters… |
| NodeIdList | string | yes | The node list (JSON-encoded) |
| Overwrite | string | no | Specifies whether to overwrite file with the same name in the destination directory. true false Default value: false |
| Timeout | integer | no | The timeout period for the file sending task. Unit: seconds. A timeout error occurs when a file cannot be sent because the process slows… |

### Scales in a CC cluster
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/shrink-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ClusterId | string | no | The cluster ID |
| NodeGroups | string | no | The information about the node groups (JSON-encoded) |
| IgnoreFailedNodeTasks | string | no | Specifies whether to skip failed nodes. The default value is False |

### Stops the O\\&M assistant command execution
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/stop-invocation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| InvokeId | string | yes | The execution ID |
| NodeIdList | string | no | The nodes (JSON-encoded) |

### Stops an ongoing fault reporting diagnostics process after a user initiates a fault report
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/stop-node-diagnostic` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ReportId | string | yes | The report ID |

### Stops nodes
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/stop-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| Nodes | string | no | The nodes (JSON-encoded) |
| IgnoreFailedNodeTasks | string | no | Specifies whether to allow skipping failed nodes. Default value: False |

### Applies tags to resources
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ResourceType | string | yes | The resource type |
| ResourceId | string | yes | A list of resource IDs (JSON-encoded) |
| RegionId | string | yes | The region ID |
| Tag | string | yes | The tags (JSON-encoded) |

### Removes custom tags from resources
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/untag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| ResourceType | string | yes | The resource type |
| ResourceId | string | yes | The list of resource IDs (JSON-encoded) |
| RegionId | string | yes | The region ID |
| TagKey | string | no | The list of tag keys (JSON-encoded) |
| All | string | no | Specifies whether to remove all tags from the resources. This parameter takes effect only if you do not specify the TagKey.N parameter.… |

### Updates a node group
`POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/update-node-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |
| NodeGroupId | string | no | The ID of the node group |
| NewNodeGroupName | string | no | The name of the node group |
| UserData | string | no | The custom executable shell script. It must be Base64-encoded, and the maximum size of the raw data is 16 KB |
| FileSystemMountEnabled | string | no | Specifies whether file storage mounting is supported |
| KeyPairName | string | no | The name of the key pair |
| RamRoleName | string | no | The name of the RAM role for the node. You can call the ListRoles API operation of RAM to query the RAM roles that you have created. The… |
| ImageId | string | no | The default image ID of the node group. If you do not specify this parameter, the image ID remains unchanged |
| LoginPassword | string | no | The logon password for the machines in the node group |
| SystemDisk | string | no | The system cloud disk configuration (JSON-encoded) |

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eflo-controller.ap-southeast-1.aliyuncs.com |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/approve-operation" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Lingjun-Controller API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-eflo-controller/approve-operation with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Alibaba Cloud Lingjun-Controller 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-eflo-controller.

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