# 保障 REST 服务高可用 (/zh-CN/realtime-media/media-pull/build/rest-availability)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

## 故障迁移 [#故障迁移]

为保障 REST 服务的高可用，避免因区域网络故障造成的服务不可用，声网提供故障迁移、多路任务保障、切换域名的方案。

针对网络故障，以及非声网云、非声网软件设施和不可抗力等因素导致的输入在线媒体流中断，声网服务为了保证更好的用户体验，提供自动故障迁移服务，该服务会在尽量短的时间内完成迁移（预计 4 分钟内），迁移期间输入在线媒体流任务中断，可能导致部分数据丢失。

对于频道内较多观众端的场景或对高可用有极高要求的关键性业务，你需要基于当前业务的重要性和声网提供的自动迁移时效性来考虑是否采用更高的质量保障。例如，准备[多路任务保障](/zh-CN/realtime-media/media-pull/build/rest-availability)以应对迁移期间的快速切换，或者可以[使用退避重试策略](/zh-CN/realtime-media/media-pull/build/rest-availability)主动迁移以减少迁移时间。

## 多路任务保障 [#多路任务保障]

如需比故障迁移更高的质量保障，你可以采用多路任务保障策略。每路输入在线媒体流任务单独计费，计费方式详见[计费说明](/zh-CN/realtime-media/media-pull/reference/billing)。实现步骤如下：

1. 同时发起主任务和备份任务，向同一频道推送在线媒体流，观众端订阅主任务中的 `uid`。
2. 在客户端监听以下回调事件，可以及时通知观众端订阅备份任务中的 `uid`：
    - 主播掉线回调 [`onUserOffline`](/zh-CN/api-reference/rtc/android/channel#callback_irtcengineeventhandler_onuseroffline)
    - 主播音视频状态变化回调 [`onRemoteAudioStateChanged`](/zh-CN/api-reference/rtc/android/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiostatechanged)/[`onRemoteVideoStateChanged`](/zh-CN/api-reference/rtc/android/video/video-basic#callback_irtcengineeventhandler_onremotevideostatechanged)

## 切换域名 [#切换域名]

切换域名的操作如下：

1. 根据你的业务服务器所在地设置主域名：
    - 业务服务器 DNS 地址位于中国大陆时，设置主域名为 `api.sd-rtn.com`。
    - 业务服务器 DNS 地址位于中国大陆以外的国家或地区时，设置主域名为 `api.agora.io`。
2. 当使用主域名发起 RESTful API 请求失败时，使用该域名重试一次。
3. 如果步骤 2 的重试依然失败，使用备用的主域名重试：
    - 如果当前设置的主域名为 `api.sd-rtn.com`，备用的主域名指 `api.agora.io`。
    - 如果当前设置的主域名为 `api.agora.io`，备用的主域名指 `api.sd-rtn.com`。
4. 如果步骤 3 的重试依然失败，使用与当前解析区域相邻的区域域名重试。

   举例说明：假设你的业务服务器位于欧洲，你设置主域名为 `api.agora.io`，并且该域名解析到德国。德国对应的区域域名为欧洲中部 `api-eu-central-1.agora.io`。查域名信息表可知，其相邻区域为欧洲西部，对应域名为 `api-eu-west-1.agora.io` 或 `api-eu-west-1.sd-rtn.com`。因此，出现网络故障且步骤 2、3 的重试失败时，请使用 `api-eu-west-1.agora.io` 或 `api-eu-west-1.sd-rtn.com` 重试。

#### 注意事项 [#注意事项]

- 为避免重试请求过于频繁，超过声网服务所规定的 QPS（每秒请求数），声网建议你使用退避策略。例如，第一次等待 1 秒后重试、第二次等待 3 秒后重试、第三次等待 6 秒后重试。
- 如果是网络问题而非 DNS 解析域名问题导致的请求失败，声网建议你跳过步骤 3，直接进行步骤 4。
- 切换至区域域名前，请确保你使用的业务（例如，云端录制、云信令、频道管理等 REST 服务）在该区域有部署服务。

#### 域名信息 [#域名信息]

<DocsTable>
<thead>
<tr>
<th scope="col">主域名</th>
<th scope="col">区域域名</th>
<th scope="col">地理区域</th>
</tr>
</thead>
<tbody>
<tr>
<td rowSpan={8}>`api.sd-rtn.com`</td>
<td>`api-us-west-1.sd-rtn.com`</td>
<td>美国西部</td>
</tr>
<tr>
<td>`api-us-east-1.sd-rtn.com`</td>
<td>美国东部</td>
</tr>
<tr>
<td>`api-ap-southeast-1.sd-rtn.com`</td>
<td>亚太东南</td>
</tr>
<tr>
<td>`api-ap-northeast-1.sd-rtn.com`</td>
<td>亚太东北</td>
</tr>
<tr>
<td>`api-eu-west-1.sd-rtn.com`</td>
<td>欧洲西部</td>
</tr>
<tr>
<td>`api-eu-central-1.sd-rtn.com`</td>
<td>欧洲中部</td>
</tr>
<tr>
<td>`api-cn-east-1.sd-rtn.com`</td>
<td>中国华东</td>
</tr>
<tr>
<td>`api-cn-north-1.sd-rtn.com`</td>
<td>中国华北</td>
</tr>
<tr>
<td rowSpan={8}>`api.agora.io`</td>
<td>`api-us-west-1.agora.io`</td>
<td>美国西部</td>
</tr>
<tr>
<td>`api-us-east-1.agora.io`</td>
<td>美国东部</td>
</tr>
<tr>
<td>`api-ap-southeast-1.agora.io`</td>
<td>亚太东南</td>
</tr>
<tr>
<td>`api-ap-northeast-1.agora.io`</td>
<td>亚太东北</td>
</tr>
<tr>
<td>`api-eu-west-1.agora.io`</td>
<td>欧洲西部</td>
</tr>
<tr>
<td>`api-eu-central-1.agora.io`</td>
<td>欧洲中部</td>
</tr>
<tr>
<td>`api-cn-east-1.agora.io`</td>
<td>中国华东</td>
</tr>
<tr>
<td>`api-cn-north-1.agora.io`</td>
<td>中国华北</td>
</tr>
</tbody>
</DocsTable>

## 使用退避重试策略 [#使用退避重试策略]

当输入在线媒体流过程中出现 `404`、`429`、`5xx` 错误码时，你需要采取退避策略，例如等待 5-6 秒、10-11 秒、15-16 秒后重试。

使用退避策略重试后，如果连续 3 次出现 `404`、`5xx` 错误码，或[查询云端播放器状态](/zh-CN/api-reference/api-ref/media-pull/list)响应包体中的 `status` 字段为 `failed`，说明输入在线媒体流失败，请按照如下步骤依次排查：

1. 确认媒体流地址是否正确，或该媒体流是否能够播放。
2. 如果媒体流地址正确且能够播放，请销毁当前云端播放器，并重新创建。