你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
遍历升级域
Walk Upgrade Domain异步操作指定必须更新其中角色实例的更新域。
请求
可以按以下方式指定 Walk Upgrade Domain 请求。 将 替换为 <subscription-id> 订阅 ID， <cloudservice-name> 将 替换为云服务的名称， <deployment-slot> 将 替换为 staging 或 production，并将 <deployment-name> 替换为部署的名称。
| 方法 | 请求 URI |
|---|---|
| POST | https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>/?comp=walkupgradedomain |
| POST | https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/?comp=walkupgradedomain |
URI 参数
| URI 参数 | 说明 |
|---|---|
comp=walkupgradedomain |
必需。 指定在手动就地更新期间，一次一个更新域地更新部署中的角色实例。 |
请求标头
下表介绍请求标头。
| 请求标头 | 说明 |
|---|---|
Content-Type |
必需。 将此标头设置为 application/xml。 |
x-ms-version |
必需。 指定用于此请求的操作的版本。 此标头应设置为 2009-10-01 或更高版本。 |
请求正文
请求正文的格式如下所示：
<?xml version="1.0" encoding="utf-8"?>
<WalkUpgradeDomain xmlns="http://schemas.microsoft.com/windowsazure">
<UpgradeDomain>update-domain-id</UpgradeDomain>
</WalkUpgradeDomain>
下表说明了请求正文的元素。
| 元素名称 | 说明 |
|---|---|
| UpgradeDomain | 必需。 指定一个整数值，该值标识要更新的更新域。 以从零开始的索引标识更新域：第一个更新域的 ID 为 0，第二个更新域的 ID 为 1，依此类推。 |
响应
响应包括 HTTP 状态代码和一组响应标头。
状态代码
此操作成功后返回状态代码 200（正常）。
响应标头
此操作的响应包括以下标头。 该响应还可能包括其他标准 HTTP 标头。
| 响应标头 | 说明 |
|---|---|
x-ms-request-id |
一个值，它唯一地标识对管理服务做出的请求。 对于异步操作，可以使用标头的值调用 “获取操作状态” ，以确定操作是完成、已失败还是仍在进行中。 |
响应正文
无。
备注
在调用操作之前， Walk Upgrade Domain 必须已调用 升级部署、 更改部署配置或 回滚更新或升级。
默认情况下为一个服务部署 5 个更新域，在就地更新期间一次一个地更新这些域。
若要手动更新部署，请按以下顺序进行操作：
调用将 元素设置为
manual的Mode升级部署。调用
Walk Upgrade Domain以更新部署中的每个域。 必须按顺序对更新域进行更新。 例如，首先更新域 0，然后更新域 1，依此类推。
添加或删除角色实例的更新将导致对云服务中部署的所有角色进行配置更新。 需要向现有角色实例通知新的角色实例，以使所有角色实例均可在云服务中进行通信。
在更新正在进行时，调用 “获取部署” 以确定其状态。 如果正在进行更新，则 Get Deployment 返回一个 UpgradeStatus 元素，其中包含有关更新的信息。 如果更新已完成，或没有更新在进行，则 UpgradeStatus 元素为 null。