你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
交换部署
Swap Deployment异步操作启动服务的过渡环境与生产部署环境之间的虚拟 IP 地址交换。 如果该服务当前在临时环境中运行，则此操作将其切换至生产环境。 如果该服务在生产环境中运行，则此操作将其切换至临时环境。
请求
可以按以下方式指定 Swap Deployment 请求。 将 <subscription-id> 替换为订阅 ID，并将 <cloudservice-name> 替换为云服务的名称。
| 方法 | 请求 URI |
|---|---|
| POST | https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name> |
URI 参数
无。
请求标头
下表介绍请求标头。
| 请求标头 | 说明 |
|---|---|
Content-Type |
必需。 将此标头设置为 application/xml。 |
x-ms-version |
必需。 指定用于此请求的操作的版本。 此标头应设置为 2009-10-01 或更高版本。 |
请求正文
请求正文的格式如下所示：
<?xml version="1.0" encoding="utf-8"?>
<Swap xmlns="http://schemas.microsoft.com/windowsazure">
<Production>production-deployment-name</Production>
<SourceDeployment>deployment-name-to-be-swapped-with-production</SourceDeployment>
</Swap>
下表说明了请求正文的元素。
| 元素名称 | 说明 |
|---|---|
| 生产 | 必需。 生产部署的名称。 |
| SourceDeployment | 必需。 源部署的名称。 |
响应
响应包括 HTTP 状态代码和一组响应标头。
状态代码
此操作成功后返回状态代码 200（正常）。
响应标头
此操作的响应包括以下标头。 该响应还可能包括其他标准 HTTP 标头。
| 响应标头 | 说明 |
|---|---|
x-ms-request-id |
一个值，它唯一地标识对管理服务做出的请求。 对于异步操作，可以使用标头的值调用 “获取操作状态” ，以确定操作是完成、已失败还是仍在进行中。 |
响应正文
无。
备注
如果为 Swap Deployment 操作指定的名称与生产和临时环境中当前的名称不符，则返回状态代码 409（冲突）。
只有在这两个部署由服务定义指定的终结点数量相同时才能交换 VIP 地址。 例如，如果将 HTTPS 终结点添加到以前仅公开过 HTTP 终结点的 Web 角色，则无法通过交换 VIP 地址而升级服务；必须删除生产部署，然后改为重新部署。 可以使用 “获取部署” 操作获取有关使用的终结点的信息。