列出部署事件

List Deployment Events操作列出在指定的时间范围内受部署影响的事件。

请求

List Deployment Events请求可用于检索单个部署槽位（过渡或生产）或特定部署名称的部署事件。 如果要按部署名称检索信息，则必须先获取该部署的唯一名称。 当你请求 获取部署 槽位的部署时，此唯一名称是响应的一部分。

例如，如果已将云服务部署到生产环境，则可以通过请求获取生产槽的 “获取部署 ”来获取唯一名称。 响应包含云服务的 Name 元素。 如果要检索有关该特定部署的信息，则可使用 Name 元素值请求 …/deployments/<deployment-name>/events。

若要生成请求 URI，请将 <subscription-id> 替换为你的订阅 ID，将 <cloudservice-name> 替换为云服务的名称，将 <deployment-slot> 替换为 staging 或 production，或者将 <deployment-name> 替换为部署的名称。

方法	请求 URI
GET	https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>/events
GET	https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/events

URI 参数

List Deployment Events具有以下 URI 参数：

参数	说明
subscriptionId	必需。 Azure 用户的订阅 ID。
cloudservice-name	必需。 云服务的名称。
deployment-slot	未使用 deployment-name 时是必需的。 部署槽位，可以是 staging 或 production。
deployment-name	未使用 deployment-slot 时是必需的。 部署的名称。
StartTime=<start-of-timeframe>	必需。 表示查询开始时间的 UTC 日期时间。
EndTime=<end-of-timeframe>	必需。 表示查询结束时间的 UTC 日期时间。

请求标头

下表介绍请求标头。

请求标头	说明
x-ms-version	必需。 指定用于此请求的操作的版本。 此标头应设置为 2009-10-01 或更高版本。

请求正文

无。

响应

响应包括 HTTP 状态代码、一组响应标头和响应正文。

状态代码

此操作成功后返回状态代码 200（正常）。

响应标头

此操作的响应包括以下标头。 该响应还可能包括其他标准 HTTP 标头。

响应标头	说明
x-ms-request-id	指定一个值，该值唯一标识针对管理服务发出的请求。
x-ms-continuation-token	指定继续标记，使用该标记可以在有比在分配的时间内返回的结果更多的云服务可列出时获得响应的剩余部分。 如果在订阅中存在大量云服务，则并非所有云服务都可以在单个响应中列出。 你可以在后续操作请求中使用此标头中的标记，直到返回所有云服务。

响应正文

响应正文的格式如下所示：

<DeploymentEventCollection xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="https://www.w3.org/2001/XMLSchema-instance">  
  <RebootEvents>  
    <RebootEvent>  
      <RoleName>KenazDemo-A4</RoleName>  
      <InstanceName>KenazDemo-A4</InstanceName>  
      <RebootReason>Virtual machine rebooted due to planned maintenance event.</RebootReason>  
      <RebootStartTime>2014-09-14T03:50:09.4299879Z</RebootStartTime>  
    </RebootEvent>  
    <RebootEvent>  
      <RoleName>KenazDemo-D4</RoleName>  
      <InstanceName>KenazDemo-D4</InstanceName>  
      <RebootReason>Virtual machine rebooted due to planned maintenance event.</RebootReason>  
      <RebootStartTime>2014-09-14T05:22:03.5531204Z</RebootStartTime>  
    </RebootEvent>  
  </RebootEvents>  
</DeploymentEventCollection>  
  

下表介绍响应正文的元素。

元素名称	说明
RoleName	已重新启动的角色实例的角色名称。
InstanceName	已重新启动的角色实例的名称。
RebootReason	已使用“2014-06-01”版本硬编码为“PlannedMaintenance”。
RebootStartedTime	表示启动 Reboot 事件的 UTC 日期时间，已舍入为最近似的分钟时间。