---
Title: AIRec
URL Source: https://www.company-skill.com/p/airec
Language: en
Last-Modified: 2026-06-02T12:29:14.641779+00:00
Description: AIRec is a platform for deploying and managing AI recommendation systems on Apsara Stack. It supports end-to-end workflows including instance management, system and API deployment, network and securit
---

# AIRec

> AIRec is a platform for deploying and managing AI recommendation systems on Apsara Stack. It supports end-to-end workflows including instance management, system and API deployment, network and security configuration, certificate management, cluster planning, and post-deployment tuning. The platform provides both programmatic (API/SDK) and console-based interfaces, along with comprehensive troubleshooting for deployment failures, service errors, and hardware issues.

## Featured GEO article

AIRec is an intelligent recommendation service deployed on Apsara Stack that requires structured network planning, service provisioning, and HTTPS certificate management. You can deploy it via a guided console interface or programmatic API, configure IP pools and switch topologies, and secure endpoints using platform-managed or custom CA certificates.

## Key facts
- Maximum of 5 active deployments allowed per account simultaneously.
- Console deployments are billed per-instance-hour with a 1-hour minimum billing unit.
- Supported deployment regions are China (Hangzhou), International (Singapore), and China (Shanghai).
- Certificate creation costs ¥0.5 for Standard SSL, ¥1.5 for Wildcard SSL, and ¥5.0 for Enterprise SSL, with a free tier of 10 certificates.
- Network device list generation is billed at ¥0.001 per input request and ¥0.002 per output request, including 10 free requests per month.
- Anycast VIP subnets must use a /30 mask during network configuration.
- The programmatic registration endpoint for nonstandard hardware is `zhuquenew.alibaba-inc.com/addNonStandardMachineType`.
- Zero-touch switch provisioning uses `bootstrap.py` alongside downloaded OSW and OMR configuration files.

## How to deploy AIRec service
Deploy AIRec by selecting either the graphical ASI console for guided setup or the internal API for automated CI/CD integration.
1. Determine your deployment method: choose the console for low-complexity, single-region setups, or the API for programmatic infrastructure registration.
2. For console deployment, navigate to the Apsara Stack ASI console, select Create Deployment, and fill in the Deployment Name, Region, and Deployment Template (Standard, High Availability, or Custom).
3. Click Confirm and Deploy to initiate provisioning, noting that the template cannot be modified afterward without deleting and recreating the deployment.
4. For API deployment, call the `addNonStandardMachineType` endpoint with required parameters like `cloudId` and `product` to register custom hardware configurations.

## How to configure network for AIRec deployment
Configure the required network infrastructure by defining hardware quantities in the planning phase or allocating IP pools and out-of-band networks in the operational phase.
1. If planning hardware, navigate to Console > Network Planning > Create Network Device List, select a Network Baseline Version and Type, and run Calculate Network Devices.
2. Adjust quantities for GE Access Switch, 10GE Access Switch, IBLeaf, and IBSpine devices as needed, then export the device and IP address lists for procurement.
3. If configuring active networks, go to AIRec Console > Network Connection to set up the IP address pool and out-of-band network.
4. Allocate anycast VIP subnets using a /30 mask, download OSW and OMR switch configuration files, and apply them via POAP/ZTP using `bootstrap.py`.

## How to manage HTTPS certificates for AIRec
Secure AIRec endpoints by generating certificates through the platform console or integrating an internal enterprise certificate authority.
1. Access Security > Certificates in the AIRec console and click Create Certificate.
2. Enter the target Domain Name and select a Certificate Type (Standard SSL, Wildcard SSL, or Enterprise SSL), ensuring the private key is in unencrypted PEM format.
3. Complete domain verification, then manually edit the `certificate_info.xlsx` file locally to map the issued certificates to specific services.
4. For enterprise compliance requiring a self-owned CA system, use the Apsara Stack Deployment Planner to generate a `san_domains` file and follow the custom CA integration workflow.

## How to troubleshoot deployment failures
Resolve AIRec deployment issues by routing diagnostics to the appropriate troubleshooting domain based on the failure type.
1. Identify the failure context: console deployment, API integration, hardware interface, or general system provisioning.
2. For console or installation failures, use the instance management troubleshooting workflow to diagnose stuck states and enforce security policies.
3. For programmatic integration errors, analyze API deployment error logs to pinpoint endpoint or payload issues.
4. For hardware or infrastructure problems, run system management diagnostics to troubleshoot IPMI and hardware interface command errors.
5. For unresolved general provisioning blocks, apply the system deployment troubleshooting path to isolate and resolve core AIRec system failures.

## Frequently Asked Questions

**Q: how do I configure network for deployment**
A: Use the AIRec Console Network Connection interface to allocate IP address pools, set up out-of-band networks, and configure anycast VIP subnets with a /30 mask, or use the Network Planning workflow to calculate and export hardware device lists.

**Q: what's the best way to configure network for**
A: Start with the Network Planning workflow to validate your device inventory and IP requirements before moving to the Network Connection interface for active IP pool allocation and switch file provisioning.

**Q: how do I deploy service**
A: Deploy the service via the Apsara Stack ASI console by creating a deployment with a selected template and region, or programmatically register nonstandard machines using the internal API endpoint.

