> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST (/ext/update/remote)

> POST (/ext/update/remote)

# POST (/ext/update/remote)

获取一个布尔值，指示指定的 AppXManifest 是否用于 ERA 标题。

* [URI 参数](#ID4ET)
* [必需的请求标头](#ID4EMB)
* [必需的请求正文](#ID4ETB)
* [响应](#ID4ETC)

## URI 参数

| 参数 | 类型 | 说明 |
| - | - | - |
| networkshare | base64 编码的字符串 | 系统更新包所在的网络共享位置。此网络共享应为 base64 编码。 |

## 必需的请求标头

无。

## 必需的请求正文

如果访问网络共享需要凭据，则请求必须包含一个 JSON 正文，其中含有可选的 username 和 password 参数以及一个布尔参数 **AllowSameBuild**，用于指示即使主机已处于此版本，是否也允许恢复继续进行。JSON 还应包含一个名为 **RecoverOptions** 的数组，该数组包含 ParamName 到 ParamValue 的键值对，用于指定以下更新选项：

* X-UpdateDownloadPolicy：1 或 0，其中 0 表示主机将显示更新提示，1 则会抑制该提示。
* X-ForceFactoryReset：布尔值，指示是否应执行恢复出厂设置。
* X-FactoryResetOptions：执行恢复出厂设置时为 0xdededede，否则为 0。
* X-HostName：应设置为 "\<save>" 以保留主机名，即使在恢复出厂设置的场景下也是如此。
* X-InhibitIdleTimeout：布尔值，指示更新期间是否应遵守屏幕变暗设置。
* X-SandboxId：作为恢复的一部分要设置的沙盒 ID。

## 响应

### HTTP 状态代码

服务针对使用此方法对此资源发出的请求返回本节中的一个状态代码。

\| 代码 | 说明 |
\| --- | --- | --- | --- |
\| 200 | 主机已成功更新到指定的恢复映像。 |
\| 4XX | 错误代码。 |
\| 5XX | 错误代码。 |

## 另请参阅

##### 父级

[/ext/update/remote](https://devdocs.xbox.com/zh-CN/reference/deviceportal/remote/uri-extupdateremote)


## Related topics

- [Remote Recovery URIs (API contents)](https://devdocs.xbox.com/reference/deviceportal/remote/atoc-rest-remote.md)
- [Remote Recovery URI（API 内容）](https://devdocs.xbox.com/zh-CN/reference/deviceportal/remote/atoc-rest-remote.md)
- [URIs de recuperação remota (conteúdo da API)](https://devdocs.xbox.com/pt-BR/reference/deviceportal/remote/atoc-rest-remote.md)
- [URI de recuperación remota (contenido de la API)](https://devdocs.xbox.com/es/reference/deviceportal/remote/atoc-rest-remote.md)
- [URI de récupération à distance (contenu de l'API)](https://devdocs.xbox.com/fr/reference/deviceportal/remote/atoc-rest-remote.md)