# 生成动态连接

选择出口国家，以及轮换或粘性会话。

## 查看可用选项

使用 `dynamic:read` 读取 `GET /dynamic/config`。响应包含工作空间支持的国家、协议、会话选项和流量包。

请使用响应中的国家值。仅当配置支持时，使用 `"*"` 表示所有可用国家。不要用空字符串代替。

## 选择会话

- **轮换会话**：请求使用轮换的 IP 选择方式。
- **粘性会话**：在支持的时长内保持会话，将 `duration_minutes` 设为支持的值。

普通连接使用标准流量。优化连接同时使用标准流量和优化流量。生成连接不会购买流量。

## 生成连接

调用 `POST /dynamic/profiles`，将 `COUNTRY` 设为支持的国家值，并保存一个请求标识。以下示例创建直连、轮换的 HTTP 连接：

```sh
CONNECTION_REQUEST_KEY=$(uuidgen)

curl --fail-with-body "$MIGO_API_BASE/dynamic/profiles" \
  -H "Authorization: Bearer $MIGO_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $CONNECTION_REQUEST_KEY" \
  -d "{\"country\":\"$COUNTRY\",\"protocol\":\"http\",\"mode\":\"rotating\",\"access_optimized\":false}"
```

API 地址和密钥设置见[开始使用](/zh-cn/docs/guides/getting-started)。此操作需要写入访问权限、`dynamic:write` 和 `credentials:read`。相同配置会复用已保存的连接。

粘性会话请设置 `mode: "sticky"` 并传入 `duration_minutes`。支持优化接入时，可设置 `access_optimized: true`。

## 查看和管理连接

`GET /dynamic/profiles` 返回不含密码的连接列表。通过 `GET /dynamic/profiles/{id}` 读取已就绪连接的详情，再按[连接指南](/zh-cn/docs/guides/connections)接入。

使用 `DELETE /dynamic/profiles/{id}` 删除已保存的连接。余额和购买步骤见[流量与账单](/zh-cn/docs/guides/traffic-and-billing)。