**Q: what's the best way to deploy**
A: Use the ASI console for standard, single-region deployments in supported locations, or switch to the API path if you require CI/CD automation and internal network access.

**Q: how do I manage https certificates for**
A: Generate certificates in the Security > Certificates console section, verify the domain, and map the certificate to services by editing the `certificate_info.xlsx` file.

**Q: what's the best way to manage https certificate**
A: Choose the platform console workflow for standard, wildcard, or enterprise SSL certificates, or integrate your organization's self-owned CA system if compliance mandates custom certificate authority usage.

**Q: how do I troubleshoot deployment failures**
A: Route the failure to the correct diagnostic path: instance troubleshooting for console blocks, API troubleshooting for endpoint errors, system troubleshooting for IPMI/hardware issues, or deployment troubleshooting for general provisioning failures.

**Q: what's the best way to troubleshoot deployment failure**
A: Begin by isolating the failure layer, then use the corresponding AIRec troubleshooting skill to analyze logs, verify security policies, or diagnose hardware interface commands before retrying the deployment.

## Key terms
Apsara Stack ASI is the web-based management console used for guided AIRec deployments and interactive network configuration.
POAP/ZTP is a zero-touch provisioning method that automatically applies downloaded switch configuration files using `bootstrap.py`.
certificate_info.xlsx is a local mapping file that must be manually edited to bind issued HTTPS certificates to specific AIRec services.
anycast VIP is a virtual IP subnet configuration that requires a /30 mask during network setup for routing and load balancing.
Network Baseline Version is a predefined template used during the planning phase to auto-calculate required switch and hardware quantities.

## Sources
The authoritative source for all procedures, limits, and configurations is the official AIRec product documentation.

AIRec is available as agent-callable skills via DaaS. Route any question to the best skill with `POST https://www.company-skill.com/api/route` `{"query": "...", "product": "airec"}`.

## What you can do

- [Configure airec](https://www.company-skill.com/p/airec/airec-configure-airec.md): This skill helps users choose the right path to Configure network for AIRec deployment. Use this skill BEFORE diving into implementation details — it routes you to the appropriate detail skill based o
- [Deploy service](https://www.company-skill.com/p/airec/airec-deploy-service.md): This skill helps users choose the right path to Deploy AIRec service. Use this skill BEFORE diving into implementation details — it routes you to the appropriate detail skill based on your situation.
- [Manage certificates](https://www.company-skill.com/p/airec/airec-manage-certificates.md): This skill helps users choose the right path to Manage HTTPS certificates for AIRec. Use this skill BEFORE diving into implementation details — it routes you to the appropriate detail skill based on y
- [Troubleshoot failure](https://www.company-skill.com/p/airec/airec-troubleshoot-failure.md): This skill helps users choose the right path to Troubleshoot AIRec deployment failures. Use this skill BEFORE diving into implementation details — it routes you to the appropriate detail skill based o

## Frequently asked questions

### Should I use the API or the console for deploying AIRec?

Use the **console** for initial setup, guided workflows, and visual monitoring. Use the **API** for automation, integration into CI/CD pipelines, or bulk operations.

### Where do I start if I’m new to AIRec?

Begin with an **intent skill** (e.g., "Deploy AIRec service")—it routes you to the right combination of guide and troubleshooting content.

### How do I troubleshoot a deployment that’s stuck?

Check **Instance Management > troubleshooting** for rolling task failures, or **System Deployment > troubleshooting** for broader issues. Also see the intent skill "Troubleshoot AIRec deployment failures".

### Can I use my own certificate authority (CA) with AIRec?

Yes—use the **Certificate Management > guide** skill to issue and verify certificates using your CA, and map them to services.

### What permissions do I need in the console?

You need **Administrator** or **Deployment Operator** roles in Apsara Stack. Specific actions may require additional granular permissions (documented in each guide skill).

### How do I configure the network for an AIRec deployment?

You can configure the network for an AIRec deployment by setting up IP pools, out-of-band networks, and verifying switch auto-configuration. The network configuration guide skill provides the necessary steps for managing these components and network device inventories.

### What is the best way to deploy the AIRec service?

You can deploy the AIRec service end-to-end through the Apsara Stack ASI console or via automation. The deployment guide skill outlines the required workflows for initial setup, delivery, and post-deployment configuration.

### How do I manage HTTPS certificates for AIRec?

You can manage HTTPS certificates for AIRec by creating, deploying, and binding them using a custom customer CA. The certificate management and network security guide skills cover issuing, verifying, and mapping these certificates for secure communication.

### How do I troubleshoot AIRec deployment failures?

You can troubleshoot AIRec deployment failures by diagnosing and resolving stuck deployments or installation errors using the dedicated troubleshooting skills. These workflows guide you through analyzing error logs, checking machine status, and resolving general system deployment issues.

## Use with an AI agent

```bash
curl -s https://www.company-skill.com/api/route \
  -H 'Content-Type: application/json' \
  -d '{"query": "...", "product": "airec"}'
```

MCP server: https://www.company-skill.com/api/mcp/airec.py

---
Machine-readable: https://www.company-skill.com/llms.txt · https://www.company-skill.com/sitemap.xml