Azure REST API (1) 前言

　　一.服务运行时API简介

　　微软的Windows Azure服务总线提供了一整套REST风格的API，其中包括服务运行时API（Service Runtime API）和服务管理API（Service Management API），分别用于运行时操作和管理操作。

　　那么，什么是REST呢？REST（Representational State Transfer表述性状态转移）是一种针对网络应用的设计和开发方式，它可以降低开发的复杂性，提高系统的可伸缩性。使用REST API，意味着我们可以使用任意的编程语言来开发应用程序，它只有一个前提，我们使用的编程语言必须要能够支持HTTP协议。使用REST API，我们就不再需要客户端的SDK。

　　二.服务运行时API和服务管理API的区别

　　服务运行时API和服务管理API有什么区别呢？

　　首先，要从两者运行的“位置”进行比较。服务运行时API运行于Windows Azure云的内部，API代码与云交互环境相勾连；而服务管理API运行于Windows Azure云的外部，可以通过调用服务管理API来操纵正在运行的服务。

　　其次，两者的功能也大不相同。服务运行时API主要用于动态查看服务信息；而服务管理API则用于Azure授权用户能够以编程的方式管理其部署、托管的服务以及存储账户。授权用户可以管理存储服务的生命周期，包括新建存储服务、更新存储服务、删除存储服务等。

　　服务运行时API有时也被认为是服务托管API

　　三.服务运行时API的作用

　　服务运行时API有哪些作用呢？

　　1.WindowsAzure云上的Adapter服务可以通过调用服务运行时API来动态查询服务信息。比如可以访问应用的服务信息和用户的角色信息。还可以用于访问服务的拓扑信息，比如正在运行哪些角色、每个角色包含了多少个实例等等。

　　2.可以从配置文件中读取最新的设置。比如访问服务定义和服务配置文件中各项设置的最新的值，即使是服务配置正在更新，服务运行时API也能确保取得的值为最新状态。要注意，对于工作者角色，它与角色的生命周期是紧密绑定在一起的。

　　3.可以在配置文件更新后获取通知。

　　四.服务运行时API的访问方式

　　服务运行时API有两种访问方式：

　　1.对于托管代码，SDK封装了整个Microsoft.WindowsAzure.ServiceRuntime.dll库。只要用Visual Studio创建了一个新的云服务项目后，服务运行时API就可以自动引用。

　　2.对于本地代码，头文件和库文件都被封装在SDK中，可以使用C语言调用服务运行时API。

　　要说明一点，本地库和托管库两者的功能是完全相同的，你可以选择任意一种访问方式，而且两者间的代码转换也是很容易的。

　　五.服务运行时API的命名空间

　　Microsoft.WindowsAzure.ServiceRuntime的命名空间详见下表所述。

类	描述
LocalResource	表示本地存储资源，托管服务所保留。
Role	表示定义的角色，作为托管服务的一部分。
RoleEntryPoint	在角色实例进行初始化、运行、停止时，提供运行代码的方法。
RoleEnvironment	提供运行角色实例的配置、端点和状态的信息。
RoleEnvironmentCharge	表示托管服务的配置发生了变化。
RoleEnvironmentChangedEventArgs	表示已更改事件的参数，当配置修改被应用到角色实例后使用。
RoleEnvironmentChangingEventArgs	表示待更改事件的参数，当配置修改被应用到角色实例前使用。
RoleEnvironmentConfigurationSettingChange	表示一个角色配置的修改。
RoleEnvironmentException	在访问RoleEnvironment类的属性和方法发生错误时所抛出的异常。
RoleEnvironmentStoppingEventArgs	表示停止事件的参数，当一个角色实例被停止时使用。
RoleEnvironmentTopologyChange	表示某个角色的拓扑结构发生变化。
RoleInstance	表示一个角色实例。
RoleInstanceEndpoint	表示一个角色实例相关联的端点。
RoleInstanceStatusCheckEventArgs	表示StatusCheck事件的参数，用于在内部定期时间间隔来指示一个角色实例的状态。